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-08-07 23:12+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:72 ../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:1011
 921 #: ../src/guestfs.pod:1015 ../src/guestfs.pod:1019 ../src/guestfs.pod:1024
 922 #: ../src/guestfs.pod:1032 ../src/guestfs.pod:1051 ../src/guestfs.pod:1059
 923 #: ../src/guestfs.pod:1081 ../src/guestfs.pod:1085 ../src/guestfs.pod:1089
 924 #: ../src/guestfs.pod:1093 ../src/guestfs.pod:1097 ../src/guestfs.pod:1101
 925 #: ../src/guestfs.pod:1583 ../src/guestfs.pod:1588 ../src/guestfs.pod:1592
 926 #: ../src/guestfs.pod:1702 ../src/guestfs.pod:1707 ../src/guestfs.pod:1711
 927 #: ../src/guestfs.pod:2064 ../src/guestfs.pod:2070 ../src/guestfs.pod:2075
 928 #: ../src/guestfs.pod:2081 ../src/guestfs.pod:2540 ../src/guestfs.pod:2544
 929 #: ../src/guestfs.pod:2548 ../src/guestfs.pod:2552
 930 #: ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22
 931 #: ../src/guestfs-actions.pod:569 ../src/guestfs-actions.pod:577
 932 #: ../src/guestfs-actions.pod:584 ../src/guestfs-actions.pod:591
 933 #: ../src/guestfs-actions.pod:1584 ../src/guestfs-actions.pod:1588
 934 #: ../src/guestfs-actions.pod:1592 ../src/guestfs-actions.pod:1596
 935 #: ../src/guestfs-actions.pod:1604 ../src/guestfs-actions.pod:1608
 936 #: ../src/guestfs-actions.pod:1612 ../src/guestfs-actions.pod:1622
 937 #: ../src/guestfs-actions.pod:1626 ../src/guestfs-actions.pod:1630
 938 #: ../src/guestfs-actions.pod:1768 ../src/guestfs-actions.pod:1772
 939 #: ../src/guestfs-actions.pod:1777 ../src/guestfs-actions.pod:1782
 940 #: ../src/guestfs-actions.pod:1843 ../src/guestfs-actions.pod:1847
 941 #: ../src/guestfs-actions.pod:1852 ../fish/guestfish.pod:427
 942 #: ../fish/guestfish.pod:431 ../fish/guestfish.pod:435
 943 #: ../fish/guestfish.pod:439 ../fish/guestfish-actions.pod:13
 944 #: ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:373
 945 #: ../fish/guestfish-actions.pod:381 ../fish/guestfish-actions.pod:388
 946 #: ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:1062
 947 #: ../fish/guestfish-actions.pod:1066 ../fish/guestfish-actions.pod:1070
 948 #: ../fish/guestfish-actions.pod:1074 ../fish/guestfish-actions.pod:1082
 949 #: ../fish/guestfish-actions.pod:1086 ../fish/guestfish-actions.pod:1090
 950 #: ../fish/guestfish-actions.pod:1100 ../fish/guestfish-actions.pod:1104
 951 #: ../fish/guestfish-actions.pod:1108 ../fish/guestfish-actions.pod:1198
 952 #: ../fish/guestfish-actions.pod:1202 ../fish/guestfish-actions.pod:1207
 953 #: ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1254
 954 #: ../fish/guestfish-actions.pod:1258 ../fish/guestfish-actions.pod:1263
 955 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
 956 #: ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345
 957 #: ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360
 958 msgid "*"
 959 msgstr ""
 960
 961 # type: textblock
 962 #. type: textblock
 963 #: ../src/guestfs.pod:390
 964 msgid ""
 965 "The kernel version that the command runs under will be different from what "
 966 "it expects."
 967 msgstr ""
 968
 969 # type: textblock
 970 #. type: textblock
 971 #: ../src/guestfs.pod:395
 972 msgid ""
 973 "If the command needs to communicate with daemons, then most likely they "
 974 "won't be running."
 975 msgstr ""
 976
 977 # type: textblock
 978 #. type: textblock
 979 #: ../src/guestfs.pod:400
 980 msgid "The command will be running in limited memory."
 981 msgstr ""
 982
 983 # type: textblock
 984 #. type: textblock
 985 #: ../src/guestfs.pod:404
 986 msgid ""
 987 "The network may not be available unless you enable it (see L</"
 988 "guestfs_set_network>)."
 989 msgstr ""
 990
 991 # type: textblock
 992 #. type: textblock
 993 #: ../src/guestfs.pod:409
 994 msgid "Only supports Linux guests (not Windows, BSD, etc)."
 995 msgstr ""
 996
 997 # type: textblock
 998 #. type: textblock
 999 #: ../src/guestfs.pod:413
1000 msgid ""
1001 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1002 msgstr ""
1003
1004 # type: textblock
1005 #. type: textblock
1006 #: ../src/guestfs.pod:418
1007 msgid ""
1008 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1009 "See L</SELINUX> in this manpage."
1010 msgstr ""
1011
1012 # type: textblock
1013 #. type: textblock
1014 #: ../src/guestfs.pod:423
1015 msgid ""
1016 "I<Security:> It is not safe to run commands from untrusted, possibly "
1017 "malicious guests.  These commands may attempt to exploit your program by "
1018 "sending unexpected output.  They could also try to exploit the Linux kernel "
1019 "or qemu provided by the libguestfs appliance.  They could use the network "
1020 "provided by the libguestfs appliance to bypass ordinary network partitions "
1021 "and firewalls.  They could use the elevated privileges or different SELinux "
1022 "context of your program to their advantage."
1023 msgstr ""
1024
1025 # type: textblock
1026 #. type: textblock
1027 #: ../src/guestfs.pod:432
1028 msgid ""
1029 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1030 "(a script which runs when the guest next boots normally), and to have this "
1031 "script run the commands you want in the normal context of the running guest, "
1032 "network security and so on.  For information about other security issues, "
1033 "see L</SECURITY>."
1034 msgstr ""
1035
1036 # type: textblock
1037 #. type: textblock
1038 #: ../src/guestfs.pod:440
1039 msgid ""
1040 "The two main API calls to run commands are L</guestfs_command> and L</"
1041 "guestfs_sh> (there are also variations)."
1042 msgstr ""
1043
1044 # type: textblock
1045 #. type: textblock
1046 #: ../src/guestfs.pod:443
1047 msgid ""
1048 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1049 "shell globs, redirections, etc will work."
1050 msgstr ""
1051
1052 # type: =head2
1053 #. type: =head2
1054 #: ../src/guestfs.pod:446
1055 msgid "CONFIGURATION FILES"
1056 msgstr ""
1057
1058 # type: textblock
1059 #. type: textblock
1060 #: ../src/guestfs.pod:448
1061 msgid ""
1062 "To read and write configuration files in Linux guest filesystems, we "
1063 "strongly recommend using Augeas.  For example, Augeas understands how to "
1064 "read and write, say, a Linux shadow password file or X.org configuration "
1065 "file, and so avoids you having to write that code."
1066 msgstr ""
1067
1068 # type: textblock
1069 #. type: textblock
1070 #: ../src/guestfs.pod:453
1071 msgid ""
1072 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1073 "document Augeas itself here because there is excellent documentation on the "
1074 "L<http://augeas.net/> website."
1075 msgstr ""
1076
1077 # type: textblock
1078 #. type: textblock
1079 #: ../src/guestfs.pod:457
1080 msgid ""
1081 "If you don't want to use Augeas (you fool!) then try calling L</"
1082 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1083 "over."
1084 msgstr ""
1085
1086 # type: =head2
1087 #. type: =head2
1088 #: ../src/guestfs.pod:461
1089 msgid "SELINUX"
1090 msgstr ""
1091
1092 # type: textblock
1093 #. type: textblock
1094 #: ../src/guestfs.pod:463
1095 msgid ""
1096 "We support SELinux guests.  To ensure that labeling happens correctly in "
1097 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1098 msgstr ""
1099
1100 # type: =item
1101 #. type: =item
1102 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1204 ../src/guestfs.pod:1335
1103 #: ../src/guestfs.pod:2109
1104 msgid "1."
1105 msgstr ""
1106
1107 # type: textblock
1108 #. type: textblock
1109 #: ../src/guestfs.pod:471
1110 msgid "Before launching, do:"
1111 msgstr ""
1112
1113 # type: verbatim
1114 #. type: verbatim
1115 #: ../src/guestfs.pod:473
1116 #, no-wrap
1117 msgid ""
1118 " guestfs_set_selinux (g, 1);\n"
1119 "\n"
1120 msgstr ""
1121
1122 # type: =item
1123 #. type: =item
1124 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1208 ../src/guestfs.pod:1339
1125 #: ../src/guestfs.pod:2134
1126 msgid "2."
1127 msgstr ""
1128
1129 # type: textblock
1130 #. type: textblock
1131 #: ../src/guestfs.pod:477
1132 msgid ""
1133 "After mounting the guest's filesystem(s), load the policy.  This is best "
1134 "done by running the L<load_policy(8)> command in the guest itself:"
1135 msgstr ""
1136
1137 # type: verbatim
1138 #. type: verbatim
1139 #: ../src/guestfs.pod:481
1140 #, no-wrap
1141 msgid ""
1142 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1143 "\n"
1144 msgstr ""
1145
1146 # type: textblock
1147 #. type: textblock
1148 #: ../src/guestfs.pod:483
1149 msgid ""
1150 "(Older versions of C<load_policy> require you to specify the name of the "
1151 "policy file)."
1152 msgstr ""
1153
1154 # type: =item
1155 #. type: =item
1156 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1345
1157 msgid "3."
1158 msgstr ""
1159
1160 # type: textblock
1161 #. type: textblock
1162 #: ../src/guestfs.pod:488
1163 msgid ""
1164 "Optionally, set the security context for the API.  The correct security "
1165 "context to use can only be known by inspecting the guest.  As an example:"
1166 msgstr ""
1167
1168 # type: verbatim
1169 #. type: verbatim
1170 #: ../src/guestfs.pod:492
1171 #, no-wrap
1172 msgid ""
1173 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1174 "\n"
1175 msgstr ""
1176
1177 # type: textblock
1178 #. type: textblock
1179 #: ../src/guestfs.pod:496
1180 msgid "This will work for running commands and editing existing files."
1181 msgstr ""
1182
1183 # type: textblock
1184 #. type: textblock
1185 #: ../src/guestfs.pod:498
1186 msgid ""
1187 "When new files are created, you may need to label them explicitly, for "
1188 "example by running the external command C<restorecon pathname>."
1189 msgstr ""
1190
1191 # type: =head2
1192 #. type: =head2
1193 #: ../src/guestfs.pod:502
1194 msgid "UMASK"
1195 msgstr ""
1196
1197 # type: textblock
1198 #. type: textblock
1199 #: ../src/guestfs.pod:504
1200 msgid ""
1201 "Certain calls are affected by the current file mode creation mask (the "
1202 "\"umask\").  In particular ones which create files or directories, such as "
1203 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1204 "either the default mode that the file is created with or modifies the mode "
1205 "that you supply."
1206 msgstr ""
1207
1208 # type: textblock
1209 #. type: textblock
1210 #: ../src/guestfs.pod:510
1211 msgid ""
1212 "The default umask is C<022>, so files are created with modes such as C<0644> "
1213 "and directories with C<0755>."
1214 msgstr ""
1215
1216 # type: textblock
1217 #. type: textblock
1218 #: ../src/guestfs.pod:513
1219 msgid ""
1220 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1221 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1222 "guestfs_chmod> after creating each file or directory."
1223 msgstr ""
1224
1225 # type: textblock
1226 #. type: textblock
1227 #: ../src/guestfs.pod:517
1228 msgid "For more information about umask, see L<umask(2)>."
1229 msgstr ""
1230
1231 # type: =head1
1232 #. type: =head1
1233 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:720
1234 msgid "ENCRYPTED DISKS"
1235 msgstr ""
1236
1237 # type: textblock
1238 #. type: textblock
1239 #: ../src/guestfs.pod:521
1240 msgid ""
1241 "Libguestfs allows you to access Linux guests which have been encrypted using "
1242 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1243 "standard.  This includes nearly all whole disk encryption systems used by "
1244 "modern Linux guests."
1245 msgstr ""
1246
1247 # type: textblock
1248 #. type: textblock
1249 #: ../src/guestfs.pod:527
1250 msgid ""
1251 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1252 "returns the string C<crypto_LUKS>)."
1253 msgstr ""
1254
1255 # type: textblock
1256 #. type: textblock
1257 #: ../src/guestfs.pod:530
1258 msgid ""
1259 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1260 "will require the passphrase!"
1261 msgstr ""
1262
1263 # type: textblock
1264 #. type: textblock
1265 #: ../src/guestfs.pod:533
1266 msgid ""
1267 "Opening a LUKS device creates a new device mapper device called C</dev/"
1268 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1269 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1270 "from and encrypted to the underlying block device respectively."
1271 msgstr ""
1272
1273 # type: textblock
1274 #. type: textblock
1275 #: ../src/guestfs.pod:539
1276 msgid ""
1277 "LVM volume groups on the device can be made visible by calling L</"
1278 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1279 "(s) can now be mounted in the usual way."
1280 msgstr ""
1281
1282 # type: textblock
1283 #. type: textblock
1284 #: ../src/guestfs.pod:543
1285 msgid ""
1286 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1287 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1288 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1289 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1290 "underlying encrypted block device)."
1291 msgstr ""
1292
1293 # type: =head2
1294 #. type: =head2
1295 #: ../src/guestfs.pod:550
1296 msgid "INSPECTION"
1297 msgstr ""
1298
1299 # type: textblock
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.  (These APIs used to be in a separate Perl-only "
1305 "library called L<Sys::Guestfs::Lib(3)> but since version 1.5.3 the most "
1306 "frequently used part of this library has been rewritten in C and moved into "
1307 "the core code)."
1308 msgstr ""
1309
1310 # type: textblock
1311 #. type: textblock
1312 #: ../src/guestfs.pod:558
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:561
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:570
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:576
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:583
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:587
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:590
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:594
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:598
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:602
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: =head2
1414 #. type: =head2
1415 #: ../src/guestfs.pod:611
1416 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1417 msgstr ""
1418
1419 # type: textblock
1420 #. type: textblock
1421 #: ../src/guestfs.pod:613
1422 msgid ""
1423 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1424 "ntfs-3g.org/> driver."
1425 msgstr ""
1426
1427 # type: =head3
1428 #. type: =head3
1429 #: ../src/guestfs.pod:616
1430 msgid "DRIVE LETTERS AND PATHS"
1431 msgstr ""
1432
1433 # type: textblock
1434 #. type: textblock
1435 #: ../src/guestfs.pod:618
1436 msgid ""
1437 "DOS and Windows still use drive letters, and the filesystems are always "
1438 "treated as case insensitive by Windows itself, and therefore you might find "
1439 "a Windows configuration file referring to a path like C<c:\\windows"
1440 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1441 "might be referred to as C</WINDOWS/System32>."
1442 msgstr ""
1443
1444 # type: textblock
1445 #. type: textblock
1446 #: ../src/guestfs.pod:624
1447 msgid ""
1448 "Drive letter mappings are outside the scope of libguestfs.  You have to use "
1449 "libguestfs to read the appropriate Windows Registry and configuration files, "
1450 "to determine yourself how drives are mapped (see also L<hivex(3)> and L<virt-"
1451 "inspector(1)>)."
1452 msgstr ""
1453
1454 # type: textblock
1455 #. type: textblock
1456 #: ../src/guestfs.pod:629
1457 msgid ""
1458 "Replacing backslash characters with forward slash characters is also outside "
1459 "the scope of libguestfs, but something that you can easily do."
1460 msgstr ""
1461
1462 # type: textblock
1463 #. type: textblock
1464 #: ../src/guestfs.pod:632
1465 msgid ""
1466 "Where we can help is in resolving the case insensitivity of paths.  For "
1467 "this, call L</guestfs_case_sensitive_path>."
1468 msgstr ""
1469
1470 # type: =head3
1471 #. type: =head3
1472 #: ../src/guestfs.pod:635
1473 msgid "ACCESSING THE WINDOWS REGISTRY"
1474 msgstr ""
1475
1476 # type: textblock
1477 #. type: textblock
1478 #: ../src/guestfs.pod:637
1479 msgid ""
1480 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1481 "files, through the library C<hivex> which is part of the libguestfs project "
1482 "although ships as a separate tarball.  You have to locate and download the "
1483 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1484 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1485 "reg(1)> for more help on this issue."
1486 msgstr ""
1487
1488 # type: =head3
1489 #. type: =head3
1490 #: ../src/guestfs.pod:645
1491 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1492 msgstr ""
1493
1494 # type: textblock
1495 #. type: textblock
1496 #: ../src/guestfs.pod:647
1497 msgid ""
1498 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1499 "provide something which looks like a Linux symlink.  The way it tries to do "
1500 "the rewriting is described here:"
1501 msgstr ""
1502
1503 # type: textblock
1504 #. type: textblock
1505 #: ../src/guestfs.pod:651
1506 msgid ""
1507 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1508 "symbolic-links/>"
1509 msgstr ""
1510
1511 # type: textblock
1512 #. type: textblock
1513 #: ../src/guestfs.pod:653
1514 msgid ""
1515 "The essential problem is that ntfs-3g simply does not have enough "
1516 "information to do a correct job.  NTFS links can contain drive letters and "
1517 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1518 "It is almost certainly the case that libguestfs callers should ignore what "
1519 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1520 msgstr ""
1521
1522 # type: textblock
1523 #. type: textblock
1524 #: ../src/guestfs.pod:660
1525 msgid ""
1526 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1527 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1528 "attribute, and read the raw reparse data from that (you can find the format "
1529 "documented in various places around the web)."
1530 msgstr ""
1531
1532 # type: =head3
1533 #. type: =head3
1534 #: ../src/guestfs.pod:665
1535 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1536 msgstr ""
1537
1538 # type: textblock
1539 #. type: textblock
1540 #: ../src/guestfs.pod:667
1541 msgid ""
1542 "There are other useful extended attributes that can be read from ntfs-3g "
1543 "filesystems (using L</guestfs_getxattr>).  See:"
1544 msgstr ""
1545
1546 # type: textblock
1547 #. type: textblock
1548 #: ../src/guestfs.pod:670
1549 msgid ""
1550 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1551 msgstr ""
1552
1553 # type: =head2
1554 #. type: =head2
1555 #: ../src/guestfs.pod:672
1556 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1557 msgstr ""
1558
1559 # type: textblock
1560 #. type: textblock
1561 #: ../src/guestfs.pod:674
1562 msgid ""
1563 "Although we don't want to discourage you from using the C API, we will "
1564 "mention here that the same API is also available in other languages."
1565 msgstr ""
1566
1567 #. type: textblock
1568 #: ../src/guestfs.pod:677
1569 msgid ""
1570 "The API is broadly identical in all supported languages.  This means that "
1571 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1572 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1573 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1574 "each language."
1575 msgstr ""
1576
1577 # type: textblock
1578 #. type: textblock
1579 #: ../src/guestfs.pod:683
1580 msgid ""
1581 "Error messages are automatically transformed into exceptions if the language "
1582 "supports it."
1583 msgstr ""
1584
1585 # type: textblock
1586 #. type: textblock
1587 #: ../src/guestfs.pod:686
1588 msgid ""
1589 "We don't try to \"object orientify\" parts of the API in OO languages, "
1590 "although contributors are welcome to write higher level APIs above what we "
1591 "provide in their favourite languages if they wish."
1592 msgstr ""
1593
1594 # type: =item
1595 #. type: =item
1596 #: ../src/guestfs.pod:692
1597 msgid "B<C++>"
1598 msgstr ""
1599
1600 # type: textblock
1601 #. type: textblock
1602 #: ../src/guestfs.pod:694
1603 msgid ""
1604 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1605 "identical to the C API.  C++ classes and exceptions are not used."
1606 msgstr ""
1607
1608 # type: =item
1609 #. type: =item
1610 #: ../src/guestfs.pod:698
1611 msgid "B<C#>"
1612 msgstr ""
1613
1614 # type: textblock
1615 #. type: textblock
1616 #: ../src/guestfs.pod:700
1617 msgid ""
1618 "The C# bindings are highly experimental.  Please read the warnings at the "
1619 "top of C<csharp/Libguestfs.cs>."
1620 msgstr ""
1621
1622 # type: =item
1623 #. type: =item
1624 #: ../src/guestfs.pod:703
1625 msgid "B<Haskell>"
1626 msgstr ""
1627
1628 # type: textblock
1629 #. type: textblock
1630 #: ../src/guestfs.pod:705
1631 msgid ""
1632 "This is the only language binding that is working but incomplete.  Only "
1633 "calls which return simple integers have been bound in Haskell, and we are "
1634 "looking for help to complete this binding."
1635 msgstr ""
1636
1637 # type: =item
1638 #. type: =item
1639 #: ../src/guestfs.pod:709
1640 msgid "B<Java>"
1641 msgstr ""
1642
1643 # type: textblock
1644 #. type: textblock
1645 #: ../src/guestfs.pod:711
1646 msgid ""
1647 "Full documentation is contained in the Javadoc which is distributed with "
1648 "libguestfs."
1649 msgstr ""
1650
1651 # type: =item
1652 #. type: =item
1653 #: ../src/guestfs.pod:714
1654 msgid "B<OCaml>"
1655 msgstr ""
1656
1657 #. type: textblock
1658 #: ../src/guestfs.pod:716
1659 msgid "See L<guestfs-ocaml(3)>."
1660 msgstr ""
1661
1662 # type: =item
1663 #. type: =item
1664 #: ../src/guestfs.pod:718
1665 msgid "B<Perl>"
1666 msgstr ""
1667
1668 #. type: textblock
1669 #: ../src/guestfs.pod:720
1670 msgid "See L<Sys::Guestfs(3)>."
1671 msgstr ""
1672
1673 # type: =item
1674 #. type: =item
1675 #: ../src/guestfs.pod:722
1676 msgid "B<PHP>"
1677 msgstr ""
1678
1679 # type: textblock
1680 #. type: textblock
1681 #: ../src/guestfs.pod:724
1682 msgid ""
1683 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1684 "the php-libguestfs package for your distribution."
1685 msgstr ""
1686
1687 # type: textblock
1688 #. type: textblock
1689 #: ../src/guestfs.pod:727
1690 msgid "The PHP binding only works correctly on 64 bit machines."
1691 msgstr ""
1692
1693 # type: =item
1694 #. type: =item
1695 #: ../src/guestfs.pod:729
1696 msgid "B<Python>"
1697 msgstr ""
1698
1699 #. type: textblock
1700 #: ../src/guestfs.pod:731
1701 msgid "See L<guestfs-python(3)>."
1702 msgstr ""
1703
1704 # type: =item
1705 #. type: =item
1706 #: ../src/guestfs.pod:733
1707 msgid "B<Ruby>"
1708 msgstr ""
1709
1710 #. type: textblock
1711 #: ../src/guestfs.pod:735
1712 msgid "See L<guestfs-ruby(3)>."
1713 msgstr ""
1714
1715 # type: =item
1716 #. type: =item
1717 #: ../src/guestfs.pod:737
1718 msgid "B<shell scripts>"
1719 msgstr ""
1720
1721 #. type: textblock
1722 #: ../src/guestfs.pod:739
1723 msgid "See L<guestfish(1)>."
1724 msgstr ""
1725
1726 # type: =head2
1727 #. type: =head2
1728 #: ../src/guestfs.pod:743
1729 msgid "LIBGUESTFS GOTCHAS"
1730 msgstr ""
1731
1732 # type: textblock
1733 #. type: textblock
1734 #: ../src/guestfs.pod:745
1735 msgid ""
1736 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1737 "system [...] that works in the way it is documented but is counterintuitive "
1738 "and almost invites mistakes.\""
1739 msgstr ""
1740
1741 # type: textblock
1742 #. type: textblock
1743 #: ../src/guestfs.pod:749
1744 msgid ""
1745 "Since we developed libguestfs and the associated tools, there are several "
1746 "things we would have designed differently, but are now stuck with for "
1747 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1748 "release, you can expect these to change.  Beware of them."
1749 msgstr ""
1750
1751 # type: =item
1752 #. type: =item
1753 #: ../src/guestfs.pod:757
1754 msgid "Autosync / forgetting to sync."
1755 msgstr ""
1756
1757 # type: textblock
1758 #. type: textblock
1759 #: ../src/guestfs.pod:759
1760 msgid ""
1761 "When modifying a filesystem from C or another language, you B<must> unmount "
1762 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1763 "libguestfs handle.  You can also call:"
1764 msgstr ""
1765
1766 # type: verbatim
1767 #. type: verbatim
1768 #: ../src/guestfs.pod:763
1769 #, no-wrap
1770 msgid ""
1771 " guestfs_set_autosync (g, 1);\n"
1772 "\n"
1773 msgstr ""
1774
1775 # type: textblock
1776 #. type: textblock
1777 #: ../src/guestfs.pod:765
1778 msgid ""
1779 "to have the unmount/sync done automatically for you when the handle 'g' is "
1780 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1781 msgstr ""
1782
1783 # type: textblock
1784 #. type: textblock
1785 #: ../src/guestfs.pod:769
1786 msgid ""
1787 "If you forget to do this, then it is entirely possible that your changes "
1788 "won't be written out, or will be partially written, or (very rarely) that "
1789 "you'll get disk corruption."
1790 msgstr ""
1791
1792 # type: textblock
1793 #. type: textblock
1794 #: ../src/guestfs.pod:773
1795 msgid ""
1796 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1797 "guestfish scripts that forget to sync will work just fine, which can make "
1798 "this very puzzling if you are trying to debug a problem."
1799 msgstr ""
1800
1801 # type: textblock
1802 #. type: textblock
1803 #: ../src/guestfs.pod:777
1804 msgid ""
1805 "Update: Autosync is enabled by default for all API users starting from "
1806 "libguestfs 1.5.24."
1807 msgstr ""
1808
1809 # type: =item
1810 #. type: =item
1811 #: ../src/guestfs.pod:780
1812 msgid "Mount option C<-o sync> should not be the default."
1813 msgstr ""
1814
1815 # type: textblock
1816 #. type: textblock
1817 #: ../src/guestfs.pod:782
1818 msgid ""
1819 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1820 "However C<-o sync> does not add any reliability benefit, but does have a "
1821 "very large performance impact."
1822 msgstr ""
1823
1824 # type: textblock
1825 #. type: textblock
1826 #: ../src/guestfs.pod:786
1827 msgid ""
1828 "The work around is to use L</guestfs_mount_options> and set the mount "
1829 "options that you actually want to use."
1830 msgstr ""
1831
1832 # type: =item
1833 #. type: =item
1834 #: ../src/guestfs.pod:789
1835 msgid "Read-only should be the default."
1836 msgstr ""
1837
1838 # type: textblock
1839 #. type: textblock
1840 #: ../src/guestfs.pod:791
1841 msgid ""
1842 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1843 "specify I<--rw> if you want to make changes to the image."
1844 msgstr ""
1845
1846 # type: textblock
1847 #. type: textblock
1848 #: ../src/guestfs.pod:794
1849 msgid "This would reduce the potential to corrupt live VM images."
1850 msgstr ""
1851
1852 # type: textblock
1853 #. type: textblock
1854 #: ../src/guestfs.pod:796
1855 msgid ""
1856 "Note that many filesystems change the disk when you just mount and unmount, "
1857 "even if you didn't perform any writes.  You need to use L</"
1858 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1859 msgstr ""
1860
1861 # type: =item
1862 #. type: =item
1863 #: ../src/guestfs.pod:800
1864 msgid "guestfish command line is hard to use."
1865 msgstr ""
1866
1867 # type: textblock
1868 #. type: textblock
1869 #: ../src/guestfs.pod:802
1870 msgid ""
1871 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1872 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1873 "exist, so it fails.  In earlier versions of guestfish the error message was "
1874 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1875 "we should have used C<guestfish -c command> to run commands."
1876 msgstr ""
1877
1878 # type: =item
1879 #. type: =item
1880 #: ../src/guestfs.pod:809
1881 msgid "guestfish megabyte modifiers don't work right on all commands"
1882 msgstr ""
1883
1884 # type: textblock
1885 #. type: textblock
1886 #: ../src/guestfs.pod:811
1887 msgid ""
1888 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1889 "other modifiers).  What guestfish actually does is to multiply the number "
1890 "part by the modifier part and pass the result to the C API.  However this "
1891 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1892 "expecting some other unit (eg. megabytes)."
1893 msgstr ""
1894
1895 # type: textblock
1896 #. type: textblock
1897 #: ../src/guestfs.pod:818
1898 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1899 msgstr ""
1900
1901 # type: verbatim
1902 #. type: verbatim
1903 #: ../src/guestfs.pod:820
1904 #, no-wrap
1905 msgid ""
1906 " lvcreate LV VG 100M\n"
1907 "\n"
1908 msgstr ""
1909
1910 # type: textblock
1911 #. type: textblock
1912 #: ../src/guestfs.pod:822
1913 msgid ""
1914 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1915 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1916 "megabytes * megabytes) logical volume.  The error message you get from this "
1917 "is also a little obscure."
1918 msgstr ""
1919
1920 # type: textblock
1921 #. type: textblock
1922 #: ../src/guestfs.pod:827
1923 msgid ""
1924 "This could be fixed in the generator by specially marking parameters and "
1925 "return values which take bytes or other units."
1926 msgstr ""
1927
1928 # type: =item
1929 #. type: =item
1930 #: ../src/guestfs.pod:830
1931 msgid "Ambiguity between devices and paths"
1932 msgstr ""
1933
1934 # type: textblock
1935 #. type: textblock
1936 #: ../src/guestfs.pod:832
1937 msgid ""
1938 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1939 "sdb2>) and a similar pathname.  A file might just happen to be called "
1940 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1941 msgstr ""
1942
1943 # type: textblock
1944 #. type: textblock
1945 #: ../src/guestfs.pod:837
1946 msgid ""
1947 "In the current API we usually resolve this ambiguity by having two separate "
1948 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1949 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1950 "detecting if the path supplied begins with C</dev/>."
1951 msgstr ""
1952
1953 # type: textblock
1954 #. type: textblock
1955 #: ../src/guestfs.pod:843
1956 msgid ""
1957 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1958 "make paths/devices into structured names.  One way to do this would be to "
1959 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1960 "aspect of grub.  Another way would be to use a structured type, equivalent "
1961 "to this OCaml type:"
1962 msgstr ""
1963
1964 # type: verbatim
1965 #. type: verbatim
1966 #: ../src/guestfs.pod:849
1967 #, no-wrap
1968 msgid ""
1969 " type path = Path of string | Device of int | Partition of int * int\n"
1970 "\n"
1971 msgstr ""
1972
1973 # type: textblock
1974 #. type: textblock
1975 #: ../src/guestfs.pod:851
1976 msgid "which would allow you to pass arguments like:"
1977 msgstr ""
1978
1979 # type: verbatim
1980 #. type: verbatim
1981 #: ../src/guestfs.pod:853
1982 #, no-wrap
1983 msgid ""
1984 " Path \"/foo/bar\"\n"
1985 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
1986 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
1987 " Path \"/dev/sdb2\"    (* not a device *)\n"
1988 "\n"
1989 msgstr ""
1990
1991 # type: textblock
1992 #. type: textblock
1993 #: ../src/guestfs.pod:858
1994 msgid ""
1995 "As you can see there are still problems to resolve even with this "
1996 "representation.  Also consider how it might work in guestfish."
1997 msgstr ""
1998
1999 # type: =head2
2000 #. type: =head2
2001 #: ../src/guestfs.pod:863
2002 msgid "PROTOCOL LIMITS"
2003 msgstr ""
2004
2005 # type: textblock
2006 #. type: textblock
2007 #: ../src/guestfs.pod:865
2008 msgid ""
2009 "Internally libguestfs uses a message-based protocol to pass API calls and "
2010 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
2011 "plenty more detail about this).  The maximum message size used by the "
2012 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
2013 "aware of this limit.  The API calls which may be affected are individually "
2014 "documented, with a link back to this section of the documentation."
2015 msgstr ""
2016
2017 # type: textblock
2018 #. type: textblock
2019 #: ../src/guestfs.pod:873
2020 msgid ""
2021 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
2022 "a simple string.  Because this string is at some point internally encoded as "
2023 "a message, the maximum size that it can return is slightly under 4 MB.  If "
2024 "the requested file is larger than this then you will get an error."
2025 msgstr ""
2026
2027 # type: textblock
2028 #. type: textblock
2029 #: ../src/guestfs.pod:879
2030 msgid ""
2031 "In order to transfer large files into and out of the guest filesystem, you "
2032 "need to use particular calls that support this.  The sections L</UPLOADING> "
2033 "and L</DOWNLOADING> document how to do this."
2034 msgstr ""
2035
2036 # type: textblock
2037 #. type: textblock
2038 #: ../src/guestfs.pod:883
2039 msgid ""
2040 "You might also consider mounting the disk image using our FUSE filesystem "
2041 "support (L<guestmount(1)>)."
2042 msgstr ""
2043
2044 # type: =head2
2045 #. type: =head2
2046 #: ../src/guestfs.pod:886
2047 msgid "KEYS AND PASSPHRASES"
2048 msgstr ""
2049
2050 # type: textblock
2051 #. type: textblock
2052 #: ../src/guestfs.pod:888
2053 msgid ""
2054 "Certain libguestfs calls take a parameter that contains sensitive key "
2055 "material, passed in as a C string."
2056 msgstr ""
2057
2058 # type: textblock
2059 #. type: textblock
2060 #: ../src/guestfs.pod:891
2061 msgid ""
2062 "In the future we would hope to change the libguestfs implementation so that "
2063 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2064 "swap.  However this is I<not> done at the moment, because of the complexity "
2065 "of such an implementation."
2066 msgstr ""
2067
2068 # type: textblock
2069 #. type: textblock
2070 #: ../src/guestfs.pod:896
2071 msgid ""
2072 "Therefore you should be aware that any key parameter you pass to libguestfs "
2073 "might end up being written out to the swap partition.  If this is a concern, "
2074 "scrub the swap partition or don't use libguestfs on encrypted devices."
2075 msgstr ""
2076
2077 # type: =head1
2078 #. type: =head2
2079 #: ../src/guestfs.pod:901
2080 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2081 msgstr ""
2082
2083 # type: textblock
2084 #. type: textblock
2085 #: ../src/guestfs.pod:903
2086 msgid ""
2087 "All high-level libguestfs actions are synchronous.  If you want to use "
2088 "libguestfs asynchronously then you must create a thread."
2089 msgstr ""
2090
2091 # type: textblock
2092 #. type: textblock
2093 #: ../src/guestfs.pod:906
2094 msgid ""
2095 "Only use the handle from a single thread.  Either use the handle exclusively "
2096 "from one thread, or provide your own mutex so that two threads cannot issue "
2097 "calls on the same handle at the same time."
2098 msgstr ""
2099
2100 # type: textblock
2101 #. type: textblock
2102 #: ../src/guestfs.pod:910
2103 msgid ""
2104 "See the graphical program guestfs-browser for one possible architecture for "
2105 "multithreaded programs using libvirt and libguestfs."
2106 msgstr ""
2107
2108 # type: =head1
2109 #. type: =head2
2110 #: ../src/guestfs.pod:913
2111 msgid "PATH"
2112 msgstr ""
2113
2114 #. type: textblock
2115 #: ../src/guestfs.pod:915
2116 msgid ""
2117 "Libguestfs needs a supermin appliance, which it finds by looking along an "
2118 "internal path."
2119 msgstr ""
2120
2121 # type: textblock
2122 #. type: textblock
2123 #: ../src/guestfs.pod:918
2124 msgid ""
2125 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2126 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2127 msgstr ""
2128
2129 # type: textblock
2130 #. type: textblock
2131 #: ../src/guestfs.pod:921
2132 msgid ""
2133 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2134 "to change the directories that libguestfs will search in.  The value is a "
2135 "colon-separated list of paths.  The current directory is I<not> searched "
2136 "unless the path contains an empty element or C<.>.  For example "
2137 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2138 "then C</usr/lib/guestfs>."
2139 msgstr ""
2140
2141 # type: =head1
2142 #. type: =head2
2143 #: ../src/guestfs.pod:928
2144 msgid "QEMU WRAPPERS"
2145 msgstr ""
2146
2147 # type: textblock
2148 #. type: textblock
2149 #: ../src/guestfs.pod:930
2150 msgid ""
2151 "If you want to compile your own qemu, run qemu from a non-standard location, "
2152 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2153 "around qemu."
2154 msgstr ""
2155
2156 # type: textblock
2157 #. type: textblock
2158 #: ../src/guestfs.pod:934
2159 msgid ""
2160 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2161 "last command in the shell script (so that qemu replaces the shell and "
2162 "becomes the direct child of the libguestfs-using program).  If you don't do "
2163 "this, then the qemu process won't be cleaned up correctly."
2164 msgstr ""
2165
2166 # type: textblock
2167 #. type: textblock
2168 #: ../src/guestfs.pod:939
2169 msgid ""
2170 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2171 "source:"
2172 msgstr ""
2173
2174 # type: verbatim
2175 #. type: verbatim
2176 #: ../src/guestfs.pod:942
2177 #, no-wrap
2178 msgid ""
2179 " #!/bin/sh -\n"
2180 " qemudir=/home/rjones/d/qemu\n"
2181 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2182 "\n"
2183 msgstr ""
2184
2185 # type: textblock
2186 #. type: textblock
2187 #: ../src/guestfs.pod:946
2188 msgid ""
2189 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2190 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2191 "example:"
2192 msgstr ""
2193
2194 # type: verbatim
2195 #. type: verbatim
2196 #: ../src/guestfs.pod:950
2197 #, no-wrap
2198 msgid ""
2199 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2200 "\n"
2201 msgstr ""
2202
2203 # type: textblock
2204 #. type: textblock
2205 #: ../src/guestfs.pod:952
2206 msgid ""
2207 "Note that libguestfs also calls qemu with the -help and -version options in "
2208 "order to determine features."
2209 msgstr ""
2210
2211 # type: =head2
2212 #. type: =head2
2213 #: ../src/guestfs.pod:955
2214 msgid "ABI GUARANTEE"
2215 msgstr ""
2216
2217 # type: textblock
2218 #. type: textblock
2219 #: ../src/guestfs.pod:957
2220 msgid ""
2221 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2222 "actions as outlined in this section.  Although we will deprecate some "
2223 "actions, for example if they get replaced by newer calls, we will keep the "
2224 "old actions forever.  This allows you the developer to program in confidence "
2225 "against the libguestfs API."
2226 msgstr ""
2227
2228 # type: =head1
2229 #. type: =head2
2230 #: ../src/guestfs.pod:963
2231 msgid "BLOCK DEVICE NAMING"
2232 msgstr ""
2233
2234 # type: textblock
2235 #. type: textblock
2236 #: ../src/guestfs.pod:965
2237 msgid ""
2238 "In the kernel there is now quite a profusion of schemata for naming block "
2239 "devices (in this context, by I<block device> I mean a physical or virtual "
2240 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2241 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2242 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2243 "for the old IDE driver (particularly for SATA devices) those devices also "
2244 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2245 "paravirtualized drivers.  This has created several different naming systems, "
2246 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2247 msgstr ""
2248
2249 # type: textblock
2250 #. type: textblock
2251 #: ../src/guestfs.pod:977
2252 msgid ""
2253 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2254 "Linux kernel to access block devices.  We can run a variety of appliances "
2255 "based on a variety of Linux kernels."
2256 msgstr ""
2257
2258 # type: textblock
2259 #. type: textblock
2260 #: ../src/guestfs.pod:981
2261 msgid ""
2262 "This causes a problem for libguestfs because many API calls use device or "
2263 "partition names.  Working scripts and the recipe (example) scripts that we "
2264 "make available over the internet could fail if the naming scheme changes."
2265 msgstr ""
2266
2267 # type: textblock
2268 #. type: textblock
2269 #: ../src/guestfs.pod:986
2270 msgid ""
2271 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2272 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2273 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2274 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2275 msgstr ""
2276
2277 # type: textblock
2278 #. type: textblock
2279 #: ../src/guestfs.pod:992
2280 msgid ""
2281 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2282 "L</guestfs_list_partitions> and similar calls return the true names of the "
2283 "devices and partitions as known to the appliance."
2284 msgstr ""
2285
2286 # type: =head2
2287 #. type: =head3
2288 #: ../src/guestfs.pod:997
2289 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2290 msgstr ""
2291
2292 # type: textblock
2293 #. type: textblock
2294 #: ../src/guestfs.pod:999
2295 msgid ""
2296 "Usually this translation is transparent.  However in some (very rare)  cases "
2297 "you may need to know the exact algorithm.  Such cases include where you use "
2298 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2299 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2300 msgstr ""
2301
2302 # type: textblock
2303 #. type: textblock
2304 #: ../src/guestfs.pod:1005
2305 msgid ""
2306 "The algorithm is applied only to I<parameters> which are known to be either "
2307 "device or partition names.  Return values from functions such as L</"
2308 "guestfs_list_devices> are never changed."
2309 msgstr ""
2310
2311 # type: textblock
2312 #. type: textblock
2313 #: ../src/guestfs.pod:1013
2314 msgid "Is the string a parameter which is a device or partition name?"
2315 msgstr ""
2316
2317 # type: textblock
2318 #. type: textblock
2319 #: ../src/guestfs.pod:1017
2320 msgid "Does the string begin with C</dev/sd>?"
2321 msgstr ""
2322
2323 # type: textblock
2324 #. type: textblock
2325 #: ../src/guestfs.pod:1021
2326 msgid ""
2327 "Does the named device exist? If so, we use that device.  However if I<not> "
2328 "then we continue with this algorithm."
2329 msgstr ""
2330
2331 # type: textblock
2332 #. type: textblock
2333 #: ../src/guestfs.pod:1026
2334 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2335 msgstr ""
2336
2337 # type: textblock
2338 #. type: textblock
2339 #: ../src/guestfs.pod:1028
2340 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2341 msgstr ""
2342
2343 # type: textblock
2344 #. type: textblock
2345 #: ../src/guestfs.pod:1030
2346 msgid "If that named device exists, use it.  If not, continue."
2347 msgstr ""
2348
2349 # type: textblock
2350 #. type: textblock
2351 #: ../src/guestfs.pod:1034
2352 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2353 msgstr ""
2354
2355 # type: textblock
2356 #. type: textblock
2357 #: ../src/guestfs.pod:1036
2358 msgid "If that named device exists, use it.  If not, return an error."
2359 msgstr ""
2360
2361 # type: =head3
2362 #. type: =head3
2363 #: ../src/guestfs.pod:1040
2364 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2365 msgstr ""
2366
2367 # type: textblock
2368 #. type: textblock
2369 #: ../src/guestfs.pod:1042
2370 msgid ""
2371 "Although the standard naming scheme and automatic translation is useful for "
2372 "simple programs and guestfish scripts, for larger programs it is best not to "
2373 "rely on this mechanism."
2374 msgstr ""
2375
2376 # type: textblock
2377 #. type: textblock
2378 #: ../src/guestfs.pod:1046
2379 msgid ""
2380 "Where possible for maximum future portability programs using libguestfs "
2381 "should use these future-proof techniques:"
2382 msgstr ""
2383
2384 # type: textblock
2385 #. type: textblock
2386 #: ../src/guestfs.pod:1053
2387 msgid ""
2388 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2389 "device names, and then use those names directly."
2390 msgstr ""
2391
2392 # type: textblock
2393 #. type: textblock
2394 #: ../src/guestfs.pod:1056
2395 msgid ""
2396 "Since those device names exist by definition, they will never be translated."
2397 msgstr ""
2398
2399 # type: textblock
2400 #. type: textblock
2401 #: ../src/guestfs.pod:1061
2402 msgid ""
2403 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2404 "filesystem labels."
2405 msgstr ""
2406
2407 # type: =head1
2408 #. type: =head1
2409 #: ../src/guestfs.pod:1066
2410 msgid "SECURITY"
2411 msgstr ""
2412
2413 # type: textblock
2414 #. type: textblock
2415 #: ../src/guestfs.pod:1068
2416 msgid ""
2417 "This section discusses security implications of using libguestfs, "
2418 "particularly with untrusted or malicious guests or disk images."
2419 msgstr ""
2420
2421 # type: =head2
2422 #. type: =head2
2423 #: ../src/guestfs.pod:1071
2424 msgid "GENERAL SECURITY CONSIDERATIONS"
2425 msgstr ""
2426
2427 # type: textblock
2428 #. type: textblock
2429 #: ../src/guestfs.pod:1073
2430 msgid ""
2431 "Be careful with any files or data that you download from a guest (by "
2432 "\"download\" we mean not just the L</guestfs_download> command but any "
2433 "command that reads files, filenames, directories or anything else from a "
2434 "disk image).  An attacker could manipulate the data to fool your program "
2435 "into doing the wrong thing.  Consider cases such as:"
2436 msgstr ""
2437
2438 # type: textblock
2439 #. type: textblock
2440 #: ../src/guestfs.pod:1083
2441 msgid "the data (file etc) not being present"
2442 msgstr ""
2443
2444 # type: textblock
2445 #. type: textblock
2446 #: ../src/guestfs.pod:1087
2447 msgid "being present but empty"
2448 msgstr ""
2449
2450 # type: textblock
2451 #. type: textblock
2452 #: ../src/guestfs.pod:1091
2453 msgid "being much larger than normal"
2454 msgstr ""
2455
2456 # type: textblock
2457 #. type: textblock
2458 #: ../src/guestfs.pod:1095
2459 msgid "containing arbitrary 8 bit data"
2460 msgstr ""
2461
2462 # type: textblock
2463 #. type: textblock
2464 #: ../src/guestfs.pod:1099
2465 msgid "being in an unexpected character encoding"
2466 msgstr ""
2467
2468 # type: textblock
2469 #. type: textblock
2470 #: ../src/guestfs.pod:1103
2471 msgid "containing homoglyphs."
2472 msgstr ""
2473
2474 # type: =head2
2475 #. type: =head2
2476 #: ../src/guestfs.pod:1107
2477 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2478 msgstr ""
2479
2480 # type: textblock
2481 #. type: textblock
2482 #: ../src/guestfs.pod:1109
2483 msgid ""
2484 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2485 "(VFS) module can sometimes be escalated into exploits by deliberately "
2486 "creating a malicious, malformed filesystem.  These exploits are very severe "
2487 "for two reasons.  Firstly there are very many filesystem drivers in the "
2488 "kernel, and many of them are infrequently used and not much developer "
2489 "attention has been paid to the code.  Linux userspace helps potential "
2490 "crackers by detecting the filesystem type and automatically choosing the "
2491 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2492 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2493 "exploit (worse in some ways), giving immediate and total access to the "
2494 "system right down to the hardware level."
2495 msgstr ""
2496
2497 # type: textblock
2498 #. type: textblock
2499 #: ../src/guestfs.pod:1122
2500 msgid ""
2501 "That explains why you should never mount a filesystem from an untrusted "
2502 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2503 "inside a qemu virtual machine, usually running as a non-root user.  The "
2504 "attacker would need to write a filesystem which first exploited the kernel, "
2505 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2506 "the libguestfs protocol, and finally to be as serious as the host kernel "
2507 "exploit it would need to escalate its privileges to root.  This multi-step "
2508 "escalation, performed by a static piece of data, is thought to be extremely "
2509 "hard to do, although we never say 'never' about security issues."
2510 msgstr ""
2511
2512 # type: textblock
2513 #. type: textblock
2514 #: ../src/guestfs.pod:1133
2515 msgid ""
2516 "In any case callers can reduce the attack surface by forcing the filesystem "
2517 "type when mounting (use L</guestfs_mount_vfs>)."
2518 msgstr ""
2519
2520 # type: =head2
2521 #. type: =head2
2522 #: ../src/guestfs.pod:1136
2523 msgid "PROTOCOL SECURITY"
2524 msgstr ""
2525
2526 # type: textblock
2527 #. type: textblock
2528 #: ../src/guestfs.pod:1138
2529 msgid ""
2530 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2531 "defined upper message size.  However a program that uses libguestfs must "
2532 "also take care - for example you can write a program that downloads a binary "
2533 "from a disk image and executes it locally, and no amount of protocol "
2534 "security will save you from the consequences."
2535 msgstr ""
2536
2537 # type: =head2
2538 #. type: =head2
2539 #: ../src/guestfs.pod:1144
2540 msgid "INSPECTION SECURITY"
2541 msgstr ""
2542
2543 # type: textblock
2544 #. type: textblock
2545 #: ../src/guestfs.pod:1146
2546 msgid ""
2547 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2548 "directly from the guest, and these could contain any 8 bit data.  Callers "
2549 "should be careful to escape these before printing them to a structured file "
2550 "(for example, use HTML escaping if creating a web page)."
2551 msgstr ""
2552
2553 # type: textblock
2554 #. type: textblock
2555 #: ../src/guestfs.pod:1152
2556 msgid ""
2557 "Guest configuration may be altered in unusual ways by the administrator of "
2558 "the virtual machine, and may not reflect reality (particularly for untrusted "
2559 "or actively malicious guests).  For example we parse the hostname from "
2560 "configuration files like C</etc/sysconfig/network> that we find in the "
2561 "guest, but the guest administrator can easily manipulate these files to "
2562 "provide the wrong hostname."
2563 msgstr ""
2564
2565 # type: textblock
2566 #. type: textblock
2567 #: ../src/guestfs.pod:1160
2568 msgid ""
2569 "The inspection API parses guest configuration using two external libraries: "
2570 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2571 "designed to be robust in the face of malicious data, although denial of "
2572 "service attacks are still possible, for example with oversized configuration "
2573 "files."
2574 msgstr ""
2575
2576 # type: =head2
2577 #. type: =head2
2578 #: ../src/guestfs.pod:1166
2579 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2580 msgstr ""
2581
2582 # type: textblock
2583 #. type: textblock
2584 #: ../src/guestfs.pod:1168
2585 msgid ""
2586 "Be very cautious about running commands from the guest.  By running a "
2587 "command in the guest, you are giving CPU time to a binary that you do not "
2588 "control, under the same user account as the library, albeit wrapped in qemu "
2589 "virtualization.  More information and alternatives can be found in the "
2590 "section L</RUNNING COMMANDS>."
2591 msgstr ""
2592
2593 # type: =head2
2594 #. type: =head2
2595 #: ../src/guestfs.pod:1174
2596 msgid "CVE-2010-3851"
2597 msgstr ""
2598
2599 # type: textblock
2600 #. type: textblock
2601 #: ../src/guestfs.pod:1176
2602 msgid "https://bugzilla.redhat.com/642934"
2603 msgstr ""
2604
2605 # type: textblock
2606 #. type: textblock
2607 #: ../src/guestfs.pod:1178
2608 msgid ""
2609 "This security bug concerns the automatic disk format detection that qemu "
2610 "does on disk images."
2611 msgstr ""
2612
2613 # type: textblock
2614 #. type: textblock
2615 #: ../src/guestfs.pod:1181
2616 msgid ""
2617 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2618 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2619 "for one of the known headers, and if none is found then assuming the disk "
2620 "image must be raw."
2621 msgstr ""
2622
2623 # type: textblock
2624 #. type: textblock
2625 #: ../src/guestfs.pod:1186
2626 msgid ""
2627 "This allows a guest which has been given a raw disk image to write some "
2628 "other header.  At next boot (or when the disk image is accessed by "
2629 "libguestfs) qemu would do autodetection and think the disk image format was, "
2630 "say, qcow2 based on the header written by the guest."
2631 msgstr ""
2632
2633 # type: textblock
2634 #. type: textblock
2635 #: ../src/guestfs.pod:1191
2636 msgid ""
2637 "This in itself would not be a problem, but qcow2 offers many features, one "
2638 "of which is to allow a disk image to refer to another image (called the "
2639 "\"backing disk\").  It does this by placing the path to the backing disk "
2640 "into the qcow2 header.  This path is not validated and could point to any "
2641 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2642 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2643 "control of the attacker."
2644 msgstr ""
2645
2646 # type: textblock
2647 #. type: textblock
2648 #: ../src/guestfs.pod:1199
2649 msgid ""
2650 "In libguestfs this is rather hard to exploit except under two circumstances:"
2651 msgstr ""
2652
2653 # type: textblock
2654 #. type: textblock
2655 #: ../src/guestfs.pod:1206
2656 msgid "You have enabled the network or have opened the disk in write mode."
2657 msgstr ""
2658
2659 # type: textblock
2660 #. type: textblock
2661 #: ../src/guestfs.pod:1210
2662 msgid ""
2663 "You are also running untrusted code from the guest (see L</RUNNING "
2664 "COMMANDS>)."
2665 msgstr ""
2666
2667 # type: textblock
2668 #. type: textblock
2669 #: ../src/guestfs.pod:1215
2670 msgid ""
2671 "The way to avoid this is to specify the expected disk format when adding "
2672 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2673 "should always do this if the disk is raw format, and it's a good idea for "
2674 "other cases too."
2675 msgstr ""
2676
2677 # type: textblock
2678 #. type: textblock
2679 #: ../src/guestfs.pod:1220
2680 msgid ""
2681 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2682 "format is fetched from libvirt and passed through."
2683 msgstr ""
2684
2685 # type: textblock
2686 #. type: textblock
2687 #: ../src/guestfs.pod:1223
2688 msgid ""
2689 "For libguestfs tools, use the I<--format> command line parameter as "
2690 "appropriate."
2691 msgstr ""
2692
2693 # type: =head1
2694 #. type: =head1
2695 #: ../src/guestfs.pod:1226
2696 msgid "CONNECTION MANAGEMENT"
2697 msgstr ""
2698
2699 # type: =head2
2700 #. type: =head2
2701 #: ../src/guestfs.pod:1228
2702 msgid "guestfs_h *"
2703 msgstr ""
2704
2705 # type: textblock
2706 #. type: textblock
2707 #: ../src/guestfs.pod:1230
2708 msgid ""
2709 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2710 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2711 "handle and release all resources used."
2712 msgstr ""
2713
2714 # type: textblock
2715 #. type: textblock
2716 #: ../src/guestfs.pod:1234
2717 msgid ""
2718 "For information on using multiple handles and threads, see the section L</"
2719 "MULTIPLE HANDLES AND MULTIPLE THREADS> below."
2720 msgstr ""
2721
2722 # type: =head2
2723 #. type: =head2
2724 #: ../src/guestfs.pod:1237
2725 msgid "guestfs_create"
2726 msgstr ""
2727
2728 # type: verbatim
2729 #. type: verbatim
2730 #: ../src/guestfs.pod:1239
2731 #, no-wrap
2732 msgid ""
2733 " guestfs_h *guestfs_create (void);\n"
2734 "\n"
2735 msgstr ""
2736
2737 # type: textblock
2738 #. type: textblock
2739 #: ../src/guestfs.pod:1241
2740 msgid "Create a connection handle."
2741 msgstr ""
2742
2743 # type: textblock
2744 #. type: textblock
2745 #: ../src/guestfs.pod:1243
2746 msgid ""
2747 "You have to call L</guestfs_add_drive_opts> (or one of the equivalent calls) "
2748 "on the handle at least once."
2749 msgstr ""
2750
2751 # type: textblock
2752 #. type: textblock
2753 #: ../src/guestfs.pod:1246
2754 msgid ""
2755 "This function returns a non-NULL pointer to a handle on success or NULL on "
2756 "error."
2757 msgstr ""
2758
2759 # type: textblock
2760 #. type: textblock
2761 #: ../src/guestfs.pod:1249
2762 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2763 msgstr ""
2764
2765 # type: textblock
2766 #. type: textblock
2767 #: ../src/guestfs.pod:1251
2768 msgid ""
2769 "You may also want to configure error handling for the handle.  See L</ERROR "
2770 "HANDLING> section below."
2771 msgstr ""
2772
2773 # type: =head2
2774 #. type: =head2
2775 #: ../src/guestfs.pod:1254
2776 msgid "guestfs_close"
2777 msgstr ""
2778
2779 # type: verbatim
2780 #. type: verbatim
2781 #: ../src/guestfs.pod:1256
2782 #, no-wrap
2783 msgid ""
2784 " void guestfs_close (guestfs_h *g);\n"
2785 "\n"
2786 msgstr ""
2787
2788 # type: textblock
2789 #. type: textblock
2790 #: ../src/guestfs.pod:1258
2791 msgid "This closes the connection handle and frees up all resources used."
2792 msgstr ""
2793
2794 # type: =head1
2795 #. type: =head1
2796 #: ../src/guestfs.pod:1260
2797 msgid "ERROR HANDLING"
2798 msgstr ""
2799
2800 # type: textblock
2801 #. type: textblock
2802 #: ../src/guestfs.pod:1262
2803 msgid ""
2804 "API functions can return errors.  For example, almost all functions that "
2805 "return C<int> will return C<-1> to indicate an error."
2806 msgstr ""
2807
2808 # type: textblock
2809 #. type: textblock
2810 #: ../src/guestfs.pod:1265
2811 msgid ""
2812 "Additional information is available for errors: an error message string and "
2813 "optionally an error number (errno) if the thing that failed was a system "
2814 "call."
2815 msgstr ""
2816
2817 # type: textblock
2818 #. type: textblock
2819 #: ../src/guestfs.pod:1269
2820 msgid ""
2821 "You can get at the additional information about the last error on the handle "
2822 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2823 "up an error handler with L</guestfs_set_error_handler>."
2824 msgstr ""
2825
2826 # type: textblock
2827 #. type: textblock
2828 #: ../src/guestfs.pod:1274
2829 msgid ""
2830 "When the handle is created, a default error handler is installed which "
2831 "prints the error message string to C<stderr>.  For small short-running "
2832 "command line programs it is sufficient to do:"
2833 msgstr ""
2834
2835 # type: verbatim
2836 #. type: verbatim
2837 #: ../src/guestfs.pod:1278
2838 #, no-wrap
2839 msgid ""
2840 " if (guestfs_launch (g) == -1)\n"
2841 "   exit (EXIT_FAILURE);\n"
2842 "\n"
2843 msgstr ""
2844
2845 # type: textblock
2846 #. type: textblock
2847 #: ../src/guestfs.pod:1281
2848 msgid ""
2849 "since the default error handler will ensure that an error message has been "
2850 "printed to C<stderr> before the program exits."
2851 msgstr ""
2852
2853 # type: textblock
2854 #. type: textblock
2855 #: ../src/guestfs.pod:1284
2856 msgid ""
2857 "For other programs the caller will almost certainly want to install an "
2858 "alternate error handler or do error handling in-line like this:"
2859 msgstr ""
2860
2861 # type: verbatim
2862 #. type: verbatim
2863 #: ../src/guestfs.pod:1287
2864 #, no-wrap
2865 msgid ""
2866 " g = guestfs_create ();\n"
2867 " \n"
2868 msgstr ""
2869
2870 # type: verbatim
2871 #. type: verbatim
2872 #: ../src/guestfs.pod:1289
2873 #, no-wrap
2874 msgid ""
2875 " /* This disables the default behaviour of printing errors\n"
2876 "    on stderr. */\n"
2877 " guestfs_set_error_handler (g, NULL, NULL);\n"
2878 " \n"
2879 msgstr ""
2880
2881 # type: verbatim
2882 #. type: verbatim
2883 #: ../src/guestfs.pod:1293
2884 #, no-wrap
2885 msgid ""
2886 " if (guestfs_launch (g) == -1) {\n"
2887 "   /* Examine the error message and print it etc. */\n"
2888 "   char *msg = guestfs_last_error (g);\n"
2889 "   int errnum = guestfs_last_errno (g);\n"
2890 "   fprintf (stderr, \"%s\\n\", msg);\n"
2891 "   /* ... */\n"
2892 "  }\n"
2893 "\n"
2894 msgstr ""
2895
2896 # type: textblock
2897 #. type: textblock
2898 #: ../src/guestfs.pod:1301
2899 msgid ""
2900 "Out of memory errors are handled differently.  The default action is to call "
2901 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
2902 "guestfs_set_out_of_memory_handler>."
2903 msgstr ""
2904
2905 # type: textblock
2906 #. type: textblock
2907 #: ../src/guestfs.pod:1305
2908 msgid ""
2909 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
2910 "because there is no handle if this happens there is no way to get additional "
2911 "error information.  However L</guestfs_create> is supposed to be a "
2912 "lightweight operation which can only fail because of insufficient memory (it "
2913 "returns NULL in this case)."
2914 msgstr ""
2915
2916 # type: =head2
2917 #. type: =head2
2918 #: ../src/guestfs.pod:1311
2919 msgid "guestfs_last_error"
2920 msgstr ""
2921
2922 # type: verbatim
2923 #. type: verbatim
2924 #: ../src/guestfs.pod:1313
2925 #, no-wrap
2926 msgid ""
2927 " const char *guestfs_last_error (guestfs_h *g);\n"
2928 "\n"
2929 msgstr ""
2930
2931 # type: textblock
2932 #. type: textblock
2933 #: ../src/guestfs.pod:1315
2934 msgid ""
2935 "This returns the last error message that happened on C<g>.  If there has not "
2936 "been an error since the handle was created, then this returns C<NULL>."
2937 msgstr ""
2938
2939 # type: textblock
2940 #. type: textblock
2941 #: ../src/guestfs.pod:1319
2942 msgid ""
2943 "The lifetime of the returned string is until the next error occurs, or L</"
2944 "guestfs_close> is called."
2945 msgstr ""
2946
2947 # type: =head2
2948 #. type: =head2
2949 #: ../src/guestfs.pod:1322
2950 msgid "guestfs_last_errno"
2951 msgstr ""
2952
2953 # type: verbatim
2954 #. type: verbatim
2955 #: ../src/guestfs.pod:1324
2956 #, no-wrap
2957 msgid ""
2958 " int guestfs_last_errno (guestfs_h *g);\n"
2959 "\n"
2960 msgstr ""
2961
2962 # type: textblock
2963 #. type: textblock
2964 #: ../src/guestfs.pod:1326
2965 msgid "This returns the last error number (errno) that happened on C<g>."
2966 msgstr ""
2967
2968 # type: textblock
2969 #. type: textblock
2970 #: ../src/guestfs.pod:1328
2971 msgid "If successful, an errno integer not equal to zero is returned."
2972 msgstr ""
2973
2974 # type: textblock
2975 #. type: textblock
2976 #: ../src/guestfs.pod:1330
2977 msgid ""
2978 "If no error, this returns 0.  This call can return 0 in three situations:"
2979 msgstr ""
2980
2981 # type: textblock
2982 #. type: textblock
2983 #: ../src/guestfs.pod:1337
2984 msgid "There has not been any error on the handle."
2985 msgstr ""
2986
2987 # type: textblock
2988 #. type: textblock
2989 #: ../src/guestfs.pod:1341
2990 msgid ""
2991 "There has been an error but the errno was meaningless.  This corresponds to "
2992 "the case where the error did not come from a failed system call, but for "
2993 "some other reason."
2994 msgstr ""
2995
2996 # type: textblock
2997 #. type: textblock
2998 #: ../src/guestfs.pod:1347
2999 msgid ""
3000 "There was an error from a failed system call, but for some reason the errno "
3001 "was not captured and returned.  This usually indicates a bug in libguestfs."
3002 msgstr ""
3003
3004 # type: textblock
3005 #. type: textblock
3006 #: ../src/guestfs.pod:1353
3007 msgid ""
3008 "Libguestfs tries to convert the errno from inside the applicance into a "
3009 "corresponding errno for the caller (not entirely trivial: the appliance "
3010 "might be running a completely different operating system from the library "
3011 "and error numbers are not standardized across Un*xen).  If this could not be "
3012 "done, then the error is translated to C<EINVAL>.  In practice this should "
3013 "only happen in very rare circumstances."
3014 msgstr ""
3015
3016 # type: =head2
3017 #. type: =head2
3018 #: ../src/guestfs.pod:1361
3019 msgid "guestfs_set_error_handler"
3020 msgstr ""
3021
3022 # type: verbatim
3023 #. type: verbatim
3024 #: ../src/guestfs.pod:1363
3025 #, no-wrap
3026 msgid ""
3027 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3028 "                                           void *opaque,\n"
3029 "                                           const char *msg);\n"
3030 " void guestfs_set_error_handler (guestfs_h *g,\n"
3031 "                                 guestfs_error_handler_cb cb,\n"
3032 "                                 void *opaque);\n"
3033 "\n"
3034 msgstr ""
3035
3036 # type: textblock
3037 #. type: textblock
3038 #: ../src/guestfs.pod:1370
3039 msgid ""
3040 "The callback C<cb> will be called if there is an error.  The parameters "
3041 "passed to the callback are an opaque data pointer and the error message "
3042 "string."
3043 msgstr ""
3044
3045 # type: textblock
3046 #. type: textblock
3047 #: ../src/guestfs.pod:1374
3048 msgid ""
3049 "C<errno> is not passed to the callback.  To get that the callback must call "
3050 "L</guestfs_last_errno>."
3051 msgstr ""
3052
3053 # type: textblock
3054 #. type: textblock
3055 #: ../src/guestfs.pod:1377
3056 msgid ""
3057 "Note that the message string C<msg> is freed as soon as the callback "
3058 "function returns, so if you want to stash it somewhere you must make your "
3059 "own copy."
3060 msgstr ""
3061
3062 # type: textblock
3063 #. type: textblock
3064 #: ../src/guestfs.pod:1381
3065 msgid "The default handler prints messages on C<stderr>."
3066 msgstr ""
3067
3068 # type: textblock
3069 #. type: textblock
3070 #: ../src/guestfs.pod:1383
3071 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3072 msgstr ""
3073
3074 # type: =head2
3075 #. type: =head2
3076 #: ../src/guestfs.pod:1385
3077 msgid "guestfs_get_error_handler"
3078 msgstr ""
3079
3080 # type: verbatim
3081 #. type: verbatim
3082 #: ../src/guestfs.pod:1387
3083 #, no-wrap
3084 msgid ""
3085 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3086 "                                                     void **opaque_rtn);\n"
3087 "\n"
3088 msgstr ""
3089
3090 # type: textblock
3091 #. type: textblock
3092 #: ../src/guestfs.pod:1390
3093 msgid "Returns the current error handler callback."
3094 msgstr ""
3095
3096 # type: =head2
3097 #. type: =head2
3098 #: ../src/guestfs.pod:1392
3099 msgid "guestfs_set_out_of_memory_handler"
3100 msgstr ""
3101
3102 #. type: verbatim
3103 #: ../src/guestfs.pod:1394
3104 #, no-wrap
3105 msgid ""
3106 " typedef void (*guestfs_abort_cb) (void);\n"
3107 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3108 "                                         guestfs_abort_cb);\n"
3109 "\n"
3110 msgstr ""
3111
3112 # type: textblock
3113 #. type: textblock
3114 #: ../src/guestfs.pod:1398
3115 msgid ""
3116 "The callback C<cb> will be called if there is an out of memory situation.  "
3117 "I<Note this callback must not return>."
3118 msgstr ""
3119
3120 # type: textblock
3121 #. type: textblock
3122 #: ../src/guestfs.pod:1401
3123 msgid "The default is to call L<abort(3)>."
3124 msgstr ""
3125
3126 # type: textblock
3127 #. type: textblock
3128 #: ../src/guestfs.pod:1403
3129 msgid ""
3130 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3131 msgstr ""
3132
3133 # type: =head2
3134 #. type: =head2
3135 #: ../src/guestfs.pod:1406
3136 msgid "guestfs_get_out_of_memory_handler"
3137 msgstr ""
3138
3139 # type: verbatim
3140 #. type: verbatim
3141 #: ../src/guestfs.pod:1408
3142 #, no-wrap
3143 msgid ""
3144 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3145 "\n"
3146 msgstr ""
3147
3148 # type: textblock
3149 #. type: textblock
3150 #: ../src/guestfs.pod:1410
3151 msgid "This returns the current out of memory handler."
3152 msgstr ""
3153
3154 # type: =head1
3155 #. type: =head1
3156 #: ../src/guestfs.pod:1412
3157 msgid "API CALLS"
3158 msgstr ""
3159
3160 # type: textblock
3161 #. type: textblock
3162 #: ../src/guestfs.pod:1414 ../fish/guestfish.pod:958
3163 msgid "@ACTIONS@"
3164 msgstr ""
3165
3166 # type: =head1
3167 #. type: =head1
3168 #: ../src/guestfs.pod:1416
3169 msgid "STRUCTURES"
3170 msgstr ""
3171
3172 # type: textblock
3173 #. type: textblock
3174 #: ../src/guestfs.pod:1418
3175 msgid "@STRUCTS@"
3176 msgstr ""
3177
3178 # type: =head1
3179 #. type: =head1
3180 #: ../src/guestfs.pod:1420
3181 msgid "AVAILABILITY"
3182 msgstr ""
3183
3184 # type: =head2
3185 #. type: =head2
3186 #: ../src/guestfs.pod:1422
3187 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3188 msgstr ""
3189
3190 # type: textblock
3191 #. type: textblock
3192 #: ../src/guestfs.pod:1424
3193 msgid ""
3194 "Using L</guestfs_available> you can test availability of the following "
3195 "groups of functions.  This test queries the appliance to see if the "
3196 "appliance you are currently using supports the functionality."
3197 msgstr ""
3198
3199 # type: textblock
3200 #. type: textblock
3201 #: ../src/guestfs.pod:1429
3202 msgid "@AVAILABILITY@"
3203 msgstr ""
3204
3205 # type: =head2
3206 #. type: =head2
3207 #: ../src/guestfs.pod:1431
3208 msgid "GUESTFISH supported COMMAND"
3209 msgstr ""
3210
3211 # type: textblock
3212 #. type: textblock
3213 #: ../src/guestfs.pod:1433
3214 msgid ""
3215 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3216 "prints out the available groups and whether they are supported by this build "
3217 "of libguestfs.  Note however that you have to do C<run> first."
3218 msgstr ""
3219
3220 # type: =head2
3221 #. type: =head2
3222 #: ../src/guestfs.pod:1438
3223 msgid "SINGLE CALLS AT COMPILE TIME"
3224 msgstr ""
3225
3226 # type: textblock
3227 #. type: textblock
3228 #: ../src/guestfs.pod:1440
3229 msgid ""
3230 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3231 "function, such as:"
3232 msgstr ""
3233
3234 # type: verbatim
3235 #. type: verbatim
3236 #: ../src/guestfs.pod:1443
3237 #, no-wrap
3238 msgid ""
3239 " #define LIBGUESTFS_HAVE_DD 1\n"
3240 "\n"
3241 msgstr ""
3242
3243 # type: textblock
3244 #. type: textblock
3245 #: ../src/guestfs.pod:1445
3246 msgid "if L</guestfs_dd> is available."
3247 msgstr ""
3248
3249 # type: textblock
3250 #. type: textblock
3251 #: ../src/guestfs.pod:1447
3252 msgid ""
3253 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3254 "function is available at compile time, we recommended using build tools such "
3255 "as autoconf or cmake.  For example in autotools you could use:"
3256 msgstr ""
3257
3258 # type: verbatim
3259 #. type: verbatim
3260 #: ../src/guestfs.pod:1452
3261 #, no-wrap
3262 msgid ""
3263 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3264 " AC_CHECK_FUNCS([guestfs_dd])\n"
3265 "\n"
3266 msgstr ""
3267
3268 # type: textblock
3269 #. type: textblock
3270 #: ../src/guestfs.pod:1455
3271 msgid ""
3272 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3273 "in your program."
3274 msgstr ""
3275
3276 # type: =head2
3277 #. type: =head2
3278 #: ../src/guestfs.pod:1458
3279 msgid "SINGLE CALLS AT RUN TIME"
3280 msgstr ""
3281
3282 # type: textblock
3283 #. type: textblock
3284 #: ../src/guestfs.pod:1460
3285 msgid ""
3286 "Testing at compile time doesn't guarantee that a function really exists in "
3287 "the library.  The reason is that you might be dynamically linked against a "
3288 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3289 "This situation unfortunately results in a segmentation fault, which is a "
3290 "shortcoming of the C dynamic linking system itself."
3291 msgstr ""
3292
3293 # type: textblock
3294 #. type: textblock
3295 #: ../src/guestfs.pod:1467
3296 msgid ""
3297 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3298 "in this example program (note that you still need the compile time check as "
3299 "well):"
3300 msgstr ""
3301
3302 # type: verbatim
3303 #. type: verbatim
3304 #: ../src/guestfs.pod:1471
3305 #, no-wrap
3306 msgid ""
3307 " #include <stdio.h>\n"
3308 " #include <stdlib.h>\n"
3309 " #include <unistd.h>\n"
3310 " #include <dlfcn.h>\n"
3311 " #include <guestfs.h>\n"
3312 " \n"
3313 msgstr ""
3314
3315 # type: verbatim
3316 #. type: verbatim
3317 #: ../src/guestfs.pod:1477
3318 #, no-wrap
3319 msgid ""
3320 " main ()\n"
3321 " {\n"
3322 " #ifdef LIBGUESTFS_HAVE_DD\n"
3323 "   void *dl;\n"
3324 "   int has_function;\n"
3325 " \n"
3326 msgstr ""
3327
3328 # type: verbatim
3329 #. type: verbatim
3330 #: ../src/guestfs.pod:1483
3331 #, no-wrap
3332 msgid ""
3333 "   /* Test if the function guestfs_dd is really available. */\n"
3334 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3335 "   if (!dl) {\n"
3336 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3337 "     exit (EXIT_FAILURE);\n"
3338 "   }\n"
3339 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3340 "   dlclose (dl);\n"
3341 " \n"
3342 msgstr ""
3343
3344 # type: verbatim
3345 #. type: verbatim
3346 #: ../src/guestfs.pod:1492
3347 #, no-wrap
3348 msgid ""
3349 "   if (!has_function)\n"
3350 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3351 "   else {\n"
3352 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3353 "     /* Now it's safe to call\n"
3354 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3355 "     */\n"
3356 "   }\n"
3357 " #else\n"
3358 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3359 " #endif\n"
3360 "  }\n"
3361 "\n"
3362 msgstr ""
3363
3364 # type: textblock
3365 #. type: textblock
3366 #: ../src/guestfs.pod:1505
3367 msgid ""
3368 "You may think the above is an awful lot of hassle, and it is.  There are "
3369 "other ways outside of the C linking system to ensure that this kind of "
3370 "incompatibility never arises, such as using package versioning:"
3371 msgstr ""
3372
3373 # type: verbatim
3374 #. type: verbatim
3375 #: ../src/guestfs.pod:1510
3376 #, no-wrap
3377 msgid ""
3378 " Requires: libguestfs >= 1.0.80\n"
3379 "\n"
3380 msgstr ""
3381
3382 # type: =head1
3383 #. type: =head1
3384 #: ../src/guestfs.pod:1512
3385 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3386 msgstr ""
3387
3388 # type: textblock
3389 #. type: textblock
3390 #: ../src/guestfs.pod:1514
3391 msgid ""
3392 "A recent feature of the API is the introduction of calls which take optional "
3393 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3394 "takes variable arguments (ie. C<...>), as in this example:"
3395 msgstr ""
3396
3397 # type: verbatim
3398 #. type: verbatim
3399 #: ../src/guestfs.pod:1519
3400 #, no-wrap
3401 msgid ""
3402 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3403 "\n"
3404 msgstr ""
3405
3406 # type: textblock
3407 #. type: textblock
3408 #: ../src/guestfs.pod:1521
3409 msgid ""
3410 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3411 "call with no optional arguments specified:"
3412 msgstr ""
3413
3414 # type: verbatim
3415 #. type: verbatim
3416 #: ../src/guestfs.pod:1524
3417 #, no-wrap
3418 msgid ""
3419 " guestfs_add_drive_opts (g, filename, -1);\n"
3420 "\n"
3421 msgstr ""
3422
3423 # type: textblock
3424 #. type: textblock
3425 #: ../src/guestfs.pod:1526
3426 msgid "With a single optional argument:"
3427 msgstr ""
3428
3429 # type: verbatim
3430 #. type: verbatim
3431 #: ../src/guestfs.pod:1528
3432 #, no-wrap
3433 msgid ""
3434 " guestfs_add_drive_opts (g, filename,\n"
3435 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3436 "                         -1);\n"
3437 "\n"
3438 msgstr ""
3439
3440 # type: textblock
3441 #. type: textblock
3442 #: ../src/guestfs.pod:1532
3443 msgid "With two:"
3444 msgstr ""
3445
3446 # type: verbatim
3447 #. type: verbatim
3448 #: ../src/guestfs.pod:1534
3449 #, no-wrap
3450 msgid ""
3451 " guestfs_add_drive_opts (g, filename,\n"
3452 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3453 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3454 "                         -1);\n"
3455 "\n"
3456 msgstr ""
3457
3458 # type: textblock
3459 #. type: textblock
3460 #: ../src/guestfs.pod:1539
3461 msgid ""
3462 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3463 "happen!"
3464 msgstr ""
3465
3466 # type: =head2
3467 #. type: =head2
3468 #: ../src/guestfs.pod:1542
3469 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3470 msgstr ""
3471
3472 # type: textblock
3473 #. type: textblock
3474 #: ../src/guestfs.pod:1544
3475 msgid ""
3476 "The second variant has the same name with the suffix C<_va>, which works the "
3477 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3478 "example function, this is declared:"
3479 msgstr ""
3480
3481 # type: verbatim
3482 #. type: verbatim
3483 #: ../src/guestfs.pod:1548
3484 #, no-wrap
3485 msgid ""
3486 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3487 "                                va_list args);\n"
3488 "\n"
3489 msgstr ""
3490
3491 # type: =head2
3492 #. type: =head2
3493 #: ../src/guestfs.pod:1551
3494 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3495 msgstr ""
3496
3497 # type: textblock
3498 #. type: textblock
3499 #: ../src/guestfs.pod:1553
3500 msgid ""
3501 "The third variant is useful where you need to construct these calls.  You "
3502 "pass in a structure where you fill in the optional fields.  The structure "
3503 "has a bitmask as the first element which you must set to indicate which "
3504 "fields you have filled in.  For our example function the structure and call "
3505 "are declared:"
3506 msgstr ""
3507
3508 # type: verbatim
3509 #. type: verbatim
3510 #: ../src/guestfs.pod:1559
3511 #, no-wrap
3512 msgid ""
3513 " struct guestfs_add_drive_opts_argv {\n"
3514 "   uint64_t bitmask;\n"
3515 "   int readonly;\n"
3516 "   const char *format;\n"
3517 "   /* ... */\n"
3518 " };\n"
3519 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3520 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3521 "\n"
3522 msgstr ""
3523
3524 # type: textblock
3525 #. type: textblock
3526 #: ../src/guestfs.pod:1568
3527 msgid "You could call it like this:"
3528 msgstr ""
3529
3530 # type: verbatim
3531 #. type: verbatim
3532 #: ../src/guestfs.pod:1570
3533 #, no-wrap
3534 msgid ""
3535 " struct guestfs_add_drive_opts_argv optargs = {\n"
3536 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3537 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3538 "   .readonly = 1,\n"
3539 "   .format = \"qcow2\"\n"
3540 " };\n"
3541 " \n"
3542 msgstr ""
3543
3544 # type: verbatim
3545 #. type: verbatim
3546 #: ../src/guestfs.pod:1577
3547 #, no-wrap
3548 msgid ""
3549 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3550 "\n"
3551 msgstr ""
3552
3553 # type: textblock
3554 #. type: textblock
3555 #: ../src/guestfs.pod:1579 ../src/guestfs-actions.pod:11
3556 #: ../src/guestfs-actions.pod:1839 ../fish/guestfish-actions.pod:9
3557 #: ../fish/guestfish-actions.pod:1250 ../tools/virt-win-reg.pl:532
3558 msgid "Notes:"
3559 msgstr ""
3560
3561 # type: textblock
3562 #. type: textblock
3563 #: ../src/guestfs.pod:1585
3564 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3565 msgstr ""
3566
3567 # type: textblock
3568 #. type: textblock
3569 #: ../src/guestfs.pod:1590
3570 msgid "You do not need to fill in all fields of the structure."
3571 msgstr ""
3572
3573 # type: textblock
3574 #. type: textblock
3575 #: ../src/guestfs.pod:1594
3576 msgid ""
3577 "There must be a one-to-one correspondence between fields of the structure "
3578 "that are filled in, and bits set in the bitmask."
3579 msgstr ""
3580
3581 # type: =head2
3582 #. type: =head2
3583 #: ../src/guestfs.pod:1599
3584 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3585 msgstr ""
3586
3587 # type: textblock
3588 #. type: textblock
3589 #: ../src/guestfs.pod:1601
3590 msgid ""
3591 "In other languages, optional arguments are expressed in the way that is "
3592 "natural for that language.  We refer you to the language-specific "
3593 "documentation for more details on that."
3594 msgstr ""
3595
3596 # type: textblock
3597 #. type: textblock
3598 #: ../src/guestfs.pod:1605
3599 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3600 msgstr ""
3601
3602 # type: =head2
3603 #. type: =head2
3604 #: ../src/guestfs.pod:1607
3605 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3606 msgstr ""
3607
3608 # type: textblock
3609 #. type: textblock
3610 #: ../src/guestfs.pod:1609
3611 msgid ""
3612 "The child process generates events in some situations.  Current events "
3613 "include: receiving a log message, the child process exits."
3614 msgstr ""
3615
3616 # type: textblock
3617 #. type: textblock
3618 #: ../src/guestfs.pod:1612
3619 msgid ""
3620 "Use the C<guestfs_set_*_callback> functions to set a callback for different "
3621 "types of events."
3622 msgstr ""
3623
3624 # type: textblock
3625 #. type: textblock
3626 #: ../src/guestfs.pod:1615
3627 msgid ""
3628 "Only I<one callback of each type> can be registered for each handle.  "
3629 "Calling C<guestfs_set_*_callback> again overwrites the previous callback of "
3630 "that type.  Cancel all callbacks of this type by calling this function with "
3631 "C<cb> set to C<NULL>."
3632 msgstr ""
3633
3634 # type: =head2
3635 #. type: =head2
3636 #: ../src/guestfs.pod:1620
3637 msgid "guestfs_set_log_message_callback"
3638 msgstr ""
3639
3640 # type: verbatim
3641 #. type: verbatim
3642 #: ../src/guestfs.pod:1622
3643 #, no-wrap
3644 msgid ""
3645 " typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n"
3646 "                                         char *buf, int len);\n"
3647 " void guestfs_set_log_message_callback (guestfs_h *g,\n"
3648 "                                        guestfs_log_message_cb cb,\n"
3649 "                                        void *opaque);\n"
3650 "\n"
3651 msgstr ""
3652
3653 # type: textblock
3654 #. type: textblock
3655 #: ../src/guestfs.pod:1628
3656 msgid ""
3657 "The callback function C<cb> will be called whenever qemu or the guest writes "
3658 "anything to the console."
3659 msgstr ""
3660
3661 # type: textblock
3662 #. type: textblock
3663 #: ../src/guestfs.pod:1631
3664 msgid "Use this function to capture kernel messages and similar."
3665 msgstr ""
3666
3667 # type: textblock
3668 #. type: textblock
3669 #: ../src/guestfs.pod:1633
3670 msgid ""
3671 "Normally there is no log message handler, and log messages are just "
3672 "discarded."
3673 msgstr ""
3674
3675 # type: =head2
3676 #. type: =head2
3677 #: ../src/guestfs.pod:1636
3678 msgid "guestfs_set_subprocess_quit_callback"
3679 msgstr ""
3680
3681 # type: verbatim
3682 #. type: verbatim
3683 #: ../src/guestfs.pod:1638
3684 #, no-wrap
3685 msgid ""
3686 " typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n"
3687 " void guestfs_set_subprocess_quit_callback (guestfs_h *g,\n"
3688 "                                            guestfs_subprocess_quit_cb cb,\n"
3689 "                                            void *opaque);\n"
3690 "\n"
3691 msgstr ""
3692
3693 # type: textblock
3694 #. type: textblock
3695 #: ../src/guestfs.pod:1643
3696 msgid ""
3697 "The callback function C<cb> will be called when the child process quits, "
3698 "either asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3699 "corresponds to a transition from any state to the CONFIG state)."
3700 msgstr ""
3701
3702 # type: =head2
3703 #. type: =head2
3704 #: ../src/guestfs.pod:1648
3705 msgid "guestfs_set_launch_done_callback"
3706 msgstr ""
3707
3708 # type: verbatim
3709 #. type: verbatim
3710 #: ../src/guestfs.pod:1650
3711 #, no-wrap
3712 msgid ""
3713 " typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n"
3714 " void guestfs_set_launch_done_callback (guestfs_h *g,\n"
3715 "                                        guestfs_launch_done_cb cb,\n"
3716 "                                        void *opaque);\n"
3717 "\n"
3718 msgstr ""
3719
3720 # type: textblock
3721 #. type: textblock
3722 #: ../src/guestfs.pod:1655
3723 msgid ""
3724 "The callback function C<cb> will be called when the child process becomes "
3725 "ready first time after it has been launched.  (This corresponds to a "
3726 "transition from LAUNCHING to the READY state)."
3727 msgstr ""
3728
3729 # type: =head2
3730 #. type: =head2
3731 #: ../src/guestfs.pod:1659
3732 msgid "guestfs_set_close_callback"
3733 msgstr ""
3734
3735 # type: verbatim
3736 #. type: verbatim
3737 #: ../src/guestfs.pod:1661
3738 #, no-wrap
3739 msgid ""
3740 " typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n"
3741 " void guestfs_set_close_callback (guestfs_h *g,\n"
3742 "                                  guestfs_close_cb cb,\n"
3743 "                                  void *opaque);\n"
3744 "\n"
3745 msgstr ""
3746
3747 # type: textblock
3748 #. type: textblock
3749 #: ../src/guestfs.pod:1666
3750 msgid ""
3751 "The callback function C<cb> will be called while the handle is being closed "
3752 "(synchronously from L</guestfs_close>)."
3753 msgstr ""
3754
3755 # type: textblock
3756 #. type: textblock
3757 #: ../src/guestfs.pod:1669
3758 msgid ""
3759 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3760 "handles that are open when the program exits.  This means that this callback "
3761 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3762 "problems in higher-level languages (eg. if your HLL interpreter has already "
3763 "been cleaned up by the time this is called, and if your callback then jumps "
3764 "into some HLL function)."
3765 msgstr ""
3766
3767 # type: =head2
3768 #. type: =head2
3769 #: ../src/guestfs.pod:1677
3770 msgid "guestfs_set_progress_callback"
3771 msgstr ""
3772
3773 # type: verbatim
3774 #. type: verbatim
3775 #: ../src/guestfs.pod:1679
3776 #, no-wrap
3777 msgid ""
3778 " typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n"
3779 "                                      int proc_nr, int serial,\n"
3780 "                                      uint64_t position, uint64_t total);\n"
3781 " void guestfs_set_progress_callback (guestfs_h *g,\n"
3782 "                                     guestfs_progress_cb cb,\n"
3783 "                                     void *opaque);\n"
3784 "\n"
3785 msgstr ""
3786
3787 # type: textblock
3788 #. type: textblock
3789 #: ../src/guestfs.pod:1686
3790 msgid ""
3791 "Some long-running operations can generate progress messages.  If this "
3792 "callback is registered, then it will be called each time a progress message "
3793 "is generated (usually two seconds after the operation started, and three "
3794 "times per second thereafter until it completes, although the frequency may "
3795 "change in future versions)."
3796 msgstr ""
3797
3798 # type: textblock
3799 #. type: textblock
3800 #: ../src/guestfs.pod:1692
3801 msgid ""
3802 "The callback receives two numbers: C<position> and C<total>.  The units of "
3803 "C<total> are not defined, although for some operations C<total> may relate "
3804 "in some way to the amount of data to be transferred (eg. in bytes or "
3805 "megabytes), and C<position> may be the portion which has been transferred."
3806 msgstr ""
3807
3808 # type: textblock
3809 #. type: textblock
3810 #: ../src/guestfs.pod:1698
3811 msgid "The only defined and stable parts of the API are:"
3812 msgstr ""
3813
3814 # type: textblock
3815 #. type: textblock
3816 #: ../src/guestfs.pod:1704
3817 msgid ""
3818 "The callback can display to the user some type of progress bar or indicator "
3819 "which shows the ratio of C<position>:C<total>."
3820 msgstr ""
3821
3822 # type: textblock
3823 #. type: textblock
3824 #: ../src/guestfs.pod:1709
3825 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3826 msgstr ""
3827
3828 #. type: textblock
3829 #: ../src/guestfs.pod:1713
3830 msgid ""
3831 "If any progress notification is sent during a call, then a final progress "
3832 "notification is always sent when C<position> = C<total> (I<unless> the call "
3833 "fails with an error)."
3834 msgstr ""
3835
3836 # type: textblock
3837 #. type: textblock
3838 #: ../src/guestfs.pod:1717
3839 msgid ""
3840 "This is to simplify caller code, so callers can easily set the progress "
3841 "indicator to \"100%\" at the end of the operation, without requiring special "
3842 "code to detect this case."
3843 msgstr ""
3844
3845 # type: textblock
3846 #. type: textblock
3847 #: ../src/guestfs.pod:1723
3848 msgid ""
3849 "The callback also receives the procedure number and serial number of the "
3850 "call.  These are only useful for debugging protocol issues, and the callback "
3851 "can normally ignore them.  The callback may want to print these numbers in "
3852 "error messages or debugging messages."
3853 msgstr ""
3854
3855 # type: =head1
3856 #. type: =head1
3857 #: ../src/guestfs.pod:1728
3858 msgid "PRIVATE DATA AREA"
3859 msgstr ""
3860
3861 # type: textblock
3862 #. type: textblock
3863 #: ../src/guestfs.pod:1730
3864 msgid ""
3865 "You can attach named pieces of private data to the libguestfs handle, and "
3866 "fetch them by name for the lifetime of the handle.  This is called the "
3867 "private data area and is only available from the C API."
3868 msgstr ""
3869
3870 # type: textblock
3871 #. type: textblock
3872 #: ../src/guestfs.pod:1734
3873 msgid "To attach a named piece of data, use the following call:"
3874 msgstr ""
3875
3876 # type: verbatim
3877 #. type: verbatim
3878 #: ../src/guestfs.pod:1736
3879 #, no-wrap
3880 msgid ""
3881 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
3882 "\n"
3883 msgstr ""
3884
3885 # type: textblock
3886 #. type: textblock
3887 #: ../src/guestfs.pod:1738
3888 msgid ""
3889 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
3890 "pointer (which can be C<NULL>).  Any previous item with the same name is "
3891 "overwritten."
3892 msgstr ""
3893
3894 # type: textblock
3895 #. type: textblock
3896 #: ../src/guestfs.pod:1742
3897 msgid ""
3898 "You can use any C<key> you want, but names beginning with an underscore "
3899 "character are reserved for internal libguestfs purposes (for implementing "
3900 "language bindings).  It is recommended to prefix the name with some unique "
3901 "string to avoid collisions with other users."
3902 msgstr ""
3903
3904 # type: textblock
3905 #. type: textblock
3906 #: ../src/guestfs.pod:1747
3907 msgid "To retrieve the pointer, use:"
3908 msgstr ""
3909
3910 # type: verbatim
3911 #. type: verbatim
3912 #: ../src/guestfs.pod:1749
3913 #, no-wrap
3914 msgid ""
3915 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
3916 "\n"
3917 msgstr ""
3918
3919 # type: textblock
3920 #. type: textblock
3921 #: ../src/guestfs.pod:1751
3922 msgid ""
3923 "This function returns C<NULL> if either no data is found associated with "
3924 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
3925 "C<NULL>."
3926 msgstr ""
3927
3928 # type: textblock
3929 #. type: textblock
3930 #: ../src/guestfs.pod:1755
3931 msgid ""
3932 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
3933 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
3934 "all.  In particular, libguestfs does I<not> try to free the data when the "
3935 "handle is closed.  If the data must be freed, then the caller must either "
3936 "free it before calling L</guestfs_close> or must set up a close callback to "
3937 "do it (see L</guestfs_set_close_callback>, and note that only one callback "
3938 "can be registered for a handle)."
3939 msgstr ""
3940
3941 # type: textblock
3942 #. type: textblock
3943 #: ../src/guestfs.pod:1763
3944 msgid ""
3945 "The private data area is implemented using a hash table, and should be "
3946 "reasonably efficient for moderate numbers of keys."
3947 msgstr ""
3948
3949 # type: =end
3950 #. type: =end
3951 #: ../src/guestfs.pod:1766 ../src/guestfs.pod:1771
3952 msgid "html"
3953 msgstr ""
3954
3955 # type: textblock
3956 #. type: textblock
3957 #: ../src/guestfs.pod:1768
3958 msgid ""
3959 "<!-- old anchor for the next section --> <a name="
3960 "\"state_machine_and_low_level_event_api\"/>"
3961 msgstr ""
3962
3963 # type: =head1
3964 #. type: =head1
3965 #: ../src/guestfs.pod:1773
3966 msgid "ARCHITECTURE"
3967 msgstr ""
3968
3969 # type: textblock
3970 #. type: textblock
3971 #: ../src/guestfs.pod:1775
3972 msgid ""
3973 "Internally, libguestfs is implemented by running an appliance (a special "
3974 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
3975 "process of the main program."
3976 msgstr ""
3977
3978 # type: verbatim
3979 #. type: verbatim
3980 #: ../src/guestfs.pod:1779
3981 #, no-wrap
3982 msgid ""
3983 "  ___________________\n"
3984 " /                   \\\n"
3985 " | main program      |\n"
3986 " |                   |\n"
3987 " |                   |           child process / appliance\n"
3988 " |                   |           __________________________\n"
3989 " |                   |          / qemu                     \\\n"
3990 " +-------------------+   RPC    |      +-----------------+ |\n"
3991 " | libguestfs     <--------------------> guestfsd        | |\n"
3992 " |                   |          |      +-----------------+ |\n"
3993 " \\___________________/          |      | Linux kernel    | |\n"
3994 "                                |      +--^--------------+ |\n"
3995 "                                \\_________|________________/\n"
3996 "                                          |\n"
3997 "                                   _______v______\n"
3998 "                                  /              \\\n"
3999 "                                  | Device or    |\n"
4000 "                                  | disk image   |\n"
4001 "                                  \\______________/\n"
4002 "\n"
4003 msgstr ""
4004
4005 # type: textblock
4006 #. type: textblock
4007 #: ../src/guestfs.pod:1799
4008 msgid ""
4009 "The library, linked to the main program, creates the child process and hence "
4010 "the appliance in the L</guestfs_launch> function."
4011 msgstr ""
4012
4013 # type: textblock
4014 #. type: textblock
4015 #: ../src/guestfs.pod:1802
4016 msgid ""
4017 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4018 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4019 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4020 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4021 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4022 "attached to the qemu process which translates device access by the "
4023 "appliance's Linux kernel into accesses to the image."
4024 msgstr ""
4025
4026 # type: textblock
4027 #. type: textblock
4028 #: ../src/guestfs.pod:1811
4029 msgid ""
4030 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4031 "Although the disk image you are attached to might also be used by some "
4032 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4033 "care if both libguestfs's qemu process and your virtual machine are trying "
4034 "to update the disk image at the same time, since these usually results in "
4035 "massive disk corruption)."
4036 msgstr ""
4037
4038 # type: =head1
4039 #. type: =head1
4040 #: ../src/guestfs.pod:1818
4041 msgid "STATE MACHINE"
4042 msgstr ""
4043
4044 # type: textblock
4045 #. type: textblock
4046 #: ../src/guestfs.pod:1820
4047 msgid "libguestfs uses a state machine to model the child process:"
4048 msgstr ""
4049
4050 # type: verbatim
4051 #. type: verbatim
4052 #: ../src/guestfs.pod:1822
4053 #, no-wrap
4054 msgid ""
4055 "                         |\n"
4056 "                    guestfs_create\n"
4057 "                         |\n"
4058 "                         |\n"
4059 "                     ____V_____\n"
4060 "                    /          \\\n"
4061 "                    |  CONFIG  |\n"
4062 "                    \\__________/\n"
4063 "                     ^ ^   ^  \\\n"
4064 "                    /  |    \\  \\ guestfs_launch\n"
4065 "                   /   |    _\\__V______\n"
4066 "                  /    |   /           \\\n"
4067 "                 /     |   | LAUNCHING |\n"
4068 "                /      |   \\___________/\n"
4069 "               /       |       /\n"
4070 "              /        |  guestfs_launch\n"
4071 "             /         |     /\n"
4072 "    ______  /        __|____V\n"
4073 "   /      \\ ------> /        \\\n"
4074 "   | BUSY |         | READY  |\n"
4075 "   \\______/ <------ \\________/\n"
4076 "\n"
4077 msgstr ""
4078
4079 # type: textblock
4080 #. type: textblock
4081 #: ../src/guestfs.pod:1844
4082 msgid ""
4083 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4084 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4085 "(3) alternating between READY and BUSY as commands are issued to, and "
4086 "carried out by, the child process."
4087 msgstr ""
4088
4089 # type: textblock
4090 #. type: textblock
4091 #: ../src/guestfs.pod:1849
4092 msgid ""
4093 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4094 "asynchronously at any time (eg. due to some internal error), and that causes "
4095 "the state to transition back to CONFIG."
4096 msgstr ""
4097
4098 # type: textblock
4099 #. type: textblock
4100 #: ../src/guestfs.pod:1853
4101 msgid ""
4102 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4103 "issued when in the CONFIG state."
4104 msgstr ""
4105
4106 # type: textblock
4107 #. type: textblock
4108 #: ../src/guestfs.pod:1856
4109 msgid ""
4110 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4111 "L</guestfs_launch> blocks until the child process is READY to accept "
4112 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4113 "moves the state from CONFIG to LAUNCHING while it is running."
4114 msgstr ""
4115
4116 # type: textblock
4117 #. type: textblock
4118 #: ../src/guestfs.pod:1862
4119 msgid ""
4120 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4121 "state.  These API calls block waiting for the command to be carried out (ie. "
4122 "the state to transition to BUSY and then back to READY).  There are no non-"
4123 "blocking versions, and no way to issue more than one command per handle at "
4124 "the same time."
4125 msgstr ""
4126
4127 # type: textblock
4128 #. type: textblock
4129 #: ../src/guestfs.pod:1868
4130 msgid ""
4131 "Finally, the child process sends asynchronous messages back to the main "
4132 "program, such as kernel log messages.  You can register a callback to "
4133 "receive these messages."
4134 msgstr ""
4135
4136 # type: =head1
4137 #. type: =head1
4138 #: ../src/guestfs.pod:1872
4139 msgid "INTERNALS"
4140 msgstr ""
4141
4142 # type: =head2
4143 #. type: =head2
4144 #: ../src/guestfs.pod:1874
4145 msgid "COMMUNICATION PROTOCOL"
4146 msgstr ""
4147
4148 # type: textblock
4149 #. type: textblock
4150 #: ../src/guestfs.pod:1876
4151 msgid ""
4152 "Don't rely on using this protocol directly.  This section documents how it "
4153 "currently works, but it may change at any time."
4154 msgstr ""
4155
4156 # type: textblock
4157 #. type: textblock
4158 #: ../src/guestfs.pod:1879
4159 msgid ""
4160 "The protocol used to talk between the library and the daemon running inside "
4161 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4162 "1014, RFC 1832, RFC 4506)."
4163 msgstr ""
4164
4165 # type: textblock
4166 #. type: textblock
4167 #: ../src/guestfs.pod:1883
4168 msgid ""
4169 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4170 "this file is automatically generated)."
4171 msgstr ""
4172
4173 # type: textblock
4174 #. type: textblock
4175 #: ../src/guestfs.pod:1886
4176 msgid ""
4177 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4178 "and C<FileOut> parameters, which are handled with very simple request/reply "
4179 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4180 "parameters, which use the same request and reply messages, but they may also "
4181 "be followed by files sent using a chunked encoding."
4182 msgstr ""
4183
4184 # type: =head3
4185 #. type: =head3
4186 #: ../src/guestfs.pod:1893
4187 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4188 msgstr ""
4189
4190 # type: textblock
4191 #. type: textblock
4192 #: ../src/guestfs.pod:1895
4193 msgid "For ordinary functions, the request message is:"
4194 msgstr ""
4195
4196 # type: verbatim
4197 #. type: verbatim
4198 #: ../src/guestfs.pod:1897
4199 #, no-wrap
4200 msgid ""
4201 " total length (header + arguments,\n"
4202 "      but not including the length word itself)\n"
4203 " struct guestfs_message_header (encoded as XDR)\n"
4204 " struct guestfs_<foo>_args (encoded as XDR)\n"
4205 "\n"
4206 msgstr ""
4207
4208 # type: textblock
4209 #. type: textblock
4210 #: ../src/guestfs.pod:1902
4211 msgid ""
4212 "The total length field allows the daemon to allocate a fixed size buffer "
4213 "into which it slurps the rest of the message.  As a result, the total length "
4214 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4215 "effective size of any request is limited to somewhere under this size."
4216 msgstr ""
4217
4218 # type: textblock
4219 #. type: textblock
4220 #: ../src/guestfs.pod:1908
4221 msgid ""
4222 "Note also that many functions don't take any arguments, in which case the "
4223 "C<guestfs_I<foo>_args> is completely omitted."
4224 msgstr ""
4225
4226 # type: textblock
4227 #. type: textblock
4228 #: ../src/guestfs.pod:1911
4229 msgid ""
4230 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4231 "receiver knows what type of args structure to expect, or none at all."
4232 msgstr ""
4233
4234 # type: textblock
4235 #. type: textblock
4236 #: ../src/guestfs.pod:1915
4237 msgid ""
4238 "For functions that take optional arguments, the optional arguments are "
4239 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4240 "arguments.  A bitmask in the header indicates which optional arguments are "
4241 "meaningful.  The bitmask is also checked to see if it contains bits set "
4242 "which the daemon does not know about (eg. if more optional arguments were "
4243 "added in a later version of the library), and this causes the call to be "
4244 "rejected."
4245 msgstr ""
4246
4247 # type: textblock
4248 #. type: textblock
4249 #: ../src/guestfs.pod:1923
4250 msgid "The reply message for ordinary functions is:"
4251 msgstr ""
4252
4253 # type: verbatim
4254 #. type: verbatim
4255 #: ../src/guestfs.pod:1925
4256 #, no-wrap
4257 msgid ""
4258 " total length (header + ret,\n"
4259 "      but not including the length word itself)\n"
4260 " struct guestfs_message_header (encoded as XDR)\n"
4261 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4262 "\n"
4263 msgstr ""
4264
4265 # type: textblock
4266 #. type: textblock
4267 #: ../src/guestfs.pod:1930
4268 msgid ""
4269 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4270 "functions that return no formal return values."
4271 msgstr ""
4272
4273 # type: textblock
4274 #. type: textblock
4275 #: ../src/guestfs.pod:1933
4276 msgid ""
4277 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4278 msgstr ""
4279
4280 # type: textblock
4281 #. type: textblock
4282 #: ../src/guestfs.pod:1936
4283 msgid ""
4284 "In the case of an error, a flag is set in the header, and the reply message "
4285 "is slightly changed:"
4286 msgstr ""
4287
4288 # type: verbatim
4289 #. type: verbatim
4290 #: ../src/guestfs.pod:1939
4291 #, no-wrap
4292 msgid ""
4293 " total length (header + error,\n"
4294 "      but not including the length word itself)\n"
4295 " struct guestfs_message_header (encoded as XDR)\n"
4296 " struct guestfs_message_error (encoded as XDR)\n"
4297 "\n"
4298 msgstr ""
4299
4300 # type: textblock
4301 #. type: textblock
4302 #: ../src/guestfs.pod:1944
4303 msgid ""
4304 "The C<guestfs_message_error> structure contains the error message as a "
4305 "string."
4306 msgstr ""
4307
4308 # type: =head3
4309 #. type: =head3
4310 #: ../src/guestfs.pod:1947
4311 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4312 msgstr ""
4313
4314 # type: textblock
4315 #. type: textblock
4316 #: ../src/guestfs.pod:1949
4317 msgid ""
4318 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4319 "The normal request message is sent (see above).  However this is followed by "
4320 "a sequence of file chunks."
4321 msgstr ""
4322
4323 # type: verbatim
4324 #. type: verbatim
4325 #: ../src/guestfs.pod:1953
4326 #, no-wrap
4327 msgid ""
4328 " total length (header + arguments,\n"
4329 "      but not including the length word itself,\n"
4330 "      and not including the chunks)\n"
4331 " struct guestfs_message_header (encoded as XDR)\n"
4332 " struct guestfs_<foo>_args (encoded as XDR)\n"
4333 " sequence of chunks for FileIn param #0\n"
4334 " sequence of chunks for FileIn param #1 etc.\n"
4335 "\n"
4336 msgstr ""
4337
4338 # type: textblock
4339 #. type: textblock
4340 #: ../src/guestfs.pod:1961
4341 msgid "The \"sequence of chunks\" is:"
4342 msgstr ""
4343
4344 # type: verbatim
4345 #. type: verbatim
4346 #: ../src/guestfs.pod:1963
4347 #, no-wrap
4348 msgid ""
4349 " length of chunk (not including length word itself)\n"
4350 " struct guestfs_chunk (encoded as XDR)\n"
4351 " length of chunk\n"
4352 " struct guestfs_chunk (encoded as XDR)\n"
4353 "   ...\n"
4354 " length of chunk\n"
4355 " struct guestfs_chunk (with data.data_len == 0)\n"
4356 "\n"
4357 msgstr ""
4358
4359 # type: textblock
4360 #. type: textblock
4361 #: ../src/guestfs.pod:1971
4362 msgid ""
4363 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4364 "is set in the final chunk to indicate either successful completion or early "
4365 "cancellation."
4366 msgstr ""
4367
4368 # type: textblock
4369 #. type: textblock
4370 #: ../src/guestfs.pod:1975
4371 msgid ""
4372 "At time of writing there are no functions that have more than one FileIn "
4373 "parameter.  However this is (theoretically) supported, by sending the "
4374 "sequence of chunks for each FileIn parameter one after another (from left to "
4375 "right)."
4376 msgstr ""
4377
4378 # type: textblock
4379 #. type: textblock
4380 #: ../src/guestfs.pod:1980
4381 msgid ""
4382 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4383 "transfer.  The library does this by sending a chunk with a special flag set "
4384 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4385 "RPC, does I<not> send any reply, and goes back to reading the next request."
4386 msgstr ""
4387
4388 # type: textblock
4389 #. type: textblock
4390 #: ../src/guestfs.pod:1986
4391 msgid ""
4392 "The daemon may also cancel.  It does this by writing a special word "
4393 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4394 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4395 "cancel chunk).  The special word is chosen so that even if cancellation "
4396 "happens right at the end of the transfer (after the library has finished "
4397 "writing and has started listening for the reply), the \"spurious\" cancel "
4398 "flag will not be confused with the reply message."
4399 msgstr ""
4400
4401 # type: textblock
4402 #. type: textblock
4403 #: ../src/guestfs.pod:1995
4404 msgid ""
4405 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4406 "limit), and also files where the size is not known in advance (eg. from "
4407 "pipes or sockets).  However the chunks are rather small "
4408 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4409 "to keep much in memory."
4410 msgstr ""
4411
4412 # type: =head3
4413 #. type: =head3
4414 #: ../src/guestfs.pod:2001
4415 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4416 msgstr ""
4417
4418 # type: textblock
4419 #. type: textblock
4420 #: ../src/guestfs.pod:2003
4421 msgid ""
4422 "The protocol for FileOut parameters is exactly the same as for FileIn "
4423 "parameters, but with the roles of daemon and library reversed."
4424 msgstr ""
4425
4426 # type: verbatim
4427 #. type: verbatim
4428 #: ../src/guestfs.pod:2006
4429 #, no-wrap
4430 msgid ""
4431 " total length (header + ret,\n"
4432 "      but not including the length word itself,\n"
4433 "      and not including the chunks)\n"
4434 " struct guestfs_message_header (encoded as XDR)\n"
4435 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4436 " sequence of chunks for FileOut param #0\n"
4437 " sequence of chunks for FileOut param #1 etc.\n"
4438 "\n"
4439 msgstr ""
4440
4441 # type: =head3
4442 #. type: =head3
4443 #: ../src/guestfs.pod:2014
4444 msgid "INITIAL MESSAGE"
4445 msgstr ""
4446
4447 # type: textblock
4448 #. type: textblock
4449 #: ../src/guestfs.pod:2016
4450 msgid ""
4451 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4452 "which indicates that the guest and daemon is alive.  This is what L</"
4453 "guestfs_launch> waits for."
4454 msgstr ""
4455
4456 # type: =head3
4457 #. type: =head3
4458 #: ../src/guestfs.pod:2020
4459 msgid "PROGRESS NOTIFICATION MESSAGES"
4460 msgstr ""
4461
4462 # type: textblock
4463 #. type: textblock
4464 #: ../src/guestfs.pod:2022
4465 msgid ""
4466 "The daemon may send progress notification messages at any time.  These are "
4467 "distinguished by the normal length word being replaced by "
4468 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4469 msgstr ""
4470
4471 # type: textblock
4472 #. type: textblock
4473 #: ../src/guestfs.pod:2026
4474 msgid ""
4475 "The library turns them into progress callbacks (see "
4476 "C<guestfs_set_progress_callback>) if there is a callback registered, or "
4477 "discards them if not."
4478 msgstr ""
4479
4480 # type: textblock
4481 #. type: textblock
4482 #: ../src/guestfs.pod:2030
4483 msgid ""
4484 "The daemon self-limits the frequency of progress messages it sends (see "
4485 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
4486 "messages."
4487 msgstr ""
4488
4489 # type: =head1
4490 #. type: =head1
4491 #: ../src/guestfs.pod:2034
4492 msgid "LIBGUESTFS VERSION NUMBERS"
4493 msgstr ""
4494
4495 # type: textblock
4496 #. type: textblock
4497 #: ../src/guestfs.pod:2036
4498 msgid ""
4499 "Since April 2010, libguestfs has started to make separate development and "
4500 "stable releases, along with corresponding branches in our git repository.  "
4501 "These separate releases can be identified by version number:"
4502 msgstr ""
4503
4504 # type: verbatim
4505 #. type: verbatim
4506 #: ../src/guestfs.pod:2041
4507 #, no-wrap
4508 msgid ""
4509 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
4510 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
4511 "       |\n"
4512 "       v\n"
4513 " 1  .  3  .  5\n"
4514 " ^           ^\n"
4515 " |           |\n"
4516 " |           `-------- sub-version\n"
4517 " |\n"
4518 " `------ always '1' because we don't change the ABI\n"
4519 "\n"
4520 msgstr ""
4521
4522 # type: textblock
4523 #. type: textblock
4524 #: ../src/guestfs.pod:2052
4525 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
4526 msgstr ""
4527
4528 # type: textblock
4529 #. type: textblock
4530 #: ../src/guestfs.pod:2054
4531 msgid ""
4532 "As time passes we cherry pick fixes from the development branch and backport "
4533 "those into the stable branch, the effect being that the stable branch should "
4534 "get more stable and less buggy over time.  So the stable releases are ideal "
4535 "for people who don't need new features but would just like the software to "
4536 "work."
4537 msgstr ""
4538
4539 # type: textblock
4540 #. type: textblock
4541 #: ../src/guestfs.pod:2060
4542 msgid "Our criteria for backporting changes are:"
4543 msgstr ""
4544
4545 # type: textblock
4546 #. type: textblock
4547 #: ../src/guestfs.pod:2066
4548 msgid ""
4549 "Documentation changes which don't affect any code are backported unless the "
4550 "documentation refers to a future feature which is not in stable."
4551 msgstr ""
4552
4553 # type: textblock
4554 #. type: textblock
4555 #: ../src/guestfs.pod:2072
4556 msgid ""
4557 "Bug fixes which are not controversial, fix obvious problems, and have been "
4558 "well tested are backported."
4559 msgstr ""
4560
4561 # type: textblock
4562 #. type: textblock
4563 #: ../src/guestfs.pod:2077
4564 msgid ""
4565 "Simple rearrangements of code which shouldn't affect how it works get "
4566 "backported.  This is so that the code in the two branches doesn't get too "
4567 "far out of step, allowing us to backport future fixes more easily."
4568 msgstr ""
4569
4570 # type: textblock
4571 #. type: textblock
4572 #: ../src/guestfs.pod:2083
4573 msgid ""
4574 "We I<don't> backport new features, new APIs, new tools etc, except in one "
4575 "exceptional case: the new feature is required in order to implement an "
4576 "important bug fix."
4577 msgstr ""
4578
4579 # type: textblock
4580 #. type: textblock
4581 #: ../src/guestfs.pod:2089
4582 msgid ""
4583 "A new stable branch starts when we think the new features in development are "
4584 "substantial and compelling enough over the current stable branch to warrant "
4585 "it.  When that happens we create new stable and development versions 1.N.0 "
4586 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
4587 "stable at this point, but by backporting fixes from development, that branch "
4588 "will stabilize over time."
4589 msgstr ""
4590
4591 #. type: =head1
4592 #: ../src/guestfs.pod:2097
4593 msgid "EXTENDING LIBGUESTFS"
4594 msgstr ""
4595
4596 #. type: =head2
4597 #: ../src/guestfs.pod:2099
4598 msgid "ADDING A NEW API ACTION"
4599 msgstr ""
4600
4601 #. type: textblock
4602 #: ../src/guestfs.pod:2101
4603 msgid ""
4604 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
4605 "documentation) are generated, and this makes it easy to extend the "
4606 "libguestfs API."
4607 msgstr ""
4608
4609 #. type: textblock
4610 #: ../src/guestfs.pod:2105
4611 msgid "To add a new API action there are two changes:"
4612 msgstr ""
4613
4614 #. type: textblock
4615 #: ../src/guestfs.pod:2111
4616 msgid ""
4617 "You need to add a description of the call (name, parameters, return type, "
4618 "tests, documentation) to C<generator/generator_actions.ml>."
4619 msgstr ""
4620
4621 #. type: textblock
4622 #: ../src/guestfs.pod:2114
4623 msgid ""
4624 "There are two sorts of API action, depending on whether the call goes "
4625 "through to the daemon in the appliance, or is serviced entirely by the "
4626 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
4627 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
4628 "an example of the latter, since a trace flag is maintained in the handle and "
4629 "all tracing is done on the library side."
4630 msgstr ""
4631
4632 #. type: textblock
4633 #: ../src/guestfs.pod:2122
4634 msgid ""
4635 "Most new actions are of the first type, and get added to the "
4636 "C<daemon_functions> list.  Each function has a unique procedure number used "
4637 "in the RPC protocol which is assigned to that action when we publish "
4638 "libguestfs and cannot be reused.  Take the latest procedure number and "
4639 "increment it."
4640 msgstr ""
4641
4642 #. type: textblock
4643 #: ../src/guestfs.pod:2128
4644 msgid ""
4645 "For library-only actions of the second type, add to the "
4646 "C<non_daemon_functions> list.  Since these functions are serviced by the "
4647 "library and do not travel over the RPC mechanism to the daemon, these "
4648 "functions do not need a procedure number, and so the procedure number is set "
4649 "to C<-1>."
4650 msgstr ""
4651
4652 #. type: textblock
4653 #: ../src/guestfs.pod:2136
4654 msgid "Implement the action (in C):"
4655 msgstr ""
4656
4657 #. type: textblock
4658 #: ../src/guestfs.pod:2138
4659 msgid ""
4660 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
4661 "C<daemon/> directory."
4662 msgstr ""
4663
4664 #. type: textblock
4665 #: ../src/guestfs.pod:2141
4666 msgid ""
4667 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
4668 "(note: double underscore) in the C<src/> directory."
4669 msgstr ""
4670
4671 #. type: textblock
4672 #: ../src/guestfs.pod:2144
4673 msgid "In either case, use another function as an example of what to do."
4674 msgstr ""
4675
4676 #. type: textblock
4677 #: ../src/guestfs.pod:2148
4678 msgid "After making these changes, use C<make> to compile."
4679 msgstr ""
4680
4681 #. type: textblock
4682 #: ../src/guestfs.pod:2150
4683 msgid ""
4684 "Note that you don't need to implement the RPC, language bindings, manual "
4685 "pages or anything else.  It's all automatically generated from the OCaml "
4686 "description."
4687 msgstr ""
4688
4689 #. type: =head2
4690 #: ../src/guestfs.pod:2154
4691 msgid "ADDING TESTS FOR AN API ACTION"
4692 msgstr ""
4693
4694 #. type: textblock
4695 #: ../src/guestfs.pod:2156
4696 msgid ""
4697 "You can supply zero or as many tests as you want per API call.  The tests "
4698 "can either be added as part of the API description (C<generator/"
4699 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
4700 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
4701 "slower, so if possible use the first method."
4702 msgstr ""
4703
4704 #. type: textblock
4705 #: ../src/guestfs.pod:2162
4706 msgid ""
4707 "The following describes the test environment used when you add an API test "
4708 "in C<generator_actions.ml>."
4709 msgstr ""
4710
4711 #. type: textblock
4712 #: ../src/guestfs.pod:2165
4713 msgid "The test environment has 4 block devices:"
4714 msgstr ""
4715
4716 #. type: =item
4717 #: ../src/guestfs.pod:2169
4718 msgid "C</dev/sda> 500MB"
4719 msgstr ""
4720
4721 #. type: textblock
4722 #: ../src/guestfs.pod:2171
4723 msgid "General block device for testing."
4724 msgstr ""
4725
4726 #. type: =item
4727 #: ../src/guestfs.pod:2173
4728 msgid "C</dev/sdb> 50MB"
4729 msgstr ""
4730
4731 #. type: textblock
4732 #: ../src/guestfs.pod:2175
4733 msgid ""
4734 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
4735 "operations."
4736 msgstr ""
4737
4738 #. type: =item
4739 #: ../src/guestfs.pod:2178
4740 msgid "C</dev/sdc> 10MB"
4741 msgstr ""
4742
4743 #. type: textblock
4744 #: ../src/guestfs.pod:2180
4745 msgid "Used in a few tests where two block devices are needed."
4746 msgstr ""
4747
4748 #. type: =item
4749 #: ../src/guestfs.pod:2182
4750 msgid "C</dev/sdd>"
4751 msgstr ""
4752
4753 #. type: textblock
4754 #: ../src/guestfs.pod:2184
4755 msgid "ISO with fixed content (see C<images/test.iso>)."
4756 msgstr ""
4757
4758 #. type: textblock
4759 #: ../src/guestfs.pod:2188
4760 msgid ""
4761 "To be able to run the tests in a reasonable amount of time, the libguestfs "
4762 "appliance and block devices are reused between tests.  So don't try testing "
4763 "L</guestfs_kill_subprocess> :-x"
4764 msgstr ""
4765
4766 #. type: textblock
4767 #: ../src/guestfs.pod:2192
4768 msgid ""
4769 "Each test starts with an initial scenario, selected using one of the "
4770 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
4771 "initialize the disks mentioned above in a particular way as documented in "
4772 "C<generator_types.ml>.  You should not assume anything about the previous "
4773 "contents of other disks that are not initialized."
4774 msgstr ""
4775
4776 #. type: textblock
4777 #: ../src/guestfs.pod:2198
4778 msgid ""
4779 "You can add a prerequisite clause to any individual test.  This is a run-"
4780 "time check, which, if it fails, causes the test to be skipped.  Useful if "
4781 "testing a command which might not work on all variations of libguestfs "
4782 "builds.  A test that has prerequisite of C<Always> means to run "
4783 "unconditionally."
4784 msgstr ""
4785
4786 #. type: textblock
4787 #: ../src/guestfs.pod:2204
4788 msgid ""
4789 "In addition, packagers can skip individual tests by setting environment "
4790 "variables before running C<make check>."
4791 msgstr ""
4792
4793 #. type: verbatim
4794 #: ../src/guestfs.pod:2207
4795 #, no-wrap
4796 msgid ""
4797 " SKIP_TEST_<CMD>_<NUM>=1\n"
4798 "\n"
4799 msgstr ""
4800
4801 #. type: textblock
4802 #: ../src/guestfs.pod:2209
4803 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
4804 msgstr ""
4805
4806 #. type: textblock
4807 #: ../src/guestfs.pod:2211
4808 msgid "or:"
4809 msgstr ""
4810
4811 #. type: verbatim
4812 #: ../src/guestfs.pod:2213
4813 #, no-wrap
4814 msgid ""
4815 " SKIP_TEST_<CMD>=1\n"
4816 "\n"
4817 msgstr ""
4818
4819 #. type: textblock
4820 #: ../src/guestfs.pod:2215
4821 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
4822 msgstr ""
4823
4824 #. type: textblock
4825 #: ../src/guestfs.pod:2217
4826 msgid "Packagers can run only certain tests by setting for example:"
4827 msgstr ""
4828
4829 #. type: verbatim
4830 #: ../src/guestfs.pod:2219
4831 #, no-wrap
4832 msgid ""
4833 " TEST_ONLY=\"vfs_type zerofree\"\n"
4834 "\n"
4835 msgstr ""
4836
4837 #. type: textblock
4838 #: ../src/guestfs.pod:2221
4839 msgid ""
4840 "See C<capitests/tests.c> for more details of how these environment variables "
4841 "work."
4842 msgstr ""
4843
4844 #. type: =head2
4845 #: ../src/guestfs.pod:2224
4846 msgid "DEBUGGING NEW API ACTIONS"
4847 msgstr ""
4848
4849 #. type: textblock
4850 #: ../src/guestfs.pod:2226
4851 msgid "Test new actions work before submitting them."
4852 msgstr ""
4853
4854 #. type: textblock
4855 #: ../src/guestfs.pod:2228
4856 msgid "You can use guestfish to try out new commands."
4857 msgstr ""
4858
4859 #. type: textblock
4860 #: ../src/guestfs.pod:2230
4861 msgid ""
4862 "Debugging the daemon is a problem because it runs inside a minimal "
4863 "environment.  However you can fprintf messages in the daemon to stderr, and "
4864 "they will show up if you use C<guestfish -v>."
4865 msgstr ""
4866
4867 #. type: =head2
4868 #: ../src/guestfs.pod:2234
4869 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
4870 msgstr ""
4871
4872 #. type: textblock
4873 #: ../src/guestfs.pod:2236
4874 msgid ""
4875 "Our C source code generally adheres to some basic code-formatting "
4876 "conventions.  The existing code base is not totally consistent on this "
4877 "front, but we do prefer that contributed code be formatted similarly.  In "
4878 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
4879 "indentation level, and other than that, follow the K&R style."
4880 msgstr ""
4881
4882 #. type: textblock
4883 #: ../src/guestfs.pod:2242
4884 msgid ""
4885 "If you use Emacs, add the following to one of one of your start-up files (e."
4886 "g., ~/.emacs), to help ensure that you get indentation right:"
4887 msgstr ""
4888
4889 #. type: verbatim
4890 #: ../src/guestfs.pod:2245
4891 #, no-wrap
4892 msgid ""
4893 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
4894 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
4895 " (add-hook 'find-file-hook\n"
4896 "     '(lambda () (if (and buffer-file-name\n"
4897 "                          (string-match \"/libguestfs\\\\>\"\n"
4898 "                              (buffer-file-name))\n"
4899 "                          (not (string-equal mode-name \"Change Log\"))\n"
4900 "                          (not (string-equal mode-name \"Makefile\")))\n"
4901 "                     (setq indent-tabs-mode nil))))\n"
4902 " \n"
4903 msgstr ""
4904
4905 #. type: verbatim
4906 #: ../src/guestfs.pod:2255
4907 #, no-wrap
4908 msgid ""
4909 " ;;; When editing C sources in libguestfs, use this style.\n"
4910 " (defun libguestfs-c-mode ()\n"
4911 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
4912 "   (interactive)\n"
4913 "   (c-set-style \"K&R\")\n"
4914 "   (setq c-indent-level 2)\n"
4915 "   (setq c-basic-offset 2))\n"
4916 " (add-hook 'c-mode-hook\n"
4917 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
4918 "                               (buffer-file-name))\n"
4919 "                           (libguestfs-c-mode))))\n"
4920 "\n"
4921 msgstr ""
4922
4923 #. type: textblock
4924 #: ../src/guestfs.pod:2267
4925 msgid "Enable warnings when compiling (and fix any problems this finds):"
4926 msgstr ""
4927
4928 #. type: verbatim
4929 #: ../src/guestfs.pod:2270
4930 #, no-wrap
4931 msgid ""
4932 " ./configure --enable-gcc-warnings\n"
4933 "\n"
4934 msgstr ""
4935
4936 #. type: textblock
4937 #: ../src/guestfs.pod:2272
4938 msgid "Useful targets are:"
4939 msgstr ""
4940
4941 #. type: verbatim
4942 #: ../src/guestfs.pod:2274
4943 #, no-wrap
4944 msgid ""
4945 " make syntax-check  # checks the syntax of the C code\n"
4946 " make check         # runs the test suite\n"
4947 "\n"
4948 msgstr ""
4949
4950 #. type: =head2
4951 #: ../src/guestfs.pod:2277
4952 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
4953 msgstr ""
4954
4955 #. type: textblock
4956 #: ../src/guestfs.pod:2279
4957 msgid ""
4958 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
4959 "which are used to do shell quoting."
4960 msgstr ""
4961
4962 #. type: =item
4963 #: ../src/guestfs.pod:2284
4964 msgid "%Q"
4965 msgstr ""
4966
4967 #. type: textblock
4968 #: ../src/guestfs.pod:2286
4969 msgid ""
4970 "Simple shell quoted string.  Any spaces or other shell characters are "
4971 "escaped for you."
4972 msgstr ""
4973
4974 #. type: =item
4975 #: ../src/guestfs.pod:2289
4976 msgid "%R"
4977 msgstr ""
4978
4979 #. type: textblock
4980 #: ../src/guestfs.pod:2291
4981 msgid ""
4982 "Same as C<%Q> except the string is treated as a path which is prefixed by "
4983 "the sysroot."
4984 msgstr ""
4985
4986 # type: textblock
4987 #. type: textblock
4988 #: ../src/guestfs.pod:2296 ../fish/guestfish.pod:240 ../fish/guestfish.pod:594
4989 msgid "For example:"
4990 msgstr ""
4991
4992 #. type: verbatim
4993 #: ../src/guestfs.pod:2298
4994 #, no-wrap
4995 msgid ""
4996 " asprintf (&cmd, \"cat %R\", path);\n"
4997 "\n"
4998 msgstr ""
4999
5000 #. type: textblock
5001 #: ../src/guestfs.pod:2300
5002 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5003 msgstr ""
5004
5005 #. type: textblock
5006 #: ../src/guestfs.pod:2302
5007 msgid ""
5008 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5009 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5010 "they are not passed via the shell (instead, straight to exec).  You probably "
5011 "want to use the C<sysroot_path()> function however."
5012 msgstr ""
5013
5014 #. type: =head2
5015 #: ../src/guestfs.pod:2308
5016 msgid "SUBMITTING YOUR NEW API ACTIONS"
5017 msgstr ""
5018
5019 #. type: textblock
5020 #: ../src/guestfs.pod:2310
5021 msgid ""
5022 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5023 "libguestfs> and CC to L<rjones@redhat.com>."
5024 msgstr ""
5025
5026 #. type: =head2
5027 #: ../src/guestfs.pod:2314
5028 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5029 msgstr ""
5030
5031 #. type: textblock
5032 #: ../src/guestfs.pod:2316
5033 msgid "We support i18n (gettext anyhow) in the library."
5034 msgstr ""
5035
5036 #. type: textblock
5037 #: ../src/guestfs.pod:2318
5038 msgid ""
5039 "However many messages come from the daemon, and we don't translate those at "
5040 "the moment.  One reason is that the appliance generally has all locale files "
5041 "removed from it, because they take up a lot of space.  So we'd have to readd "
5042 "some of those, as well as copying our PO files into the appliance."
5043 msgstr ""
5044
5045 #. type: textblock
5046 #: ../src/guestfs.pod:2324
5047 msgid ""
5048 "Debugging messages are never translated, since they are intended for the "
5049 "programmers."
5050 msgstr ""
5051
5052 #. type: =head2
5053 #: ../src/guestfs.pod:2327
5054 msgid "SOURCE CODE SUBDIRECTORIES"
5055 msgstr ""
5056
5057 #. type: =item
5058 #: ../src/guestfs.pod:2331
5059 msgid "C<appliance>"
5060 msgstr ""
5061
5062 #. type: textblock
5063 #: ../src/guestfs.pod:2333
5064 msgid "The libguestfs appliance, build scripts and so on."
5065 msgstr ""
5066
5067 #. type: =item
5068 #: ../src/guestfs.pod:2335
5069 msgid "C<capitests>"
5070 msgstr ""
5071
5072 #. type: textblock
5073 #: ../src/guestfs.pod:2337
5074 msgid "Automated tests of the C API."
5075 msgstr ""
5076
5077 #. type: =item
5078 #: ../src/guestfs.pod:2339
5079 msgid "C<cat>"
5080 msgstr ""
5081
5082 #. type: textblock
5083 #: ../src/guestfs.pod:2341
5084 msgid ""
5085 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5086 "documentation."
5087 msgstr ""
5088
5089 #. type: =item
5090 #: ../src/guestfs.pod:2344
5091 msgid "C<caution>"
5092 msgstr ""
5093
5094 #. type: textblock
5095 #: ../src/guestfs.pod:2346
5096 msgid ""
5097 "Safety and liveness tests of components that libguestfs depends upon (not of "
5098 "libguestfs itself).  Mainly this is for qemu and the kernel."
5099 msgstr ""
5100
5101 #. type: =item
5102 #: ../src/guestfs.pod:2349
5103 msgid "C<contrib>"
5104 msgstr ""
5105
5106 #. type: textblock
5107 #: ../src/guestfs.pod:2351
5108 msgid "Outside contributions, experimental parts."
5109 msgstr ""
5110
5111 #. type: =item
5112 #: ../src/guestfs.pod:2353
5113 msgid "C<daemon>"
5114 msgstr ""
5115
5116 #. type: textblock
5117 #: ../src/guestfs.pod:2355
5118 msgid ""
5119 "The daemon that runs inside the libguestfs appliance and carries out actions."
5120 msgstr ""
5121
5122 #. type: =item
5123 #: ../src/guestfs.pod:2358
5124 msgid "C<df>"
5125 msgstr ""
5126
5127 #. type: textblock
5128 #: ../src/guestfs.pod:2360
5129 msgid "L<virt-df(1)> command and documentation."
5130 msgstr ""
5131
5132 #. type: =item
5133 #: ../src/guestfs.pod:2362
5134 msgid "C<examples>"
5135 msgstr ""
5136
5137 #. type: textblock
5138 #: ../src/guestfs.pod:2364
5139 msgid "C API example code."
5140 msgstr ""
5141
5142 #. type: =item
5143 #: ../src/guestfs.pod:2366
5144 msgid "C<fish>"
5145 msgstr ""
5146
5147 #. type: textblock
5148 #: ../src/guestfs.pod:2368
5149 msgid "L<guestfish(1)>, the command-line shell."
5150 msgstr ""
5151
5152 #. type: =item
5153 #: ../src/guestfs.pod:2370
5154 msgid "C<fuse>"
5155 msgstr ""
5156
5157 #. type: textblock
5158 #: ../src/guestfs.pod:2372
5159 msgid ""
5160 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5161 msgstr ""
5162
5163 #. type: =item
5164 #: ../src/guestfs.pod:2374
5165 msgid "C<generator>"
5166 msgstr ""
5167
5168 #. type: textblock
5169 #: ../src/guestfs.pod:2376
5170 msgid ""
5171 "The crucially important generator, used to automatically generate large "
5172 "amounts of boilerplate C code for things like RPC and bindings."
5173 msgstr ""
5174
5175 #. type: =item
5176 #: ../src/guestfs.pod:2379
5177 msgid "C<images>"
5178 msgstr ""
5179
5180 #. type: textblock
5181 #: ../src/guestfs.pod:2381
5182 msgid "Files used by the test suite."
5183 msgstr ""
5184
5185 #. type: textblock
5186 #: ../src/guestfs.pod:2383
5187 msgid "Some \"phony\" guest images which we test against."
5188 msgstr ""
5189
5190 #. type: =item
5191 #: ../src/guestfs.pod:2385
5192 msgid "C<inspector>"
5193 msgstr ""
5194
5195 #. type: textblock
5196 #: ../src/guestfs.pod:2387
5197 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5198 msgstr ""
5199
5200 #. type: =item
5201 #: ../src/guestfs.pod:2389
5202 msgid "C<m4>"
5203 msgstr ""
5204
5205 #. type: textblock
5206 #: ../src/guestfs.pod:2391
5207 msgid "M4 macros used by autoconf."
5208 msgstr ""
5209
5210 #. type: =item
5211 #: ../src/guestfs.pod:2393
5212 msgid "C<po>"
5213 msgstr ""
5214
5215 #. type: textblock
5216 #: ../src/guestfs.pod:2395
5217 msgid "Translations of simple gettext strings."
5218 msgstr ""
5219
5220 #. type: =item
5221 #: ../src/guestfs.pod:2397
5222 msgid "C<po-docs>"
5223 msgstr ""
5224
5225 #. type: textblock
5226 #: ../src/guestfs.pod:2399
5227 msgid ""
5228 "The build infrastructure and PO files for translations of manpages and POD "
5229 "files.  Eventually this will be combined with the C<po> directory, but that "
5230 "is rather complicated."
5231 msgstr ""
5232
5233 #. type: =item
5234 #: ../src/guestfs.pod:2403
5235 msgid "C<regressions>"
5236 msgstr ""
5237
5238 #. type: textblock
5239 #: ../src/guestfs.pod:2405
5240 msgid "Regression tests."
5241 msgstr ""
5242
5243 #. type: =item
5244 #: ../src/guestfs.pod:2407
5245 msgid "C<rescue>"
5246 msgstr ""
5247
5248 #. type: textblock
5249 #: ../src/guestfs.pod:2409
5250 msgid "L<virt-rescue(1)> command and documentation."
5251 msgstr ""
5252
5253 #. type: =item
5254 #: ../src/guestfs.pod:2411
5255 msgid "C<src>"
5256 msgstr ""
5257
5258 #. type: textblock
5259 #: ../src/guestfs.pod:2413
5260 msgid "Source code to the C library."
5261 msgstr ""
5262
5263 #. type: =item
5264 #: ../src/guestfs.pod:2415
5265 msgid "C<tools>"
5266 msgstr ""
5267
5268 #. type: textblock
5269 #: ../src/guestfs.pod:2417
5270 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5271 msgstr ""
5272
5273 #. type: =item
5274 #: ../src/guestfs.pod:2419
5275 msgid "C<test-tool>"
5276 msgstr ""
5277
5278 #. type: textblock
5279 #: ../src/guestfs.pod:2421
5280 msgid ""
5281 "Test tool for end users to test if their qemu/kernel combination will work "
5282 "with libguestfs."
5283 msgstr ""
5284
5285 #. type: =item
5286 #: ../src/guestfs.pod:2424
5287 msgid "C<csharp>"
5288 msgstr ""
5289
5290 #. type: =item
5291 #: ../src/guestfs.pod:2426
5292 msgid "C<haskell>"
5293 msgstr ""
5294
5295 #. type: =item
5296 #: ../src/guestfs.pod:2428
5297 msgid "C<java>"
5298 msgstr ""
5299
5300 #. type: =item
5301 #: ../src/guestfs.pod:2430
5302 msgid "C<ocaml>"
5303 msgstr ""
5304
5305 #. type: =item
5306 #: ../src/guestfs.pod:2432
5307 msgid "C<php>"
5308 msgstr ""
5309
5310 #. type: =item
5311 #: ../src/guestfs.pod:2434
5312 msgid "C<perl>"
5313 msgstr ""
5314
5315 #. type: =item
5316 #: ../src/guestfs.pod:2436
5317 msgid "C<python>"
5318 msgstr ""
5319
5320 #. type: =item
5321 #: ../src/guestfs.pod:2438
5322 msgid "C<ruby>"
5323 msgstr ""
5324
5325 #. type: textblock
5326 #: ../src/guestfs.pod:2440
5327 msgid "Language bindings."
5328 msgstr ""
5329
5330 # type: =head1
5331 #. type: =head1
5332 #: ../src/guestfs.pod:2444 ../fish/guestfish.pod:965
5333 #: ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:375
5334 msgid "ENVIRONMENT VARIABLES"
5335 msgstr ""
5336
5337 # type: =item
5338 #. type: =item
5339 #: ../src/guestfs.pod:2448 ../fish/guestfish.pod:991
5340 msgid "LIBGUESTFS_APPEND"
5341 msgstr ""
5342
5343 # type: textblock
5344 #. type: textblock
5345 #: ../src/guestfs.pod:2450 ../fish/guestfish.pod:993
5346 msgid "Pass additional options to the guest kernel."
5347 msgstr ""
5348
5349 # type: =item
5350 #. type: =item
5351 #: ../src/guestfs.pod:2452 ../fish/guestfish.pod:995
5352 msgid "LIBGUESTFS_DEBUG"
5353 msgstr ""
5354
5355 # type: textblock
5356 #. type: textblock
5357 #: ../src/guestfs.pod:2454
5358 msgid ""
5359 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
5360 "effect as calling C<guestfs_set_verbose (g, 1)>."
5361 msgstr ""
5362
5363 # type: =item
5364 #. type: =item
5365 #: ../src/guestfs.pod:2457 ../fish/guestfish.pod:1000
5366 msgid "LIBGUESTFS_MEMSIZE"
5367 msgstr ""
5368
5369 # type: textblock
5370 #. type: textblock
5371 #: ../src/guestfs.pod:2459 ../fish/guestfish.pod:1002
5372 msgid ""
5373 "Set the memory allocated to the qemu process, in megabytes.  For example:"
5374 msgstr ""
5375
5376 # type: verbatim
5377 #. type: verbatim
5378 #: ../src/guestfs.pod:2462 ../fish/guestfish.pod:1005
5379 #, no-wrap
5380 msgid ""
5381 " LIBGUESTFS_MEMSIZE=700\n"
5382 "\n"
5383 msgstr ""
5384
5385 # type: =item
5386 #. type: =item
5387 #: ../src/guestfs.pod:2464 ../fish/guestfish.pod:1007
5388 msgid "LIBGUESTFS_PATH"
5389 msgstr ""
5390
5391 #. type: textblock
5392 #: ../src/guestfs.pod:2466
5393 msgid ""
5394 "Set the path that libguestfs uses to search for a supermin appliance.  See "
5395 "the discussion of paths in section L</PATH> above."
5396 msgstr ""
5397
5398 # type: =item
5399 #. type: =item
5400 #: ../src/guestfs.pod:2469 ../fish/guestfish.pod:1012
5401 msgid "LIBGUESTFS_QEMU"
5402 msgstr ""
5403
5404 # type: textblock
5405 #. type: textblock
5406 #: ../src/guestfs.pod:2471 ../fish/guestfish.pod:1014
5407 msgid ""
5408 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
5409 "which was found at compile time by the configure script is used."
5410 msgstr ""
5411
5412 # type: textblock
5413 #. type: textblock
5414 #: ../src/guestfs.pod:2475
5415 msgid "See also L</QEMU WRAPPERS> above."
5416 msgstr ""
5417
5418 # type: =item
5419 #. type: =item
5420 #: ../src/guestfs.pod:2477 ../fish/guestfish.pod:1018
5421 msgid "LIBGUESTFS_TRACE"
5422 msgstr ""
5423
5424 # type: textblock
5425 #. type: textblock
5426 #: ../src/guestfs.pod:2479
5427 msgid ""
5428 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
5429 "effect as calling C<guestfs_set_trace (g, 1)>."
5430 msgstr ""
5431
5432 # type: =item
5433 #. type: =item
5434 #: ../src/guestfs.pod:2482 ../fish/guestfish.pod:1027
5435 msgid "TMPDIR"
5436 msgstr ""
5437
5438 # type: textblock
5439 #. type: textblock
5440 #: ../src/guestfs.pod:2484 ../fish/guestfish.pod:1029
5441 msgid "Location of temporary directory, defaults to C</tmp>."
5442 msgstr ""
5443
5444 # type: textblock
5445 #. type: textblock
5446 #: ../src/guestfs.pod:2486 ../fish/guestfish.pod:1031
5447 msgid ""
5448 "If libguestfs was compiled to use the supermin appliance then the real "
5449 "appliance is cached in this directory, shared between all handles belonging "
5450 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
5451 "use in case C</tmp> is not large enough."
5452 msgstr ""
5453
5454 # type: =head1
5455 #. type: =head1
5456 #: ../src/guestfs.pod:2494 ../fish/guestfish.pod:1089
5457 #: ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:233
5458 #: ../tools/virt-edit.pl:395 ../tools/virt-win-reg.pl:572
5459 #: ../tools/virt-resize.pl:1483 ../tools/virt-list-filesystems.pl:189
5460 #: ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:539
5461 #: ../tools/virt-list-partitions.pl:257
5462 msgid "SEE ALSO"
5463 msgstr ""
5464
5465 # type: textblock
5466 #. type: textblock
5467 #: ../src/guestfs.pod:2496
5468 msgid ""
5469 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-"
5470 "ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-df(1)>, "
5471 "L<virt-edit(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-"
5472 "filesystems(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)"
5473 ">, L<virt-rescue(1)>, L<virt-tar(1)>, L<virt-win-reg(1)>, L<qemu(1)>, "
5474 "L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
5475 msgstr ""
5476
5477 # type: textblock
5478 #. type: textblock
5479 #: ../src/guestfs.pod:2519
5480 msgid ""
5481 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
5482 "(8)>, L<disktype(1)>."
5483 msgstr ""
5484
5485 # type: =head1
5486 #. type: =head1
5487 #: ../src/guestfs.pod:2526 ../tools/virt-win-reg.pl:587
5488 #: ../tools/virt-make-fs.pl:553
5489 msgid "BUGS"
5490 msgstr ""
5491
5492 # type: textblock
5493 #. type: textblock
5494 #: ../src/guestfs.pod:2528
5495 msgid "To get a list of bugs against libguestfs use this link:"
5496 msgstr ""
5497
5498 # type: textblock
5499 #. type: textblock
5500 #: ../src/guestfs.pod:2530
5501 msgid ""
5502 "L<https://bugzilla.redhat.com/buglist.cgi?"
5503 "component=libguestfs&product=Virtualization+Tools>"
5504 msgstr ""
5505
5506 # type: textblock
5507 #. type: textblock
5508 #: ../src/guestfs.pod:2532
5509 msgid "To report a new bug against libguestfs use this link:"
5510 msgstr ""
5511
5512 # type: textblock
5513 #. type: textblock
5514 #: ../src/guestfs.pod:2534
5515 msgid ""
5516 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5517 "component=libguestfs&product=Virtualization+Tools>"
5518 msgstr ""
5519
5520 # type: textblock
5521 #. type: textblock
5522 #: ../src/guestfs.pod:2536
5523 msgid "When reporting a bug, please check:"
5524 msgstr ""
5525
5526 # type: textblock
5527 #. type: textblock
5528 #: ../src/guestfs.pod:2542
5529 msgid "That the bug hasn't been reported already."
5530 msgstr ""
5531
5532 # type: textblock
5533 #. type: textblock
5534 #: ../src/guestfs.pod:2546
5535 msgid "That you are testing a recent version."
5536 msgstr ""
5537
5538 # type: textblock
5539 #. type: textblock
5540 #: ../src/guestfs.pod:2550
5541 msgid "Describe the bug accurately, and give a way to reproduce it."
5542 msgstr ""
5543
5544 # type: textblock
5545 #. type: textblock
5546 #: ../src/guestfs.pod:2554
5547 msgid ""
5548 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
5549 "bug report."
5550 msgstr ""
5551
5552 # type: =head1
5553 #. type: =head1
5554 #: ../src/guestfs.pod:2559 ../fish/guestfish.pod:1108
5555 #: ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:244
5556 msgid "AUTHORS"
5557 msgstr ""
5558
5559 # type: textblock
5560 #. type: textblock
5561 #: ../src/guestfs.pod:2561 ../fish/guestfish.pod:1110
5562 #: ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:246
5563 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
5564 msgstr ""
5565
5566 # type: =head1
5567 #. type: =head1
5568 #: ../src/guestfs.pod:2563 ../fish/guestfish.pod:1112
5569 #: ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:248
5570 #: ../tools/virt-edit.pl:411 ../tools/virt-win-reg.pl:602
5571 #: ../tools/virt-resize.pl:1508 ../tools/virt-list-filesystems.pl:206
5572 #: ../tools/virt-tar.pl:296 ../tools/virt-make-fs.pl:568
5573 #: ../tools/virt-list-partitions.pl:273
5574 msgid "COPYRIGHT"
5575 msgstr ""
5576
5577 # type: textblock
5578 #. type: textblock
5579 #: ../src/guestfs.pod:2565 ../fish/guestfish.pod:1114
5580 #: ../fuse/guestmount.pod:250
5581 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
5582 msgstr ""
5583
5584 # type: textblock
5585 #. type: textblock
5586 #: ../src/guestfs.pod:2568
5587 msgid ""
5588 "This library is free software; you can redistribute it and/or modify it "
5589 "under the terms of the GNU Lesser General Public License as published by the "
5590 "Free Software Foundation; either version 2 of the License, or (at your "
5591 "option) any later version."
5592 msgstr ""
5593
5594 # type: textblock
5595 #. type: textblock
5596 #: ../src/guestfs.pod:2573
5597 msgid ""
5598 "This library is distributed in the hope that it will be useful, but WITHOUT "
5599 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
5600 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
5601 "for more details."
5602 msgstr ""
5603
5604 # type: textblock
5605 #. type: textblock
5606 #: ../src/guestfs.pod:2578
5607 msgid ""
5608 "You should have received a copy of the GNU Lesser General Public License "
5609 "along with this library; if not, write to the Free Software Foundation, "
5610 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
5611 msgstr ""
5612
5613 # type: =head2
5614 #. type: =head2
5615 #: ../src/guestfs-actions.pod:1
5616 msgid "guestfs_add_cdrom"
5617 msgstr ""
5618
5619 # type: verbatim
5620 #. type: verbatim
5621 #: ../src/guestfs-actions.pod:3
5622 #, no-wrap
5623 msgid ""
5624 " int\n"
5625 " guestfs_add_cdrom (guestfs_h *g,\n"
5626 "                    const char *filename);\n"
5627 "\n"
5628 msgstr ""
5629
5630 # type: textblock
5631 #. type: textblock
5632 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
5633 msgid "This function adds a virtual CD-ROM disk image to the guest."
5634 msgstr ""
5635
5636 # type: textblock
5637 #. type: textblock
5638 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
5639 msgid "This is equivalent to the qemu parameter C<-cdrom filename>."
5640 msgstr ""
5641
5642 # type: textblock
5643 #. type: textblock
5644 #: ../src/guestfs-actions.pod:17
5645 msgid ""
5646 "This call checks for the existence of C<filename>.  This stops you from "
5647 "specifying other types of drive which are supported by qemu such as C<nbd:> "
5648 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
5649 "instead."
5650 msgstr ""
5651
5652 # type: textblock
5653 #. type: textblock
5654 #: ../src/guestfs-actions.pod:24
5655 msgid ""
5656 "If you just want to add an ISO file (often you use this as an efficient way "
5657 "to transfer large files into the guest), then you should probably use "
5658 "C<guestfs_add_drive_ro> instead."
5659 msgstr ""
5660
5661 # type: textblock
5662 #. type: textblock
5663 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:126
5664 #: ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:224
5665 #: ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:259
5666 #: ../src/guestfs-actions.pod:279 ../src/guestfs-actions.pod:293
5667 #: ../src/guestfs-actions.pod:408 ../src/guestfs-actions.pod:428
5668 #: ../src/guestfs-actions.pod:442 ../src/guestfs-actions.pod:487
5669 #: ../src/guestfs-actions.pod:515 ../src/guestfs-actions.pod:533
5670 #: ../src/guestfs-actions.pod:600 ../src/guestfs-actions.pod:633
5671 #: ../src/guestfs-actions.pod:647 ../src/guestfs-actions.pod:662
5672 #: ../src/guestfs-actions.pod:761 ../src/guestfs-actions.pod:779
5673 #: ../src/guestfs-actions.pod:793 ../src/guestfs-actions.pod:807
5674 #: ../src/guestfs-actions.pod:968 ../src/guestfs-actions.pod:988
5675 #: ../src/guestfs-actions.pod:1006 ../src/guestfs-actions.pod:1090
5676 #: ../src/guestfs-actions.pod:1108 ../src/guestfs-actions.pod:1127
5677 #: ../src/guestfs-actions.pod:1141 ../src/guestfs-actions.pod:1161
5678 #: ../src/guestfs-actions.pod:1231 ../src/guestfs-actions.pod:1262
5679 #: ../src/guestfs-actions.pod:1287 ../src/guestfs-actions.pod:1324
5680 #: ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1464
5681 #: ../src/guestfs-actions.pod:1679 ../src/guestfs-actions.pod:1701
5682 #: ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:2240
5683 #: ../src/guestfs-actions.pod:2384 ../src/guestfs-actions.pod:2445
5684 #: ../src/guestfs-actions.pod:2480 ../src/guestfs-actions.pod:3223
5685 #: ../src/guestfs-actions.pod:3238 ../src/guestfs-actions.pod:3258
5686 #: ../src/guestfs-actions.pod:3413 ../src/guestfs-actions.pod:3427
5687 #: ../src/guestfs-actions.pod:3440 ../src/guestfs-actions.pod:3454
5688 #: ../src/guestfs-actions.pod:3469 ../src/guestfs-actions.pod:3505
5689 #: ../src/guestfs-actions.pod:3577 ../src/guestfs-actions.pod:3597
5690 #: ../src/guestfs-actions.pod:3614 ../src/guestfs-actions.pod:3637
5691 #: ../src/guestfs-actions.pod:3660 ../src/guestfs-actions.pod:3692
5692 #: ../src/guestfs-actions.pod:3711 ../src/guestfs-actions.pod:3730
5693 #: ../src/guestfs-actions.pod:3765 ../src/guestfs-actions.pod:3777
5694 #: ../src/guestfs-actions.pod:3813 ../src/guestfs-actions.pod:3829
5695 #: ../src/guestfs-actions.pod:3842 ../src/guestfs-actions.pod:3857
5696 #: ../src/guestfs-actions.pod:3874 ../src/guestfs-actions.pod:3967
5697 #: ../src/guestfs-actions.pod:3987 ../src/guestfs-actions.pod:4000
5698 #: ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4069
5699 #: ../src/guestfs-actions.pod:4087 ../src/guestfs-actions.pod:4103
5700 #: ../src/guestfs-actions.pod:4117 ../src/guestfs-actions.pod:4131
5701 #: ../src/guestfs-actions.pod:4148 ../src/guestfs-actions.pod:4163
5702 #: ../src/guestfs-actions.pod:4183 ../src/guestfs-actions.pod:4229
5703 #: ../src/guestfs-actions.pod:4302 ../src/guestfs-actions.pod:4333
5704 #: ../src/guestfs-actions.pod:4352 ../src/guestfs-actions.pod:4371
5705 #: ../src/guestfs-actions.pod:4383 ../src/guestfs-actions.pod:4400
5706 #: ../src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:4428
5707 #: ../src/guestfs-actions.pod:4443 ../src/guestfs-actions.pod:4478
5708 #: ../src/guestfs-actions.pod:4493 ../src/guestfs-actions.pod:4513
5709 #: ../src/guestfs-actions.pod:4527 ../src/guestfs-actions.pod:4544
5710 #: ../src/guestfs-actions.pod:4593 ../src/guestfs-actions.pod:4639
5711 #: ../src/guestfs-actions.pod:4653 ../src/guestfs-actions.pod:4681
5712 #: ../src/guestfs-actions.pod:4698 ../src/guestfs-actions.pod:4716
5713 #: ../src/guestfs-actions.pod:4850 ../src/guestfs-actions.pod:4907
5714 #: ../src/guestfs-actions.pod:4929 ../src/guestfs-actions.pod:4947
5715 #: ../src/guestfs-actions.pod:4979 ../src/guestfs-actions.pod:5045
5716 #: ../src/guestfs-actions.pod:5062 ../src/guestfs-actions.pod:5075
5717 #: ../src/guestfs-actions.pod:5089 ../src/guestfs-actions.pod:5378
5718 #: ../src/guestfs-actions.pod:5397 ../src/guestfs-actions.pod:5411
5719 #: ../src/guestfs-actions.pod:5423 ../src/guestfs-actions.pod:5437
5720 #: ../src/guestfs-actions.pod:5449 ../src/guestfs-actions.pod:5463
5721 #: ../src/guestfs-actions.pod:5479 ../src/guestfs-actions.pod:5500
5722 #: ../src/guestfs-actions.pod:5519 ../src/guestfs-actions.pod:5538
5723 #: ../src/guestfs-actions.pod:5556 ../src/guestfs-actions.pod:5579
5724 #: ../src/guestfs-actions.pod:5597 ../src/guestfs-actions.pod:5616
5725 #: ../src/guestfs-actions.pod:5637 ../src/guestfs-actions.pod:5656
5726 #: ../src/guestfs-actions.pod:5673 ../src/guestfs-actions.pod:5701
5727 #: ../src/guestfs-actions.pod:5725 ../src/guestfs-actions.pod:5744
5728 #: ../src/guestfs-actions.pod:5768 ../src/guestfs-actions.pod:5783
5729 #: ../src/guestfs-actions.pod:5798 ../src/guestfs-actions.pod:5817
5730 #: ../src/guestfs-actions.pod:5854 ../src/guestfs-actions.pod:5877
5731 #: ../src/guestfs-actions.pod:5903 ../src/guestfs-actions.pod:6011
5732 #: ../src/guestfs-actions.pod:6132 ../src/guestfs-actions.pod:6144
5733 #: ../src/guestfs-actions.pod:6157 ../src/guestfs-actions.pod:6170
5734 #: ../src/guestfs-actions.pod:6192 ../src/guestfs-actions.pod:6205
5735 #: ../src/guestfs-actions.pod:6218 ../src/guestfs-actions.pod:6231
5736 #: ../src/guestfs-actions.pod:6246 ../src/guestfs-actions.pod:6305
5737 #: ../src/guestfs-actions.pod:6322 ../src/guestfs-actions.pod:6338
5738 #: ../src/guestfs-actions.pod:6354 ../src/guestfs-actions.pod:6371
5739 #: ../src/guestfs-actions.pod:6384 ../src/guestfs-actions.pod:6404
5740 #: ../src/guestfs-actions.pod:6440 ../src/guestfs-actions.pod:6454
5741 #: ../src/guestfs-actions.pod:6495 ../src/guestfs-actions.pod:6508
5742 #: ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6560
5743 #: ../src/guestfs-actions.pod:6596 ../src/guestfs-actions.pod:6715
5744 #: ../src/guestfs-actions.pod:6733 ../src/guestfs-actions.pod:6747
5745 #: ../src/guestfs-actions.pod:6802 ../src/guestfs-actions.pod:6815
5746 #: ../src/guestfs-actions.pod:6860 ../src/guestfs-actions.pod:6893
5747 #: ../src/guestfs-actions.pod:6947 ../src/guestfs-actions.pod:6973
5748 #: ../src/guestfs-actions.pod:7039 ../src/guestfs-actions.pod:7058
5749 #: ../src/guestfs-actions.pod:7087
5750 msgid "This function returns 0 on success or -1 on error."
5751 msgstr ""
5752
5753 #. type: textblock
5754 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:240
5755 #: ../src/guestfs-actions.pod:261
5756 msgid ""
5757 "This function is deprecated.  In new code, use the L</"
5758 "guestfs_add_drive_opts> call instead."
5759 msgstr ""
5760
5761 # type: textblock
5762 #. type: textblock
5763 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:243
5764 #: ../src/guestfs-actions.pod:264 ../src/guestfs-actions.pod:1435
5765 #: ../src/guestfs-actions.pod:1918 ../src/guestfs-actions.pod:1939
5766 #: ../src/guestfs-actions.pod:4188 ../src/guestfs-actions.pod:6981
5767 #: ../src/guestfs-actions.pod:7150 ../fish/guestfish-actions.pod:31
5768 #: ../fish/guestfish-actions.pod:154 ../fish/guestfish-actions.pod:168
5769 #: ../fish/guestfish-actions.pod:949 ../fish/guestfish-actions.pod:1303
5770 #: ../fish/guestfish-actions.pod:1317 ../fish/guestfish-actions.pod:2817
5771 #: ../fish/guestfish-actions.pod:4630 ../fish/guestfish-actions.pod:4727
5772 msgid ""
5773 "Deprecated functions will not be removed from the API, but the fact that "
5774 "they are deprecated indicates that there are problems with correct use of "
5775 "these functions."
5776 msgstr ""
5777
5778 # type: textblock
5779 #. type: textblock
5780 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:128
5781 #: ../src/guestfs-actions.pod:1092 ../src/guestfs-actions.pod:1890
5782 #: ../src/guestfs-actions.pod:1988 ../src/guestfs-actions.pod:2091
5783 #: ../src/guestfs-actions.pod:3225 ../src/guestfs-actions.pod:3240
5784 #: ../src/guestfs-actions.pod:4480 ../src/guestfs-actions.pod:5558
5785 #: ../src/guestfs-actions.pod:5675 ../src/guestfs-actions.pod:5785
5786 #: ../src/guestfs-actions.pod:6248 ../src/guestfs-actions.pod:6373
5787 #: ../src/guestfs-actions.pod:6895
5788 msgid "(Added in 0.3)"
5789 msgstr ""
5790
5791 # type: =head2
5792 #. type: =head2
5793 #: ../src/guestfs-actions.pod:41
5794 msgid "guestfs_add_domain"
5795 msgstr ""
5796
5797 # type: verbatim
5798 #. type: verbatim
5799 #: ../src/guestfs-actions.pod:43
5800 #, no-wrap
5801 msgid ""
5802 " int\n"
5803 " guestfs_add_domain (guestfs_h *g,\n"
5804 "                     const char *dom,\n"
5805 "                     ...);\n"
5806 "\n"
5807 msgstr ""
5808
5809 # type: textblock
5810 #. type: textblock
5811 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:137
5812 #: ../src/guestfs-actions.pod:4202
5813 msgid ""
5814 "You may supply a list of optional arguments to this call.  Use zero or more "
5815 "of the following pairs of parameters, and terminate the list with C<-1> on "
5816 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
5817 msgstr ""
5818
5819 # type: verbatim
5820 #. type: verbatim
5821 #: ../src/guestfs-actions.pod:53
5822 #, no-wrap
5823 msgid ""
5824 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
5825 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
5826 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
5827 "\n"
5828 msgstr ""
5829
5830 # type: textblock
5831 #. type: textblock
5832 #: ../src/guestfs-actions.pod:57
5833 msgid ""
5834 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
5835 "It works by connecting to libvirt, requesting the domain and domain XML from "
5836 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
5837 "one."
5838 msgstr ""
5839
5840 # type: textblock
5841 #. type: textblock
5842 #: ../src/guestfs-actions.pod:62 ../fish/guestfish-actions.pod:46
5843 msgid ""
5844 "The number of disks added is returned.  This operation is atomic: if an "
5845 "error is returned, then no disks are added."
5846 msgstr ""
5847
5848 # type: textblock
5849 #. type: textblock
5850 #: ../src/guestfs-actions.pod:65 ../fish/guestfish-actions.pod:49
5851 msgid ""
5852 "This function does some minimal checks to make sure the libvirt domain is "
5853 "not running (unless C<readonly> is true).  In a future version we will try "
5854 "to acquire the libvirt lock on each disk."
5855 msgstr ""
5856
5857 # type: textblock
5858 #. type: textblock
5859 #: ../src/guestfs-actions.pod:69 ../fish/guestfish-actions.pod:53
5860 msgid ""
5861 "Disks must be accessible locally.  This often means that adding disks from a "
5862 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
5863 "unless those disks are accessible via the same device path locally too."
5864 msgstr ""
5865
5866 #. type: textblock
5867 #: ../src/guestfs-actions.pod:74 ../fish/guestfish-actions.pod:58
5868 msgid ""
5869 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
5870 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
5871 "libvirt URI (or one set through an environment variable, see the libvirt "
5872 "documentation for full details)."
5873 msgstr ""
5874
5875 # type: textblock
5876 #. type: textblock
5877 #: ../src/guestfs-actions.pod:80
5878 msgid ""
5879 "The other optional parameters are passed directly through to "
5880 "C<guestfs_add_drive_opts>."
5881 msgstr ""
5882
5883 # type: textblock
5884 #. type: textblock
5885 #: ../src/guestfs-actions.pod:83 ../src/guestfs-actions.pod:336
5886 #: ../src/guestfs-actions.pod:501 ../src/guestfs-actions.pod:679
5887 #: ../src/guestfs-actions.pod:710 ../src/guestfs-actions.pod:728
5888 #: ../src/guestfs-actions.pod:747 ../src/guestfs-actions.pod:1307
5889 #: ../src/guestfs-actions.pod:1658 ../src/guestfs-actions.pod:1861
5890 #: ../src/guestfs-actions.pod:1960 ../src/guestfs-actions.pod:2000
5891 #: ../src/guestfs-actions.pod:2055 ../src/guestfs-actions.pod:2078
5892 #: ../src/guestfs-actions.pod:2371 ../src/guestfs-actions.pod:2659
5893 #: ../src/guestfs-actions.pod:2680 ../src/guestfs-actions.pod:4616
5894 #: ../src/guestfs-actions.pod:4753 ../src/guestfs-actions.pod:5159
5895 #: ../src/guestfs-actions.pod:5185 ../src/guestfs-actions.pod:6481
5896 #: ../src/guestfs-actions.pod:6906 ../src/guestfs-actions.pod:6919
5897 #: ../src/guestfs-actions.pod:6932
5898 msgid "On error this function returns -1."
5899 msgstr ""
5900
5901 # type: textblock
5902 #. type: textblock
5903 #: ../src/guestfs-actions.pod:85
5904 msgid "(Added in 1.7.4)"
5905 msgstr ""
5906
5907 # type: =head2
5908 #. type: =head2
5909 #: ../src/guestfs-actions.pod:87
5910 msgid "guestfs_add_domain_va"
5911 msgstr ""
5912
5913 # type: verbatim
5914 #. type: verbatim
5915 #: ../src/guestfs-actions.pod:89
5916 #, no-wrap
5917 msgid ""
5918 " int\n"
5919 " guestfs_add_domain_va (guestfs_h *g,\n"
5920 "                        const char *dom,\n"
5921 "                        va_list args);\n"
5922 "\n"
5923 msgstr ""
5924
5925 # type: textblock
5926 #. type: textblock
5927 #: ../src/guestfs-actions.pod:94
5928 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
5929 msgstr ""
5930
5931 # type: textblock
5932 #. type: textblock
5933 #: ../src/guestfs-actions.pod:96 ../src/guestfs-actions.pod:107
5934 #: ../src/guestfs-actions.pod:200 ../src/guestfs-actions.pod:211
5935 #: ../src/guestfs-actions.pod:4243 ../src/guestfs-actions.pod:4255
5936 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
5937 msgstr ""
5938
5939 # type: =head2
5940 #. type: =head2
5941 #: ../src/guestfs-actions.pod:98
5942 msgid "guestfs_add_domain_argv"
5943 msgstr ""
5944
5945 # type: verbatim
5946 #. type: verbatim
5947 #: ../src/guestfs-actions.pod:100
5948 #, no-wrap
5949 msgid ""
5950 " int\n"
5951 " guestfs_add_domain_argv (guestfs_h *g,\n"
5952 "                          const char *dom,\n"
5953 "                          const struct guestfs_add_domain_argv *optargs);\n"
5954 "\n"
5955 msgstr ""
5956
5957 # type: textblock
5958 #. type: textblock
5959 #: ../src/guestfs-actions.pod:105
5960 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
5961 msgstr ""
5962
5963 # type: =head2
5964 #. type: =head2
5965 #: ../src/guestfs-actions.pod:109
5966 msgid "guestfs_add_drive"
5967 msgstr ""
5968
5969 # type: verbatim
5970 #. type: verbatim
5971 #: ../src/guestfs-actions.pod:111
5972 #, no-wrap
5973 msgid ""
5974 " int\n"
5975 " guestfs_add_drive (guestfs_h *g,\n"
5976 "                    const char *filename);\n"
5977 "\n"
5978 msgstr ""
5979
5980 # type: textblock
5981 #. type: textblock
5982 #: ../src/guestfs-actions.pod:115
5983 msgid ""
5984 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
5985 "optional parameters, so the disk is added writable, with the format being "
5986 "detected automatically."
5987 msgstr ""
5988
5989 # type: textblock
5990 #. type: textblock
5991 #: ../src/guestfs-actions.pod:119
5992 msgid ""
5993 "Automatic detection of the format opens you up to a potential security hole "
5994 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
5995 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
5996 "you should think about replacing calls to this function with calls to "
5997 "C<guestfs_add_drive_opts>, and specifying the format."
5998 msgstr ""
5999
6000 # type: =head2
6001 #. type: =head2
6002 #: ../src/guestfs-actions.pod:130
6003 msgid "guestfs_add_drive_opts"
6004 msgstr ""
6005
6006 # type: verbatim
6007 #. type: verbatim
6008 #: ../src/guestfs-actions.pod:132
6009 #, no-wrap
6010 msgid ""
6011 " int\n"
6012 " guestfs_add_drive_opts (guestfs_h *g,\n"
6013 "                         const char *filename,\n"
6014 "                         ...);\n"
6015 "\n"
6016 msgstr ""
6017
6018 # type: verbatim
6019 #. type: verbatim
6020 #: ../src/guestfs-actions.pod:142
6021 #, no-wrap
6022 msgid ""
6023 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6024 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6025 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6026 "\n"
6027 msgstr ""
6028
6029 # type: textblock
6030 #. type: textblock
6031 #: ../src/guestfs-actions.pod:146 ../fish/guestfish-actions.pod:90
6032 msgid ""
6033 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6034 "The first time you call this function, the disk appears as C</dev/sda>, the "
6035 "second time as C</dev/sdb>, and so on."
6036 msgstr ""
6037
6038 # type: textblock
6039 #. type: textblock
6040 #: ../src/guestfs-actions.pod:151 ../fish/guestfish-actions.pod:95
6041 msgid ""
6042 "You don't necessarily need to be root when using libguestfs.  However you "
6043 "obviously do need sufficient permissions to access the filename for whatever "
6044 "operations you want to perform (ie. read access if you just want to read the "
6045 "image or write access if you want to modify the image)."
6046 msgstr ""
6047
6048 # type: textblock
6049 #. type: textblock
6050 #: ../src/guestfs-actions.pod:157 ../fish/guestfish-actions.pod:101
6051 msgid "This call checks that C<filename> exists."
6052 msgstr ""
6053
6054 # type: textblock
6055 #. type: textblock
6056 #: ../src/guestfs-actions.pod:159 ../src/guestfs-actions.pod:4212
6057 #: ../fish/guestfish-actions.pod:103 ../fish/guestfish-actions.pod:2828
6058 msgid "The optional arguments are:"
6059 msgstr ""
6060
6061 # type: =item
6062 #. type: =item
6063 #: ../src/guestfs-actions.pod:163 ../fish/guestfish-actions.pod:107
6064 msgid "C<readonly>"
6065 msgstr ""
6066
6067 # type: textblock
6068 #. type: textblock
6069 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:109
6070 msgid ""
6071 "If true then the image is treated as read-only.  Writes are still allowed, "
6072 "but they are stored in a temporary snapshot overlay which is discarded at "
6073 "the end.  The disk that you add is not modified."
6074 msgstr ""
6075
6076 # type: =item
6077 #. type: =item
6078 #: ../src/guestfs-actions.pod:169 ../fish/guestfish-actions.pod:113
6079 msgid "C<format>"
6080 msgstr ""
6081
6082 # type: textblock
6083 #. type: textblock
6084 #: ../src/guestfs-actions.pod:171
6085 msgid ""
6086 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6087 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6088 "Possible formats include C<raw> and C<qcow2>."
6089 msgstr ""
6090
6091 # type: textblock
6092 #. type: textblock
6093 #: ../src/guestfs-actions.pod:175 ../fish/guestfish-actions.pod:119
6094 msgid ""
6095 "Automatic detection of the format opens you up to a potential security hole "
6096 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6097 "RHBZ#642934.  Specifying the format closes this security hole."
6098 msgstr ""
6099
6100 # type: =item
6101 #. type: =item
6102 #: ../src/guestfs-actions.pod:180 ../fish/guestfish-actions.pod:124
6103 msgid "C<iface>"
6104 msgstr ""
6105
6106 # type: textblock
6107 #. type: textblock
6108 #: ../src/guestfs-actions.pod:182
6109 msgid ""
6110 "This rarely-used option lets you emulate the behaviour of the deprecated "
6111 "C<guestfs_add_drive_with_if> call (q.v.)"
6112 msgstr ""
6113
6114 # type: textblock
6115 #. type: textblock
6116 #: ../src/guestfs-actions.pod:189
6117 msgid "(Added in 1.5.23)"
6118 msgstr ""
6119
6120 # type: =head2
6121 #. type: =head2
6122 #: ../src/guestfs-actions.pod:191
6123 msgid "guestfs_add_drive_opts_va"
6124 msgstr ""
6125
6126 # type: verbatim
6127 #. type: verbatim
6128 #: ../src/guestfs-actions.pod:193
6129 #, no-wrap
6130 msgid ""
6131 " int\n"
6132 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6133 "                            const char *filename,\n"
6134 "                            va_list args);\n"
6135 "\n"
6136 msgstr ""
6137
6138 # type: textblock
6139 #. type: textblock
6140 #: ../src/guestfs-actions.pod:198
6141 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6142 msgstr ""
6143
6144 # type: =head2
6145 #. type: =head2
6146 #: ../src/guestfs-actions.pod:202
6147 msgid "guestfs_add_drive_opts_argv"
6148 msgstr ""
6149
6150 # type: verbatim
6151 #. type: verbatim
6152 #: ../src/guestfs-actions.pod:204
6153 #, no-wrap
6154 msgid ""
6155 " int\n"
6156 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6157 "                              const char *filename,\n"
6158 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6159 "\n"
6160 msgstr ""
6161
6162 # type: textblock
6163 #. type: textblock
6164 #: ../src/guestfs-actions.pod:209
6165 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6166 msgstr ""
6167
6168 # type: =head2
6169 #. type: =head2
6170 #: ../src/guestfs-actions.pod:213
6171 msgid "guestfs_add_drive_ro"
6172 msgstr ""
6173
6174 # type: verbatim
6175 #. type: verbatim
6176 #: ../src/guestfs-actions.pod:215
6177 #, no-wrap
6178 msgid ""
6179 " int\n"
6180 " guestfs_add_drive_ro (guestfs_h *g,\n"
6181 "                       const char *filename);\n"
6182 "\n"
6183 msgstr ""
6184
6185 # type: textblock
6186 #. type: textblock
6187 #: ../src/guestfs-actions.pod:219
6188 msgid ""
6189 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6190 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6191 "disk is added read-only, with the format being detected automatically."
6192 msgstr ""
6193
6194 # type: textblock
6195 #. type: textblock
6196 #: ../src/guestfs-actions.pod:226
6197 msgid "(Added in 1.0.38)"
6198 msgstr ""
6199
6200 # type: =head2
6201 #. type: =head2
6202 #: ../src/guestfs-actions.pod:228
6203 msgid "guestfs_add_drive_ro_with_if"
6204 msgstr ""
6205
6206 # type: verbatim
6207 #. type: verbatim
6208 #: ../src/guestfs-actions.pod:230
6209 #, no-wrap
6210 msgid ""
6211 " int\n"
6212 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6213 "                               const char *filename,\n"
6214 "                               const char *iface);\n"
6215 "\n"
6216 msgstr ""
6217
6218 # type: textblock
6219 #. type: textblock
6220 #: ../src/guestfs-actions.pod:235
6221 msgid ""
6222 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6223 "QEMU interface emulation to use at run time."
6224 msgstr ""
6225
6226 # type: textblock
6227 #. type: textblock
6228 #: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:268
6229 #: ../src/guestfs-actions.pod:2330
6230 msgid "(Added in 1.0.84)"
6231 msgstr ""
6232
6233 # type: =head2
6234 #. type: =head2
6235 #: ../src/guestfs-actions.pod:249
6236 msgid "guestfs_add_drive_with_if"
6237 msgstr ""
6238
6239 # type: verbatim
6240 #. type: verbatim
6241 #: ../src/guestfs-actions.pod:251
6242 #, no-wrap
6243 msgid ""
6244 " int\n"
6245 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6246 "                            const char *filename,\n"
6247 "                            const char *iface);\n"
6248 "\n"
6249 msgstr ""
6250
6251 # type: textblock
6252 #. type: textblock
6253 #: ../src/guestfs-actions.pod:256
6254 msgid ""
6255 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
6256 "QEMU interface emulation to use at run time."
6257 msgstr ""
6258
6259 # type: =head2
6260 #. type: =head2
6261 #: ../src/guestfs-actions.pod:270
6262 msgid "guestfs_aug_clear"
6263 msgstr ""
6264
6265 # type: verbatim
6266 #. type: verbatim
6267 #: ../src/guestfs-actions.pod:272
6268 #, no-wrap
6269 msgid ""
6270 " int\n"
6271 " guestfs_aug_clear (guestfs_h *g,\n"
6272 "                    const char *augpath);\n"
6273 "\n"
6274 msgstr ""
6275
6276 # type: textblock
6277 #. type: textblock
6278 #: ../src/guestfs-actions.pod:276 ../fish/guestfish-actions.pod:176
6279 msgid ""
6280 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
6281 "L<augtool(1)> C<clear> command."
6282 msgstr ""
6283
6284 # type: textblock
6285 #. type: textblock
6286 #: ../src/guestfs-actions.pod:281 ../src/guestfs-actions.pod:2080
6287 msgid "(Added in 1.3.4)"
6288 msgstr ""
6289
6290 # type: =head2
6291 #. type: =head2
6292 #: ../src/guestfs-actions.pod:283
6293 msgid "guestfs_aug_close"
6294 msgstr ""
6295
6296 # type: verbatim
6297 #. type: verbatim
6298 #: ../src/guestfs-actions.pod:285
6299 #, no-wrap
6300 msgid ""
6301 " int\n"
6302 " guestfs_aug_close (guestfs_h *g);\n"
6303 "\n"
6304 msgstr ""
6305
6306 # type: textblock
6307 #. type: textblock
6308 #: ../src/guestfs-actions.pod:288
6309 msgid ""
6310 "Close the current Augeas handle and free up any resources used by it.  After "
6311 "calling this, you have to call C<guestfs_aug_init> again before you can use "
6312 "any other Augeas functions."
6313 msgstr ""
6314
6315 # type: textblock
6316 #. type: textblock
6317 #: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:320
6318 #: ../src/guestfs-actions.pod:338 ../src/guestfs-actions.pod:352
6319 #: ../src/guestfs-actions.pod:410 ../src/guestfs-actions.pod:430
6320 #: ../src/guestfs-actions.pod:444 ../src/guestfs-actions.pod:475
6321 #: ../src/guestfs-actions.pod:489 ../src/guestfs-actions.pod:503
6322 #: ../src/guestfs-actions.pod:517 ../src/guestfs-actions.pod:535
6323 #: ../src/guestfs-actions.pod:5236
6324 msgid "(Added in 0.7)"
6325 msgstr ""
6326
6327 # type: =head2
6328 #. type: =head2
6329 #: ../src/guestfs-actions.pod:297
6330 msgid "guestfs_aug_defnode"
6331 msgstr ""
6332
6333 # type: verbatim
6334 #. type: verbatim
6335 #: ../src/guestfs-actions.pod:299
6336 #, no-wrap
6337 msgid ""
6338 " struct guestfs_int_bool *\n"
6339 " guestfs_aug_defnode (guestfs_h *g,\n"
6340 "                      const char *name,\n"
6341 "                      const char *expr,\n"
6342 "                      const char *val);\n"
6343 "\n"
6344 msgstr ""
6345
6346 # type: textblock
6347 #. type: textblock
6348 #: ../src/guestfs-actions.pod:305 ../fish/guestfish-actions.pod:192
6349 msgid ""
6350 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
6351 msgstr ""
6352
6353 # type: textblock
6354 #. type: textblock
6355 #: ../src/guestfs-actions.pod:308
6356 msgid ""
6357 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
6358 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
6359 "containing that single node."
6360 msgstr ""
6361
6362 # type: textblock
6363 #. type: textblock
6364 #: ../src/guestfs-actions.pod:312 ../fish/guestfish-actions.pod:199
6365 msgid ""
6366 "On success this returns a pair containing the number of nodes in the "
6367 "nodeset, and a boolean flag if a node was created."
6368 msgstr ""
6369
6370 # type: textblock
6371 #. type: textblock
6372 #: ../src/guestfs-actions.pod:316
6373 msgid ""
6374 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
6375 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
6376 msgstr ""
6377
6378 # type: =head2
6379 #. type: =head2
6380 #: ../src/guestfs-actions.pod:322
6381 msgid "guestfs_aug_defvar"
6382 msgstr ""
6383
6384 # type: verbatim
6385 #. type: verbatim
6386 #: ../src/guestfs-actions.pod:324
6387 #, no-wrap
6388 msgid ""
6389 " int\n"
6390 " guestfs_aug_defvar (guestfs_h *g,\n"
6391 "                     const char *name,\n"
6392 "                     const char *expr);\n"
6393 "\n"
6394 msgstr ""
6395
6396 # type: textblock
6397 #. type: textblock
6398 #: ../src/guestfs-actions.pod:329 ../fish/guestfish-actions.pod:207
6399 msgid ""
6400 "Defines an Augeas variable C<name> whose value is the result of evaluating "
6401 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
6402 msgstr ""
6403
6404 # type: textblock
6405 #. type: textblock
6406 #: ../src/guestfs-actions.pod:333 ../fish/guestfish-actions.pod:211
6407 msgid ""
6408 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
6409 "evaluates to something which is not a nodeset."
6410 msgstr ""
6411
6412 # type: =head2
6413 #. type: =head2
6414 #: ../src/guestfs-actions.pod:340
6415 msgid "guestfs_aug_get"
6416 msgstr ""
6417
6418 # type: verbatim
6419 #. type: verbatim
6420 #: ../src/guestfs-actions.pod:342
6421 #, no-wrap
6422 msgid ""
6423 " char *\n"
6424 " guestfs_aug_get (guestfs_h *g,\n"
6425 "                  const char *augpath);\n"
6426 "\n"
6427 msgstr ""
6428
6429 # type: textblock
6430 #. type: textblock
6431 #: ../src/guestfs-actions.pod:346 ../fish/guestfish-actions.pod:218
6432 msgid ""
6433 "Look up the value associated with C<path>.  If C<path> matches exactly one "
6434 "node, the C<value> is returned."
6435 msgstr ""
6436
6437 # type: textblock
6438 #. type: textblock
6439 #: ../src/guestfs-actions.pod:349 ../src/guestfs-actions.pod:849
6440 #: ../src/guestfs-actions.pod:867 ../src/guestfs-actions.pod:927
6441 #: ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1046
6442 #: ../src/guestfs-actions.pod:1176 ../src/guestfs-actions.pod:1193
6443 #: ../src/guestfs-actions.pod:1212 ../src/guestfs-actions.pod:1341
6444 #: ../src/guestfs-actions.pod:1529 ../src/guestfs-actions.pod:1641
6445 #: ../src/guestfs-actions.pod:1804 ../src/guestfs-actions.pod:1821
6446 #: ../src/guestfs-actions.pod:1912 ../src/guestfs-actions.pod:1933
6447 #: ../src/guestfs-actions.pod:2103 ../src/guestfs-actions.pod:2295
6448 #: ../src/guestfs-actions.pod:2502 ../src/guestfs-actions.pod:2583
6449 #: ../src/guestfs-actions.pod:2631 ../src/guestfs-actions.pod:2745
6450 #: ../src/guestfs-actions.pod:2776 ../src/guestfs-actions.pod:2800
6451 #: ../src/guestfs-actions.pod:2862 ../src/guestfs-actions.pod:2885
6452 #: ../src/guestfs-actions.pod:3399 ../src/guestfs-actions.pod:3749
6453 #: ../src/guestfs-actions.pod:3919 ../src/guestfs-actions.pod:4029
6454 #: ../src/guestfs-actions.pod:4771 ../src/guestfs-actions.pod:4964
6455 #: ../src/guestfs-actions.pod:5134 ../src/guestfs-actions.pod:5312
6456 #: ../src/guestfs-actions.pod:5361 ../src/guestfs-actions.pod:5924
6457 #: ../src/guestfs-actions.pod:5940 ../src/guestfs-actions.pod:5957
6458 #: ../src/guestfs-actions.pod:5981 ../src/guestfs-actions.pod:6655
6459 #: ../src/guestfs-actions.pod:6674 ../src/guestfs-actions.pod:6692
6460 #: ../src/guestfs-actions.pod:6872 ../src/guestfs-actions.pod:7144
6461 msgid ""
6462 "This function returns a string, or NULL on error.  I<The caller must free "
6463 "the returned string after use>."
6464 msgstr ""
6465
6466 # type: =head2
6467 #. type: =head2
6468 #: ../src/guestfs-actions.pod:354
6469 msgid "guestfs_aug_init"
6470 msgstr ""
6471
6472 # type: verbatim
6473 #. type: verbatim
6474 #: ../src/guestfs-actions.pod:356
6475 #, no-wrap
6476 msgid ""
6477 " int\n"
6478 " guestfs_aug_init (guestfs_h *g,\n"
6479 "                   const char *root,\n"
6480 "                   int flags);\n"
6481 "\n"
6482 msgstr ""
6483
6484 # type: textblock
6485 #. type: textblock
6486 #: ../src/guestfs-actions.pod:361 ../fish/guestfish-actions.pod:225
6487 msgid ""
6488 "Create a new Augeas handle for editing configuration files.  If there was "
6489 "any previous Augeas handle associated with this guestfs session, then it is "
6490 "closed."
6491 msgstr ""
6492
6493 # type: textblock
6494 #. type: textblock
6495 #: ../src/guestfs-actions.pod:365
6496 msgid "You must call this before using any other C<guestfs_aug_*> commands."
6497 msgstr ""
6498
6499 # type: textblock
6500 #. type: textblock
6501 #: ../src/guestfs-actions.pod:368 ../fish/guestfish-actions.pod:232
6502 msgid ""
6503 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
6504 msgstr ""
6505
6506 # type: textblock
6507 #. type: textblock
6508 #: ../src/guestfs-actions.pod:371 ../fish/guestfish-actions.pod:235
6509 msgid ""
6510 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
6511 "logical I<or> of the following integers:"
6512 msgstr ""
6513
6514 # type: =item
6515 #. type: =item
6516 #: ../src/guestfs-actions.pod:377 ../fish/guestfish-actions.pod:241
6517 msgid "C<AUG_SAVE_BACKUP> = 1"
6518 msgstr ""
6519
6520 # type: textblock
6521 #. type: textblock
6522 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:243
6523 msgid "Keep the original file with a C<.augsave> extension."
6524 msgstr ""
6525
6526 # type: =item
6527 #. type: =item
6528 #: ../src/guestfs-actions.pod:381 ../fish/guestfish-actions.pod:245
6529 msgid "C<AUG_SAVE_NEWFILE> = 2"
6530 msgstr ""
6531
6532 # type: textblock
6533 #. type: textblock
6534 #: ../src/guestfs-actions.pod:383 ../fish/guestfish-actions.pod:247
6535 msgid ""
6536 "Save changes into a file with extension C<.augnew>, and do not overwrite "
6537 "original.  Overrides C<AUG_SAVE_BACKUP>."
6538 msgstr ""
6539
6540 # type: =item
6541 #. type: =item
6542 #: ../src/guestfs-actions.pod:386 ../fish/guestfish-actions.pod:250
6543 msgid "C<AUG_TYPE_CHECK> = 4"
6544 msgstr ""
6545
6546 # type: textblock
6547 #. type: textblock
6548 #: ../src/guestfs-actions.pod:388 ../fish/guestfish-actions.pod:252
6549 msgid "Typecheck lenses (can be expensive)."
6550 msgstr ""
6551
6552 # type: =item
6553 #. type: =item
6554 #: ../src/guestfs-actions.pod:390 ../fish/guestfish-actions.pod:254
6555 msgid "C<AUG_NO_STDINC> = 8"
6556 msgstr ""
6557
6558 # type: textblock
6559 #. type: textblock
6560 #: ../src/guestfs-actions.pod:392 ../fish/guestfish-actions.pod:256
6561 msgid "Do not use standard load path for modules."
6562 msgstr ""
6563
6564 # type: =item
6565 #. type: =item
6566 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:258
6567 msgid "C<AUG_SAVE_NOOP> = 16"
6568 msgstr ""
6569
6570 # type: textblock
6571 #. type: textblock
6572 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:260
6573 msgid "Make save a no-op, just record what would have been changed."
6574 msgstr ""
6575
6576 # type: =item
6577 #. type: =item
6578 #: ../src/guestfs-actions.pod:398 ../fish/guestfish-actions.pod:262
6579 msgid "C<AUG_NO_LOAD> = 32"
6580 msgstr ""
6581
6582 # type: textblock
6583 #. type: textblock
6584 #: ../src/guestfs-actions.pod:400
6585 msgid "Do not load the tree in C<guestfs_aug_init>."
6586 msgstr ""
6587
6588 # type: textblock
6589 #. type: textblock
6590 #: ../src/guestfs-actions.pod:404
6591 msgid "To close the handle, you can call C<guestfs_aug_close>."
6592 msgstr ""
6593
6594 # type: textblock
6595 #. type: textblock
6596 #: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:270
6597 msgid "To find out more about Augeas, see L<http://augeas.net/>."
6598 msgstr ""
6599
6600 # type: =head2
6601 #. type: =head2
6602 #: ../src/guestfs-actions.pod:412
6603 msgid "guestfs_aug_insert"
6604 msgstr ""
6605
6606 # type: verbatim
6607 #. type: verbatim
6608 #: ../src/guestfs-actions.pod:414
6609 #, no-wrap
6610 msgid ""
6611 " int\n"
6612 " guestfs_aug_insert (guestfs_h *g,\n"
6613 "                     const char *augpath,\n"
6614 "                     const char *label,\n"
6615 "                     int before);\n"
6616 "\n"
6617 msgstr ""
6618
6619 # type: textblock
6620 #. type: textblock
6621 #: ../src/guestfs-actions.pod:420 ../fish/guestfish-actions.pod:276
6622 msgid ""
6623 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
6624 "or after C<path> (depending on the boolean flag C<before>)."
6625 msgstr ""
6626
6627 # type: textblock
6628 #. type: textblock
6629 #: ../src/guestfs-actions.pod:424 ../fish/guestfish-actions.pod:280
6630 msgid ""
6631 "C<path> must match exactly one existing node in the tree, and C<label> must "
6632 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
6633 msgstr ""
6634
6635 # type: =head2
6636 #. type: =head2
6637 #: ../src/guestfs-actions.pod:432
6638 msgid "guestfs_aug_load"
6639 msgstr ""
6640
6641 # type: verbatim
6642 #. type: verbatim
6643 #: ../src/guestfs-actions.pod:434
6644 #, no-wrap
6645 msgid ""
6646 " int\n"
6647 " guestfs_aug_load (guestfs_h *g);\n"
6648 "\n"
6649 msgstr ""
6650
6651 # type: textblock
6652 #. type: textblock
6653 #: ../src/guestfs-actions.pod:437 ../fish/guestfish-actions.pod:288
6654 msgid "Load files into the tree."
6655 msgstr ""
6656
6657 # type: textblock
6658 #. type: textblock
6659 #: ../src/guestfs-actions.pod:439 ../fish/guestfish-actions.pod:290
6660 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
6661 msgstr ""
6662
6663 # type: =head2
6664 #. type: =head2
6665 #: ../src/guestfs-actions.pod:446
6666 msgid "guestfs_aug_ls"
6667 msgstr ""
6668
6669 # type: verbatim
6670 #. type: verbatim
6671 #: ../src/guestfs-actions.pod:448
6672 #, no-wrap
6673 msgid ""
6674 " char **\n"
6675 " guestfs_aug_ls (guestfs_h *g,\n"
6676 "                 const char *augpath);\n"
6677 "\n"
6678 msgstr ""
6679
6680 # type: textblock
6681 #. type: textblock
6682 #: ../src/guestfs-actions.pod:452
6683 msgid ""
6684 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
6685 "sorting the resulting nodes into alphabetical order."
6686 msgstr ""
6687
6688 # type: textblock
6689 #. type: textblock
6690 #: ../src/guestfs-actions.pod:455 ../src/guestfs-actions.pod:471
6691 #: ../src/guestfs-actions.pod:617 ../src/guestfs-actions.pod:1065
6692 #: ../src/guestfs-actions.pod:1356 ../src/guestfs-actions.pod:1375
6693 #: ../src/guestfs-actions.pod:1478 ../src/guestfs-actions.pod:1497
6694 #: ../src/guestfs-actions.pod:1743 ../src/guestfs-actions.pod:2175
6695 #: ../src/guestfs-actions.pod:2191 ../src/guestfs-actions.pod:2210
6696 #: ../src/guestfs-actions.pod:2253 ../src/guestfs-actions.pod:2277
6697 #: ../src/guestfs-actions.pod:2348 ../src/guestfs-actions.pod:2397
6698 #: ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2819
6699 #: ../src/guestfs-actions.pod:3034 ../src/guestfs-actions.pod:3319
6700 #: ../src/guestfs-actions.pod:3381 ../src/guestfs-actions.pod:3486
6701 #: ../src/guestfs-actions.pod:3891 ../src/guestfs-actions.pod:4577
6702 #: ../src/guestfs-actions.pod:5106 ../src/guestfs-actions.pod:5232
6703 #: ../src/guestfs-actions.pod:5346 ../src/guestfs-actions.pod:5997
6704 #: ../src/guestfs-actions.pod:6058 ../src/guestfs-actions.pod:6113
6705 #: ../src/guestfs-actions.pod:6259 ../src/guestfs-actions.pod:6283
6706 #: ../src/guestfs-actions.pod:6765 ../src/guestfs-actions.pod:6785
6707 #: ../src/guestfs-actions.pod:6832 ../src/guestfs-actions.pod:6997
6708 #: ../src/guestfs-actions.pod:7016 ../src/guestfs-actions.pod:7101
6709 #: ../src/guestfs-actions.pod:7120 ../src/guestfs-actions.pod:7166
6710 #: ../src/guestfs-actions.pod:7185
6711 msgid ""
6712 "This function returns a NULL-terminated array of strings (like L<environ(3)"
6713 ">), or NULL if there was an error.  I<The caller must free the strings and "
6714 "the array after use>."
6715 msgstr ""
6716
6717 # type: textblock
6718 #. type: textblock
6719 #: ../src/guestfs-actions.pod:459 ../src/guestfs-actions.pod:990
6720 #: ../src/guestfs-actions.pod:1008 ../src/guestfs-actions.pod:1413
6721 #: ../src/guestfs-actions.pod:3112 ../src/guestfs-actions.pod:3143
6722 #: ../src/guestfs-actions.pod:3732 ../src/guestfs-actions.pod:3782
6723 #: ../src/guestfs-actions.pod:3969 ../src/guestfs-actions.pod:4002
6724 #: ../src/guestfs-actions.pod:4165 ../src/guestfs-actions.pod:4581
6725 #: ../src/guestfs-actions.pod:5047 ../src/guestfs-actions.pod:5425
6726 #: ../src/guestfs-actions.pod:5439 ../src/guestfs-actions.pod:5451
6727 #: ../src/guestfs-actions.pod:5859 ../src/guestfs-actions.pod:6497
6728 #: ../src/guestfs-actions.pod:6510 ../src/guestfs-actions.pod:6749
6729 #: ../src/guestfs-actions.pod:6985
6730 msgid "(Added in 0.8)"
6731 msgstr ""
6732
6733 # type: =head2
6734 #. type: =head2
6735 #: ../src/guestfs-actions.pod:461
6736 msgid "guestfs_aug_match"
6737 msgstr ""
6738
6739 # type: verbatim
6740 #. type: verbatim
6741 #: ../src/guestfs-actions.pod:463
6742 #, no-wrap
6743 msgid ""
6744 " char **\n"
6745 " guestfs_aug_match (guestfs_h *g,\n"
6746 "                    const char *augpath);\n"
6747 "\n"
6748 msgstr ""
6749
6750 # type: textblock
6751 #. type: textblock
6752 #: ../src/guestfs-actions.pod:467 ../fish/guestfish-actions.pod:304
6753 msgid ""
6754 "Returns a list of paths which match the path expression C<path>.  The "
6755 "returned paths are sufficiently qualified so that they match exactly one "
6756 "node in the current tree."
6757 msgstr ""
6758
6759 # type: =head2
6760 #. type: =head2
6761 #: ../src/guestfs-actions.pod:477
6762 msgid "guestfs_aug_mv"
6763 msgstr ""
6764
6765 # type: verbatim
6766 #. type: verbatim
6767 #: ../src/guestfs-actions.pod:479
6768 #, no-wrap
6769 msgid ""
6770 " int\n"
6771 " guestfs_aug_mv (guestfs_h *g,\n"
6772 "                 const char *src,\n"
6773 "                 const char *dest);\n"
6774 "\n"
6775 msgstr ""
6776
6777 # type: textblock
6778 #. type: textblock
6779 #: ../src/guestfs-actions.pod:484 ../fish/guestfish-actions.pod:312
6780 msgid ""
6781 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
6782 "C<dest> is overwritten if it exists."
6783 msgstr ""
6784
6785 # type: =head2
6786 #. type: =head2
6787 #: ../src/guestfs-actions.pod:491
6788 msgid "guestfs_aug_rm"
6789 msgstr ""
6790
6791 # type: verbatim
6792 #. type: verbatim
6793 #: ../src/guestfs-actions.pod:493
6794 #, no-wrap
6795 msgid ""
6796 " int\n"
6797 " guestfs_aug_rm (guestfs_h *g,\n"
6798 "                 const char *augpath);\n"
6799 "\n"
6800 msgstr ""
6801
6802 # type: textblock
6803 #. type: textblock
6804 #: ../src/guestfs-actions.pod:497 ../fish/guestfish-actions.pod:319
6805 msgid "Remove C<path> and all of its children."
6806 msgstr ""
6807
6808 # type: textblock
6809 #. type: textblock
6810 #: ../src/guestfs-actions.pod:499 ../fish/guestfish-actions.pod:321
6811 msgid "On success this returns the number of entries which were removed."
6812 msgstr ""
6813
6814 # type: =head2
6815 #. type: =head2
6816 #: ../src/guestfs-actions.pod:505
6817 msgid "guestfs_aug_save"
6818 msgstr ""
6819
6820 # type: verbatim
6821 #. type: verbatim
6822 #: ../src/guestfs-actions.pod:507
6823 #, no-wrap
6824 msgid ""
6825 " int\n"
6826 " guestfs_aug_save (guestfs_h *g);\n"
6827 "\n"
6828 msgstr ""
6829
6830 # type: textblock
6831 #. type: textblock
6832 #: ../src/guestfs-actions.pod:510 ../fish/guestfish-actions.pod:327
6833 msgid "This writes all pending changes to disk."
6834 msgstr ""
6835
6836 # type: textblock
6837 #. type: textblock
6838 #: ../src/guestfs-actions.pod:512
6839 msgid ""
6840 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
6841 "are saved."
6842 msgstr ""
6843
6844 # type: =head2
6845 #. type: =head2
6846 #: ../src/guestfs-actions.pod:519
6847 msgid "guestfs_aug_set"
6848 msgstr ""
6849
6850 # type: verbatim
6851 #. type: verbatim
6852 #: ../src/guestfs-actions.pod:521
6853 #, no-wrap
6854 msgid ""
6855 " int\n"
6856 " guestfs_aug_set (guestfs_h *g,\n"
6857 "                  const char *augpath,\n"
6858 "                  const char *val);\n"
6859 "\n"
6860 msgstr ""
6861
6862 # type: textblock
6863 #. type: textblock
6864 #: ../src/guestfs-actions.pod:526 ../fish/guestfish-actions.pod:336
6865 msgid "Set the value associated with C<path> to C<val>."
6866 msgstr ""
6867
6868 # type: textblock
6869 #. type: textblock
6870 #: ../src/guestfs-actions.pod:528
6871 msgid ""
6872 "In the Augeas API, it is possible to clear a node by setting the value to "
6873 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
6874 "this call.  Instead you must use the C<guestfs_aug_clear> call."
6875 msgstr ""
6876
6877 # type: =head2
6878 #. type: =head2
6879 #: ../src/guestfs-actions.pod:537
6880 msgid "guestfs_available"
6881 msgstr ""
6882
6883 # type: verbatim
6884 #. type: verbatim
6885 #: ../src/guestfs-actions.pod:539
6886 #, no-wrap
6887 msgid ""
6888 " int\n"
6889 " guestfs_available (guestfs_h *g,\n"
6890 "                    char *const *groups);\n"
6891 "\n"
6892 msgstr ""
6893
6894 # type: textblock
6895 #. type: textblock
6896 #: ../src/guestfs-actions.pod:543 ../fish/guestfish-actions.pod:347
6897 msgid ""
6898 "This command is used to check the availability of some groups of "
6899 "functionality in the appliance, which not all builds of the libguestfs "
6900 "appliance will be able to provide."
6901 msgstr ""
6902
6903 # type: textblock
6904 #. type: textblock
6905 #: ../src/guestfs-actions.pod:547
6906 msgid ""
6907 "The libguestfs groups, and the functions that those groups correspond to, "
6908 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
6909 "runtime by calling C<guestfs_available_all_groups>."
6910 msgstr ""
6911
6912 # type: textblock
6913 #. type: textblock
6914 #: ../src/guestfs-actions.pod:552 ../fish/guestfish-actions.pod:356
6915 msgid ""
6916 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
6917 "\"]> would check for the availability of the Linux inotify functions and "
6918 "Augeas (configuration file editing) functions."
6919 msgstr ""
6920
6921 # type: textblock
6922 #. type: textblock
6923 #: ../src/guestfs-actions.pod:557 ../fish/guestfish-actions.pod:361
6924 msgid "The command returns no error if I<all> requested groups are available."
6925 msgstr ""
6926
6927 # type: textblock
6928 #. type: textblock
6929 #: ../src/guestfs-actions.pod:559 ../fish/guestfish-actions.pod:363
6930 msgid ""
6931 "It fails with an error if one or more of the requested groups is unavailable "
6932 "in the appliance."
6933 msgstr ""
6934
6935 # type: textblock
6936 #. type: textblock
6937 #: ../src/guestfs-actions.pod:562 ../fish/guestfish-actions.pod:366
6938 msgid ""
6939 "If an unknown group name is included in the list of groups then an error is "
6940 "always returned."
6941 msgstr ""
6942
6943 # type: textblock
6944 #. type: textblock
6945 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:369
6946 msgid "I<Notes:>"
6947 msgstr ""
6948
6949 # type: textblock
6950 #. type: textblock
6951 #: ../src/guestfs-actions.pod:571
6952 msgid "You must call C<guestfs_launch> before calling this function."
6953 msgstr ""
6954
6955 # type: textblock
6956 #. type: textblock
6957 #: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:377
6958 msgid ""
6959 "The reason is because we don't know what groups are supported by the "
6960 "appliance/daemon until it is running and can be queried."
6961 msgstr ""
6962
6963 # type: textblock
6964 #. type: textblock
6965 #: ../src/guestfs-actions.pod:579 ../fish/guestfish-actions.pod:383
6966 msgid ""
6967 "If a group of functions is available, this does not necessarily mean that "
6968 "they will work.  You still have to check for errors when calling individual "
6969 "API functions even if they are available."
6970 msgstr ""
6971
6972 # type: textblock
6973 #. type: textblock
6974 #: ../src/guestfs-actions.pod:586 ../fish/guestfish-actions.pod:390
6975 msgid ""
6976 "It is usually the job of distro packagers to build complete functionality "
6977 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
6978 "with all requirements satisfied, will support everything."
6979 msgstr ""
6980
6981 # type: textblock
6982 #. type: textblock
6983 #: ../src/guestfs-actions.pod:593
6984 msgid ""
6985 "This call was added in version C<1.0.80>.  In previous versions of "
6986 "libguestfs all you could do would be to speculatively execute a command to "
6987 "find out if the daemon implemented it.  See also C<guestfs_version>."
6988 msgstr ""
6989
6990 # type: textblock
6991 #. type: textblock
6992 #: ../src/guestfs-actions.pod:602 ../src/guestfs-actions.pod:1163
6993 msgid "(Added in 1.0.80)"
6994 msgstr ""
6995
6996 # type: =head2
6997 #. type: =head2
6998 #: ../src/guestfs-actions.pod:604
6999 msgid "guestfs_available_all_groups"
7000 msgstr ""
7001
7002 # type: verbatim
7003 #. type: verbatim
7004 #: ../src/guestfs-actions.pod:606
7005 #, no-wrap
7006 msgid ""
7007 " char **\n"
7008 " guestfs_available_all_groups (guestfs_h *g);\n"
7009 "\n"
7010 msgstr ""
7011
7012 # type: textblock
7013 #. type: textblock
7014 #: ../src/guestfs-actions.pod:609
7015 msgid ""
7016 "This command returns a list of all optional groups that this daemon knows "
7017 "about.  Note this returns both supported and unsupported groups.  To find "
7018 "out which ones the daemon can actually support you have to call "
7019 "C<guestfs_available> on each member of the returned list."
7020 msgstr ""
7021
7022 # type: textblock
7023 #. type: textblock
7024 #: ../src/guestfs-actions.pod:615
7025 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7026 msgstr ""
7027
7028 # type: textblock
7029 #. type: textblock
7030 #: ../src/guestfs-actions.pod:621
7031 msgid "(Added in 1.3.15)"
7032 msgstr ""
7033
7034 # type: =head2
7035 #. type: =head2
7036 #: ../src/guestfs-actions.pod:623
7037 msgid "guestfs_base64_in"
7038 msgstr ""
7039
7040 # type: verbatim
7041 #. type: verbatim
7042 #: ../src/guestfs-actions.pod:625
7043 #, no-wrap
7044 msgid ""
7045 " int\n"
7046 " guestfs_base64_in (guestfs_h *g,\n"
7047 "                    const char *base64file,\n"
7048 "                    const char *filename);\n"
7049 "\n"
7050 msgstr ""
7051
7052 # type: textblock
7053 #. type: textblock
7054 #: ../src/guestfs-actions.pod:630 ../fish/guestfish-actions.pod:420
7055 msgid ""
7056 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7057 msgstr ""
7058
7059 # type: textblock
7060 #. type: textblock
7061 #: ../src/guestfs-actions.pod:635 ../src/guestfs-actions.pod:649
7062 msgid "(Added in 1.3.5)"
7063 msgstr ""
7064
7065 # type: =head2
7066 #. type: =head2
7067 #: ../src/guestfs-actions.pod:637
7068 msgid "guestfs_base64_out"
7069 msgstr ""
7070
7071 # type: verbatim
7072 #. type: verbatim
7073 #: ../src/guestfs-actions.pod:639
7074 #, no-wrap
7075 msgid ""
7076 " int\n"
7077 " guestfs_base64_out (guestfs_h *g,\n"
7078 "                     const char *filename,\n"
7079 "                     const char *base64file);\n"
7080 "\n"
7081 msgstr ""
7082
7083 # type: textblock
7084 #. type: textblock
7085 #: ../src/guestfs-actions.pod:644 ../fish/guestfish-actions.pod:429
7086 msgid ""
7087 "This command downloads the contents of C<filename>, writing it out to local "
7088 "file C<base64file> encoded as base64."
7089 msgstr ""
7090
7091 # type: =head2
7092 #. type: =head2
7093 #: ../src/guestfs-actions.pod:651
7094 msgid "guestfs_blockdev_flushbufs"
7095 msgstr ""
7096
7097 # type: verbatim
7098 #. type: verbatim
7099 #: ../src/guestfs-actions.pod:653
7100 #, no-wrap
7101 msgid ""
7102 " int\n"
7103 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7104 "                             const char *device);\n"
7105 "\n"
7106 msgstr ""
7107
7108 # type: textblock
7109 #. type: textblock
7110 #: ../src/guestfs-actions.pod:657 ../fish/guestfish-actions.pod:438
7111 msgid ""
7112 "This tells the kernel to flush internal buffers associated with C<device>."
7113 msgstr ""
7114
7115 # type: textblock
7116 #. type: textblock
7117 #: ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:677
7118 #: ../src/guestfs-actions.pod:692 ../src/guestfs-actions.pod:708
7119 #: ../src/guestfs-actions.pod:726 ../src/guestfs-actions.pod:745
7120 #: ../src/guestfs-actions.pod:759 ../src/guestfs-actions.pod:777
7121 #: ../src/guestfs-actions.pod:791 ../src/guestfs-actions.pod:805
7122 #: ../fish/guestfish-actions.pod:441 ../fish/guestfish-actions.pod:452
7123 #: ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:471
7124 #: ../fish/guestfish-actions.pod:483 ../fish/guestfish-actions.pod:496
7125 #: ../fish/guestfish-actions.pod:504 ../fish/guestfish-actions.pod:515
7126 #: ../fish/guestfish-actions.pod:523 ../fish/guestfish-actions.pod:531
7127 msgid "This uses the L<blockdev(8)> command."
7128 msgstr ""
7129
7130 # type: textblock
7131 #. type: textblock
7132 #: ../src/guestfs-actions.pod:664 ../src/guestfs-actions.pod:681
7133 #: ../src/guestfs-actions.pod:696 ../src/guestfs-actions.pod:712
7134 #: ../src/guestfs-actions.pod:730 ../src/guestfs-actions.pod:749
7135 #: ../src/guestfs-actions.pod:763 ../src/guestfs-actions.pod:781
7136 #: ../src/guestfs-actions.pod:795 ../src/guestfs-actions.pod:809
7137 msgid "(Added in 0.9.3)"
7138 msgstr ""
7139
7140 # type: =head2
7141 #. type: =head2
7142 #: ../src/guestfs-actions.pod:666
7143 msgid "guestfs_blockdev_getbsz"
7144 msgstr ""
7145
7146 # type: verbatim
7147 #. type: verbatim
7148 #: ../src/guestfs-actions.pod:668
7149 #, no-wrap
7150 msgid ""
7151 " int\n"
7152 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7153 "                          const char *device);\n"
7154 "\n"
7155 msgstr ""
7156
7157 # type: textblock
7158 #. type: textblock
7159 #: ../src/guestfs-actions.pod:672 ../fish/guestfish-actions.pod:447
7160 msgid "This returns the block size of a device."
7161 msgstr ""
7162
7163 # type: textblock
7164 #. type: textblock
7165 #: ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:774
7166 #: ../fish/guestfish-actions.pod:449 ../fish/guestfish-actions.pod:512
7167 msgid ""
7168 "(Note this is different from both I<size in blocks> and I<filesystem block "
7169 "size>)."
7170 msgstr ""
7171
7172 # type: =head2
7173 #. type: =head2
7174 #: ../src/guestfs-actions.pod:683
7175 msgid "guestfs_blockdev_getro"
7176 msgstr ""
7177
7178 # type: verbatim
7179 #. type: verbatim
7180 #: ../src/guestfs-actions.pod:685
7181 #, no-wrap
7182 msgid ""
7183 " int\n"
7184 " guestfs_blockdev_getro (guestfs_h *g,\n"
7185 "                         const char *device);\n"
7186 "\n"
7187 msgstr ""
7188
7189 # type: textblock
7190 #. type: textblock
7191 #: ../src/guestfs-actions.pod:689 ../fish/guestfish-actions.pod:458
7192 msgid ""
7193 "Returns a boolean indicating if the block device is read-only (true if read-"
7194 "only, false if not)."
7195 msgstr ""
7196
7197 # type: textblock
7198 #. type: textblock
7199 #: ../src/guestfs-actions.pod:694 ../src/guestfs-actions.pod:1396
7200 #: ../src/guestfs-actions.pod:1411 ../src/guestfs-actions.pod:1888
7201 #: ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1971
7202 #: ../src/guestfs-actions.pod:2026 ../src/guestfs-actions.pod:2041
7203 #: ../src/guestfs-actions.pod:2066 ../src/guestfs-actions.pod:2089
7204 #: ../src/guestfs-actions.pod:3051 ../src/guestfs-actions.pod:3065
7205 #: ../src/guestfs-actions.pod:3080 ../src/guestfs-actions.pod:3094
7206 #: ../src/guestfs-actions.pod:3110 ../src/guestfs-actions.pod:3125
7207 #: ../src/guestfs-actions.pod:3141 ../src/guestfs-actions.pod:3155
7208 #: ../src/guestfs-actions.pod:3168 ../src/guestfs-actions.pod:3182
7209 #: ../src/guestfs-actions.pod:3197 ../src/guestfs-actions.pod:3212
7210 #: ../src/guestfs-actions.pod:4735
7211 msgid "This function returns a C truth value on success or -1 on error."
7212 msgstr ""
7213
7214 # type: =head2
7215 #. type: =head2
7216 #: ../src/guestfs-actions.pod:698
7217 msgid "guestfs_blockdev_getsize64"
7218 msgstr ""
7219
7220 # type: verbatim
7221 #. type: verbatim
7222 #: ../src/guestfs-actions.pod:700
7223 #, no-wrap
7224 msgid ""
7225 " int64_t\n"
7226 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7227 "                             const char *device);\n"
7228 "\n"
7229 msgstr ""
7230
7231 # type: textblock
7232 #. type: textblock
7233 #: ../src/guestfs-actions.pod:704 ../fish/guestfish-actions.pod:467
7234 msgid "This returns the size of the device in bytes."
7235 msgstr ""
7236
7237 # type: textblock
7238 #. type: textblock
7239 #: ../src/guestfs-actions.pod:706
7240 msgid "See also C<guestfs_blockdev_getsz>."
7241 msgstr ""
7242
7243 # type: =head2
7244 #. type: =head2
7245 #: ../src/guestfs-actions.pod:714
7246 msgid "guestfs_blockdev_getss"
7247 msgstr ""
7248
7249 # type: verbatim
7250 #. type: verbatim
7251 #: ../src/guestfs-actions.pod:716
7252 #, no-wrap
7253 msgid ""
7254 " int\n"
7255 " guestfs_blockdev_getss (guestfs_h *g,\n"
7256 "                         const char *device);\n"
7257 "\n"
7258 msgstr ""
7259
7260 # type: textblock
7261 #. type: textblock
7262 #: ../src/guestfs-actions.pod:720 ../fish/guestfish-actions.pod:477
7263 msgid ""
7264 "This returns the size of sectors on a block device.  Usually 512, but can be "
7265 "larger for modern devices."
7266 msgstr ""
7267
7268 # type: textblock
7269 #. type: textblock
7270 #: ../src/guestfs-actions.pod:723
7271 msgid ""
7272 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
7273 "that)."
7274 msgstr ""
7275
7276 # type: =head2
7277 #. type: =head2
7278 #: ../src/guestfs-actions.pod:732
7279 msgid "guestfs_blockdev_getsz"
7280 msgstr ""
7281
7282 # type: verbatim
7283 #. type: verbatim
7284 #: ../src/guestfs-actions.pod:734
7285 #, no-wrap
7286 msgid ""
7287 " int64_t\n"
7288 " guestfs_blockdev_getsz (guestfs_h *g,\n"
7289 "                         const char *device);\n"
7290 "\n"
7291 msgstr ""
7292
7293 # type: textblock
7294 #. type: textblock
7295 #: ../src/guestfs-actions.pod:738 ../fish/guestfish-actions.pod:489
7296 msgid ""
7297 "This returns the size of the device in units of 512-byte sectors (even if "
7298 "the sectorsize isn't 512 bytes ... weird)."
7299 msgstr ""
7300
7301 # type: textblock
7302 #. type: textblock
7303 #: ../src/guestfs-actions.pod:741
7304 msgid ""
7305 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
7306 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
7307 msgstr ""
7308
7309 # type: =head2
7310 #. type: =head2
7311 #: ../src/guestfs-actions.pod:751
7312 msgid "guestfs_blockdev_rereadpt"
7313 msgstr ""
7314
7315 # type: verbatim
7316 #. type: verbatim
7317 #: ../src/guestfs-actions.pod:753
7318 #, no-wrap
7319 msgid ""
7320 " int\n"
7321 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
7322 "                            const char *device);\n"
7323 "\n"
7324 msgstr ""
7325
7326 # type: textblock
7327 #. type: textblock
7328 #: ../src/guestfs-actions.pod:757 ../fish/guestfish-actions.pod:502
7329 msgid "Reread the partition table on C<device>."
7330 msgstr ""
7331
7332 # type: =head2
7333 #. type: =head2
7334 #: ../src/guestfs-actions.pod:765
7335 msgid "guestfs_blockdev_setbsz"
7336 msgstr ""
7337
7338 # type: verbatim
7339 #. type: verbatim
7340 #: ../src/guestfs-actions.pod:767
7341 #, no-wrap
7342 msgid ""
7343 " int\n"
7344 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
7345 "                          const char *device,\n"
7346 "                          int blocksize);\n"
7347 "\n"
7348 msgstr ""
7349
7350 # type: textblock
7351 #. type: textblock
7352 #: ../src/guestfs-actions.pod:772 ../fish/guestfish-actions.pod:510
7353 msgid "This sets the block size of a device."
7354 msgstr ""
7355
7356 # type: =head2
7357 #. type: =head2
7358 #: ../src/guestfs-actions.pod:783
7359 msgid "guestfs_blockdev_setro"
7360 msgstr ""
7361
7362 # type: verbatim
7363 #. type: verbatim
7364 #: ../src/guestfs-actions.pod:785
7365 #, no-wrap
7366 msgid ""
7367 " int\n"
7368 " guestfs_blockdev_setro (guestfs_h *g,\n"
7369 "                         const char *device);\n"
7370 "\n"
7371 msgstr ""
7372
7373 # type: textblock
7374 #. type: textblock
7375 #: ../src/guestfs-actions.pod:789 ../fish/guestfish-actions.pod:521
7376 msgid "Sets the block device named C<device> to read-only."
7377 msgstr ""
7378
7379 # type: =head2
7380 #. type: =head2
7381 #: ../src/guestfs-actions.pod:797
7382 msgid "guestfs_blockdev_setrw"
7383 msgstr ""
7384
7385 # type: verbatim
7386 #. type: verbatim
7387 #: ../src/guestfs-actions.pod:799
7388 #, no-wrap
7389 msgid ""
7390 " int\n"
7391 " guestfs_blockdev_setrw (guestfs_h *g,\n"
7392 "                         const char *device);\n"
7393 "\n"
7394 msgstr ""
7395
7396 # type: textblock
7397 #. type: textblock
7398 #: ../src/guestfs-actions.pod:803 ../fish/guestfish-actions.pod:529
7399 msgid "Sets the block device named C<device> to read-write."
7400 msgstr ""
7401
7402 # type: =head2
7403 #. type: =head2
7404 #: ../src/guestfs-actions.pod:811
7405 msgid "guestfs_case_sensitive_path"
7406 msgstr ""
7407
7408 # type: verbatim
7409 #. type: verbatim
7410 #: ../src/guestfs-actions.pod:813
7411 #, no-wrap
7412 msgid ""
7413 " char *\n"
7414 " guestfs_case_sensitive_path (guestfs_h *g,\n"
7415 "                              const char *path);\n"
7416 "\n"
7417 msgstr ""
7418
7419 # type: textblock
7420 #. type: textblock
7421 #: ../src/guestfs-actions.pod:817 ../fish/guestfish-actions.pod:537
7422 msgid ""
7423 "This can be used to resolve case insensitive paths on a filesystem which is "
7424 "case sensitive.  The use case is to resolve paths which you have read from "
7425 "Windows configuration files or the Windows Registry, to the true path."
7426 msgstr ""
7427
7428 # type: textblock
7429 #. type: textblock
7430 #: ../src/guestfs-actions.pod:822 ../fish/guestfish-actions.pod:542
7431 msgid ""
7432 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
7433 "(and probably others), which is that although the underlying filesystem is "
7434 "case-insensitive, the driver exports the filesystem to Linux as case-"
7435 "sensitive."
7436 msgstr ""
7437
7438 # type: textblock
7439 #. type: textblock
7440 #: ../src/guestfs-actions.pod:827 ../fish/guestfish-actions.pod:547
7441 msgid ""
7442 "One consequence of this is that special directories such as C<c:\\windows> "
7443 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
7444 "precise details of how they were created.  In Windows itself this would not "
7445 "be a problem."
7446 msgstr ""
7447
7448 # type: textblock
7449 #. type: textblock
7450 #: ../src/guestfs-actions.pod:833 ../fish/guestfish-actions.pod:553
7451 msgid ""
7452 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
7453 "#posixfilenames1>"
7454 msgstr ""
7455
7456 # type: textblock
7457 #. type: textblock
7458 #: ../src/guestfs-actions.pod:836 ../fish/guestfish-actions.pod:556
7459 msgid ""
7460 "This function resolves the true case of each element in the path and returns "
7461 "the case-sensitive path."
7462 msgstr ""
7463
7464 # type: textblock
7465 #. type: textblock
7466 #: ../src/guestfs-actions.pod:839
7467 msgid ""
7468 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
7469 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
7470 "how the directories were originally created under Windows)."
7471 msgstr ""
7472
7473 # type: textblock
7474 #. type: textblock
7475 #: ../src/guestfs-actions.pod:844 ../fish/guestfish-actions.pod:564
7476 msgid "I<Note>: This function does not handle drive names, backslashes etc."
7477 msgstr ""
7478
7479 # type: textblock
7480 #. type: textblock
7481 #: ../src/guestfs-actions.pod:847
7482 msgid "See also C<guestfs_realpath>."
7483 msgstr ""
7484
7485 # type: textblock
7486 #. type: textblock
7487 #: ../src/guestfs-actions.pod:852 ../src/guestfs-actions.pod:6677
7488 msgid "(Added in 1.0.75)"
7489 msgstr ""
7490
7491 # type: =head2
7492 #. type: =head2
7493 #: ../src/guestfs-actions.pod:854
7494 msgid "guestfs_cat"
7495 msgstr ""
7496
7497 # type: verbatim
7498 #. type: verbatim
7499 #: ../src/guestfs-actions.pod:856
7500 #, no-wrap
7501 msgid ""
7502 " char *\n"
7503 " guestfs_cat (guestfs_h *g,\n"
7504 "              const char *path);\n"
7505 "\n"
7506 msgstr ""
7507
7508 # type: textblock
7509 #. type: textblock
7510 #: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:5222
7511 #: ../fish/guestfish-actions.pod:573 ../fish/guestfish-actions.pod:3474
7512 msgid "Return the contents of the file named C<path>."
7513 msgstr ""
7514
7515 # type: textblock
7516 #. type: textblock
7517 #: ../src/guestfs-actions.pod:862
7518 msgid ""
7519 "Note that this function cannot correctly handle binary files (specifically, "
7520 "files containing C<\\0> character which is treated as end of string).  For "
7521 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
7522 "functions which have a more complex interface."
7523 msgstr ""
7524
7525 # type: textblock
7526 #. type: textblock
7527 #: ../src/guestfs-actions.pod:870 ../src/guestfs-actions.pod:1049
7528 #: ../src/guestfs-actions.pod:1069 ../src/guestfs-actions.pod:1360
7529 #: ../src/guestfs-actions.pod:1379 ../src/guestfs-actions.pod:1482
7530 #: ../src/guestfs-actions.pod:1501 ../src/guestfs-actions.pod:1747
7531 #: ../src/guestfs-actions.pod:2195 ../src/guestfs-actions.pod:2214
7532 #: ../src/guestfs-actions.pod:2257 ../src/guestfs-actions.pod:2281
7533 #: ../src/guestfs-actions.pod:2298 ../src/guestfs-actions.pod:2327
7534 #: ../src/guestfs-actions.pod:5004 ../src/guestfs-actions.pod:5030
7535 #: ../src/guestfs-actions.pod:5161 ../src/guestfs-actions.pod:5187
7536 #: ../src/guestfs-actions.pod:5211 ../src/guestfs-actions.pod:6062
7537 #: ../src/guestfs-actions.pod:6117 ../src/guestfs-actions.pod:6263
7538 #: ../src/guestfs-actions.pod:6287 ../src/guestfs-actions.pod:6949
7539 #: ../src/guestfs-actions.pod:6975 ../src/guestfs-actions.pod:7001
7540 #: ../src/guestfs-actions.pod:7020 ../src/guestfs-actions.pod:7105
7541 #: ../src/guestfs-actions.pod:7124 ../src/guestfs-actions.pod:7170
7542 #: ../src/guestfs-actions.pod:7189 ../fish/guestfish-actions.pod:580
7543 #: ../fish/guestfish-actions.pod:715 ../fish/guestfish-actions.pod:727
7544 #: ../fish/guestfish-actions.pod:903 ../fish/guestfish-actions.pod:913
7545 #: ../fish/guestfish-actions.pod:980 ../fish/guestfish-actions.pod:990
7546 #: ../fish/guestfish-actions.pod:1182 ../fish/guestfish-actions.pod:1477
7547 #: ../fish/guestfish-actions.pod:1487 ../fish/guestfish-actions.pod:1515
7548 #: ../fish/guestfish-actions.pod:1530 ../fish/guestfish-actions.pod:1540
7549 #: ../fish/guestfish-actions.pod:1559 ../fish/guestfish-actions.pod:3344
7550 #: ../fish/guestfish-actions.pod:3359 ../fish/guestfish-actions.pod:3435
7551 #: ../fish/guestfish-actions.pod:3452 ../fish/guestfish-actions.pod:3467
7552 #: ../fish/guestfish-actions.pod:4050 ../fish/guestfish-actions.pod:4096
7553 #: ../fish/guestfish-actions.pod:4181 ../fish/guestfish-actions.pod:4196
7554 #: ../fish/guestfish-actions.pod:4606 ../fish/guestfish-actions.pod:4624
7555 #: ../fish/guestfish-actions.pod:4641 ../fish/guestfish-actions.pod:4651
7556 #: ../fish/guestfish-actions.pod:4699 ../fish/guestfish-actions.pod:4709
7557 #: ../fish/guestfish-actions.pod:4738 ../fish/guestfish-actions.pod:4748
7558 msgid ""
7559 "Because of the message protocol, there is a transfer limit of somewhere "
7560 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
7561 msgstr ""
7562
7563 # type: textblock
7564 #. type: textblock
7565 #: ../src/guestfs-actions.pod:873 ../src/guestfs-actions.pod:3323
7566 #: ../src/guestfs-actions.pod:3385 ../src/guestfs-actions.pod:3402
7567 #: ../src/guestfs-actions.pod:3490 ../src/guestfs-actions.pod:3895
7568 #: ../src/guestfs-actions.pod:3909 ../src/guestfs-actions.pod:5110
7569 #: ../src/guestfs-actions.pod:5124 ../src/guestfs-actions.pod:6836
7570 #: ../src/guestfs-actions.pod:6850
7571 msgid "(Added in 0.4)"
7572 msgstr ""
7573
7574 # type: =head2
7575 #. type: =head2
7576 #: ../src/guestfs-actions.pod:875
7577 msgid "guestfs_checksum"
7578 msgstr ""
7579
7580 # type: verbatim
7581 #. type: verbatim
7582 #: ../src/guestfs-actions.pod:877
7583 #, no-wrap
7584 msgid ""
7585 " char *\n"
7586 " guestfs_checksum (guestfs_h *g,\n"
7587 "                   const char *csumtype,\n"
7588 "                   const char *path);\n"
7589 "\n"
7590 msgstr ""
7591
7592 # type: textblock
7593 #. type: textblock
7594 #: ../src/guestfs-actions.pod:882 ../fish/guestfish-actions.pod:587
7595 msgid ""
7596 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
7597 msgstr ""
7598
7599 # type: textblock
7600 #. type: textblock
7601 #: ../src/guestfs-actions.pod:885 ../fish/guestfish-actions.pod:590
7602 msgid ""
7603 "The type of checksum to compute is given by the C<csumtype> parameter which "
7604 "must have one of the following values:"
7605 msgstr ""
7606
7607 # type: =item
7608 #. type: =item
7609 #: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:595
7610 msgid "C<crc>"
7611 msgstr ""
7612
7613 # type: textblock
7614 #. type: textblock
7615 #: ../src/guestfs-actions.pod:892 ../fish/guestfish-actions.pod:597
7616 msgid ""
7617 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
7618 "C<cksum> command."
7619 msgstr ""
7620
7621 # type: =item
7622 #. type: =item
7623 #: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:600
7624 msgid "C<md5>"
7625 msgstr ""
7626
7627 # type: textblock
7628 #. type: textblock
7629 #: ../src/guestfs-actions.pod:897 ../fish/guestfish-actions.pod:602
7630 msgid "Compute the MD5 hash (using the C<md5sum> program)."
7631 msgstr ""
7632
7633 # type: =item
7634 #. type: =item
7635 #: ../src/guestfs-actions.pod:899 ../fish/guestfish-actions.pod:604
7636 msgid "C<sha1>"
7637 msgstr ""
7638
7639 # type: textblock
7640 #. type: textblock
7641 #: ../src/guestfs-actions.pod:901 ../fish/guestfish-actions.pod:606
7642 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
7643 msgstr ""
7644
7645 # type: =item
7646 #. type: =item
7647 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:608
7648 msgid "C<sha224>"
7649 msgstr ""
7650
7651 # type: textblock
7652 #. type: textblock
7653 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:610
7654 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
7655 msgstr ""
7656
7657 # type: =item
7658 #. type: =item
7659 #: ../src/guestfs-actions.pod:907 ../fish/guestfish-actions.pod:612
7660 msgid "C<sha256>"
7661 msgstr ""
7662
7663 # type: textblock
7664 #. type: textblock
7665 #: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:614
7666 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
7667 msgstr ""
7668
7669 # type: =item
7670 #. type: =item
7671 #: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:616
7672 msgid "C<sha384>"
7673 msgstr ""
7674
7675 # type: textblock
7676 #. type: textblock
7677 #: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:618
7678 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
7679 msgstr ""
7680
7681 # type: =item
7682 #. type: =item
7683 #: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:620
7684 msgid "C<sha512>"
7685 msgstr ""
7686
7687 # type: textblock
7688 #. type: textblock
7689 #: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:622
7690 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
7691 msgstr ""
7692
7693 # type: textblock
7694 #. type: textblock
7695 #: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:626
7696 msgid "The checksum is returned as a printable string."
7697 msgstr ""
7698
7699 # type: textblock
7700 #. type: textblock
7701 #: ../src/guestfs-actions.pod:923
7702 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
7703 msgstr ""
7704
7705 # type: textblock
7706 #. type: textblock
7707 #: ../src/guestfs-actions.pod:925
7708 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
7709 msgstr ""
7710
7711 # type: textblock
7712 #. type: textblock
7713 #: ../src/guestfs-actions.pod:930 ../src/guestfs-actions.pod:1238
7714 #: ../src/guestfs-actions.pod:2057 ../src/guestfs-actions.pod:3067
7715 #: ../src/guestfs-actions.pod:3096 ../src/guestfs-actions.pod:3157
7716 #: ../src/guestfs-actions.pod:3184 ../src/guestfs-actions.pod:6533
7717 msgid "(Added in 1.0.2)"
7718 msgstr ""
7719
7720 # type: =head2
7721 #. type: =head2
7722 #: ../src/guestfs-actions.pod:932
7723 msgid "guestfs_checksum_device"
7724 msgstr ""
7725
7726 # type: verbatim
7727 #. type: verbatim
7728 #: ../src/guestfs-actions.pod:934
7729 #, no-wrap
7730 msgid ""
7731 " char *\n"
7732 " guestfs_checksum_device (guestfs_h *g,\n"
7733 "                          const char *csumtype,\n"
7734 "                          const char *device);\n"
7735 "\n"
7736 msgstr ""
7737
7738 # type: textblock
7739 #. type: textblock
7740 #: ../src/guestfs-actions.pod:939
7741 msgid ""
7742 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
7743 "device named C<device>.  For the types of checksums supported see the "
7744 "C<guestfs_checksum> command."
7745 msgstr ""
7746
7747 # type: textblock
7748 #. type: textblock
7749 #: ../src/guestfs-actions.pod:946 ../src/guestfs-actions.pod:4641
7750 #: ../src/guestfs-actions.pod:4700 ../src/guestfs-actions.pod:4737
7751 #: ../src/guestfs-actions.pod:4755 ../src/guestfs-actions.pod:4931
7752 #: ../src/guestfs-actions.pod:6442 ../src/guestfs-actions.pod:6456
7753 #: ../src/guestfs-actions.pod:6862
7754 msgid "(Added in 1.3.2)"
7755 msgstr ""
7756
7757 # type: =head2
7758 #. type: =head2
7759 #: ../src/guestfs-actions.pod:948
7760 msgid "guestfs_checksums_out"
7761 msgstr ""
7762
7763 # type: verbatim
7764 #. type: verbatim
7765 #: ../src/guestfs-actions.pod:950
7766 #, no-wrap
7767 msgid ""
7768 " int\n"
7769 " guestfs_checksums_out (guestfs_h *g,\n"
7770 "                        const char *csumtype,\n"
7771 "                        const char *directory,\n"
7772 "                        const char *sumsfile);\n"
7773 "\n"
7774 msgstr ""
7775
7776 # type: textblock
7777 #. type: textblock
7778 #: ../src/guestfs-actions.pod:956 ../fish/guestfish-actions.pod:644
7779 msgid ""
7780 "This command computes the checksums of all regular files in C<directory> and "
7781 "then emits a list of those checksums to the local output file C<sumsfile>."
7782 msgstr ""
7783
7784 # type: textblock
7785 #. type: textblock
7786 #: ../src/guestfs-actions.pod:960 ../fish/guestfish-actions.pod:648
7787 msgid ""
7788 "This can be used for verifying the integrity of a virtual machine.  However "
7789 "to be properly secure you should pay attention to the output of the checksum "
7790 "command (it uses the ones from GNU coreutils).  In particular when the "
7791 "filename is not printable, coreutils uses a special backslash syntax.  For "
7792 "more information, see the GNU coreutils info file."
7793 msgstr ""
7794
7795 # type: textblock
7796 #. type: textblock
7797 #: ../src/guestfs-actions.pod:970
7798 msgid "(Added in 1.3.7)"
7799 msgstr ""
7800
7801 # type: =head2
7802 #. type: =head2
7803 #: ../src/guestfs-actions.pod:972
7804 msgid "guestfs_chmod"
7805 msgstr ""
7806
7807 # type: verbatim
7808 #. type: verbatim
7809 #: ../src/guestfs-actions.pod:974
7810 #, no-wrap
7811 msgid ""
7812 " int\n"
7813 " guestfs_chmod (guestfs_h *g,\n"
7814 "                int mode,\n"
7815 "                const char *path);\n"
7816 "\n"
7817 msgstr ""
7818
7819 # type: textblock
7820 #. type: textblock
7821 #: ../src/guestfs-actions.pod:979 ../fish/guestfish-actions.pod:662
7822 msgid ""
7823 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
7824 "supported."
7825 msgstr ""
7826
7827 # type: textblock
7828 #. type: textblock
7829 #: ../src/guestfs-actions.pod:982 ../fish/guestfish-actions.pod:665
7830 msgid ""
7831 "I<Note>: When using this command from guestfish, C<mode> by default would be "
7832 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
7833 "C<700>."
7834 msgstr ""
7835
7836 # type: textblock
7837 #. type: textblock
7838 #: ../src/guestfs-actions.pod:986 ../src/guestfs-actions.pod:4146
7839 #: ../src/guestfs-actions.pod:4331 ../src/guestfs-actions.pod:4350
7840 #: ../src/guestfs-actions.pod:4369 ../fish/guestfish-actions.pod:669
7841 #: ../fish/guestfish-actions.pod:2792 ../fish/guestfish-actions.pod:2910
7842 #: ../fish/guestfish-actions.pod:2920 ../fish/guestfish-actions.pod:2930
7843 msgid "The mode actually set is affected by the umask."
7844 msgstr ""
7845
7846 # type: =head2
7847 #. type: =head2
7848 #: ../src/guestfs-actions.pod:992
7849 msgid "guestfs_chown"
7850 msgstr ""
7851
7852 # type: verbatim
7853 #. type: verbatim
7854 #: ../src/guestfs-actions.pod:994
7855 #, no-wrap
7856 msgid ""
7857 " int\n"
7858 " guestfs_chown (guestfs_h *g,\n"
7859 "                int owner,\n"
7860 "                int group,\n"
7861 "                const char *path);\n"
7862 "\n"
7863 msgstr ""
7864
7865 # type: textblock
7866 #. type: textblock
7867 #: ../src/guestfs-actions.pod:1000 ../fish/guestfish-actions.pod:675
7868 msgid "Change the file owner to C<owner> and group to C<group>."
7869 msgstr ""
7870
7871 # type: textblock
7872 #. type: textblock
7873 #: ../src/guestfs-actions.pod:1002 ../src/guestfs-actions.pod:3254
7874 #: ../fish/guestfish-actions.pod:677 ../fish/guestfish-actions.pod:2250
7875 msgid ""
7876 "Only numeric uid and gid are supported.  If you want to use names, you will "
7877 "need to locate and parse the password file yourself (Augeas support makes "
7878 "this relatively easy)."
7879 msgstr ""
7880
7881 # type: =head2
7882 #. type: =head2
7883 #: ../src/guestfs-actions.pod:1010
7884 msgid "guestfs_command"
7885 msgstr ""
7886
7887 # type: verbatim
7888 #. type: verbatim
7889 #: ../src/guestfs-actions.pod:1012
7890 #, no-wrap
7891 msgid ""
7892 " char *\n"
7893 " guestfs_command (guestfs_h *g,\n"
7894 "                  char *const *arguments);\n"
7895 "\n"
7896 msgstr ""
7897
7898 # type: textblock
7899 #. type: textblock
7900 #: ../src/guestfs-actions.pod:1016 ../fish/guestfish-actions.pod:685
7901 msgid ""
7902 "This call runs a command from the guest filesystem.  The filesystem must be "
7903 "mounted, and must contain a compatible operating system (ie. something "
7904 "Linux, with the same or compatible processor architecture)."
7905 msgstr ""
7906
7907 # type: textblock
7908 #. type: textblock
7909 #: ../src/guestfs-actions.pod:1021
7910 msgid ""
7911 "The single parameter is an argv-style list of arguments.  The first element "
7912 "is the name of the program to run.  Subsequent elements are parameters.  The "
7913 "list must be non-empty (ie. must contain a program name).  Note that the "
7914 "command runs directly, and is I<not> invoked via the shell (see "
7915 "C<guestfs_sh>)."
7916 msgstr ""
7917
7918 # type: textblock
7919 #. type: textblock
7920 #: ../src/guestfs-actions.pod:1028 ../fish/guestfish-actions.pod:697
7921 msgid "The return value is anything printed to I<stdout> by the command."
7922 msgstr ""
7923
7924 # type: textblock
7925 #. type: textblock
7926 #: ../src/guestfs-actions.pod:1031 ../fish/guestfish-actions.pod:700
7927 msgid ""
7928 "If the command returns a non-zero exit status, then this function returns an "
7929 "error message.  The error message string is the content of I<stderr> from "
7930 "the command."
7931 msgstr ""
7932
7933 # type: textblock
7934 #. type: textblock
7935 #: ../src/guestfs-actions.pod:1035 ../fish/guestfish-actions.pod:704
7936 msgid ""
7937 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
7938 "bin>.  If you require a program from another location, you should provide "
7939 "the full path in the first parameter."
7940 msgstr ""
7941
7942 # type: textblock
7943 #. type: textblock
7944 #: ../src/guestfs-actions.pod:1040 ../fish/guestfish-actions.pod:709
7945 msgid ""
7946 "Shared libraries and data files required by the program must be available on "
7947 "filesystems which are mounted in the correct places.  It is the caller's "
7948 "responsibility to ensure all filesystems that are needed are mounted at the "
7949 "right locations."
7950 msgstr ""
7951
7952 # type: textblock
7953 #. type: textblock
7954 #: ../src/guestfs-actions.pod:1052 ../src/guestfs-actions.pod:1072
7955 #: ../src/guestfs-actions.pod:1532
7956 msgid "(Added in 0.9.1)"
7957 msgstr ""
7958
7959 # type: =head2
7960 #. type: =head2
7961 #: ../src/guestfs-actions.pod:1054
7962 msgid "guestfs_command_lines"
7963 msgstr ""
7964
7965 # type: verbatim
7966 #. type: verbatim
7967 #: ../src/guestfs-actions.pod:1056
7968 #, no-wrap
7969 msgid ""
7970 " char **\n"
7971 " guestfs_command_lines (guestfs_h *g,\n"
7972 "                        char *const *arguments);\n"
7973 "\n"
7974 msgstr ""
7975
7976 # type: textblock
7977 #. type: textblock
7978 #: ../src/guestfs-actions.pod:1060
7979 msgid ""
7980 "This is the same as C<guestfs_command>, but splits the result into a list of "
7981 "lines."
7982 msgstr ""
7983
7984 # type: textblock
7985 #. type: textblock
7986 #: ../src/guestfs-actions.pod:1063
7987 msgid "See also: C<guestfs_sh_lines>"
7988 msgstr ""
7989
7990 # type: =head2
7991 #. type: =head2
7992 #: ../src/guestfs-actions.pod:1074
7993 msgid "guestfs_config"
7994 msgstr ""
7995
7996 # type: verbatim
7997 #. type: verbatim
7998 #: ../src/guestfs-actions.pod:1076
7999 #, no-wrap
8000 msgid ""
8001 " int\n"
8002 " guestfs_config (guestfs_h *g,\n"
8003 "                 const char *qemuparam,\n"
8004 "                 const char *qemuvalue);\n"
8005 "\n"
8006 msgstr ""
8007
8008 # type: textblock
8009 #. type: textblock
8010 #: ../src/guestfs-actions.pod:1081 ../fish/guestfish-actions.pod:734
8011 msgid ""
8012 "This can be used to add arbitrary qemu command line parameters of the form "
8013 "C<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8014 "setting some parameters which would interfere with parameters that we use."
8015 msgstr ""
8016
8017 # type: textblock
8018 #. type: textblock
8019 #: ../src/guestfs-actions.pod:1086 ../fish/guestfish-actions.pod:739
8020 msgid "The first character of C<param> string must be a C<-> (dash)."
8021 msgstr ""
8022
8023 # type: textblock
8024 #. type: textblock
8025 #: ../src/guestfs-actions.pod:1088 ../fish/guestfish-actions.pod:741
8026 msgid "C<value> can be NULL."
8027 msgstr ""
8028
8029 # type: =head2
8030 #. type: =head2
8031 #: ../src/guestfs-actions.pod:1094
8032 msgid "guestfs_copy_size"
8033 msgstr ""
8034
8035 # type: verbatim
8036 #. type: verbatim
8037 #: ../src/guestfs-actions.pod:1096
8038 #, no-wrap
8039 msgid ""
8040 " int\n"
8041 " guestfs_copy_size (guestfs_h *g,\n"
8042 "                    const char *src,\n"
8043 "                    const char *dest,\n"
8044 "                    int64_t size);\n"
8045 "\n"
8046 msgstr ""
8047
8048 # type: textblock
8049 #. type: textblock
8050 #: ../src/guestfs-actions.pod:1102 ../fish/guestfish-actions.pod:747
8051 msgid ""
8052 "This command copies exactly C<size> bytes from one source device or file "
8053 "C<src> to another destination device or file C<dest>."
8054 msgstr ""
8055
8056 # type: textblock
8057 #. type: textblock
8058 #: ../src/guestfs-actions.pod:1105 ../fish/guestfish-actions.pod:750
8059 msgid ""
8060 "Note this will fail if the source is too short or if the destination is not "
8061 "large enough."
8062 msgstr ""
8063
8064 # type: textblock
8065 #. type: textblock
8066 #: ../src/guestfs-actions.pod:1110 ../src/guestfs-actions.pod:1233
8067 #: ../src/guestfs-actions.pod:1264 ../src/guestfs-actions.pod:1681
8068 #: ../src/guestfs-actions.pod:1703 ../src/guestfs-actions.pod:6528
8069 #: ../src/guestfs-actions.pod:6562 ../src/guestfs-actions.pod:7041
8070 #: ../src/guestfs-actions.pod:7060
8071 msgid ""
8072 "This long-running command can generate progress notification messages so "
8073 "that the caller can display a progress bar or indicator.  To receive these "
8074 "messages, the caller must register a progress callback.  See L<guestfs(3)/"
8075 "guestfs_set_progress_callback>."
8076 msgstr ""
8077
8078 # type: textblock
8079 #. type: textblock
8080 #: ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:3922
8081 #: ../src/guestfs-actions.pod:5137 ../src/guestfs-actions.pod:6769
8082 #: ../src/guestfs-actions.pod:6789 ../src/guestfs-actions.pod:6875
8083 msgid "(Added in 1.0.87)"
8084 msgstr ""
8085
8086 # type: =head2
8087 #. type: =head2
8088 #: ../src/guestfs-actions.pod:1117
8089 msgid "guestfs_cp"
8090 msgstr ""
8091
8092 # type: verbatim
8093 #. type: verbatim
8094 #: ../src/guestfs-actions.pod:1119
8095 #, no-wrap
8096 msgid ""
8097 " int\n"
8098 " guestfs_cp (guestfs_h *g,\n"
8099 "             const char *src,\n"
8100 "             const char *dest);\n"
8101 "\n"
8102 msgstr ""
8103
8104 # type: textblock
8105 #. type: textblock
8106 #: ../src/guestfs-actions.pod:1124 ../fish/guestfish-actions.pod:757
8107 msgid ""
8108 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8109 "destination filename or destination directory."
8110 msgstr ""
8111
8112 # type: textblock
8113 #. type: textblock
8114 #: ../src/guestfs-actions.pod:1129 ../src/guestfs-actions.pod:1143
8115 #: ../src/guestfs-actions.pod:1215 ../src/guestfs-actions.pod:1289
8116 #: ../src/guestfs-actions.pod:1398 ../src/guestfs-actions.pod:4595
8117 #: ../src/guestfs-actions.pod:4981
8118 msgid "(Added in 1.0.18)"
8119 msgstr ""
8120
8121 # type: =head2
8122 #. type: =head2
8123 #: ../src/guestfs-actions.pod:1131
8124 msgid "guestfs_cp_a"
8125 msgstr ""
8126
8127 # type: verbatim
8128 #. type: verbatim
8129 #: ../src/guestfs-actions.pod:1133
8130 #, no-wrap
8131 msgid ""
8132 " int\n"
8133 " guestfs_cp_a (guestfs_h *g,\n"
8134 "               const char *src,\n"
8135 "               const char *dest);\n"
8136 "\n"
8137 msgstr ""
8138
8139 # type: textblock
8140 #. type: textblock
8141 #: ../src/guestfs-actions.pod:1138 ../fish/guestfish-actions.pod:764
8142 msgid ""
8143 "This copies a file or directory from C<src> to C<dest> recursively using the "
8144 "C<cp -a> command."
8145 msgstr ""
8146
8147 # type: =head2
8148 #. type: =head2
8149 #: ../src/guestfs-actions.pod:1145
8150 msgid "guestfs_dd"
8151 msgstr ""
8152
8153 # type: verbatim
8154 #. type: verbatim
8155 #: ../src/guestfs-actions.pod:1147
8156 #, no-wrap
8157 msgid ""
8158 " int\n"
8159 " guestfs_dd (guestfs_h *g,\n"
8160 "             const char *src,\n"
8161 "             const char *dest);\n"
8162 "\n"
8163 msgstr ""
8164
8165 # type: textblock
8166 #. type: textblock
8167 #: ../src/guestfs-actions.pod:1152 ../fish/guestfish-actions.pod:771
8168 msgid ""
8169 "This command copies from one source device or file C<src> to another "
8170 "destination device or file C<dest>.  Normally you would use this to copy to "
8171 "or from a device or partition, for example to duplicate a filesystem."
8172 msgstr ""
8173
8174 # type: textblock
8175 #. type: textblock
8176 #: ../src/guestfs-actions.pod:1157
8177 msgid ""
8178 "If the destination is a device, it must be as large or larger than the "
8179 "source file or device, otherwise the copy will fail.  This command cannot do "
8180 "partial copies (see C<guestfs_copy_size>)."
8181 msgstr ""
8182
8183 # type: =head2
8184 #. type: =head2
8185 #: ../src/guestfs-actions.pod:1165
8186 msgid "guestfs_df"
8187 msgstr ""
8188
8189 # type: verbatim
8190 #. type: verbatim
8191 #: ../src/guestfs-actions.pod:1167
8192 #, no-wrap
8193 msgid ""
8194 " char *\n"
8195 " guestfs_df (guestfs_h *g);\n"
8196 "\n"
8197 msgstr ""
8198
8199 # type: textblock
8200 #. type: textblock
8201 #: ../src/guestfs-actions.pod:1170 ../fish/guestfish-actions.pod:784
8202 msgid "This command runs the C<df> command to report disk space used."
8203 msgstr ""
8204
8205 # type: textblock
8206 #. type: textblock
8207 #: ../src/guestfs-actions.pod:1172 ../src/guestfs-actions.pod:1189
8208 msgid ""
8209 "This command is mostly useful for interactive sessions.  It is I<not> "
8210 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8211 "from programs."
8212 msgstr ""
8213
8214 # type: textblock
8215 #. type: textblock
8216 #: ../src/guestfs-actions.pod:1179 ../src/guestfs-actions.pod:1196
8217 #: ../src/guestfs-actions.pod:1309 ../src/guestfs-actions.pod:2260
8218 #: ../src/guestfs-actions.pod:2284 ../src/guestfs-actions.pod:2352
8219 #: ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4495
8220 #: ../src/guestfs-actions.pod:6266 ../src/guestfs-actions.pod:6290
8221 #: ../src/guestfs-actions.pod:6908 ../src/guestfs-actions.pod:6921
8222 #: ../src/guestfs-actions.pod:6934
8223 msgid "(Added in 1.0.54)"
8224 msgstr ""
8225
8226 # type: =head2
8227 #. type: =head2
8228 #: ../src/guestfs-actions.pod:1181
8229 msgid "guestfs_df_h"
8230 msgstr ""
8231
8232 # type: verbatim
8233 #. type: verbatim
8234 #: ../src/guestfs-actions.pod:1183
8235 #, no-wrap
8236 msgid ""
8237 " char *\n"
8238 " guestfs_df_h (guestfs_h *g);\n"
8239 "\n"
8240 msgstr ""
8241
8242 # type: textblock
8243 #. type: textblock
8244 #: ../src/guestfs-actions.pod:1186 ../fish/guestfish-actions.pod:794
8245 msgid ""
8246 "This command runs the C<df -h> command to report disk space used in human-"
8247 "readable format."
8248 msgstr ""
8249
8250 # type: =head2
8251 #. type: =head2
8252 #: ../src/guestfs-actions.pod:1198
8253 msgid "guestfs_dmesg"
8254 msgstr ""
8255
8256 # type: verbatim
8257 #. type: verbatim
8258 #: ../src/guestfs-actions.pod:1200
8259 #, no-wrap
8260 msgid ""
8261 " char *\n"
8262 " guestfs_dmesg (guestfs_h *g);\n"
8263 "\n"
8264 msgstr ""
8265
8266 # type: textblock
8267 #. type: textblock
8268 #: ../src/guestfs-actions.pod:1203 ../fish/guestfish-actions.pod:805
8269 msgid ""
8270 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
8271 "This is sometimes useful for extended debugging of problems."
8272 msgstr ""
8273
8274 # type: textblock
8275 #. type: textblock
8276 #: ../src/guestfs-actions.pod:1207
8277 msgid ""
8278 "Another way to get the same information is to enable verbose messages with "
8279 "C<guestfs_set_verbose> or by setting the environment variable "
8280 "C<LIBGUESTFS_DEBUG=1> before running the program."
8281 msgstr ""
8282
8283 # type: =head2
8284 #. type: =head2
8285 #: ../src/guestfs-actions.pod:1217
8286 msgid "guestfs_download"
8287 msgstr ""
8288
8289 # type: verbatim
8290 #. type: verbatim
8291 #: ../src/guestfs-actions.pod:1219
8292 #, no-wrap
8293 msgid ""
8294 " int\n"
8295 " guestfs_download (guestfs_h *g,\n"
8296 "                   const char *remotefilename,\n"
8297 "                   const char *filename);\n"
8298 "\n"
8299 msgstr ""
8300
8301 # type: textblock
8302 #. type: textblock
8303 #: ../src/guestfs-actions.pod:1224 ../src/guestfs-actions.pod:1249
8304 #: ../fish/guestfish-actions.pod:818 ../fish/guestfish-actions.pod:831
8305 msgid ""
8306 "Download file C<remotefilename> and save it as C<filename> on the local "
8307 "machine."
8308 msgstr ""
8309
8310 # type: textblock
8311 #. type: textblock
8312 #: ../src/guestfs-actions.pod:1227 ../src/guestfs-actions.pod:6522
8313 #: ../fish/guestfish-actions.pod:821 ../fish/guestfish-actions.pod:4354
8314 msgid "C<filename> can also be a named pipe."
8315 msgstr ""
8316
8317 # type: textblock
8318 #. type: textblock
8319 #: ../src/guestfs-actions.pod:1229
8320 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
8321 msgstr ""
8322
8323 # type: =head2
8324 #. type: =head2
8325 #: ../src/guestfs-actions.pod:1240
8326 msgid "guestfs_download_offset"
8327 msgstr ""
8328
8329 # type: verbatim
8330 #. type: verbatim
8331 #: ../src/guestfs-actions.pod:1242
8332 #, no-wrap
8333 msgid ""
8334 " int\n"
8335 " guestfs_download_offset (guestfs_h *g,\n"
8336 "                          const char *remotefilename,\n"
8337 "                          const char *filename,\n"
8338 "                          int64_t offset,\n"
8339 "                          int64_t size);\n"
8340 "\n"
8341 msgstr ""
8342
8343 # type: textblock
8344 #. type: textblock
8345 #: ../src/guestfs-actions.pod:1252 ../fish/guestfish-actions.pod:834
8346 msgid ""
8347 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8348 "region must be within the file or device)."
8349 msgstr ""
8350
8351 # type: textblock
8352 #. type: textblock
8353 #: ../src/guestfs-actions.pod:1255
8354 msgid ""
8355 "Note that there is no limit on the amount of data that can be downloaded "
8356 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
8357 "full amount unless an error occurs."
8358 msgstr ""
8359
8360 # type: textblock
8361 #. type: textblock
8362 #: ../src/guestfs-actions.pod:1260
8363 msgid "See also C<guestfs_download>, C<guestfs_pread>."
8364 msgstr ""
8365
8366 # type: textblock
8367 #. type: textblock
8368 #: ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:6567
8369 msgid "(Added in 1.5.17)"
8370 msgstr ""
8371
8372 # type: =head2
8373 #. type: =head2
8374 #: ../src/guestfs-actions.pod:1271
8375 msgid "guestfs_drop_caches"
8376 msgstr ""
8377
8378 # type: verbatim
8379 #. type: verbatim
8380 #: ../src/guestfs-actions.pod:1273
8381 #, no-wrap
8382 msgid ""
8383 " int\n"
8384 " guestfs_drop_caches (guestfs_h *g,\n"
8385 "                      int whattodrop);\n"
8386 "\n"
8387 msgstr ""
8388
8389 # type: textblock
8390 #. type: textblock
8391 #: ../src/guestfs-actions.pod:1277 ../fish/guestfish-actions.pod:850
8392 msgid ""
8393 "This instructs the guest kernel to drop its page cache, and/or dentries and "
8394 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
8395 "to drop, see L<http://linux-mm.org/Drop_Caches>"
8396 msgstr ""
8397
8398 # type: textblock
8399 #. type: textblock
8400 #: ../src/guestfs-actions.pod:1282 ../fish/guestfish-actions.pod:855
8401 msgid "Setting C<whattodrop> to 3 should drop everything."
8402 msgstr ""
8403
8404 # type: textblock
8405 #. type: textblock
8406 #: ../src/guestfs-actions.pod:1284 ../fish/guestfish-actions.pod:857
8407 msgid ""
8408 "This automatically calls L<sync(2)> before the operation, so that the "
8409 "maximum guest memory is freed."
8410 msgstr ""
8411
8412 # type: =head2
8413 #. type: =head2
8414 #: ../src/guestfs-actions.pod:1291
8415 msgid "guestfs_du"
8416 msgstr ""
8417
8418 # type: verbatim
8419 #. type: verbatim
8420 #: ../src/guestfs-actions.pod:1293
8421 #, no-wrap
8422 msgid ""
8423 " int64_t\n"
8424 " guestfs_du (guestfs_h *g,\n"
8425 "             const char *path);\n"
8426 "\n"
8427 msgstr ""
8428
8429 # type: textblock
8430 #. type: textblock
8431 #: ../src/guestfs-actions.pod:1297 ../fish/guestfish-actions.pod:864
8432 msgid ""
8433 "This command runs the C<du -s> command to estimate file space usage for "
8434 "C<path>."
8435 msgstr ""
8436
8437 # type: textblock
8438 #. type: textblock
8439 #: ../src/guestfs-actions.pod:1300 ../fish/guestfish-actions.pod:867
8440 msgid ""
8441 "C<path> can be a file or a directory.  If C<path> is a directory then the "
8442 "estimate includes the contents of the directory and all subdirectories "
8443 "(recursively)."
8444 msgstr ""
8445
8446 # type: textblock
8447 #. type: textblock
8448 #: ../src/guestfs-actions.pod:1304 ../fish/guestfish-actions.pod:871
8449 msgid ""
8450 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
8451 msgstr ""
8452
8453 # type: =head2
8454 #. type: =head2
8455 #: ../src/guestfs-actions.pod:1311
8456 msgid "guestfs_e2fsck_f"
8457 msgstr ""
8458
8459 # type: verbatim
8460 #. type: verbatim
8461 #: ../src/guestfs-actions.pod:1313
8462 #, no-wrap
8463 msgid ""
8464 " int\n"
8465 " guestfs_e2fsck_f (guestfs_h *g,\n"
8466 "                   const char *device);\n"
8467 "\n"
8468 msgstr ""
8469
8470 # type: textblock
8471 #. type: textblock
8472 #: ../src/guestfs-actions.pod:1317 ../fish/guestfish-actions.pod:878
8473 msgid ""
8474 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
8475 "on C<device>, noninteractively (C<-p>), even if the filesystem appears to be "
8476 "clean (C<-f>)."
8477 msgstr ""
8478
8479 # type: textblock
8480 #. type: textblock
8481 #: ../src/guestfs-actions.pod:1321
8482 msgid ""
8483 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
8484 "Normally you should use C<guestfs_fsck>."
8485 msgstr ""
8486
8487 # type: textblock
8488 #. type: textblock
8489 #: ../src/guestfs-actions.pod:1326
8490 msgid "(Added in 1.0.29)"
8491 msgstr ""
8492
8493 # type: =head2
8494 #. type: =head2
8495 #: ../src/guestfs-actions.pod:1328
8496 msgid "guestfs_echo_daemon"
8497 msgstr ""
8498
8499 # type: verbatim
8500 #. type: verbatim
8501 #: ../src/guestfs-actions.pod:1330
8502 #, no-wrap
8503 msgid ""
8504 " char *\n"
8505 " guestfs_echo_daemon (guestfs_h *g,\n"
8506 "                      char *const *words);\n"
8507 "\n"
8508 msgstr ""
8509
8510 # type: textblock
8511 #. type: textblock
8512 #: ../src/guestfs-actions.pod:1334 ../fish/guestfish-actions.pod:889
8513 msgid ""
8514 "This command concatenates the list of C<words> passed with single spaces "
8515 "between them and returns the resulting string."
8516 msgstr ""
8517
8518 # type: textblock
8519 #. type: textblock
8520 #: ../src/guestfs-actions.pod:1337 ../fish/guestfish-actions.pod:892
8521 msgid "You can use this command to test the connection through to the daemon."
8522 msgstr ""
8523
8524 # type: textblock
8525 #. type: textblock
8526 #: ../src/guestfs-actions.pod:1339
8527 msgid "See also C<guestfs_ping_daemon>."
8528 msgstr ""
8529
8530 # type: textblock
8531 #. type: textblock
8532 #: ../src/guestfs-actions.pod:1344 ../src/guestfs-actions.pod:2068
8533 #: ../src/guestfs-actions.pod:5770
8534 msgid "(Added in 1.0.69)"
8535 msgstr ""
8536
8537 # type: =head2
8538 #. type: =head2
8539 #: ../src/guestfs-actions.pod:1346
8540 msgid "guestfs_egrep"
8541 msgstr ""
8542
8543 # type: verbatim
8544 #. type: verbatim
8545 #: ../src/guestfs-actions.pod:1348
8546 #, no-wrap
8547 msgid ""
8548 " char **\n"
8549 " guestfs_egrep (guestfs_h *g,\n"
8550 "                const char *regex,\n"
8551 "                const char *path);\n"
8552 "\n"
8553 msgstr ""
8554
8555 # type: textblock
8556 #. type: textblock
8557 #: ../src/guestfs-actions.pod:1353 ../fish/guestfish-actions.pod:900
8558 msgid ""
8559 "This calls the external C<egrep> program and returns the matching lines."
8560 msgstr ""
8561
8562 # type: textblock
8563 #. type: textblock
8564 #: ../src/guestfs-actions.pod:1363 ../src/guestfs-actions.pod:1382
8565 #: ../src/guestfs-actions.pod:1439 ../src/guestfs-actions.pod:1485
8566 #: ../src/guestfs-actions.pod:1504 ../src/guestfs-actions.pod:2198
8567 #: ../src/guestfs-actions.pod:2217 ../src/guestfs-actions.pod:2373
8568 #: ../src/guestfs-actions.pod:2386 ../src/guestfs-actions.pod:2401
8569 #: ../src/guestfs-actions.pod:2447 ../src/guestfs-actions.pod:2469
8570 #: ../src/guestfs-actions.pod:2482 ../src/guestfs-actions.pod:3415
8571 #: ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3442
8572 #: ../src/guestfs-actions.pod:3456 ../src/guestfs-actions.pod:4430
8573 #: ../src/guestfs-actions.pod:5315 ../src/guestfs-actions.pod:5364
8574 #: ../src/guestfs-actions.pod:6134 ../src/guestfs-actions.pod:6146
8575 #: ../src/guestfs-actions.pod:6159 ../src/guestfs-actions.pod:6172
8576 #: ../src/guestfs-actions.pod:6194 ../src/guestfs-actions.pod:6207
8577 #: ../src/guestfs-actions.pod:6220 ../src/guestfs-actions.pod:6233
8578 #: ../src/guestfs-actions.pod:7004 ../src/guestfs-actions.pod:7023
8579 #: ../src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7127
8580 #: ../src/guestfs-actions.pod:7173 ../src/guestfs-actions.pod:7192
8581 msgid "(Added in 1.0.66)"
8582 msgstr ""
8583
8584 # type: =head2
8585 #. type: =head2
8586 #: ../src/guestfs-actions.pod:1365
8587 msgid "guestfs_egrepi"
8588 msgstr ""
8589
8590 # type: verbatim
8591 #. type: verbatim
8592 #: ../src/guestfs-actions.pod:1367
8593 #, no-wrap
8594 msgid ""
8595 " char **\n"
8596 " guestfs_egrepi (guestfs_h *g,\n"
8597 "                 const char *regex,\n"
8598 "                 const char *path);\n"
8599 "\n"
8600 msgstr ""
8601
8602 # type: textblock
8603 #. type: textblock
8604 #: ../src/guestfs-actions.pod:1372 ../fish/guestfish-actions.pod:910
8605 msgid ""
8606 "This calls the external C<egrep -i> program and returns the matching lines."
8607 msgstr ""
8608
8609 # type: =head2
8610 #. type: =head2
8611 #: ../src/guestfs-actions.pod:1384
8612 msgid "guestfs_equal"
8613 msgstr ""
8614
8615 # type: verbatim
8616 #. type: verbatim
8617 #: ../src/guestfs-actions.pod:1386
8618 #, no-wrap
8619 msgid ""
8620 " int\n"
8621 " guestfs_equal (guestfs_h *g,\n"
8622 "                const char *file1,\n"
8623 "                const char *file2);\n"
8624 "\n"
8625 msgstr ""
8626
8627 # type: textblock
8628 #. type: textblock
8629 #: ../src/guestfs-actions.pod:1391 ../fish/guestfish-actions.pod:920
8630 msgid ""
8631 "This compares the two files C<file1> and C<file2> and returns true if their "
8632 "content is exactly equal, or false otherwise."
8633 msgstr ""
8634
8635 # type: textblock
8636 #. type: textblock
8637 #: ../src/guestfs-actions.pod:1394 ../fish/guestfish-actions.pod:923
8638 msgid "The external L<cmp(1)> program is used for the comparison."
8639 msgstr ""
8640
8641 # type: =head2
8642 #. type: =head2
8643 #: ../src/guestfs-actions.pod:1400
8644 msgid "guestfs_exists"
8645 msgstr ""
8646
8647 # type: verbatim
8648 #. type: verbatim
8649 #: ../src/guestfs-actions.pod:1402
8650 #, no-wrap
8651 msgid ""
8652 " int\n"
8653 " guestfs_exists (guestfs_h *g,\n"
8654 "                 const char *path);\n"
8655 "\n"
8656 msgstr ""
8657
8658 # type: textblock
8659 #. type: textblock
8660 #: ../src/guestfs-actions.pod:1406 ../fish/guestfish-actions.pod:929
8661 msgid ""
8662 "This returns C<true> if and only if there is a file, directory (or anything) "
8663 "with the given C<path> name."
8664 msgstr ""
8665
8666 # type: textblock
8667 #. type: textblock
8668 #: ../src/guestfs-actions.pod:1409
8669 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
8670 msgstr ""
8671
8672 # type: =head2
8673 #. type: =head2
8674 #: ../src/guestfs-actions.pod:1415
8675 msgid "guestfs_fallocate"
8676 msgstr ""
8677
8678 # type: verbatim
8679 #. type: verbatim
8680 #: ../src/guestfs-actions.pod:1417
8681 #, no-wrap
8682 msgid ""
8683 " int\n"
8684 " guestfs_fallocate (guestfs_h *g,\n"
8685 "                    const char *path,\n"
8686 "                    int len);\n"
8687 "\n"
8688 msgstr ""
8689
8690 # type: textblock
8691 #. type: textblock
8692 #: ../src/guestfs-actions.pod:1422 ../src/guestfs-actions.pod:1448
8693 #: ../fish/guestfish-actions.pod:938 ../fish/guestfish-actions.pod:957
8694 msgid ""
8695 "This command preallocates a file (containing zero bytes) named C<path> of "
8696 "size C<len> bytes.  If the file exists already, it is overwritten."
8697 msgstr ""
8698
8699 # type: textblock
8700 #. type: textblock
8701 #: ../src/guestfs-actions.pod:1426 ../fish/guestfish-actions.pod:942
8702 msgid ""
8703 "Do not confuse this with the guestfish-specific C<alloc> command which "
8704 "allocates a file in the host and attaches it as a device."
8705 msgstr ""
8706
8707 #. type: textblock
8708 #: ../src/guestfs-actions.pod:1432
8709 msgid ""
8710 "This function is deprecated.  In new code, use the L</guestfs_fallocate64> "
8711 "call instead."
8712 msgstr ""
8713
8714 # type: =head2
8715 #. type: =head2
8716 #: ../src/guestfs-actions.pod:1441
8717 msgid "guestfs_fallocate64"
8718 msgstr ""
8719
8720 # type: verbatim
8721 #. type: verbatim
8722 #: ../src/guestfs-actions.pod:1443
8723 #, no-wrap
8724 msgid ""
8725 " int\n"
8726 " guestfs_fallocate64 (guestfs_h *g,\n"
8727 "                      const char *path,\n"
8728 "                      int64_t len);\n"
8729 "\n"
8730 msgstr ""
8731
8732 # type: textblock
8733 #. type: textblock
8734 #: ../src/guestfs-actions.pod:1452
8735 msgid ""
8736 "Note that this call allocates disk blocks for the file.  To create a sparse "
8737 "file use C<guestfs_truncate_size> instead."
8738 msgstr ""
8739
8740 # type: textblock
8741 #. type: textblock
8742 #: ../src/guestfs-actions.pod:1455
8743 msgid ""
8744 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
8745 "oversight it only allowed 30 bit lengths to be specified, effectively "
8746 "limiting the maximum size of files created through that call to 1GB."
8747 msgstr ""
8748
8749 # type: textblock
8750 #. type: textblock
8751 #: ../src/guestfs-actions.pod:1460 ../fish/guestfish-actions.pod:969
8752 msgid ""
8753 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
8754 "commands which create a file in the host and attach it as a device."
8755 msgstr ""
8756
8757 # type: textblock
8758 #. type: textblock
8759 #: ../src/guestfs-actions.pod:1466
8760 msgid "(Added in 1.3.17)"
8761 msgstr ""
8762
8763 # type: =head2
8764 #. type: =head2
8765 #: ../src/guestfs-actions.pod:1468
8766 msgid "guestfs_fgrep"
8767 msgstr ""
8768
8769 # type: verbatim
8770 #. type: verbatim
8771 #: ../src/guestfs-actions.pod:1470
8772 #, no-wrap
8773 msgid ""
8774 " char **\n"
8775 " guestfs_fgrep (guestfs_h *g,\n"
8776 "                const char *pattern,\n"
8777 "                const char *path);\n"
8778 "\n"
8779 msgstr ""
8780
8781 # type: textblock
8782 #. type: textblock
8783 #: ../src/guestfs-actions.pod:1475 ../fish/guestfish-actions.pod:977
8784 msgid ""
8785 "This calls the external C<fgrep> program and returns the matching lines."
8786 msgstr ""
8787
8788 # type: =head2
8789 #. type: =head2
8790 #: ../src/guestfs-actions.pod:1487
8791 msgid "guestfs_fgrepi"
8792 msgstr ""
8793
8794 # type: verbatim
8795 #. type: verbatim
8796 #: ../src/guestfs-actions.pod:1489
8797 #, no-wrap
8798 msgid ""
8799 " char **\n"
8800 " guestfs_fgrepi (guestfs_h *g,\n"
8801 "                 const char *pattern,\n"
8802 "                 const char *path);\n"
8803 "\n"
8804 msgstr ""
8805
8806 # type: textblock
8807 #. type: textblock
8808 #: ../src/guestfs-actions.pod:1494 ../fish/guestfish-actions.pod:987
8809 msgid ""
8810 "This calls the external C<fgrep -i> program and returns the matching lines."
8811 msgstr ""
8812
8813 # type: =head2
8814 #. type: =head2
8815 #: ../src/guestfs-actions.pod:1506
8816 msgid "guestfs_file"
8817 msgstr ""
8818
8819 # type: verbatim
8820 #. type: verbatim
8821 #: ../src/guestfs-actions.pod:1508
8822 #, no-wrap
8823 msgid ""
8824 " char *\n"
8825 " guestfs_file (guestfs_h *g,\n"
8826 "               const char *path);\n"
8827 "\n"
8828 msgstr ""
8829
8830 # type: textblock
8831 #. type: textblock
8832 #: ../src/guestfs-actions.pod:1512 ../fish/guestfish-actions.pod:997
8833 msgid ""
8834 "This call uses the standard L<file(1)> command to determine the type or "
8835 "contents of the file."
8836 msgstr ""
8837
8838 # type: textblock
8839 #. type: textblock
8840 #: ../src/guestfs-actions.pod:1515 ../fish/guestfish-actions.pod:1000
8841 msgid ""
8842 "This call will also transparently look inside various types of compressed "
8843 "file."
8844 msgstr ""
8845
8846 # type: textblock
8847 #. type: textblock
8848 #: ../src/guestfs-actions.pod:1518 ../fish/guestfish-actions.pod:1003
8849 msgid ""
8850 "The exact command which runs is C<file -zb path>.  Note in particular that "
8851 "the filename is not prepended to the output (the C<-b> option)."
8852 msgstr ""
8853
8854 #. type: textblock
8855 #: ../src/guestfs-actions.pod:1522 ../fish/guestfish-actions.pod:1007
8856 msgid ""
8857 "The output depends on the output of the underlying L<file(1)> command and it "
8858 "can change in future in ways beyond our control.  In other words, the output "
8859 "is not guaranteed by the ABI."
8860 msgstr ""
8861
8862 #. type: textblock
8863 #: ../src/guestfs-actions.pod:1526
8864 msgid ""
8865 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
8866 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc)."
8867 msgstr ""
8868
8869 # type: =head2
8870 #. type: =head2
8871 #: ../src/guestfs-actions.pod:1534
8872 msgid "guestfs_file_architecture"
8873 msgstr ""
8874
8875 # type: verbatim
8876 #. type: verbatim
8877 #: ../src/guestfs-actions.pod:1536
8878 #, no-wrap
8879 msgid ""
8880 " char *\n"
8881 " guestfs_file_architecture (guestfs_h *g,\n"
8882 "                            const char *filename);\n"
8883 "\n"
8884 msgstr ""
8885
8886 # type: textblock
8887 #. type: textblock
8888 #: ../src/guestfs-actions.pod:1540 ../fish/guestfish-actions.pod:1018
8889 msgid ""
8890 "This detects the architecture of the binary C<filename>, and returns it if "
8891 "known."
8892 msgstr ""
8893
8894 # type: textblock
8895 #. type: textblock
8896 #: ../src/guestfs-actions.pod:1543 ../fish/guestfish-actions.pod:1021
8897 msgid "Currently defined architectures are:"
8898 msgstr ""
8899
8900 # type: =item
8901 #. type: =item
8902 #: ../src/guestfs-actions.pod:1547 ../fish/guestfish-actions.pod:1025
8903 msgid "\"i386\""
8904 msgstr ""
8905
8906 # type: textblock
8907 #. type: textblock
8908 #: ../src/guestfs-actions.pod:1549 ../fish/guestfish-actions.pod:1027
8909 msgid ""
8910 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
8911 "irrespective of the precise processor requirements of the binary."
8912 msgstr ""
8913
8914 # type: =item
8915 #. type: =item
8916 #: ../src/guestfs-actions.pod:1552 ../fish/guestfish-actions.pod:1030
8917 msgid "\"x86_64\""
8918 msgstr ""
8919
8920 # type: textblock
8921 #. type: textblock
8922 #: ../src/guestfs-actions.pod:1554 ../fish/guestfish-actions.pod:1032
8923 msgid "64 bit x86-64."
8924 msgstr ""
8925
8926 # type: =item
8927 #. type: =item
8928 #: ../src/guestfs-actions.pod:1556 ../fish/guestfish-actions.pod:1034
8929 msgid "\"sparc\""
8930 msgstr ""
8931
8932 # type: textblock
8933 #. type: textblock
8934 #: ../src/guestfs-actions.pod:1558 ../fish/guestfish-actions.pod:1036
8935 msgid "32 bit SPARC."
8936 msgstr ""
8937
8938 # type: =item
8939 #. type: =item
8940 #: ../src/guestfs-actions.pod:1560 ../fish/guestfish-actions.pod:1038
8941 msgid "\"sparc64\""
8942 msgstr ""
8943
8944 # type: textblock
8945 #. type: textblock
8946 #: ../src/guestfs-actions.pod:1562 ../fish/guestfish-actions.pod:1040
8947 msgid "64 bit SPARC V9 and above."
8948 msgstr ""
8949
8950 # type: =item
8951 #. type: =item
8952 #: ../src/guestfs-actions.pod:1564 ../fish/guestfish-actions.pod:1042
8953 msgid "\"ia64\""
8954 msgstr ""
8955
8956 # type: textblock
8957 #. type: textblock
8958 #: ../src/guestfs-actions.pod:1566 ../fish/guestfish-actions.pod:1044
8959 msgid "Intel Itanium."
8960 msgstr ""
8961
8962 # type: =item
8963 #. type: =item
8964 #: ../src/guestfs-actions.pod:1568 ../fish/guestfish-actions.pod:1046
8965 msgid "\"ppc\""
8966 msgstr ""
8967
8968 # type: textblock
8969 #. type: textblock
8970 #: ../src/guestfs-actions.pod:1570 ../fish/guestfish-actions.pod:1048
8971 msgid "32 bit Power PC."
8972 msgstr ""
8973
8974 # type: =item
8975 #. type: =item
8976 #: ../src/guestfs-actions.pod:1572 ../fish/guestfish-actions.pod:1050
8977 msgid "\"ppc64\""
8978 msgstr ""
8979
8980 # type: textblock
8981 #. type: textblock
8982 #: ../src/guestfs-actions.pod:1574 ../fish/guestfish-actions.pod:1052
8983 msgid "64 bit Power PC."
8984 msgstr ""
8985
8986 # type: textblock
8987 #. type: textblock
8988 #: ../src/guestfs-actions.pod:1578 ../fish/guestfish-actions.pod:1056
8989 msgid "Libguestfs may return other architecture strings in future."
8990 msgstr ""
8991
8992 # type: textblock
8993 #. type: textblock
8994 #: ../src/guestfs-actions.pod:1580 ../fish/guestfish-actions.pod:1058
8995 msgid "The function works on at least the following types of files:"
8996 msgstr ""
8997
8998 # type: textblock
8999 #. type: textblock
9000 #: ../src/guestfs-actions.pod:1586 ../fish/guestfish-actions.pod:1064
9001 msgid "many types of Un*x and Linux binary"
9002 msgstr ""
9003
9004 # type: textblock
9005 #. type: textblock
9006 #: ../src/guestfs-actions.pod:1590 ../fish/guestfish-actions.pod:1068
9007 msgid "many types of Un*x and Linux shared library"
9008 msgstr ""
9009
9010 # type: textblock
9011 #. type: textblock
9012 #: ../src/guestfs-actions.pod:1594 ../fish/guestfish-actions.pod:1072
9013 msgid "Windows Win32 and Win64 binaries"
9014 msgstr ""
9015
9016 # type: textblock
9017 #. type: textblock
9018 #: ../src/guestfs-actions.pod:1598 ../fish/guestfish-actions.pod:1076
9019 msgid "Windows Win32 and Win64 DLLs"
9020 msgstr ""
9021
9022 # type: textblock
9023 #. type: textblock
9024 #: ../src/guestfs-actions.pod:1600 ../fish/guestfish-actions.pod:1078
9025 msgid "Win32 binaries and DLLs return C<i386>."
9026 msgstr ""
9027
9028 # type: textblock
9029 #. type: textblock
9030 #: ../src/guestfs-actions.pod:1602 ../fish/guestfish-actions.pod:1080
9031 msgid "Win64 binaries and DLLs return C<x86_64>."
9032 msgstr ""
9033
9034 # type: textblock
9035 #. type: textblock
9036 #: ../src/guestfs-actions.pod:1606 ../fish/guestfish-actions.pod:1084
9037 msgid "Linux kernel modules"
9038 msgstr ""
9039
9040 # type: textblock
9041 #. type: textblock
9042 #: ../src/guestfs-actions.pod:1610 ../fish/guestfish-actions.pod:1088
9043 msgid "Linux new-style initrd images"
9044 msgstr ""
9045
9046 # type: textblock
9047 #. type: textblock
9048 #: ../src/guestfs-actions.pod:1614 ../fish/guestfish-actions.pod:1092
9049 msgid "some non-x86 Linux vmlinuz kernels"
9050 msgstr ""
9051
9052 # type: textblock
9053 #. type: textblock
9054 #: ../src/guestfs-actions.pod:1618 ../fish/guestfish-actions.pod:1096
9055 msgid "What it can't do currently:"
9056 msgstr ""
9057
9058 # type: textblock
9059 #. type: textblock
9060 #: ../src/guestfs-actions.pod:1624 ../fish/guestfish-actions.pod:1102
9061 msgid "static libraries (libfoo.a)"
9062 msgstr ""
9063
9064 # type: textblock
9065 #. type: textblock
9066 #: ../src/guestfs-actions.pod:1628 ../fish/guestfish-actions.pod:1106
9067 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9068 msgstr ""
9069
9070 # type: textblock
9071 #. type: textblock
9072 #: ../src/guestfs-actions.pod:1632 ../fish/guestfish-actions.pod:1110
9073 msgid "x86 Linux vmlinuz kernels"
9074 msgstr ""
9075
9076 # type: textblock
9077 #. type: textblock
9078 #: ../src/guestfs-actions.pod:1634 ../fish/guestfish-actions.pod:1112
9079 msgid ""
9080 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9081 "compressed code, and are horribly hard to unpack.  If you want to find the "
9082 "architecture of a kernel, use the architecture of the associated initrd or "
9083 "kernel module(s) instead."
9084 msgstr ""
9085
9086 # type: textblock
9087 #. type: textblock
9088 #: ../src/guestfs-actions.pod:1644 ../src/guestfs-actions.pod:1807
9089 #: ../src/guestfs-actions.pod:1824 ../src/guestfs-actions.pod:2505
9090 #: ../src/guestfs-actions.pod:2586 ../src/guestfs-actions.pod:2612
9091 #: ../src/guestfs-actions.pod:2661 ../src/guestfs-actions.pod:2682
9092 #: ../src/guestfs-actions.pod:2719 ../src/guestfs-actions.pod:2803
9093 #: ../src/guestfs-actions.pod:2865 ../src/guestfs-actions.pod:3038
9094 #: ../src/guestfs-actions.pod:3170
9095 msgid "(Added in 1.5.3)"
9096 msgstr ""
9097
9098 # type: =head2
9099 #. type: =head2
9100 #: ../src/guestfs-actions.pod:1646
9101 msgid "guestfs_filesize"
9102 msgstr ""
9103
9104 # type: verbatim
9105 #. type: verbatim
9106 #: ../src/guestfs-actions.pod:1648
9107 #, no-wrap
9108 msgid ""
9109 " int64_t\n"
9110 " guestfs_filesize (guestfs_h *g,\n"
9111 "                   const char *file);\n"
9112 "\n"
9113 msgstr ""
9114
9115 # type: textblock
9116 #. type: textblock
9117 #: ../src/guestfs-actions.pod:1652 ../fish/guestfish-actions.pod:1123
9118 msgid "This command returns the size of C<file> in bytes."
9119 msgstr ""
9120
9121 # type: textblock
9122 #. type: textblock
9123 #: ../src/guestfs-actions.pod:1654
9124 msgid ""
9125 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9126 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9127 "devices, use C<guestfs_blockdev_getsize64>."
9128 msgstr ""
9129
9130 # type: textblock
9131 #. type: textblock
9132 #: ../src/guestfs-actions.pod:1660
9133 msgid "(Added in 1.0.82)"
9134 msgstr ""
9135
9136 # type: =head2
9137 #. type: =head2
9138 #: ../src/guestfs-actions.pod:1662
9139 msgid "guestfs_fill"
9140 msgstr ""
9141
9142 # type: verbatim
9143 #. type: verbatim
9144 #: ../src/guestfs-actions.pod:1664
9145 #, no-wrap
9146 msgid ""
9147 " int\n"
9148 " guestfs_fill (guestfs_h *g,\n"
9149 "               int c,\n"
9150 "               int len,\n"
9151 "               const char *path);\n"
9152 "\n"
9153 msgstr ""
9154
9155 # type: textblock
9156 #. type: textblock
9157 #: ../src/guestfs-actions.pod:1670 ../fish/guestfish-actions.pod:1133
9158 msgid ""
9159 "This command creates a new file called C<path>.  The initial content of the "
9160 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9161 "[0..255]>."
9162 msgstr ""
9163
9164 # type: textblock
9165 #. type: textblock
9166 #: ../src/guestfs-actions.pod:1674
9167 msgid ""
9168 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9169 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9170 "bytes use C<guestfs_fill_pattern>."
9171 msgstr ""
9172
9173 # type: textblock
9174 #. type: textblock
9175 #: ../src/guestfs-actions.pod:1686
9176 msgid "(Added in 1.0.79)"
9177 msgstr ""
9178
9179 # type: =head2
9180 #. type: =head2
9181 #: ../src/guestfs-actions.pod:1688
9182 msgid "guestfs_fill_pattern"
9183 msgstr ""
9184
9185 # type: verbatim
9186 #. type: verbatim
9187 #: ../src/guestfs-actions.pod:1690
9188 #, no-wrap
9189 msgid ""
9190 " int\n"
9191 " guestfs_fill_pattern (guestfs_h *g,\n"
9192 "                       const char *pattern,\n"
9193 "                       int len,\n"
9194 "                       const char *path);\n"
9195 "\n"
9196 msgstr ""
9197
9198 # type: textblock
9199 #. type: textblock
9200 #: ../src/guestfs-actions.pod:1696
9201 msgid ""
9202 "This function is like C<guestfs_fill> except that it creates a new file of "
9203 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9204 "pattern is truncated if necessary to ensure the length of the file is "
9205 "exactly C<len> bytes."
9206 msgstr ""
9207
9208 # type: textblock
9209 #. type: textblock
9210 #: ../src/guestfs-actions.pod:1708
9211 msgid "(Added in 1.3.12)"
9212 msgstr ""
9213
9214 # type: =head2
9215 #. type: =head2
9216 #: ../src/guestfs-actions.pod:1710
9217 msgid "guestfs_find"
9218 msgstr ""
9219
9220 # type: verbatim
9221 #. type: verbatim
9222 #: ../src/guestfs-actions.pod:1712
9223 #, no-wrap
9224 msgid ""
9225 " char **\n"
9226 " guestfs_find (guestfs_h *g,\n"
9227 "               const char *directory);\n"
9228 "\n"
9229 msgstr ""
9230
9231 # type: textblock
9232 #. type: textblock
9233 #: ../src/guestfs-actions.pod:1716 ../fish/guestfish-actions.pod:1155
9234 msgid ""
9235 "This command lists out all files and directories, recursively, starting at "
9236 "C<directory>.  It is essentially equivalent to running the shell command "
9237 "C<find directory -print> but some post-processing happens on the output, "
9238 "described below."
9239 msgstr ""
9240
9241 # type: textblock
9242 #. type: textblock
9243 #: ../src/guestfs-actions.pod:1721 ../fish/guestfish-actions.pod:1160
9244 msgid ""
9245 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9246 "structure was:"
9247 msgstr ""
9248
9249 # type: verbatim
9250 #. type: verbatim
9251 #: ../src/guestfs-actions.pod:1724 ../fish/guestfish-actions.pod:1163
9252 #, no-wrap
9253 msgid ""
9254 " /tmp/a\n"
9255 " /tmp/b\n"
9256 " /tmp/c/d\n"
9257 "\n"
9258 msgstr ""
9259
9260 # type: textblock
9261 #. type: textblock
9262 #: ../src/guestfs-actions.pod:1728
9263 msgid ""
9264 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
9265 msgstr ""
9266
9267 # type: verbatim
9268 #. type: verbatim
9269 #: ../src/guestfs-actions.pod:1731 ../fish/guestfish-actions.pod:1170
9270 #, no-wrap
9271 msgid ""
9272 " a\n"
9273 " b\n"
9274 " c\n"
9275 " c/d\n"
9276 "\n"
9277 msgstr ""
9278
9279 # type: textblock
9280 #. type: textblock
9281 #: ../src/guestfs-actions.pod:1736 ../fish/guestfish-actions.pod:1175
9282 msgid "If C<directory> is not a directory, then this command returns an error."
9283 msgstr ""
9284
9285 # type: textblock
9286 #. type: textblock
9287 #: ../src/guestfs-actions.pod:1739 ../fish/guestfish-actions.pod:1178
9288 msgid "The returned list is sorted."
9289 msgstr ""
9290
9291 # type: textblock
9292 #. type: textblock
9293 #: ../src/guestfs-actions.pod:1741
9294 msgid "See also C<guestfs_find0>."
9295 msgstr ""
9296
9297 # type: textblock
9298 #. type: textblock
9299 #: ../src/guestfs-actions.pod:1750 ../src/guestfs-actions.pod:3859
9300 #: ../src/guestfs-actions.pod:5399
9301 msgid "(Added in 1.0.27)"
9302 msgstr ""
9303
9304 # type: =head2
9305 #. type: =head2
9306 #: ../src/guestfs-actions.pod:1752
9307 msgid "guestfs_find0"
9308 msgstr ""
9309
9310 # type: verbatim
9311 #. type: verbatim
9312 #: ../src/guestfs-actions.pod:1754
9313 #, no-wrap
9314 msgid ""
9315 " int\n"
9316 " guestfs_find0 (guestfs_h *g,\n"
9317 "                const char *directory,\n"
9318 "                const char *files);\n"
9319 "\n"
9320 msgstr ""
9321
9322 # type: textblock
9323 #. type: textblock
9324 #: ../src/guestfs-actions.pod:1759 ../fish/guestfish-actions.pod:1189
9325 msgid ""
9326 "This command lists out all files and directories, recursively, starting at "
9327 "C<directory>, placing the resulting list in the external file called "
9328 "C<files>."
9329 msgstr ""
9330
9331 # type: textblock
9332 #. type: textblock
9333 #: ../src/guestfs-actions.pod:1763
9334 msgid ""
9335 "This command works the same way as C<guestfs_find> with the following "
9336 "exceptions:"
9337 msgstr ""
9338
9339 # type: textblock
9340 #. type: textblock
9341 #: ../src/guestfs-actions.pod:1770 ../fish/guestfish-actions.pod:1200
9342 msgid "The resulting list is written to an external file."
9343 msgstr ""
9344
9345 # type: textblock
9346 #. type: textblock
9347 #: ../src/guestfs-actions.pod:1774 ../fish/guestfish-actions.pod:1204
9348 msgid ""
9349 "Items (filenames) in the result are separated by C<\\0> characters.  See "
9350 "L<find(1)> option I<-print0>."
9351 msgstr ""
9352
9353 # type: textblock
9354 #. type: textblock
9355 #: ../src/guestfs-actions.pod:1779 ../fish/guestfish-actions.pod:1209
9356 msgid "This command is not limited in the number of names that it can return."
9357 msgstr ""
9358
9359 # type: textblock
9360 #. type: textblock
9361 #: ../src/guestfs-actions.pod:1784 ../fish/guestfish-actions.pod:1214
9362 msgid "The result list is not sorted."
9363 msgstr ""
9364
9365 # type: textblock
9366 #. type: textblock
9367 #: ../src/guestfs-actions.pod:1790
9368 msgid "(Added in 1.0.74)"
9369 msgstr ""
9370
9371 # type: =head2
9372 #. type: =head2
9373 #: ../src/guestfs-actions.pod:1792
9374 msgid "guestfs_findfs_label"
9375 msgstr ""
9376
9377 # type: verbatim
9378 #. type: verbatim
9379 #: ../src/guestfs-actions.pod:1794
9380 #, no-wrap
9381 msgid ""
9382 " char *\n"
9383 " guestfs_findfs_label (guestfs_h *g,\n"
9384 "                       const char *label);\n"
9385 "\n"
9386 msgstr ""
9387
9388 # type: textblock
9389 #. type: textblock
9390 #: ../src/guestfs-actions.pod:1798 ../fish/guestfish-actions.pod:1224
9391 msgid ""
9392 "This command searches the filesystems and returns the one which has the "
9393 "given label.  An error is returned if no such filesystem can be found."
9394 msgstr ""
9395
9396 # type: textblock
9397 #. type: textblock
9398 #: ../src/guestfs-actions.pod:1802
9399 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
9400 msgstr ""
9401
9402 # type: =head2
9403 #. type: =head2
9404 #: ../src/guestfs-actions.pod:1809
9405 msgid "guestfs_findfs_uuid"
9406 msgstr ""
9407
9408 # type: verbatim
9409 #. type: verbatim
9410 #: ../src/guestfs-actions.pod:1811
9411 #, no-wrap
9412 msgid ""
9413 " char *\n"
9414 " guestfs_findfs_uuid (guestfs_h *g,\n"
9415 "                      const char *uuid);\n"
9416 "\n"
9417 msgstr ""
9418
9419 # type: textblock
9420 #. type: textblock
9421 #: ../src/guestfs-actions.pod:1815 ../fish/guestfish-actions.pod:1234
9422 msgid ""
9423 "This command searches the filesystems and returns the one which has the "
9424 "given UUID.  An error is returned if no such filesystem can be found."
9425 msgstr ""
9426
9427 # type: textblock
9428 #. type: textblock
9429 #: ../src/guestfs-actions.pod:1819
9430 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
9431 msgstr ""
9432
9433 # type: =head2
9434 #. type: =head2
9435 #: ../src/guestfs-actions.pod:1826
9436 msgid "guestfs_fsck"
9437 msgstr ""
9438
9439 # type: verbatim
9440 #. type: verbatim
9441 #: ../src/guestfs-actions.pod:1828
9442 #, no-wrap
9443 msgid ""
9444 " int\n"
9445 " guestfs_fsck (guestfs_h *g,\n"
9446 "               const char *fstype,\n"
9447 "               const char *device);\n"
9448 "\n"
9449 msgstr ""
9450
9451 # type: textblock
9452 #. type: textblock
9453 #: ../src/guestfs-actions.pod:1833 ../fish/guestfish-actions.pod:1244
9454 msgid ""
9455 "This runs the filesystem checker (fsck) on C<device> which should have "
9456 "filesystem type C<fstype>."
9457 msgstr ""
9458
9459 # type: textblock
9460 #. type: textblock
9461 #: ../src/guestfs-actions.pod:1836 ../fish/guestfish-actions.pod:1247
9462 msgid ""
9463 "The returned integer is the status.  See L<fsck(8)> for the list of status "
9464 "codes from C<fsck>."
9465 msgstr ""
9466
9467 # type: textblock
9468 #. type: textblock
9469 #: ../src/guestfs-actions.pod:1845 ../fish/guestfish-actions.pod:1256
9470 msgid "Multiple status codes can be summed together."
9471 msgstr ""
9472
9473 # type: textblock
9474 #. type: textblock
9475 #: ../src/guestfs-actions.pod:1849 ../fish/guestfish-actions.pod:1260
9476 msgid ""
9477 "A non-zero return code can mean \"success\", for example if errors have been "
9478 "corrected on the filesystem."
9479 msgstr ""
9480
9481 # type: textblock
9482 #. type: textblock
9483 #: ../src/guestfs-actions.pod:1854 ../fish/guestfish-actions.pod:1265
9484 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
9485 msgstr ""
9486
9487 # type: textblock
9488 #. type: textblock
9489 #: ../src/guestfs-actions.pod:1859 ../fish/guestfish-actions.pod:1270
9490 msgid ""
9491 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
9492 msgstr ""
9493
9494 # type: textblock
9495 #. type: textblock
9496 #: ../src/guestfs-actions.pod:1863 ../src/guestfs-actions.pod:7046
9497 msgid "(Added in 1.0.16)"
9498 msgstr ""
9499
9500 # type: =head2
9501 #. type: =head2
9502 #: ../src/guestfs-actions.pod:1865
9503 msgid "guestfs_get_append"
9504 msgstr ""
9505
9506 # type: verbatim
9507 #. type: verbatim
9508 #: ../src/guestfs-actions.pod:1867
9509 #, no-wrap
9510 msgid ""
9511 " const char *\n"
9512 " guestfs_get_append (guestfs_h *g);\n"
9513 "\n"
9514 msgstr ""
9515
9516 # type: textblock
9517 #. type: textblock
9518 #: ../src/guestfs-actions.pod:1870 ../fish/guestfish-actions.pod:1276
9519 msgid ""
9520 "Return the additional kernel options which are added to the guest kernel "
9521 "command line."
9522 msgstr ""
9523
9524 # type: textblock
9525 #. type: textblock
9526 #: ../src/guestfs-actions.pod:1873 ../fish/guestfish-actions.pod:1279
9527 msgid "If C<NULL> then no options are added."
9528 msgstr ""
9529
9530 # type: textblock
9531 #. type: textblock
9532 #: ../src/guestfs-actions.pod:1875
9533 msgid ""
9534 "This function returns a string which may be NULL.  There is no way to return "
9535 "an error from this function.  The string is owned by the guest handle and "
9536 "must I<not> be freed."
9537 msgstr ""
9538
9539 # type: textblock
9540 #. type: textblock
9541 #: ../src/guestfs-actions.pod:1879 ../src/guestfs-actions.pod:5077
9542 #: ../src/guestfs-actions.pod:5540 ../src/guestfs-actions.pod:5908
9543 #: ../src/guestfs-actions.pod:5927 ../src/guestfs-actions.pod:5943
9544 #: ../src/guestfs-actions.pod:5960 ../src/guestfs-actions.pod:6717
9545 #: ../src/guestfs-actions.pod:6735 ../src/guestfs-actions.pod:7089
9546 msgid "(Added in 1.0.26)"
9547 msgstr ""
9548
9549 # type: =head2
9550 #. type: =head2
9551 #: ../src/guestfs-actions.pod:1881
9552 msgid "guestfs_get_autosync"
9553 msgstr ""
9554
9555 # type: verbatim
9556 #. type: verbatim
9557 #: ../src/guestfs-actions.pod:1883
9558 #, no-wrap
9559 msgid ""
9560 " int\n"
9561 " guestfs_get_autosync (guestfs_h *g);\n"
9562 "\n"
9563 msgstr ""
9564
9565 # type: textblock
9566 #. type: textblock
9567 #: ../src/guestfs-actions.pod:1886 ../fish/guestfish-actions.pod:1285
9568 msgid "Get the autosync flag."
9569 msgstr ""
9570
9571 # type: =head2
9572 #. type: =head2
9573 #: ../src/guestfs-actions.pod:1892
9574 msgid "guestfs_get_direct"
9575 msgstr ""
9576
9577 # type: verbatim
9578 #. type: verbatim
9579 #: ../src/guestfs-actions.pod:1894
9580 #, no-wrap
9581 msgid ""
9582 " int\n"
9583 " guestfs_get_direct (guestfs_h *g);\n"
9584 "\n"
9585 msgstr ""
9586
9587 # type: textblock
9588 #. type: textblock
9589 #: ../src/guestfs-actions.pod:1897 ../fish/guestfish-actions.pod:1291
9590 msgid "Return the direct appliance mode flag."
9591 msgstr ""
9592
9593 # type: textblock
9594 #. type: textblock
9595 #: ../src/guestfs-actions.pod:1901 ../src/guestfs-actions.pod:5581
9596 msgid "(Added in 1.0.72)"
9597 msgstr ""
9598
9599 # type: =head2
9600 #. type: =head2
9601 #: ../src/guestfs-actions.pod:1903
9602 msgid "guestfs_get_e2label"
9603 msgstr ""
9604
9605 # type: verbatim
9606 #. type: verbatim
9607 #: ../src/guestfs-actions.pod:1905
9608 #, no-wrap
9609 msgid ""
9610 " char *\n"
9611 " guestfs_get_e2label (guestfs_h *g,\n"
9612 "                      const char *device);\n"
9613 "\n"
9614 msgstr ""
9615
9616 # type: textblock
9617 #. type: textblock
9618 #: ../src/guestfs-actions.pod:1909 ../fish/guestfish-actions.pod:1297
9619 msgid ""
9620 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
9621 msgstr ""
9622
9623 #. type: textblock
9624 #: ../src/guestfs-actions.pod:1915
9625 msgid ""
9626 "This function is deprecated.  In new code, use the L</guestfs_vfs_label> "
9627 "call instead."
9628 msgstr ""
9629
9630 # type: textblock
9631 #. type: textblock
9632 #: ../src/guestfs-actions.pod:1922 ../src/guestfs-actions.pod:1943
9633 #: ../src/guestfs-actions.pod:5599 ../src/guestfs-actions.pod:5618
9634 msgid "(Added in 1.0.15)"
9635 msgstr ""
9636
9637 # type: =head2
9638 #. type: =head2
9639 #: ../src/guestfs-actions.pod:1924
9640 msgid "guestfs_get_e2uuid"
9641 msgstr ""
9642
9643 # type: verbatim
9644 #. type: verbatim
9645 #: ../src/guestfs-actions.pod:1926
9646 #, no-wrap
9647 msgid ""
9648 " char *\n"
9649 " guestfs_get_e2uuid (guestfs_h *g,\n"
9650 "                     const char *device);\n"
9651 "\n"
9652 msgstr ""
9653
9654 # type: textblock
9655 #. type: textblock
9656 #: ../src/guestfs-actions.pod:1930 ../fish/guestfish-actions.pod:1311
9657 msgid ""
9658 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
9659 msgstr ""
9660
9661 #. type: textblock
9662 #: ../src/guestfs-actions.pod:1936
9663 msgid ""
9664 "This function is deprecated.  In new code, use the L</guestfs_vfs_uuid> call "
9665 "instead."
9666 msgstr ""
9667
9668 # type: =head2
9669 #. type: =head2
9670 #: ../src/guestfs-actions.pod:1945
9671 msgid "guestfs_get_memsize"
9672 msgstr ""
9673
9674 # type: verbatim
9675 #. type: verbatim
9676 #: ../src/guestfs-actions.pod:1947
9677 #, no-wrap
9678 msgid ""
9679 " int\n"
9680 " guestfs_get_memsize (guestfs_h *g);\n"
9681 "\n"
9682 msgstr ""
9683
9684 # type: textblock
9685 #. type: textblock
9686 #: ../src/guestfs-actions.pod:1950 ../fish/guestfish-actions.pod:1325
9687 msgid ""
9688 "This gets the memory size in megabytes allocated to the qemu subprocess."
9689 msgstr ""
9690
9691 # type: textblock
9692 #. type: textblock
9693 #: ../src/guestfs-actions.pod:1953
9694 msgid ""
9695 "If C<guestfs_set_memsize> was not called on this handle, and if "
9696 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
9697 "value for memsize."
9698 msgstr ""
9699
9700 # type: textblock
9701 #. type: textblock
9702 #: ../src/guestfs-actions.pod:1957 ../src/guestfs-actions.pod:2038
9703 #: ../src/guestfs-actions.pod:5634 ../src/guestfs-actions.pod:5741
9704 #: ../fish/guestfish-actions.pod:1332 ../fish/guestfish-actions.pod:1383
9705 #: ../fish/guestfish-actions.pod:3761 ../fish/guestfish-actions.pod:3848
9706 msgid ""
9707 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
9708 msgstr ""
9709
9710 # type: textblock
9711 #. type: textblock
9712 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:4150
9713 #: ../src/guestfs-actions.pod:4335 ../src/guestfs-actions.pod:4354
9714 #: ../src/guestfs-actions.pod:4373 ../src/guestfs-actions.pod:4385
9715 #: ../src/guestfs-actions.pod:4402 ../src/guestfs-actions.pod:4415
9716 #: ../src/guestfs-actions.pod:5302 ../src/guestfs-actions.pod:5639
9717 #: ../src/guestfs-actions.pod:5882 ../src/guestfs-actions.pod:6483
9718 msgid "(Added in 1.0.55)"
9719 msgstr ""
9720
9721 # type: =head2
9722 #. type: =head2
9723 #: ../src/guestfs-actions.pod:1964
9724 msgid "guestfs_get_network"
9725 msgstr ""
9726
9727 # type: verbatim
9728 #. type: verbatim
9729 #: ../src/guestfs-actions.pod:1966
9730 #, no-wrap
9731 msgid ""
9732 " int\n"
9733 " guestfs_get_network (guestfs_h *g);\n"
9734 "\n"
9735 msgstr ""
9736
9737 # type: textblock
9738 #. type: textblock
9739 #: ../src/guestfs-actions.pod:1969 ../fish/guestfish-actions.pod:1339
9740 msgid "This returns the enable network flag."
9741 msgstr ""
9742
9743 # type: textblock
9744 #. type: textblock
9745 #: ../src/guestfs-actions.pod:1973 ../src/guestfs-actions.pod:5658
9746 msgid "(Added in 1.5.4)"
9747 msgstr ""
9748
9749 # type: =head2
9750 #. type: =head2
9751 #: ../src/guestfs-actions.pod:1975
9752 msgid "guestfs_get_path"
9753 msgstr ""
9754
9755 # type: verbatim
9756 #. type: verbatim
9757 #: ../src/guestfs-actions.pod:1977
9758 #, no-wrap
9759 msgid ""
9760 " const char *\n"
9761 " guestfs_get_path (guestfs_h *g);\n"
9762 "\n"
9763 msgstr ""
9764
9765 # type: textblock
9766 #. type: textblock
9767 #: ../src/guestfs-actions.pod:1980 ../fish/guestfish-actions.pod:1345
9768 msgid "Return the current search path."
9769 msgstr ""
9770
9771 # type: textblock
9772 #. type: textblock
9773 #: ../src/guestfs-actions.pod:1982 ../fish/guestfish-actions.pod:1347
9774 msgid ""
9775 "This is always non-NULL.  If it wasn't set already, then this will return "
9776 "the default path."
9777 msgstr ""
9778
9779 # type: textblock
9780 #. type: textblock
9781 #: ../src/guestfs-actions.pod:1985 ../src/guestfs-actions.pod:2014
9782 msgid ""
9783 "This function returns a string, or NULL on error.  The string is owned by "
9784 "the guest handle and must I<not> be freed."
9785 msgstr ""
9786
9787 # type: =head2
9788 #. type: =head2
9789 #: ../src/guestfs-actions.pod:1990
9790 msgid "guestfs_get_pid"
9791 msgstr ""
9792
9793 # type: verbatim
9794 #. type: verbatim
9795 #: ../src/guestfs-actions.pod:1992
9796 #, no-wrap
9797 msgid ""
9798 " int\n"
9799 " guestfs_get_pid (guestfs_h *g);\n"
9800 "\n"
9801 msgstr ""
9802
9803 # type: textblock
9804 #. type: textblock
9805 #: ../src/guestfs-actions.pod:1995 ../fish/guestfish-actions.pod:1356
9806 msgid ""
9807 "Return the process ID of the qemu subprocess.  If there is no qemu "
9808 "subprocess, then this will return an error."
9809 msgstr ""
9810
9811 # type: textblock
9812 #. type: textblock
9813 #: ../src/guestfs-actions.pod:1998 ../fish/guestfish-actions.pod:1359
9814 msgid "This is an internal call used for debugging and testing."
9815 msgstr ""
9816
9817 # type: textblock
9818 #. type: textblock
9819 #: ../src/guestfs-actions.pod:2002
9820 msgid "(Added in 1.0.56)"
9821 msgstr ""
9822
9823 # type: =head2
9824 #. type: =head2
9825 #: ../src/guestfs-actions.pod:2004
9826 msgid "guestfs_get_qemu"
9827 msgstr ""
9828
9829 # type: verbatim
9830 #. type: verbatim
9831 #: ../src/guestfs-actions.pod:2006
9832 #, no-wrap
9833 msgid ""
9834 " const char *\n"
9835 " guestfs_get_qemu (guestfs_h *g);\n"
9836 "\n"
9837 msgstr ""
9838
9839 # type: textblock
9840 #. type: textblock
9841 #: ../src/guestfs-actions.pod:2009 ../fish/guestfish-actions.pod:1365
9842 msgid "Return the current qemu binary."
9843 msgstr ""
9844
9845 # type: textblock
9846 #. type: textblock
9847 #: ../src/guestfs-actions.pod:2011 ../fish/guestfish-actions.pod:1367
9848 msgid ""
9849 "This is always non-NULL.  If it wasn't set already, then this will return "
9850 "the default qemu binary name."
9851 msgstr ""
9852
9853 # type: textblock
9854 #. type: textblock
9855 #: ../src/guestfs-actions.pod:2017 ../src/guestfs-actions.pod:5703
9856 msgid "(Added in 1.0.6)"
9857 msgstr ""
9858
9859 # type: =head2
9860 #. type: =head2
9861 #: ../src/guestfs-actions.pod:2019
9862 msgid "guestfs_get_recovery_proc"
9863 msgstr ""
9864
9865 # type: verbatim
9866 #. type: verbatim
9867 #: ../src/guestfs-actions.pod:2021
9868 #, no-wrap
9869 msgid ""
9870 " int\n"
9871 " guestfs_get_recovery_proc (guestfs_h *g);\n"
9872 "\n"
9873 msgstr ""
9874
9875 # type: textblock
9876 #. type: textblock
9877 #: ../src/guestfs-actions.pod:2024 ../fish/guestfish-actions.pod:1374
9878 msgid "Return the recovery process enabled flag."
9879 msgstr ""
9880
9881 # type: textblock
9882 #. type: textblock
9883 #: ../src/guestfs-actions.pod:2028 ../src/guestfs-actions.pod:3260
9884 #: ../src/guestfs-actions.pod:3557 ../src/guestfs-actions.pod:3957
9885 #: ../src/guestfs-actions.pod:3989 ../src/guestfs-actions.pod:5007
9886 #: ../src/guestfs-actions.pod:5350 ../src/guestfs-actions.pod:5727
9887 #: ../src/guestfs-actions.pod:6386 ../src/guestfs-actions.pod:6406
9888 #: ../src/guestfs-actions.pod:6598
9889 msgid "(Added in 1.0.77)"
9890 msgstr ""
9891
9892 # type: =head2
9893 #. type: =head2
9894 #: ../src/guestfs-actions.pod:2030
9895 msgid "guestfs_get_selinux"
9896 msgstr ""
9897
9898 # type: verbatim
9899 #. type: verbatim
9900 #: ../src/guestfs-actions.pod:2032
9901 #, no-wrap
9902 msgid ""
9903 " int\n"
9904 " guestfs_get_selinux (guestfs_h *g);\n"
9905 "\n"
9906 msgstr ""
9907
9908 # type: textblock
9909 #. type: textblock
9910 #: ../src/guestfs-actions.pod:2035
9911 msgid ""
9912 "This returns the current setting of the selinux flag which is passed to the "
9913 "appliance at boot time.  See C<guestfs_set_selinux>."
9914 msgstr ""
9915
9916 # type: textblock
9917 #. type: textblock
9918 #: ../src/guestfs-actions.pod:2043 ../src/guestfs-actions.pod:2106
9919 #: ../src/guestfs-actions.pod:5746 ../src/guestfs-actions.pod:5800
9920 msgid "(Added in 1.0.67)"
9921 msgstr ""
9922
9923 # type: =head2
9924 #. type: =head2
9925 #: ../src/guestfs-actions.pod:2045
9926 msgid "guestfs_get_state"
9927 msgstr ""
9928
9929 # type: verbatim
9930 #. type: verbatim
9931 #: ../src/guestfs-actions.pod:2047
9932 #, no-wrap
9933 msgid ""
9934 " int\n"
9935 " guestfs_get_state (guestfs_h *g);\n"
9936 "\n"
9937 msgstr ""
9938
9939 # type: textblock
9940 #. type: textblock
9941 #: ../src/guestfs-actions.pod:2050 ../fish/guestfish-actions.pod:1390
9942 msgid ""
9943 "This returns the current state as an opaque integer.  This is only useful "
9944 "for printing debug and internal error messages."
9945 msgstr ""
9946
9947 # type: textblock
9948 #. type: textblock
9949 #: ../src/guestfs-actions.pod:2053 ../src/guestfs-actions.pod:3063
9950 #: ../src/guestfs-actions.pod:3092 ../src/guestfs-actions.pod:3153
9951 #: ../src/guestfs-actions.pod:3180 ../fish/guestfish-actions.pod:1393
9952 #: ../fish/guestfish-actions.pod:2132 ../fish/guestfish-actions.pod:2150
9953 #: ../fish/guestfish-actions.pod:2188 ../fish/guestfish-actions.pod:2204
9954 msgid "For more information on states, see L<guestfs(3)>."
9955 msgstr ""
9956
9957 # type: =head2
9958 #. type: =head2
9959 #: ../src/guestfs-actions.pod:2059
9960 msgid "guestfs_get_trace"
9961 msgstr ""
9962
9963 # type: verbatim
9964 #. type: verbatim
9965 #: ../src/guestfs-actions.pod:2061
9966 #, no-wrap
9967 msgid ""
9968 " int\n"
9969 " guestfs_get_trace (guestfs_h *g);\n"
9970 "\n"
9971 msgstr ""
9972
9973 # type: textblock
9974 #. type: textblock
9975 #: ../src/guestfs-actions.pod:2064 ../fish/guestfish-actions.pod:1399
9976 msgid "Return the command trace flag."
9977 msgstr ""
9978
9979 # type: =head2
9980 #. type: =head2
9981 #: ../src/guestfs-actions.pod:2070
9982 msgid "guestfs_get_umask"
9983 msgstr ""
9984
9985 # type: verbatim
9986 #. type: verbatim
9987 #: ../src/guestfs-actions.pod:2072
9988 #, no-wrap
9989 msgid ""
9990 " int\n"
9991 " guestfs_get_umask (guestfs_h *g);\n"
9992 "\n"
9993 msgstr ""
9994
9995 # type: textblock
9996 #. type: textblock
9997 #: ../src/guestfs-actions.pod:2075
9998 msgid ""
9999 "Return the current umask.  By default the umask is C<022> unless it has been "
10000 "set by calling C<guestfs_umask>."
10001 msgstr ""
10002
10003 # type: =head2
10004 #. type: =head2
10005 #: ../src/guestfs-actions.pod:2082
10006 msgid "guestfs_get_verbose"
10007 msgstr ""
10008
10009 # type: verbatim
10010 #. type: verbatim
10011 #: ../src/guestfs-actions.pod:2084
10012 #, no-wrap
10013 msgid ""
10014 " int\n"
10015 " guestfs_get_verbose (guestfs_h *g);\n"
10016 "\n"
10017 msgstr ""
10018
10019 # type: textblock
10020 #. type: textblock
10021 #: ../src/guestfs-actions.pod:2087 ../fish/guestfish-actions.pod:1412
10022 msgid "This returns the verbose messages flag."
10023 msgstr ""
10024
10025 # type: =head2
10026 #. type: =head2
10027 #: ../src/guestfs-actions.pod:2093
10028 msgid "guestfs_getcon"
10029 msgstr ""
10030
10031 # type: verbatim
10032 #. type: verbatim
10033 #: ../src/guestfs-actions.pod:2095
10034 #, no-wrap
10035 msgid ""
10036 " char *\n"
10037 " guestfs_getcon (guestfs_h *g);\n"
10038 "\n"
10039 msgstr ""
10040
10041 # type: textblock
10042 #. type: textblock
10043 #: ../src/guestfs-actions.pod:2098 ../fish/guestfish-actions.pod:1418
10044 msgid "This gets the SELinux security context of the daemon."
10045 msgstr ""
10046
10047 # type: textblock
10048 #. type: textblock
10049 #: ../src/guestfs-actions.pod:2100
10050 msgid ""
10051 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10052 msgstr ""
10053
10054 # type: =head2
10055 #. type: =head2
10056 #: ../src/guestfs-actions.pod:2108
10057 msgid "guestfs_getxattr"
10058 msgstr ""
10059
10060 # type: verbatim
10061 #. type: verbatim
10062 #: ../src/guestfs-actions.pod:2110
10063 #, no-wrap
10064 msgid ""
10065 " char *\n"
10066 " guestfs_getxattr (guestfs_h *g,\n"
10067 "                   const char *path,\n"
10068 "                   const char *name,\n"
10069 "                   size_t *size_r);\n"
10070 "\n"
10071 msgstr ""
10072
10073 # type: textblock
10074 #. type: textblock
10075 #: ../src/guestfs-actions.pod:2116
10076 msgid ""
10077 "Get a single extended attribute from file C<path> named C<name>.  This call "
10078 "follows symlinks.  If you want to lookup an extended attribute for the "
10079 "symlink itself, use C<guestfs_lgetxattr>."
10080 msgstr ""
10081
10082 # type: textblock
10083 #. type: textblock
10084 #: ../src/guestfs-actions.pod:2120 ../src/guestfs-actions.pod:3274
10085 msgid ""
10086 "Normally it is better to get all extended attributes from a file in one go "
10087 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10088 "implementations are buggy and do not provide a way to list out attributes.  "
10089 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10090 "extended attributes you want in advance and call this function."
10091 msgstr ""
10092
10093 # type: textblock
10094 #. type: textblock
10095 #: ../src/guestfs-actions.pod:2127 ../src/guestfs-actions.pod:3281
10096 #: ../fish/guestfish-actions.pod:1438 ../fish/guestfish-actions.pod:2269
10097 msgid ""
10098 "Extended attribute values are blobs of binary data.  If there is no extended "
10099 "attribute named C<name>, this returns an error."
10100 msgstr ""
10101
10102 # type: textblock
10103 #. type: textblock
10104 #: ../src/guestfs-actions.pod:2130
10105 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10106 msgstr ""
10107
10108 # type: textblock
10109 #. type: textblock
10110 #: ../src/guestfs-actions.pod:2132 ../src/guestfs-actions.pod:2323
10111 #: ../src/guestfs-actions.pod:3286 ../src/guestfs-actions.pod:5000
10112 #: ../src/guestfs-actions.pod:5026 ../src/guestfs-actions.pod:5207
10113 msgid ""
10114 "This function returns a buffer, or NULL on error.  The size of the returned "
10115 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10116 "after use>."
10117 msgstr ""
10118
10119 #. type: textblock
10120 #: ../src/guestfs-actions.pod:2136 ../src/guestfs-actions.pod:3290
10121 msgid "(Added in 1.7.24)"
10122 msgstr ""
10123
10124 # type: =head2
10125 #. type: =head2
10126 #: ../src/guestfs-actions.pod:2138
10127 msgid "guestfs_getxattrs"
10128 msgstr ""
10129
10130 # type: verbatim
10131 #. type: verbatim
10132 #: ../src/guestfs-actions.pod:2140
10133 #, no-wrap
10134 msgid ""
10135 " struct guestfs_xattr_list *\n"
10136 " guestfs_getxattrs (guestfs_h *g,\n"
10137 "                    const char *path);\n"
10138 "\n"
10139 msgstr ""
10140
10141 # type: textblock
10142 #. type: textblock
10143 #: ../src/guestfs-actions.pod:2144 ../fish/guestfish-actions.pod:1447
10144 msgid ""
10145 "This call lists the extended attributes of the file or directory C<path>."
10146 msgstr ""
10147
10148 # type: textblock
10149 #. type: textblock
10150 #: ../src/guestfs-actions.pod:2147 ../fish/guestfish-actions.pod:1450
10151 msgid ""
10152 "At the system call level, this is a combination of the L<listxattr(2)> and "
10153 "L<getxattr(2)> calls."
10154 msgstr ""
10155
10156 # type: textblock
10157 #. type: textblock
10158 #: ../src/guestfs-actions.pod:2150
10159 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10160 msgstr ""
10161
10162 # type: textblock
10163 #. type: textblock
10164 #: ../src/guestfs-actions.pod:2152 ../src/guestfs-actions.pod:3302
10165 #: ../src/guestfs-actions.pod:3953
10166 msgid ""
10167 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10168 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10169 msgstr ""
10170
10171 # type: textblock
10172 #. type: textblock
10173 #: ../src/guestfs-actions.pod:2156 ../src/guestfs-actions.pod:3306
10174 #: ../src/guestfs-actions.pod:3471 ../src/guestfs-actions.pod:3507
10175 #: ../src/guestfs-actions.pod:5380 ../src/guestfs-actions.pod:5819
10176 #: ../src/guestfs-actions.pod:7154
10177 msgid "(Added in 1.0.59)"
10178 msgstr ""
10179
10180 # type: =head2
10181 #. type: =head2
10182 #: ../src/guestfs-actions.pod:2158
10183 msgid "guestfs_glob_expand"
10184 msgstr ""
10185
10186 # type: verbatim
10187 #. type: verbatim
10188 #: ../src/guestfs-actions.pod:2160
10189 #, no-wrap
10190 msgid ""
10191 " char **\n"
10192 " guestfs_glob_expand (guestfs_h *g,\n"
10193 "                      const char *pattern);\n"
10194 "\n"
10195 msgstr ""
10196
10197 # type: textblock
10198 #. type: textblock
10199 #: ../src/guestfs-actions.pod:2164 ../fish/guestfish-actions.pod:1459
10200 msgid ""
10201 "This command searches for all the pathnames matching C<pattern> according to "
10202 "the wildcard expansion rules used by the shell."
10203 msgstr ""
10204
10205 # type: textblock
10206 #. type: textblock
10207 #: ../src/guestfs-actions.pod:2168 ../fish/guestfish-actions.pod:1463
10208 msgid ""
10209 "If no paths match, then this returns an empty list (note: not an error)."
10210 msgstr ""
10211
10212 # type: textblock
10213 #. type: textblock
10214 #: ../src/guestfs-actions.pod:2171 ../fish/guestfish-actions.pod:1466
10215 msgid ""
10216 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10217 "GLOB_BRACE>.  See that manual page for more details."
10218 msgstr ""
10219
10220 # type: textblock
10221 #. type: textblock
10222 #: ../src/guestfs-actions.pod:2179 ../src/guestfs-actions.pod:5984
10223 #: ../src/guestfs-actions.pod:6001
10224 msgid "(Added in 1.0.50)"
10225 msgstr ""
10226
10227 # type: =head2
10228 #. type: =head2
10229 #: ../src/guestfs-actions.pod:2181
10230 msgid "guestfs_grep"
10231 msgstr ""
10232
10233 # type: verbatim
10234 #. type: verbatim
10235 #: ../src/guestfs-actions.pod:2183
10236 #, no-wrap
10237 msgid ""
10238 " char **\n"
10239 " guestfs_grep (guestfs_h *g,\n"
10240 "               const char *regex,\n"
10241 "               const char *path);\n"
10242 "\n"
10243 msgstr ""
10244
10245 # type: textblock
10246 #. type: textblock
10247 #: ../src/guestfs-actions.pod:2188 ../fish/guestfish-actions.pod:1474
10248 msgid "This calls the external C<grep> program and returns the matching lines."
10249 msgstr ""
10250
10251 # type: =head2
10252 #. type: =head2
10253 #: ../src/guestfs-actions.pod:2200
10254 msgid "guestfs_grepi"
10255 msgstr ""
10256
10257 # type: verbatim
10258 #. type: verbatim
10259 #: ../src/guestfs-actions.pod:2202
10260 #, no-wrap
10261 msgid ""
10262 " char **\n"
10263 " guestfs_grepi (guestfs_h *g,\n"
10264 "                const char *regex,\n"
10265 "                const char *path);\n"
10266 "\n"
10267 msgstr ""
10268
10269 # type: textblock
10270 #. type: textblock
10271 #: ../src/guestfs-actions.pod:2207 ../fish/guestfish-actions.pod:1484
10272 msgid ""
10273 "This calls the external C<grep -i> program and returns the matching lines."
10274 msgstr ""
10275
10276 # type: =head2
10277 #. type: =head2
10278 #: ../src/guestfs-actions.pod:2219
10279 msgid "guestfs_grub_install"
10280 msgstr ""
10281
10282 # type: verbatim
10283 #. type: verbatim
10284 #: ../src/guestfs-actions.pod:2221
10285 #, no-wrap
10286 msgid ""
10287 " int\n"
10288 " guestfs_grub_install (guestfs_h *g,\n"
10289 "                       const char *root,\n"
10290 "                       const char *device);\n"
10291 "\n"
10292 msgstr ""
10293
10294 # type: textblock
10295 #. type: textblock
10296 #: ../src/guestfs-actions.pod:2226 ../fish/guestfish-actions.pod:1494
10297 msgid ""
10298 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
10299 "the root directory being C<root>."
10300 msgstr ""
10301
10302 # type: textblock
10303 #. type: textblock
10304 #: ../src/guestfs-actions.pod:2229 ../fish/guestfish-actions.pod:1497
10305 msgid ""
10306 "Note: If grub-install reports the error \"No suitable drive was found in the "
10307 "generated device map.\" it may be that you need to create a C</boot/grub/"
10308 "device.map> file first that contains the mapping between grub device names "
10309 "and Linux device names.  It is usually sufficient to create a file "
10310 "containing:"
10311 msgstr ""
10312
10313 # type: verbatim
10314 #. type: verbatim
10315 #: ../src/guestfs-actions.pod:2236 ../fish/guestfish-actions.pod:1504
10316 #, no-wrap
10317 msgid ""
10318 " (hd0) /dev/vda\n"
10319 "\n"
10320 msgstr ""
10321
10322 # type: textblock
10323 #. type: textblock
10324 #: ../src/guestfs-actions.pod:2238 ../fish/guestfish-actions.pod:1506
10325 msgid "replacing C</dev/vda> with the name of the installation device."
10326 msgstr ""
10327
10328 # type: textblock
10329 #. type: textblock
10330 #: ../src/guestfs-actions.pod:2242
10331 msgid "(Added in 1.0.17)"
10332 msgstr ""
10333
10334 # type: =head2
10335 #. type: =head2
10336 #: ../src/guestfs-actions.pod:2244
10337 msgid "guestfs_head"
10338 msgstr ""
10339
10340 # type: verbatim
10341 #. type: verbatim
10342 #: ../src/guestfs-actions.pod:2246
10343 #, no-wrap
10344 msgid ""
10345 " char **\n"
10346 " guestfs_head (guestfs_h *g,\n"
10347 "               const char *path);\n"
10348 "\n"
10349 msgstr ""
10350
10351 # type: textblock
10352 #. type: textblock
10353 #: ../src/guestfs-actions.pod:2250 ../fish/guestfish-actions.pod:1512
10354 msgid ""
10355 "This command returns up to the first 10 lines of a file as a list of strings."
10356 msgstr ""
10357
10358 # type: =head2
10359 #. type: =head2
10360 #: ../src/guestfs-actions.pod:2262
10361 msgid "guestfs_head_n"
10362 msgstr ""
10363
10364 # type: verbatim
10365 #. type: verbatim
10366 #: ../src/guestfs-actions.pod:2264
10367 #, no-wrap
10368 msgid ""
10369 " char **\n"
10370 " guestfs_head_n (guestfs_h *g,\n"
10371 "                 int nrlines,\n"
10372 "                 const char *path);\n"
10373 "\n"
10374 msgstr ""
10375
10376 # type: textblock
10377 #. type: textblock
10378 #: ../src/guestfs-actions.pod:2269 ../fish/guestfish-actions.pod:1522
10379 msgid ""
10380 "If the parameter C<nrlines> is a positive number, this returns the first "
10381 "C<nrlines> lines of the file C<path>."
10382 msgstr ""
10383
10384 # type: textblock
10385 #. type: textblock
10386 #: ../src/guestfs-actions.pod:2272 ../fish/guestfish-actions.pod:1525
10387 msgid ""
10388 "If the parameter C<nrlines> is a negative number, this returns lines from "
10389 "the file C<path>, excluding the last C<nrlines> lines."
10390 msgstr ""
10391
10392 # type: textblock
10393 #. type: textblock
10394 #: ../src/guestfs-actions.pod:2275 ../src/guestfs-actions.pod:6281
10395 #: ../fish/guestfish-actions.pod:1528 ../fish/guestfish-actions.pod:4194
10396 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
10397 msgstr ""
10398
10399 # type: =head2
10400 #. type: =head2
10401 #: ../src/guestfs-actions.pod:2286
10402 msgid "guestfs_hexdump"
10403 msgstr ""
10404
10405 # type: verbatim
10406 #. type: verbatim
10407 #: ../src/guestfs-actions.pod:2288
10408 #, no-wrap
10409 msgid ""
10410 " char *\n"
10411 " guestfs_hexdump (guestfs_h *g,\n"
10412 "                  const char *path);\n"
10413 "\n"
10414 msgstr ""
10415
10416 # type: textblock
10417 #. type: textblock
10418 #: ../src/guestfs-actions.pod:2292 ../fish/guestfish-actions.pod:1537
10419 msgid ""
10420 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
10421 "readable, canonical hex dump of the file."
10422 msgstr ""
10423
10424 # type: textblock
10425 #. type: textblock
10426 #: ../src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:6065
10427 #: ../src/guestfs-actions.pod:6120
10428 msgid "(Added in 1.0.22)"
10429 msgstr ""
10430
10431 # type: =head2
10432 #. type: =head2
10433 #: ../src/guestfs-actions.pod:2303
10434 msgid "guestfs_initrd_cat"
10435 msgstr ""
10436
10437 # type: verbatim
10438 #. type: verbatim
10439 #: ../src/guestfs-actions.pod:2305
10440 #, no-wrap
10441 msgid ""
10442 " char *\n"
10443 " guestfs_initrd_cat (guestfs_h *g,\n"
10444 "                     const char *initrdpath,\n"
10445 "                     const char *filename,\n"
10446 "                     size_t *size_r);\n"
10447 "\n"
10448 msgstr ""
10449
10450 # type: textblock
10451 #. type: textblock
10452 #: ../src/guestfs-actions.pod:2311 ../fish/guestfish-actions.pod:1547
10453 msgid ""
10454 "This command unpacks the file C<filename> from the initrd file called "
10455 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
10456 "character."
10457 msgstr ""
10458
10459 # type: textblock
10460 #. type: textblock
10461 #: ../src/guestfs-actions.pod:2315 ../fish/guestfish-actions.pod:1551
10462 msgid ""
10463 "For example, in guestfish you could use the following command to examine the "
10464 "boot script (usually called C</init>)  contained in a Linux initrd or "
10465 "initramfs image:"
10466 msgstr ""
10467
10468 # type: verbatim
10469 #. type: verbatim
10470 #: ../src/guestfs-actions.pod:2319 ../fish/guestfish-actions.pod:1555
10471 #, no-wrap
10472 msgid ""
10473 " initrd-cat /boot/initrd-<version>.img init\n"
10474 "\n"
10475 msgstr ""
10476
10477 # type: textblock
10478 #. type: textblock
10479 #: ../src/guestfs-actions.pod:2321
10480 msgid "See also C<guestfs_initrd_list>."
10481 msgstr ""
10482
10483 # type: =head2
10484 #. type: =head2
10485 #: ../src/guestfs-actions.pod:2332
10486 msgid "guestfs_initrd_list"
10487 msgstr ""
10488
10489 # type: verbatim
10490 #. type: verbatim
10491 #: ../src/guestfs-actions.pod:2334
10492 #, no-wrap
10493 msgid ""
10494 " char **\n"
10495 " guestfs_initrd_list (guestfs_h *g,\n"
10496 "                      const char *path);\n"
10497 "\n"
10498 msgstr ""
10499
10500 # type: textblock
10501 #. type: textblock
10502 #: ../src/guestfs-actions.pod:2338 ../fish/guestfish-actions.pod:1566
10503 msgid "This command lists out files contained in an initrd."
10504 msgstr ""
10505
10506 # type: textblock
10507 #. type: textblock
10508 #: ../src/guestfs-actions.pod:2340 ../fish/guestfish-actions.pod:1568
10509 msgid ""
10510 "The files are listed without any initial C</> character.  The files are "
10511 "listed in the order they appear (not necessarily alphabetical).  Directory "
10512 "names are listed as separate items."
10513 msgstr ""
10514
10515 # type: textblock
10516 #. type: textblock
10517 #: ../src/guestfs-actions.pod:2344 ../fish/guestfish-actions.pod:1572
10518 msgid ""
10519 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
10520 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
10521 "files)."
10522 msgstr ""
10523
10524 # type: =head2
10525 #. type: =head2
10526 #: ../src/guestfs-actions.pod:2354
10527 msgid "guestfs_inotify_add_watch"
10528 msgstr ""
10529
10530 # type: verbatim
10531 #. type: verbatim
10532 #: ../src/guestfs-actions.pod:2356
10533 #, no-wrap
10534 msgid ""
10535 " int64_t\n"
10536 " guestfs_inotify_add_watch (guestfs_h *g,\n"
10537 "                            const char *path,\n"
10538 "                            int mask);\n"
10539 "\n"
10540 msgstr ""
10541
10542 # type: textblock
10543 #. type: textblock
10544 #: ../src/guestfs-actions.pod:2361 ../fish/guestfish-actions.pod:1580
10545 msgid "Watch C<path> for the events listed in C<mask>."
10546 msgstr ""
10547
10548 # type: textblock
10549 #. type: textblock
10550 #: ../src/guestfs-actions.pod:2363 ../fish/guestfish-actions.pod:1582
10551 msgid ""
10552 "Note that if C<path> is a directory then events within that directory are "
10553 "watched, but this does I<not> happen recursively (in subdirectories)."
10554 msgstr ""
10555
10556 # type: textblock
10557 #. type: textblock
10558 #: ../src/guestfs-actions.pod:2367 ../fish/guestfish-actions.pod:1586
10559 msgid ""
10560 "Note for non-C or non-Linux callers: the inotify events are defined by the "
10561 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
10562 msgstr ""
10563
10564 # type: =head2
10565 #. type: =head2
10566 #: ../src/guestfs-actions.pod:2375
10567 msgid "guestfs_inotify_close"
10568 msgstr ""
10569
10570 # type: verbatim
10571 #. type: verbatim
10572 #: ../src/guestfs-actions.pod:2377
10573 #, no-wrap
10574 msgid ""
10575 " int\n"
10576 " guestfs_inotify_close (guestfs_h *g);\n"
10577 "\n"
10578 msgstr ""
10579
10580 # type: textblock
10581 #. type: textblock
10582 #: ../src/guestfs-actions.pod:2380 ../fish/guestfish-actions.pod:1594
10583 msgid ""
10584 "This closes the inotify handle which was previously opened by inotify_init.  "
10585 "It removes all watches, throws away any pending events, and deallocates all "
10586 "resources."
10587 msgstr ""
10588
10589 # type: =head2
10590 #. type: =head2
10591 #: ../src/guestfs-actions.pod:2388
10592 msgid "guestfs_inotify_files"
10593 msgstr ""
10594
10595 # type: verbatim
10596 #. type: verbatim
10597 #: ../src/guestfs-actions.pod:2390
10598 #, no-wrap
10599 msgid ""
10600 " char **\n"
10601 " guestfs_inotify_files (guestfs_h *g);\n"
10602 "\n"
10603 msgstr ""
10604
10605 # type: textblock
10606 #. type: textblock
10607 #: ../src/guestfs-actions.pod:2393
10608 msgid ""
10609 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
10610 "returns a list of pathnames of objects that were touched.  The returned "
10611 "pathnames are sorted and deduplicated."
10612 msgstr ""
10613
10614 # type: =head2
10615 #. type: =head2
10616 #: ../src/guestfs-actions.pod:2403
10617 msgid "guestfs_inotify_init"
10618 msgstr ""
10619
10620 # type: verbatim
10621 #. type: verbatim
10622 #: ../src/guestfs-actions.pod:2405
10623 #, no-wrap
10624 msgid ""
10625 " int\n"
10626 " guestfs_inotify_init (guestfs_h *g,\n"
10627 "                       int maxevents);\n"
10628 "\n"
10629 msgstr ""
10630
10631 # type: textblock
10632 #. type: textblock
10633 #: ../src/guestfs-actions.pod:2409 ../fish/guestfish-actions.pod:1610
10634 msgid ""
10635 "This command creates a new inotify handle.  The inotify subsystem can be "
10636 "used to notify events which happen to objects in the guest filesystem."
10637 msgstr ""
10638
10639 # type: textblock
10640 #. type: textblock
10641 #: ../src/guestfs-actions.pod:2413
10642 msgid ""
10643 "C<maxevents> is the maximum number of events which will be queued up between "
10644 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
10645 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
10646 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
10647 "throws away events, but records the fact that it threw them away by setting "
10648 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
10649 "C<guestfs_inotify_read>)."
10650 msgstr ""
10651
10652 # type: textblock
10653 #. type: textblock
10654 #: ../src/guestfs-actions.pod:2423
10655 msgid ""
10656 "Before any events are generated, you have to add some watches to the "
10657 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
10658 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
10659 msgstr ""
10660
10661 # type: textblock
10662 #. type: textblock
10663 #: ../src/guestfs-actions.pod:2429
10664 msgid ""
10665 "Queued up events should be read periodically by calling "
10666 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
10667 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
10668 "often enough then you risk the internal queue overflowing."
10669 msgstr ""
10670
10671 # type: textblock
10672 #. type: textblock
10673 #: ../src/guestfs-actions.pod:2436
10674 msgid ""
10675 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
10676 "This also removes any watches automatically."
10677 msgstr ""
10678
10679 # type: textblock
10680 #. type: textblock
10681 #: ../src/guestfs-actions.pod:2440 ../fish/guestfish-actions.pod:1641
10682 msgid ""
10683 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
10684 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
10685 "that there is one global inotify handle per libguestfs instance."
10686 msgstr ""
10687
10688 # type: =head2
10689 #. type: =head2
10690 #: ../src/guestfs-actions.pod:2449
10691 msgid "guestfs_inotify_read"
10692 msgstr ""
10693
10694 # type: verbatim
10695 #. type: verbatim
10696 #: ../src/guestfs-actions.pod:2451
10697 #, no-wrap
10698 msgid ""
10699 " struct guestfs_inotify_event_list *\n"
10700 " guestfs_inotify_read (guestfs_h *g);\n"
10701 "\n"
10702 msgstr ""
10703
10704 # type: textblock
10705 #. type: textblock
10706 #: ../src/guestfs-actions.pod:2454 ../fish/guestfish-actions.pod:1650
10707 msgid ""
10708 "Return the complete queue of events that have happened since the previous "
10709 "read call."
10710 msgstr ""
10711
10712 # type: textblock
10713 #. type: textblock
10714 #: ../src/guestfs-actions.pod:2457 ../fish/guestfish-actions.pod:1653
10715 msgid "If no events have happened, this returns an empty list."
10716 msgstr ""
10717
10718 # type: textblock
10719 #. type: textblock
10720 #: ../src/guestfs-actions.pod:2459 ../fish/guestfish-actions.pod:1655
10721 msgid ""
10722 "I<Note>: In order to make sure that all events have been read, you must call "
10723 "this function repeatedly until it returns an empty list.  The reason is that "
10724 "the call will read events up to the maximum appliance-to-host message size "
10725 "and leave remaining events in the queue."
10726 msgstr ""
10727
10728 # type: textblock
10729 #. type: textblock
10730 #: ../src/guestfs-actions.pod:2465
10731 msgid ""
10732 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
10733 "there was an error.  I<The caller must call "
10734 "C<guestfs_free_inotify_event_list> after use>."
10735 msgstr ""
10736
10737 # type: =head2
10738 #. type: =head2
10739 #: ../src/guestfs-actions.pod:2471
10740 msgid "guestfs_inotify_rm_watch"
10741 msgstr ""
10742
10743 # type: verbatim
10744 #. type: verbatim
10745 #: ../src/guestfs-actions.pod:2473
10746 #, no-wrap
10747 msgid ""
10748 " int\n"
10749 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
10750 "                           int wd);\n"
10751 "\n"
10752 msgstr ""
10753
10754 # type: textblock
10755 #. type: textblock
10756 #: ../src/guestfs-actions.pod:2477
10757 msgid ""
10758 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
10759 msgstr ""
10760
10761 # type: =head2
10762 #. type: =head2
10763 #: ../src/guestfs-actions.pod:2484
10764 msgid "guestfs_inspect_get_arch"
10765 msgstr ""
10766
10767 # type: verbatim
10768 #. type: verbatim
10769 #: ../src/guestfs-actions.pod:2486
10770 #, no-wrap
10771 msgid ""
10772 " char *\n"
10773 " guestfs_inspect_get_arch (guestfs_h *g,\n"
10774 "                           const char *root);\n"
10775 "\n"
10776 msgstr ""
10777
10778 # type: textblock
10779 #. type: textblock
10780 #: ../src/guestfs-actions.pod:2490 ../src/guestfs-actions.pod:2513
10781 #: ../src/guestfs-actions.pod:2594 ../src/guestfs-actions.pod:2620
10782 #: ../src/guestfs-actions.pod:2642 ../src/guestfs-actions.pod:2669
10783 #: ../src/guestfs-actions.pod:2690 ../src/guestfs-actions.pod:2727
10784 #: ../src/guestfs-actions.pod:2756 ../src/guestfs-actions.pod:2787
10785 #: ../src/guestfs-actions.pod:2831 ../src/guestfs-actions.pod:2873
10786 #: ../src/guestfs-actions.pod:2896
10787 msgid ""
10788 "This function should only be called with a root device string as returned by "
10789 "C<guestfs_inspect_os>."
10790 msgstr ""
10791
10792 # type: textblock
10793 #. type: textblock
10794 #: ../src/guestfs-actions.pod:2493
10795 msgid ""
10796 "This returns the architecture of the inspected operating system.  The "
10797 "possible return values are listed under C<guestfs_file_architecture>."
10798 msgstr ""
10799
10800 # type: textblock
10801 #. type: textblock
10802 #: ../src/guestfs-actions.pod:2497 ../fish/guestfish-actions.pod:1679
10803 msgid ""
10804 "If the architecture could not be determined, then the string C<unknown> is "
10805 "returned."
10806 msgstr ""
10807
10808 # type: textblock
10809 #. type: textblock
10810 #: ../src/guestfs-actions.pod:2500 ../src/guestfs-actions.pod:2581
10811 #: ../src/guestfs-actions.pod:2629 ../src/guestfs-actions.pod:2657
10812 #: ../src/guestfs-actions.pod:2743 ../src/guestfs-actions.pod:2774
10813 #: ../src/guestfs-actions.pod:2798 ../src/guestfs-actions.pod:2817
10814 #: ../src/guestfs-actions.pod:2860 ../src/guestfs-actions.pod:2883
10815 #: ../src/guestfs-actions.pod:2989 ../src/guestfs-actions.pod:3030
10816 #: ../fish/guestfish-actions.pod:1682 ../fish/guestfish-actions.pod:1756
10817 #: ../fish/guestfish-actions.pod:1789 ../fish/guestfish-actions.pod:1810
10818 #: ../fish/guestfish-actions.pod:1874 ../fish/guestfish-actions.pod:1898
10819 #: ../fish/guestfish-actions.pod:1915 ../fish/guestfish-actions.pod:1928
10820 #: ../fish/guestfish-actions.pod:1963 ../fish/guestfish-actions.pod:1979
10821 #: ../fish/guestfish-actions.pod:2078 ../fish/guestfish-actions.pod:2112
10822 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
10823 msgstr ""
10824
10825 # type: =head2
10826 #. type: =head2
10827 #: ../src/guestfs-actions.pod:2507
10828 msgid "guestfs_inspect_get_distro"
10829 msgstr ""
10830
10831 # type: verbatim
10832 #. type: verbatim
10833 #: ../src/guestfs-actions.pod:2509
10834 #, no-wrap
10835 msgid ""
10836 " char *\n"
10837 " guestfs_inspect_get_distro (guestfs_h *g,\n"
10838 "                             const char *root);\n"
10839 "\n"
10840 msgstr ""
10841
10842 # type: textblock
10843 #. type: textblock
10844 #: ../src/guestfs-actions.pod:2516 ../fish/guestfish-actions.pod:1691
10845 msgid ""
10846 "This returns the distro (distribution) of the inspected operating system."
10847 msgstr ""
10848
10849 # type: textblock
10850 #. type: textblock
10851 #: ../src/guestfs-actions.pod:2519 ../fish/guestfish-actions.pod:1694
10852 msgid "Currently defined distros are:"
10853 msgstr ""
10854
10855 # type: =item
10856 #. type: =item
10857 #: ../src/guestfs-actions.pod:2523 ../fish/guestfish-actions.pod:1698
10858 msgid "\"archlinux\""
10859 msgstr ""
10860
10861 # type: textblock
10862 #. type: textblock
10863 #: ../src/guestfs-actions.pod:2525 ../fish/guestfish-actions.pod:1700
10864 msgid "Arch Linux."
10865 msgstr ""
10866
10867 # type: =item
10868 #. type: =item
10869 #: ../src/guestfs-actions.pod:2527 ../fish/guestfish-actions.pod:1702
10870 msgid "\"debian\""
10871 msgstr ""
10872
10873 # type: textblock
10874 #. type: textblock
10875 #: ../src/guestfs-actions.pod:2529 ../fish/guestfish-actions.pod:1704
10876 msgid "Debian."
10877 msgstr ""
10878
10879 # type: =item
10880 #. type: =item
10881 #: ../src/guestfs-actions.pod:2531 ../fish/guestfish-actions.pod:1706
10882 msgid "\"fedora\""
10883 msgstr ""
10884
10885 # type: textblock
10886 #. type: textblock
10887 #: ../src/guestfs-actions.pod:2533 ../fish/guestfish-actions.pod:1708
10888 msgid "Fedora."
10889 msgstr ""
10890
10891 # type: =item
10892 #. type: =item
10893 #: ../src/guestfs-actions.pod:2535 ../fish/guestfish-actions.pod:1710
10894 msgid "\"gentoo\""
10895 msgstr ""
10896
10897 # type: textblock
10898 #. type: textblock
10899 #: ../src/guestfs-actions.pod:2537 ../fish/guestfish-actions.pod:1712
10900 msgid "Gentoo."
10901 msgstr ""
10902
10903 # type: =item
10904 #. type: =item
10905 #: ../src/guestfs-actions.pod:2539 ../fish/guestfish-actions.pod:1714
10906 msgid "\"linuxmint\""
10907 msgstr ""
10908
10909 # type: textblock
10910 #. type: textblock
10911 #: ../src/guestfs-actions.pod:2541 ../fish/guestfish-actions.pod:1716
10912 msgid "Linux Mint."
10913 msgstr ""
10914
10915 # type: =item
10916 #. type: =item
10917 #: ../src/guestfs-actions.pod:2543 ../fish/guestfish-actions.pod:1718
10918 msgid "\"mandriva\""
10919 msgstr ""
10920
10921 # type: textblock
10922 #. type: textblock
10923 #: ../src/guestfs-actions.pod:2545 ../fish/guestfish-actions.pod:1720
10924 msgid "Mandriva."
10925 msgstr ""
10926
10927 # type: =item
10928 #. type: =item
10929 #: ../src/guestfs-actions.pod:2547 ../fish/guestfish-actions.pod:1722
10930 msgid "\"meego\""
10931 msgstr ""
10932
10933 # type: textblock
10934 #. type: textblock
10935 #: ../src/guestfs-actions.pod:2549 ../fish/guestfish-actions.pod:1724
10936 msgid "MeeGo."
10937 msgstr ""
10938
10939 # type: =item
10940 #. type: =item
10941 #: ../src/guestfs-actions.pod:2551 ../fish/guestfish-actions.pod:1726
10942 msgid "\"pardus\""
10943 msgstr ""
10944
10945 # type: textblock
10946 #. type: textblock
10947 #: ../src/guestfs-actions.pod:2553 ../fish/guestfish-actions.pod:1728
10948 msgid "Pardus."
10949 msgstr ""
10950
10951 # type: =item
10952 #. type: =item
10953 #: ../src/guestfs-actions.pod:2555 ../fish/guestfish-actions.pod:1730
10954 msgid "\"redhat-based\""
10955 msgstr ""
10956
10957 # type: textblock
10958 #. type: textblock
10959 #: ../src/guestfs-actions.pod:2557 ../fish/guestfish-actions.pod:1732
10960 msgid "Some Red Hat-derived distro."
10961 msgstr ""
10962
10963 # type: =item
10964 #. type: =item
10965 #: ../src/guestfs-actions.pod:2559 ../fish/guestfish-actions.pod:1734
10966 msgid "\"rhel\""
10967 msgstr ""
10968
10969 # type: textblock
10970 #. type: textblock
10971 #: ../src/guestfs-actions.pod:2561 ../fish/guestfish-actions.pod:1736
10972 msgid "Red Hat Enterprise Linux and some derivatives."
10973 msgstr ""
10974
10975 # type: =item
10976 #. type: =item
10977 #: ../src/guestfs-actions.pod:2563 ../fish/guestfish-actions.pod:1738
10978 msgid "\"ubuntu\""
10979 msgstr ""
10980
10981 # type: textblock
10982 #. type: textblock
10983 #: ../src/guestfs-actions.pod:2565 ../fish/guestfish-actions.pod:1740
10984 msgid "Ubuntu."
10985 msgstr ""
10986
10987 # type: =item
10988 #. type: =item
10989 #: ../src/guestfs-actions.pod:2567 ../src/guestfs-actions.pod:2851
10990 #: ../fish/guestfish-actions.pod:1742 ../fish/guestfish-actions.pod:1954
10991 msgid "\"unknown\""
10992 msgstr ""
10993
10994 # type: textblock
10995 #. type: textblock
10996 #: ../src/guestfs-actions.pod:2569 ../fish/guestfish-actions.pod:1744
10997 msgid "The distro could not be determined."
10998 msgstr ""
10999
11000 # type: =item
11001 #. type: =item
11002 #: ../src/guestfs-actions.pod:2571 ../src/guestfs-actions.pod:2843
11003 #: ../fish/guestfish-actions.pod:1746 ../fish/guestfish-actions.pod:1946
11004 msgid "\"windows\""
11005 msgstr ""
11006
11007 # type: textblock
11008 #. type: textblock
11009 #: ../src/guestfs-actions.pod:2573 ../fish/guestfish-actions.pod:1748
11010 msgid ""
11011 "Windows does not have distributions.  This string is returned if the OS type "
11012 "is Windows."
11013 msgstr ""
11014
11015 # type: textblock
11016 #. type: textblock
11017 #: ../src/guestfs-actions.pod:2578 ../src/guestfs-actions.pod:2857
11018 #: ../fish/guestfish-actions.pod:1753 ../fish/guestfish-actions.pod:1960
11019 msgid ""
11020 "Future versions of libguestfs may return other strings here.  The caller "
11021 "should be prepared to handle any string."
11022 msgstr ""
11023
11024 # type: =head2
11025 #. type: =head2
11026 #: ../src/guestfs-actions.pod:2588
11027 msgid "guestfs_inspect_get_filesystems"
11028 msgstr ""
11029
11030 # type: verbatim
11031 #. type: verbatim
11032 #: ../src/guestfs-actions.pod:2590
11033 #, no-wrap
11034 msgid ""
11035 " char **\n"
11036 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11037 "                                  const char *root);\n"
11038 "\n"
11039 msgstr ""
11040
11041 # type: textblock
11042 #. type: textblock
11043 #: ../src/guestfs-actions.pod:2597 ../fish/guestfish-actions.pod:1765
11044 msgid ""
11045 "This returns a list of all the filesystems that we think are associated with "
11046 "this operating system.  This includes the root filesystem, other ordinary "
11047 "filesystems, and non-mounted devices like swap partitions."
11048 msgstr ""
11049
11050 # type: textblock
11051 #. type: textblock
11052 #: ../src/guestfs-actions.pod:2602 ../fish/guestfish-actions.pod:1770
11053 msgid ""
11054 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11055 "to be shared between operating systems."
11056 msgstr ""
11057
11058 # type: textblock
11059 #. type: textblock
11060 #: ../src/guestfs-actions.pod:2605
11061 msgid ""
11062 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11063 "C<guestfs_inspect_get_mountpoints>."
11064 msgstr ""
11065
11066 # type: =head2
11067 #. type: =head2
11068 #: ../src/guestfs-actions.pod:2614
11069 msgid "guestfs_inspect_get_hostname"
11070 msgstr ""
11071
11072 # type: verbatim
11073 #. type: verbatim
11074 #: ../src/guestfs-actions.pod:2616
11075 #, no-wrap
11076 msgid ""
11077 " char *\n"
11078 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
11079 "                               const char *root);\n"
11080 "\n"
11081 msgstr ""
11082
11083 # type: textblock
11084 #. type: textblock
11085 #: ../src/guestfs-actions.pod:2623 ../fish/guestfish-actions.pod:1783
11086 msgid ""
11087 "This function returns the hostname of the operating system as found by "
11088 "inspection of the guest's configuration files."
11089 msgstr ""
11090
11091 # type: textblock
11092 #. type: textblock
11093 #: ../src/guestfs-actions.pod:2626 ../fish/guestfish-actions.pod:1786
11094 msgid ""
11095 "If the hostname could not be determined, then the string C<unknown> is "
11096 "returned."
11097 msgstr ""
11098
11099 # type: textblock
11100 #. type: textblock
11101 #: ../src/guestfs-actions.pod:2634
11102 msgid "(Added in 1.7.9)"
11103 msgstr ""
11104
11105 # type: =head2
11106 #. type: =head2
11107 #: ../src/guestfs-actions.pod:2636
11108 msgid "guestfs_inspect_get_major_version"
11109 msgstr ""
11110
11111 # type: verbatim
11112 #. type: verbatim
11113 #: ../src/guestfs-actions.pod:2638
11114 #, no-wrap
11115 msgid ""
11116 " int\n"
11117 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
11118 "                                    const char *root);\n"
11119 "\n"
11120 msgstr ""
11121
11122 # type: textblock
11123 #. type: textblock
11124 #: ../src/guestfs-actions.pod:2645 ../fish/guestfish-actions.pod:1798
11125 msgid ""
11126 "This returns the major version number of the inspected operating system."
11127 msgstr ""
11128
11129 # type: textblock
11130 #. type: textblock
11131 #: ../src/guestfs-actions.pod:2648 ../fish/guestfish-actions.pod:1801
11132 msgid ""
11133 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
11134 "popular public names used by the operating system.  Notably the operating "
11135 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
11136 "1).  You can find out the real versions corresponding to releases of Windows "
11137 "by consulting Wikipedia or MSDN."
11138 msgstr ""
11139
11140 # type: textblock
11141 #. type: textblock
11142 #: ../src/guestfs-actions.pod:2655 ../src/guestfs-actions.pod:2675
11143 #: ../fish/guestfish-actions.pod:1808 ../fish/guestfish-actions.pod:1822
11144 msgid "If the version could not be determined, then C<0> is returned."
11145 msgstr ""
11146
11147 # type: =head2
11148 #. type: =head2
11149 #: ../src/guestfs-actions.pod:2663
11150 msgid "guestfs_inspect_get_minor_version"
11151 msgstr ""
11152
11153 # type: verbatim
11154 #. type: verbatim
11155 #: ../src/guestfs-actions.pod:2665
11156 #, no-wrap
11157 msgid ""
11158 " int\n"
11159 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
11160 "                                    const char *root);\n"
11161 "\n"
11162 msgstr ""
11163
11164 # type: textblock
11165 #. type: textblock
11166 #: ../src/guestfs-actions.pod:2672 ../fish/guestfish-actions.pod:1819
11167 msgid ""
11168 "This returns the minor version number of the inspected operating system."
11169 msgstr ""
11170
11171 # type: textblock
11172 #. type: textblock
11173 #: ../src/guestfs-actions.pod:2677
11174 msgid ""
11175 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11176 "C<guestfs_inspect_get_major_version>."
11177 msgstr ""
11178
11179 # type: =head2
11180 #. type: =head2
11181 #: ../src/guestfs-actions.pod:2684
11182 msgid "guestfs_inspect_get_mountpoints"
11183 msgstr ""
11184
11185 # type: verbatim
11186 #. type: verbatim
11187 #: ../src/guestfs-actions.pod:2686
11188 #, no-wrap
11189 msgid ""
11190 " char **\n"
11191 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
11192 "                                  const char *root);\n"
11193 "\n"
11194 msgstr ""
11195
11196 #. type: textblock
11197 #: ../src/guestfs-actions.pod:2693 ../fish/guestfish-actions.pod:1834
11198 msgid ""
11199 "This returns a hash of where we think the filesystems associated with this "
11200 "operating system should be mounted.  Callers should note that this is at "
11201 "best an educated guess made by reading configuration files such as C</etc/"
11202 "fstab>.  I<In particular note> that this may return filesystems which are "
11203 "non-existent or not mountable and callers should be prepared to handle or "
11204 "ignore failures if they try to mount them."
11205 msgstr ""
11206
11207 # type: textblock
11208 #. type: textblock
11209 #: ../src/guestfs-actions.pod:2702 ../fish/guestfish-actions.pod:1843
11210 msgid ""
11211 "Each element in the returned hashtable has a key which is the path of the "
11212 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
11213 "mounted there (eg. C</dev/sda1>)."
11214 msgstr ""
11215
11216 # type: textblock
11217 #. type: textblock
11218 #: ../src/guestfs-actions.pod:2707 ../fish/guestfish-actions.pod:1848
11219 msgid ""
11220 "Non-mounted devices such as swap devices are I<not> returned in this list."
11221 msgstr ""
11222
11223 # type: textblock
11224 #. type: textblock
11225 #: ../src/guestfs-actions.pod:2710
11226 msgid ""
11227 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11228 "C<guestfs_inspect_get_filesystems>."
11229 msgstr ""
11230
11231 # type: textblock
11232 #. type: textblock
11233 #: ../src/guestfs-actions.pod:2713 ../src/guestfs-actions.pod:3359
11234 #: ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:6422
11235 msgid ""
11236 "This function returns a NULL-terminated array of strings, or NULL if there "
11237 "was an error.  The array of strings will always have length C<2n+1>, where "
11238 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11239 "caller must free the strings and the array after use>."
11240 msgstr ""
11241
11242 # type: =head2
11243 #. type: =head2
11244 #: ../src/guestfs-actions.pod:2721
11245 msgid "guestfs_inspect_get_package_format"
11246 msgstr ""
11247
11248 # type: verbatim
11249 #. type: verbatim
11250 #: ../src/guestfs-actions.pod:2723
11251 #, no-wrap
11252 msgid ""
11253 " char *\n"
11254 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
11255 "                                     const char *root);\n"
11256 "\n"
11257 msgstr ""
11258
11259 # type: textblock
11260 #. type: textblock
11261 #: ../src/guestfs-actions.pod:2730
11262 msgid ""
11263 "This function and C<guestfs_inspect_get_package_management> return the "
11264 "package format and package management tool used by the inspected operating "
11265 "system.  For example for Fedora these functions would return C<rpm> (package "
11266 "format) and C<yum> (package management)."
11267 msgstr ""
11268
11269 # type: textblock
11270 #. type: textblock
11271 #: ../src/guestfs-actions.pod:2736 ../fish/guestfish-actions.pod:1867
11272 msgid ""
11273 "This returns the string C<unknown> if we could not determine the package "
11274 "format I<or> if the operating system does not have a real packaging system "
11275 "(eg. Windows)."
11276 msgstr ""
11277
11278 # type: textblock
11279 #. type: textblock
11280 #: ../src/guestfs-actions.pod:2740 ../fish/guestfish-actions.pod:1871
11281 msgid ""
11282 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
11283 "Future versions of libguestfs may return other strings."
11284 msgstr ""
11285
11286 # type: textblock
11287 #. type: textblock
11288 #: ../src/guestfs-actions.pod:2748 ../src/guestfs-actions.pod:2779
11289 msgid "(Added in 1.7.5)"
11290 msgstr ""
11291
11292 # type: =head2
11293 #. type: =head2
11294 #: ../src/guestfs-actions.pod:2750
11295 msgid "guestfs_inspect_get_package_management"
11296 msgstr ""
11297
11298 # type: verbatim
11299 #. type: verbatim
11300 #: ../src/guestfs-actions.pod:2752
11301 #, no-wrap
11302 msgid ""
11303 " char *\n"
11304 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
11305 "                                         const char *root);\n"
11306 "\n"
11307 msgstr ""
11308
11309 # type: textblock
11310 #. type: textblock
11311 #: ../src/guestfs-actions.pod:2759
11312 msgid ""
11313 "C<guestfs_inspect_get_package_format> and this function return the package "
11314 "format and package management tool used by the inspected operating system.  "
11315 "For example for Fedora these functions would return C<rpm> (package format) "
11316 "and C<yum> (package management)."
11317 msgstr ""
11318
11319 # type: textblock
11320 #. type: textblock
11321 #: ../src/guestfs-actions.pod:2765 ../fish/guestfish-actions.pod:1889
11322 msgid ""
11323 "This returns the string C<unknown> if we could not determine the package "
11324 "management tool I<or> if the operating system does not have a real packaging "
11325 "system (eg. Windows)."
11326 msgstr ""
11327
11328 # type: textblock
11329 #. type: textblock
11330 #: ../src/guestfs-actions.pod:2769 ../fish/guestfish-actions.pod:1893
11331 msgid ""
11332 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
11333 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
11334 "libguestfs may return other strings."
11335 msgstr ""
11336
11337 # type: =head2
11338 #. type: =head2
11339 #: ../src/guestfs-actions.pod:2781
11340 msgid "guestfs_inspect_get_product_name"
11341 msgstr ""
11342
11343 # type: verbatim
11344 #. type: verbatim
11345 #: ../src/guestfs-actions.pod:2783
11346 #, no-wrap
11347 msgid ""
11348 " char *\n"
11349 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
11350 "                                   const char *root);\n"
11351 "\n"
11352 msgstr ""
11353
11354 # type: textblock
11355 #. type: textblock
11356 #: ../src/guestfs-actions.pod:2790 ../fish/guestfish-actions.pod:1907
11357 msgid ""
11358 "This returns the product name of the inspected operating system.  The "
11359 "product name is generally some freeform string which can be displayed to the "
11360 "user, but should not be parsed by programs."
11361 msgstr ""
11362
11363 # type: textblock
11364 #. type: textblock
11365 #: ../src/guestfs-actions.pod:2795 ../fish/guestfish-actions.pod:1912
11366 msgid ""
11367 "If the product name could not be determined, then the string C<unknown> is "
11368 "returned."
11369 msgstr ""
11370
11371 # type: =head2
11372 #. type: =head2
11373 #: ../src/guestfs-actions.pod:2805
11374 msgid "guestfs_inspect_get_roots"
11375 msgstr ""
11376
11377 # type: verbatim
11378 #. type: verbatim
11379 #: ../src/guestfs-actions.pod:2807
11380 #, no-wrap
11381 msgid ""
11382 " char **\n"
11383 " guestfs_inspect_get_roots (guestfs_h *g);\n"
11384 "\n"
11385 msgstr ""
11386
11387 # type: textblock
11388 #. type: textblock
11389 #: ../src/guestfs-actions.pod:2810
11390 msgid ""
11391 "This function is a convenient way to get the list of root devices, as "
11392 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
11393 "the whole inspection process."
11394 msgstr ""
11395
11396 # type: textblock
11397 #. type: textblock
11398 #: ../src/guestfs-actions.pod:2814
11399 msgid ""
11400 "This returns an empty list if either no root devices were found or the "
11401 "caller has not called C<guestfs_inspect_os>."
11402 msgstr ""
11403
11404 # type: textblock
11405 #. type: textblock
11406 #: ../src/guestfs-actions.pod:2823
11407 msgid "(Added in 1.7.3)"
11408 msgstr ""
11409
11410 # type: =head2
11411 #. type: =head2
11412 #: ../src/guestfs-actions.pod:2825
11413 msgid "guestfs_inspect_get_type"
11414 msgstr ""
11415
11416 # type: verbatim
11417 #. type: verbatim
11418 #: ../src/guestfs-actions.pod:2827
11419 #, no-wrap
11420 msgid ""
11421 " char *\n"
11422 " guestfs_inspect_get_type (guestfs_h *g,\n"
11423 "                           const char *root);\n"
11424 "\n"
11425 msgstr ""
11426
11427 # type: textblock
11428 #. type: textblock
11429 #: ../src/guestfs-actions.pod:2834 ../fish/guestfish-actions.pod:1937
11430 msgid ""
11431 "This returns the type of the inspected operating system.  Currently defined "
11432 "types are:"
11433 msgstr ""
11434
11435 # type: =item
11436 #. type: =item
11437 #: ../src/guestfs-actions.pod:2839 ../fish/guestfish-actions.pod:1942
11438 msgid "\"linux\""
11439 msgstr ""
11440
11441 # type: textblock
11442 #. type: textblock
11443 #: ../src/guestfs-actions.pod:2841 ../fish/guestfish-actions.pod:1944
11444 msgid "Any Linux-based operating system."
11445 msgstr ""
11446
11447 # type: textblock
11448 #. type: textblock
11449 #: ../src/guestfs-actions.pod:2845 ../fish/guestfish-actions.pod:1948
11450 msgid "Any Microsoft Windows operating system."
11451 msgstr ""
11452
11453 # type: =item
11454 #. type: =item
11455 #: ../src/guestfs-actions.pod:2847 ../fish/guestfish-actions.pod:1950
11456 msgid "\"freebsd\""
11457 msgstr ""
11458
11459 # type: textblock
11460 #. type: textblock
11461 #: ../src/guestfs-actions.pod:2849 ../fish/guestfish-actions.pod:1952
11462 msgid "FreeBSD."
11463 msgstr ""
11464
11465 # type: textblock
11466 #. type: textblock
11467 #: ../src/guestfs-actions.pod:2853 ../fish/guestfish-actions.pod:1956
11468 msgid "The operating system type could not be determined."
11469 msgstr ""
11470
11471 # type: =head2
11472 #. type: =head2
11473 #: ../src/guestfs-actions.pod:2867
11474 msgid "guestfs_inspect_get_windows_systemroot"
11475 msgstr ""
11476
11477 # type: verbatim
11478 #. type: verbatim
11479 #: ../src/guestfs-actions.pod:2869
11480 #, no-wrap
11481 msgid ""
11482 " char *\n"
11483 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
11484 "                                         const char *root);\n"
11485 "\n"
11486 msgstr ""
11487
11488 # type: textblock
11489 #. type: textblock
11490 #: ../src/guestfs-actions.pod:2876 ../fish/guestfish-actions.pod:1972
11491 msgid ""
11492 "This returns the Windows systemroot of the inspected guest.  The systemroot "
11493 "is a directory path such as C</WINDOWS>."
11494 msgstr ""
11495
11496 # type: textblock
11497 #. type: textblock
11498 #: ../src/guestfs-actions.pod:2879 ../fish/guestfish-actions.pod:1975
11499 msgid ""
11500 "This call assumes that the guest is Windows and that the systemroot could be "
11501 "determined by inspection.  If this is not the case then an error is returned."
11502 msgstr ""
11503
11504 # type: textblock
11505 #. type: textblock
11506 #: ../src/guestfs-actions.pod:2888
11507 msgid "(Added in 1.5.25)"
11508 msgstr ""
11509
11510 # type: =head2
11511 #. type: =head2
11512 #: ../src/guestfs-actions.pod:2890
11513 msgid "guestfs_inspect_list_applications"
11514 msgstr ""
11515
11516 # type: verbatim
11517 #. type: verbatim
11518 #: ../src/guestfs-actions.pod:2892
11519 #, no-wrap
11520 msgid ""
11521 " struct guestfs_application_list *\n"
11522 " guestfs_inspect_list_applications (guestfs_h *g,\n"
11523 "                                    const char *root);\n"
11524 "\n"
11525 msgstr ""
11526
11527 # type: textblock
11528 #. type: textblock
11529 #: ../src/guestfs-actions.pod:2899 ../fish/guestfish-actions.pod:1988
11530 msgid "Return the list of applications installed in the operating system."
11531 msgstr ""
11532
11533 # type: textblock
11534 #. type: textblock
11535 #: ../src/guestfs-actions.pod:2901
11536 msgid ""
11537 "I<Note:> This call works differently from other parts of the inspection "
11538 "API.  You have to call C<guestfs_inspect_os>, then "
11539 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
11540 "this.  Listing applications is a significantly more difficult operation "
11541 "which requires access to the full filesystem.  Also note that unlike the "
11542 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
11543 "the libguestfs handle, this call actually reads parts of the mounted "
11544 "filesystems during the call."
11545 msgstr ""
11546
11547 # type: textblock
11548 #. type: textblock
11549 #: ../src/guestfs-actions.pod:2911 ../fish/guestfish-actions.pod:2000
11550 msgid ""
11551 "This returns an empty list if the inspection code was not able to determine "
11552 "the list of applications."
11553 msgstr ""
11554
11555 # type: textblock
11556 #. type: textblock
11557 #: ../src/guestfs-actions.pod:2914 ../fish/guestfish-actions.pod:2003
11558 msgid "The application structure contains the following fields:"
11559 msgstr ""
11560
11561 # type: =item
11562 #. type: =item
11563 #: ../src/guestfs-actions.pod:2918 ../fish/guestfish-actions.pod:2007
11564 msgid "C<app_name>"
11565 msgstr ""
11566
11567 # type: textblock
11568 #. type: textblock
11569 #: ../src/guestfs-actions.pod:2920 ../fish/guestfish-actions.pod:2009
11570 msgid ""
11571 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
11572 "guests, this is the package name."
11573 msgstr ""
11574
11575 # type: =item
11576 #. type: =item
11577 #: ../src/guestfs-actions.pod:2923 ../fish/guestfish-actions.pod:2012
11578 msgid "C<app_display_name>"
11579 msgstr ""
11580
11581 # type: textblock
11582 #. type: textblock
11583 #: ../src/guestfs-actions.pod:2925 ../fish/guestfish-actions.pod:2014
11584 msgid ""
11585 "The display name of the application, sometimes localized to the install "
11586 "language of the guest operating system."
11587 msgstr ""
11588
11589 # type: textblock
11590 #. type: textblock
11591 #: ../src/guestfs-actions.pod:2928 ../fish/guestfish-actions.pod:2017
11592 msgid ""
11593 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
11594 "to display something can use C<app_name> instead."
11595 msgstr ""
11596
11597 # type: =item
11598 #. type: =item
11599 #: ../src/guestfs-actions.pod:2931 ../fish/guestfish-actions.pod:2020
11600 msgid "C<app_epoch>"
11601 msgstr ""
11602
11603 # type: textblock
11604 #. type: textblock
11605 #: ../src/guestfs-actions.pod:2933 ../fish/guestfish-actions.pod:2022
11606 msgid ""
11607 "For package managers which use epochs, this contains the epoch of the "
11608 "package (an integer).  If unavailable, this is returned as C<0>."
11609 msgstr ""
11610
11611 # type: =item
11612 #. type: =item
11613 #: ../src/guestfs-actions.pod:2936 ../fish/guestfish-actions.pod:2025
11614 msgid "C<app_version>"
11615 msgstr ""
11616
11617 # type: textblock
11618 #. type: textblock
11619 #: ../src/guestfs-actions.pod:2938 ../fish/guestfish-actions.pod:2027
11620 msgid ""
11621 "The version string of the application or package.  If unavailable this is "
11622 "returned as an empty string C<\"\">."
11623 msgstr ""
11624
11625 # type: =item
11626 #. type: =item
11627 #: ../src/guestfs-actions.pod:2941 ../fish/guestfish-actions.pod:2030
11628 msgid "C<app_release>"
11629 msgstr ""
11630
11631 # type: textblock
11632 #. type: textblock
11633 #: ../src/guestfs-actions.pod:2943 ../fish/guestfish-actions.pod:2032
11634 msgid ""
11635 "The release string of the application or package, for package managers that "
11636 "use this.  If unavailable this is returned as an empty string C<\"\">."
11637 msgstr ""
11638
11639 # type: =item
11640 #. type: =item
11641 #: ../src/guestfs-actions.pod:2947 ../fish/guestfish-actions.pod:2036
11642 msgid "C<app_install_path>"
11643 msgstr ""
11644
11645 # type: textblock
11646 #. type: textblock
11647 #: ../src/guestfs-actions.pod:2949 ../fish/guestfish-actions.pod:2038
11648 msgid ""
11649 "The installation path of the application (on operating systems such as "
11650 "Windows which use installation paths).  This path is in the format used by "
11651 "the guest operating system, it is not a libguestfs path."
11652 msgstr ""
11653
11654 # type: textblock
11655 #. type: textblock
11656 #: ../src/guestfs-actions.pod:2954 ../fish/guestfish-actions.pod:2043
11657 msgid "If unavailable this is returned as an empty string C<\"\">."
11658 msgstr ""
11659
11660 # type: =item
11661 #. type: =item
11662 #: ../src/guestfs-actions.pod:2956 ../fish/guestfish-actions.pod:2045
11663 msgid "C<app_trans_path>"
11664 msgstr ""
11665
11666 # type: textblock
11667 #. type: textblock
11668 #: ../src/guestfs-actions.pod:2958 ../fish/guestfish-actions.pod:2047
11669 msgid ""
11670 "The install path translated into a libguestfs path.  If unavailable this is "
11671 "returned as an empty string C<\"\">."
11672 msgstr ""
11673
11674 # type: =item
11675 #. type: =item
11676 #: ../src/guestfs-actions.pod:2961 ../fish/guestfish-actions.pod:2050
11677 msgid "C<app_publisher>"
11678 msgstr ""
11679
11680 # type: textblock
11681 #. type: textblock
11682 #: ../src/guestfs-actions.pod:2963 ../fish/guestfish-actions.pod:2052
11683 msgid ""
11684 "The name of the publisher of the application, for package managers that use "
11685 "this.  If unavailable this is returned as an empty string C<\"\">."
11686 msgstr ""
11687
11688 # type: =item
11689 #. type: =item
11690 #: ../src/guestfs-actions.pod:2967 ../fish/guestfish-actions.pod:2056
11691 msgid "C<app_url>"
11692 msgstr ""
11693
11694 # type: textblock
11695 #. type: textblock
11696 #: ../src/guestfs-actions.pod:2969 ../fish/guestfish-actions.pod:2058
11697 msgid ""
11698 "The URL (eg. upstream URL) of the application.  If unavailable this is "
11699 "returned as an empty string C<\"\">."
11700 msgstr ""
11701
11702 # type: =item
11703 #. type: =item
11704 #: ../src/guestfs-actions.pod:2972 ../fish/guestfish-actions.pod:2061
11705 msgid "C<app_source_package>"
11706 msgstr ""
11707
11708 # type: textblock
11709 #. type: textblock
11710 #: ../src/guestfs-actions.pod:2974 ../fish/guestfish-actions.pod:2063
11711 msgid ""
11712 "For packaging systems which support this, the name of the source package.  "
11713 "If unavailable this is returned as an empty string C<\"\">."
11714 msgstr ""
11715
11716 # type: =item
11717 #. type: =item
11718 #: ../src/guestfs-actions.pod:2977 ../fish/guestfish-actions.pod:2066
11719 msgid "C<app_summary>"
11720 msgstr ""
11721
11722 # type: textblock
11723 #. type: textblock
11724 #: ../src/guestfs-actions.pod:2979 ../fish/guestfish-actions.pod:2068
11725 msgid ""
11726 "A short (usually one line) description of the application or package.  If "
11727 "unavailable this is returned as an empty string C<\"\">."
11728 msgstr ""
11729
11730 # type: =item
11731 #. type: =item
11732 #: ../src/guestfs-actions.pod:2982 ../fish/guestfish-actions.pod:2071
11733 msgid "C<app_description>"
11734 msgstr ""
11735
11736 # type: textblock
11737 #. type: textblock
11738 #: ../src/guestfs-actions.pod:2984 ../fish/guestfish-actions.pod:2073
11739 msgid ""
11740 "A longer description of the application or package.  If unavailable this is "
11741 "returned as an empty string C<\"\">."
11742 msgstr ""
11743
11744 # type: textblock
11745 #. type: textblock
11746 #: ../src/guestfs-actions.pod:2991
11747 msgid ""
11748 "This function returns a C<struct guestfs_application_list *>, or NULL if "
11749 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
11750 "after use>."
11751 msgstr ""
11752
11753 # type: textblock
11754 #. type: textblock
11755 #: ../src/guestfs-actions.pod:2995
11756 msgid "(Added in 1.7.8)"
11757 msgstr ""
11758
11759 # type: =head2
11760 #. type: =head2
11761 #: ../src/guestfs-actions.pod:2997
11762 msgid "guestfs_inspect_os"
11763 msgstr ""
11764
11765 # type: verbatim
11766 #. type: verbatim
11767 #: ../src/guestfs-actions.pod:2999
11768 #, no-wrap
11769 msgid ""
11770 " char **\n"
11771 " guestfs_inspect_os (guestfs_h *g);\n"
11772 "\n"
11773 msgstr ""
11774
11775 # type: textblock
11776 #. type: textblock
11777 #: ../src/guestfs-actions.pod:3002 ../fish/guestfish-actions.pod:2084
11778 msgid ""
11779 "This function uses other libguestfs functions and certain heuristics to "
11780 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
11781 "for operating systems."
11782 msgstr ""
11783
11784 # type: textblock
11785 #. type: textblock
11786 #: ../src/guestfs-actions.pod:3006 ../fish/guestfish-actions.pod:2088
11787 msgid "The list returned is empty if no operating systems were found."
11788 msgstr ""
11789
11790 # type: textblock
11791 #. type: textblock
11792 #: ../src/guestfs-actions.pod:3008 ../fish/guestfish-actions.pod:2090
11793 msgid ""
11794 "If one operating system was found, then this returns a list with a single "
11795 "element, which is the name of the root filesystem of this operating system.  "
11796 "It is also possible for this function to return a list containing more than "
11797 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
11798 "element being the root filesystem of one of the operating systems."
11799 msgstr ""
11800
11801 # type: textblock
11802 #. type: textblock
11803 #: ../src/guestfs-actions.pod:3015
11804 msgid ""
11805 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
11806 "functions in order to query further information about each operating system, "
11807 "such as the name and version."
11808 msgstr ""
11809
11810 # type: textblock
11811 #. type: textblock
11812 #: ../src/guestfs-actions.pod:3020
11813 msgid ""
11814 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
11815 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
11816 "the contents.  This should be called with no disks currently mounted.  The "
11817 "function may also use Augeas, so any existing Augeas handle will be closed."
11818 msgstr ""
11819
11820 # type: textblock
11821 #. type: textblock
11822 #: ../src/guestfs-actions.pod:3026 ../fish/guestfish-actions.pod:2108
11823 msgid ""
11824 "This function cannot decrypt encrypted disks.  The caller must do that first "
11825 "(supplying the necessary keys) if the disk is encrypted."
11826 msgstr ""
11827
11828 # type: textblock
11829 #. type: textblock
11830 #: ../src/guestfs-actions.pod:3032 ../src/guestfs-actions.pod:3317
11831 #: ../src/guestfs-actions.pod:3379
11832 msgid "See also C<guestfs_list_filesystems>."
11833 msgstr ""
11834
11835 # type: =head2
11836 #. type: =head2
11837 #: ../src/guestfs-actions.pod:3040
11838 msgid "guestfs_is_blockdev"
11839 msgstr ""
11840
11841 # type: verbatim
11842 #. type: verbatim
11843 #: ../src/guestfs-actions.pod:3042
11844 #, no-wrap
11845 msgid ""
11846 " int\n"
11847 " guestfs_is_blockdev (guestfs_h *g,\n"
11848 "                      const char *path);\n"
11849 "\n"
11850 msgstr ""
11851
11852 # type: textblock
11853 #. type: textblock
11854 #: ../src/guestfs-actions.pod:3046 ../fish/guestfish-actions.pod:2120
11855 msgid ""
11856 "This returns C<true> if and only if there is a block device with the given "
11857 "C<path> name."
11858 msgstr ""
11859
11860 # type: textblock
11861 #. type: textblock
11862 #: ../src/guestfs-actions.pod:3049 ../src/guestfs-actions.pod:3078
11863 #: ../src/guestfs-actions.pod:3108 ../src/guestfs-actions.pod:3123
11864 #: ../src/guestfs-actions.pod:3139 ../src/guestfs-actions.pod:3195
11865 #: ../src/guestfs-actions.pod:3210
11866 msgid "See also C<guestfs_stat>."
11867 msgstr ""
11868
11869 # type: textblock
11870 #. type: textblock
11871 #: ../src/guestfs-actions.pod:3053 ../src/guestfs-actions.pod:3082
11872 #: ../src/guestfs-actions.pod:3127 ../src/guestfs-actions.pod:3199
11873 #: ../src/guestfs-actions.pod:3214
11874 msgid "(Added in 1.5.10)"
11875 msgstr ""
11876
11877 # type: =head2
11878 #. type: =head2
11879 #: ../src/guestfs-actions.pod:3055
11880 msgid "guestfs_is_busy"
11881 msgstr ""
11882
11883 # type: verbatim
11884 #. type: verbatim
11885 #: ../src/guestfs-actions.pod:3057
11886 #, no-wrap
11887 msgid ""
11888 " int\n"
11889 " guestfs_is_busy (guestfs_h *g);\n"
11890 "\n"
11891 msgstr ""
11892
11893 # type: textblock
11894 #. type: textblock
11895 #: ../src/guestfs-actions.pod:3060 ../fish/guestfish-actions.pod:2129
11896 msgid ""
11897 "This returns true iff this handle is busy processing a command (in the "
11898 "C<BUSY> state)."
11899 msgstr ""
11900
11901 # type: =head2
11902 #. type: =head2
11903 #: ../src/guestfs-actions.pod:3069
11904 msgid "guestfs_is_chardev"
11905 msgstr ""
11906
11907 # type: verbatim
11908 #. type: verbatim
11909 #: ../src/guestfs-actions.pod:3071
11910 #, no-wrap
11911 msgid ""
11912 " int\n"
11913 " guestfs_is_chardev (guestfs_h *g,\n"
11914 "                     const char *path);\n"
11915 "\n"
11916 msgstr ""
11917
11918 # type: textblock
11919 #. type: textblock
11920 #: ../src/guestfs-actions.pod:3075 ../fish/guestfish-actions.pod:2138
11921 msgid ""
11922 "This returns C<true> if and only if there is a character device with the "
11923 "given C<path> name."
11924 msgstr ""
11925
11926 # type: =head2
11927 #. type: =head2
11928 #: ../src/guestfs-actions.pod:3084
11929 msgid "guestfs_is_config"
11930 msgstr ""
11931
11932 # type: verbatim
11933 #. type: verbatim
11934 #: ../src/guestfs-actions.pod:3086
11935 #, no-wrap
11936 msgid ""
11937 " int\n"
11938 " guestfs_is_config (guestfs_h *g);\n"
11939 "\n"
11940 msgstr ""
11941
11942 # type: textblock
11943 #. type: textblock
11944 #: ../src/guestfs-actions.pod:3089 ../fish/guestfish-actions.pod:2147
11945 msgid ""
11946 "This returns true iff this handle is being configured (in the C<CONFIG> "
11947 "state)."
11948 msgstr ""
11949
11950 # type: =head2
11951 #. type: =head2
11952 #: ../src/guestfs-actions.pod:3098
11953 msgid "guestfs_is_dir"
11954 msgstr ""
11955
11956 # type: verbatim
11957 #. type: verbatim
11958 #: ../src/guestfs-actions.pod:3100
11959 #, no-wrap
11960 msgid ""
11961 " int\n"
11962 " guestfs_is_dir (guestfs_h *g,\n"
11963 "                 const char *path);\n"
11964 "\n"
11965 msgstr ""
11966
11967 # type: textblock
11968 #. type: textblock
11969 #: ../src/guestfs-actions.pod:3104 ../fish/guestfish-actions.pod:2156
11970 msgid ""
11971 "This returns C<true> if and only if there is a directory with the given "
11972 "C<path> name.  Note that it returns false for other objects like files."
11973 msgstr ""
11974
11975 # type: =head2
11976 #. type: =head2
11977 #: ../src/guestfs-actions.pod:3114
11978 msgid "guestfs_is_fifo"
11979 msgstr ""
11980
11981 # type: verbatim
11982 #. type: verbatim
11983 #: ../src/guestfs-actions.pod:3116
11984 #, no-wrap
11985 msgid ""
11986 " int\n"
11987 " guestfs_is_fifo (guestfs_h *g,\n"
11988 "                  const char *path);\n"
11989 "\n"
11990 msgstr ""
11991
11992 # type: textblock
11993 #. type: textblock
11994 #: ../src/guestfs-actions.pod:3120 ../fish/guestfish-actions.pod:2166
11995 msgid ""
11996 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
11997 "given C<path> name."
11998 msgstr ""
11999
12000 # type: =head2
12001 #. type: =head2
12002 #: ../src/guestfs-actions.pod:3129
12003 msgid "guestfs_is_file"
12004 msgstr ""
12005
12006 # type: verbatim
12007 #. type: verbatim
12008 #: ../src/guestfs-actions.pod:3131
12009 #, no-wrap
12010 msgid ""
12011 " int\n"
12012 " guestfs_is_file (guestfs_h *g,\n"
12013 "                  const char *path);\n"
12014 "\n"
12015 msgstr ""
12016
12017 # type: textblock
12018 #. type: textblock
12019 #: ../src/guestfs-actions.pod:3135 ../fish/guestfish-actions.pod:2175
12020 msgid ""
12021 "This returns C<true> if and only if there is a regular file with the given "
12022 "C<path> name.  Note that it returns false for other objects like directories."
12023 msgstr ""
12024
12025 # type: =head2
12026 #. type: =head2
12027 #: ../src/guestfs-actions.pod:3145
12028 msgid "guestfs_is_launching"
12029 msgstr ""
12030
12031 # type: verbatim
12032 #. type: verbatim
12033 #: ../src/guestfs-actions.pod:3147
12034 #, no-wrap
12035 msgid ""
12036 " int\n"
12037 " guestfs_is_launching (guestfs_h *g);\n"
12038 "\n"
12039 msgstr ""
12040
12041 # type: textblock
12042 #. type: textblock
12043 #: ../src/guestfs-actions.pod:3150 ../fish/guestfish-actions.pod:2185
12044 msgid ""
12045 "This returns true iff this handle is launching the subprocess (in the "
12046 "C<LAUNCHING> state)."
12047 msgstr ""
12048
12049 # type: =head2
12050 #. type: =head2
12051 #: ../src/guestfs-actions.pod:3159
12052 msgid "guestfs_is_lv"
12053 msgstr ""
12054
12055 # type: verbatim
12056 #. type: verbatim
12057 #: ../src/guestfs-actions.pod:3161
12058 #, no-wrap
12059 msgid ""
12060 " int\n"
12061 " guestfs_is_lv (guestfs_h *g,\n"
12062 "                const char *device);\n"
12063 "\n"
12064 msgstr ""
12065
12066 # type: textblock
12067 #. type: textblock
12068 #: ../src/guestfs-actions.pod:3165 ../fish/guestfish-actions.pod:2194
12069 msgid ""
12070 "This command tests whether C<device> is a logical volume, and returns true "
12071 "iff this is the case."
12072 msgstr ""
12073
12074 # type: =head2
12075 #. type: =head2
12076 #: ../src/guestfs-actions.pod:3172
12077 msgid "guestfs_is_ready"
12078 msgstr ""
12079
12080 # type: verbatim
12081 #. type: verbatim
12082 #: ../src/guestfs-actions.pod:3174
12083 #, no-wrap
12084 msgid ""
12085 " int\n"
12086 " guestfs_is_ready (guestfs_h *g);\n"
12087 "\n"
12088 msgstr ""
12089
12090 # type: textblock
12091 #. type: textblock
12092 #: ../src/guestfs-actions.pod:3177 ../fish/guestfish-actions.pod:2201
12093 msgid ""
12094 "This returns true iff this handle is ready to accept commands (in the "
12095 "C<READY> state)."
12096 msgstr ""
12097
12098 # type: =head2
12099 #. type: =head2
12100 #: ../src/guestfs-actions.pod:3186
12101 msgid "guestfs_is_socket"
12102 msgstr ""
12103
12104 # type: verbatim
12105 #. type: verbatim
12106 #: ../src/guestfs-actions.pod:3188
12107 #, no-wrap
12108 msgid ""
12109 " int\n"
12110 " guestfs_is_socket (guestfs_h *g,\n"
12111 "                    const char *path);\n"
12112 "\n"
12113 msgstr ""
12114
12115 # type: textblock
12116 #. type: textblock
12117 #: ../src/guestfs-actions.pod:3192 ../fish/guestfish-actions.pod:2210
12118 msgid ""
12119 "This returns C<true> if and only if there is a Unix domain socket with the "
12120 "given C<path> name."
12121 msgstr ""
12122
12123 # type: =head2
12124 #. type: =head2
12125 #: ../src/guestfs-actions.pod:3201
12126 msgid "guestfs_is_symlink"
12127 msgstr ""
12128
12129 # type: verbatim
12130 #. type: verbatim
12131 #: ../src/guestfs-actions.pod:3203
12132 #, no-wrap
12133 msgid ""
12134 " int\n"
12135 " guestfs_is_symlink (guestfs_h *g,\n"
12136 "                     const char *path);\n"
12137 "\n"
12138 msgstr ""
12139
12140 # type: textblock
12141 #. type: textblock
12142 #: ../src/guestfs-actions.pod:3207 ../fish/guestfish-actions.pod:2219
12143 msgid ""
12144 "This returns C<true> if and only if there is a symbolic link with the given "
12145 "C<path> name."
12146 msgstr ""
12147
12148 # type: =head2
12149 #. type: =head2
12150 #: ../src/guestfs-actions.pod:3216
12151 msgid "guestfs_kill_subprocess"
12152 msgstr ""
12153
12154 # type: verbatim
12155 #. type: verbatim
12156 #: ../src/guestfs-actions.pod:3218
12157 #, no-wrap
12158 msgid ""
12159 " int\n"
12160 " guestfs_kill_subprocess (guestfs_h *g);\n"
12161 "\n"
12162 msgstr ""
12163
12164 # type: textblock
12165 #. type: textblock
12166 #: ../src/guestfs-actions.pod:3221 ../fish/guestfish-actions.pod:2228
12167 msgid "This kills the qemu subprocess.  You should never need to call this."
12168 msgstr ""
12169
12170 # type: =head2
12171 #. type: =head2
12172 #: ../src/guestfs-actions.pod:3227
12173 msgid "guestfs_launch"
12174 msgstr ""
12175
12176 # type: verbatim
12177 #. type: verbatim
12178 #: ../src/guestfs-actions.pod:3229
12179 #, no-wrap
12180 msgid ""
12181 " int\n"
12182 " guestfs_launch (guestfs_h *g);\n"
12183 "\n"
12184 msgstr ""
12185
12186 # type: textblock
12187 #. type: textblock
12188 #: ../src/guestfs-actions.pod:3232 ../fish/guestfish-actions.pod:2236
12189 msgid ""
12190 "Internally libguestfs is implemented by running a virtual machine using "
12191 "L<qemu(1)>."
12192 msgstr ""
12193
12194 # type: textblock
12195 #. type: textblock
12196 #: ../src/guestfs-actions.pod:3235 ../fish/guestfish-actions.pod:2239
12197 msgid ""
12198 "You should call this after configuring the handle (eg. adding drives) but "
12199 "before performing any actions."
12200 msgstr ""
12201
12202 # type: =head2
12203 #. type: =head2
12204 #: ../src/guestfs-actions.pod:3242
12205 msgid "guestfs_lchown"
12206 msgstr ""
12207
12208 # type: verbatim
12209 #. type: verbatim
12210 #: ../src/guestfs-actions.pod:3244
12211 #, no-wrap
12212 msgid ""
12213 " int\n"
12214 " guestfs_lchown (guestfs_h *g,\n"
12215 "                 int owner,\n"
12216 "                 int group,\n"
12217 "                 const char *path);\n"
12218 "\n"
12219 msgstr ""
12220
12221 # type: textblock
12222 #. type: textblock
12223 #: ../src/guestfs-actions.pod:3250
12224 msgid ""
12225 "Change the file owner to C<owner> and group to C<group>.  This is like "
12226 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
12227 "changed, not the target."
12228 msgstr ""
12229
12230 # type: =head2
12231 #. type: =head2
12232 #: ../src/guestfs-actions.pod:3262
12233 msgid "guestfs_lgetxattr"
12234 msgstr ""
12235
12236 # type: verbatim
12237 #. type: verbatim
12238 #: ../src/guestfs-actions.pod:3264
12239 #, no-wrap
12240 msgid ""
12241 " char *\n"
12242 " guestfs_lgetxattr (guestfs_h *g,\n"
12243 "                    const char *path,\n"
12244 "                    const char *name,\n"
12245 "                    size_t *size_r);\n"
12246 "\n"
12247 msgstr ""
12248
12249 # type: textblock
12250 #. type: textblock
12251 #: ../src/guestfs-actions.pod:3270 ../fish/guestfish-actions.pod:2258
12252 msgid ""
12253 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
12254 "is a symlink, then this call returns an extended attribute from the symlink."
12255 msgstr ""
12256
12257 # type: textblock
12258 #. type: textblock
12259 #: ../src/guestfs-actions.pod:3284
12260 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
12261 msgstr ""
12262
12263 # type: =head2
12264 #. type: =head2
12265 #: ../src/guestfs-actions.pod:3292
12266 msgid "guestfs_lgetxattrs"
12267 msgstr ""
12268
12269 # type: verbatim
12270 #. type: verbatim
12271 #: ../src/guestfs-actions.pod:3294
12272 #, no-wrap
12273 msgid ""
12274 " struct guestfs_xattr_list *\n"
12275 " guestfs_lgetxattrs (guestfs_h *g,\n"
12276 "                     const char *path);\n"
12277 "\n"
12278 msgstr ""
12279
12280 # type: textblock
12281 #. type: textblock
12282 #: ../src/guestfs-actions.pod:3298
12283 msgid ""
12284 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
12285 "then it returns the extended attributes of the link itself."
12286 msgstr ""
12287
12288 # type: =head2
12289 #. type: =head2
12290 #: ../src/guestfs-actions.pod:3308
12291 msgid "guestfs_list_devices"
12292 msgstr ""
12293
12294 # type: verbatim
12295 #. type: verbatim
12296 #: ../src/guestfs-actions.pod:3310
12297 #, no-wrap
12298 msgid ""
12299 " char **\n"
12300 " guestfs_list_devices (guestfs_h *g);\n"
12301 "\n"
12302 msgstr ""
12303
12304 # type: textblock
12305 #. type: textblock
12306 #: ../src/guestfs-actions.pod:3313 ../fish/guestfish-actions.pod:2286
12307 msgid "List all the block devices."
12308 msgstr ""
12309
12310 # type: textblock
12311 #. type: textblock
12312 #: ../src/guestfs-actions.pod:3315 ../fish/guestfish-actions.pod:2288
12313 msgid "The full block device names are returned, eg. C</dev/sda>."
12314 msgstr ""
12315
12316 # type: =head2
12317 #. type: =head2
12318 #: ../src/guestfs-actions.pod:3325
12319 msgid "guestfs_list_filesystems"
12320 msgstr ""
12321
12322 # type: verbatim
12323 #. type: verbatim
12324 #: ../src/guestfs-actions.pod:3327
12325 #, no-wrap
12326 msgid ""
12327 " char **\n"
12328 " guestfs_list_filesystems (guestfs_h *g);\n"
12329 "\n"
12330 msgstr ""
12331
12332 # type: textblock
12333 #. type: textblock
12334 #: ../src/guestfs-actions.pod:3330 ../fish/guestfish-actions.pod:2296
12335 msgid ""
12336 "This inspection command looks for filesystems on partitions, block devices "
12337 "and logical volumes, returning a list of devices containing filesystems and "
12338 "their type."
12339 msgstr ""
12340
12341 # type: textblock
12342 #. type: textblock
12343 #: ../src/guestfs-actions.pod:3334 ../fish/guestfish-actions.pod:2300
12344 msgid ""
12345 "The return value is a hash, where the keys are the devices containing "
12346 "filesystems, and the values are the filesystem types.  For example:"
12347 msgstr ""
12348
12349 # type: verbatim
12350 #. type: verbatim
12351 #: ../src/guestfs-actions.pod:3338 ../fish/guestfish-actions.pod:2304
12352 #, no-wrap
12353 msgid ""
12354 " \"/dev/sda1\" => \"ntfs\"\n"
12355 " \"/dev/sda2\" => \"ext2\"\n"
12356 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
12357 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
12358 "\n"
12359 msgstr ""
12360
12361 # type: textblock
12362 #. type: textblock
12363 #: ../src/guestfs-actions.pod:3343 ../fish/guestfish-actions.pod:2309
12364 msgid ""
12365 "The value can have the special value \"unknown\", meaning the content of the "
12366 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
12367 msgstr ""
12368
12369 # type: textblock
12370 #. type: textblock
12371 #: ../src/guestfs-actions.pod:3347
12372 msgid ""
12373 "This command runs other libguestfs commands, which might include "
12374 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
12375 "soon after launch and only when nothing is mounted."
12376 msgstr ""
12377
12378 # type: textblock
12379 #. type: textblock
12380 #: ../src/guestfs-actions.pod:3351
12381 msgid ""
12382 "Not all of the filesystems returned will be mountable.  In particular, swap "
12383 "partitions are returned in the list.  Also this command does not check that "
12384 "each filesystem found is valid and mountable, and some filesystems might be "
12385 "mountable but require special options.  Filesystems may not all belong to a "
12386 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
12387 msgstr ""
12388
12389 # type: textblock
12390 #. type: textblock
12391 #: ../src/guestfs-actions.pod:3365 ../src/guestfs-actions.pod:4967
12392 msgid "(Added in 1.5.15)"
12393 msgstr ""
12394
12395 # type: =head2
12396 #. type: =head2
12397 #: ../src/guestfs-actions.pod:3367
12398 msgid "guestfs_list_partitions"
12399 msgstr ""
12400
12401 # type: verbatim
12402 #. type: verbatim
12403 #: ../src/guestfs-actions.pod:3369
12404 #, no-wrap
12405 msgid ""
12406 " char **\n"
12407 " guestfs_list_partitions (guestfs_h *g);\n"
12408 "\n"
12409 msgstr ""
12410
12411 # type: textblock
12412 #. type: textblock
12413 #: ../src/guestfs-actions.pod:3372 ../fish/guestfish-actions.pod:2329
12414 msgid "List all the partitions detected on all block devices."
12415 msgstr ""
12416
12417 # type: textblock
12418 #. type: textblock
12419 #: ../src/guestfs-actions.pod:3374 ../fish/guestfish-actions.pod:2331
12420 msgid "The full partition device names are returned, eg. C</dev/sda1>"
12421 msgstr ""
12422
12423 # type: textblock
12424 #. type: textblock
12425 #: ../src/guestfs-actions.pod:3376
12426 msgid ""
12427 "This does not return logical volumes.  For that you will need to call "
12428 "C<guestfs_lvs>."
12429 msgstr ""
12430
12431 # type: =head2
12432 #. type: =head2
12433 #: ../src/guestfs-actions.pod:3387
12434 msgid "guestfs_ll"
12435 msgstr ""
12436
12437 # type: verbatim
12438 #. type: verbatim
12439 #: ../src/guestfs-actions.pod:3389
12440 #, no-wrap
12441 msgid ""
12442 " char *\n"
12443 " guestfs_ll (guestfs_h *g,\n"
12444 "             const char *directory);\n"
12445 "\n"
12446 msgstr ""
12447
12448 # type: textblock
12449 #. type: textblock
12450 #: ../src/guestfs-actions.pod:3393 ../fish/guestfish-actions.pod:2342
12451 msgid ""
12452 "List the files in C<directory> (relative to the root directory, there is no "
12453 "cwd) in the format of 'ls -la'."
12454 msgstr ""
12455
12456 # type: textblock
12457 #. type: textblock
12458 #: ../src/guestfs-actions.pod:3396 ../fish/guestfish-actions.pod:2345
12459 msgid ""
12460 "This command is mostly useful for interactive sessions.  It is I<not> "
12461 "intended that you try to parse the output string."
12462 msgstr ""
12463
12464 # type: =head2
12465 #. type: =head2
12466 #: ../src/guestfs-actions.pod:3404
12467 msgid "guestfs_ln"
12468 msgstr ""
12469
12470 # type: verbatim
12471 #. type: verbatim
12472 #: ../src/guestfs-actions.pod:3406
12473 #, no-wrap
12474 msgid ""
12475 " int\n"
12476 " guestfs_ln (guestfs_h *g,\n"
12477 "             const char *target,\n"
12478 "             const char *linkname);\n"
12479 "\n"
12480 msgstr ""
12481
12482 # type: textblock
12483 #. type: textblock
12484 #: ../src/guestfs-actions.pod:3411 ../fish/guestfish-actions.pod:2352
12485 msgid "This command creates a hard link using the C<ln> command."
12486 msgstr ""
12487
12488 # type: =head2
12489 #. type: =head2
12490 #: ../src/guestfs-actions.pod:3417
12491 msgid "guestfs_ln_f"
12492 msgstr ""
12493
12494 # type: verbatim
12495 #. type: verbatim
12496 #: ../src/guestfs-actions.pod:3419
12497 #, no-wrap
12498 msgid ""
12499 " int\n"
12500 " guestfs_ln_f (guestfs_h *g,\n"
12501 "               const char *target,\n"
12502 "               const char *linkname);\n"
12503 "\n"
12504 msgstr ""
12505
12506 # type: textblock
12507 #. type: textblock
12508 #: ../src/guestfs-actions.pod:3424 ../fish/guestfish-actions.pod:2358
12509 msgid ""
12510 "This command creates a hard link using the C<ln -f> command.  The C<-f> "
12511 "option removes the link (C<linkname>) if it exists already."
12512 msgstr ""
12513
12514 # type: =head2
12515 #. type: =head2
12516 #: ../src/guestfs-actions.pod:3431
12517 msgid "guestfs_ln_s"
12518 msgstr ""
12519
12520 # type: verbatim
12521 #. type: verbatim
12522 #: ../src/guestfs-actions.pod:3433
12523 #, no-wrap
12524 msgid ""
12525 " int\n"
12526 " guestfs_ln_s (guestfs_h *g,\n"
12527 "               const char *target,\n"
12528 "               const char *linkname);\n"
12529 "\n"
12530 msgstr ""
12531
12532 # type: textblock
12533 #. type: textblock
12534 #: ../src/guestfs-actions.pod:3438 ../fish/guestfish-actions.pod:2365
12535 msgid "This command creates a symbolic link using the C<ln -s> command."
12536 msgstr ""
12537
12538 # type: =head2
12539 #. type: =head2
12540 #: ../src/guestfs-actions.pod:3444
12541 msgid "guestfs_ln_sf"
12542 msgstr ""
12543
12544 # type: verbatim
12545 #. type: verbatim
12546 #: ../src/guestfs-actions.pod:3446
12547 #, no-wrap
12548 msgid ""
12549 " int\n"
12550 " guestfs_ln_sf (guestfs_h *g,\n"
12551 "                const char *target,\n"
12552 "                const char *linkname);\n"
12553 "\n"
12554 msgstr ""
12555
12556 # type: textblock
12557 #. type: textblock
12558 #: ../src/guestfs-actions.pod:3451 ../fish/guestfish-actions.pod:2371
12559 msgid ""
12560 "This command creates a symbolic link using the C<ln -sf> command, The C<-f> "
12561 "option removes the link (C<linkname>) if it exists already."
12562 msgstr ""
12563
12564 # type: =head2
12565 #. type: =head2
12566 #: ../src/guestfs-actions.pod:3458
12567 msgid "guestfs_lremovexattr"
12568 msgstr ""
12569
12570 # type: verbatim
12571 #. type: verbatim
12572 #: ../src/guestfs-actions.pod:3460
12573 #, no-wrap
12574 msgid ""
12575 " int\n"
12576 " guestfs_lremovexattr (guestfs_h *g,\n"
12577 "                       const char *xattr,\n"
12578 "                       const char *path);\n"
12579 "\n"
12580 msgstr ""
12581
12582 # type: textblock
12583 #. type: textblock
12584 #: ../src/guestfs-actions.pod:3465
12585 msgid ""
12586 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
12587 "link, then it removes an extended attribute of the link itself."
12588 msgstr ""
12589
12590 # type: =head2
12591 #. type: =head2
12592 #: ../src/guestfs-actions.pod:3473
12593 msgid "guestfs_ls"
12594 msgstr ""
12595
12596 # type: verbatim
12597 #. type: verbatim
12598 #: ../src/guestfs-actions.pod:3475
12599 #, no-wrap
12600 msgid ""
12601 " char **\n"
12602 " guestfs_ls (guestfs_h *g,\n"
12603 "             const char *directory);\n"
12604 "\n"
12605 msgstr ""
12606
12607 # type: textblock
12608 #. type: textblock
12609 #: ../src/guestfs-actions.pod:3479 ../fish/guestfish-actions.pod:2386
12610 msgid ""
12611 "List the files in C<directory> (relative to the root directory, there is no "
12612 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
12613 msgstr ""
12614
12615 # type: textblock
12616 #. type: textblock
12617 #: ../src/guestfs-actions.pod:3483
12618 msgid ""
12619 "This command is mostly useful for interactive sessions.  Programs should "
12620 "probably use C<guestfs_readdir> instead."
12621 msgstr ""
12622
12623 # type: =head2
12624 #. type: =head2
12625 #: ../src/guestfs-actions.pod:3492
12626 msgid "guestfs_lsetxattr"
12627 msgstr ""
12628
12629 # type: verbatim
12630 #. type: verbatim
12631 #: ../src/guestfs-actions.pod:3494
12632 #, no-wrap
12633 msgid ""
12634 " int\n"
12635 " guestfs_lsetxattr (guestfs_h *g,\n"
12636 "                    const char *xattr,\n"
12637 "                    const char *val,\n"
12638 "                    int vallen,\n"
12639 "                    const char *path);\n"
12640 "\n"
12641 msgstr ""
12642
12643 # type: textblock
12644 #. type: textblock
12645 #: ../src/guestfs-actions.pod:3501
12646 msgid ""
12647 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
12648 "then it sets an extended attribute of the link itself."
12649 msgstr ""
12650
12651 # type: =head2
12652 #. type: =head2
12653 #: ../src/guestfs-actions.pod:3509
12654 msgid "guestfs_lstat"
12655 msgstr ""
12656
12657 # type: verbatim
12658 #. type: verbatim
12659 #: ../src/guestfs-actions.pod:3511
12660 #, no-wrap
12661 msgid ""
12662 " struct guestfs_stat *\n"
12663 " guestfs_lstat (guestfs_h *g,\n"
12664 "                const char *path);\n"
12665 "\n"
12666 msgstr ""
12667
12668 # type: textblock
12669 #. type: textblock
12670 #: ../src/guestfs-actions.pod:3515 ../src/guestfs-actions.pod:6021
12671 #: ../fish/guestfish-actions.pod:2405 ../fish/guestfish-actions.pod:4029
12672 msgid "Returns file information for the given C<path>."
12673 msgstr ""
12674
12675 # type: textblock
12676 #. type: textblock
12677 #: ../src/guestfs-actions.pod:3517
12678 msgid ""
12679 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
12680 "link, then the link is stat-ed, not the file it refers to."
12681 msgstr ""
12682
12683 # type: textblock
12684 #. type: textblock
12685 #: ../src/guestfs-actions.pod:3521 ../fish/guestfish-actions.pod:2411
12686 msgid "This is the same as the C<lstat(2)> system call."
12687 msgstr ""
12688
12689 # type: textblock
12690 #. type: textblock
12691 #: ../src/guestfs-actions.pod:3523 ../src/guestfs-actions.pod:6025
12692 msgid ""
12693 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
12694 "error.  I<The caller must call C<guestfs_free_stat> after use>."
12695 msgstr ""
12696
12697 # type: textblock
12698 #. type: textblock
12699 #: ../src/guestfs-actions.pod:3527 ../src/guestfs-actions.pod:6029
12700 #: ../src/guestfs-actions.pod:6047 ../src/guestfs-actions.pod:6428
12701 msgid "(Added in 0.9.2)"
12702 msgstr ""
12703
12704 # type: =head2
12705 #. type: =head2
12706 #: ../src/guestfs-actions.pod:3529
12707 msgid "guestfs_lstatlist"
12708 msgstr ""
12709
12710 # type: verbatim
12711 #. type: verbatim
12712 #: ../src/guestfs-actions.pod:3531
12713 #, no-wrap
12714 msgid ""
12715 " struct guestfs_stat_list *\n"
12716 " guestfs_lstatlist (guestfs_h *g,\n"
12717 "                    const char *path,\n"
12718 "                    char *const *names);\n"
12719 "\n"
12720 msgstr ""
12721
12722 # type: textblock
12723 #. type: textblock
12724 #: ../src/guestfs-actions.pod:3536
12725 msgid ""
12726 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
12727 "files, where all files are in the directory C<path>.  C<names> is the list "
12728 "of files from this directory."
12729 msgstr ""
12730
12731 # type: textblock
12732 #. type: textblock
12733 #: ../src/guestfs-actions.pod:3540 ../fish/guestfish-actions.pod:2421
12734 msgid ""
12735 "On return you get a list of stat structs, with a one-to-one correspondence "
12736 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
12737 "then the C<ino> field of that structure is set to C<-1>."
12738 msgstr ""
12739
12740 # type: textblock
12741 #. type: textblock
12742 #: ../src/guestfs-actions.pod:3545
12743 msgid ""
12744 "This call is intended for programs that want to efficiently list a directory "
12745 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
12746 "for a similarly efficient call for getting extended attributes.  Very long "
12747 "directory listings might cause the protocol message size to be exceeded, "
12748 "causing this call to fail.  The caller must split up such requests into "
12749 "smaller groups of names."
12750 msgstr ""
12751
12752 # type: textblock
12753 #. type: textblock
12754 #: ../src/guestfs-actions.pod:3553
12755 msgid ""
12756 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
12757 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
12758 msgstr ""
12759
12760 # type: =head2
12761 #. type: =head2
12762 #: ../src/guestfs-actions.pod:3559
12763 msgid "guestfs_luks_add_key"
12764 msgstr ""
12765
12766 # type: verbatim
12767 #. type: verbatim
12768 #: ../src/guestfs-actions.pod:3561
12769 #, no-wrap
12770 msgid ""
12771 " int\n"
12772 " guestfs_luks_add_key (guestfs_h *g,\n"
12773 "                       const char *device,\n"
12774 "                       const char *key,\n"
12775 "                       const char *newkey,\n"
12776 "                       int keyslot);\n"
12777 "\n"
12778 msgstr ""
12779
12780 # type: textblock
12781 #. type: textblock
12782 #: ../src/guestfs-actions.pod:3568 ../fish/guestfish-actions.pod:2438
12783 msgid ""
12784 "This command adds a new key on LUKS device C<device>.  C<key> is any "
12785 "existing key, and is used to access the device.  C<newkey> is the new key to "
12786 "add.  C<keyslot> is the key slot that will be replaced."
12787 msgstr ""
12788
12789 # type: textblock
12790 #. type: textblock
12791 #: ../src/guestfs-actions.pod:3573
12792 msgid ""
12793 "Note that if C<keyslot> already contains a key, then this command will "
12794 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
12795 msgstr ""
12796
12797 # type: textblock
12798 #. type: textblock
12799 #: ../src/guestfs-actions.pod:3579 ../src/guestfs-actions.pod:3619
12800 #: ../src/guestfs-actions.pod:3642 ../src/guestfs-actions.pod:3662
12801 #: ../src/guestfs-actions.pod:3694 ../src/guestfs-actions.pod:3713
12802 msgid ""
12803 "This function takes a key or passphrase parameter which could contain "
12804 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
12805 "information."
12806 msgstr ""
12807
12808 # type: textblock
12809 #. type: textblock
12810 #: ../src/guestfs-actions.pod:3583 ../src/guestfs-actions.pod:3623
12811 #: ../src/guestfs-actions.pod:3646 ../src/guestfs-actions.pod:3666
12812 msgid "(Added in 1.5.2)"
12813 msgstr ""
12814
12815 # type: =head2
12816 #. type: =head2
12817 #: ../src/guestfs-actions.pod:3585
12818 msgid "guestfs_luks_close"
12819 msgstr ""
12820
12821 # type: verbatim
12822 #. type: verbatim
12823 #: ../src/guestfs-actions.pod:3587
12824 #, no-wrap
12825 msgid ""
12826 " int\n"
12827 " guestfs_luks_close (guestfs_h *g,\n"
12828 "                     const char *device);\n"
12829 "\n"
12830 msgstr ""
12831
12832 # type: textblock
12833 #. type: textblock
12834 #: ../src/guestfs-actions.pod:3591
12835 msgid ""
12836 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
12837 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
12838 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
12839 "underlying block device."
12840 msgstr ""
12841
12842 # type: textblock
12843 #. type: textblock
12844 #: ../src/guestfs-actions.pod:3599 ../src/guestfs-actions.pod:3698
12845 #: ../src/guestfs-actions.pod:3717 ../src/guestfs-actions.pod:3767
12846 #: ../src/guestfs-actions.pod:3815
12847 msgid "(Added in 1.5.1)"
12848 msgstr ""
12849
12850 # type: =head2
12851 #. type: =head2
12852 #: ../src/guestfs-actions.pod:3601
12853 msgid "guestfs_luks_format"
12854 msgstr ""
12855
12856 # type: verbatim
12857 #. type: verbatim
12858 #: ../src/guestfs-actions.pod:3603
12859 #, no-wrap
12860 msgid ""
12861 " int\n"
12862 " guestfs_luks_format (guestfs_h *g,\n"
12863 "                      const char *device,\n"
12864 "                      const char *key,\n"
12865 "                      int keyslot);\n"
12866 "\n"
12867 msgstr ""
12868
12869 # type: textblock
12870 #. type: textblock
12871 #: ../src/guestfs-actions.pod:3609 ../fish/guestfish-actions.pod:2464
12872 msgid ""
12873 "This command erases existing data on C<device> and formats the device as a "
12874 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
12875 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
12876 msgstr ""
12877
12878 # type: textblock
12879 #. type: textblock
12880 #: ../src/guestfs-actions.pod:3616 ../src/guestfs-actions.pod:3639
12881 #: ../src/guestfs-actions.pod:3779 ../src/guestfs-actions.pod:4718
12882 #: ../src/guestfs-actions.pod:5481 ../src/guestfs-actions.pod:5856
12883 #: ../src/guestfs-actions.pod:5879 ../src/guestfs-actions.pod:5905
12884 #: ../src/guestfs-actions.pod:7065 ../fish/guestfish-actions.pod:2472
12885 #: ../fish/guestfish-actions.pod:2485 ../fish/guestfish-actions.pod:2569
12886 #: ../fish/guestfish-actions.pod:3141 ../fish/guestfish-actions.pod:3648
12887 #: ../fish/guestfish-actions.pod:3928 ../fish/guestfish-actions.pod:3944
12888 #: ../fish/guestfish-actions.pod:3959 ../fish/guestfish-actions.pod:4674
12889 msgid ""
12890 "B<This command is dangerous.  Without careful use you can easily destroy all "
12891 "your data>."
12892 msgstr ""
12893
12894 # type: =head2
12895 #. type: =head2
12896 #: ../src/guestfs-actions.pod:3625
12897 msgid "guestfs_luks_format_cipher"
12898 msgstr ""
12899
12900 # type: verbatim
12901 #. type: verbatim
12902 #: ../src/guestfs-actions.pod:3627
12903 #, no-wrap
12904 msgid ""
12905 " int\n"
12906 " guestfs_luks_format_cipher (guestfs_h *g,\n"
12907 "                             const char *device,\n"
12908 "                             const char *key,\n"
12909 "                             int keyslot,\n"
12910 "                             const char *cipher);\n"
12911 "\n"
12912 msgstr ""
12913
12914 # type: textblock
12915 #. type: textblock
12916 #: ../src/guestfs-actions.pod:3634
12917 msgid ""
12918 "This command is the same as C<guestfs_luks_format> but it also allows you to "
12919 "set the C<cipher> used."
12920 msgstr ""
12921
12922 # type: =head2
12923 #. type: =head2
12924 #: ../src/guestfs-actions.pod:3648
12925 msgid "guestfs_luks_kill_slot"
12926 msgstr ""
12927
12928 # type: verbatim
12929 #. type: verbatim
12930 #: ../src/guestfs-actions.pod:3650
12931 #, no-wrap
12932 msgid ""
12933 " int\n"
12934 " guestfs_luks_kill_slot (guestfs_h *g,\n"
12935 "                         const char *device,\n"
12936 "                         const char *key,\n"
12937 "                         int keyslot);\n"
12938 "\n"
12939 msgstr ""
12940
12941 # type: textblock
12942 #. type: textblock
12943 #: ../src/guestfs-actions.pod:3656 ../fish/guestfish-actions.pod:2492
12944 msgid ""
12945 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
12946 "device C<device>.  C<key> must be one of the I<other> keys."
12947 msgstr ""
12948
12949 # type: =head2
12950 #. type: =head2
12951 #: ../src/guestfs-actions.pod:3668
12952 msgid "guestfs_luks_open"
12953 msgstr ""
12954
12955 # type: verbatim
12956 #. type: verbatim
12957 #: ../src/guestfs-actions.pod:3670
12958 #, no-wrap
12959 msgid ""
12960 " int\n"
12961 " guestfs_luks_open (guestfs_h *g,\n"
12962 "                    const char *device,\n"
12963 "                    const char *key,\n"
12964 "                    const char *mapname);\n"
12965 "\n"
12966 msgstr ""
12967
12968 # type: textblock
12969 #. type: textblock
12970 #: ../src/guestfs-actions.pod:3676 ../fish/guestfish-actions.pod:2503
12971 msgid ""
12972 "This command opens a block device which has been encrypted according to the "
12973 "Linux Unified Key Setup (LUKS) standard."
12974 msgstr ""
12975
12976 # type: textblock
12977 #. type: textblock
12978 #: ../src/guestfs-actions.pod:3679 ../fish/guestfish-actions.pod:2506
12979 msgid "C<device> is the encrypted block device or partition."
12980 msgstr ""
12981
12982 # type: textblock
12983 #. type: textblock
12984 #: ../src/guestfs-actions.pod:3681 ../fish/guestfish-actions.pod:2508
12985 msgid ""
12986 "The caller must supply one of the keys associated with the LUKS block "
12987 "device, in the C<key> parameter."
12988 msgstr ""
12989
12990 # type: textblock
12991 #. type: textblock
12992 #: ../src/guestfs-actions.pod:3684 ../fish/guestfish-actions.pod:2511
12993 msgid ""
12994 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
12995 "writes to this block device are decrypted from and encrypted to the "
12996 "underlying C<device> respectively."
12997 msgstr ""
12998
12999 # type: textblock
13000 #. type: textblock
13001 #: ../src/guestfs-actions.pod:3688
13002 msgid ""
13003 "If this block device contains LVM volume groups, then calling "
13004 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
13005 "visible."
13006 msgstr ""
13007
13008 # type: =head2
13009 #. type: =head2
13010 #: ../src/guestfs-actions.pod:3700
13011 msgid "guestfs_luks_open_ro"
13012 msgstr ""
13013
13014 # type: verbatim
13015 #. type: verbatim
13016 #: ../src/guestfs-actions.pod:3702
13017 #, no-wrap
13018 msgid ""
13019 " int\n"
13020 " guestfs_luks_open_ro (guestfs_h *g,\n"
13021 "                       const char *device,\n"
13022 "                       const char *key,\n"
13023 "                       const char *mapname);\n"
13024 "\n"
13025 msgstr ""
13026
13027 # type: textblock
13028 #. type: textblock
13029 #: ../src/guestfs-actions.pod:3708
13030 msgid ""
13031 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
13032 "created."
13033 msgstr ""
13034
13035 # type: =head2
13036 #. type: =head2
13037 #: ../src/guestfs-actions.pod:3719
13038 msgid "guestfs_lvcreate"
13039 msgstr ""
13040
13041 # type: verbatim
13042 #. type: verbatim
13043 #: ../src/guestfs-actions.pod:3721
13044 #, no-wrap
13045 msgid ""
13046 " int\n"
13047 " guestfs_lvcreate (guestfs_h *g,\n"
13048 "                   const char *logvol,\n"
13049 "                   const char *volgroup,\n"
13050 "                   int mbytes);\n"
13051 "\n"
13052 msgstr ""
13053
13054 # type: textblock
13055 #. type: textblock
13056 #: ../src/guestfs-actions.pod:3727 ../fish/guestfish-actions.pod:2536
13057 msgid ""
13058 "This creates an LVM logical volume called C<logvol> on the volume group "
13059 "C<volgroup>, with C<size> megabytes."
13060 msgstr ""
13061
13062 # type: =head2
13063 #. type: =head2
13064 #: ../src/guestfs-actions.pod:3734
13065 msgid "guestfs_lvm_canonical_lv_name"
13066 msgstr ""
13067
13068 # type: verbatim
13069 #. type: verbatim
13070 #: ../src/guestfs-actions.pod:3736
13071 #, no-wrap
13072 msgid ""
13073 " char *\n"
13074 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
13075 "                                const char *lvname);\n"
13076 "\n"
13077 msgstr ""
13078
13079 # type: textblock
13080 #. type: textblock
13081 #: ../src/guestfs-actions.pod:3740 ../fish/guestfish-actions.pod:2543
13082 msgid ""
13083 "This converts alternative naming schemes for LVs that you might find to the "
13084 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
13085 "LV>."
13086 msgstr ""
13087
13088 # type: textblock
13089 #. type: textblock
13090 #: ../src/guestfs-actions.pod:3744 ../fish/guestfish-actions.pod:2547
13091 msgid ""
13092 "This command returns an error if the C<lvname> parameter does not refer to a "
13093 "logical volume."
13094 msgstr ""
13095
13096 # type: textblock
13097 #. type: textblock
13098 #: ../src/guestfs-actions.pod:3747
13099 msgid "See also C<guestfs_is_lv>."
13100 msgstr ""
13101
13102 # type: textblock
13103 #. type: textblock
13104 #: ../src/guestfs-actions.pod:3752
13105 msgid "(Added in 1.5.24)"
13106 msgstr ""
13107
13108 # type: =head2
13109 #. type: =head2
13110 #: ../src/guestfs-actions.pod:3754
13111 msgid "guestfs_lvm_clear_filter"
13112 msgstr ""
13113
13114 # type: verbatim
13115 #. type: verbatim
13116 #: ../src/guestfs-actions.pod:3756
13117 #, no-wrap
13118 msgid ""
13119 " int\n"
13120 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
13121 "\n"
13122 msgstr ""
13123
13124 # type: textblock
13125 #. type: textblock
13126 #: ../src/guestfs-actions.pod:3759
13127 msgid ""
13128 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
13129 "see every block device."
13130 msgstr ""
13131
13132 # type: textblock
13133 #. type: textblock
13134 #: ../src/guestfs-actions.pod:3762 ../src/guestfs-actions.pod:3804
13135 #: ../fish/guestfish-actions.pod:2559 ../fish/guestfish-actions.pod:2590
13136 msgid ""
13137 "This command also clears the LVM cache and performs a volume group scan."
13138 msgstr ""
13139
13140 # type: =head2
13141 #. type: =head2
13142 #: ../src/guestfs-actions.pod:3769
13143 msgid "guestfs_lvm_remove_all"
13144 msgstr ""
13145
13146 # type: verbatim
13147 #. type: verbatim
13148 #: ../src/guestfs-actions.pod:3771
13149 #, no-wrap
13150 msgid ""
13151 " int\n"
13152 " guestfs_lvm_remove_all (guestfs_h *g);\n"
13153 "\n"
13154 msgstr ""
13155
13156 # type: textblock
13157 #. type: textblock
13158 #: ../src/guestfs-actions.pod:3774 ../fish/guestfish-actions.pod:2566
13159 msgid ""
13160 "This command removes all LVM logical volumes, volume groups and physical "
13161 "volumes."
13162 msgstr ""
13163
13164 # type: =head2
13165 #. type: =head2
13166 #: ../src/guestfs-actions.pod:3784
13167 msgid "guestfs_lvm_set_filter"
13168 msgstr ""
13169
13170 # type: verbatim
13171 #. type: verbatim
13172 #: ../src/guestfs-actions.pod:3786
13173 #, no-wrap
13174 msgid ""
13175 " int\n"
13176 " guestfs_lvm_set_filter (guestfs_h *g,\n"
13177 "                         char *const *devices);\n"
13178 "\n"
13179 msgstr ""
13180
13181 # type: textblock
13182 #. type: textblock
13183 #: ../src/guestfs-actions.pod:3790 ../fish/guestfish-actions.pod:2576
13184 msgid ""
13185 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
13186 "block devices in the list C<devices>, and will ignore all other attached "
13187 "block devices."
13188 msgstr ""
13189
13190 # type: textblock
13191 #. type: textblock
13192 #: ../src/guestfs-actions.pod:3794 ../fish/guestfish-actions.pod:2580
13193 msgid ""
13194 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
13195 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
13196 "there are two types of duplication possible: either cloned PVs/VGs which "
13197 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
13198 "same name.  In normal operation you cannot create this situation, but you "
13199 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
13200 "inside the LVM metadata."
13201 msgstr ""
13202
13203 # type: textblock
13204 #. type: textblock
13205 #: ../src/guestfs-actions.pod:3807 ../fish/guestfish-actions.pod:2593
13206 msgid "You can filter whole block devices or individual partitions."
13207 msgstr ""
13208
13209 # type: textblock
13210 #. type: textblock
13211 #: ../src/guestfs-actions.pod:3809 ../fish/guestfish-actions.pod:2595
13212 msgid ""
13213 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
13214 "filesystem), even if you are not filtering out that VG."
13215 msgstr ""
13216
13217 # type: =head2
13218 #. type: =head2
13219 #: ../src/guestfs-actions.pod:3817
13220 msgid "guestfs_lvremove"
13221 msgstr ""
13222
13223 # type: verbatim
13224 #. type: verbatim
13225 #: ../src/guestfs-actions.pod:3819
13226 #, no-wrap
13227 msgid ""
13228 " int\n"
13229 " guestfs_lvremove (guestfs_h *g,\n"
13230 "                   const char *device);\n"
13231 "\n"
13232 msgstr ""
13233
13234 # type: textblock
13235 #. type: textblock
13236 #: ../src/guestfs-actions.pod:3823 ../fish/guestfish-actions.pod:2603
13237 msgid ""
13238 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
13239 "LV, such as C</dev/VG/LV>."
13240 msgstr ""
13241
13242 # type: textblock
13243 #. type: textblock
13244 #: ../src/guestfs-actions.pod:3826 ../fish/guestfish-actions.pod:2606
13245 msgid ""
13246 "You can also remove all LVs in a volume group by specifying the VG name, C</"
13247 "dev/VG>."
13248 msgstr ""
13249
13250 # type: textblock
13251 #. type: textblock
13252 #: ../src/guestfs-actions.pod:3831 ../src/guestfs-actions.pod:5064
13253 #: ../src/guestfs-actions.pod:6804
13254 msgid "(Added in 1.0.13)"
13255 msgstr ""
13256
13257 # type: =head2
13258 #. type: =head2
13259 #: ../src/guestfs-actions.pod:3833
13260 msgid "guestfs_lvrename"
13261 msgstr ""
13262
13263 # type: verbatim
13264 #. type: verbatim
13265 #: ../src/guestfs-actions.pod:3835
13266 #, no-wrap
13267 msgid ""
13268 " int\n"
13269 " guestfs_lvrename (guestfs_h *g,\n"
13270 "                   const char *logvol,\n"
13271 "                   const char *newlogvol);\n"
13272 "\n"
13273 msgstr ""
13274
13275 # type: textblock
13276 #. type: textblock
13277 #: ../src/guestfs-actions.pod:3840 ../fish/guestfish-actions.pod:2613
13278 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
13279 msgstr ""
13280
13281 # type: textblock
13282 #. type: textblock
13283 #: ../src/guestfs-actions.pod:3844 ../src/guestfs-actions.pod:6817
13284 msgid "(Added in 1.0.83)"
13285 msgstr ""
13286
13287 # type: =head2
13288 #. type: =head2
13289 #: ../src/guestfs-actions.pod:3846
13290 msgid "guestfs_lvresize"
13291 msgstr ""
13292
13293 # type: verbatim
13294 #. type: verbatim
13295 #: ../src/guestfs-actions.pod:3848
13296 #, no-wrap
13297 msgid ""
13298 " int\n"
13299 " guestfs_lvresize (guestfs_h *g,\n"
13300 "                   const char *device,\n"
13301 "                   int mbytes);\n"
13302 "\n"
13303 msgstr ""
13304
13305 # type: textblock
13306 #. type: textblock
13307 #: ../src/guestfs-actions.pod:3853 ../fish/guestfish-actions.pod:2619
13308 msgid ""
13309 "This resizes (expands or shrinks) an existing LVM logical volume to "
13310 "C<mbytes>.  When reducing, data in the reduced part is lost."
13311 msgstr ""
13312
13313 # type: =head2
13314 #. type: =head2
13315 #: ../src/guestfs-actions.pod:3861
13316 msgid "guestfs_lvresize_free"
13317 msgstr ""
13318
13319 # type: verbatim
13320 #. type: verbatim
13321 #: ../src/guestfs-actions.pod:3863
13322 #, no-wrap
13323 msgid ""
13324 " int\n"
13325 " guestfs_lvresize_free (guestfs_h *g,\n"
13326 "                        const char *lv,\n"
13327 "                        int percent);\n"
13328 "\n"
13329 msgstr ""
13330
13331 # type: textblock
13332 #. type: textblock
13333 #: ../src/guestfs-actions.pod:3868 ../fish/guestfish-actions.pod:2627
13334 msgid ""
13335 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
13336 "remaining free space in the volume group.  Commonly you would call this with "
13337 "pc = 100 which expands the logical volume as much as possible, using all "
13338 "remaining free space in the volume group."
13339 msgstr ""
13340
13341 # type: textblock
13342 #. type: textblock
13343 #: ../src/guestfs-actions.pod:3876
13344 msgid "(Added in 1.3.3)"
13345 msgstr ""
13346
13347 # type: =head2
13348 #. type: =head2
13349 #: ../src/guestfs-actions.pod:3878
13350 msgid "guestfs_lvs"
13351 msgstr ""
13352
13353 # type: verbatim
13354 #. type: verbatim
13355 #: ../src/guestfs-actions.pod:3880
13356 #, no-wrap
13357 msgid ""
13358 " char **\n"
13359 " guestfs_lvs (guestfs_h *g);\n"
13360 "\n"
13361 msgstr ""
13362
13363 # type: textblock
13364 #. type: textblock
13365 #: ../src/guestfs-actions.pod:3883 ../fish/guestfish-actions.pod:2637
13366 msgid ""
13367 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13368 "(8)> command."
13369 msgstr ""
13370
13371 # type: textblock
13372 #. type: textblock
13373 #: ../src/guestfs-actions.pod:3886 ../fish/guestfish-actions.pod:2640
13374 msgid ""
13375 "This returns a list of the logical volume device names (eg. C</dev/"
13376 "VolGroup00/LogVol00>)."
13377 msgstr ""
13378
13379 # type: textblock
13380 #. type: textblock
13381 #: ../src/guestfs-actions.pod:3889
13382 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
13383 msgstr ""
13384
13385 # type: =head2
13386 #. type: =head2
13387 #: ../src/guestfs-actions.pod:3897
13388 msgid "guestfs_lvs_full"
13389 msgstr ""
13390
13391 # type: verbatim
13392 #. type: verbatim
13393 #: ../src/guestfs-actions.pod:3899
13394 #, no-wrap
13395 msgid ""
13396 " struct guestfs_lvm_lv_list *\n"
13397 " guestfs_lvs_full (guestfs_h *g);\n"
13398 "\n"
13399 msgstr ""
13400
13401 # type: textblock
13402 #. type: textblock
13403 #: ../src/guestfs-actions.pod:3902 ../fish/guestfish-actions.pod:2649
13404 msgid ""
13405 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13406 "(8)> command.  The \"full\" version includes all fields."
13407 msgstr ""
13408
13409 # type: textblock
13410 #. type: textblock
13411 #: ../src/guestfs-actions.pod:3905
13412 msgid ""
13413 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
13414 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
13415 msgstr ""
13416
13417 # type: =head2
13418 #. type: =head2
13419 #: ../src/guestfs-actions.pod:3911
13420 msgid "guestfs_lvuuid"
13421 msgstr ""
13422
13423 # type: verbatim
13424 #. type: verbatim
13425 #: ../src/guestfs-actions.pod:3913
13426 #, no-wrap
13427 msgid ""
13428 " char *\n"
13429 " guestfs_lvuuid (guestfs_h *g,\n"
13430 "                 const char *device);\n"
13431 "\n"
13432 msgstr ""
13433
13434 # type: textblock
13435 #. type: textblock
13436 #: ../src/guestfs-actions.pod:3917 ../fish/guestfish-actions.pod:2656
13437 msgid "This command returns the UUID of the LVM LV C<device>."
13438 msgstr ""
13439
13440 # type: =head2
13441 #. type: =head2
13442 #: ../src/guestfs-actions.pod:3924
13443 msgid "guestfs_lxattrlist"
13444 msgstr ""
13445
13446 # type: verbatim
13447 #. type: verbatim
13448 #: ../src/guestfs-actions.pod:3926
13449 #, no-wrap
13450 msgid ""
13451 " struct guestfs_xattr_list *\n"
13452 " guestfs_lxattrlist (guestfs_h *g,\n"
13453 "                     const char *path,\n"
13454 "                     char *const *names);\n"
13455 "\n"
13456 msgstr ""
13457
13458 # type: textblock
13459 #. type: textblock
13460 #: ../src/guestfs-actions.pod:3931 ../fish/guestfish-actions.pod:2662
13461 msgid ""
13462 "This call allows you to get the extended attributes of multiple files, where "
13463 "all files are in the directory C<path>.  C<names> is the list of files from "
13464 "this directory."
13465 msgstr ""
13466
13467 # type: textblock
13468 #. type: textblock
13469 #: ../src/guestfs-actions.pod:3935 ../fish/guestfish-actions.pod:2666
13470 msgid ""
13471 "On return you get a flat list of xattr structs which must be interpreted "
13472 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
13473 "C<attrval> in this struct is zero-length to indicate there was an error "
13474 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
13475 "number (the number of following attributes for this file, which could be C<"
13476 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
13477 "for the first named file.  This repeats for the second and subsequent files."
13478 msgstr ""
13479
13480 # type: textblock
13481 #. type: textblock
13482 #: ../src/guestfs-actions.pod:3945
13483 msgid ""
13484 "This call is intended for programs that want to efficiently list a directory "
13485 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
13486 "a similarly efficient call for getting standard stats.  Very long directory "
13487 "listings might cause the protocol message size to be exceeded, causing this "
13488 "call to fail.  The caller must split up such requests into smaller groups of "
13489 "names."
13490 msgstr ""
13491
13492 # type: =head2
13493 #. type: =head2
13494 #: ../src/guestfs-actions.pod:3959
13495 msgid "guestfs_mkdir"
13496 msgstr ""
13497
13498 # type: verbatim
13499 #. type: verbatim
13500 #: ../src/guestfs-actions.pod:3961
13501 #, no-wrap
13502 msgid ""
13503 " int\n"
13504 " guestfs_mkdir (guestfs_h *g,\n"
13505 "                const char *path);\n"
13506 "\n"
13507 msgstr ""
13508
13509 # type: textblock
13510 #. type: textblock
13511 #: ../src/guestfs-actions.pod:3965 ../fish/guestfish-actions.pod:2688
13512 msgid "Create a directory named C<path>."
13513 msgstr ""
13514
13515 # type: =head2
13516 #. type: =head2
13517 #: ../src/guestfs-actions.pod:3971
13518 msgid "guestfs_mkdir_mode"
13519 msgstr ""
13520
13521 # type: verbatim
13522 #. type: verbatim
13523 #: ../src/guestfs-actions.pod:3973
13524 #, no-wrap
13525 msgid ""
13526 " int\n"
13527 " guestfs_mkdir_mode (guestfs_h *g,\n"
13528 "                     const char *path,\n"
13529 "                     int mode);\n"
13530 "\n"
13531 msgstr ""
13532
13533 # type: textblock
13534 #. type: textblock
13535 #: ../src/guestfs-actions.pod:3978 ../fish/guestfish-actions.pod:2694
13536 msgid ""
13537 "This command creates a directory, setting the initial permissions of the "
13538 "directory to C<mode>."
13539 msgstr ""
13540
13541 # type: textblock
13542 #. type: textblock
13543 #: ../src/guestfs-actions.pod:3981 ../fish/guestfish-actions.pod:2697
13544 msgid ""
13545 "For common Linux filesystems, the actual mode which is set will be C<mode & "
13546 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
13547 "other ways."
13548 msgstr ""
13549
13550 # type: textblock
13551 #. type: textblock
13552 #: ../src/guestfs-actions.pod:3985
13553 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
13554 msgstr ""
13555
13556 # type: =head2
13557 #. type: =head2
13558 #: ../src/guestfs-actions.pod:3991
13559 msgid "guestfs_mkdir_p"
13560 msgstr ""
13561
13562 # type: verbatim
13563 #. type: verbatim
13564 #: ../src/guestfs-actions.pod:3993
13565 #, no-wrap
13566 msgid ""
13567 " int\n"
13568 " guestfs_mkdir_p (guestfs_h *g,\n"
13569 "                  const char *path);\n"
13570 "\n"
13571 msgstr ""
13572
13573 # type: textblock
13574 #. type: textblock
13575 #: ../src/guestfs-actions.pod:3997 ../fish/guestfish-actions.pod:2707
13576 msgid ""
13577 "Create a directory named C<path>, creating any parent directories as "
13578 "necessary.  This is like the C<mkdir -p> shell command."
13579 msgstr ""
13580
13581 # type: =head2
13582 #. type: =head2
13583 #: ../src/guestfs-actions.pod:4004
13584 msgid "guestfs_mkdtemp"
13585 msgstr ""
13586
13587 # type: verbatim
13588 #. type: verbatim
13589 #: ../src/guestfs-actions.pod:4006
13590 #, no-wrap
13591 msgid ""
13592 " char *\n"
13593 " guestfs_mkdtemp (guestfs_h *g,\n"
13594 "                  const char *template);\n"
13595 "\n"
13596 msgstr ""
13597
13598 # type: textblock
13599 #. type: textblock
13600 #: ../src/guestfs-actions.pod:4010 ../fish/guestfish-actions.pod:2714
13601 msgid ""
13602 "This command creates a temporary directory.  The C<template> parameter "
13603 "should be a full pathname for the temporary directory name with the final "
13604 "six characters being \"XXXXXX\"."
13605 msgstr ""
13606
13607 # type: textblock
13608 #. type: textblock
13609 #: ../src/guestfs-actions.pod:4015 ../fish/guestfish-actions.pod:2719
13610 msgid ""
13611 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
13612 "being suitable for Windows filesystems."
13613 msgstr ""
13614
13615 # type: textblock
13616 #. type: textblock
13617 #: ../src/guestfs-actions.pod:4018 ../fish/guestfish-actions.pod:2722
13618 msgid "The name of the temporary directory that was created is returned."
13619 msgstr ""
13620
13621 # type: textblock
13622 #. type: textblock
13623 #: ../src/guestfs-actions.pod:4021 ../fish/guestfish-actions.pod:2725
13624 msgid "The temporary directory is created with mode 0700 and is owned by root."
13625 msgstr ""
13626
13627 # type: textblock
13628 #. type: textblock
13629 #: ../src/guestfs-actions.pod:4024 ../fish/guestfish-actions.pod:2728
13630 msgid ""
13631 "The caller is responsible for deleting the temporary directory and its "
13632 "contents after use."
13633 msgstr ""
13634
13635 # type: textblock
13636 #. type: textblock
13637 #: ../src/guestfs-actions.pod:4027 ../fish/guestfish-actions.pod:2731
13638 msgid "See also: L<mkdtemp(3)>"
13639 msgstr ""
13640
13641 # type: =head2
13642 #. type: =head2
13643 #: ../src/guestfs-actions.pod:4034
13644 msgid "guestfs_mke2fs_J"
13645 msgstr ""
13646
13647 # type: verbatim
13648 #. type: verbatim
13649 #: ../src/guestfs-actions.pod:4036
13650 #, no-wrap
13651 msgid ""
13652 " int\n"
13653 " guestfs_mke2fs_J (guestfs_h *g,\n"
13654 "                   const char *fstype,\n"
13655 "                   int blocksize,\n"
13656 "                   const char *device,\n"
13657 "                   const char *journal);\n"
13658 "\n"
13659 msgstr ""
13660
13661 # type: textblock
13662 #. type: textblock
13663 #: ../src/guestfs-actions.pod:4043 ../fish/guestfish-actions.pod:2737
13664 msgid ""
13665 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13666 "C<journal>.  It is equivalent to the command:"
13667 msgstr ""
13668
13669 # type: verbatim
13670 #. type: verbatim
13671 #: ../src/guestfs-actions.pod:4047 ../fish/guestfish-actions.pod:2741
13672 #, no-wrap
13673 msgid ""
13674 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
13675 "\n"
13676 msgstr ""
13677
13678 # type: textblock
13679 #. type: textblock
13680 #: ../src/guestfs-actions.pod:4049
13681 msgid "See also C<guestfs_mke2journal>."
13682 msgstr ""
13683
13684 # type: textblock
13685 #. type: textblock
13686 #: ../src/guestfs-actions.pod:4053 ../src/guestfs-actions.pod:4071
13687 #: ../src/guestfs-actions.pod:4089 ../src/guestfs-actions.pod:4105
13688 #: ../src/guestfs-actions.pod:4119 ../src/guestfs-actions.pod:4133
13689 #: ../src/guestfs-actions.pod:4192 ../src/guestfs-actions.pod:4445
13690 msgid "(Added in 1.0.68)"
13691 msgstr ""
13692
13693 # type: =head2
13694 #. type: =head2
13695 #: ../src/guestfs-actions.pod:4055
13696 msgid "guestfs_mke2fs_JL"
13697 msgstr ""
13698
13699 # type: verbatim
13700 #. type: verbatim
13701 #: ../src/guestfs-actions.pod:4057
13702 #, no-wrap
13703 msgid ""
13704 " int\n"
13705 " guestfs_mke2fs_JL (guestfs_h *g,\n"
13706 "                    const char *fstype,\n"
13707 "                    int blocksize,\n"
13708 "                    const char *device,\n"
13709 "                    const char *label);\n"
13710 "\n"
13711 msgstr ""
13712
13713 # type: textblock
13714 #. type: textblock
13715 #: ../src/guestfs-actions.pod:4064 ../fish/guestfish-actions.pod:2749
13716 msgid ""
13717 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13718 "the journal labeled C<label>."
13719 msgstr ""
13720
13721 # type: textblock
13722 #. type: textblock
13723 #: ../src/guestfs-actions.pod:4067
13724 msgid "See also C<guestfs_mke2journal_L>."
13725 msgstr ""
13726
13727 # type: =head2
13728 #. type: =head2
13729 #: ../src/guestfs-actions.pod:4073
13730 msgid "guestfs_mke2fs_JU"
13731 msgstr ""
13732
13733 # type: verbatim
13734 #. type: verbatim
13735 #: ../src/guestfs-actions.pod:4075
13736 #, no-wrap
13737 msgid ""
13738 " int\n"
13739 " guestfs_mke2fs_JU (guestfs_h *g,\n"
13740 "                    const char *fstype,\n"
13741 "                    int blocksize,\n"
13742 "                    const char *device,\n"
13743 "                    const char *uuid);\n"
13744 "\n"
13745 msgstr ""
13746
13747 # type: textblock
13748 #. type: textblock
13749 #: ../src/guestfs-actions.pod:4082 ../fish/guestfish-actions.pod:2758
13750 msgid ""
13751 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13752 "the journal with UUID C<uuid>."
13753 msgstr ""
13754
13755 # type: textblock
13756 #. type: textblock
13757 #: ../src/guestfs-actions.pod:4085
13758 msgid "See also C<guestfs_mke2journal_U>."
13759 msgstr ""
13760
13761 # type: =head2
13762 #. type: =head2
13763 #: ../src/guestfs-actions.pod:4091
13764 msgid "guestfs_mke2journal"
13765 msgstr ""
13766
13767 # type: verbatim
13768 #. type: verbatim
13769 #: ../src/guestfs-actions.pod:4093
13770 #, no-wrap
13771 msgid ""
13772 " int\n"
13773 " guestfs_mke2journal (guestfs_h *g,\n"
13774 "                      int blocksize,\n"
13775 "                      const char *device);\n"
13776 "\n"
13777 msgstr ""
13778
13779 # type: textblock
13780 #. type: textblock
13781 #: ../src/guestfs-actions.pod:4098 ../fish/guestfish-actions.pod:2767
13782 msgid ""
13783 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
13784 "command:"
13785 msgstr ""
13786
13787 # type: verbatim
13788 #. type: verbatim
13789 #: ../src/guestfs-actions.pod:4101 ../fish/guestfish-actions.pod:2770
13790 #, no-wrap
13791 msgid ""
13792 " mke2fs -O journal_dev -b blocksize device\n"
13793 "\n"
13794 msgstr ""
13795
13796 # type: =head2
13797 #. type: =head2
13798 #: ../src/guestfs-actions.pod:4107
13799 msgid "guestfs_mke2journal_L"
13800 msgstr ""
13801
13802 # type: verbatim
13803 #. type: verbatim
13804 #: ../src/guestfs-actions.pod:4109
13805 #, no-wrap
13806 msgid ""
13807 " int\n"
13808 " guestfs_mke2journal_L (guestfs_h *g,\n"
13809 "                        int blocksize,\n"
13810 "                        const char *label,\n"
13811 "                        const char *device);\n"
13812 "\n"
13813 msgstr ""
13814
13815 # type: textblock
13816 #. type: textblock
13817 #: ../src/guestfs-actions.pod:4115 ../fish/guestfish-actions.pod:2776
13818 msgid "This creates an ext2 external journal on C<device> with label C<label>."
13819 msgstr ""
13820
13821 # type: =head2
13822 #. type: =head2
13823 #: ../src/guestfs-actions.pod:4121
13824 msgid "guestfs_mke2journal_U"
13825 msgstr ""
13826
13827 # type: verbatim
13828 #. type: verbatim
13829 #: ../src/guestfs-actions.pod:4123
13830 #, no-wrap
13831 msgid ""
13832 " int\n"
13833 " guestfs_mke2journal_U (guestfs_h *g,\n"
13834 "                        int blocksize,\n"
13835 "                        const char *uuid,\n"
13836 "                        const char *device);\n"
13837 "\n"
13838 msgstr ""
13839
13840 # type: textblock
13841 #. type: textblock
13842 #: ../src/guestfs-actions.pod:4129 ../fish/guestfish-actions.pod:2782
13843 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
13844 msgstr ""
13845
13846 # type: =head2
13847 #. type: =head2
13848 #: ../src/guestfs-actions.pod:4135
13849 msgid "guestfs_mkfifo"
13850 msgstr ""
13851
13852 # type: verbatim
13853 #. type: verbatim
13854 #: ../src/guestfs-actions.pod:4137
13855 #, no-wrap
13856 msgid ""
13857 " int\n"
13858 " guestfs_mkfifo (guestfs_h *g,\n"
13859 "                 int mode,\n"
13860 "                 const char *path);\n"
13861 "\n"
13862 msgstr ""
13863
13864 # type: textblock
13865 #. type: textblock
13866 #: ../src/guestfs-actions.pod:4142
13867 msgid ""
13868 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
13869 "is just a convenient wrapper around C<guestfs_mknod>."
13870 msgstr ""
13871
13872 # type: =head2
13873 #. type: =head2
13874 #: ../src/guestfs-actions.pod:4152
13875 msgid "guestfs_mkfs"
13876 msgstr ""
13877
13878 # type: verbatim
13879 #. type: verbatim
13880 #: ../src/guestfs-actions.pod:4154
13881 #, no-wrap
13882 msgid ""
13883 " int\n"
13884 " guestfs_mkfs (guestfs_h *g,\n"
13885 "               const char *fstype,\n"
13886 "               const char *device);\n"
13887 "\n"
13888 msgstr ""
13889
13890 # type: textblock
13891 #. type: textblock
13892 #: ../src/guestfs-actions.pod:4159 ../fish/guestfish-actions.pod:2798
13893 msgid ""
13894 "This creates a filesystem on C<device> (usually a partition or LVM logical "
13895 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
13896 msgstr ""
13897
13898 # type: =head2
13899 #. type: =head2
13900 #: ../src/guestfs-actions.pod:4167
13901 msgid "guestfs_mkfs_b"
13902 msgstr ""
13903
13904 # type: verbatim
13905 #. type: verbatim
13906 #: ../src/guestfs-actions.pod:4169
13907 #, no-wrap
13908 msgid ""
13909 " int\n"
13910 " guestfs_mkfs_b (guestfs_h *g,\n"
13911 "                 const char *fstype,\n"
13912 "                 int blocksize,\n"
13913 "                 const char *device);\n"
13914 "\n"
13915 msgstr ""
13916
13917 # type: textblock
13918 #. type: textblock
13919 #: ../src/guestfs-actions.pod:4175
13920 msgid ""
13921 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
13922 "block size of the resulting filesystem.  Supported block sizes depend on the "
13923 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
13924 msgstr ""
13925
13926 # type: textblock
13927 #. type: textblock
13928 #: ../src/guestfs-actions.pod:4180 ../src/guestfs-actions.pod:4222
13929 #: ../fish/guestfish-actions.pod:2811 ../fish/guestfish-actions.pod:2838
13930 msgid ""
13931 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
13932 "cluster size."
13933 msgstr ""
13934
13935 #. type: textblock
13936 #: ../src/guestfs-actions.pod:4185
13937 msgid ""
13938 "This function is deprecated.  In new code, use the L</guestfs_mkfs_opts> "
13939 "call instead."
13940 msgstr ""
13941
13942 # type: =head2
13943 #. type: =head2
13944 #: ../src/guestfs-actions.pod:4194
13945 msgid "guestfs_mkfs_opts"
13946 msgstr ""
13947
13948 # type: verbatim
13949 #. type: verbatim
13950 #: ../src/guestfs-actions.pod:4196
13951 #, no-wrap
13952 msgid ""
13953 " int\n"
13954 " guestfs_mkfs_opts (guestfs_h *g,\n"
13955 "                    const char *fstype,\n"
13956 "                    const char *device,\n"
13957 "                    ...);\n"
13958 "\n"
13959 msgstr ""
13960
13961 # type: verbatim
13962 #. type: verbatim
13963 #: ../src/guestfs-actions.pod:4207
13964 #, no-wrap
13965 msgid ""
13966 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
13967 "\n"
13968 msgstr ""
13969
13970 # type: textblock
13971 #. type: textblock
13972 #: ../src/guestfs-actions.pod:4209 ../fish/guestfish-actions.pod:2825
13973 msgid ""
13974 "This function creates a filesystem on C<device>.  The filesystem type is "
13975 "C<fstype>, for example C<ext3>."
13976 msgstr ""
13977
13978 # type: =item
13979 #. type: =item
13980 #: ../src/guestfs-actions.pod:4216 ../fish/guestfish-actions.pod:2832
13981 msgid "C<blocksize>"
13982 msgstr ""
13983
13984 # type: textblock
13985 #. type: textblock
13986 #: ../src/guestfs-actions.pod:4218 ../fish/guestfish-actions.pod:2834
13987 msgid ""
13988 "The filesystem block size.  Supported block sizes depend on the filesystem "
13989 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
13990 "filesystems."
13991 msgstr ""
13992
13993 #. type: textblock
13994 #: ../src/guestfs-actions.pod:4225 ../fish/guestfish-actions.pod:2841
13995 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
13996 msgstr ""
13997
13998 #. type: textblock
13999 #: ../src/guestfs-actions.pod:4231
14000 msgid "(Added in 1.7.19)"
14001 msgstr ""
14002
14003 # type: =head2
14004 #. type: =head2
14005 #: ../src/guestfs-actions.pod:4233
14006 msgid "guestfs_mkfs_opts_va"
14007 msgstr ""
14008
14009 # type: verbatim
14010 #. type: verbatim
14011 #: ../src/guestfs-actions.pod:4235
14012 #, no-wrap
14013 msgid ""
14014 " int\n"
14015 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
14016 "                       const char *fstype,\n"
14017 "                       const char *device,\n"
14018 "                       va_list args);\n"
14019 "\n"
14020 msgstr ""
14021
14022 # type: textblock
14023 #. type: textblock
14024 #: ../src/guestfs-actions.pod:4241
14025 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
14026 msgstr ""
14027
14028 # type: =head2
14029 #. type: =head2
14030 #: ../src/guestfs-actions.pod:4245
14031 msgid "guestfs_mkfs_opts_argv"
14032 msgstr ""
14033
14034 # type: verbatim
14035 #. type: verbatim
14036 #: ../src/guestfs-actions.pod:4247
14037 #, no-wrap
14038 msgid ""
14039 " int\n"
14040 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
14041 "                         const char *fstype,\n"
14042 "                         const char *device,\n"
14043 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
14044 "\n"
14045 msgstr ""
14046
14047 # type: textblock
14048 #. type: textblock
14049 #: ../src/guestfs-actions.pod:4253
14050 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
14051 msgstr ""
14052
14053 # type: =head2
14054 #. type: =head2
14055 #: ../src/guestfs-actions.pod:4257
14056 msgid "guestfs_mkmountpoint"
14057 msgstr ""
14058
14059 # type: verbatim
14060 #. type: verbatim
14061 #: ../src/guestfs-actions.pod:4259
14062 #, no-wrap
14063 msgid ""
14064 " int\n"
14065 " guestfs_mkmountpoint (guestfs_h *g,\n"
14066 "                       const char *exemptpath);\n"
14067 "\n"
14068 msgstr ""
14069
14070 # type: textblock
14071 #. type: textblock
14072 #: ../src/guestfs-actions.pod:4263
14073 msgid ""
14074 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
14075 "that can be used to create extra mountpoints before mounting the first "
14076 "filesystem."
14077 msgstr ""
14078
14079 # type: textblock
14080 #. type: textblock
14081 #: ../src/guestfs-actions.pod:4267 ../fish/guestfish-actions.pod:2855
14082 msgid ""
14083 "These calls are I<only> necessary in some very limited circumstances, mainly "
14084 "the case where you want to mount a mix of unrelated and/or read-only "
14085 "filesystems together."
14086 msgstr ""
14087
14088 # type: textblock
14089 #. type: textblock
14090 #: ../src/guestfs-actions.pod:4271 ../fish/guestfish-actions.pod:2859
14091 msgid ""
14092 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
14093 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
14094 "inside that.  You can unpack this as follows in guestfish:"
14095 msgstr ""
14096
14097 # type: verbatim
14098 #. type: verbatim
14099 #: ../src/guestfs-actions.pod:4276 ../fish/guestfish-actions.pod:2864
14100 #, no-wrap
14101 msgid ""
14102 " add-ro Fedora-11-i686-Live.iso\n"
14103 " run\n"
14104 " mkmountpoint /cd\n"
14105 " mkmountpoint /sqsh\n"
14106 " mkmountpoint /ext3fs\n"
14107 " mount /dev/sda /cd\n"
14108 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
14109 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
14110 "\n"
14111 msgstr ""
14112
14113 # type: textblock
14114 #. type: textblock
14115 #: ../src/guestfs-actions.pod:4285 ../fish/guestfish-actions.pod:2873
14116 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
14117 msgstr ""
14118
14119 # type: textblock
14120 #. type: textblock
14121 #: ../src/guestfs-actions.pod:4287
14122 msgid ""
14123 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
14124 "may get unexpected errors if you try to mix these calls.  It is safest to "
14125 "manually unmount filesystems and remove mountpoints after use."
14126 msgstr ""
14127
14128 # type: textblock
14129 #. type: textblock
14130 #: ../src/guestfs-actions.pod:4291
14131 msgid ""
14132 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
14133 "first, so for this to work for manual mountpoints, you must ensure that the "
14134 "innermost mountpoints have the longest pathnames, as in the example code "
14135 "above."
14136 msgstr ""
14137
14138 # type: textblock
14139 #. type: textblock
14140 #: ../src/guestfs-actions.pod:4296 ../fish/guestfish-actions.pod:2884
14141 msgid ""
14142 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
14143 msgstr ""
14144
14145 # type: textblock
14146 #. type: textblock
14147 #: ../src/guestfs-actions.pod:4298
14148 msgid ""
14149 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
14150 "means that C<guestfs_umount_all> is called when the handle is closed which "
14151 "can also trigger these issues."
14152 msgstr ""
14153
14154 # type: textblock
14155 #. type: textblock
14156 #: ../src/guestfs-actions.pod:4304 ../src/guestfs-actions.pod:4563
14157 #: ../src/guestfs-actions.pod:5465
14158 msgid "(Added in 1.0.62)"
14159 msgstr ""
14160
14161 # type: =head2
14162 #. type: =head2
14163 #: ../src/guestfs-actions.pod:4306
14164 msgid "guestfs_mknod"
14165 msgstr ""
14166
14167 # type: verbatim
14168 #. type: verbatim
14169 #: ../src/guestfs-actions.pod:4308
14170 #, no-wrap
14171 msgid ""
14172 " int\n"
14173 " guestfs_mknod (guestfs_h *g,\n"
14174 "                int mode,\n"
14175 "                int devmajor,\n"
14176 "                int devminor,\n"
14177 "                const char *path);\n"
14178 "\n"
14179 msgstr ""
14180
14181 # type: textblock
14182 #. type: textblock
14183 #: ../src/guestfs-actions.pod:4315 ../fish/guestfish-actions.pod:2894
14184 msgid ""
14185 "This call creates block or character special devices, or named pipes (FIFOs)."
14186 msgstr ""
14187
14188 # type: textblock
14189 #. type: textblock
14190 #: ../src/guestfs-actions.pod:4318 ../fish/guestfish-actions.pod:2897
14191 msgid ""
14192 "The C<mode> parameter should be the mode, using the standard constants.  "
14193 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
14194 "used when creating block and character special devices."
14195 msgstr ""
14196
14197 # type: textblock
14198 #. type: textblock
14199 #: ../src/guestfs-actions.pod:4323
14200 msgid ""
14201 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
14202 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
14203 "regular file).  These constants are available in the standard Linux header "
14204 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
14205 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
14206 "the appropriate constant for you."
14207 msgstr ""
14208
14209 # type: =head2
14210 #. type: =head2
14211 #: ../src/guestfs-actions.pod:4337
14212 msgid "guestfs_mknod_b"
14213 msgstr ""
14214
14215 # type: verbatim
14216 #. type: verbatim
14217 #: ../src/guestfs-actions.pod:4339
14218 #, no-wrap
14219 msgid ""
14220 " int\n"
14221 " guestfs_mknod_b (guestfs_h *g,\n"
14222 "                  int mode,\n"
14223 "                  int devmajor,\n"
14224 "                  int devminor,\n"
14225 "                  const char *path);\n"
14226 "\n"
14227 msgstr ""
14228
14229 # type: textblock
14230 #. type: textblock
14231 #: ../src/guestfs-actions.pod:4346
14232 msgid ""
14233 "This call creates a block device node called C<path> with mode C<mode> and "
14234 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
14235 "wrapper around C<guestfs_mknod>."
14236 msgstr ""
14237
14238 # type: =head2
14239 #. type: =head2
14240 #: ../src/guestfs-actions.pod:4356
14241 msgid "guestfs_mknod_c"
14242 msgstr ""
14243
14244 # type: verbatim
14245 #. type: verbatim
14246 #: ../src/guestfs-actions.pod:4358
14247 #, no-wrap
14248 msgid ""
14249 " int\n"
14250 " guestfs_mknod_c (guestfs_h *g,\n"
14251 "                  int mode,\n"
14252 "                  int devmajor,\n"
14253 "                  int devminor,\n"
14254 "                  const char *path);\n"
14255 "\n"
14256 msgstr ""
14257
14258 # type: textblock
14259 #. type: textblock
14260 #: ../src/guestfs-actions.pod:4365
14261 msgid ""
14262 "This call creates a char device node called C<path> with mode C<mode> and "
14263 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
14264 "wrapper around C<guestfs_mknod>."
14265 msgstr ""
14266
14267 # type: =head2
14268 #. type: =head2
14269 #: ../src/guestfs-actions.pod:4375
14270 msgid "guestfs_mkswap"
14271 msgstr ""
14272
14273 # type: verbatim
14274 #. type: verbatim
14275 #: ../src/guestfs-actions.pod:4377
14276 #, no-wrap
14277 msgid ""
14278 " int\n"
14279 " guestfs_mkswap (guestfs_h *g,\n"
14280 "                 const char *device);\n"
14281 "\n"
14282 msgstr ""
14283
14284 # type: textblock
14285 #. type: textblock
14286 #: ../src/guestfs-actions.pod:4381 ../fish/guestfish-actions.pod:2936
14287 msgid "Create a swap partition on C<device>."
14288 msgstr ""
14289
14290 # type: =head2
14291 #. type: =head2
14292 #: ../src/guestfs-actions.pod:4387
14293 msgid "guestfs_mkswap_L"
14294 msgstr ""
14295
14296 # type: verbatim
14297 #. type: verbatim
14298 #: ../src/guestfs-actions.pod:4389
14299 #, no-wrap
14300 msgid ""
14301 " int\n"
14302 " guestfs_mkswap_L (guestfs_h *g,\n"
14303 "                   const char *label,\n"
14304 "                   const char *device);\n"
14305 "\n"
14306 msgstr ""
14307
14308 # type: textblock
14309 #. type: textblock
14310 #: ../src/guestfs-actions.pod:4394 ../fish/guestfish-actions.pod:2942
14311 msgid "Create a swap partition on C<device> with label C<label>."
14312 msgstr ""
14313
14314 # type: textblock
14315 #. type: textblock
14316 #: ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:2944
14317 msgid ""
14318 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
14319 "sda>), just to a partition.  This appears to be a limitation of the kernel "
14320 "or swap tools."
14321 msgstr ""
14322
14323 # type: =head2
14324 #. type: =head2
14325 #: ../src/guestfs-actions.pod:4404
14326 msgid "guestfs_mkswap_U"
14327 msgstr ""
14328
14329 # type: verbatim
14330 #. type: verbatim
14331 #: ../src/guestfs-actions.pod:4406
14332 #, no-wrap
14333 msgid ""
14334 " int\n"
14335 " guestfs_mkswap_U (guestfs_h *g,\n"
14336 "                   const char *uuid,\n"
14337 "                   const char *device);\n"
14338 "\n"
14339 msgstr ""
14340
14341 # type: textblock
14342 #. type: textblock
14343 #: ../src/guestfs-actions.pod:4411 ../fish/guestfish-actions.pod:2952
14344 msgid "Create a swap partition on C<device> with UUID C<uuid>."
14345 msgstr ""
14346
14347 # type: =head2
14348 #. type: =head2
14349 #: ../src/guestfs-actions.pod:4417
14350 msgid "guestfs_mkswap_file"
14351 msgstr ""
14352
14353 # type: verbatim
14354 #. type: verbatim
14355 #: ../src/guestfs-actions.pod:4419
14356 #, no-wrap
14357 msgid ""
14358 " int\n"
14359 " guestfs_mkswap_file (guestfs_h *g,\n"
14360 "                      const char *path);\n"
14361 "\n"
14362 msgstr ""
14363
14364 # type: textblock
14365 #. type: textblock
14366 #: ../src/guestfs-actions.pod:4423 ../fish/guestfish-actions.pod:2958
14367 msgid "Create a swap file."
14368 msgstr ""
14369
14370 # type: textblock
14371 #. type: textblock
14372 #: ../src/guestfs-actions.pod:4425
14373 msgid ""
14374 "This command just writes a swap file signature to an existing file.  To "
14375 "create the file itself, use something like C<guestfs_fallocate>."
14376 msgstr ""
14377
14378 # type: =head2
14379 #. type: =head2
14380 #: ../src/guestfs-actions.pod:4432
14381 msgid "guestfs_modprobe"
14382 msgstr ""
14383
14384 # type: verbatim
14385 #. type: verbatim
14386 #: ../src/guestfs-actions.pod:4434
14387 #, no-wrap
14388 msgid ""
14389 " int\n"
14390 " guestfs_modprobe (guestfs_h *g,\n"
14391 "                   const char *modulename);\n"
14392 "\n"
14393 msgstr ""
14394
14395 # type: textblock
14396 #. type: textblock
14397 #: ../src/guestfs-actions.pod:4438 ../fish/guestfish-actions.pod:2967
14398 msgid "This loads a kernel module in the appliance."
14399 msgstr ""
14400
14401 # type: textblock
14402 #. type: textblock
14403 #: ../src/guestfs-actions.pod:4440 ../fish/guestfish-actions.pod:2969
14404 msgid ""
14405 "The kernel module must have been whitelisted when libguestfs was built (see "
14406 "C<appliance/kmod.whitelist.in> in the source)."
14407 msgstr ""
14408
14409 # type: =head2
14410 #. type: =head2
14411 #: ../src/guestfs-actions.pod:4447
14412 msgid "guestfs_mount"
14413 msgstr ""
14414
14415 # type: verbatim
14416 #. type: verbatim
14417 #: ../src/guestfs-actions.pod:4449
14418 #, no-wrap
14419 msgid ""
14420 " int\n"
14421 " guestfs_mount (guestfs_h *g,\n"
14422 "                const char *device,\n"
14423 "                const char *mountpoint);\n"
14424 "\n"
14425 msgstr ""
14426
14427 # type: textblock
14428 #. type: textblock
14429 #: ../src/guestfs-actions.pod:4454 ../fish/guestfish-actions.pod:2976
14430 msgid ""
14431 "Mount a guest disk at a position in the filesystem.  Block devices are named "
14432 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
14433 "those block devices contain partitions, they will have the usual names (eg. "
14434 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
14435 msgstr ""
14436
14437 # type: textblock
14438 #. type: textblock
14439 #: ../src/guestfs-actions.pod:4460 ../fish/guestfish-actions.pod:2982
14440 msgid ""
14441 "The rules are the same as for L<mount(2)>: A filesystem must first be "
14442 "mounted on C</> before others can be mounted.  Other filesystems can only be "
14443 "mounted on directories which already exist."
14444 msgstr ""
14445
14446 # type: textblock
14447 #. type: textblock
14448 #: ../src/guestfs-actions.pod:4465 ../fish/guestfish-actions.pod:2987
14449 msgid ""
14450 "The mounted filesystem is writable, if we have sufficient permissions on the "
14451 "underlying device."
14452 msgstr ""
14453
14454 # type: textblock
14455 #. type: textblock
14456 #: ../src/guestfs-actions.pod:4468
14457 msgid ""
14458 "B<Important note:> When you use this call, the filesystem options C<sync> "
14459 "and C<noatime> are set implicitly.  This was originally done because we "
14460 "thought it would improve reliability, but it turns out that I<-o sync> has a "
14461 "very large negative performance impact and negligible effect on "
14462 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
14463 "in any code that needs performance, and instead use C<guestfs_mount_options> "
14464 "(use an empty string for the first parameter if you don't want any options)."
14465 msgstr ""
14466
14467 # type: =head2
14468 #. type: =head2
14469 #: ../src/guestfs-actions.pod:4482
14470 msgid "guestfs_mount_loop"
14471 msgstr ""
14472
14473 # type: verbatim
14474 #. type: verbatim
14475 #: ../src/guestfs-actions.pod:4484
14476 #, no-wrap
14477 msgid ""
14478 " int\n"
14479 " guestfs_mount_loop (guestfs_h *g,\n"
14480 "                     const char *file,\n"
14481 "                     const char *mountpoint);\n"
14482 "\n"
14483 msgstr ""
14484
14485 # type: textblock
14486 #. type: textblock
14487 #: ../src/guestfs-actions.pod:4489 ../fish/guestfish-actions.pod:3004
14488 msgid ""
14489 "This command lets you mount C<file> (a filesystem image in a file) on a "
14490 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
14491 "mountpoint>."
14492 msgstr ""
14493
14494 # type: =head2
14495 #. type: =head2
14496 #: ../src/guestfs-actions.pod:4497
14497 msgid "guestfs_mount_options"
14498 msgstr ""
14499
14500 # type: verbatim
14501 #. type: verbatim
14502 #: ../src/guestfs-actions.pod:4499
14503 #, no-wrap
14504 msgid ""
14505 " int\n"
14506 " guestfs_mount_options (guestfs_h *g,\n"
14507 "                        const char *options,\n"
14508 "                        const char *device,\n"
14509 "                        const char *mountpoint);\n"
14510 "\n"
14511 msgstr ""
14512
14513 # type: textblock
14514 #. type: textblock
14515 #: ../src/guestfs-actions.pod:4505
14516 msgid ""
14517 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14518 "the mount options as for the L<mount(8)> I<-o> flag."
14519 msgstr ""
14520
14521 # type: textblock
14522 #. type: textblock
14523 #: ../src/guestfs-actions.pod:4509 ../fish/guestfish-actions.pod:3016
14524 msgid ""
14525 "If the C<options> parameter is an empty string, then no options are passed "
14526 "(all options default to whatever the filesystem uses)."
14527 msgstr ""
14528
14529 # type: textblock
14530 #. type: textblock
14531 #: ../src/guestfs-actions.pod:4515 ../src/guestfs-actions.pod:4529
14532 #: ../src/guestfs-actions.pod:4546
14533 msgid "(Added in 1.0.10)"
14534 msgstr ""
14535
14536 # type: =head2
14537 #. type: =head2
14538 #: ../src/guestfs-actions.pod:4517
14539 msgid "guestfs_mount_ro"
14540 msgstr ""
14541
14542 # type: verbatim
14543 #. type: verbatim
14544 #: ../src/guestfs-actions.pod:4519
14545 #, no-wrap
14546 msgid ""
14547 " int\n"
14548 " guestfs_mount_ro (guestfs_h *g,\n"
14549 "                   const char *device,\n"
14550 "                   const char *mountpoint);\n"
14551 "\n"
14552 msgstr ""
14553
14554 # type: textblock
14555 #. type: textblock
14556 #: ../src/guestfs-actions.pod:4524
14557 msgid ""
14558 "This is the same as the C<guestfs_mount> command, but it mounts the "
14559 "filesystem with the read-only (I<-o ro>) flag."
14560 msgstr ""
14561
14562 # type: =head2
14563 #. type: =head2
14564 #: ../src/guestfs-actions.pod:4531
14565 msgid "guestfs_mount_vfs"
14566 msgstr ""
14567
14568 # type: verbatim
14569 #. type: verbatim
14570 #: ../src/guestfs-actions.pod:4533
14571 #, no-wrap
14572 msgid ""
14573 " int\n"
14574 " guestfs_mount_vfs (guestfs_h *g,\n"
14575 "                    const char *options,\n"
14576 "                    const char *vfstype,\n"
14577 "                    const char *device,\n"
14578 "                    const char *mountpoint);\n"
14579 "\n"
14580 msgstr ""
14581
14582 # type: textblock
14583 #. type: textblock
14584 #: ../src/guestfs-actions.pod:4540
14585 msgid ""
14586 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14587 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
14588 "t> flags."
14589 msgstr ""
14590
14591 # type: =head2
14592 #. type: =head2
14593 #: ../src/guestfs-actions.pod:4548
14594 msgid "guestfs_mountpoints"
14595 msgstr ""
14596
14597 # type: verbatim
14598 #. type: verbatim
14599 #: ../src/guestfs-actions.pod:4550
14600 #, no-wrap
14601 msgid ""
14602 " char **\n"
14603 " guestfs_mountpoints (guestfs_h *g);\n"
14604 "\n"
14605 msgstr ""
14606
14607 # type: textblock
14608 #. type: textblock
14609 #: ../src/guestfs-actions.pod:4553
14610 msgid ""
14611 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
14612 "devices.  This one returns a hash table (map) of device name to directory "
14613 "where the device is mounted."
14614 msgstr ""
14615
14616 # type: =head2
14617 #. type: =head2
14618 #: ../src/guestfs-actions.pod:4565
14619 msgid "guestfs_mounts"
14620 msgstr ""
14621
14622 # type: verbatim
14623 #. type: verbatim
14624 #: ../src/guestfs-actions.pod:4567
14625 #, no-wrap
14626 msgid ""
14627 " char **\n"
14628 " guestfs_mounts (guestfs_h *g);\n"
14629 "\n"
14630 msgstr ""
14631
14632 # type: textblock
14633 #. type: textblock
14634 #: ../src/guestfs-actions.pod:4570 ../fish/guestfish-actions.pod:3047
14635 msgid ""
14636 "This returns the list of currently mounted filesystems.  It returns the list "
14637 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
14638 msgstr ""
14639
14640 # type: textblock
14641 #. type: textblock
14642 #: ../src/guestfs-actions.pod:4573 ../fish/guestfish-actions.pod:3050
14643 msgid "Some internal mounts are not shown."
14644 msgstr ""
14645
14646 # type: textblock
14647 #. type: textblock
14648 #: ../src/guestfs-actions.pod:4575
14649 msgid "See also: C<guestfs_mountpoints>"
14650 msgstr ""
14651
14652 # type: =head2
14653 #. type: =head2
14654 #: ../src/guestfs-actions.pod:4583
14655 msgid "guestfs_mv"
14656 msgstr ""
14657
14658 # type: verbatim
14659 #. type: verbatim
14660 #: ../src/guestfs-actions.pod:4585
14661 #, no-wrap
14662 msgid ""
14663 " int\n"
14664 " guestfs_mv (guestfs_h *g,\n"
14665 "             const char *src,\n"
14666 "             const char *dest);\n"
14667 "\n"
14668 msgstr ""
14669
14670 # type: textblock
14671 #. type: textblock
14672 #: ../src/guestfs-actions.pod:4590 ../fish/guestfish-actions.pod:3058
14673 msgid ""
14674 "This moves a file from C<src> to C<dest> where C<dest> is either a "
14675 "destination filename or destination directory."
14676 msgstr ""
14677
14678 # type: =head2
14679 #. type: =head2
14680 #: ../src/guestfs-actions.pod:4597
14681 msgid "guestfs_ntfs_3g_probe"
14682 msgstr ""
14683
14684 # type: verbatim
14685 #. type: verbatim
14686 #: ../src/guestfs-actions.pod:4599
14687 #, no-wrap
14688 msgid ""
14689 " int\n"
14690 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
14691 "                        int rw,\n"
14692 "                        const char *device);\n"
14693 "\n"
14694 msgstr ""
14695
14696 # type: textblock
14697 #. type: textblock
14698 #: ../src/guestfs-actions.pod:4604 ../fish/guestfish-actions.pod:3065
14699 msgid ""
14700 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
14701 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
14702 "write, and some cannot be mounted at all)."
14703 msgstr ""
14704
14705 # type: textblock
14706 #. type: textblock
14707 #: ../src/guestfs-actions.pod:4608 ../fish/guestfish-actions.pod:3069
14708 msgid ""
14709 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
14710 "can be mounted read-write.  Set it to false if you want to test if the "
14711 "volume can be mounted read-only."
14712 msgstr ""
14713
14714 # type: textblock
14715 #. type: textblock
14716 #: ../src/guestfs-actions.pod:4612 ../fish/guestfish-actions.pod:3073
14717 msgid ""
14718 "The return value is an integer which C<0> if the operation would succeed, or "
14719 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
14720 msgstr ""
14721
14722 # type: textblock
14723 #. type: textblock
14724 #: ../src/guestfs-actions.pod:4618
14725 msgid "(Added in 1.0.43)"
14726 msgstr ""
14727
14728 # type: =head2
14729 #. type: =head2
14730 #: ../src/guestfs-actions.pod:4620
14731 msgid "guestfs_ntfsresize"
14732 msgstr ""
14733
14734 # type: verbatim
14735 #. type: verbatim
14736 #: ../src/guestfs-actions.pod:4622
14737 #, no-wrap
14738 msgid ""
14739 " int\n"
14740 " guestfs_ntfsresize (guestfs_h *g,\n"
14741 "                     const char *device);\n"
14742 "\n"
14743 msgstr ""
14744
14745 #. type: textblock
14746 #: ../src/guestfs-actions.pod:4626 ../fish/guestfish-actions.pod:3081
14747 msgid ""
14748 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
14749 "size of the underlying device."
14750 msgstr ""
14751
14752 #. type: textblock
14753 #: ../src/guestfs-actions.pod:4629 ../fish/guestfish-actions.pod:3084
14754 msgid ""
14755 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
14756 "consistency check (for safety).  You have to boot into Windows to perform "
14757 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
14758 "resize filesystems which have been marked in this way.  So in effect it is "
14759 "not possible to call ntfsresize multiple times on a single filesystem "
14760 "without booting into Windows between each resize."
14761 msgstr ""
14762
14763 #. type: textblock
14764 #: ../src/guestfs-actions.pod:4637 ../fish/guestfish-actions.pod:3092
14765 msgid "See also L<ntfsresize(8)>."
14766 msgstr ""
14767
14768 # type: =head2
14769 #. type: =head2
14770 #: ../src/guestfs-actions.pod:4643
14771 msgid "guestfs_ntfsresize_size"
14772 msgstr ""
14773
14774 # type: verbatim
14775 #. type: verbatim
14776 #: ../src/guestfs-actions.pod:4645
14777 #, no-wrap
14778 msgid ""
14779 " int\n"
14780 " guestfs_ntfsresize_size (guestfs_h *g,\n"
14781 "                          const char *device,\n"
14782 "                          int64_t size);\n"
14783 "\n"
14784 msgstr ""
14785
14786 # type: textblock
14787 #. type: textblock
14788 #: ../src/guestfs-actions.pod:4650
14789 msgid ""
14790 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
14791 "to specify the new size (in bytes) explicitly."
14792 msgstr ""
14793
14794 # type: textblock
14795 #. type: textblock
14796 #: ../src/guestfs-actions.pod:4655 ../src/guestfs-actions.pod:5091
14797 #: ../src/guestfs-actions.pod:5164 ../src/guestfs-actions.pod:5413
14798 #: ../src/guestfs-actions.pod:6952
14799 msgid "(Added in 1.3.14)"
14800 msgstr ""
14801
14802 # type: =head2
14803 #. type: =head2
14804 #: ../src/guestfs-actions.pod:4657
14805 msgid "guestfs_part_add"
14806 msgstr ""
14807
14808 # type: verbatim
14809 #. type: verbatim
14810 #: ../src/guestfs-actions.pod:4659
14811 #, no-wrap
14812 msgid ""
14813 " int\n"
14814 " guestfs_part_add (guestfs_h *g,\n"
14815 "                   const char *device,\n"
14816 "                   const char *prlogex,\n"
14817 "                   int64_t startsect,\n"
14818 "                   int64_t endsect);\n"
14819 "\n"
14820 msgstr ""
14821
14822 # type: textblock
14823 #. type: textblock
14824 #: ../src/guestfs-actions.pod:4666
14825 msgid ""
14826 "This command adds a partition to C<device>.  If there is no partition table "
14827 "on the device, call C<guestfs_part_init> first."
14828 msgstr ""
14829
14830 # type: textblock
14831 #. type: textblock
14832 #: ../src/guestfs-actions.pod:4669 ../fish/guestfish-actions.pod:3108
14833 msgid ""
14834 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
14835 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
14836 "C<logical>) and C<e> (or C<extended>) partition types."
14837 msgstr ""
14838
14839 # type: textblock
14840 #. type: textblock
14841 #: ../src/guestfs-actions.pod:4674 ../fish/guestfish-actions.pod:3113
14842 msgid ""
14843 "C<startsect> and C<endsect> are the start and end of the partition in "
14844 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
14845 "from the end of the disk (C<-1> is the last sector)."
14846 msgstr ""
14847
14848 # type: textblock
14849 #. type: textblock
14850 #: ../src/guestfs-actions.pod:4678
14851 msgid ""
14852 "Creating a partition which covers the whole disk is not so easy.  Use "
14853 "C<guestfs_part_disk> to do that."
14854 msgstr ""
14855
14856 # type: textblock
14857 #. type: textblock
14858 #: ../src/guestfs-actions.pod:4683 ../src/guestfs-actions.pod:4721
14859 #: ../src/guestfs-actions.pod:4774 ../src/guestfs-actions.pod:4852
14860 #: ../src/guestfs-actions.pod:4890 ../src/guestfs-actions.pod:4909
14861 #: ../src/guestfs-actions.pod:4949
14862 msgid "(Added in 1.0.78)"
14863 msgstr ""
14864
14865 # type: =head2
14866 #. type: =head2
14867 #: ../src/guestfs-actions.pod:4685
14868 msgid "guestfs_part_del"
14869 msgstr ""
14870
14871 # type: verbatim
14872 #. type: verbatim
14873 #: ../src/guestfs-actions.pod:4687
14874 #, no-wrap
14875 msgid ""
14876 " int\n"
14877 " guestfs_part_del (guestfs_h *g,\n"
14878 "                   const char *device,\n"
14879 "                   int partnum);\n"
14880 "\n"
14881 msgstr ""
14882
14883 # type: textblock
14884 #. type: textblock
14885 #: ../src/guestfs-actions.pod:4692 ../fish/guestfish-actions.pod:3124
14886 msgid "This command deletes the partition numbered C<partnum> on C<device>."
14887 msgstr ""
14888
14889 # type: textblock
14890 #. type: textblock
14891 #: ../src/guestfs-actions.pod:4694 ../fish/guestfish-actions.pod:3126
14892 msgid ""
14893 "Note that in the case of MBR partitioning, deleting an extended partition "
14894 "also deletes any logical partitions it contains."
14895 msgstr ""
14896
14897 # type: =head2
14898 #. type: =head2
14899 #: ../src/guestfs-actions.pod:4702
14900 msgid "guestfs_part_disk"
14901 msgstr ""
14902
14903 # type: verbatim
14904 #. type: verbatim
14905 #: ../src/guestfs-actions.pod:4704
14906 #, no-wrap
14907 msgid ""
14908 " int\n"
14909 " guestfs_part_disk (guestfs_h *g,\n"
14910 "                    const char *device,\n"
14911 "                    const char *parttype);\n"
14912 "\n"
14913 msgstr ""
14914
14915 # type: textblock
14916 #. type: textblock
14917 #: ../src/guestfs-actions.pod:4709
14918 msgid ""
14919 "This command is simply a combination of C<guestfs_part_init> followed by "
14920 "C<guestfs_part_add> to create a single primary partition covering the whole "
14921 "disk."
14922 msgstr ""
14923
14924 # type: textblock
14925 #. type: textblock
14926 #: ../src/guestfs-actions.pod:4713
14927 msgid ""
14928 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
14929 "possible values are described in C<guestfs_part_init>."
14930 msgstr ""
14931
14932 # type: =head2
14933 #. type: =head2
14934 #: ../src/guestfs-actions.pod:4723
14935 msgid "guestfs_part_get_bootable"
14936 msgstr ""
14937
14938 # type: verbatim
14939 #. type: verbatim
14940 #: ../src/guestfs-actions.pod:4725
14941 #, no-wrap
14942 msgid ""
14943 " int\n"
14944 " guestfs_part_get_bootable (guestfs_h *g,\n"
14945 "                            const char *device,\n"
14946 "                            int partnum);\n"
14947 "\n"
14948 msgstr ""
14949
14950 # type: textblock
14951 #. type: textblock
14952 #: ../src/guestfs-actions.pod:4730 ../fish/guestfish-actions.pod:3148
14953 msgid ""
14954 "This command returns true if the partition C<partnum> on C<device> has the "
14955 "bootable flag set."
14956 msgstr ""
14957
14958 # type: textblock
14959 #. type: textblock
14960 #: ../src/guestfs-actions.pod:4733
14961 msgid "See also C<guestfs_part_set_bootable>."
14962 msgstr ""
14963
14964 # type: =head2
14965 #. type: =head2
14966 #: ../src/guestfs-actions.pod:4739
14967 msgid "guestfs_part_get_mbr_id"
14968 msgstr ""
14969
14970 # type: verbatim
14971 #. type: verbatim
14972 #: ../src/guestfs-actions.pod:4741
14973 #, no-wrap
14974 msgid ""
14975 " int\n"
14976 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
14977 "                          const char *device,\n"
14978 "                          int partnum);\n"
14979 "\n"
14980 msgstr ""
14981
14982 # type: textblock
14983 #. type: textblock
14984 #: ../src/guestfs-actions.pod:4746 ../fish/guestfish-actions.pod:3157
14985 msgid ""
14986 "Returns the MBR type byte (also known as the ID byte) from the numbered "
14987 "partition C<partnum>."
14988 msgstr ""
14989
14990 # type: textblock
14991 #. type: textblock
14992 #: ../src/guestfs-actions.pod:4749 ../src/guestfs-actions.pod:4925
14993 msgid ""
14994 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
14995 "undefined results for other partition table types (see "
14996 "C<guestfs_part_get_parttype>)."
14997 msgstr ""
14998
14999 # type: =head2
15000 #. type: =head2
15001 #: ../src/guestfs-actions.pod:4757
15002 msgid "guestfs_part_get_parttype"
15003 msgstr ""
15004
15005 # type: verbatim
15006 #. type: verbatim
15007 #: ../src/guestfs-actions.pod:4759
15008 #, no-wrap
15009 msgid ""
15010 " char *\n"
15011 " guestfs_part_get_parttype (guestfs_h *g,\n"
15012 "                            const char *device);\n"
15013 "\n"
15014 msgstr ""
15015
15016 # type: textblock
15017 #. type: textblock
15018 #: ../src/guestfs-actions.pod:4763 ../fish/guestfish-actions.pod:3168
15019 msgid ""
15020 "This command examines the partition table on C<device> and returns the "
15021 "partition table type (format) being used."
15022 msgstr ""
15023
15024 # type: textblock
15025 #. type: textblock
15026 #: ../src/guestfs-actions.pod:4766
15027 msgid ""
15028 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
15029 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
15030 "possible, although unusual.  See C<guestfs_part_init> for a full list."
15031 msgstr ""
15032
15033 # type: =head2
15034 #. type: =head2
15035 #: ../src/guestfs-actions.pod:4776
15036 msgid "guestfs_part_init"
15037 msgstr ""
15038
15039 # type: verbatim
15040 #. type: verbatim
15041 #: ../src/guestfs-actions.pod:4778
15042 #, no-wrap
15043 msgid ""
15044 " int\n"
15045 " guestfs_part_init (guestfs_h *g,\n"
15046 "                    const char *device,\n"
15047 "                    const char *parttype);\n"
15048 "\n"
15049 msgstr ""
15050
15051 # type: textblock
15052 #. type: textblock
15053 #: ../src/guestfs-actions.pod:4783 ../fish/guestfish-actions.pod:3180
15054 msgid ""
15055 "This creates an empty partition table on C<device> of one of the partition "
15056 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
15057 "(for large disks)."
15058 msgstr ""
15059
15060 # type: textblock
15061 #. type: textblock
15062 #: ../src/guestfs-actions.pod:4787
15063 msgid ""
15064 "Initially there are no partitions.  Following this, you should call "
15065 "C<guestfs_part_add> for each partition required."
15066 msgstr ""
15067
15068 # type: textblock
15069 #. type: textblock
15070 #: ../src/guestfs-actions.pod:4790 ../fish/guestfish-actions.pod:3187
15071 msgid "Possible values for C<parttype> are:"
15072 msgstr ""
15073
15074 # type: =item
15075 #. type: =item
15076 #: ../src/guestfs-actions.pod:4794 ../fish/guestfish-actions.pod:3191
15077 msgid "B<efi> | B<gpt>"
15078 msgstr ""
15079
15080 # type: textblock
15081 #. type: textblock
15082 #: ../src/guestfs-actions.pod:4796 ../fish/guestfish-actions.pod:3193
15083 msgid "Intel EFI / GPT partition table."
15084 msgstr ""
15085
15086 # type: textblock
15087 #. type: textblock
15088 #: ../src/guestfs-actions.pod:4798 ../fish/guestfish-actions.pod:3195
15089 msgid ""
15090 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
15091 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
15092 "the C<mbr> format."
15093 msgstr ""
15094
15095 # type: =item
15096 #. type: =item
15097 #: ../src/guestfs-actions.pod:4802 ../fish/guestfish-actions.pod:3199
15098 msgid "B<mbr> | B<msdos>"
15099 msgstr ""
15100
15101 # type: textblock
15102 #. type: textblock
15103 #: ../src/guestfs-actions.pod:4804 ../fish/guestfish-actions.pod:3201
15104 msgid ""
15105 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
15106 "Windows.  This partition type will B<only> work for device sizes up to 2 "
15107 "TB.  For large disks we recommend using C<gpt>."
15108 msgstr ""
15109
15110 # type: textblock
15111 #. type: textblock
15112 #: ../src/guestfs-actions.pod:4811 ../fish/guestfish-actions.pod:3208
15113 msgid ""
15114 "Other partition table types that may work but are not supported include:"
15115 msgstr ""
15116
15117 # type: =item
15118 #. type: =item
15119 #: ../src/guestfs-actions.pod:4816 ../fish/guestfish-actions.pod:3213
15120 msgid "B<aix>"
15121 msgstr ""
15122
15123 # type: textblock
15124 #. type: textblock
15125 #: ../src/guestfs-actions.pod:4818 ../fish/guestfish-actions.pod:3215
15126 msgid "AIX disk labels."
15127 msgstr ""
15128
15129 # type: =item
15130 #. type: =item
15131 #: ../src/guestfs-actions.pod:4820 ../fish/guestfish-actions.pod:3217
15132 msgid "B<amiga> | B<rdb>"
15133 msgstr ""
15134
15135 # type: textblock
15136 #. type: textblock
15137 #: ../src/guestfs-actions.pod:4822 ../fish/guestfish-actions.pod:3219
15138 msgid "Amiga \"Rigid Disk Block\" format."
15139 msgstr ""
15140
15141 # type: =item
15142 #. type: =item
15143 #: ../src/guestfs-actions.pod:4824 ../fish/guestfish-actions.pod:3221
15144 msgid "B<bsd>"
15145 msgstr ""
15146
15147 # type: textblock
15148 #. type: textblock
15149 #: ../src/guestfs-actions.pod:4826 ../fish/guestfish-actions.pod:3223
15150 msgid "BSD disk labels."
15151 msgstr ""
15152
15153 # type: =item
15154 #. type: =item
15155 #: ../src/guestfs-actions.pod:4828 ../fish/guestfish-actions.pod:3225
15156 msgid "B<dasd>"
15157 msgstr ""
15158
15159 # type: textblock
15160 #. type: textblock
15161 #: ../src/guestfs-actions.pod:4830 ../fish/guestfish-actions.pod:3227
15162 msgid "DASD, used on IBM mainframes."
15163 msgstr ""
15164
15165 # type: =item
15166 #. type: =item
15167 #: ../src/guestfs-actions.pod:4832 ../fish/guestfish-actions.pod:3229
15168 msgid "B<dvh>"
15169 msgstr ""
15170
15171 # type: textblock
15172 #. type: textblock
15173 #: ../src/guestfs-actions.pod:4834 ../fish/guestfish-actions.pod:3231
15174 msgid "MIPS/SGI volumes."
15175 msgstr ""
15176
15177 # type: =item
15178 #. type: =item
15179 #: ../src/guestfs-actions.pod:4836 ../fish/guestfish-actions.pod:3233
15180 msgid "B<mac>"
15181 msgstr ""
15182
15183 # type: textblock
15184 #. type: textblock
15185 #: ../src/guestfs-actions.pod:4838 ../fish/guestfish-actions.pod:3235
15186 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
15187 msgstr ""
15188
15189 # type: =item
15190 #. type: =item
15191 #: ../src/guestfs-actions.pod:4840 ../fish/guestfish-actions.pod:3237
15192 msgid "B<pc98>"
15193 msgstr ""
15194
15195 # type: textblock
15196 #. type: textblock
15197 #: ../src/guestfs-actions.pod:4842 ../fish/guestfish-actions.pod:3239
15198 msgid "NEC PC-98 format, common in Japan apparently."
15199 msgstr ""
15200
15201 # type: =item
15202 #. type: =item
15203 #: ../src/guestfs-actions.pod:4844 ../fish/guestfish-actions.pod:3241
15204 msgid "B<sun>"
15205 msgstr ""
15206
15207 # type: textblock
15208 #. type: textblock
15209 #: ../src/guestfs-actions.pod:4846 ../fish/guestfish-actions.pod:3243
15210 msgid "Sun disk labels."
15211 msgstr ""
15212
15213 # type: =head2
15214 #. type: =head2
15215 #: ../src/guestfs-actions.pod:4854
15216 msgid "guestfs_part_list"
15217 msgstr ""
15218
15219 # type: verbatim
15220 #. type: verbatim
15221 #: ../src/guestfs-actions.pod:4856
15222 #, no-wrap
15223 msgid ""
15224 " struct guestfs_partition_list *\n"
15225 " guestfs_part_list (guestfs_h *g,\n"
15226 "                    const char *device);\n"
15227 "\n"
15228 msgstr ""
15229
15230 # type: textblock
15231 #. type: textblock
15232 #: ../src/guestfs-actions.pod:4860 ../fish/guestfish-actions.pod:3251
15233 msgid ""
15234 "This command parses the partition table on C<device> and returns the list of "
15235 "partitions found."
15236 msgstr ""
15237
15238 # type: textblock
15239 #. type: textblock
15240 #: ../src/guestfs-actions.pod:4863 ../fish/guestfish-actions.pod:3254
15241 msgid "The fields in the returned structure are:"
15242 msgstr ""
15243
15244 # type: =item
15245 #. type: =item
15246 #: ../src/guestfs-actions.pod:4867 ../fish/guestfish-actions.pod:3258
15247 msgid "B<part_num>"
15248 msgstr ""
15249
15250 # type: textblock
15251 #. type: textblock
15252 #: ../src/guestfs-actions.pod:4869 ../fish/guestfish-actions.pod:3260
15253 msgid "Partition number, counting from 1."
15254 msgstr ""
15255
15256 # type: =item
15257 #. type: =item
15258 #: ../src/guestfs-actions.pod:4871 ../fish/guestfish-actions.pod:3262
15259 msgid "B<part_start>"
15260 msgstr ""
15261
15262 # type: textblock
15263 #. type: textblock
15264 #: ../src/guestfs-actions.pod:4873
15265 msgid ""
15266 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
15267 "the device's sector size, see C<guestfs_blockdev_getss>."
15268 msgstr ""
15269
15270 # type: =item
15271 #. type: =item
15272 #: ../src/guestfs-actions.pod:4876 ../fish/guestfish-actions.pod:3267
15273 msgid "B<part_end>"
15274 msgstr ""
15275
15276 # type: textblock
15277 #. type: textblock
15278 #: ../src/guestfs-actions.pod:4878 ../fish/guestfish-actions.pod:3269
15279 msgid "End of the partition in bytes."
15280 msgstr ""
15281
15282 # type: =item
15283 #. type: =item
15284 #: ../src/guestfs-actions.pod:4880 ../fish/guestfish-actions.pod:3271
15285 msgid "B<part_size>"
15286 msgstr ""
15287
15288 # type: textblock
15289 #. type: textblock
15290 #: ../src/guestfs-actions.pod:4882 ../fish/guestfish-actions.pod:3273
15291 msgid "Size of the partition in bytes."
15292 msgstr ""
15293
15294 # type: textblock
15295 #. type: textblock
15296 #: ../src/guestfs-actions.pod:4886
15297 msgid ""
15298 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
15299 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
15300 "use>."
15301 msgstr ""
15302
15303 # type: =head2
15304 #. type: =head2
15305 #: ../src/guestfs-actions.pod:4892
15306 msgid "guestfs_part_set_bootable"
15307 msgstr ""
15308
15309 # type: verbatim
15310 #. type: verbatim
15311 #: ../src/guestfs-actions.pod:4894
15312 #, no-wrap
15313 msgid ""
15314 " int\n"
15315 " guestfs_part_set_bootable (guestfs_h *g,\n"
15316 "                            const char *device,\n"
15317 "                            int partnum,\n"
15318 "                            int bootable);\n"
15319 "\n"
15320 msgstr ""
15321
15322 # type: textblock
15323 #. type: textblock
15324 #: ../src/guestfs-actions.pod:4900 ../fish/guestfish-actions.pod:3281
15325 msgid ""
15326 "This sets the bootable flag on partition numbered C<partnum> on device "
15327 "C<device>.  Note that partitions are numbered from 1."
15328 msgstr ""
15329
15330 # type: textblock
15331 #. type: textblock
15332 #: ../src/guestfs-actions.pod:4903 ../fish/guestfish-actions.pod:3284
15333 msgid ""
15334 "The bootable flag is used by some operating systems (notably Windows) to "
15335 "determine which partition to boot from.  It is by no means universally "
15336 "recognized."
15337 msgstr ""
15338
15339 # type: =head2
15340 #. type: =head2
15341 #: ../src/guestfs-actions.pod:4911
15342 msgid "guestfs_part_set_mbr_id"
15343 msgstr ""
15344
15345 # type: verbatim
15346 #. type: verbatim
15347 #: ../src/guestfs-actions.pod:4913
15348 #, no-wrap
15349 msgid ""
15350 " int\n"
15351 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
15352 "                          const char *device,\n"
15353 "                          int partnum,\n"
15354 "                          int idbyte);\n"
15355 "\n"
15356 msgstr ""
15357
15358 # type: textblock
15359 #. type: textblock
15360 #: ../src/guestfs-actions.pod:4919 ../fish/guestfish-actions.pod:3292
15361 msgid ""
15362 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
15363 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
15364 "documentation are in fact hexadecimal numbers, but usually documented "
15365 "without any leading \"0x\" which might be confusing."
15366 msgstr ""
15367
15368 # type: =head2
15369 #. type: =head2
15370 #: ../src/guestfs-actions.pod:4933
15371 msgid "guestfs_part_set_name"
15372 msgstr ""
15373
15374 # type: verbatim
15375 #. type: verbatim
15376 #: ../src/guestfs-actions.pod:4935
15377 #, no-wrap
15378 msgid ""
15379 " int\n"
15380 " guestfs_part_set_name (guestfs_h *g,\n"
15381 "                        const char *device,\n"
15382 "                        int partnum,\n"
15383 "                        const char *name);\n"
15384 "\n"
15385 msgstr ""
15386
15387 # type: textblock
15388 #. type: textblock
15389 #: ../src/guestfs-actions.pod:4941 ../fish/guestfish-actions.pod:3306
15390 msgid ""
15391 "This sets the partition name on partition numbered C<partnum> on device "
15392 "C<device>.  Note that partitions are numbered from 1."
15393 msgstr ""
15394
15395 # type: textblock
15396 #. type: textblock
15397 #: ../src/guestfs-actions.pod:4944 ../fish/guestfish-actions.pod:3309
15398 msgid ""
15399 "The partition name can only be set on certain types of partition table.  "
15400 "This works on C<gpt> but not on C<mbr> partitions."
15401 msgstr ""
15402
15403 # type: =head2
15404 #. type: =head2
15405 #: ../src/guestfs-actions.pod:4951
15406 msgid "guestfs_part_to_dev"
15407 msgstr ""
15408
15409 # type: verbatim
15410 #. type: verbatim
15411 #: ../src/guestfs-actions.pod:4953
15412 #, no-wrap
15413 msgid ""
15414 " char *\n"
15415 " guestfs_part_to_dev (guestfs_h *g,\n"
15416 "                      const char *partition);\n"
15417 "\n"
15418 msgstr ""
15419
15420 # type: textblock
15421 #. type: textblock
15422 #: ../src/guestfs-actions.pod:4957 ../fish/guestfish-actions.pod:3316
15423 msgid ""
15424 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
15425 "partition number, returning the device name (eg. \"/dev/sdb\")."
15426 msgstr ""
15427
15428 # type: textblock
15429 #. type: textblock
15430 #: ../src/guestfs-actions.pod:4961
15431 msgid ""
15432 "The named partition must exist, for example as a string returned from "
15433 "C<guestfs_list_partitions>."
15434 msgstr ""
15435
15436 # type: =head2
15437 #. type: =head2
15438 #: ../src/guestfs-actions.pod:4969
15439 msgid "guestfs_ping_daemon"
15440 msgstr ""
15441
15442 # type: verbatim
15443 #. type: verbatim
15444 #: ../src/guestfs-actions.pod:4971
15445 #, no-wrap
15446 msgid ""
15447 " int\n"
15448 " guestfs_ping_daemon (guestfs_h *g);\n"
15449 "\n"
15450 msgstr ""
15451
15452 # type: textblock
15453 #. type: textblock
15454 #: ../src/guestfs-actions.pod:4974 ../fish/guestfish-actions.pod:3327
15455 msgid ""
15456 "This is a test probe into the guestfs daemon running inside the qemu "
15457 "subprocess.  Calling this function checks that the daemon responds to the "
15458 "ping message, without affecting the daemon or attached block device(s) in "
15459 "any other way."
15460 msgstr ""
15461
15462 # type: =head2
15463 #. type: =head2
15464 #: ../src/guestfs-actions.pod:4983
15465 msgid "guestfs_pread"
15466 msgstr ""
15467
15468 # type: verbatim
15469 #. type: verbatim
15470 #: ../src/guestfs-actions.pod:4985
15471 #, no-wrap
15472 msgid ""
15473 " char *\n"
15474 " guestfs_pread (guestfs_h *g,\n"
15475 "                const char *path,\n"
15476 "                int count,\n"
15477 "                int64_t offset,\n"
15478 "                size_t *size_r);\n"
15479 "\n"
15480 msgstr ""
15481
15482 # type: textblock
15483 #. type: textblock
15484 #: ../src/guestfs-actions.pod:4992 ../fish/guestfish-actions.pod:3336
15485 msgid ""
15486 "This command lets you read part of a file.  It reads C<count> bytes of the "
15487 "file, starting at C<offset>, from file C<path>."
15488 msgstr ""
15489
15490 # type: textblock
15491 #. type: textblock
15492 #: ../src/guestfs-actions.pod:4995 ../src/guestfs-actions.pod:5021
15493 #: ../fish/guestfish-actions.pod:3339 ../fish/guestfish-actions.pod:3354
15494 msgid ""
15495 "This may read fewer bytes than requested.  For further details see the "
15496 "L<pread(2)> system call."
15497 msgstr ""
15498
15499 # type: textblock
15500 #. type: textblock
15501 #: ../src/guestfs-actions.pod:4998
15502 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
15503 msgstr ""
15504
15505 # type: =head2
15506 #. type: =head2
15507 #: ../src/guestfs-actions.pod:5009
15508 msgid "guestfs_pread_device"
15509 msgstr ""
15510
15511 # type: verbatim
15512 #. type: verbatim
15513 #: ../src/guestfs-actions.pod:5011
15514 #, no-wrap
15515 msgid ""
15516 " char *\n"
15517 " guestfs_pread_device (guestfs_h *g,\n"
15518 "                       const char *device,\n"
15519 "                       int count,\n"
15520 "                       int64_t offset,\n"
15521 "                       size_t *size_r);\n"
15522 "\n"
15523 msgstr ""
15524
15525 # type: textblock
15526 #. type: textblock
15527 #: ../src/guestfs-actions.pod:5018 ../fish/guestfish-actions.pod:3351
15528 msgid ""
15529 "This command lets you read part of a file.  It reads C<count> bytes of "
15530 "C<device>, starting at C<offset>."
15531 msgstr ""
15532
15533 # type: textblock
15534 #. type: textblock
15535 #: ../src/guestfs-actions.pod:5024
15536 msgid "See also C<guestfs_pread>."
15537 msgstr ""
15538
15539 # type: textblock
15540 #. type: textblock
15541 #: ../src/guestfs-actions.pod:5033
15542 msgid "(Added in 1.5.21)"
15543 msgstr ""
15544
15545 # type: =head2
15546 #. type: =head2
15547 #: ../src/guestfs-actions.pod:5035
15548 msgid "guestfs_pvcreate"
15549 msgstr ""
15550
15551 # type: verbatim
15552 #. type: verbatim
15553 #: ../src/guestfs-actions.pod:5037
15554 #, no-wrap
15555 msgid ""
15556 " int\n"
15557 " guestfs_pvcreate (guestfs_h *g,\n"
15558 "                   const char *device);\n"
15559 "\n"
15560 msgstr ""
15561
15562 # type: textblock
15563 #. type: textblock
15564 #: ../src/guestfs-actions.pod:5041 ../fish/guestfish-actions.pod:3366
15565 msgid ""
15566 "This creates an LVM physical volume on the named C<device>, where C<device> "
15567 "should usually be a partition name such as C</dev/sda1>."
15568 msgstr ""
15569
15570 # type: =head2
15571 #. type: =head2
15572 #: ../src/guestfs-actions.pod:5049
15573 msgid "guestfs_pvremove"
15574 msgstr ""
15575
15576 # type: verbatim
15577 #. type: verbatim
15578 #: ../src/guestfs-actions.pod:5051
15579 #, no-wrap
15580 msgid ""
15581 " int\n"
15582 " guestfs_pvremove (guestfs_h *g,\n"
15583 "                   const char *device);\n"
15584 "\n"
15585 msgstr ""
15586
15587 # type: textblock
15588 #. type: textblock
15589 #: ../src/guestfs-actions.pod:5055 ../fish/guestfish-actions.pod:3374
15590 msgid ""
15591 "This wipes a physical volume C<device> so that LVM will no longer recognise "
15592 "it."
15593 msgstr ""
15594
15595 # type: textblock
15596 #. type: textblock
15597 #: ../src/guestfs-actions.pod:5058 ../fish/guestfish-actions.pod:3377
15598 msgid ""
15599 "The implementation uses the C<pvremove> command which refuses to wipe "
15600 "physical volumes that contain any volume groups, so you have to remove those "
15601 "first."
15602 msgstr ""
15603
15604 # type: =head2
15605 #. type: =head2
15606 #: ../src/guestfs-actions.pod:5066
15607 msgid "guestfs_pvresize"
15608 msgstr ""
15609
15610 # type: verbatim
15611 #. type: verbatim
15612 #: ../src/guestfs-actions.pod:5068
15613 #, no-wrap
15614 msgid ""
15615 " int\n"
15616 " guestfs_pvresize (guestfs_h *g,\n"
15617 "                   const char *device);\n"
15618 "\n"
15619 msgstr ""
15620
15621 # type: textblock
15622 #. type: textblock
15623 #: ../src/guestfs-actions.pod:5072 ../fish/guestfish-actions.pod:3385
15624 msgid ""
15625 "This resizes (expands or shrinks) an existing LVM physical volume to match "
15626 "the new size of the underlying device."
15627 msgstr ""
15628
15629 # type: =head2
15630 #. type: =head2
15631 #: ../src/guestfs-actions.pod:5079
15632 msgid "guestfs_pvresize_size"
15633 msgstr ""
15634
15635 # type: verbatim
15636 #. type: verbatim
15637 #: ../src/guestfs-actions.pod:5081
15638 #, no-wrap
15639 msgid ""
15640 " int\n"
15641 " guestfs_pvresize_size (guestfs_h *g,\n"
15642 "                        const char *device,\n"
15643 "                        int64_t size);\n"
15644 "\n"
15645 msgstr ""
15646
15647 # type: textblock
15648 #. type: textblock
15649 #: ../src/guestfs-actions.pod:5086
15650 msgid ""
15651 "This command is the same as C<guestfs_pvresize> except that it allows you to "
15652 "specify the new size (in bytes) explicitly."
15653 msgstr ""
15654
15655 # type: =head2
15656 #. type: =head2
15657 #: ../src/guestfs-actions.pod:5093
15658 msgid "guestfs_pvs"
15659 msgstr ""
15660
15661 # type: verbatim
15662 #. type: verbatim
15663 #: ../src/guestfs-actions.pod:5095
15664 #, no-wrap
15665 msgid ""
15666 " char **\n"
15667 " guestfs_pvs (guestfs_h *g);\n"
15668 "\n"
15669 msgstr ""
15670
15671 # type: textblock
15672 #. type: textblock
15673 #: ../src/guestfs-actions.pod:5098 ../fish/guestfish-actions.pod:3399
15674 msgid ""
15675 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15676 "(8)> command."
15677 msgstr ""
15678
15679 # type: textblock
15680 #. type: textblock
15681 #: ../src/guestfs-actions.pod:5101 ../fish/guestfish-actions.pod:3402
15682 msgid ""
15683 "This returns a list of just the device names that contain PVs (eg. C</dev/"
15684 "sda2>)."
15685 msgstr ""
15686
15687 # type: textblock
15688 #. type: textblock
15689 #: ../src/guestfs-actions.pod:5104
15690 msgid "See also C<guestfs_pvs_full>."
15691 msgstr ""
15692
15693 # type: =head2
15694 #. type: =head2
15695 #: ../src/guestfs-actions.pod:5112
15696 msgid "guestfs_pvs_full"
15697 msgstr ""
15698
15699 # type: verbatim
15700 #. type: verbatim
15701 #: ../src/guestfs-actions.pod:5114
15702 #, no-wrap
15703 msgid ""
15704 " struct guestfs_lvm_pv_list *\n"
15705 " guestfs_pvs_full (guestfs_h *g);\n"
15706 "\n"
15707 msgstr ""
15708
15709 # type: textblock
15710 #. type: textblock
15711 #: ../src/guestfs-actions.pod:5117 ../fish/guestfish-actions.pod:3411
15712 msgid ""
15713 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15714 "(8)> command.  The \"full\" version includes all fields."
15715 msgstr ""
15716
15717 # type: textblock
15718 #. type: textblock
15719 #: ../src/guestfs-actions.pod:5120
15720 msgid ""
15721 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
15722 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
15723 msgstr ""
15724
15725 # type: =head2
15726 #. type: =head2
15727 #: ../src/guestfs-actions.pod:5126
15728 msgid "guestfs_pvuuid"
15729 msgstr ""
15730
15731 # type: verbatim
15732 #. type: verbatim
15733 #: ../src/guestfs-actions.pod:5128
15734 #, no-wrap
15735 msgid ""
15736 " char *\n"
15737 " guestfs_pvuuid (guestfs_h *g,\n"
15738 "                 const char *device);\n"
15739 "\n"
15740 msgstr ""
15741
15742 # type: textblock
15743 #. type: textblock
15744 #: ../src/guestfs-actions.pod:5132 ../fish/guestfish-actions.pod:3418
15745 msgid "This command returns the UUID of the LVM PV C<device>."
15746 msgstr ""
15747
15748 # type: =head2
15749 #. type: =head2
15750 #: ../src/guestfs-actions.pod:5139
15751 msgid "guestfs_pwrite"
15752 msgstr ""
15753
15754 # type: verbatim
15755 #. type: verbatim
15756 #: ../src/guestfs-actions.pod:5141
15757 #, no-wrap
15758 msgid ""
15759 " int\n"
15760 " guestfs_pwrite (guestfs_h *g,\n"
15761 "                 const char *path,\n"
15762 "                 const char *content,\n"
15763 "                 size_t content_size,\n"
15764 "                 int64_t offset);\n"
15765 "\n"
15766 msgstr ""
15767
15768 # type: textblock
15769 #. type: textblock
15770 #: ../src/guestfs-actions.pod:5148 ../fish/guestfish-actions.pod:3424
15771 msgid ""
15772 "This command writes to part of a file.  It writes the data buffer C<content> "
15773 "to the file C<path> starting at offset C<offset>."
15774 msgstr ""
15775
15776 # type: textblock
15777 #. type: textblock
15778 #: ../src/guestfs-actions.pod:5151 ../fish/guestfish-actions.pod:3427
15779 msgid ""
15780 "This command implements the L<pwrite(2)> system call, and like that system "
15781 "call it may not write the full data requested.  The return value is the "
15782 "number of bytes that were actually written to the file.  This could even be "
15783 "0, although short writes are unlikely for regular files in ordinary "
15784 "circumstances."
15785 msgstr ""
15786
15787 # type: textblock
15788 #. type: textblock
15789 #: ../src/guestfs-actions.pod:5157
15790 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
15791 msgstr ""
15792
15793 # type: =head2
15794 #. type: =head2
15795 #: ../src/guestfs-actions.pod:5166
15796 msgid "guestfs_pwrite_device"
15797 msgstr ""
15798
15799 # type: verbatim
15800 #. type: verbatim
15801 #: ../src/guestfs-actions.pod:5168
15802 #, no-wrap
15803 msgid ""
15804 " int\n"
15805 " guestfs_pwrite_device (guestfs_h *g,\n"
15806 "                        const char *device,\n"
15807 "                        const char *content,\n"
15808 "                        size_t content_size,\n"
15809 "                        int64_t offset);\n"
15810 "\n"
15811 msgstr ""
15812
15813 # type: textblock
15814 #. type: textblock
15815 #: ../src/guestfs-actions.pod:5175 ../fish/guestfish-actions.pod:3442
15816 msgid ""
15817 "This command writes to part of a device.  It writes the data buffer "
15818 "C<content> to C<device> starting at offset C<offset>."
15819 msgstr ""
15820
15821 # type: textblock
15822 #. type: textblock
15823 #: ../src/guestfs-actions.pod:5178 ../fish/guestfish-actions.pod:3445
15824 msgid ""
15825 "This command implements the L<pwrite(2)> system call, and like that system "
15826 "call it may not write the full data requested (although short writes to disk "
15827 "devices and partitions are probably impossible with standard Linux kernels)."
15828 msgstr ""
15829
15830 # type: textblock
15831 #. type: textblock
15832 #: ../src/guestfs-actions.pod:5183
15833 msgid "See also C<guestfs_pwrite>."
15834 msgstr ""
15835
15836 # type: textblock
15837 #. type: textblock
15838 #: ../src/guestfs-actions.pod:5190
15839 msgid "(Added in 1.5.20)"
15840 msgstr ""
15841
15842 # type: =head2
15843 #. type: =head2
15844 #: ../src/guestfs-actions.pod:5192
15845 msgid "guestfs_read_file"
15846 msgstr ""
15847
15848 # type: verbatim
15849 #. type: verbatim
15850 #: ../src/guestfs-actions.pod:5194
15851 #, no-wrap
15852 msgid ""
15853 " char *\n"
15854 " guestfs_read_file (guestfs_h *g,\n"
15855 "                    const char *path,\n"
15856 "                    size_t *size_r);\n"
15857 "\n"
15858 msgstr ""
15859
15860 # type: textblock
15861 #. type: textblock
15862 #: ../src/guestfs-actions.pod:5199 ../fish/guestfish-actions.pod:3459
15863 msgid "This calls returns the contents of the file C<path> as a buffer."
15864 msgstr ""
15865
15866 # type: textblock
15867 #. type: textblock
15868 #: ../src/guestfs-actions.pod:5202
15869 msgid ""
15870 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
15871 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
15872 "function is limited in the total size of file that can be handled."
15873 msgstr ""
15874
15875 # type: textblock
15876 #. type: textblock
15877 #: ../src/guestfs-actions.pod:5214
15878 msgid "(Added in 1.0.63)"
15879 msgstr ""
15880
15881 # type: =head2
15882 #. type: =head2
15883 #: ../src/guestfs-actions.pod:5216
15884 msgid "guestfs_read_lines"
15885 msgstr ""
15886
15887 # type: verbatim
15888 #. type: verbatim
15889 #: ../src/guestfs-actions.pod:5218
15890 #, no-wrap
15891 msgid ""
15892 " char **\n"
15893 " guestfs_read_lines (guestfs_h *g,\n"
15894 "                     const char *path);\n"
15895 "\n"
15896 msgstr ""
15897
15898 # type: textblock
15899 #. type: textblock
15900 #: ../src/guestfs-actions.pod:5224 ../fish/guestfish-actions.pod:3476
15901 msgid ""
15902 "The file contents are returned as a list of lines.  Trailing C<LF> and "
15903 "C<CRLF> character sequences are I<not> returned."
15904 msgstr ""
15905
15906 # type: textblock
15907 #. type: textblock
15908 #: ../src/guestfs-actions.pod:5227
15909 msgid ""
15910 "Note that this function cannot correctly handle binary files (specifically, "
15911 "files containing C<\\0> character which is treated as end of line).  For "
15912 "those you need to use the C<guestfs_read_file> function which has a more "
15913 "complex interface."
15914 msgstr ""
15915
15916 # type: =head2
15917 #. type: =head2
15918 #: ../src/guestfs-actions.pod:5238
15919 msgid "guestfs_readdir"
15920 msgstr ""
15921
15922 # type: verbatim
15923 #. type: verbatim
15924 #: ../src/guestfs-actions.pod:5240
15925 #, no-wrap
15926 msgid ""
15927 " struct guestfs_dirent_list *\n"
15928 " guestfs_readdir (guestfs_h *g,\n"
15929 "                  const char *dir);\n"
15930 "\n"
15931 msgstr ""
15932
15933 # type: textblock
15934 #. type: textblock
15935 #: ../src/guestfs-actions.pod:5244 ../fish/guestfish-actions.pod:3488
15936 msgid "This returns the list of directory entries in directory C<dir>."
15937 msgstr ""
15938
15939 # type: textblock
15940 #. type: textblock
15941 #: ../src/guestfs-actions.pod:5246 ../fish/guestfish-actions.pod:3490
15942 msgid ""
15943 "All entries in the directory are returned, including C<.> and C<..>.  The "
15944 "entries are I<not> sorted, but returned in the same order as the underlying "
15945 "filesystem."
15946 msgstr ""
15947
15948 # type: textblock
15949 #. type: textblock
15950 #: ../src/guestfs-actions.pod:5250 ../fish/guestfish-actions.pod:3494
15951 msgid ""
15952 "Also this call returns basic file type information about each file.  The "
15953 "C<ftyp> field will contain one of the following characters:"
15954 msgstr ""
15955
15956 # type: =item
15957 #. type: =item
15958 #: ../src/guestfs-actions.pod:5255 ../fish/guestfish-actions.pod:3499
15959 msgid "'b'"
15960 msgstr ""
15961
15962 # type: textblock
15963 #. type: textblock
15964 #: ../src/guestfs-actions.pod:5257 ../fish/guestfish-actions.pod:3501
15965 msgid "Block special"
15966 msgstr ""
15967
15968 # type: =item
15969 #. type: =item
15970 #: ../src/guestfs-actions.pod:5259 ../fish/guestfish-actions.pod:3503
15971 msgid "'c'"
15972 msgstr ""
15973
15974 # type: textblock
15975 #. type: textblock
15976 #: ../src/guestfs-actions.pod:5261 ../fish/guestfish-actions.pod:3505
15977 msgid "Char special"
15978 msgstr ""
15979
15980 # type: =item
15981 #. type: =item
15982 #: ../src/guestfs-actions.pod:5263 ../fish/guestfish-actions.pod:3507
15983 msgid "'d'"
15984 msgstr ""
15985
15986 # type: textblock
15987 #. type: textblock
15988 #: ../src/guestfs-actions.pod:5265 ../fish/guestfish-actions.pod:3509
15989 msgid "Directory"
15990 msgstr ""
15991
15992 # type: =item
15993 #. type: =item
15994 #: ../src/guestfs-actions.pod:5267 ../fish/guestfish-actions.pod:3511
15995 msgid "'f'"
15996 msgstr ""
15997
15998 # type: textblock
15999 #. type: textblock
16000 #: ../src/guestfs-actions.pod:5269 ../fish/guestfish-actions.pod:3513
16001 msgid "FIFO (named pipe)"
16002 msgstr ""
16003
16004 # type: =item
16005 #. type: =item
16006 #: ../src/guestfs-actions.pod:5271 ../fish/guestfish-actions.pod:3515
16007 msgid "'l'"
16008 msgstr ""
16009
16010 # type: textblock
16011 #. type: textblock
16012 #: ../src/guestfs-actions.pod:5273 ../fish/guestfish-actions.pod:3517
16013 msgid "Symbolic link"
16014 msgstr ""
16015
16016 # type: =item
16017 #. type: =item
16018 #: ../src/guestfs-actions.pod:5275 ../fish/guestfish-actions.pod:3519
16019 msgid "'r'"
16020 msgstr ""
16021
16022 # type: textblock
16023 #. type: textblock
16024 #: ../src/guestfs-actions.pod:5277 ../fish/guestfish-actions.pod:3521
16025 msgid "Regular file"
16026 msgstr ""
16027
16028 # type: =item
16029 #. type: =item
16030 #: ../src/guestfs-actions.pod:5279 ../fish/guestfish-actions.pod:3523
16031 msgid "'s'"
16032 msgstr ""
16033
16034 # type: textblock
16035 #. type: textblock
16036 #: ../src/guestfs-actions.pod:5281 ../fish/guestfish-actions.pod:3525
16037 msgid "Socket"
16038 msgstr ""
16039
16040 # type: =item
16041 #. type: =item
16042 #: ../src/guestfs-actions.pod:5283 ../fish/guestfish-actions.pod:3527
16043 msgid "'u'"
16044 msgstr ""
16045
16046 # type: textblock
16047 #. type: textblock
16048 #: ../src/guestfs-actions.pod:5285 ../fish/guestfish-actions.pod:3529
16049 msgid "Unknown file type"
16050 msgstr ""
16051
16052 # type: =item
16053 #. type: =item
16054 #: ../src/guestfs-actions.pod:5287 ../fish/guestfish-actions.pod:3531
16055 msgid "'?'"
16056 msgstr ""
16057
16058 # type: textblock
16059 #. type: textblock
16060 #: ../src/guestfs-actions.pod:5289 ../fish/guestfish-actions.pod:3533
16061 msgid ""
16062 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
16063 msgstr ""
16064
16065 # type: textblock
16066 #. type: textblock
16067 #: ../src/guestfs-actions.pod:5294
16068 msgid ""
16069 "This function is primarily intended for use by programs.  To get a simple "
16070 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
16071 "consumption, use C<guestfs_ll>."
16072 msgstr ""
16073
16074 # type: textblock
16075 #. type: textblock
16076 #: ../src/guestfs-actions.pod:5298
16077 msgid ""
16078 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
16079 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
16080 msgstr ""
16081
16082 # type: =head2
16083 #. type: =head2
16084 #: ../src/guestfs-actions.pod:5304
16085 msgid "guestfs_readlink"
16086 msgstr ""
16087
16088 # type: verbatim
16089 #. type: verbatim
16090 #: ../src/guestfs-actions.pod:5306
16091 #, no-wrap
16092 msgid ""
16093 " char *\n"
16094 " guestfs_readlink (guestfs_h *g,\n"
16095 "                   const char *path);\n"
16096 "\n"
16097 msgstr ""
16098
16099 # type: textblock
16100 #. type: textblock
16101 #: ../src/guestfs-actions.pod:5310 ../fish/guestfish-actions.pod:3546
16102 msgid "This command reads the target of a symbolic link."
16103 msgstr ""
16104
16105 # type: =head2
16106 #. type: =head2
16107 #: ../src/guestfs-actions.pod:5317
16108 msgid "guestfs_readlinklist"
16109 msgstr ""
16110
16111 # type: verbatim
16112 #. type: verbatim
16113 #: ../src/guestfs-actions.pod:5319
16114 #, no-wrap
16115 msgid ""
16116 " char **\n"
16117 " guestfs_readlinklist (guestfs_h *g,\n"
16118 "                       const char *path,\n"
16119 "                       char *const *names);\n"
16120 "\n"
16121 msgstr ""
16122
16123 # type: textblock
16124 #. type: textblock
16125 #: ../src/guestfs-actions.pod:5324 ../fish/guestfish-actions.pod:3552
16126 msgid ""
16127 "This call allows you to do a C<readlink> operation on multiple files, where "
16128 "all files are in the directory C<path>.  C<names> is the list of files from "
16129 "this directory."
16130 msgstr ""
16131
16132 # type: textblock
16133 #. type: textblock
16134 #: ../src/guestfs-actions.pod:5328 ../fish/guestfish-actions.pod:3556
16135 msgid ""
16136 "On return you get a list of strings, with a one-to-one correspondence to the "
16137 "C<names> list.  Each string is the value of the symbolic link."
16138 msgstr ""
16139
16140 # type: textblock
16141 #. type: textblock
16142 #: ../src/guestfs-actions.pod:5332 ../fish/guestfish-actions.pod:3560
16143 msgid ""
16144 "If the C<readlink(2)> operation fails on any name, then the corresponding "
16145 "result string is the empty string C<\"\">.  However the whole operation is "
16146 "completed even if there were C<readlink(2)> errors, and so you can call this "
16147 "function with names where you don't know if they are symbolic links already "
16148 "(albeit slightly less efficient)."
16149 msgstr ""
16150
16151 # type: textblock
16152 #. type: textblock
16153 #: ../src/guestfs-actions.pod:5339 ../fish/guestfish-actions.pod:3567
16154 msgid ""
16155 "This call is intended for programs that want to efficiently list a directory "
16156 "contents without making many round-trips.  Very long directory listings "
16157 "might cause the protocol message size to be exceeded, causing this call to "
16158 "fail.  The caller must split up such requests into smaller groups of names."
16159 msgstr ""
16160
16161 # type: =head2
16162 #. type: =head2
16163 #: ../src/guestfs-actions.pod:5352
16164 msgid "guestfs_realpath"
16165 msgstr ""
16166
16167 # type: verbatim
16168 #. type: verbatim
16169 #: ../src/guestfs-actions.pod:5354
16170 #, no-wrap
16171 msgid ""
16172 " char *\n"
16173 " guestfs_realpath (guestfs_h *g,\n"
16174 "                   const char *path);\n"
16175 "\n"
16176 msgstr ""
16177
16178 # type: textblock
16179 #. type: textblock
16180 #: ../src/guestfs-actions.pod:5358 ../fish/guestfish-actions.pod:3578
16181 msgid ""
16182 "Return the canonicalized absolute pathname of C<path>.  The returned path "
16183 "has no C<.>, C<..> or symbolic link path elements."
16184 msgstr ""
16185
16186 # type: =head2
16187 #. type: =head2
16188 #: ../src/guestfs-actions.pod:5366
16189 msgid "guestfs_removexattr"
16190 msgstr ""
16191
16192 # type: verbatim
16193 #. type: verbatim
16194 #: ../src/guestfs-actions.pod:5368
16195 #, no-wrap
16196 msgid ""
16197 " int\n"
16198 " guestfs_removexattr (guestfs_h *g,\n"
16199 "                      const char *xattr,\n"
16200 "                      const char *path);\n"
16201 "\n"
16202 msgstr ""
16203
16204 # type: textblock
16205 #. type: textblock
16206 #: ../src/guestfs-actions.pod:5373 ../fish/guestfish-actions.pod:3585
16207 msgid ""
16208 "This call removes the extended attribute named C<xattr> of the file C<path>."
16209 msgstr ""
16210
16211 # type: textblock
16212 #. type: textblock
16213 #: ../src/guestfs-actions.pod:5376
16214 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
16215 msgstr ""
16216
16217 # type: =head2
16218 #. type: =head2
16219 #: ../src/guestfs-actions.pod:5382
16220 msgid "guestfs_resize2fs"
16221 msgstr ""
16222
16223 # type: verbatim
16224 #. type: verbatim
16225 #: ../src/guestfs-actions.pod:5384
16226 #, no-wrap
16227 msgid ""
16228 " int\n"
16229 " guestfs_resize2fs (guestfs_h *g,\n"
16230 "                    const char *device);\n"
16231 "\n"
16232 msgstr ""
16233
16234 # type: textblock
16235 #. type: textblock
16236 #: ../src/guestfs-actions.pod:5388 ../fish/guestfish-actions.pod:3594
16237 msgid ""
16238 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
16239 "underlying device."
16240 msgstr ""
16241
16242 # type: textblock
16243 #. type: textblock
16244 #: ../src/guestfs-actions.pod:5391
16245 msgid ""
16246 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
16247 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
16248 "sometimes gives an error about this and sometimes not.  In any case, it is "
16249 "always safe to call C<guestfs_e2fsck_f> before calling this function."
16250 msgstr ""
16251
16252 # type: =head2
16253 #. type: =head2
16254 #: ../src/guestfs-actions.pod:5401
16255 msgid "guestfs_resize2fs_size"
16256 msgstr ""
16257
16258 # type: verbatim
16259 #. type: verbatim
16260 #: ../src/guestfs-actions.pod:5403
16261 #, no-wrap
16262 msgid ""
16263 " int\n"
16264 " guestfs_resize2fs_size (guestfs_h *g,\n"
16265 "                         const char *device,\n"
16266 "                         int64_t size);\n"
16267 "\n"
16268 msgstr ""
16269
16270 # type: textblock
16271 #. type: textblock
16272 #: ../src/guestfs-actions.pod:5408
16273 msgid ""
16274 "This command is the same as C<guestfs_resize2fs> except that it allows you "
16275 "to specify the new size (in bytes) explicitly."
16276 msgstr ""
16277
16278 # type: =head2
16279 #. type: =head2
16280 #: ../src/guestfs-actions.pod:5415
16281 msgid "guestfs_rm"
16282 msgstr ""
16283
16284 # type: verbatim
16285 #. type: verbatim
16286 #: ../src/guestfs-actions.pod:5417
16287 #, no-wrap
16288 msgid ""
16289 " int\n"
16290 " guestfs_rm (guestfs_h *g,\n"
16291 "             const char *path);\n"
16292 "\n"
16293 msgstr ""
16294
16295 # type: textblock
16296 #. type: textblock
16297 #: ../src/guestfs-actions.pod:5421 ../fish/guestfish-actions.pod:3614
16298 msgid "Remove the single file C<path>."
16299 msgstr ""
16300
16301 # type: =head2
16302 #. type: =head2
16303 #: ../src/guestfs-actions.pod:5427
16304 msgid "guestfs_rm_rf"
16305 msgstr ""
16306
16307 # type: verbatim
16308 #. type: verbatim
16309 #: ../src/guestfs-actions.pod:5429
16310 #, no-wrap
16311 msgid ""
16312 " int\n"
16313 " guestfs_rm_rf (guestfs_h *g,\n"
16314 "                const char *path);\n"
16315 "\n"
16316 msgstr ""
16317
16318 # type: textblock
16319 #. type: textblock
16320 #: ../src/guestfs-actions.pod:5433 ../fish/guestfish-actions.pod:3620
16321 msgid ""
16322 "Remove the file or directory C<path>, recursively removing the contents if "
16323 "its a directory.  This is like the C<rm -rf> shell command."
16324 msgstr ""
16325
16326 # type: =head2
16327 #. type: =head2
16328 #: ../src/guestfs-actions.pod:5441
16329 msgid "guestfs_rmdir"
16330 msgstr ""
16331
16332 # type: verbatim
16333 #. type: verbatim
16334 #: ../src/guestfs-actions.pod:5443
16335 #, no-wrap
16336 msgid ""
16337 " int\n"
16338 " guestfs_rmdir (guestfs_h *g,\n"
16339 "                const char *path);\n"
16340 "\n"
16341 msgstr ""
16342
16343 # type: textblock
16344 #. type: textblock
16345 #: ../src/guestfs-actions.pod:5447 ../fish/guestfish-actions.pod:3628
16346 msgid "Remove the single directory C<path>."
16347 msgstr ""
16348
16349 # type: =head2
16350 #. type: =head2
16351 #: ../src/guestfs-actions.pod:5453
16352 msgid "guestfs_rmmountpoint"
16353 msgstr ""
16354
16355 # type: verbatim
16356 #. type: verbatim
16357 #: ../src/guestfs-actions.pod:5455
16358 #, no-wrap
16359 msgid ""
16360 " int\n"
16361 " guestfs_rmmountpoint (guestfs_h *g,\n"
16362 "                       const char *exemptpath);\n"
16363 "\n"
16364 msgstr ""
16365
16366 # type: textblock
16367 #. type: textblock
16368 #: ../src/guestfs-actions.pod:5459
16369 msgid ""
16370 "This calls removes a mountpoint that was previously created with "
16371 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
16372 msgstr ""
16373
16374 # type: =head2
16375 #. type: =head2
16376 #: ../src/guestfs-actions.pod:5467
16377 msgid "guestfs_scrub_device"
16378 msgstr ""
16379
16380 # type: verbatim
16381 #. type: verbatim
16382 #: ../src/guestfs-actions.pod:5469
16383 #, no-wrap
16384 msgid ""
16385 " int\n"
16386 " guestfs_scrub_device (guestfs_h *g,\n"
16387 "                       const char *device);\n"
16388 "\n"
16389 msgstr ""
16390
16391 # type: textblock
16392 #. type: textblock
16393 #: ../src/guestfs-actions.pod:5473 ../fish/guestfish-actions.pod:3642
16394 msgid ""
16395 "This command writes patterns over C<device> to make data retrieval more "
16396 "difficult."
16397 msgstr ""
16398
16399 # type: textblock
16400 #. type: textblock
16401 #: ../src/guestfs-actions.pod:5476 ../src/guestfs-actions.pod:5497
16402 #: ../src/guestfs-actions.pod:5516 ../fish/guestfish-actions.pod:3645
16403 #: ../fish/guestfish-actions.pod:3660 ../fish/guestfish-actions.pod:3673
16404 msgid ""
16405 "It is an interface to the L<scrub(1)> program.  See that manual page for "
16406 "more details."
16407 msgstr ""
16408
16409 # type: textblock
16410 #. type: textblock
16411 #: ../src/guestfs-actions.pod:5484 ../src/guestfs-actions.pod:5502
16412 #: ../src/guestfs-actions.pod:5521
16413 msgid "(Added in 1.0.52)"
16414 msgstr ""
16415
16416 # type: =head2
16417 #. type: =head2
16418 #: ../src/guestfs-actions.pod:5486
16419 msgid "guestfs_scrub_file"
16420 msgstr ""
16421
16422 # type: verbatim
16423 #. type: verbatim
16424 #: ../src/guestfs-actions.pod:5488
16425 #, no-wrap
16426 msgid ""
16427 " int\n"
16428 " guestfs_scrub_file (guestfs_h *g,\n"
16429 "                     const char *file);\n"
16430 "\n"
16431 msgstr ""
16432
16433 # type: textblock
16434 #. type: textblock
16435 #: ../src/guestfs-actions.pod:5492 ../fish/guestfish-actions.pod:3655
16436 msgid ""
16437 "This command writes patterns over a file to make data retrieval more "
16438 "difficult."
16439 msgstr ""
16440
16441 # type: textblock
16442 #. type: textblock
16443 #: ../src/guestfs-actions.pod:5495 ../fish/guestfish-actions.pod:3658
16444 msgid "The file is I<removed> after scrubbing."
16445 msgstr ""
16446
16447 # type: =head2
16448 #. type: =head2
16449 #: ../src/guestfs-actions.pod:5504
16450 msgid "guestfs_scrub_freespace"
16451 msgstr ""
16452
16453 # type: verbatim
16454 #. type: verbatim
16455 #: ../src/guestfs-actions.pod:5506
16456 #, no-wrap
16457 msgid ""
16458 " int\n"
16459 " guestfs_scrub_freespace (guestfs_h *g,\n"
16460 "                          const char *dir);\n"
16461 "\n"
16462 msgstr ""
16463
16464 # type: textblock
16465 #. type: textblock
16466 #: ../src/guestfs-actions.pod:5510
16467 msgid ""
16468 "This command creates the directory C<dir> and then fills it with files until "
16469 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
16470 "and deletes them.  The intention is to scrub any free space on the partition "
16471 "containing C<dir>."
16472 msgstr ""
16473
16474 # type: =head2
16475 #. type: =head2
16476 #: ../src/guestfs-actions.pod:5523
16477 msgid "guestfs_set_append"
16478 msgstr ""
16479
16480 # type: verbatim
16481 #. type: verbatim
16482 #: ../src/guestfs-actions.pod:5525
16483 #, no-wrap
16484 msgid ""
16485 " int\n"
16486 " guestfs_set_append (guestfs_h *g,\n"
16487 "                     const char *append);\n"
16488 "\n"
16489 msgstr ""
16490
16491 # type: textblock
16492 #. type: textblock
16493 #: ../src/guestfs-actions.pod:5529 ../fish/guestfish-actions.pod:3682
16494 msgid ""
16495 "This function is used to add additional options to the guest kernel command "
16496 "line."
16497 msgstr ""
16498
16499 # type: textblock
16500 #. type: textblock
16501 #: ../src/guestfs-actions.pod:5532 ../fish/guestfish-actions.pod:3685
16502 msgid ""
16503 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
16504 "environment variable."
16505 msgstr ""
16506
16507 # type: textblock
16508 #. type: textblock
16509 #: ../src/guestfs-actions.pod:5535 ../fish/guestfish-actions.pod:3688
16510 msgid ""
16511 "Setting C<append> to C<NULL> means I<no> additional options are passed "
16512 "(libguestfs always adds a few of its own)."
16513 msgstr ""
16514
16515 # type: =head2
16516 #. type: =head2
16517 #: ../src/guestfs-actions.pod:5542
16518 msgid "guestfs_set_autosync"
16519 msgstr ""
16520
16521 # type: verbatim
16522 #. type: verbatim
16523 #: ../src/guestfs-actions.pod:5544
16524 #, no-wrap
16525 msgid ""
16526 " int\n"
16527 " guestfs_set_autosync (guestfs_h *g,\n"
16528 "                       int autosync);\n"
16529 "\n"
16530 msgstr ""
16531
16532 # type: textblock
16533 #. type: textblock
16534 #: ../src/guestfs-actions.pod:5548
16535 msgid ""
16536 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
16537 "effort attempt to run C<guestfs_umount_all> followed by C<guestfs_sync> when "
16538 "the handle is closed (also if the program exits without closing handles)."
16539 msgstr ""
16540
16541 # type: textblock
16542 #. type: textblock
16543 #: ../src/guestfs-actions.pod:5553 ../fish/guestfish-actions.pod:3702
16544 msgid ""
16545 "This is enabled by default (since libguestfs 1.5.24, previously it was "
16546 "disabled by default)."
16547 msgstr ""
16548
16549 # type: =head2
16550 #. type: =head2
16551 #: ../src/guestfs-actions.pod:5560
16552 msgid "guestfs_set_direct"
16553 msgstr ""
16554
16555 # type: verbatim
16556 #. type: verbatim
16557 #: ../src/guestfs-actions.pod:5562
16558 #, no-wrap
16559 msgid ""
16560 " int\n"
16561 " guestfs_set_direct (guestfs_h *g,\n"
16562 "                     int direct);\n"
16563 "\n"
16564 msgstr ""
16565
16566 # type: textblock
16567 #. type: textblock
16568 #: ../src/guestfs-actions.pod:5566 ../fish/guestfish-actions.pod:3711
16569 msgid ""
16570 "If the direct appliance mode flag is enabled, then stdin and stdout are "
16571 "passed directly through to the appliance once it is launched."
16572 msgstr ""
16573
16574 # type: textblock
16575 #. type: textblock
16576 #: ../src/guestfs-actions.pod:5570
16577 msgid ""
16578 "One consequence of this is that log messages aren't caught by the library "
16579 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
16580 "stdout."
16581 msgstr ""
16582
16583 # type: textblock
16584 #. type: textblock
16585 #: ../src/guestfs-actions.pod:5574 ../fish/guestfish-actions.pod:3719
16586 msgid "You probably don't want to use this unless you know what you are doing."
16587 msgstr ""
16588
16589 # type: textblock
16590 #. type: textblock
16591 #: ../src/guestfs-actions.pod:5577 ../fish/guestfish-actions.pod:3722
16592 msgid "The default is disabled."
16593 msgstr ""
16594
16595 # type: =head2
16596 #. type: =head2
16597 #: ../src/guestfs-actions.pod:5583
16598 msgid "guestfs_set_e2label"
16599 msgstr ""
16600
16601 # type: verbatim
16602 #. type: verbatim
16603 #: ../src/guestfs-actions.pod:5585
16604 #, no-wrap
16605 msgid ""
16606 " int\n"
16607 " guestfs_set_e2label (guestfs_h *g,\n"
16608 "                      const char *device,\n"
16609 "                      const char *label);\n"
16610 "\n"
16611 msgstr ""
16612
16613 # type: textblock
16614 #. type: textblock
16615 #: ../src/guestfs-actions.pod:5590 ../fish/guestfish-actions.pod:3728
16616 msgid ""
16617 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
16618 "C<label>.  Filesystem labels are limited to 16 characters."
16619 msgstr ""
16620
16621 # type: textblock
16622 #. type: textblock
16623 #: ../src/guestfs-actions.pod:5594
16624 msgid ""
16625 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
16626 "the existing label on a filesystem."
16627 msgstr ""
16628
16629 # type: =head2
16630 #. type: =head2
16631 #: ../src/guestfs-actions.pod:5601
16632 msgid "guestfs_set_e2uuid"
16633 msgstr ""
16634
16635 # type: verbatim
16636 #. type: verbatim
16637 #: ../src/guestfs-actions.pod:5603
16638 #, no-wrap
16639 msgid ""
16640 " int\n"
16641 " guestfs_set_e2uuid (guestfs_h *g,\n"
16642 "                     const char *device,\n"
16643 "                     const char *uuid);\n"
16644 "\n"
16645 msgstr ""
16646
16647 # type: textblock
16648 #. type: textblock
16649 #: ../src/guestfs-actions.pod:5608 ../fish/guestfish-actions.pod:3739
16650 msgid ""
16651 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
16652 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
16653 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
16654 msgstr ""
16655
16656 # type: textblock
16657 #. type: textblock
16658 #: ../src/guestfs-actions.pod:5613
16659 msgid ""
16660 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
16661 "the existing UUID of a filesystem."
16662 msgstr ""
16663
16664 # type: =head2
16665 #. type: =head2
16666 #: ../src/guestfs-actions.pod:5620
16667 msgid "guestfs_set_memsize"
16668 msgstr ""
16669
16670 # type: verbatim
16671 #. type: verbatim
16672 #: ../src/guestfs-actions.pod:5622
16673 #, no-wrap
16674 msgid ""
16675 " int\n"
16676 " guestfs_set_memsize (guestfs_h *g,\n"
16677 "                      int memsize);\n"
16678 "\n"
16679 msgstr ""
16680
16681 # type: textblock
16682 #. type: textblock
16683 #: ../src/guestfs-actions.pod:5626
16684 msgid ""
16685 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
16686 "This only has any effect if called before C<guestfs_launch>."
16687 msgstr ""
16688
16689 # type: textblock
16690 #. type: textblock
16691 #: ../src/guestfs-actions.pod:5630 ../fish/guestfish-actions.pod:3757
16692 msgid ""
16693 "You can also change this by setting the environment variable "
16694 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
16695 msgstr ""
16696
16697 # type: =head2
16698 #. type: =head2
16699 #: ../src/guestfs-actions.pod:5641
16700 msgid "guestfs_set_network"
16701 msgstr ""
16702
16703 # type: verbatim
16704 #. type: verbatim
16705 #: ../src/guestfs-actions.pod:5643
16706 #, no-wrap
16707 msgid ""
16708 " int\n"
16709 " guestfs_set_network (guestfs_h *g,\n"
16710 "                      int network);\n"
16711 "\n"
16712 msgstr ""
16713
16714 # type: textblock
16715 #. type: textblock
16716 #: ../src/guestfs-actions.pod:5647 ../fish/guestfish-actions.pod:3770
16717 msgid ""
16718 "If C<network> is true, then the network is enabled in the libguestfs "
16719 "appliance.  The default is false."
16720 msgstr ""
16721
16722 # type: textblock
16723 #. type: textblock
16724 #: ../src/guestfs-actions.pod:5650 ../fish/guestfish-actions.pod:3773
16725 msgid ""
16726 "This affects whether commands are able to access the network (see L<guestfs"
16727 "(3)/RUNNING COMMANDS>)."
16728 msgstr ""
16729
16730 # type: textblock
16731 #. type: textblock
16732 #: ../src/guestfs-actions.pod:5653
16733 msgid ""
16734 "You must call this before calling C<guestfs_launch>, otherwise it has no "
16735 "effect."
16736 msgstr ""
16737
16738 # type: =head2
16739 #. type: =head2
16740 #: ../src/guestfs-actions.pod:5660
16741 msgid "guestfs_set_path"
16742 msgstr ""
16743
16744 # type: verbatim
16745 #. type: verbatim
16746 #: ../src/guestfs-actions.pod:5662
16747 #, no-wrap
16748 msgid ""
16749 " int\n"
16750 " guestfs_set_path (guestfs_h *g,\n"
16751 "                   const char *searchpath);\n"
16752 "\n"
16753 msgstr ""
16754
16755 # type: textblock
16756 #. type: textblock
16757 #: ../src/guestfs-actions.pod:5666 ../fish/guestfish-actions.pod:3785
16758 msgid "Set the path that libguestfs searches for kernel and initrd.img."
16759 msgstr ""
16760
16761 # type: textblock
16762 #. type: textblock
16763 #: ../src/guestfs-actions.pod:5668 ../fish/guestfish-actions.pod:3787
16764 msgid ""
16765 "The default is C<$libdir/guestfs> unless overridden by setting "
16766 "C<LIBGUESTFS_PATH> environment variable."
16767 msgstr ""
16768
16769 # type: textblock
16770 #. type: textblock
16771 #: ../src/guestfs-actions.pod:5671 ../fish/guestfish-actions.pod:3790
16772 msgid "Setting C<path> to C<NULL> restores the default path."
16773 msgstr ""
16774
16775 # type: =head2
16776 #. type: =head2
16777 #: ../src/guestfs-actions.pod:5677
16778 msgid "guestfs_set_qemu"
16779 msgstr ""
16780
16781 # type: verbatim
16782 #. type: verbatim
16783 #: ../src/guestfs-actions.pod:5679
16784 #, no-wrap
16785 msgid ""
16786 " int\n"
16787 " guestfs_set_qemu (guestfs_h *g,\n"
16788 "                   const char *qemu);\n"
16789 "\n"
16790 msgstr ""
16791
16792 # type: textblock
16793 #. type: textblock
16794 #: ../src/guestfs-actions.pod:5683 ../fish/guestfish-actions.pod:3798
16795 msgid "Set the qemu binary that we will use."
16796 msgstr ""
16797
16798 # type: textblock
16799 #. type: textblock
16800 #: ../src/guestfs-actions.pod:5685 ../fish/guestfish-actions.pod:3800
16801 msgid ""
16802 "The default is chosen when the library was compiled by the configure script."
16803 msgstr ""
16804
16805 # type: textblock
16806 #. type: textblock
16807 #: ../src/guestfs-actions.pod:5688 ../fish/guestfish-actions.pod:3803
16808 msgid ""
16809 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
16810 "variable."
16811 msgstr ""
16812
16813 # type: textblock
16814 #. type: textblock
16815 #: ../src/guestfs-actions.pod:5691 ../fish/guestfish-actions.pod:3806
16816 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
16817 msgstr ""
16818
16819 # type: textblock
16820 #. type: textblock
16821 #: ../src/guestfs-actions.pod:5693 ../fish/guestfish-actions.pod:3808
16822 msgid ""
16823 "Note that you should call this function as early as possible after creating "
16824 "the handle.  This is because some pre-launch operations depend on testing "
16825 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
16826 "don't retest features, and so you might see inconsistent results.  Using the "
16827 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
16828 "the qemu binary at the same time as the handle is created."
16829 msgstr ""
16830
16831 # type: =head2
16832 #. type: =head2
16833 #: ../src/guestfs-actions.pod:5705
16834 msgid "guestfs_set_recovery_proc"
16835 msgstr ""
16836
16837 # type: verbatim
16838 #. type: verbatim
16839 #: ../src/guestfs-actions.pod:5707
16840 #, no-wrap
16841 msgid ""
16842 " int\n"
16843 " guestfs_set_recovery_proc (guestfs_h *g,\n"
16844 "                            int recoveryproc);\n"
16845 "\n"
16846 msgstr ""
16847
16848 # type: textblock
16849 #. type: textblock
16850 #: ../src/guestfs-actions.pod:5711
16851 msgid ""
16852 "If this is called with the parameter C<false> then C<guestfs_launch> does "
16853 "not create a recovery process.  The purpose of the recovery process is to "
16854 "stop runaway qemu processes in the case where the main program aborts "
16855 "abruptly."
16856 msgstr ""
16857
16858 # type: textblock
16859 #. type: textblock
16860 #: ../src/guestfs-actions.pod:5716
16861 msgid ""
16862 "This only has any effect if called before C<guestfs_launch>, and the default "
16863 "is true."
16864 msgstr ""
16865
16866 # type: textblock
16867 #. type: textblock
16868 #: ../src/guestfs-actions.pod:5719 ../fish/guestfish-actions.pod:3830
16869 msgid ""
16870 "About the only time when you would want to disable this is if the main "
16871 "process will fork itself into the background (\"daemonize\" itself).  In "
16872 "this case the recovery process thinks that the main program has disappeared "
16873 "and so kills qemu, which is not very helpful."
16874 msgstr ""
16875
16876 # type: =head2
16877 #. type: =head2
16878 #: ../src/guestfs-actions.pod:5729
16879 msgid "guestfs_set_selinux"
16880 msgstr ""
16881
16882 # type: verbatim
16883 #. type: verbatim
16884 #: ../src/guestfs-actions.pod:5731
16885 #, no-wrap
16886 msgid ""
16887 " int\n"
16888 " guestfs_set_selinux (guestfs_h *g,\n"
16889 "                      int selinux);\n"
16890 "\n"
16891 msgstr ""
16892
16893 # type: textblock
16894 #. type: textblock
16895 #: ../src/guestfs-actions.pod:5735 ../fish/guestfish-actions.pod:3842
16896 msgid ""
16897 "This sets the selinux flag that is passed to the appliance at boot time.  "
16898 "The default is C<selinux=0> (disabled)."
16899 msgstr ""
16900
16901 # type: textblock
16902 #. type: textblock
16903 #: ../src/guestfs-actions.pod:5738 ../fish/guestfish-actions.pod:3845
16904 msgid ""
16905 "Note that if SELinux is enabled, it is always in Permissive mode "
16906 "(C<enforcing=0>)."
16907 msgstr ""
16908
16909 # type: =head2
16910 #. type: =head2
16911 #: ../src/guestfs-actions.pod:5748
16912 msgid "guestfs_set_trace"
16913 msgstr ""
16914
16915 # type: verbatim
16916 #. type: verbatim
16917 #: ../src/guestfs-actions.pod:5750
16918 #, no-wrap
16919 msgid ""
16920 " int\n"
16921 " guestfs_set_trace (guestfs_h *g,\n"
16922 "                    int trace);\n"
16923 "\n"
16924 msgstr ""
16925
16926 # type: textblock
16927 #. type: textblock
16928 #: ../src/guestfs-actions.pod:5754 ../fish/guestfish-actions.pod:3857
16929 msgid ""
16930 "If the command trace flag is set to 1, then commands are printed on stderr "
16931 "before they are executed in a format which is very similar to the one used "
16932 "by guestfish.  In other words, you can run a program with this enabled, and "
16933 "you will get out a script which you can feed to guestfish to perform the "
16934 "same set of actions."
16935 msgstr ""
16936
16937 # type: textblock
16938 #. type: textblock
16939 #: ../src/guestfs-actions.pod:5761 ../fish/guestfish-actions.pod:3864
16940 msgid ""
16941 "If you want to trace C API calls into libguestfs (and other libraries) then "
16942 "possibly a better way is to use the external ltrace(1) command."
16943 msgstr ""
16944
16945 # type: textblock
16946 #. type: textblock
16947 #: ../src/guestfs-actions.pod:5765 ../fish/guestfish-actions.pod:3868
16948 msgid ""
16949 "Command traces are disabled unless the environment variable "
16950 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
16951 msgstr ""
16952
16953 # type: =head2
16954 #. type: =head2
16955 #: ../src/guestfs-actions.pod:5772
16956 msgid "guestfs_set_verbose"
16957 msgstr ""
16958
16959 # type: verbatim
16960 #. type: verbatim
16961 #: ../src/guestfs-actions.pod:5774
16962 #, no-wrap
16963 msgid ""
16964 " int\n"
16965 " guestfs_set_verbose (guestfs_h *g,\n"
16966 "                      int verbose);\n"
16967 "\n"
16968 msgstr ""
16969
16970 # type: textblock
16971 #. type: textblock
16972 #: ../src/guestfs-actions.pod:5778 ../fish/guestfish-actions.pod:3877
16973 msgid "If C<verbose> is true, this turns on verbose messages (to C<stderr>)."
16974 msgstr ""
16975
16976 # type: textblock
16977 #. type: textblock
16978 #: ../src/guestfs-actions.pod:5780 ../fish/guestfish-actions.pod:3879
16979 msgid ""
16980 "Verbose messages are disabled unless the environment variable "
16981 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
16982 msgstr ""
16983
16984 # type: =head2
16985 #. type: =head2
16986 #: ../src/guestfs-actions.pod:5787
16987 msgid "guestfs_setcon"
16988 msgstr ""
16989
16990 # type: verbatim
16991 #. type: verbatim
16992 #: ../src/guestfs-actions.pod:5789
16993 #, no-wrap
16994 msgid ""
16995 " int\n"
16996 " guestfs_setcon (guestfs_h *g,\n"
16997 "                 const char *context);\n"
16998 "\n"
16999 msgstr ""
17000
17001 # type: textblock
17002 #. type: textblock
17003 #: ../src/guestfs-actions.pod:5793 ../fish/guestfish-actions.pod:3886
17004 msgid ""
17005 "This sets the SELinux security context of the daemon to the string "
17006 "C<context>."
17007 msgstr ""
17008
17009 # type: textblock
17010 #. type: textblock
17011 #: ../src/guestfs-actions.pod:5796 ../fish/guestfish-actions.pod:3889
17012 msgid "See the documentation about SELINUX in L<guestfs(3)>."
17013 msgstr ""
17014
17015 # type: =head2
17016 #. type: =head2
17017 #: ../src/guestfs-actions.pod:5802
17018 msgid "guestfs_setxattr"
17019 msgstr ""
17020
17021 # type: verbatim
17022 #. type: verbatim
17023 #: ../src/guestfs-actions.pod:5804
17024 #, no-wrap
17025 msgid ""
17026 " int\n"
17027 " guestfs_setxattr (guestfs_h *g,\n"
17028 "                   const char *xattr,\n"
17029 "                   const char *val,\n"
17030 "                   int vallen,\n"
17031 "                   const char *path);\n"
17032 "\n"
17033 msgstr ""
17034
17035 # type: textblock
17036 #. type: textblock
17037 #: ../src/guestfs-actions.pod:5811 ../fish/guestfish-actions.pod:3895
17038 msgid ""
17039 "This call sets the extended attribute named C<xattr> of the file C<path> to "
17040 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
17041 msgstr ""
17042
17043 # type: textblock
17044 #. type: textblock
17045 #: ../src/guestfs-actions.pod:5815
17046 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
17047 msgstr ""
17048
17049 # type: =head2
17050 #. type: =head2
17051 #: ../src/guestfs-actions.pod:5821
17052 msgid "guestfs_sfdisk"
17053 msgstr ""
17054
17055 # type: verbatim
17056 #. type: verbatim
17057 #: ../src/guestfs-actions.pod:5823
17058 #, no-wrap
17059 msgid ""
17060 " int\n"
17061 " guestfs_sfdisk (guestfs_h *g,\n"
17062 "                 const char *device,\n"
17063 "                 int cyls,\n"
17064 "                 int heads,\n"
17065 "                 int sectors,\n"
17066 "                 char *const *lines);\n"
17067 "\n"
17068 msgstr ""
17069
17070 # type: textblock
17071 #. type: textblock
17072 #: ../src/guestfs-actions.pod:5831 ../fish/guestfish-actions.pod:3905
17073 msgid ""
17074 "This is a direct interface to the L<sfdisk(8)> program for creating "
17075 "partitions on block devices."
17076 msgstr ""
17077
17078 # type: textblock
17079 #. type: textblock
17080 #: ../src/guestfs-actions.pod:5834 ../fish/guestfish-actions.pod:3908
17081 msgid "C<device> should be a block device, for example C</dev/sda>."
17082 msgstr ""
17083
17084 # type: textblock
17085 #. type: textblock
17086 #: ../src/guestfs-actions.pod:5836 ../fish/guestfish-actions.pod:3910
17087 msgid ""
17088 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
17089 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
17090 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
17091 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
17092 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
17093 "the kernel) cannot work out the right geometry and you will need to tell it."
17094 msgstr ""
17095
17096 # type: textblock
17097 #. type: textblock
17098 #: ../src/guestfs-actions.pod:5844 ../fish/guestfish-actions.pod:3918
17099 msgid ""
17100 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
17101 "refer to the L<sfdisk(8)> manpage."
17102 msgstr ""
17103
17104 # type: textblock
17105 #. type: textblock
17106 #: ../src/guestfs-actions.pod:5847 ../fish/guestfish-actions.pod:3921
17107 msgid ""
17108 "To create a single partition occupying the whole disk, you would pass "
17109 "C<lines> as a single element list, when the single element being the string "
17110 "C<,> (comma)."
17111 msgstr ""
17112
17113 # type: textblock
17114 #. type: textblock
17115 #: ../src/guestfs-actions.pod:5851
17116 msgid ""
17117 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
17118 msgstr ""
17119
17120 # type: =head2
17121 #. type: =head2
17122 #: ../src/guestfs-actions.pod:5861
17123 msgid "guestfs_sfdiskM"
17124 msgstr ""
17125
17126 # type: verbatim
17127 #. type: verbatim
17128 #: ../src/guestfs-actions.pod:5863
17129 #, no-wrap
17130 msgid ""
17131 " int\n"
17132 " guestfs_sfdiskM (guestfs_h *g,\n"
17133 "                  const char *device,\n"
17134 "                  char *const *lines);\n"
17135 "\n"
17136 msgstr ""
17137
17138 # type: textblock
17139 #. type: textblock
17140 #: ../src/guestfs-actions.pod:5868
17141 msgid ""
17142 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
17143 "partition sizes are specified in megabytes only (rounded to the nearest "
17144 "cylinder) and you don't need to specify the cyls, heads and sectors "
17145 "parameters which were rarely if ever used anyway."
17146 msgstr ""
17147
17148 # type: textblock
17149 #. type: textblock
17150 #: ../src/guestfs-actions.pod:5874
17151 msgid ""
17152 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
17153 "C<guestfs_part_disk>"
17154 msgstr ""
17155
17156 # type: =head2
17157 #. type: =head2
17158 #: ../src/guestfs-actions.pod:5884
17159 msgid "guestfs_sfdisk_N"
17160 msgstr ""
17161
17162 # type: verbatim
17163 #. type: verbatim
17164 #: ../src/guestfs-actions.pod:5886
17165 #, no-wrap
17166 msgid ""
17167 " int\n"
17168 " guestfs_sfdisk_N (guestfs_h *g,\n"
17169 "                   const char *device,\n"
17170 "                   int partnum,\n"
17171 "                   int cyls,\n"
17172 "                   int heads,\n"
17173 "                   int sectors,\n"
17174 "                   const char *line);\n"
17175 "\n"
17176 msgstr ""
17177
17178 # type: textblock
17179 #. type: textblock
17180 #: ../src/guestfs-actions.pod:5895 ../fish/guestfish-actions.pod:3951
17181 msgid ""
17182 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
17183 "(note: C<n> counts from 1)."
17184 msgstr ""
17185
17186 # type: textblock
17187 #. type: textblock
17188 #: ../src/guestfs-actions.pod:5898
17189 msgid ""
17190 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
17191 "for the cyls/heads/sectors parameters."
17192 msgstr ""
17193
17194 # type: textblock
17195 #. type: textblock
17196 #: ../src/guestfs-actions.pod:5901
17197 msgid "See also: C<guestfs_part_add>"
17198 msgstr ""
17199
17200 # type: =head2
17201 #. type: =head2
17202 #: ../src/guestfs-actions.pod:5910
17203 msgid "guestfs_sfdisk_disk_geometry"
17204 msgstr ""
17205
17206 # type: verbatim
17207 #. type: verbatim
17208 #: ../src/guestfs-actions.pod:5912
17209 #, no-wrap
17210 msgid ""
17211 " char *\n"
17212 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
17213 "                               const char *device);\n"
17214 "\n"
17215 msgstr ""
17216
17217 # type: textblock
17218 #. type: textblock
17219 #: ../src/guestfs-actions.pod:5916
17220 msgid ""
17221 "This displays the disk geometry of C<device> read from the partition table.  "
17222 "Especially in the case where the underlying block device has been resized, "
17223 "this can be different from the kernel's idea of the geometry (see "
17224 "C<guestfs_sfdisk_kernel_geometry>)."
17225 msgstr ""
17226
17227 # type: textblock
17228 #. type: textblock
17229 #: ../src/guestfs-actions.pod:5921 ../src/guestfs-actions.pod:5937
17230 #: ../fish/guestfish-actions.pod:3971 ../fish/guestfish-actions.pod:3980
17231 msgid "The result is in human-readable format, and not designed to be parsed."
17232 msgstr ""
17233
17234 # type: =head2
17235 #. type: =head2
17236 #: ../src/guestfs-actions.pod:5929
17237 msgid "guestfs_sfdisk_kernel_geometry"
17238 msgstr ""
17239
17240 # type: verbatim
17241 #. type: verbatim
17242 #: ../src/guestfs-actions.pod:5931
17243 #, no-wrap
17244 msgid ""
17245 " char *\n"
17246 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
17247 "                                 const char *device);\n"
17248 "\n"
17249 msgstr ""
17250
17251 # type: textblock
17252 #. type: textblock
17253 #: ../src/guestfs-actions.pod:5935 ../fish/guestfish-actions.pod:3978
17254 msgid "This displays the kernel's idea of the geometry of C<device>."
17255 msgstr ""
17256
17257 # type: =head2
17258 #. type: =head2
17259 #: ../src/guestfs-actions.pod:5945
17260 msgid "guestfs_sfdisk_l"
17261 msgstr ""
17262
17263 # type: verbatim
17264 #. type: verbatim
17265 #: ../src/guestfs-actions.pod:5947
17266 #, no-wrap
17267 msgid ""
17268 " char *\n"
17269 " guestfs_sfdisk_l (guestfs_h *g,\n"
17270 "                   const char *device);\n"
17271 "\n"
17272 msgstr ""
17273
17274 # type: textblock
17275 #. type: textblock
17276 #: ../src/guestfs-actions.pod:5951 ../fish/guestfish-actions.pod:3987
17277 msgid ""
17278 "This displays the partition table on C<device>, in the human-readable output "
17279 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
17280 msgstr ""
17281
17282 # type: textblock
17283 #. type: textblock
17284 #: ../src/guestfs-actions.pod:5955
17285 msgid "See also: C<guestfs_part_list>"
17286 msgstr ""
17287
17288 # type: =head2
17289 #. type: =head2
17290 #: ../src/guestfs-actions.pod:5962
17291 msgid "guestfs_sh"
17292 msgstr ""
17293
17294 # type: verbatim
17295 #. type: verbatim
17296 #: ../src/guestfs-actions.pod:5964
17297 #, no-wrap
17298 msgid ""
17299 " char *\n"
17300 " guestfs_sh (guestfs_h *g,\n"
17301 "             const char *command);\n"
17302 "\n"
17303 msgstr ""
17304
17305 # type: textblock
17306 #. type: textblock
17307 #: ../src/guestfs-actions.pod:5968 ../fish/guestfish-actions.pod:3997
17308 msgid ""
17309 "This call runs a command from the guest filesystem via the guest's C</bin/"
17310 "sh>."
17311 msgstr ""
17312
17313 # type: textblock
17314 #. type: textblock
17315 #: ../src/guestfs-actions.pod:5971
17316 msgid "This is like C<guestfs_command>, but passes the command to:"
17317 msgstr ""
17318
17319 # type: verbatim
17320 #. type: verbatim
17321 #: ../src/guestfs-actions.pod:5973 ../fish/guestfish-actions.pod:4002
17322 #, no-wrap
17323 msgid ""
17324 " /bin/sh -c \"command\"\n"
17325 "\n"
17326 msgstr ""
17327
17328 # type: textblock
17329 #. type: textblock
17330 #: ../src/guestfs-actions.pod:5975 ../fish/guestfish-actions.pod:4004
17331 msgid ""
17332 "Depending on the guest's shell, this usually results in wildcards being "
17333 "expanded, shell expressions being interpolated and so on."
17334 msgstr ""
17335
17336 # type: textblock
17337 #. type: textblock
17338 #: ../src/guestfs-actions.pod:5979
17339 msgid "All the provisos about C<guestfs_command> apply to this call."
17340 msgstr ""
17341
17342 # type: =head2
17343 #. type: =head2
17344 #: ../src/guestfs-actions.pod:5986
17345 msgid "guestfs_sh_lines"
17346 msgstr ""
17347
17348 # type: verbatim
17349 #. type: verbatim
17350 #: ../src/guestfs-actions.pod:5988
17351 #, no-wrap
17352 msgid ""
17353 " char **\n"
17354 " guestfs_sh_lines (guestfs_h *g,\n"
17355 "                   const char *command);\n"
17356 "\n"
17357 msgstr ""
17358
17359 # type: textblock
17360 #. type: textblock
17361 #: ../src/guestfs-actions.pod:5992
17362 msgid ""
17363 "This is the same as C<guestfs_sh>, but splits the result into a list of "
17364 "lines."
17365 msgstr ""
17366
17367 # type: textblock
17368 #. type: textblock
17369 #: ../src/guestfs-actions.pod:5995
17370 msgid "See also: C<guestfs_command_lines>"
17371 msgstr ""
17372
17373 # type: =head2
17374 #. type: =head2
17375 #: ../src/guestfs-actions.pod:6003
17376 msgid "guestfs_sleep"
17377 msgstr ""
17378
17379 # type: verbatim
17380 #. type: verbatim
17381 #: ../src/guestfs-actions.pod:6005
17382 #, no-wrap
17383 msgid ""
17384 " int\n"
17385 " guestfs_sleep (guestfs_h *g,\n"
17386 "                int secs);\n"
17387 "\n"
17388 msgstr ""
17389
17390 # type: textblock
17391 #. type: textblock
17392 #: ../src/guestfs-actions.pod:6009 ../fish/guestfish-actions.pod:4023
17393 msgid "Sleep for C<secs> seconds."
17394 msgstr ""
17395
17396 # type: textblock
17397 #. type: textblock
17398 #: ../src/guestfs-actions.pod:6013
17399 msgid "(Added in 1.0.41)"
17400 msgstr ""
17401
17402 # type: =head2
17403 #. type: =head2
17404 #: ../src/guestfs-actions.pod:6015 ../src/guestfs-structs.pod:109
17405 msgid "guestfs_stat"
17406 msgstr ""
17407
17408 # type: verbatim
17409 #. type: verbatim
17410 #: ../src/guestfs-actions.pod:6017
17411 #, no-wrap
17412 msgid ""
17413 " struct guestfs_stat *\n"
17414 " guestfs_stat (guestfs_h *g,\n"
17415 "               const char *path);\n"
17416 "\n"
17417 msgstr ""
17418
17419 # type: textblock
17420 #. type: textblock
17421 #: ../src/guestfs-actions.pod:6023 ../fish/guestfish-actions.pod:4031
17422 msgid "This is the same as the C<stat(2)> system call."
17423 msgstr ""
17424
17425 # type: =head2
17426 #. type: =head2
17427 #: ../src/guestfs-actions.pod:6031 ../src/guestfs-structs.pod:135
17428 msgid "guestfs_statvfs"
17429 msgstr ""
17430
17431 # type: verbatim
17432 #. type: verbatim
17433 #: ../src/guestfs-actions.pod:6033
17434 #, no-wrap
17435 msgid ""
17436 " struct guestfs_statvfs *\n"
17437 " guestfs_statvfs (guestfs_h *g,\n"
17438 "                  const char *path);\n"
17439 "\n"
17440 msgstr ""
17441
17442 # type: textblock
17443 #. type: textblock
17444 #: ../src/guestfs-actions.pod:6037 ../fish/guestfish-actions.pod:4037
17445 msgid ""
17446 "Returns file system statistics for any mounted file system.  C<path> should "
17447 "be a file or directory in the mounted file system (typically it is the mount "
17448 "point itself, but it doesn't need to be)."
17449 msgstr ""
17450
17451 # type: textblock
17452 #. type: textblock
17453 #: ../src/guestfs-actions.pod:6041 ../fish/guestfish-actions.pod:4041
17454 msgid "This is the same as the C<statvfs(2)> system call."
17455 msgstr ""
17456
17457 # type: textblock
17458 #. type: textblock
17459 #: ../src/guestfs-actions.pod:6043
17460 msgid ""
17461 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
17462 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
17463 msgstr ""
17464
17465 # type: =head2
17466 #. type: =head2
17467 #: ../src/guestfs-actions.pod:6049
17468 msgid "guestfs_strings"
17469 msgstr ""
17470
17471 # type: verbatim
17472 #. type: verbatim
17473 #: ../src/guestfs-actions.pod:6051
17474 #, no-wrap
17475 msgid ""
17476 " char **\n"
17477 " guestfs_strings (guestfs_h *g,\n"
17478 "                  const char *path);\n"
17479 "\n"
17480 msgstr ""
17481
17482 # type: textblock
17483 #. type: textblock
17484 #: ../src/guestfs-actions.pod:6055 ../fish/guestfish-actions.pod:4047
17485 msgid ""
17486 "This runs the L<strings(1)> command on a file and returns the list of "
17487 "printable strings found."
17488 msgstr ""
17489
17490 # type: =head2
17491 #. type: =head2
17492 #: ../src/guestfs-actions.pod:6067
17493 msgid "guestfs_strings_e"
17494 msgstr ""
17495
17496 # type: verbatim
17497 #. type: verbatim
17498 #: ../src/guestfs-actions.pod:6069
17499 #, no-wrap
17500 msgid ""
17501 " char **\n"
17502 " guestfs_strings_e (guestfs_h *g,\n"
17503 "                    const char *encoding,\n"
17504 "                    const char *path);\n"
17505 "\n"
17506 msgstr ""
17507
17508 # type: textblock
17509 #. type: textblock
17510 #: ../src/guestfs-actions.pod:6074
17511 msgid ""
17512 "This is like the C<guestfs_strings> command, but allows you to specify the "
17513 "encoding of strings that are looked for in the source file C<path>."
17514 msgstr ""
17515
17516 # type: textblock
17517 #. type: textblock
17518 #: ../src/guestfs-actions.pod:6078 ../fish/guestfish-actions.pod:4061
17519 msgid "Allowed encodings are:"
17520 msgstr ""
17521
17522 # type: =item
17523 #. type: =item
17524 #: ../src/guestfs-actions.pod:6082 ../fish/guestfish-actions.pod:4065
17525 msgid "s"
17526 msgstr ""
17527
17528 # type: textblock
17529 #. type: textblock
17530 #: ../src/guestfs-actions.pod:6084
17531 msgid ""
17532 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
17533 "ISO-8859-X (this is what C<guestfs_strings> uses)."
17534 msgstr ""
17535
17536 # type: =item
17537 #. type: =item
17538 #: ../src/guestfs-actions.pod:6087 ../fish/guestfish-actions.pod:4070
17539 msgid "S"
17540 msgstr ""
17541
17542 # type: textblock
17543 #. type: textblock
17544 #: ../src/guestfs-actions.pod:6089 ../fish/guestfish-actions.pod:4072
17545 msgid "Single 8-bit-byte characters."
17546 msgstr ""
17547
17548 # type: =item
17549 #. type: =item
17550 #: ../src/guestfs-actions.pod:6091 ../fish/guestfish-actions.pod:4074
17551 msgid "b"
17552 msgstr ""
17553
17554 # type: textblock
17555 #. type: textblock
17556 #: ../src/guestfs-actions.pod:6093 ../fish/guestfish-actions.pod:4076
17557 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
17558 msgstr ""
17559
17560 # type: =item
17561 #. type: =item
17562 #: ../src/guestfs-actions.pod:6096 ../fish/guestfish-actions.pod:4079
17563 msgid "l (lower case letter L)"
17564 msgstr ""
17565
17566 # type: textblock
17567 #. type: textblock
17568 #: ../src/guestfs-actions.pod:6098 ../fish/guestfish-actions.pod:4081
17569 msgid ""
17570 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
17571 "examining binaries in Windows guests."
17572 msgstr ""
17573
17574 # type: =item
17575 #. type: =item
17576 #: ../src/guestfs-actions.pod:6101 ../fish/guestfish-actions.pod:4084
17577 msgid "B"
17578 msgstr ""
17579
17580 # type: textblock
17581 #. type: textblock
17582 #: ../src/guestfs-actions.pod:6103 ../fish/guestfish-actions.pod:4086
17583 msgid "32-bit big endian such as UCS-4BE."
17584 msgstr ""
17585
17586 # type: =item
17587 #. type: =item
17588 #: ../src/guestfs-actions.pod:6105 ../fish/guestfish-actions.pod:4088
17589 msgid "L"
17590 msgstr ""
17591
17592 # type: textblock
17593 #. type: textblock
17594 #: ../src/guestfs-actions.pod:6107 ../fish/guestfish-actions.pod:4090
17595 msgid "32-bit little endian such as UCS-4LE."
17596 msgstr ""
17597
17598 # type: textblock
17599 #. type: textblock
17600 #: ../src/guestfs-actions.pod:6111 ../fish/guestfish-actions.pod:4094
17601 msgid "The returned strings are transcoded to UTF-8."
17602 msgstr ""
17603
17604 # type: =head2
17605 #. type: =head2
17606 #: ../src/guestfs-actions.pod:6122
17607 msgid "guestfs_swapoff_device"
17608 msgstr ""
17609
17610 # type: verbatim
17611 #. type: verbatim
17612 #: ../src/guestfs-actions.pod:6124
17613 #, no-wrap
17614 msgid ""
17615 " int\n"
17616 " guestfs_swapoff_device (guestfs_h *g,\n"
17617 "                         const char *device);\n"
17618 "\n"
17619 msgstr ""
17620
17621 # type: textblock
17622 #. type: textblock
17623 #: ../src/guestfs-actions.pod:6128
17624 msgid ""
17625 "This command disables the libguestfs appliance swap device or partition "
17626 "named C<device>.  See C<guestfs_swapon_device>."
17627 msgstr ""
17628
17629 # type: =head2
17630 #. type: =head2
17631 #: ../src/guestfs-actions.pod:6136
17632 msgid "guestfs_swapoff_file"
17633 msgstr ""
17634
17635 # type: verbatim
17636 #. type: verbatim
17637 #: ../src/guestfs-actions.pod:6138
17638 #, no-wrap
17639 msgid ""
17640 " int\n"
17641 " guestfs_swapoff_file (guestfs_h *g,\n"
17642 "                       const char *file);\n"
17643 "\n"
17644 msgstr ""
17645
17646 # type: textblock
17647 #. type: textblock
17648 #: ../src/guestfs-actions.pod:6142 ../fish/guestfish-actions.pod:4111
17649 msgid "This command disables the libguestfs appliance swap on file."
17650 msgstr ""
17651
17652 # type: =head2
17653 #. type: =head2
17654 #: ../src/guestfs-actions.pod:6148
17655 msgid "guestfs_swapoff_label"
17656 msgstr ""
17657
17658 # type: verbatim
17659 #. type: verbatim
17660 #: ../src/guestfs-actions.pod:6150
17661 #, no-wrap
17662 msgid ""
17663 " int\n"
17664 " guestfs_swapoff_label (guestfs_h *g,\n"
17665 "                        const char *label);\n"
17666 "\n"
17667 msgstr ""
17668
17669 # type: textblock
17670 #. type: textblock
17671 #: ../src/guestfs-actions.pod:6154 ../fish/guestfish-actions.pod:4117
17672 msgid ""
17673 "This command disables the libguestfs appliance swap on labeled swap "
17674 "partition."
17675 msgstr ""
17676
17677 # type: =head2
17678 #. type: =head2
17679 #: ../src/guestfs-actions.pod:6161
17680 msgid "guestfs_swapoff_uuid"
17681 msgstr ""
17682
17683 # type: verbatim
17684 #. type: verbatim
17685 #: ../src/guestfs-actions.pod:6163
17686 #, no-wrap
17687 msgid ""
17688 " int\n"
17689 " guestfs_swapoff_uuid (guestfs_h *g,\n"
17690 "                       const char *uuid);\n"
17691 "\n"
17692 msgstr ""
17693
17694 # type: textblock
17695 #. type: textblock
17696 #: ../src/guestfs-actions.pod:6167 ../fish/guestfish-actions.pod:4124
17697 msgid ""
17698 "This command disables the libguestfs appliance swap partition with the given "
17699 "UUID."
17700 msgstr ""
17701
17702 # type: =head2
17703 #. type: =head2
17704 #: ../src/guestfs-actions.pod:6174
17705 msgid "guestfs_swapon_device"
17706 msgstr ""
17707
17708 # type: verbatim
17709 #. type: verbatim
17710 #: ../src/guestfs-actions.pod:6176
17711 #, no-wrap
17712 msgid ""
17713 " int\n"
17714 " guestfs_swapon_device (guestfs_h *g,\n"
17715 "                        const char *device);\n"
17716 "\n"
17717 msgstr ""
17718
17719 # type: textblock
17720 #. type: textblock
17721 #: ../src/guestfs-actions.pod:6180
17722 msgid ""
17723 "This command enables the libguestfs appliance to use the swap device or "
17724 "partition named C<device>.  The increased memory is made available for all "
17725 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
17726 msgstr ""
17727
17728 # type: textblock
17729 #. type: textblock
17730 #: ../src/guestfs-actions.pod:6185 ../fish/guestfish-actions.pod:4136
17731 msgid ""
17732 "Note that you should not swap to existing guest swap partitions unless you "
17733 "know what you are doing.  They may contain hibernation information, or other "
17734 "information that the guest doesn't want you to trash.  You also risk leaking "
17735 "information about the host to the guest this way.  Instead, attach a new "
17736 "host device to the guest and swap on that."
17737 msgstr ""
17738
17739 # type: =head2
17740 #. type: =head2
17741 #: ../src/guestfs-actions.pod:6196
17742 msgid "guestfs_swapon_file"
17743 msgstr ""
17744
17745 # type: verbatim
17746 #. type: verbatim
17747 #: ../src/guestfs-actions.pod:6198
17748 #, no-wrap
17749 msgid ""
17750 " int\n"
17751 " guestfs_swapon_file (guestfs_h *g,\n"
17752 "                      const char *file);\n"
17753 "\n"
17754 msgstr ""
17755
17756 # type: textblock
17757 #. type: textblock
17758 #: ../src/guestfs-actions.pod:6202
17759 msgid ""
17760 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
17761 "notes."
17762 msgstr ""
17763
17764 # type: =head2
17765 #. type: =head2
17766 #: ../src/guestfs-actions.pod:6209
17767 msgid "guestfs_swapon_label"
17768 msgstr ""
17769
17770 # type: verbatim
17771 #. type: verbatim
17772 #: ../src/guestfs-actions.pod:6211
17773 #, no-wrap
17774 msgid ""
17775 " int\n"
17776 " guestfs_swapon_label (guestfs_h *g,\n"
17777 "                       const char *label);\n"
17778 "\n"
17779 msgstr ""
17780
17781 # type: textblock
17782 #. type: textblock
17783 #: ../src/guestfs-actions.pod:6215
17784 msgid ""
17785 "This command enables swap to a labeled swap partition.  See "
17786 "C<guestfs_swapon_device> for other notes."
17787 msgstr ""
17788
17789 # type: =head2
17790 #. type: =head2
17791 #: ../src/guestfs-actions.pod:6222
17792 msgid "guestfs_swapon_uuid"
17793 msgstr ""
17794
17795 # type: verbatim
17796 #. type: verbatim
17797 #: ../src/guestfs-actions.pod:6224
17798 #, no-wrap
17799 msgid ""
17800 " int\n"
17801 " guestfs_swapon_uuid (guestfs_h *g,\n"
17802 "                      const char *uuid);\n"
17803 "\n"
17804 msgstr ""
17805
17806 # type: textblock
17807 #. type: textblock
17808 #: ../src/guestfs-actions.pod:6228
17809 msgid ""
17810 "This command enables swap to a swap partition with the given UUID.  See "
17811 "C<guestfs_swapon_device> for other notes."
17812 msgstr ""
17813
17814 # type: =head2
17815 #. type: =head2
17816 #: ../src/guestfs-actions.pod:6235
17817 msgid "guestfs_sync"
17818 msgstr ""
17819
17820 # type: verbatim
17821 #. type: verbatim
17822 #: ../src/guestfs-actions.pod:6237
17823 #, no-wrap
17824 msgid ""
17825 " int\n"
17826 " guestfs_sync (guestfs_h *g);\n"
17827 "\n"
17828 msgstr ""
17829
17830 # type: textblock
17831 #. type: textblock
17832 #: ../src/guestfs-actions.pod:6240 ../fish/guestfish-actions.pod:4168
17833 msgid ""
17834 "This syncs the disk, so that any writes are flushed through to the "
17835 "underlying disk image."
17836 msgstr ""
17837
17838 # type: textblock
17839 #. type: textblock
17840 #: ../src/guestfs-actions.pod:6243 ../fish/guestfish-actions.pod:4171
17841 msgid ""
17842 "You should always call this if you have modified a disk image, before "
17843 "closing the handle."
17844 msgstr ""
17845
17846 # type: =head2
17847 #. type: =head2
17848 #: ../src/guestfs-actions.pod:6250
17849 msgid "guestfs_tail"
17850 msgstr ""
17851
17852 # type: verbatim
17853 #. type: verbatim
17854 #: ../src/guestfs-actions.pod:6252
17855 #, no-wrap
17856 msgid ""
17857 " char **\n"
17858 " guestfs_tail (guestfs_h *g,\n"
17859 "               const char *path);\n"
17860 "\n"
17861 msgstr ""
17862
17863 # type: textblock
17864 #. type: textblock
17865 #: ../src/guestfs-actions.pod:6256 ../fish/guestfish-actions.pod:4178
17866 msgid ""
17867 "This command returns up to the last 10 lines of a file as a list of strings."
17868 msgstr ""
17869
17870 # type: =head2
17871 #. type: =head2
17872 #: ../src/guestfs-actions.pod:6268
17873 msgid "guestfs_tail_n"
17874 msgstr ""
17875
17876 # type: verbatim
17877 #. type: verbatim
17878 #: ../src/guestfs-actions.pod:6270
17879 #, no-wrap
17880 msgid ""
17881 " char **\n"
17882 " guestfs_tail_n (guestfs_h *g,\n"
17883 "                 int nrlines,\n"
17884 "                 const char *path);\n"
17885 "\n"
17886 msgstr ""
17887
17888 # type: textblock
17889 #. type: textblock
17890 #: ../src/guestfs-actions.pod:6275 ../fish/guestfish-actions.pod:4188
17891 msgid ""
17892 "If the parameter C<nrlines> is a positive number, this returns the last "
17893 "C<nrlines> lines of the file C<path>."
17894 msgstr ""
17895
17896 # type: textblock
17897 #. type: textblock
17898 #: ../src/guestfs-actions.pod:6278 ../fish/guestfish-actions.pod:4191
17899 msgid ""
17900 "If the parameter C<nrlines> is a negative number, this returns lines from "
17901 "the file C<path>, starting with the C<-nrlines>th line."
17902 msgstr ""
17903
17904 # type: =head2
17905 #. type: =head2
17906 #: ../src/guestfs-actions.pod:6292
17907 msgid "guestfs_tar_in"
17908 msgstr ""
17909
17910 # type: verbatim
17911 #. type: verbatim
17912 #: ../src/guestfs-actions.pod:6294
17913 #, no-wrap
17914 msgid ""
17915 " int\n"
17916 " guestfs_tar_in (guestfs_h *g,\n"
17917 "                 const char *tarfile,\n"
17918 "                 const char *directory);\n"
17919 "\n"
17920 msgstr ""
17921
17922 # type: textblock
17923 #. type: textblock
17924 #: ../src/guestfs-actions.pod:6299 ../fish/guestfish-actions.pod:4203
17925 msgid ""
17926 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
17927 "tar file) into C<directory>."
17928 msgstr ""
17929
17930 # type: textblock
17931 #. type: textblock
17932 #: ../src/guestfs-actions.pod:6302
17933 msgid ""
17934 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
17935 msgstr ""
17936
17937 # type: textblock
17938 #. type: textblock
17939 #: ../src/guestfs-actions.pod:6307 ../src/guestfs-actions.pod:6324
17940 #: ../src/guestfs-actions.pod:6340 ../src/guestfs-actions.pod:6356
17941 msgid "(Added in 1.0.3)"
17942 msgstr ""
17943
17944 # type: =head2
17945 #. type: =head2
17946 #: ../src/guestfs-actions.pod:6309
17947 msgid "guestfs_tar_out"
17948 msgstr ""
17949
17950 # type: verbatim
17951 #. type: verbatim
17952 #: ../src/guestfs-actions.pod:6311
17953 #, no-wrap
17954 msgid ""
17955 " int\n"
17956 " guestfs_tar_out (guestfs_h *g,\n"
17957 "                  const char *directory,\n"
17958 "                  const char *tarfile);\n"
17959 "\n"
17960 msgstr ""
17961
17962 # type: textblock
17963 #. type: textblock
17964 #: ../src/guestfs-actions.pod:6316 ../fish/guestfish-actions.pod:4215
17965 msgid ""
17966 "This command packs the contents of C<directory> and downloads it to local "
17967 "file C<tarfile>."
17968 msgstr ""
17969
17970 # type: textblock
17971 #. type: textblock
17972 #: ../src/guestfs-actions.pod:6319
17973 msgid ""
17974 "To download a compressed tarball, use C<guestfs_tgz_out> or "
17975 "C<guestfs_txz_out>."
17976 msgstr ""
17977
17978 # type: =head2
17979 #. type: =head2
17980 #: ../src/guestfs-actions.pod:6326
17981 msgid "guestfs_tgz_in"
17982 msgstr ""
17983
17984 # type: verbatim
17985 #. type: verbatim
17986 #: ../src/guestfs-actions.pod:6328
17987 #, no-wrap
17988 msgid ""
17989 " int\n"
17990 " guestfs_tgz_in (guestfs_h *g,\n"
17991 "                 const char *tarball,\n"
17992 "                 const char *directory);\n"
17993 "\n"
17994 msgstr ""
17995
17996 # type: textblock
17997 #. type: textblock
17998 #: ../src/guestfs-actions.pod:6333 ../fish/guestfish-actions.pod:4227
17999 msgid ""
18000 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
18001 "tar file) into C<directory>."
18002 msgstr ""
18003
18004 # type: textblock
18005 #. type: textblock
18006 #: ../src/guestfs-actions.pod:6336
18007 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
18008 msgstr ""
18009
18010 # type: =head2
18011 #. type: =head2
18012 #: ../src/guestfs-actions.pod:6342
18013 msgid "guestfs_tgz_out"
18014 msgstr ""
18015
18016 # type: verbatim
18017 #. type: verbatim
18018 #: ../src/guestfs-actions.pod:6344
18019 #, no-wrap
18020 msgid ""
18021 " int\n"
18022 " guestfs_tgz_out (guestfs_h *g,\n"
18023 "                  const char *directory,\n"
18024 "                  const char *tarball);\n"
18025 "\n"
18026 msgstr ""
18027
18028 # type: textblock
18029 #. type: textblock
18030 #: ../src/guestfs-actions.pod:6349 ../fish/guestfish-actions.pod:4238
18031 msgid ""
18032 "This command packs the contents of C<directory> and downloads it to local "
18033 "file C<tarball>."
18034 msgstr ""
18035
18036 # type: textblock
18037 #. type: textblock
18038 #: ../src/guestfs-actions.pod:6352
18039 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
18040 msgstr ""
18041
18042 # type: =head2
18043 #. type: =head2
18044 #: ../src/guestfs-actions.pod:6358
18045 msgid "guestfs_touch"
18046 msgstr ""
18047
18048 # type: verbatim
18049 #. type: verbatim
18050 #: ../src/guestfs-actions.pod:6360
18051 #, no-wrap
18052 msgid ""
18053 " int\n"
18054 " guestfs_touch (guestfs_h *g,\n"
18055 "                const char *path);\n"
18056 "\n"
18057 msgstr ""
18058
18059 # type: textblock
18060 #. type: textblock
18061 #: ../src/guestfs-actions.pod:6364 ../fish/guestfish-actions.pod:4249
18062 msgid ""
18063 "Touch acts like the L<touch(1)> command.  It can be used to update the "
18064 "timestamps on a file, or, if the file does not exist, to create a new zero-"
18065 "length file."
18066 msgstr ""
18067
18068 # type: textblock
18069 #. type: textblock
18070 #: ../src/guestfs-actions.pod:6368 ../fish/guestfish-actions.pod:4253
18071 msgid ""
18072 "This command only works on regular files, and will fail on other file types "
18073 "such as directories, symbolic links, block special etc."
18074 msgstr ""
18075
18076 # type: =head2
18077 #. type: =head2
18078 #: ../src/guestfs-actions.pod:6375
18079 msgid "guestfs_truncate"
18080 msgstr ""
18081
18082 # type: verbatim
18083 #. type: verbatim
18084 #: ../src/guestfs-actions.pod:6377
18085 #, no-wrap
18086 msgid ""
18087 " int\n"
18088 " guestfs_truncate (guestfs_h *g,\n"
18089 "                   const char *path);\n"
18090 "\n"
18091 msgstr ""
18092
18093 # type: textblock
18094 #. type: textblock
18095 #: ../src/guestfs-actions.pod:6381 ../fish/guestfish-actions.pod:4260
18096 msgid ""
18097 "This command truncates C<path> to a zero-length file.  The file must exist "
18098 "already."
18099 msgstr ""
18100
18101 # type: =head2
18102 #. type: =head2
18103 #: ../src/guestfs-actions.pod:6388
18104 msgid "guestfs_truncate_size"
18105 msgstr ""
18106
18107 # type: verbatim
18108 #. type: verbatim
18109 #: ../src/guestfs-actions.pod:6390
18110 #, no-wrap
18111 msgid ""
18112 " int\n"
18113 " guestfs_truncate_size (guestfs_h *g,\n"
18114 "                        const char *path,\n"
18115 "                        int64_t size);\n"
18116 "\n"
18117 msgstr ""
18118
18119 # type: textblock
18120 #. type: textblock
18121 #: ../src/guestfs-actions.pod:6395 ../fish/guestfish-actions.pod:4267
18122 msgid ""
18123 "This command truncates C<path> to size C<size> bytes.  The file must exist "
18124 "already."
18125 msgstr ""
18126
18127 # type: textblock
18128 #. type: textblock
18129 #: ../src/guestfs-actions.pod:6398
18130 msgid ""
18131 "If the current file size is less than C<size> then the file is extended to "
18132 "the required size with zero bytes.  This creates a sparse file (ie. disk "
18133 "blocks are not allocated for the file until you write to it).  To create a "
18134 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
18135 msgstr ""
18136
18137 # type: =head2
18138 #. type: =head2
18139 #: ../src/guestfs-actions.pod:6408
18140 msgid "guestfs_tune2fs_l"
18141 msgstr ""
18142
18143 # type: verbatim
18144 #. type: verbatim
18145 #: ../src/guestfs-actions.pod:6410
18146 #, no-wrap
18147 msgid ""
18148 " char **\n"
18149 " guestfs_tune2fs_l (guestfs_h *g,\n"
18150 "                    const char *device);\n"
18151 "\n"
18152 msgstr ""
18153
18154 # type: textblock
18155 #. type: textblock
18156 #: ../src/guestfs-actions.pod:6414 ../fish/guestfish-actions.pod:4280
18157 msgid ""
18158 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
18159 "C<device>."
18160 msgstr ""
18161
18162 # type: textblock
18163 #. type: textblock
18164 #: ../src/guestfs-actions.pod:6417 ../fish/guestfish-actions.pod:4283
18165 msgid ""
18166 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
18167 "for more details.  The list of fields returned isn't clearly defined, and "
18168 "depends on both the version of C<tune2fs> that libguestfs was built against, "
18169 "and the filesystem itself."
18170 msgstr ""
18171
18172 # type: =head2
18173 #. type: =head2
18174 #: ../src/guestfs-actions.pod:6430
18175 msgid "guestfs_txz_in"
18176 msgstr ""
18177
18178 # type: verbatim
18179 #. type: verbatim
18180 #: ../src/guestfs-actions.pod:6432
18181 #, no-wrap
18182 msgid ""
18183 " int\n"
18184 " guestfs_txz_in (guestfs_h *g,\n"
18185 "                 const char *tarball,\n"
18186 "                 const char *directory);\n"
18187 "\n"
18188 msgstr ""
18189
18190 # type: textblock
18191 #. type: textblock
18192 #: ../src/guestfs-actions.pod:6437 ../fish/guestfish-actions.pod:4292
18193 msgid ""
18194 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
18195 "tar file) into C<directory>."
18196 msgstr ""
18197
18198 # type: =head2
18199 #. type: =head2
18200 #: ../src/guestfs-actions.pod:6444
18201 msgid "guestfs_txz_out"
18202 msgstr ""
18203
18204 # type: verbatim
18205 #. type: verbatim
18206 #: ../src/guestfs-actions.pod:6446
18207 #, no-wrap
18208 msgid ""
18209 " int\n"
18210 " guestfs_txz_out (guestfs_h *g,\n"
18211 "                  const char *directory,\n"
18212 "                  const char *tarball);\n"
18213 "\n"
18214 msgstr ""
18215
18216 # type: textblock
18217 #. type: textblock
18218 #: ../src/guestfs-actions.pod:6451 ../fish/guestfish-actions.pod:4301
18219 msgid ""
18220 "This command packs the contents of C<directory> and downloads it to local "
18221 "file C<tarball> (as an xz compressed tar archive)."
18222 msgstr ""
18223
18224 # type: =head2
18225 #. type: =head2
18226 #: ../src/guestfs-actions.pod:6458
18227 msgid "guestfs_umask"
18228 msgstr ""
18229
18230 # type: verbatim
18231 #. type: verbatim
18232 #: ../src/guestfs-actions.pod:6460
18233 #, no-wrap
18234 msgid ""
18235 " int\n"
18236 " guestfs_umask (guestfs_h *g,\n"
18237 "                int mask);\n"
18238 "\n"
18239 msgstr ""
18240
18241 # type: textblock
18242 #. type: textblock
18243 #: ../src/guestfs-actions.pod:6464 ../fish/guestfish-actions.pod:4310
18244 msgid ""
18245 "This function sets the mask used for creating new files and device nodes to "
18246 "C<mask & 0777>."
18247 msgstr ""
18248
18249 # type: textblock
18250 #. type: textblock
18251 #: ../src/guestfs-actions.pod:6467 ../fish/guestfish-actions.pod:4313
18252 msgid ""
18253 "Typical umask values would be C<022> which creates new files with "
18254 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
18255 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
18256 msgstr ""
18257
18258 # type: textblock
18259 #. type: textblock
18260 #: ../src/guestfs-actions.pod:6472 ../fish/guestfish-actions.pod:4318
18261 msgid ""
18262 "The default umask is C<022>.  This is important because it means that "
18263 "directories and device nodes will be created with C<0644> or C<0755> mode "
18264 "even if you specify C<0777>."
18265 msgstr ""
18266
18267 # type: textblock
18268 #. type: textblock
18269 #: ../src/guestfs-actions.pod:6476
18270 msgid ""
18271 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
18272 "C<guestfs_mkdir>."
18273 msgstr ""
18274
18275 # type: textblock
18276 #. type: textblock
18277 #: ../src/guestfs-actions.pod:6479 ../fish/guestfish-actions.pod:4325
18278 msgid "This call returns the previous umask."
18279 msgstr ""
18280
18281 # type: =head2
18282 #. type: =head2
18283 #: ../src/guestfs-actions.pod:6485
18284 msgid "guestfs_umount"
18285 msgstr ""
18286
18287 # type: verbatim
18288 #. type: verbatim
18289 #: ../src/guestfs-actions.pod:6487
18290 #, no-wrap
18291 msgid ""
18292 " int\n"
18293 " guestfs_umount (guestfs_h *g,\n"
18294 "                 const char *pathordevice);\n"
18295 "\n"
18296 msgstr ""
18297
18298 # type: textblock
18299 #. type: textblock
18300 #: ../src/guestfs-actions.pod:6491 ../fish/guestfish-actions.pod:4333
18301 msgid ""
18302 "This unmounts the given filesystem.  The filesystem may be specified either "
18303 "by its mountpoint (path) or the device which contains the filesystem."
18304 msgstr ""
18305
18306 # type: =head2
18307 #. type: =head2
18308 #: ../src/guestfs-actions.pod:6499
18309 msgid "guestfs_umount_all"
18310 msgstr ""
18311
18312 # type: verbatim
18313 #. type: verbatim
18314 #: ../src/guestfs-actions.pod:6501
18315 #, no-wrap
18316 msgid ""
18317 " int\n"
18318 " guestfs_umount_all (guestfs_h *g);\n"
18319 "\n"
18320 msgstr ""
18321
18322 # type: textblock
18323 #. type: textblock
18324 #: ../src/guestfs-actions.pod:6504 ../fish/guestfish-actions.pod:4343
18325 msgid "This unmounts all mounted filesystems."
18326 msgstr ""
18327
18328 # type: textblock
18329 #. type: textblock
18330 #: ../src/guestfs-actions.pod:6506 ../fish/guestfish-actions.pod:4345
18331 msgid "Some internal mounts are not unmounted by this call."
18332 msgstr ""
18333
18334 # type: =head2
18335 #. type: =head2
18336 #: ../src/guestfs-actions.pod:6512
18337 msgid "guestfs_upload"
18338 msgstr ""
18339
18340 # type: verbatim
18341 #. type: verbatim
18342 #: ../src/guestfs-actions.pod:6514
18343 #, no-wrap
18344 msgid ""
18345 " int\n"
18346 " guestfs_upload (guestfs_h *g,\n"
18347 "                 const char *filename,\n"
18348 "                 const char *remotefilename);\n"
18349 "\n"
18350 msgstr ""
18351
18352 # type: textblock
18353 #. type: textblock
18354 #: ../src/guestfs-actions.pod:6519 ../src/guestfs-actions.pod:6543
18355 #: ../fish/guestfish-actions.pod:4351 ../fish/guestfish-actions.pod:4364
18356 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
18357 msgstr ""
18358
18359 # type: textblock
18360 #. type: textblock
18361 #: ../src/guestfs-actions.pod:6524
18362 msgid "See also C<guestfs_download>."
18363 msgstr ""
18364
18365 # type: =head2
18366 #. type: =head2
18367 #: ../src/guestfs-actions.pod:6535
18368 msgid "guestfs_upload_offset"
18369 msgstr ""
18370
18371 # type: verbatim
18372 #. type: verbatim
18373 #: ../src/guestfs-actions.pod:6537
18374 #, no-wrap
18375 msgid ""
18376 " int\n"
18377 " guestfs_upload_offset (guestfs_h *g,\n"
18378 "                        const char *filename,\n"
18379 "                        const char *remotefilename,\n"
18380 "                        int64_t offset);\n"
18381 "\n"
18382 msgstr ""
18383
18384 # type: textblock
18385 #. type: textblock
18386 #: ../src/guestfs-actions.pod:6546 ../fish/guestfish-actions.pod:4367
18387 msgid ""
18388 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
18389 "The intention is to overwrite parts of existing files or devices, although "
18390 "if a non-existant file is specified then it is created with a \"hole\" "
18391 "before C<offset>.  The size of the data written is implicit in the size of "
18392 "the source C<filename>."
18393 msgstr ""
18394
18395 # type: textblock
18396 #. type: textblock
18397 #: ../src/guestfs-actions.pod:6553
18398 msgid ""
18399 "Note that there is no limit on the amount of data that can be uploaded with "
18400 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
18401 "full amount unless an error occurs."
18402 msgstr ""
18403
18404 # type: textblock
18405 #. type: textblock
18406 #: ../src/guestfs-actions.pod:6558
18407 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
18408 msgstr ""
18409
18410 # type: =head2
18411 #. type: =head2
18412 #: ../src/guestfs-actions.pod:6569
18413 msgid "guestfs_utimens"
18414 msgstr ""
18415
18416 # type: verbatim
18417 #. type: verbatim
18418 #: ../src/guestfs-actions.pod:6571
18419 #, no-wrap
18420 msgid ""
18421 " int\n"
18422 " guestfs_utimens (guestfs_h *g,\n"
18423 "                  const char *path,\n"
18424 "                  int64_t atsecs,\n"
18425 "                  int64_t atnsecs,\n"
18426 "                  int64_t mtsecs,\n"
18427 "                  int64_t mtnsecs);\n"
18428 "\n"
18429 msgstr ""
18430
18431 # type: textblock
18432 #. type: textblock
18433 #: ../src/guestfs-actions.pod:6579 ../fish/guestfish-actions.pod:4387
18434 msgid "This command sets the timestamps of a file with nanosecond precision."
18435 msgstr ""
18436
18437 # type: textblock
18438 #. type: textblock
18439 #: ../src/guestfs-actions.pod:6582 ../fish/guestfish-actions.pod:4390
18440 msgid ""
18441 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
18442 "from the epoch."
18443 msgstr ""
18444
18445 # type: textblock
18446 #. type: textblock
18447 #: ../src/guestfs-actions.pod:6585 ../fish/guestfish-actions.pod:4393
18448 msgid ""
18449 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
18450 "nanoseconds from the epoch."
18451 msgstr ""
18452
18453 # type: textblock
18454 #. type: textblock
18455 #: ../src/guestfs-actions.pod:6588 ../fish/guestfish-actions.pod:4396
18456 msgid ""
18457 "If the C<*nsecs> field contains the special value C<-1> then the "
18458 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
18459 "ignored in this case)."
18460 msgstr ""
18461
18462 # type: textblock
18463 #. type: textblock
18464 #: ../src/guestfs-actions.pod:6592 ../fish/guestfish-actions.pod:4400
18465 msgid ""
18466 "If the C<*nsecs> field contains the special value C<-2> then the "
18467 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
18468 "in this case)."
18469 msgstr ""
18470
18471 # type: =head2
18472 #. type: =head2
18473 #: ../src/guestfs-actions.pod:6600 ../src/guestfs-structs.pod:175
18474 msgid "guestfs_version"
18475 msgstr ""
18476
18477 # type: verbatim
18478 #. type: verbatim
18479 #: ../src/guestfs-actions.pod:6602
18480 #, no-wrap
18481 msgid ""
18482 " struct guestfs_version *\n"
18483 " guestfs_version (guestfs_h *g);\n"
18484 "\n"
18485 msgstr ""
18486
18487 # type: textblock
18488 #. type: textblock
18489 #: ../src/guestfs-actions.pod:6605 ../fish/guestfish-actions.pod:4408
18490 msgid ""
18491 "Return the libguestfs version number that the program is linked against."
18492 msgstr ""
18493
18494 # type: textblock
18495 #. type: textblock
18496 #: ../src/guestfs-actions.pod:6608 ../fish/guestfish-actions.pod:4411
18497 msgid ""
18498 "Note that because of dynamic linking this is not necessarily the version of "
18499 "libguestfs that you compiled against.  You can compile the program, and then "
18500 "at runtime dynamically link against a completely different C<libguestfs.so> "
18501 "library."
18502 msgstr ""
18503
18504 # type: textblock
18505 #. type: textblock
18506 #: ../src/guestfs-actions.pod:6613 ../fish/guestfish-actions.pod:4416
18507 msgid ""
18508 "This call was added in version C<1.0.58>.  In previous versions of "
18509 "libguestfs there was no way to get the version number.  From C code you can "
18510 "use dynamic linker functions to find out if this symbol exists (if it "
18511 "doesn't, then it's an earlier version)."
18512 msgstr ""
18513
18514 # type: textblock
18515 #. type: textblock
18516 #: ../src/guestfs-actions.pod:6619 ../fish/guestfish-actions.pod:4422
18517 msgid ""
18518 "The call returns a structure with four elements.  The first three (C<major>, "
18519 "C<minor> and C<release>) are numbers and correspond to the usual version "
18520 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
18521 "but may be used for distro-specific information."
18522 msgstr ""
18523
18524 # type: textblock
18525 #. type: textblock
18526 #: ../src/guestfs-actions.pod:6625 ../fish/guestfish-actions.pod:4428
18527 msgid ""
18528 "To construct the original version string: C<$major.$minor.$release$extra>"
18529 msgstr ""
18530
18531 # type: textblock
18532 #. type: textblock
18533 #: ../src/guestfs-actions.pod:6628 ../fish/guestfish-actions.pod:4431
18534 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
18535 msgstr ""
18536
18537 # type: textblock
18538 #. type: textblock
18539 #: ../src/guestfs-actions.pod:6630
18540 msgid ""
18541 "I<Note:> Don't use this call to test for availability of features.  In "
18542 "enterprise distributions we backport features from later versions into "
18543 "earlier versions, making this an unreliable way to test for features.  Use "
18544 "C<guestfs_available> instead."
18545 msgstr ""
18546
18547 # type: textblock
18548 #. type: textblock
18549 #: ../src/guestfs-actions.pod:6636
18550 msgid ""
18551 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
18552 "error.  I<The caller must call C<guestfs_free_version> after use>."
18553 msgstr ""
18554
18555 # type: textblock
18556 #. type: textblock
18557 #: ../src/guestfs-actions.pod:6640
18558 msgid "(Added in 1.0.58)"
18559 msgstr ""
18560
18561 # type: =head2
18562 #. type: =head2
18563 #: ../src/guestfs-actions.pod:6642
18564 msgid "guestfs_vfs_label"
18565 msgstr ""
18566
18567 # type: verbatim
18568 #. type: verbatim
18569 #: ../src/guestfs-actions.pod:6644
18570 #, no-wrap
18571 msgid ""
18572 " char *\n"
18573 " guestfs_vfs_label (guestfs_h *g,\n"
18574 "                    const char *device);\n"
18575 "\n"
18576 msgstr ""
18577
18578 # type: textblock
18579 #. type: textblock
18580 #: ../src/guestfs-actions.pod:6648 ../fish/guestfish-actions.pod:4443
18581 msgid "This returns the filesystem label of the filesystem on C<device>."
18582 msgstr ""
18583
18584 # type: textblock
18585 #. type: textblock
18586 #: ../src/guestfs-actions.pod:6651 ../fish/guestfish-actions.pod:4446
18587 msgid "If the filesystem is unlabeled, this returns the empty string."
18588 msgstr ""
18589
18590 # type: textblock
18591 #. type: textblock
18592 #: ../src/guestfs-actions.pod:6653
18593 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
18594 msgstr ""
18595
18596 # type: textblock
18597 #. type: textblock
18598 #: ../src/guestfs-actions.pod:6658 ../src/guestfs-actions.pod:6695
18599 msgid "(Added in 1.3.18)"
18600 msgstr ""
18601
18602 # type: =head2
18603 #. type: =head2
18604 #: ../src/guestfs-actions.pod:6660
18605 msgid "guestfs_vfs_type"
18606 msgstr ""
18607
18608 # type: verbatim
18609 #. type: verbatim
18610 #: ../src/guestfs-actions.pod:6662
18611 #, no-wrap
18612 msgid ""
18613 " char *\n"
18614 " guestfs_vfs_type (guestfs_h *g,\n"
18615 "                   const char *device);\n"
18616 "\n"
18617 msgstr ""
18618
18619 # type: textblock
18620 #. type: textblock
18621 #: ../src/guestfs-actions.pod:6666 ../fish/guestfish-actions.pod:4454
18622 msgid ""
18623 "This command gets the filesystem type corresponding to the filesystem on "
18624 "C<device>."
18625 msgstr ""
18626
18627 # type: textblock
18628 #. type: textblock
18629 #: ../src/guestfs-actions.pod:6669 ../fish/guestfish-actions.pod:4457
18630 msgid ""
18631 "For most filesystems, the result is the name of the Linux VFS module which "
18632 "would be used to mount this filesystem if you mounted it without specifying "
18633 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
18634 msgstr ""
18635
18636 # type: =head2
18637 #. type: =head2
18638 #: ../src/guestfs-actions.pod:6679
18639 msgid "guestfs_vfs_uuid"
18640 msgstr ""
18641
18642 # type: verbatim
18643 #. type: verbatim
18644 #: ../src/guestfs-actions.pod:6681
18645 #, no-wrap
18646 msgid ""
18647 " char *\n"
18648 " guestfs_vfs_uuid (guestfs_h *g,\n"
18649 "                   const char *device);\n"
18650 "\n"
18651 msgstr ""
18652
18653 # type: textblock
18654 #. type: textblock
18655 #: ../src/guestfs-actions.pod:6685 ../fish/guestfish-actions.pod:4466
18656 msgid "This returns the filesystem UUID of the filesystem on C<device>."
18657 msgstr ""
18658
18659 # type: textblock
18660 #. type: textblock
18661 #: ../src/guestfs-actions.pod:6688 ../fish/guestfish-actions.pod:4469
18662 msgid "If the filesystem does not have a UUID, this returns the empty string."
18663 msgstr ""
18664
18665 # type: textblock
18666 #. type: textblock
18667 #: ../src/guestfs-actions.pod:6690
18668 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
18669 msgstr ""
18670
18671 # type: =head2
18672 #. type: =head2
18673 #: ../src/guestfs-actions.pod:6697
18674 msgid "guestfs_vg_activate"
18675 msgstr ""
18676
18677 # type: verbatim
18678 #. type: verbatim
18679 #: ../src/guestfs-actions.pod:6699
18680 #, no-wrap
18681 msgid ""
18682 " int\n"
18683 " guestfs_vg_activate (guestfs_h *g,\n"
18684 "                      int activate,\n"
18685 "                      char *const *volgroups);\n"
18686 "\n"
18687 msgstr ""
18688
18689 # type: textblock
18690 #. type: textblock
18691 #: ../src/guestfs-actions.pod:6704 ../fish/guestfish-actions.pod:4477
18692 msgid ""
18693 "This command activates or (if C<activate> is false) deactivates all logical "
18694 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
18695 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
18696 "deactivated, then those devices disappear."
18697 msgstr ""
18698
18699 # type: textblock
18700 #. type: textblock
18701 #: ../src/guestfs-actions.pod:6710 ../fish/guestfish-actions.pod:4483
18702 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
18703 msgstr ""
18704
18705 # type: textblock
18706 #. type: textblock
18707 #: ../src/guestfs-actions.pod:6712 ../fish/guestfish-actions.pod:4485
18708 msgid ""
18709 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
18710 "activated or deactivated."
18711 msgstr ""
18712
18713 # type: =head2
18714 #. type: =head2
18715 #: ../src/guestfs-actions.pod:6719
18716 msgid "guestfs_vg_activate_all"
18717 msgstr ""
18718
18719 # type: verbatim
18720 #. type: verbatim
18721 #: ../src/guestfs-actions.pod:6721
18722 #, no-wrap
18723 msgid ""
18724 " int\n"
18725 " guestfs_vg_activate_all (guestfs_h *g,\n"
18726 "                          int activate);\n"
18727 "\n"
18728 msgstr ""
18729
18730 # type: textblock
18731 #. type: textblock
18732 #: ../src/guestfs-actions.pod:6725 ../fish/guestfish-actions.pod:4492
18733 msgid ""
18734 "This command activates or (if C<activate> is false) deactivates all logical "
18735 "volumes in all volume groups.  If activated, then they are made known to the "
18736 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
18737 "those devices disappear."
18738 msgstr ""
18739
18740 # type: textblock
18741 #. type: textblock
18742 #: ../src/guestfs-actions.pod:6731 ../fish/guestfish-actions.pod:4498
18743 msgid "This command is the same as running C<vgchange -a y|n>"
18744 msgstr ""
18745
18746 # type: =head2
18747 #. type: =head2
18748 #: ../src/guestfs-actions.pod:6737
18749 msgid "guestfs_vgcreate"
18750 msgstr ""
18751
18752 # type: verbatim
18753 #. type: verbatim
18754 #: ../src/guestfs-actions.pod:6739
18755 #, no-wrap
18756 msgid ""
18757 " int\n"
18758 " guestfs_vgcreate (guestfs_h *g,\n"
18759 "                   const char *volgroup,\n"
18760 "                   char *const *physvols);\n"
18761 "\n"
18762 msgstr ""
18763
18764 # type: textblock
18765 #. type: textblock
18766 #: ../src/guestfs-actions.pod:6744 ../fish/guestfish-actions.pod:4504
18767 msgid ""
18768 "This creates an LVM volume group called C<volgroup> from the non-empty list "
18769 "of physical volumes C<physvols>."
18770 msgstr ""
18771
18772 # type: =head2
18773 #. type: =head2
18774 #: ../src/guestfs-actions.pod:6751
18775 msgid "guestfs_vglvuuids"
18776 msgstr ""
18777
18778 # type: verbatim
18779 #. type: verbatim
18780 #: ../src/guestfs-actions.pod:6753
18781 #, no-wrap
18782 msgid ""
18783 " char **\n"
18784 " guestfs_vglvuuids (guestfs_h *g,\n"
18785 "                    const char *vgname);\n"
18786 "\n"
18787 msgstr ""
18788
18789 # type: textblock
18790 #. type: textblock
18791 #: ../src/guestfs-actions.pod:6757 ../fish/guestfish-actions.pod:4511
18792 msgid ""
18793 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
18794 "volumes created in this volume group."
18795 msgstr ""
18796
18797 # type: textblock
18798 #. type: textblock
18799 #: ../src/guestfs-actions.pod:6760
18800 msgid ""
18801 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
18802 "associate logical volumes and volume groups."
18803 msgstr ""
18804
18805 # type: textblock
18806 #. type: textblock
18807 #: ../src/guestfs-actions.pod:6763
18808 msgid "See also C<guestfs_vgpvuuids>."
18809 msgstr ""
18810
18811 # type: =head2
18812 #. type: =head2
18813 #: ../src/guestfs-actions.pod:6771
18814 msgid "guestfs_vgpvuuids"
18815 msgstr ""
18816
18817 # type: verbatim
18818 #. type: verbatim
18819 #: ../src/guestfs-actions.pod:6773
18820 #, no-wrap
18821 msgid ""
18822 " char **\n"
18823 " guestfs_vgpvuuids (guestfs_h *g,\n"
18824 "                    const char *vgname);\n"
18825 "\n"
18826 msgstr ""
18827
18828 # type: textblock
18829 #. type: textblock
18830 #: ../src/guestfs-actions.pod:6777 ../fish/guestfish-actions.pod:4523
18831 msgid ""
18832 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
18833 "volumes that this volume group resides on."
18834 msgstr ""
18835
18836 # type: textblock
18837 #. type: textblock
18838 #: ../src/guestfs-actions.pod:6780
18839 msgid ""
18840 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
18841 "associate physical volumes and volume groups."
18842 msgstr ""
18843
18844 # type: textblock
18845 #. type: textblock
18846 #: ../src/guestfs-actions.pod:6783
18847 msgid "See also C<guestfs_vglvuuids>."
18848 msgstr ""
18849
18850 # type: =head2
18851 #. type: =head2
18852 #: ../src/guestfs-actions.pod:6791
18853 msgid "guestfs_vgremove"
18854 msgstr ""
18855
18856 # type: verbatim
18857 #. type: verbatim
18858 #: ../src/guestfs-actions.pod:6793
18859 #, no-wrap
18860 msgid ""
18861 " int\n"
18862 " guestfs_vgremove (guestfs_h *g,\n"
18863 "                   const char *vgname);\n"
18864 "\n"
18865 msgstr ""
18866
18867 # type: textblock
18868 #. type: textblock
18869 #: ../src/guestfs-actions.pod:6797 ../fish/guestfish-actions.pod:4535
18870 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
18871 msgstr ""
18872
18873 # type: textblock
18874 #. type: textblock
18875 #: ../src/guestfs-actions.pod:6799 ../fish/guestfish-actions.pod:4537
18876 msgid ""
18877 "This also forcibly removes all logical volumes in the volume group (if any)."
18878 msgstr ""
18879
18880 # type: =head2
18881 #. type: =head2
18882 #: ../src/guestfs-actions.pod:6806
18883 msgid "guestfs_vgrename"
18884 msgstr ""
18885
18886 # type: verbatim
18887 #. type: verbatim
18888 #: ../src/guestfs-actions.pod:6808
18889 #, no-wrap
18890 msgid ""
18891 " int\n"
18892 " guestfs_vgrename (guestfs_h *g,\n"
18893 "                   const char *volgroup,\n"
18894 "                   const char *newvolgroup);\n"
18895 "\n"
18896 msgstr ""
18897
18898 # type: textblock
18899 #. type: textblock
18900 #: ../src/guestfs-actions.pod:6813 ../fish/guestfish-actions.pod:4544
18901 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
18902 msgstr ""
18903
18904 # type: =head2
18905 #. type: =head2
18906 #: ../src/guestfs-actions.pod:6819
18907 msgid "guestfs_vgs"
18908 msgstr ""
18909
18910 # type: verbatim
18911 #. type: verbatim
18912 #: ../src/guestfs-actions.pod:6821
18913 #, no-wrap
18914 msgid ""
18915 " char **\n"
18916 " guestfs_vgs (guestfs_h *g);\n"
18917 "\n"
18918 msgstr ""
18919
18920 # type: textblock
18921 #. type: textblock
18922 #: ../src/guestfs-actions.pod:6824 ../fish/guestfish-actions.pod:4550
18923 msgid ""
18924 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18925 "> command."
18926 msgstr ""
18927
18928 # type: textblock
18929 #. type: textblock
18930 #: ../src/guestfs-actions.pod:6827 ../fish/guestfish-actions.pod:4553
18931 msgid ""
18932 "This returns a list of just the volume group names that were detected (eg. "
18933 "C<VolGroup00>)."
18934 msgstr ""
18935
18936 # type: textblock
18937 #. type: textblock
18938 #: ../src/guestfs-actions.pod:6830
18939 msgid "See also C<guestfs_vgs_full>."
18940 msgstr ""
18941
18942 # type: =head2
18943 #. type: =head2
18944 #: ../src/guestfs-actions.pod:6838
18945 msgid "guestfs_vgs_full"
18946 msgstr ""
18947
18948 # type: verbatim
18949 #. type: verbatim
18950 #: ../src/guestfs-actions.pod:6840
18951 #, no-wrap
18952 msgid ""
18953 " struct guestfs_lvm_vg_list *\n"
18954 " guestfs_vgs_full (guestfs_h *g);\n"
18955 "\n"
18956 msgstr ""
18957
18958 # type: textblock
18959 #. type: textblock
18960 #: ../src/guestfs-actions.pod:6843 ../fish/guestfish-actions.pod:4562
18961 msgid ""
18962 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18963 "> command.  The \"full\" version includes all fields."
18964 msgstr ""
18965
18966 # type: textblock
18967 #. type: textblock
18968 #: ../src/guestfs-actions.pod:6846
18969 msgid ""
18970 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
18971 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
18972 msgstr ""
18973
18974 # type: =head2
18975 #. type: =head2
18976 #: ../src/guestfs-actions.pod:6852
18977 msgid "guestfs_vgscan"
18978 msgstr ""
18979
18980 # type: verbatim
18981 #. type: verbatim
18982 #: ../src/guestfs-actions.pod:6854
18983 #, no-wrap
18984 msgid ""
18985 " int\n"
18986 " guestfs_vgscan (guestfs_h *g);\n"
18987 "\n"
18988 msgstr ""
18989
18990 # type: textblock
18991 #. type: textblock
18992 #: ../src/guestfs-actions.pod:6857 ../fish/guestfish-actions.pod:4569
18993 msgid ""
18994 "This rescans all block devices and rebuilds the list of LVM physical "
18995 "volumes, volume groups and logical volumes."
18996 msgstr ""
18997
18998 # type: =head2
18999 #. type: =head2
19000 #: ../src/guestfs-actions.pod:6864
19001 msgid "guestfs_vguuid"
19002 msgstr ""
19003
19004 # type: verbatim
19005 #. type: verbatim
19006 #: ../src/guestfs-actions.pod:6866
19007 #, no-wrap
19008 msgid ""
19009 " char *\n"
19010 " guestfs_vguuid (guestfs_h *g,\n"
19011 "                 const char *vgname);\n"
19012 "\n"
19013 msgstr ""
19014
19015 # type: textblock
19016 #. type: textblock
19017 #: ../src/guestfs-actions.pod:6870 ../fish/guestfish-actions.pod:4576
19018 msgid "This command returns the UUID of the LVM VG named C<vgname>."
19019 msgstr ""
19020
19021 # type: =head2
19022 #. type: =head2
19023 #: ../src/guestfs-actions.pod:6877
19024 msgid "guestfs_wait_ready"
19025 msgstr ""
19026
19027 # type: verbatim
19028 #. type: verbatim
19029 #: ../src/guestfs-actions.pod:6879
19030 #, no-wrap
19031 msgid ""
19032 " int\n"
19033 " guestfs_wait_ready (guestfs_h *g);\n"
19034 "\n"
19035 msgstr ""
19036
19037 # type: textblock
19038 #. type: textblock
19039 #: ../src/guestfs-actions.pod:6882
19040 msgid "This function is a no op."
19041 msgstr ""
19042
19043 # type: textblock
19044 #. type: textblock
19045 #: ../src/guestfs-actions.pod:6884
19046 msgid ""
19047 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
19048 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
19049 "is no longer necessary because C<guestfs_launch> now does the waiting."
19050 msgstr ""
19051
19052 # type: textblock
19053 #. type: textblock
19054 #: ../src/guestfs-actions.pod:6889
19055 msgid ""
19056 "If you see any calls to this function in code then you can just remove them, "
19057 "unless you want to retain compatibility with older versions of the API."
19058 msgstr ""
19059
19060 # type: =head2
19061 #. type: =head2
19062 #: ../src/guestfs-actions.pod:6897
19063 msgid "guestfs_wc_c"
19064 msgstr ""
19065
19066 # type: verbatim
19067 #. type: verbatim
19068 #: ../src/guestfs-actions.pod:6899
19069 #, no-wrap
19070 msgid ""
19071 " int\n"
19072 " guestfs_wc_c (guestfs_h *g,\n"
19073 "               const char *path);\n"
19074 "\n"
19075 msgstr ""
19076
19077 # type: textblock
19078 #. type: textblock
19079 #: ../src/guestfs-actions.pod:6903 ../fish/guestfish-actions.pod:4582
19080 msgid ""
19081 "This command counts the characters in a file, using the C<wc -c> external "
19082 "command."
19083 msgstr ""
19084
19085 # type: =head2
19086 #. type: =head2
19087 #: ../src/guestfs-actions.pod:6910
19088 msgid "guestfs_wc_l"
19089 msgstr ""
19090
19091 # type: verbatim
19092 #. type: verbatim
19093 #: ../src/guestfs-actions.pod:6912
19094 #, no-wrap
19095 msgid ""
19096 " int\n"
19097 " guestfs_wc_l (guestfs_h *g,\n"
19098 "               const char *path);\n"
19099 "\n"
19100 msgstr ""
19101
19102 # type: textblock
19103 #. type: textblock
19104 #: ../src/guestfs-actions.pod:6916 ../fish/guestfish-actions.pod:4589
19105 msgid ""
19106 "This command counts the lines in a file, using the C<wc -l> external command."
19107 msgstr ""
19108
19109 # type: =head2
19110 #. type: =head2
19111 #: ../src/guestfs-actions.pod:6923
19112 msgid "guestfs_wc_w"
19113 msgstr ""
19114
19115 # type: verbatim
19116 #. type: verbatim
19117 #: ../src/guestfs-actions.pod:6925
19118 #, no-wrap
19119 msgid ""
19120 " int\n"
19121 " guestfs_wc_w (guestfs_h *g,\n"
19122 "               const char *path);\n"
19123 "\n"
19124 msgstr ""
19125
19126 # type: textblock
19127 #. type: textblock
19128 #: ../src/guestfs-actions.pod:6929 ../fish/guestfish-actions.pod:4596
19129 msgid ""
19130 "This command counts the words in a file, using the C<wc -w> external command."
19131 msgstr ""
19132
19133 # type: =head2
19134 #. type: =head2
19135 #: ../src/guestfs-actions.pod:6936
19136 msgid "guestfs_write"
19137 msgstr ""
19138
19139 # type: verbatim
19140 #. type: verbatim
19141 #: ../src/guestfs-actions.pod:6938
19142 #, no-wrap
19143 msgid ""
19144 " int\n"
19145 " guestfs_write (guestfs_h *g,\n"
19146 "                const char *path,\n"
19147 "                const char *content,\n"
19148 "                size_t content_size);\n"
19149 "\n"
19150 msgstr ""
19151
19152 # type: textblock
19153 #. type: textblock
19154 #: ../src/guestfs-actions.pod:6944 ../fish/guestfish-actions.pod:4603
19155 msgid ""
19156 "This call creates a file called C<path>.  The content of the file is the "
19157 "string C<content> (which can contain any 8 bit data)."
19158 msgstr ""
19159
19160 # type: =head2
19161 #. type: =head2
19162 #: ../src/guestfs-actions.pod:6954
19163 msgid "guestfs_write_file"
19164 msgstr ""
19165
19166 # type: verbatim
19167 #. type: verbatim
19168 #: ../src/guestfs-actions.pod:6956
19169 #, no-wrap
19170 msgid ""
19171 " int\n"
19172 " guestfs_write_file (guestfs_h *g,\n"
19173 "                     const char *path,\n"
19174 "                     const char *content,\n"
19175 "                     int size);\n"
19176 "\n"
19177 msgstr ""
19178
19179 # type: textblock
19180 #. type: textblock
19181 #: ../src/guestfs-actions.pod:6962 ../fish/guestfish-actions.pod:4613
19182 msgid ""
19183 "This call creates a file called C<path>.  The contents of the file is the "
19184 "string C<content> (which can contain any 8 bit data), with length C<size>."
19185 msgstr ""
19186
19187 # type: textblock
19188 #. type: textblock
19189 #: ../src/guestfs-actions.pod:6966 ../fish/guestfish-actions.pod:4617
19190 msgid ""
19191 "As a special case, if C<size> is C<0> then the length is calculated using "
19192 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
19193 msgstr ""
19194
19195 # type: textblock
19196 #. type: textblock
19197 #: ../src/guestfs-actions.pod:6970 ../fish/guestfish-actions.pod:4621
19198 msgid ""
19199 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
19200 "I<not> work, even if the length is specified."
19201 msgstr ""
19202
19203 #. type: textblock
19204 #: ../src/guestfs-actions.pod:6978
19205 msgid ""
19206 "This function is deprecated.  In new code, use the L</guestfs_write> call "
19207 "instead."
19208 msgstr ""
19209
19210 # type: =head2
19211 #. type: =head2
19212 #: ../src/guestfs-actions.pod:6987
19213 msgid "guestfs_zegrep"
19214 msgstr ""
19215
19216 # type: verbatim
19217 #. type: verbatim
19218 #: ../src/guestfs-actions.pod:6989
19219 #, no-wrap
19220 msgid ""
19221 " char **\n"
19222 " guestfs_zegrep (guestfs_h *g,\n"
19223 "                 const char *regex,\n"
19224 "                 const char *path);\n"
19225 "\n"
19226 msgstr ""
19227
19228 # type: textblock
19229 #. type: textblock
19230 #: ../src/guestfs-actions.pod:6994 ../fish/guestfish-actions.pod:4638
19231 msgid ""
19232 "This calls the external C<zegrep> program and returns the matching lines."
19233 msgstr ""
19234
19235 # type: =head2
19236 #. type: =head2
19237 #: ../src/guestfs-actions.pod:7006
19238 msgid "guestfs_zegrepi"
19239 msgstr ""
19240
19241 # type: verbatim
19242 #. type: verbatim
19243 #: ../src/guestfs-actions.pod:7008
19244 #, no-wrap
19245 msgid ""
19246 " char **\n"
19247 " guestfs_zegrepi (guestfs_h *g,\n"
19248 "                  const char *regex,\n"
19249 "                  const char *path);\n"
19250 "\n"
19251 msgstr ""
19252
19253 # type: textblock
19254 #. type: textblock
19255 #: ../src/guestfs-actions.pod:7013 ../fish/guestfish-actions.pod:4648
19256 msgid ""
19257 "This calls the external C<zegrep -i> program and returns the matching lines."
19258 msgstr ""
19259
19260 # type: =head2
19261 #. type: =head2
19262 #: ../src/guestfs-actions.pod:7025
19263 msgid "guestfs_zero"
19264 msgstr ""
19265
19266 # type: verbatim
19267 #. type: verbatim
19268 #: ../src/guestfs-actions.pod:7027
19269 #, no-wrap
19270 msgid ""
19271 " int\n"
19272 " guestfs_zero (guestfs_h *g,\n"
19273 "               const char *device);\n"
19274 "\n"
19275 msgstr ""
19276
19277 # type: textblock
19278 #. type: textblock
19279 #: ../src/guestfs-actions.pod:7031 ../fish/guestfish-actions.pod:4658
19280 msgid "This command writes zeroes over the first few blocks of C<device>."
19281 msgstr ""
19282
19283 # type: textblock
19284 #. type: textblock
19285 #: ../src/guestfs-actions.pod:7033 ../fish/guestfish-actions.pod:4660
19286 msgid ""
19287 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
19288 "securely wipe the device).  It should be sufficient to remove any partition "
19289 "tables, filesystem superblocks and so on."
19290 msgstr ""
19291
19292 # type: textblock
19293 #. type: textblock
19294 #: ../src/guestfs-actions.pod:7037
19295 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
19296 msgstr ""
19297
19298 # type: =head2
19299 #. type: =head2
19300 #: ../src/guestfs-actions.pod:7048
19301 msgid "guestfs_zero_device"
19302 msgstr ""
19303
19304 # type: verbatim
19305 #. type: verbatim
19306 #: ../src/guestfs-actions.pod:7050
19307 #, no-wrap
19308 msgid ""
19309 " int\n"
19310 " guestfs_zero_device (guestfs_h *g,\n"
19311 "                      const char *device);\n"
19312 "\n"
19313 msgstr ""
19314
19315 # type: textblock
19316 #. type: textblock
19317 #: ../src/guestfs-actions.pod:7054
19318 msgid ""
19319 "This command writes zeroes over the entire C<device>.  Compare with "
19320 "C<guestfs_zero> which just zeroes the first few blocks of a device."
19321 msgstr ""
19322
19323 # type: textblock
19324 #. type: textblock
19325 #: ../src/guestfs-actions.pod:7068
19326 msgid "(Added in 1.3.1)"
19327 msgstr ""
19328
19329 # type: =head2
19330 #. type: =head2
19331 #: ../src/guestfs-actions.pod:7070
19332 msgid "guestfs_zerofree"
19333 msgstr ""
19334
19335 # type: verbatim
19336 #. type: verbatim
19337 #: ../src/guestfs-actions.pod:7072
19338 #, no-wrap
19339 msgid ""
19340 " int\n"
19341 " guestfs_zerofree (guestfs_h *g,\n"
19342 "                   const char *device);\n"
19343 "\n"
19344 msgstr ""
19345
19346 # type: textblock
19347 #. type: textblock
19348 #: ../src/guestfs-actions.pod:7076 ../fish/guestfish-actions.pod:4681
19349 msgid ""
19350 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
19351 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
19352 "possible to compress the filesystem more effectively."
19353 msgstr ""
19354
19355 # type: textblock
19356 #. type: textblock
19357 #: ../src/guestfs-actions.pod:7081 ../fish/guestfish-actions.pod:4686
19358 msgid "You should B<not> run this program if the filesystem is mounted."
19359 msgstr ""
19360
19361 # type: textblock
19362 #. type: textblock
19363 #: ../src/guestfs-actions.pod:7084 ../fish/guestfish-actions.pod:4689
19364 msgid ""
19365 "It is possible that using this program can damage the filesystem or data on "
19366 "the filesystem."
19367 msgstr ""
19368
19369 # type: =head2
19370 #. type: =head2
19371 #: ../src/guestfs-actions.pod:7091
19372 msgid "guestfs_zfgrep"
19373 msgstr ""
19374
19375 # type: verbatim
19376 #. type: verbatim
19377 #: ../src/guestfs-actions.pod:7093
19378 #, no-wrap
19379 msgid ""
19380 " char **\n"
19381 " guestfs_zfgrep (guestfs_h *g,\n"
19382 "                 const char *pattern,\n"
19383 "                 const char *path);\n"
19384 "\n"
19385 msgstr ""
19386
19387 # type: textblock
19388 #. type: textblock
19389 #: ../src/guestfs-actions.pod:7098 ../fish/guestfish-actions.pod:4696
19390 msgid ""
19391 "This calls the external C<zfgrep> program and returns the matching lines."
19392 msgstr ""
19393
19394 # type: =head2
19395 #. type: =head2
19396 #: ../src/guestfs-actions.pod:7110
19397 msgid "guestfs_zfgrepi"
19398 msgstr ""
19399
19400 # type: verbatim
19401 #. type: verbatim
19402 #: ../src/guestfs-actions.pod:7112
19403 #, no-wrap
19404 msgid ""
19405 " char **\n"
19406 " guestfs_zfgrepi (guestfs_h *g,\n"
19407 "                  const char *pattern,\n"
19408 "                  const char *path);\n"
19409 "\n"
19410 msgstr ""
19411
19412 # type: textblock
19413 #. type: textblock
19414 #: ../src/guestfs-actions.pod:7117 ../fish/guestfish-actions.pod:4706
19415 msgid ""
19416 "This calls the external C<zfgrep -i> program and returns the matching lines."
19417 msgstr ""
19418
19419 # type: =head2
19420 #. type: =head2
19421 #: ../src/guestfs-actions.pod:7129
19422 msgid "guestfs_zfile"
19423 msgstr ""
19424
19425 # type: verbatim
19426 #. type: verbatim
19427 #: ../src/guestfs-actions.pod:7131
19428 #, no-wrap
19429 msgid ""
19430 " char *\n"
19431 " guestfs_zfile (guestfs_h *g,\n"
19432 "                const char *meth,\n"
19433 "                const char *path);\n"
19434 "\n"
19435 msgstr ""
19436
19437 # type: textblock
19438 #. type: textblock
19439 #: ../src/guestfs-actions.pod:7136 ../fish/guestfish-actions.pod:4716
19440 msgid ""
19441 "This command runs C<file> after first decompressing C<path> using C<method>."
19442 msgstr ""
19443
19444 # type: textblock
19445 #. type: textblock
19446 #: ../src/guestfs-actions.pod:7139 ../fish/guestfish-actions.pod:4719
19447 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
19448 msgstr ""
19449
19450 # type: textblock
19451 #. type: textblock
19452 #: ../src/guestfs-actions.pod:7141
19453 msgid ""
19454 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
19455 "files."
19456 msgstr ""
19457
19458 #. type: textblock
19459 #: ../src/guestfs-actions.pod:7147
19460 msgid ""
19461 "This function is deprecated.  In new code, use the L</guestfs_file> call "
19462 "instead."
19463 msgstr ""
19464
19465 # type: =head2
19466 #. type: =head2
19467 #: ../src/guestfs-actions.pod:7156
19468 msgid "guestfs_zgrep"
19469 msgstr ""
19470
19471 # type: verbatim
19472 #. type: verbatim
19473 #: ../src/guestfs-actions.pod:7158
19474 #, no-wrap
19475 msgid ""
19476 " char **\n"
19477 " guestfs_zgrep (guestfs_h *g,\n"
19478 "                const char *regex,\n"
19479 "                const char *path);\n"
19480 "\n"
19481 msgstr ""
19482
19483 # type: textblock
19484 #. type: textblock
19485 #: ../src/guestfs-actions.pod:7163 ../fish/guestfish-actions.pod:4735
19486 msgid ""
19487 "This calls the external C<zgrep> program and returns the matching lines."
19488 msgstr ""
19489
19490 # type: =head2
19491 #. type: =head2
19492 #: ../src/guestfs-actions.pod:7175
19493 msgid "guestfs_zgrepi"
19494 msgstr ""
19495
19496 # type: verbatim
19497 #. type: verbatim
19498 #: ../src/guestfs-actions.pod:7177
19499 #, no-wrap
19500 msgid ""
19501 " char **\n"
19502 " guestfs_zgrepi (guestfs_h *g,\n"
19503 "                 const char *regex,\n"
19504 "                 const char *path);\n"
19505 "\n"
19506 msgstr ""
19507
19508 # type: textblock
19509 #. type: textblock
19510 #: ../src/guestfs-actions.pod:7182 ../fish/guestfish-actions.pod:4745
19511 msgid ""
19512 "This calls the external C<zgrep -i> program and returns the matching lines."
19513 msgstr ""
19514
19515 # type: =item
19516 #. type: =item
19517 #: ../src/guestfs-availability.pod:3
19518 msgid "B<augeas>"
19519 msgstr ""
19520
19521 # type: textblock
19522 #. type: textblock
19523 #: ../src/guestfs-availability.pod:5
19524 msgid ""
19525 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
19526 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
19527 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
19528 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
19529 "L</guestfs_aug_save> L</guestfs_aug_set>"
19530 msgstr ""
19531
19532 # type: =item
19533 #. type: =item
19534 #: ../src/guestfs-availability.pod:21
19535 msgid "B<inotify>"
19536 msgstr ""
19537
19538 # type: textblock
19539 #. type: textblock
19540 #: ../src/guestfs-availability.pod:23
19541 msgid ""
19542 "The following functions: L</guestfs_inotify_add_watch> L</"
19543 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
19544 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
19545 msgstr ""
19546
19547 # type: =item
19548 #. type: =item
19549 #: ../src/guestfs-availability.pod:31
19550 msgid "B<linuxfsuuid>"
19551 msgstr ""
19552
19553 # type: textblock
19554 #. type: textblock
19555 #: ../src/guestfs-availability.pod:33
19556 msgid ""
19557 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
19558 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
19559 msgstr ""
19560
19561 # type: =item
19562 #. type: =item
19563 #: ../src/guestfs-availability.pod:40
19564 msgid "B<linuxmodules>"
19565 msgstr ""
19566
19567 # type: textblock
19568 #. type: textblock
19569 #: ../src/guestfs-availability.pod:42
19570 msgid "The following functions: L</guestfs_modprobe>"
19571 msgstr ""
19572
19573 # type: =item
19574 #. type: =item
19575 #: ../src/guestfs-availability.pod:45
19576 msgid "B<linuxxattrs>"
19577 msgstr ""
19578
19579 # type: textblock
19580 #. type: textblock
19581 #: ../src/guestfs-availability.pod:47
19582 msgid ""
19583 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
19584 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
19585 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
19586 "guestfs_setxattr>"
19587 msgstr ""
19588
19589 # type: =item
19590 #. type: =item
19591 #: ../src/guestfs-availability.pod:58
19592 msgid "B<luks>"
19593 msgstr ""
19594
19595 # type: textblock
19596 #. type: textblock
19597 #: ../src/guestfs-availability.pod:60
19598 msgid ""
19599 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
19600 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
19601 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
19602 msgstr ""
19603
19604 # type: =item
19605 #. type: =item
19606 #: ../src/guestfs-availability.pod:69
19607 msgid "B<lvm2>"
19608 msgstr ""
19609
19610 # type: textblock
19611 #. type: textblock
19612 #: ../src/guestfs-availability.pod:71
19613 msgid ""
19614 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
19615 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
19616 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
19617 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
19618 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
19619 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
19620 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
19621 msgstr ""
19622
19623 # type: =item
19624 #. type: =item
19625 #: ../src/guestfs-availability.pod:94
19626 msgid "B<mknod>"
19627 msgstr ""
19628
19629 # type: textblock
19630 #. type: textblock
19631 #: ../src/guestfs-availability.pod:96
19632 msgid ""
19633 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
19634 "guestfs_mknod_b> L</guestfs_mknod_c>"
19635 msgstr ""
19636
19637 # type: =item
19638 #. type: =item
19639 #: ../src/guestfs-availability.pod:102
19640 msgid "B<ntfs3g>"
19641 msgstr ""
19642
19643 # type: textblock
19644 #. type: textblock
19645 #: ../src/guestfs-availability.pod:104
19646 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
19647 msgstr ""
19648
19649 # type: =item
19650 #. type: =item
19651 #: ../src/guestfs-availability.pod:107
19652 msgid "B<ntfsprogs>"
19653 msgstr ""
19654
19655 # type: textblock
19656 #. type: textblock
19657 #: ../src/guestfs-availability.pod:109
19658 msgid ""
19659 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
19660 msgstr ""
19661
19662 # type: =item
19663 #. type: =item
19664 #: ../src/guestfs-availability.pod:113
19665 msgid "B<realpath>"
19666 msgstr ""
19667
19668 # type: textblock
19669 #. type: textblock
19670 #: ../src/guestfs-availability.pod:115
19671 msgid "The following functions: L</guestfs_realpath>"
19672 msgstr ""
19673
19674 # type: =item
19675 #. type: =item
19676 #: ../src/guestfs-availability.pod:118
19677 msgid "B<scrub>"
19678 msgstr ""
19679
19680 # type: textblock
19681 #. type: textblock
19682 #: ../src/guestfs-availability.pod:120
19683 msgid ""
19684 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
19685 "guestfs_scrub_freespace>"
19686 msgstr ""
19687
19688 # type: =item
19689 #. type: =item
19690 #: ../src/guestfs-availability.pod:125
19691 msgid "B<selinux>"
19692 msgstr ""
19693
19694 # type: textblock
19695 #. type: textblock
19696 #: ../src/guestfs-availability.pod:127
19697 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
19698 msgstr ""
19699
19700 # type: =item
19701 #. type: =item
19702 #: ../src/guestfs-availability.pod:131
19703 msgid "B<xz>"
19704 msgstr ""
19705
19706 # type: textblock
19707 #. type: textblock
19708 #: ../src/guestfs-availability.pod:133
19709 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
19710 msgstr ""
19711
19712 # type: =item
19713 #. type: =item
19714 #: ../src/guestfs-availability.pod:137
19715 msgid "B<zerofree>"
19716 msgstr ""
19717
19718 # type: textblock
19719 #. type: textblock
19720 #: ../src/guestfs-availability.pod:139
19721 msgid "The following functions: L</guestfs_zerofree>"
19722 msgstr ""
19723
19724 # type: =head2
19725 #. type: =head2
19726 #: ../src/guestfs-structs.pod:1
19727 msgid "guestfs_int_bool"
19728 msgstr ""
19729
19730 # type: verbatim
19731 #. type: verbatim
19732 #: ../src/guestfs-structs.pod:3
19733 #, no-wrap
19734 msgid ""
19735 " struct guestfs_int_bool {\n"
19736 "   int32_t i;\n"
19737 "   int32_t b;\n"
19738 " };\n"
19739 " \n"
19740 msgstr ""
19741
19742 # type: verbatim
19743 #. type: verbatim
19744 #: ../src/guestfs-structs.pod:8
19745 #, no-wrap
19746 msgid ""
19747 " struct guestfs_int_bool_list {\n"
19748 "   uint32_t len; /* Number of elements in list. */\n"
19749 "   struct guestfs_int_bool *val; /* Elements. */\n"
19750 " };\n"
19751 " \n"
19752 msgstr ""
19753
19754 # type: verbatim
19755 #. type: verbatim
19756 #: ../src/guestfs-structs.pod:13
19757 #, no-wrap
19758 msgid ""
19759 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
19760 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
19761 "\n"
19762 msgstr ""
19763
19764 # type: =head2
19765 #. type: =head2
19766 #: ../src/guestfs-structs.pod:16
19767 msgid "guestfs_lvm_pv"
19768 msgstr ""
19769
19770 # type: verbatim
19771 #. type: verbatim
19772 #: ../src/guestfs-structs.pod:18
19773 #, no-wrap
19774 msgid ""
19775 " struct guestfs_lvm_pv {\n"
19776 "   char *pv_name;\n"
19777 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
19778 "   char pv_uuid[32];\n"
19779 "   char *pv_fmt;\n"
19780 "   uint64_t pv_size;\n"
19781 "   uint64_t dev_size;\n"
19782 "   uint64_t pv_free;\n"
19783 "   uint64_t pv_used;\n"
19784 "   char *pv_attr;\n"
19785 "   int64_t pv_pe_count;\n"
19786 "   int64_t pv_pe_alloc_count;\n"
19787 "   char *pv_tags;\n"
19788 "   uint64_t pe_start;\n"
19789 "   int64_t pv_mda_count;\n"
19790 "   uint64_t pv_mda_free;\n"
19791 " };\n"
19792 " \n"
19793 msgstr ""
19794
19795 # type: verbatim
19796 #. type: verbatim
19797 #: ../src/guestfs-structs.pod:36
19798 #, no-wrap
19799 msgid ""
19800 " struct guestfs_lvm_pv_list {\n"
19801 "   uint32_t len; /* Number of elements in list. */\n"
19802 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
19803 " };\n"
19804 " \n"
19805 msgstr ""
19806
19807 # type: verbatim
19808 #. type: verbatim
19809 #: ../src/guestfs-structs.pod:41
19810 #, no-wrap
19811 msgid ""
19812 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
19813 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
19814 "\n"
19815 msgstr ""
19816
19817 # type: =head2
19818 #. type: =head2
19819 #: ../src/guestfs-structs.pod:44
19820 msgid "guestfs_lvm_vg"
19821 msgstr ""
19822
19823 # type: verbatim
19824 #. type: verbatim
19825 #: ../src/guestfs-structs.pod:46
19826 #, no-wrap
19827 msgid ""
19828 " struct guestfs_lvm_vg {\n"
19829 "   char *vg_name;\n"
19830 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
19831 "   char vg_uuid[32];\n"
19832 "   char *vg_fmt;\n"
19833 "   char *vg_attr;\n"
19834 "   uint64_t vg_size;\n"
19835 "   uint64_t vg_free;\n"
19836 "   char *vg_sysid;\n"
19837 "   uint64_t vg_extent_size;\n"
19838 "   int64_t vg_extent_count;\n"
19839 "   int64_t vg_free_count;\n"
19840 "   int64_t max_lv;\n"
19841 "   int64_t max_pv;\n"
19842 "   int64_t pv_count;\n"
19843 "   int64_t lv_count;\n"
19844 "   int64_t snap_count;\n"
19845 "   int64_t vg_seqno;\n"
19846 "   char *vg_tags;\n"
19847 "   int64_t vg_mda_count;\n"
19848 "   uint64_t vg_mda_free;\n"
19849 " };\n"
19850 " \n"
19851 msgstr ""
19852
19853 # type: verbatim
19854 #. type: verbatim
19855 #: ../src/guestfs-structs.pod:69
19856 #, no-wrap
19857 msgid ""
19858 " struct guestfs_lvm_vg_list {\n"
19859 "   uint32_t len; /* Number of elements in list. */\n"
19860 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
19861 " };\n"
19862 " \n"
19863 msgstr ""
19864
19865 # type: verbatim
19866 #. type: verbatim
19867 #: ../src/guestfs-structs.pod:74
19868 #, no-wrap
19869 msgid ""
19870 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
19871 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
19872 "\n"
19873 msgstr ""
19874
19875 # type: =head2
19876 #. type: =head2
19877 #: ../src/guestfs-structs.pod:77
19878 msgid "guestfs_lvm_lv"
19879 msgstr ""
19880
19881 # type: verbatim
19882 #. type: verbatim
19883 #: ../src/guestfs-structs.pod:79
19884 #, no-wrap
19885 msgid ""
19886 " struct guestfs_lvm_lv {\n"
19887 "   char *lv_name;\n"
19888 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
19889 "   char lv_uuid[32];\n"
19890 "   char *lv_attr;\n"
19891 "   int64_t lv_major;\n"
19892 "   int64_t lv_minor;\n"
19893 "   int64_t lv_kernel_major;\n"
19894 "   int64_t lv_kernel_minor;\n"
19895 "   uint64_t lv_size;\n"
19896 "   int64_t seg_count;\n"
19897 "   char *origin;\n"
19898 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
19899 "   float snap_percent;\n"
19900 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
19901 "   float copy_percent;\n"
19902 "   char *move_pv;\n"
19903 "   char *lv_tags;\n"
19904 "   char *mirror_log;\n"
19905 "   char *modules;\n"
19906 " };\n"
19907 " \n"
19908 msgstr ""
19909
19910 # type: verbatim
19911 #. type: verbatim
19912 #: ../src/guestfs-structs.pod:101
19913 #, no-wrap
19914 msgid ""
19915 " struct guestfs_lvm_lv_list {\n"
19916 "   uint32_t len; /* Number of elements in list. */\n"
19917 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
19918 " };\n"
19919 " \n"
19920 msgstr ""
19921
19922 # type: verbatim
19923 #. type: verbatim
19924 #: ../src/guestfs-structs.pod:106
19925 #, no-wrap
19926 msgid ""
19927 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
19928 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
19929 "\n"
19930 msgstr ""
19931
19932 # type: verbatim
19933 #. type: verbatim
19934 #: ../src/guestfs-structs.pod:111
19935 #, no-wrap
19936 msgid ""
19937 " struct guestfs_stat {\n"
19938 "   int64_t dev;\n"
19939 "   int64_t ino;\n"
19940 "   int64_t mode;\n"
19941 "   int64_t nlink;\n"
19942 "   int64_t uid;\n"
19943 "   int64_t gid;\n"
19944 "   int64_t rdev;\n"
19945 "   int64_t size;\n"
19946 "   int64_t blksize;\n"
19947 "   int64_t blocks;\n"
19948 "   int64_t atime;\n"
19949 "   int64_t mtime;\n"
19950 "   int64_t ctime;\n"
19951 " };\n"
19952 " \n"
19953 msgstr ""
19954
19955 # type: verbatim
19956 #. type: verbatim
19957 #: ../src/guestfs-structs.pod:127
19958 #, no-wrap
19959 msgid ""
19960 " struct guestfs_stat_list {\n"
19961 "   uint32_t len; /* Number of elements in list. */\n"
19962 "   struct guestfs_stat *val; /* Elements. */\n"
19963 " };\n"
19964 " \n"
19965 msgstr ""
19966
19967 # type: verbatim
19968 #. type: verbatim
19969 #: ../src/guestfs-structs.pod:132
19970 #, no-wrap
19971 msgid ""
19972 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
19973 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
19974 "\n"
19975 msgstr ""
19976
19977 # type: verbatim
19978 #. type: verbatim
19979 #: ../src/guestfs-structs.pod:137
19980 #, no-wrap
19981 msgid ""
19982 " struct guestfs_statvfs {\n"
19983 "   int64_t bsize;\n"
19984 "   int64_t frsize;\n"
19985 "   int64_t blocks;\n"
19986 "   int64_t bfree;\n"
19987 "   int64_t bavail;\n"
19988 "   int64_t files;\n"
19989 "   int64_t ffree;\n"
19990 "   int64_t favail;\n"
19991 "   int64_t fsid;\n"
19992 "   int64_t flag;\n"
19993 "   int64_t namemax;\n"
19994 " };\n"
19995 " \n"
19996 msgstr ""
19997
19998 # type: verbatim
19999 #. type: verbatim
20000 #: ../src/guestfs-structs.pod:151
20001 #, no-wrap
20002 msgid ""
20003 " struct guestfs_statvfs_list {\n"
20004 "   uint32_t len; /* Number of elements in list. */\n"
20005 "   struct guestfs_statvfs *val; /* Elements. */\n"
20006 " };\n"
20007 " \n"
20008 msgstr ""
20009
20010 # type: verbatim
20011 #. type: verbatim
20012 #: ../src/guestfs-structs.pod:156
20013 #, no-wrap
20014 msgid ""
20015 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
20016 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
20017 "\n"
20018 msgstr ""
20019
20020 # type: =head2
20021 #. type: =head2
20022 #: ../src/guestfs-structs.pod:159
20023 msgid "guestfs_dirent"
20024 msgstr ""
20025
20026 # type: verbatim
20027 #. type: verbatim
20028 #: ../src/guestfs-structs.pod:161
20029 #, no-wrap
20030 msgid ""
20031 " struct guestfs_dirent {\n"
20032 "   int64_t ino;\n"
20033 "   char ftyp;\n"
20034 "   char *name;\n"
20035 " };\n"
20036 " \n"
20037 msgstr ""
20038
20039 # type: verbatim
20040 #. type: verbatim
20041 #: ../src/guestfs-structs.pod:167
20042 #, no-wrap
20043 msgid ""
20044 " struct guestfs_dirent_list {\n"
20045 "   uint32_t len; /* Number of elements in list. */\n"
20046 "   struct guestfs_dirent *val; /* Elements. */\n"
20047 " };\n"
20048 " \n"
20049 msgstr ""
20050
20051 # type: verbatim
20052 #. type: verbatim
20053 #: ../src/guestfs-structs.pod:172
20054 #, no-wrap
20055 msgid ""
20056 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
20057 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
20058 "\n"
20059 msgstr ""
20060
20061 # type: verbatim
20062 #. type: verbatim
20063 #: ../src/guestfs-structs.pod:177
20064 #, no-wrap
20065 msgid ""
20066 " struct guestfs_version {\n"
20067 "   int64_t major;\n"
20068 "   int64_t minor;\n"
20069 "   int64_t release;\n"
20070 "   char *extra;\n"
20071 " };\n"
20072 " \n"
20073 msgstr ""
20074
20075 # type: verbatim
20076 #. type: verbatim
20077 #: ../src/guestfs-structs.pod:184
20078 #, no-wrap
20079 msgid ""
20080 " struct guestfs_version_list {\n"
20081 "   uint32_t len; /* Number of elements in list. */\n"
20082 "   struct guestfs_version *val; /* Elements. */\n"
20083 " };\n"
20084 " \n"
20085 msgstr ""
20086
20087 # type: verbatim
20088 #. type: verbatim
20089 #: ../src/guestfs-structs.pod:189
20090 #, no-wrap
20091 msgid ""
20092 " void guestfs_free_version (struct guestfs_free_version *);\n"
20093 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
20094 "\n"
20095 msgstr ""
20096
20097 # type: =head2
20098 #. type: =head2
20099 #: ../src/guestfs-structs.pod:192
20100 msgid "guestfs_xattr"
20101 msgstr ""
20102
20103 # type: verbatim
20104 #. type: verbatim
20105 #: ../src/guestfs-structs.pod:194
20106 #, no-wrap
20107 msgid ""
20108 " struct guestfs_xattr {\n"
20109 "   char *attrname;\n"
20110 "   /* The next two fields describe a byte array. */\n"
20111 "   uint32_t attrval_len;\n"
20112 "   char *attrval;\n"
20113 " };\n"
20114 " \n"
20115 msgstr ""
20116
20117 # type: verbatim
20118 #. type: verbatim
20119 #: ../src/guestfs-structs.pod:201
20120 #, no-wrap
20121 msgid ""
20122 " struct guestfs_xattr_list {\n"
20123 "   uint32_t len; /* Number of elements in list. */\n"
20124 "   struct guestfs_xattr *val; /* Elements. */\n"
20125 " };\n"
20126 " \n"
20127 msgstr ""
20128
20129 # type: verbatim
20130 #. type: verbatim
20131 #: ../src/guestfs-structs.pod:206
20132 #, no-wrap
20133 msgid ""
20134 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
20135 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
20136 "\n"
20137 msgstr ""
20138
20139 # type: =head2
20140 #. type: =head2
20141 #: ../src/guestfs-structs.pod:209
20142 msgid "guestfs_inotify_event"
20143 msgstr ""
20144
20145 # type: verbatim
20146 #. type: verbatim
20147 #: ../src/guestfs-structs.pod:211
20148 #, no-wrap
20149 msgid ""
20150 " struct guestfs_inotify_event {\n"
20151 "   int64_t in_wd;\n"
20152 "   uint32_t in_mask;\n"
20153 "   uint32_t in_cookie;\n"
20154 "   char *in_name;\n"
20155 " };\n"
20156 " \n"
20157 msgstr ""
20158
20159 # type: verbatim
20160 #. type: verbatim
20161 #: ../src/guestfs-structs.pod:218
20162 #, no-wrap
20163 msgid ""
20164 " struct guestfs_inotify_event_list {\n"
20165 "   uint32_t len; /* Number of elements in list. */\n"
20166 "   struct guestfs_inotify_event *val; /* Elements. */\n"
20167 " };\n"
20168 " \n"
20169 msgstr ""
20170
20171 # type: verbatim
20172 #. type: verbatim
20173 #: ../src/guestfs-structs.pod:223
20174 #, no-wrap
20175 msgid ""
20176 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
20177 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
20178 "\n"
20179 msgstr ""
20180
20181 # type: =head2
20182 #. type: =head2
20183 #: ../src/guestfs-structs.pod:226
20184 msgid "guestfs_partition"
20185 msgstr ""
20186
20187 # type: verbatim
20188 #. type: verbatim
20189 #: ../src/guestfs-structs.pod:228
20190 #, no-wrap
20191 msgid ""
20192 " struct guestfs_partition {\n"
20193 "   int32_t part_num;\n"
20194 "   uint64_t part_start;\n"
20195 "   uint64_t part_end;\n"
20196 "   uint64_t part_size;\n"
20197 " };\n"
20198 " \n"
20199 msgstr ""
20200
20201 # type: verbatim
20202 #. type: verbatim
20203 #: ../src/guestfs-structs.pod:235
20204 #, no-wrap
20205 msgid ""
20206 " struct guestfs_partition_list {\n"
20207 "   uint32_t len; /* Number of elements in list. */\n"
20208 "   struct guestfs_partition *val; /* Elements. */\n"
20209 " };\n"
20210 " \n"
20211 msgstr ""
20212
20213 # type: verbatim
20214 #. type: verbatim
20215 #: ../src/guestfs-structs.pod:240
20216 #, no-wrap
20217 msgid ""
20218 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
20219 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
20220 "\n"
20221 msgstr ""
20222
20223 # type: =head2
20224 #. type: =head2
20225 #: ../src/guestfs-structs.pod:243
20226 msgid "guestfs_application"
20227 msgstr ""
20228
20229 # type: verbatim
20230 #. type: verbatim
20231 #: ../src/guestfs-structs.pod:245
20232 #, no-wrap
20233 msgid ""
20234 " struct guestfs_application {\n"
20235 "   char *app_name;\n"
20236 "   char *app_display_name;\n"
20237 "   int32_t app_epoch;\n"
20238 "   char *app_version;\n"
20239 "   char *app_release;\n"
20240 "   char *app_install_path;\n"
20241 "   char *app_trans_path;\n"
20242 "   char *app_publisher;\n"
20243 "   char *app_url;\n"
20244 "   char *app_source_package;\n"
20245 "   char *app_summary;\n"
20246 "   char *app_description;\n"
20247 " };\n"
20248 " \n"
20249 msgstr ""
20250
20251 # type: verbatim
20252 #. type: verbatim
20253 #: ../src/guestfs-structs.pod:260
20254 #, no-wrap
20255 msgid ""
20256 " struct guestfs_application_list {\n"
20257 "   uint32_t len; /* Number of elements in list. */\n"
20258 "   struct guestfs_application *val; /* Elements. */\n"
20259 " };\n"
20260 " \n"
20261 msgstr ""
20262
20263 # type: verbatim
20264 #. type: verbatim
20265 #: ../src/guestfs-structs.pod:265
20266 #, no-wrap
20267 msgid ""
20268 " void guestfs_free_application (struct guestfs_free_application *);\n"
20269 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
20270 "\n"
20271 msgstr ""
20272
20273 # type: textblock
20274 #. type: textblock
20275 #: ../fish/guestfish.pod:5
20276 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
20277 msgstr ""
20278
20279 # type: verbatim
20280 #. type: verbatim
20281 #: ../fish/guestfish.pod:9
20282 #, no-wrap
20283 msgid ""
20284 " guestfish [--options] [commands]\n"
20285 "\n"
20286 msgstr ""
20287
20288 # type: verbatim
20289 #. type: verbatim
20290 #: ../fish/guestfish.pod:11
20291 #, no-wrap
20292 msgid ""
20293 " guestfish\n"
20294 "\n"
20295 msgstr ""
20296
20297 # type: verbatim
20298 #. type: verbatim
20299 #: ../fish/guestfish.pod:13
20300 #, no-wrap
20301 msgid ""
20302 " guestfish [--ro|--rw] -a disk.img\n"
20303 "\n"
20304 msgstr ""
20305
20306 # type: verbatim
20307 #. type: verbatim
20308 #: ../fish/guestfish.pod:15
20309 #, no-wrap
20310 msgid ""
20311 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
20312 "\n"
20313 msgstr ""
20314
20315 # type: verbatim
20316 #. type: verbatim
20317 #: ../fish/guestfish.pod:17
20318 #, no-wrap
20319 msgid ""
20320 " guestfish -d libvirt-domain\n"
20321 "\n"
20322 msgstr ""
20323
20324 # type: verbatim
20325 #. type: verbatim
20326 #: ../fish/guestfish.pod:19
20327 #, no-wrap
20328 msgid ""
20329 " guestfish [--ro|--rw] -a disk.img -i\n"
20330 "\n"
20331 msgstr ""
20332
20333 # type: verbatim
20334 #. type: verbatim
20335 #: ../fish/guestfish.pod:21
20336 #, no-wrap
20337 msgid ""
20338 " guestfish -d libvirt-domain -i\n"
20339 "\n"
20340 msgstr ""
20341
20342 # type: =head1
20343 #. type: =head1
20344 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
20345 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:59
20346 msgid "WARNING"
20347 msgstr ""
20348
20349 # type: textblock
20350 #. type: textblock
20351 #: ../fish/guestfish.pod:25
20352 msgid ""
20353 "Using guestfish in read/write mode on live virtual machines can be "
20354 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
20355 "option to use guestfish safely if the disk image or virtual machine might be "
20356 "live."
20357 msgstr ""
20358
20359 # type: textblock
20360 #. type: textblock
20361 #: ../fish/guestfish.pod:32
20362 msgid ""
20363 "Guestfish is a shell and command-line tool for examining and modifying "
20364 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
20365 "functionality of the guestfs API, see L<guestfs(3)>."
20366 msgstr ""
20367
20368 # type: textblock
20369 #. type: textblock
20370 #: ../fish/guestfish.pod:36
20371 msgid ""
20372 "Guestfish gives you structured access to the libguestfs API, from shell "
20373 "scripts or the command line or interactively.  If you want to rescue a "
20374 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
20375 "command."
20376 msgstr ""
20377
20378 # type: =head1
20379 #. type: =head1
20380 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:897
20381 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63
20382 #: ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:45
20383 msgid "EXAMPLES"
20384 msgstr ""
20385
20386 # type: =head2
20387 #. type: =head2
20388 #: ../fish/guestfish.pod:43
20389 msgid "As an interactive shell"
20390 msgstr ""
20391
20392 # type: verbatim
20393 #. type: verbatim
20394 #: ../fish/guestfish.pod:45
20395 #, no-wrap
20396 msgid ""
20397 " $ guestfish\n"
20398 " \n"
20399 msgstr ""
20400
20401 # type: verbatim
20402 #. type: verbatim
20403 #: ../fish/guestfish.pod:47
20404 #, no-wrap
20405 msgid ""
20406 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
20407 " editing virtual machine filesystems.\n"
20408 " \n"
20409 msgstr ""
20410
20411 # type: verbatim
20412 #. type: verbatim
20413 #: ../fish/guestfish.pod:50
20414 #, no-wrap
20415 msgid ""
20416 " Type: 'help' for a list of commands\n"
20417 "       'man' to read the manual\n"
20418 "       'quit' to quit the shell\n"
20419 " \n"
20420 msgstr ""
20421
20422 # type: verbatim
20423 #. type: verbatim
20424 #: ../fish/guestfish.pod:54
20425 #, no-wrap
20426 msgid ""
20427 " ><fs> add-ro disk.img\n"
20428 " ><fs> run\n"
20429 " ><fs> list-filesystems\n"
20430 " /dev/sda1: ext4\n"
20431 " /dev/vg_guest/lv_root: ext4\n"
20432 " /dev/vg_guest/lv_swap: swap\n"
20433 " ><fs> mount /dev/vg_guest/lv_root /\n"
20434 " ><fs> cat /etc/fstab\n"
20435 " # /etc/fstab\n"
20436 " # Created by anaconda\n"
20437 " [...]\n"
20438 " ><fs> exit\n"
20439 "\n"
20440 msgstr ""
20441
20442 # type: =head2
20443 #. type: =head2
20444 #: ../fish/guestfish.pod:67
20445 msgid "From shell scripts"
20446 msgstr ""
20447
20448 # type: textblock
20449 #. type: textblock
20450 #: ../fish/guestfish.pod:69
20451 msgid "Create a new C</etc/motd> file in a guest or disk image:"
20452 msgstr ""
20453
20454 # type: verbatim
20455 #. type: verbatim
20456 #: ../fish/guestfish.pod:71
20457 #, no-wrap
20458 msgid ""
20459 " guestfish <<_EOF_\n"
20460 " add disk.img\n"
20461 " run\n"
20462 " mount /dev/vg_guest/lv_root /\n"
20463 " write /etc/motd \"Welcome, new users\"\n"
20464 " _EOF_\n"
20465 "\n"
20466 msgstr ""
20467
20468 # type: textblock
20469 #. type: textblock
20470 #: ../fish/guestfish.pod:78
20471 msgid "List the LVM logical volumes in a disk image:"
20472 msgstr ""
20473
20474 # type: verbatim
20475 #. type: verbatim
20476 #: ../fish/guestfish.pod:80
20477 #, no-wrap
20478 msgid ""
20479 " guestfish -a disk.img --ro <<_EOF_\n"
20480 " run\n"
20481 " lvs\n"
20482 " _EOF_\n"
20483 "\n"
20484 msgstr ""
20485
20486 # type: textblock
20487 #. type: textblock
20488 #: ../fish/guestfish.pod:85
20489 msgid "List all the filesystems in a disk image:"
20490 msgstr ""
20491
20492 # type: verbatim
20493 #. type: verbatim
20494 #: ../fish/guestfish.pod:87
20495 #, no-wrap
20496 msgid ""
20497 " guestfish -a disk.img --ro <<_EOF_\n"
20498 " run\n"
20499 " list-filesystems\n"
20500 " _EOF_\n"
20501 "\n"
20502 msgstr ""
20503
20504 # type: =head2
20505 #. type: =head2
20506 #: ../fish/guestfish.pod:92
20507 msgid "On one command line"
20508 msgstr ""
20509
20510 # type: textblock
20511 #. type: textblock
20512 #: ../fish/guestfish.pod:94
20513 msgid "Update C</etc/resolv.conf> in a guest:"
20514 msgstr ""
20515
20516 # type: verbatim
20517 #. type: verbatim
20518 #: ../fish/guestfish.pod:96
20519 #, no-wrap
20520 msgid ""
20521 " guestfish \\\n"
20522 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
20523 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
20524 "\n"
20525 msgstr ""
20526
20527 # type: textblock
20528 #. type: textblock
20529 #: ../fish/guestfish.pod:100
20530 msgid "Edit C</boot/grub/grub.conf> interactively:"
20531 msgstr ""
20532
20533 # type: verbatim
20534 #. type: verbatim
20535 #: ../fish/guestfish.pod:102
20536 #, no-wrap
20537 msgid ""
20538 " guestfish --rw --add disk.img \\\n"
20539 "   --mount /dev/vg_guest/lv_root \\\n"
20540 "   --mount /dev/sda1:/boot \\\n"
20541 "   edit /boot/grub/grub.conf\n"
20542 "\n"
20543 msgstr ""
20544
20545 # type: =head2
20546 #. type: =head2
20547 #: ../fish/guestfish.pod:107
20548 msgid "Mount disks automatically"
20549 msgstr ""
20550
20551 # type: textblock
20552 #. type: textblock
20553 #: ../fish/guestfish.pod:109
20554 msgid ""
20555 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
20556 msgstr ""
20557
20558 # type: verbatim
20559 #. type: verbatim
20560 #: ../fish/guestfish.pod:112
20561 #, no-wrap
20562 msgid ""
20563 " guestfish --ro -a disk.img -i cat /etc/group\n"
20564 "\n"
20565 msgstr ""
20566
20567 # type: verbatim
20568 #. type: verbatim
20569 #: ../fish/guestfish.pod:114
20570 #, no-wrap
20571 msgid ""
20572 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
20573 "\n"
20574 msgstr ""
20575
20576 # type: textblock
20577 #. type: textblock
20578 #: ../fish/guestfish.pod:116
20579 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
20580 msgstr ""
20581
20582 # type: verbatim
20583 #. type: verbatim
20584 #: ../fish/guestfish.pod:118
20585 #, no-wrap
20586 msgid ""
20587 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
20588 "\n"
20589 msgstr ""
20590
20591 # type: =head2
20592 #. type: =head2
20593 #: ../fish/guestfish.pod:120
20594 msgid "As a script interpreter"
20595 msgstr ""
20596
20597 # type: textblock
20598 #. type: textblock
20599 #: ../fish/guestfish.pod:122
20600 msgid "Create a 100MB disk containing an ext2-formatted partition:"
20601 msgstr ""
20602
20603 # type: verbatim
20604 #. type: verbatim
20605 #: ../fish/guestfish.pod:124
20606 #, no-wrap
20607 msgid ""
20608 " #!/usr/bin/guestfish -f\n"
20609 " sparse test1.img 100M\n"
20610 " run\n"
20611 " part-disk /dev/sda mbr\n"
20612 " mkfs ext2 /dev/sda1\n"
20613 "\n"
20614 msgstr ""
20615
20616 # type: =head2
20617 #. type: =head2
20618 #: ../fish/guestfish.pod:130
20619 msgid "Start with a prepared disk"
20620 msgstr ""
20621
20622 # type: textblock
20623 #. type: textblock
20624 #: ../fish/guestfish.pod:132
20625 msgid ""
20626 "An alternate way to create a 100MB disk called C<test1.img> containing a "
20627 "single ext2-formatted partition:"
20628 msgstr ""
20629
20630 # type: verbatim
20631 #. type: verbatim
20632 #: ../fish/guestfish.pod:135
20633 #, no-wrap
20634 msgid ""
20635 " guestfish -N fs\n"
20636 "\n"
20637 msgstr ""
20638
20639 # type: textblock
20640 #. type: textblock
20641 #: ../fish/guestfish.pod:137
20642 msgid "To list what is available do:"
20643 msgstr ""
20644
20645 # type: verbatim
20646 #. type: verbatim
20647 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:888
20648 #, no-wrap
20649 msgid ""
20650 " guestfish -N help | less\n"
20651 "\n"
20652 msgstr ""
20653
20654 # type: =head2
20655 #. type: =head2
20656 #: ../fish/guestfish.pod:141
20657 msgid "Remote control"
20658 msgstr ""
20659
20660 # type: verbatim
20661 #. type: verbatim
20662 #: ../fish/guestfish.pod:143
20663 #, no-wrap
20664 msgid ""
20665 " eval \"`guestfish --listen`\"\n"
20666 " guestfish --remote add-ro disk.img\n"
20667 " guestfish --remote run\n"
20668 " guestfish --remote lvs\n"
20669 "\n"
20670 msgstr ""
20671
20672 # type: =head1
20673 #. type: =head1
20674 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
20675 #: ../fuse/guestmount.pod:73 ../tools/virt-edit.pl:77
20676 #: ../tools/virt-win-reg.pl:96 ../tools/virt-resize.pl:254
20677 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:98
20678 #: ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
20679 msgid "OPTIONS"
20680 msgstr ""
20681
20682 # type: =item
20683 #. type: =item
20684 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:131
20685 #: ../tools/virt-edit.pl:85 ../tools/virt-win-reg.pl:104
20686 #: ../tools/virt-resize.pl:262 ../tools/virt-list-filesystems.pl:61
20687 #: ../tools/virt-tar.pl:106 ../tools/virt-make-fs.pl:161
20688 #: ../tools/virt-list-partitions.pl:62
20689 msgid "B<--help>"
20690 msgstr ""
20691
20692 # type: textblock
20693 #. type: textblock
20694 #: ../fish/guestfish.pod:154
20695 msgid "Displays general help on options."
20696 msgstr ""
20697
20698 # type: =item
20699 #. type: =item
20700 #: ../fish/guestfish.pod:156
20701 msgid "B<-h>"
20702 msgstr ""
20703
20704 # type: =item
20705 #. type: =item
20706 #: ../fish/guestfish.pod:158
20707 msgid "B<--cmd-help>"
20708 msgstr ""
20709
20710 # type: textblock
20711 #. type: textblock
20712 #: ../fish/guestfish.pod:160
20713 msgid "Lists all available guestfish commands."
20714 msgstr ""
20715
20716 # type: =item
20717 #. type: =item
20718 #: ../fish/guestfish.pod:162
20719 msgid "B<-h cmd>"
20720 msgstr ""
20721
20722 # type: =item
20723 #. type: =item
20724 #: ../fish/guestfish.pod:164
20725 msgid "B<--cmd-help cmd>"
20726 msgstr ""
20727
20728 # type: textblock
20729 #. type: textblock
20730 #: ../fish/guestfish.pod:166
20731 msgid "Displays detailed help on a single command C<cmd>."
20732 msgstr ""
20733
20734 # type: =item
20735 #. type: =item
20736 #: ../fish/guestfish.pod:168
20737 msgid "B<-a image>"
20738 msgstr ""
20739
20740 # type: =item
20741 #. type: =item
20742 #: ../fish/guestfish.pod:170
20743 msgid "B<--add image>"
20744 msgstr ""
20745
20746 # type: textblock
20747 #. type: textblock
20748 #: ../fish/guestfish.pod:172
20749 msgid "Add a block device or virtual machine image to the shell."
20750 msgstr ""
20751
20752 # type: textblock
20753 #. type: textblock
20754 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:81
20755 msgid ""
20756 "The format of the disk image is auto-detected.  To override this and force a "
20757 "particular format use the I<--format=..> option."
20758 msgstr ""
20759
20760 #. type: textblock
20761 #: ../fish/guestfish.pod:177
20762 msgid ""
20763 "Using this flag is mostly equivalent to using the C<add> command, with "
20764 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
20765 "the I<--format=...> flag was given."
20766 msgstr ""
20767
20768 # type: =item
20769 #. type: =item
20770 #: ../fish/guestfish.pod:181
20771 msgid "B<-c URI>"
20772 msgstr ""
20773
20774 # type: =item
20775 #. type: =item
20776 #: ../fish/guestfish.pod:183
20777 msgid "B<--connect URI>"
20778 msgstr ""
20779
20780 # type: textblock
20781 #. type: textblock
20782 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:86
20783 msgid ""
20784 "When used in conjunction with the I<-d> option, this specifies the libvirt "
20785 "URI to use.  The default is to use the default libvirt connection."
20786 msgstr ""
20787
20788 # type: =item
20789 #. type: =item
20790 #: ../fish/guestfish.pod:189
20791 msgid "B<--csh>"
20792 msgstr ""
20793
20794 # type: textblock
20795 #. type: textblock
20796 #: ../fish/guestfish.pod:191
20797 msgid ""
20798 "If using the I<--listen> option and a csh-like shell, use this option.  See "
20799 "section L</REMOTE CONTROL AND CSH> below."
20800 msgstr ""
20801
20802 # type: =item
20803 #. type: =item
20804 #: ../fish/guestfish.pod:194
20805 msgid "B<-d libvirt-domain>"
20806 msgstr ""
20807
20808 # type: =item
20809 #. type: =item
20810 #: ../fish/guestfish.pod:196
20811 msgid "B<--domain libvirt-domain>"
20812 msgstr ""
20813
20814 # type: textblock
20815 #. type: textblock
20816 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:92
20817 msgid ""
20818 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
20819 "used, then any libvirt domain can be used.  However in write mode, only "
20820 "libvirt domains which are shut down can be named here."
20821 msgstr ""
20822
20823 # type: textblock
20824 #. type: textblock
20825 #: ../fish/guestfish.pod:202
20826 msgid ""
20827 "Using this flag is mostly equivalent to using the C<add-domain> command, "
20828 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
20829 "if the I<--format:...> flag was given."
20830 msgstr ""
20831
20832 # type: =item
20833 #. type: =item
20834 #: ../fish/guestfish.pod:206
20835 msgid "B<-D>"
20836 msgstr ""
20837
20838 # type: =item
20839 #. type: =item
20840 #: ../fish/guestfish.pod:208
20841 msgid "B<--no-dest-paths>"
20842 msgstr ""
20843
20844 # type: textblock
20845 #. type: textblock
20846 #: ../fish/guestfish.pod:210
20847 msgid ""
20848 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
20849 "to hit the tab key to complete paths on the guest filesystem, but this "
20850 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
20851 "allow this feature to be disabled."
20852 msgstr ""
20853
20854 # type: =item
20855 #. type: =item
20856 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:108
20857 msgid "B<--echo-keys>"
20858 msgstr ""
20859
20860 # type: textblock
20861 #. type: textblock
20862 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:110
20863 msgid ""
20864 "When prompting for keys and passphrases, guestfish normally turns echoing "
20865 "off so you cannot see what you are typing.  If you are not worried about "
20866 "Tempest attacks and there is no one else in the room you can specify this "
20867 "flag to see what you are typing."
20868 msgstr ""
20869
20870 # type: =item
20871 #. type: =item
20872 #: ../fish/guestfish.pod:222
20873 msgid "B<-f file>"
20874 msgstr ""
20875
20876 # type: =item
20877 #. type: =item
20878 #: ../fish/guestfish.pod:224
20879 msgid "B<--file file>"
20880 msgstr ""
20881
20882 # type: textblock
20883 #. type: textblock
20884 #: ../fish/guestfish.pod:226
20885 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
20886 msgstr ""
20887
20888 # type: verbatim
20889 #. type: verbatim
20890 #: ../fish/guestfish.pod:229
20891 #, no-wrap
20892 msgid ""
20893 " #!/usr/bin/guestfish -f\n"
20894 "\n"
20895 msgstr ""
20896
20897 # type: =item
20898 #. type: =item
20899 #: ../fish/guestfish.pod:231
20900 msgid "B<--format=raw|qcow2|..>"
20901 msgstr ""
20902
20903 # type: =item
20904 #. type: =item
20905 #: ../fish/guestfish.pod:233
20906 msgid "B<--format>"
20907 msgstr ""
20908
20909 # type: textblock
20910 #. type: textblock
20911 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:117
20912 msgid ""
20913 "The default for the I<-a> option is to auto-detect the format of the disk "
20914 "image.  Using this forces the disk format for I<-a> options which follow on "
20915 "the command line.  Using I<--format> with no argument switches back to auto-"
20916 "detection for subsequent I<-a> options."
20917 msgstr ""
20918
20919 # type: verbatim
20920 #. type: verbatim
20921 #: ../fish/guestfish.pod:242
20922 #, no-wrap
20923 msgid ""
20924 " guestfish --format=raw -a disk.img\n"
20925 "\n"
20926 msgstr ""
20927
20928 # type: textblock
20929 #. type: textblock
20930 #: ../fish/guestfish.pod:244
20931 msgid "forces raw format (no auto-detection) for C<disk.img>."
20932 msgstr ""
20933
20934 # type: verbatim
20935 #. type: verbatim
20936 #: ../fish/guestfish.pod:246
20937 #, no-wrap
20938 msgid ""
20939 " guestfish --format=raw -a disk.img --format -a another.img\n"
20940 "\n"
20941 msgstr ""
20942
20943 # type: textblock
20944 #. type: textblock
20945 #: ../fish/guestfish.pod:248
20946 msgid ""
20947 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
20948 "detection for C<another.img>."
20949 msgstr ""
20950
20951 # type: textblock
20952 #. type: textblock
20953 #: ../fish/guestfish.pod:251
20954 msgid ""
20955 "If you have untrusted raw-format guest disk images, you should use this "
20956 "option to specify the disk format.  This avoids a possible security problem "
20957 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
20958 msgstr ""
20959
20960 # type: =item
20961 #. type: =item
20962 #: ../fish/guestfish.pod:256
20963 msgid "B<-i>"
20964 msgstr ""
20965
20966 # type: =item
20967 #. type: =item
20968 #: ../fish/guestfish.pod:258
20969 msgid "B<--inspector>"
20970 msgstr ""
20971
20972 # type: textblock
20973 #. type: textblock
20974 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:137
20975 msgid ""
20976 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
20977 "system and mount filesystems as they would be mounted on the real virtual "
20978 "machine."
20979 msgstr ""
20980
20981 # type: textblock
20982 #. type: textblock
20983 #: ../fish/guestfish.pod:264
20984 msgid "Typical usage is either:"
20985 msgstr ""
20986
20987 # type: verbatim
20988 #. type: verbatim
20989 #: ../fish/guestfish.pod:266
20990 #, no-wrap
20991 msgid ""
20992 " guestfish -d myguest -i\n"
20993 "\n"
20994 msgstr ""
20995
20996 # type: textblock
20997 #. type: textblock
20998 #: ../fish/guestfish.pod:268
20999 msgid "(for an inactive libvirt domain called I<myguest>), or:"
21000 msgstr ""
21001
21002 # type: verbatim
21003 #. type: verbatim
21004 #: ../fish/guestfish.pod:270
21005 #, no-wrap
21006 msgid ""
21007 " guestfish --ro -d myguest -i\n"
21008 "\n"
21009 msgstr ""
21010
21011 # type: textblock
21012 #. type: textblock
21013 #: ../fish/guestfish.pod:272
21014 msgid "(for active domains, readonly), or specify the block device directly:"
21015 msgstr ""
21016
21017 # type: verbatim
21018 #. type: verbatim
21019 #: ../fish/guestfish.pod:274
21020 #, no-wrap
21021 msgid ""
21022 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
21023 "\n"
21024 msgstr ""
21025
21026 # type: textblock
21027 #. type: textblock
21028 #: ../fish/guestfish.pod:276
21029 msgid ""
21030 "Note that the command line syntax changed slightly over older versions of "
21031 "guestfish.  You can still use the old syntax:"
21032 msgstr ""
21033
21034 # type: verbatim
21035 #. type: verbatim
21036 #: ../fish/guestfish.pod:279
21037 #, no-wrap
21038 msgid ""
21039 " guestfish [--ro] -i disk.img\n"
21040 "\n"
21041 msgstr ""
21042
21043 # type: verbatim
21044 #. type: verbatim
21045 #: ../fish/guestfish.pod:281
21046 #, no-wrap
21047 msgid ""
21048 " guestfish [--ro] -i libvirt-domain\n"
21049 "\n"
21050 msgstr ""
21051
21052 # type: textblock
21053 #. type: textblock
21054 #: ../fish/guestfish.pod:283
21055 msgid ""
21056 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
21057 "then using other commands to mount the filesystems that were found."
21058 msgstr ""
21059
21060 # type: =item
21061 #. type: =item
21062 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:141
21063 msgid "B<--keys-from-stdin>"
21064 msgstr ""
21065
21066 # type: textblock
21067 #. type: textblock
21068 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:143
21069 msgid ""
21070 "Read key or passphrase parameters from stdin.  The default is to try to read "
21071 "passphrases from the user by opening C</dev/tty>."
21072 msgstr ""
21073
21074 # type: =item
21075 #. type: =item
21076 #: ../fish/guestfish.pod:292
21077 msgid "B<--listen>"
21078 msgstr ""
21079
21080 # type: textblock
21081 #. type: textblock
21082 #: ../fish/guestfish.pod:294
21083 msgid ""
21084 "Fork into the background and listen for remote commands.  See section L</"
21085 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
21086 msgstr ""
21087
21088 # type: =item
21089 #. type: =item
21090 #: ../fish/guestfish.pod:297
21091 msgid "B<-m dev[:mountpoint]>"
21092 msgstr ""
21093
21094 # type: =item
21095 #. type: =item
21096 #: ../fish/guestfish.pod:299
21097 msgid "B<--mount dev[:mountpoint]>"
21098 msgstr ""
21099
21100 # type: textblock
21101 #. type: textblock
21102 #: ../fish/guestfish.pod:301
21103 msgid "Mount the named partition or logical volume on the given mountpoint."
21104 msgstr ""
21105
21106 # type: textblock
21107 #. type: textblock
21108 #: ../fish/guestfish.pod:303
21109 msgid "If the mountpoint is omitted, it defaults to C</>."
21110 msgstr ""
21111
21112 # type: textblock
21113 #. type: textblock
21114 #: ../fish/guestfish.pod:305
21115 msgid "You have to mount something on C</> before most commands will work."
21116 msgstr ""
21117
21118 # type: textblock
21119 #. type: textblock
21120 #: ../fish/guestfish.pod:307
21121 msgid ""
21122 "If any I<-m> or I<--mount> options are given, the guest is automatically "
21123 "launched."
21124 msgstr ""
21125
21126 # type: textblock
21127 #. type: textblock
21128 #: ../fish/guestfish.pod:310
21129 msgid ""
21130 "If you don't know what filesystems a disk image contains, you can either run "
21131 "guestfish without this option, then list the partitions, filesystems and LVs "
21132 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
21133 "commands), or you can use the L<virt-filesystems(1)> program."
21134 msgstr ""
21135
21136 # type: textblock
21137 #. type: textblock
21138 #: ../fish/guestfish.pod:316
21139 msgid ""
21140 "Using this flag is mostly equivalent to using the C<mount-options> command "
21141 "or the C<mount-ro> command if the I<--ro> flag was given."
21142 msgstr ""
21143
21144 # type: =item
21145 #. type: =item
21146 #: ../fish/guestfish.pod:319
21147 msgid "B<-n>"
21148 msgstr ""
21149
21150 # type: =item
21151 #. type: =item
21152 #: ../fish/guestfish.pod:321
21153 msgid "B<--no-sync>"
21154 msgstr ""
21155
21156 # type: textblock
21157 #. type: textblock
21158 #: ../fish/guestfish.pod:323
21159 msgid ""
21160 "Disable autosync.  This is enabled by default.  See the discussion of "
21161 "autosync in the L<guestfs(3)> manpage."
21162 msgstr ""
21163
21164 # type: =item
21165 #. type: =item
21166 #: ../fish/guestfish.pod:326
21167 msgid "B<-N type>"
21168 msgstr ""
21169
21170 # type: =item
21171 #. type: =item
21172 #: ../fish/guestfish.pod:328
21173 msgid "B<--new type>"
21174 msgstr ""
21175
21176 # type: =item
21177 #. type: =item
21178 #: ../fish/guestfish.pod:330
21179 msgid "B<-N help>"
21180 msgstr ""
21181
21182 # type: textblock
21183 #. type: textblock
21184 #: ../fish/guestfish.pod:332
21185 msgid ""
21186 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
21187 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
21188 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
21189 "IMAGES> below."
21190 msgstr ""
21191
21192 # type: =item
21193 #. type: =item
21194 #: ../fish/guestfish.pod:337
21195 msgid "B<--progress-bars>"
21196 msgstr ""
21197
21198 # type: textblock
21199 #. type: textblock
21200 #: ../fish/guestfish.pod:339
21201 msgid "Enable progress bars, even when guestfish is used non-interactively."
21202 msgstr ""
21203
21204 # type: textblock
21205 #. type: textblock
21206 #: ../fish/guestfish.pod:341
21207 msgid ""
21208 "Progress bars are enabled by default when guestfish is used as an "
21209 "interactive shell."
21210 msgstr ""
21211
21212 # type: =item
21213 #. type: =item
21214 #: ../fish/guestfish.pod:344
21215 msgid "B<--no-progress-bars>"
21216 msgstr ""
21217
21218 # type: textblock
21219 #. type: textblock
21220 #: ../fish/guestfish.pod:346
21221 msgid "Disable progress bars."
21222 msgstr ""
21223
21224 # type: =item
21225 #. type: =item
21226 #: ../fish/guestfish.pod:348
21227 msgid "B<--remote[=pid]>"
21228 msgstr ""
21229
21230 # type: textblock
21231 #. type: textblock
21232 #: ../fish/guestfish.pod:350
21233 msgid ""
21234 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
21235 "CONTROL GUESTFISH OVER A SOCKET> below."
21236 msgstr ""
21237
21238 # type: =item
21239 #. type: =item
21240 #: ../fish/guestfish.pod:353
21241 msgid "B<-r>"
21242 msgstr ""
21243
21244 # type: =item
21245 #. type: =item
21246 #: ../fish/guestfish.pod:355
21247 msgid "B<--ro>"
21248 msgstr ""
21249
21250 # type: textblock
21251 #. type: textblock
21252 #: ../fish/guestfish.pod:357
21253 msgid ""
21254 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
21255 "mounts are done read-only."
21256 msgstr ""
21257
21258 # type: textblock
21259 #. type: textblock
21260 #: ../fish/guestfish.pod:360
21261 msgid ""
21262 "The option must always be used if the disk image or virtual machine might be "
21263 "running, and is generally recommended in cases where you don't need write "
21264 "access to the disk."
21265 msgstr ""
21266
21267 # type: textblock
21268 #. type: textblock
21269 #: ../fish/guestfish.pod:364
21270 msgid ""
21271 "Note that prepared disk images created with I<-N> are not affected by this "
21272 "option.  Also commands like C<add> are not affected - you have to specify "
21273 "the C<readonly:true> option explicitly if you need it."
21274 msgstr ""
21275
21276 # type: textblock
21277 #. type: textblock
21278 #: ../fish/guestfish.pod:368
21279 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
21280 msgstr ""
21281
21282 # type: =item
21283 #. type: =item
21284 #: ../fish/guestfish.pod:370 ../fuse/guestmount.pod:208
21285 msgid "B<--selinux>"
21286 msgstr ""
21287
21288 # type: textblock
21289 #. type: textblock
21290 #: ../fish/guestfish.pod:372
21291 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
21292 msgstr ""
21293
21294 # type: =item
21295 #. type: =item
21296 #: ../fish/guestfish.pod:374
21297 msgid "B<-v>"
21298 msgstr ""
21299
21300 # type: =item
21301 #. type: =item
21302 #: ../fish/guestfish.pod:376
21303 msgid "B<--verbose>"
21304 msgstr ""
21305
21306 # type: textblock
21307 #. type: textblock
21308 #: ../fish/guestfish.pod:378
21309 msgid ""
21310 "Enable very verbose messages.  This is particularly useful if you find a bug."
21311 msgstr ""
21312
21313 # type: =item
21314 #. type: =item
21315 #: ../fish/guestfish.pod:381
21316 msgid "B<-V>"
21317 msgstr ""
21318
21319 # type: =item
21320 #. type: =item
21321 #: ../fish/guestfish.pod:383 ../tools/virt-edit.pl:93
21322 #: ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270
21323 #: ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:114
21324 #: ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
21325 msgid "B<--version>"
21326 msgstr ""
21327
21328 # type: textblock
21329 #. type: textblock
21330 #: ../fish/guestfish.pod:385
21331 msgid "Display the guestfish / libguestfs version number and exit."
21332 msgstr ""
21333
21334 # type: =item
21335 #. type: =item
21336 #: ../fish/guestfish.pod:387
21337 msgid "B<-w>"
21338 msgstr ""
21339
21340 # type: =item
21341 #. type: =item
21342 #: ../fish/guestfish.pod:389
21343 msgid "B<--rw>"
21344 msgstr ""
21345
21346 # type: textblock
21347 #. type: textblock
21348 #: ../fish/guestfish.pod:391
21349 msgid ""
21350 "This option does nothing at the moment.  See L</OPENING DISKS FOR READ AND "
21351 "WRITE> below."
21352 msgstr ""
21353
21354 # type: =item
21355 #. type: =item
21356 #: ../fish/guestfish.pod:394
21357 msgid "B<-x>"
21358 msgstr ""
21359
21360 # type: textblock
21361 #. type: textblock
21362 #: ../fish/guestfish.pod:396
21363 msgid "Echo each command before executing it."
21364 msgstr ""
21365
21366 # type: =head1
21367 #. type: =head1
21368 #: ../fish/guestfish.pod:400
21369 msgid "COMMANDS ON COMMAND LINE"
21370 msgstr ""
21371
21372 # type: textblock
21373 #. type: textblock
21374 #: ../fish/guestfish.pod:402
21375 msgid ""
21376 "Any additional (non-option) arguments are treated as commands to execute."
21377 msgstr ""
21378
21379 # type: textblock
21380 #. type: textblock
21381 #: ../fish/guestfish.pod:405
21382 msgid ""
21383 "Commands to execute should be separated by a colon (C<:>), where the colon "
21384 "is a separate parameter.  Thus:"
21385 msgstr ""
21386
21387 # type: verbatim
21388 #. type: verbatim
21389 #: ../fish/guestfish.pod:408
21390 #, no-wrap
21391 msgid ""
21392 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
21393 "\n"
21394 msgstr ""
21395
21396 # type: textblock
21397 #. type: textblock
21398 #: ../fish/guestfish.pod:410
21399 msgid ""
21400 "If there are no additional arguments, then we enter a shell, either an "
21401 "interactive shell with a prompt (if the input is a terminal) or a non-"
21402 "interactive shell."
21403 msgstr ""
21404
21405 # type: textblock
21406 #. type: textblock
21407 #: ../fish/guestfish.pod:414
21408 msgid ""
21409 "In either command line mode or non-interactive shell, the first command that "
21410 "gives an error causes the whole shell to exit.  In interactive mode (with a "
21411 "prompt) if a command fails, you can continue to enter commands."
21412 msgstr ""
21413
21414 # type: =head1
21415 #. type: =head1
21416 #: ../fish/guestfish.pod:419
21417 msgid "USING launch (OR run)"
21418 msgstr ""
21419
21420 # type: textblock
21421 #. type: textblock
21422 #: ../fish/guestfish.pod:421
21423 msgid ""
21424 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
21425 "then launch it, then mount any disks you need, and finally issue actions/"
21426 "commands.  So the general order of the day is:"
21427 msgstr ""
21428
21429 # type: textblock
21430 #. type: textblock
21431 #: ../fish/guestfish.pod:429
21432 msgid "add or -a/--add"
21433 msgstr ""
21434
21435 # type: textblock
21436 #. type: textblock
21437 #: ../fish/guestfish.pod:433
21438 msgid "launch (aka run)"
21439 msgstr ""
21440
21441 # type: textblock
21442 #. type: textblock
21443 #: ../fish/guestfish.pod:437
21444 msgid "mount or -m/--mount"
21445 msgstr ""
21446
21447 # type: textblock
21448 #. type: textblock
21449 #: ../fish/guestfish.pod:441
21450 msgid "any other commands"
21451 msgstr ""
21452
21453 # type: textblock
21454 #. type: textblock
21455 #: ../fish/guestfish.pod:445
21456 msgid ""
21457 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
21458 "guest before mounting or performing any other commands."
21459 msgstr ""
21460
21461 # type: textblock
21462 #. type: textblock
21463 #: ../fish/guestfish.pod:448
21464 msgid ""
21465 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
21466 "I<--new> options were given then C<run> is done automatically, simply "
21467 "because guestfish can't perform the action you asked for without doing this."
21468 msgstr ""
21469
21470 # type: =head1
21471 #. type: =head1
21472 #: ../fish/guestfish.pod:453
21473 msgid "OPENING DISKS FOR READ AND WRITE"
21474 msgstr ""
21475
21476 # type: textblock
21477 #. type: textblock
21478 #: ../fish/guestfish.pod:455
21479 msgid ""
21480 "The guestfish (and L<guestmount(1)>) options I<--ro> and I<--rw> affect "
21481 "whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> "
21482 "open disk images read-only or for writing."
21483 msgstr ""
21484
21485 # type: textblock
21486 #. type: textblock
21487 #: ../fish/guestfish.pod:459
21488 msgid ""
21489 "In libguestfs E<lt> 1.6.2, guestfish and guestmount defaulted to opening "
21490 "disk images supplied on the command line for write.  To open a disk image "
21491 "read-only you have to do I<-a image --ro>."
21492 msgstr ""
21493
21494 # type: textblock
21495 #. type: textblock
21496 #: ../fish/guestfish.pod:463
21497 msgid ""
21498 "This matters: If you accidentally open a live VM disk image writable then "
21499 "you will cause irreversible disk corruption."
21500 msgstr ""
21501
21502 #. type: textblock
21503 #: ../fish/guestfish.pod:466
21504 msgid ""
21505 "By libguestfs 1.10 we intend to change the default the other way.  Disk "
21506 "images will be opened read-only.  You will have to either specify "
21507 "I<guestfish --rw> or change a configuration file in order to get write "
21508 "access for disk images specified by those other command line options."
21509 msgstr ""
21510
21511 # type: textblock
21512 #. type: textblock
21513 #: ../fish/guestfish.pod:471
21514 msgid ""
21515 "This version of guestfish has a I<--rw> option which does nothing (it is "
21516 "already the default).  However it is highly recommended that you use this "
21517 "option to indicate that guestfish needs write access, and to prepare your "
21518 "scripts for the day when this option will be required for write access."
21519 msgstr ""
21520
21521 # type: textblock
21522 #. type: textblock
21523 #: ../fish/guestfish.pod:477
21524 msgid ""
21525 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
21526 "other libguestfs program apart from guestfish and guestmount."
21527 msgstr ""
21528
21529 # type: =head1
21530 #. type: =head1
21531 #: ../fish/guestfish.pod:480
21532 msgid "QUOTING"
21533 msgstr ""
21534
21535 # type: textblock
21536 #. type: textblock
21537 #: ../fish/guestfish.pod:482
21538 msgid ""
21539 "You can quote ordinary parameters using either single or double quotes.  For "
21540 "example:"
21541 msgstr ""
21542
21543 # type: verbatim
21544 #. type: verbatim
21545 #: ../fish/guestfish.pod:485
21546 #, no-wrap
21547 msgid ""
21548 " add \"file with a space.img\"\n"
21549 "\n"
21550 msgstr ""
21551
21552 # type: verbatim
21553 #. type: verbatim
21554 #: ../fish/guestfish.pod:487
21555 #, no-wrap
21556 msgid ""
21557 " rm '/file name'\n"
21558 "\n"
21559 msgstr ""
21560
21561 # type: verbatim
21562 #. type: verbatim
21563 #: ../fish/guestfish.pod:489
21564 #, no-wrap
21565 msgid ""
21566 " rm '/\"'\n"
21567 "\n"
21568 msgstr ""
21569
21570 # type: textblock
21571 #. type: textblock
21572 #: ../fish/guestfish.pod:491
21573 msgid ""
21574 "A few commands require a list of strings to be passed.  For these, use a "
21575 "whitespace-separated list, enclosed in quotes.  Strings containing "
21576 "whitespace to be passed through must be enclosed in single quotes.  A "
21577 "literal single quote must be escaped with a backslash."
21578 msgstr ""
21579
21580 # type: verbatim
21581 #. type: verbatim
21582 #: ../fish/guestfish.pod:496
21583 #, no-wrap
21584 msgid ""
21585 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
21586 " command \"/bin/echo 'foo      bar'\"\n"
21587 " command \"/bin/echo \\'foo\\'\"\n"
21588 "\n"
21589 msgstr ""
21590
21591 # type: =head1
21592 #. type: =head1
21593 #: ../fish/guestfish.pod:500
21594 msgid "OPTIONAL ARGUMENTS"
21595 msgstr ""
21596
21597 # type: textblock
21598 #. type: textblock
21599 #: ../fish/guestfish.pod:502
21600 msgid ""
21601 "Some commands take optional arguments.  These arguments appear in this "
21602 "documentation as C<[argname:..]>.  You can use them as in these examples:"
21603 msgstr ""
21604
21605 # type: verbatim
21606 #. type: verbatim
21607 #: ../fish/guestfish.pod:506
21608 #, no-wrap
21609 msgid ""
21610 " add-drive-opts filename\n"
21611 "\n"
21612 msgstr ""
21613
21614 # type: verbatim
21615 #. type: verbatim
21616 #: ../fish/guestfish.pod:508
21617 #, no-wrap
21618 msgid ""
21619 " add-drive-opts filename readonly:true\n"
21620 "\n"
21621 msgstr ""
21622
21623 # type: verbatim
21624 #. type: verbatim
21625 #: ../fish/guestfish.pod:510
21626 #, no-wrap
21627 msgid ""
21628 " add-drive-opts filename format:qcow2 readonly:false\n"
21629 "\n"
21630 msgstr ""
21631
21632 # type: textblock
21633 #. type: textblock
21634 #: ../fish/guestfish.pod:512
21635 msgid ""
21636 "Each optional argument can appear at most once.  All optional arguments must "
21637 "appear after the required ones."
21638 msgstr ""
21639
21640 # type: =head1
21641 #. type: =head1
21642 #: ../fish/guestfish.pod:515
21643 msgid "NUMBERS"
21644 msgstr ""
21645
21646 # type: textblock
21647 #. type: textblock
21648 #: ../fish/guestfish.pod:517
21649 msgid ""
21650 "This section applies to all commands which can take integers as parameters."
21651 msgstr ""
21652
21653 # type: =head2
21654 #. type: =head2
21655 #: ../fish/guestfish.pod:520
21656 msgid "SIZE SUFFIX"
21657 msgstr ""
21658
21659 # type: textblock
21660 #. type: textblock
21661 #: ../fish/guestfish.pod:522
21662 msgid ""
21663 "When the command takes a parameter measured in bytes, you can use one of the "
21664 "following suffixes to specify kilobytes, megabytes and larger sizes:"
21665 msgstr ""
21666
21667 # type: =item
21668 #. type: =item
21669 #: ../fish/guestfish.pod:528
21670 msgid "B<k> or B<K> or B<KiB>"
21671 msgstr ""
21672
21673 # type: textblock
21674 #. type: textblock
21675 #: ../fish/guestfish.pod:530
21676 msgid "The size in kilobytes (multiplied by 1024)."
21677 msgstr ""
21678
21679 # type: =item
21680 #. type: =item
21681 #: ../fish/guestfish.pod:532
21682 msgid "B<KB>"
21683 msgstr ""
21684
21685 # type: textblock
21686 #. type: textblock
21687 #: ../fish/guestfish.pod:534
21688 msgid "The size in SI 1000 byte units."
21689 msgstr ""
21690
21691 # type: =item
21692 #. type: =item
21693 #: ../fish/guestfish.pod:536
21694 msgid "B<M> or B<MiB>"
21695 msgstr ""
21696
21697 # type: textblock
21698 #. type: textblock
21699 #: ../fish/guestfish.pod:538
21700 msgid "The size in megabytes (multiplied by 1048576)."
21701 msgstr ""
21702
21703 # type: =item
21704 #. type: =item
21705 #: ../fish/guestfish.pod:540
21706 msgid "B<MB>"
21707 msgstr ""
21708
21709 # type: textblock
21710 #. type: textblock
21711 #: ../fish/guestfish.pod:542
21712 msgid "The size in SI 1000000 byte units."
21713 msgstr ""
21714
21715 # type: =item
21716 #. type: =item
21717 #: ../fish/guestfish.pod:544
21718 msgid "B<G> or B<GiB>"
21719 msgstr ""
21720
21721 # type: textblock
21722 #. type: textblock
21723 #: ../fish/guestfish.pod:546
21724 msgid "The size in gigabytes (multiplied by 2**30)."
21725 msgstr ""
21726
21727 # type: =item
21728 #. type: =item
21729 #: ../fish/guestfish.pod:548
21730 msgid "B<GB>"
21731 msgstr ""
21732
21733 # type: textblock
21734 #. type: textblock
21735 #: ../fish/guestfish.pod:550
21736 msgid "The size in SI 10**9 byte units."
21737 msgstr ""
21738
21739 # type: =item
21740 #. type: =item
21741 #: ../fish/guestfish.pod:552
21742 msgid "B<T> or B<TiB>"
21743 msgstr ""
21744
21745 # type: textblock
21746 #. type: textblock
21747 #: ../fish/guestfish.pod:554
21748 msgid "The size in terabytes (multiplied by 2**40)."
21749 msgstr ""
21750
21751 # type: =item
21752 #. type: =item
21753 #: ../fish/guestfish.pod:556
21754 msgid "B<TB>"
21755 msgstr ""
21756
21757 # type: textblock
21758 #. type: textblock
21759 #: ../fish/guestfish.pod:558
21760 msgid "The size in SI 10**12 byte units."
21761 msgstr ""
21762
21763 # type: =item
21764 #. type: =item
21765 #: ../fish/guestfish.pod:560
21766 msgid "B<P> or B<PiB>"
21767 msgstr ""
21768
21769 # type: textblock
21770 #. type: textblock
21771 #: ../fish/guestfish.pod:562
21772 msgid "The size in petabytes (multiplied by 2**50)."
21773 msgstr ""
21774
21775 # type: =item
21776 #. type: =item
21777 #: ../fish/guestfish.pod:564
21778 msgid "B<PB>"
21779 msgstr ""
21780
21781 # type: textblock
21782 #. type: textblock
21783 #: ../fish/guestfish.pod:566
21784 msgid "The size in SI 10**15 byte units."
21785 msgstr ""
21786
21787 # type: =item
21788 #. type: =item
21789 #: ../fish/guestfish.pod:568
21790 msgid "B<E> or B<EiB>"
21791 msgstr ""
21792
21793 # type: textblock
21794 #. type: textblock
21795 #: ../fish/guestfish.pod:570
21796 msgid "The size in exabytes (multiplied by 2**60)."
21797 msgstr ""
21798
21799 # type: =item
21800 #. type: =item
21801 #: ../fish/guestfish.pod:572
21802 msgid "B<EB>"
21803 msgstr ""
21804
21805 # type: textblock
21806 #. type: textblock
21807 #: ../fish/guestfish.pod:574
21808 msgid "The size in SI 10**18 byte units."
21809 msgstr ""
21810
21811 # type: =item
21812 #. type: =item
21813 #: ../fish/guestfish.pod:576
21814 msgid "B<Z> or B<ZiB>"
21815 msgstr ""
21816
21817 # type: textblock
21818 #. type: textblock
21819 #: ../fish/guestfish.pod:578
21820 msgid "The size in zettabytes (multiplied by 2**70)."
21821 msgstr ""
21822
21823 # type: =item
21824 #. type: =item
21825 #: ../fish/guestfish.pod:580
21826 msgid "B<ZB>"
21827 msgstr ""
21828
21829 # type: textblock
21830 #. type: textblock
21831 #: ../fish/guestfish.pod:582
21832 msgid "The size in SI 10**21 byte units."
21833 msgstr ""
21834
21835 # type: =item
21836 #. type: =item
21837 #: ../fish/guestfish.pod:584
21838 msgid "B<Y> or B<YiB>"
21839 msgstr ""
21840
21841 # type: textblock
21842 #. type: textblock
21843 #: ../fish/guestfish.pod:586
21844 msgid "The size in yottabytes (multiplied by 2**80)."
21845 msgstr ""
21846
21847 # type: =item
21848 #. type: =item
21849 #: ../fish/guestfish.pod:588
21850 msgid "B<YB>"
21851 msgstr ""
21852
21853 # type: textblock
21854 #. type: textblock
21855 #: ../fish/guestfish.pod:590
21856 msgid "The size in SI 10**24 byte units."
21857 msgstr ""
21858
21859 # type: verbatim
21860 #. type: verbatim
21861 #: ../fish/guestfish.pod:596
21862 #, no-wrap
21863 msgid ""
21864 " truncate-size /file 1G\n"
21865 "\n"
21866 msgstr ""
21867
21868 # type: textblock
21869 #. type: textblock
21870 #: ../fish/guestfish.pod:598
21871 msgid "would truncate the file to 1 gigabyte."
21872 msgstr ""
21873
21874 # type: textblock
21875 #. type: textblock
21876 #: ../fish/guestfish.pod:600
21877 msgid ""
21878 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
21879 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
21880 "suffix will probably not do what you expect."
21881 msgstr ""
21882
21883 # type: =head2
21884 #. type: =head2
21885 #: ../fish/guestfish.pod:604
21886 msgid "OCTAL AND HEXADECIMAL NUMBERS"
21887 msgstr ""
21888
21889 # type: textblock
21890 #. type: textblock
21891 #: ../fish/guestfish.pod:606
21892 msgid ""
21893 "For specifying the radix (base) use the C convention: C<0> to prefix an "
21894 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
21895 msgstr ""
21896
21897 # type: verbatim
21898 #. type: verbatim
21899 #: ../fish/guestfish.pod:609
21900 #, no-wrap
21901 msgid ""
21902 " 1234      decimal number 1234\n"
21903 " 02322     octal number, equivalent to decimal 1234\n"
21904 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
21905 "\n"
21906 msgstr ""
21907
21908 # type: textblock
21909 #. type: textblock
21910 #: ../fish/guestfish.pod:613
21911 msgid ""
21912 "When using the C<chmod> command, you almost always want to specify an octal "
21913 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
21914 "L<chmod(1)> program):"
21915 msgstr ""
21916
21917 # type: verbatim
21918 #. type: verbatim
21919 #: ../fish/guestfish.pod:617
21920 #, no-wrap
21921 msgid ""
21922 " chmod 0777 /public  # OK\n"
21923 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
21924 "\n"
21925 msgstr ""
21926
21927 # type: textblock
21928 #. type: textblock
21929 #: ../fish/guestfish.pod:620
21930 msgid ""
21931 "Commands that return numbers usually print them in decimal, but some "
21932 "commands print numbers in other radices (eg. C<umask> prints the mode in "
21933 "octal, preceeded by C<0>)."
21934 msgstr ""
21935
21936 # type: =head1
21937 #. type: =head1
21938 #: ../fish/guestfish.pod:624
21939 msgid "WILDCARDS AND GLOBBING"
21940 msgstr ""
21941
21942 # type: textblock
21943 #. type: textblock
21944 #: ../fish/guestfish.pod:626
21945 msgid ""
21946 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
21947 "(globbing) by default.  So for example the following will not do what you "
21948 "expect:"
21949 msgstr ""
21950
21951 # type: verbatim
21952 #. type: verbatim
21953 #: ../fish/guestfish.pod:630
21954 #, no-wrap
21955 msgid ""
21956 " rm-rf /home/*\n"
21957 "\n"
21958 msgstr ""
21959
21960 # type: textblock
21961 #. type: textblock
21962 #: ../fish/guestfish.pod:632
21963 msgid ""
21964 "Assuming you don't have a directory called literally C</home/*> then the "
21965 "above command will return an error."
21966 msgstr ""
21967
21968 # type: textblock
21969 #. type: textblock
21970 #: ../fish/guestfish.pod:635
21971 msgid "To perform wildcard expansion, use the C<glob> command."
21972 msgstr ""
21973
21974 # type: verbatim
21975 #. type: verbatim
21976 #: ../fish/guestfish.pod:637
21977 #, no-wrap
21978 msgid ""
21979 " glob rm-rf /home/*\n"
21980 "\n"
21981 msgstr ""
21982
21983 # type: textblock
21984 #. type: textblock
21985 #: ../fish/guestfish.pod:639
21986 msgid ""
21987 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
21988 "many times), equivalent to:"
21989 msgstr ""
21990
21991 # type: verbatim
21992 #. type: verbatim
21993 #: ../fish/guestfish.pod:642
21994 #, no-wrap
21995 msgid ""
21996 " rm-rf /home/jim\n"
21997 " rm-rf /home/joe\n"
21998 " rm-rf /home/mary\n"
21999 "\n"
22000 msgstr ""
22001
22002 # type: textblock
22003 #. type: textblock
22004 #: ../fish/guestfish.pod:646
22005 msgid "C<glob> only works on simple guest paths and not on device names."
22006 msgstr ""
22007
22008 # type: textblock
22009 #. type: textblock
22010 #: ../fish/guestfish.pod:648
22011 msgid ""
22012 "If you have several parameters, each containing a wildcard, then glob will "
22013 "perform a Cartesian product."
22014 msgstr ""
22015
22016 # type: =head1
22017 #. type: =head1
22018 #: ../fish/guestfish.pod:651
22019 msgid "COMMENTS"
22020 msgstr ""
22021
22022 # type: textblock
22023 #. type: textblock
22024 #: ../fish/guestfish.pod:653
22025 msgid ""
22026 "Any line which starts with a I<#> character is treated as a comment and "
22027 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
22028 "a command.  For example:"
22029 msgstr ""
22030
22031 # type: verbatim
22032 #. type: verbatim
22033 #: ../fish/guestfish.pod:657
22034 #, no-wrap
22035 msgid ""
22036 " # this is a comment\n"
22037 "         # this is a comment\n"
22038 " foo # NOT a comment\n"
22039 "\n"
22040 msgstr ""
22041
22042 # type: textblock
22043 #. type: textblock
22044 #: ../fish/guestfish.pod:661
22045 msgid "Blank lines are also ignored."
22046 msgstr ""
22047
22048 # type: =head1
22049 #. type: =head1
22050 #: ../fish/guestfish.pod:663
22051 msgid "RUNNING COMMANDS LOCALLY"
22052 msgstr ""
22053
22054 # type: textblock
22055 #. type: textblock
22056 #: ../fish/guestfish.pod:665
22057 msgid ""
22058 "Any line which starts with a I<!> character is treated as a command sent to "
22059 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
22060 msgstr ""
22061
22062 # type: verbatim
22063 #. type: verbatim
22064 #: ../fish/guestfish.pod:669
22065 #, no-wrap
22066 msgid ""
22067 " !mkdir local\n"
22068 " tgz-out /remote local/remote-data.tar.gz\n"
22069 "\n"
22070 msgstr ""
22071
22072 # type: textblock
22073 #. type: textblock
22074 #: ../fish/guestfish.pod:672
22075 msgid ""
22076 "will create a directory C<local> on the host, and then export the contents "
22077 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
22078 "(See C<tgz-out>)."
22079 msgstr ""
22080
22081 # type: textblock
22082 #. type: textblock
22083 #: ../fish/guestfish.pod:676
22084 msgid ""
22085 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
22086 "effect, due to the way that subprocesses work in Unix."
22087 msgstr ""
22088
22089 # type: =head1
22090 #. type: =head1
22091 #: ../fish/guestfish.pod:679
22092 msgid "PIPES"
22093 msgstr ""
22094
22095 # type: textblock
22096 #. type: textblock
22097 #: ../fish/guestfish.pod:681
22098 msgid ""
22099 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
22100 "command (a guestfish command) to the second command (any host command).  For "
22101 "example:"
22102 msgstr ""
22103
22104 # type: verbatim
22105 #. type: verbatim
22106 #: ../fish/guestfish.pod:685
22107 #, no-wrap
22108 msgid ""
22109 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
22110 "\n"
22111 msgstr ""
22112
22113 # type: textblock
22114 #. type: textblock
22115 #: ../fish/guestfish.pod:687
22116 msgid ""
22117 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
22118 "program).  The above command would list all accounts in the guest filesystem "
22119 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
22120 msgstr ""
22121
22122 # type: verbatim
22123 #. type: verbatim
22124 #: ../fish/guestfish.pod:692
22125 #, no-wrap
22126 msgid ""
22127 " hexdump /bin/ls | head\n"
22128 " list-devices | tail -1\n"
22129 " tgz-out / - | tar ztf -\n"
22130 "\n"
22131 msgstr ""
22132
22133 # type: textblock
22134 #. type: textblock
22135 #: ../fish/guestfish.pod:696
22136 msgid ""
22137 "The space before the pipe symbol is required, any space after the pipe "
22138 "symbol is optional.  Everything after the pipe symbol is just passed "
22139 "straight to the host shell, so it can contain redirections, globs and "
22140 "anything else that makes sense on the host side."
22141 msgstr ""
22142
22143 # type: textblock
22144 #. type: textblock
22145 #: ../fish/guestfish.pod:701
22146 msgid ""
22147 "To use a literal argument which begins with a pipe symbol, you have to quote "
22148 "it, eg:"
22149 msgstr ""
22150
22151 # type: verbatim
22152 #. type: verbatim
22153 #: ../fish/guestfish.pod:704
22154 #, no-wrap
22155 msgid ""
22156 " echo \"|\"\n"
22157 "\n"
22158 msgstr ""
22159
22160 # type: =head1
22161 #. type: =head1
22162 #: ../fish/guestfish.pod:706
22163 msgid "HOME DIRECTORIES"
22164 msgstr ""
22165
22166 # type: textblock
22167 #. type: textblock
22168 #: ../fish/guestfish.pod:708
22169 msgid ""
22170 "If a parameter starts with the character C<~> then the tilde may be expanded "
22171 "as a home directory path (either C<~> for the current user's home directory, "
22172 "or C<~user> for another user)."
22173 msgstr ""
22174
22175 # type: textblock
22176 #. type: textblock
22177 #: ../fish/guestfish.pod:712
22178 msgid ""
22179 "Note that home directory expansion happens for users known I<on the host>, "
22180 "not in the guest filesystem."
22181 msgstr ""
22182
22183 # type: textblock
22184 #. type: textblock
22185 #: ../fish/guestfish.pod:715
22186 msgid ""
22187 "To use a literal argument which begins with a tilde, you have to quote it, "
22188 "eg:"
22189 msgstr ""
22190
22191 # type: verbatim
22192 #. type: verbatim
22193 #: ../fish/guestfish.pod:718
22194 #, no-wrap
22195 msgid ""
22196 " echo \"~\"\n"
22197 "\n"
22198 msgstr ""
22199
22200 # type: textblock
22201 #. type: textblock
22202 #: ../fish/guestfish.pod:722
22203 msgid ""
22204 "Libguestfs has some support for Linux guests encrypted according to the "
22205 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
22206 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
22207 "LUKS is supported."
22208 msgstr ""
22209
22210 # type: textblock
22211 #. type: textblock
22212 #: ../fish/guestfish.pod:727
22213 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
22214 msgstr ""
22215
22216 # type: verbatim
22217 #. type: verbatim
22218 #: ../fish/guestfish.pod:729
22219 #, no-wrap
22220 msgid ""
22221 " ><fs> vfs-type /dev/sda2\n"
22222 " crypto_LUKS\n"
22223 "\n"
22224 msgstr ""
22225
22226 # type: textblock
22227 #. type: textblock
22228 #: ../fish/guestfish.pod:732
22229 msgid ""
22230 "Then open those devices using L</luks-open>.  This creates a device-mapper "
22231 "device called C</dev/mapper/luksdev>."
22232 msgstr ""
22233
22234 # type: verbatim
22235 #. type: verbatim
22236 #: ../fish/guestfish.pod:735
22237 #, no-wrap
22238 msgid ""
22239 " ><fs> luks-open /dev/sda2 luksdev\n"
22240 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
22241 "\n"
22242 msgstr ""
22243
22244 # type: textblock
22245 #. type: textblock
22246 #: ../fish/guestfish.pod:738
22247 msgid ""
22248 "Finally you have to tell LVM to scan for volume groups on the newly created "
22249 "mapper device:"
22250 msgstr ""
22251
22252 # type: verbatim
22253 #. type: verbatim
22254 #: ../fish/guestfish.pod:741
22255 #, no-wrap
22256 msgid ""
22257 " vgscan\n"
22258 " vg-activate-all true\n"
22259 "\n"
22260 msgstr ""
22261
22262 # type: textblock
22263 #. type: textblock
22264 #: ../fish/guestfish.pod:744
22265 msgid "The logical volume(s) can now be mounted in the usual way."
22266 msgstr ""
22267
22268 # type: textblock
22269 #. type: textblock
22270 #: ../fish/guestfish.pod:746
22271 msgid ""
22272 "Before closing a LUKS device you must unmount any logical volumes on it and "
22273 "deactivate the volume groups by calling C<vg-activate false VG> on each "
22274 "one.  Then you can close the mapper device:"
22275 msgstr ""
22276
22277 # type: verbatim
22278 #. type: verbatim
22279 #: ../fish/guestfish.pod:750
22280 #, no-wrap
22281 msgid ""
22282 " vg-activate false /dev/VG\n"
22283 " luks-close /dev/mapper/luksdev\n"
22284 "\n"
22285 msgstr ""
22286
22287 # type: =head1
22288 #. type: =head1
22289 #: ../fish/guestfish.pod:753
22290 msgid "WINDOWS PATHS"
22291 msgstr ""
22292
22293 # type: textblock
22294 #. type: textblock
22295 #: ../fish/guestfish.pod:755
22296 msgid ""
22297 "If a path is prefixed with C<win:> then you can use Windows-style paths "
22298 "(with some limitations).  The following commands are equivalent:"
22299 msgstr ""
22300
22301 # type: verbatim
22302 #. type: verbatim
22303 #: ../fish/guestfish.pod:758
22304 #, no-wrap
22305 msgid ""
22306 " file /WINDOWS/system32/config/system.LOG\n"
22307 "\n"
22308 msgstr ""
22309
22310 # type: verbatim
22311 #. type: verbatim
22312 #: ../fish/guestfish.pod:760
22313 #, no-wrap
22314 msgid ""
22315 " file win:/windows/system32/config/system.log\n"
22316 "\n"
22317 msgstr ""
22318
22319 # type: verbatim
22320 #. type: verbatim
22321 #: ../fish/guestfish.pod:762
22322 #, no-wrap
22323 msgid ""
22324 " file win:\\windows\\system32\\config\\system.log\n"
22325 "\n"
22326 msgstr ""
22327
22328 # type: verbatim
22329 #. type: verbatim
22330 #: ../fish/guestfish.pod:764
22331 #, no-wrap
22332 msgid ""
22333 " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n"
22334 "\n"
22335 msgstr ""
22336
22337 # type: textblock
22338 #. type: textblock
22339 #: ../fish/guestfish.pod:766
22340 msgid ""
22341 "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also "
22342 "handles case insensitivity like Windows would.  This only works in argument "
22343 "positions that expect a path."
22344 msgstr ""
22345
22346 # type: =head1
22347 #. type: =head1
22348 #: ../fish/guestfish.pod:770
22349 msgid "UPLOADING AND DOWNLOADING FILES"
22350 msgstr ""
22351
22352 # type: textblock
22353 #. type: textblock
22354 #: ../fish/guestfish.pod:772
22355 msgid ""
22356 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
22357 "others which upload from or download to a local file, you can use the "
22358 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
22359 msgstr ""
22360
22361 # type: verbatim
22362 #. type: verbatim
22363 #: ../fish/guestfish.pod:776
22364 #, no-wrap
22365 msgid ""
22366 " upload - /foo\n"
22367 "\n"
22368 msgstr ""
22369
22370 # type: textblock
22371 #. type: textblock
22372 #: ../fish/guestfish.pod:778
22373 msgid ""
22374 "reads stdin and creates from that a file C</foo> in the disk image, and:"
22375 msgstr ""
22376
22377 # type: verbatim
22378 #. type: verbatim
22379 #: ../fish/guestfish.pod:781
22380 #, no-wrap
22381 msgid ""
22382 " tar-out /etc - | tar tf -\n"
22383 "\n"
22384 msgstr ""
22385
22386 # type: textblock
22387 #. type: textblock
22388 #: ../fish/guestfish.pod:783
22389 msgid ""
22390 "writes the tarball to stdout and then pipes that into the external \"tar\" "
22391 "command (see L</PIPES>)."
22392 msgstr ""
22393
22394 # type: textblock
22395 #. type: textblock
22396 #: ../fish/guestfish.pod:786
22397 msgid ""
22398 "When using C<-> to read from stdin, the input is read up to the end of "
22399 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
22400 "some arbitrary end marker:"
22401 msgstr ""
22402
22403 # type: verbatim
22404 #. type: verbatim
22405 #: ../fish/guestfish.pod:790
22406 #, no-wrap
22407 msgid ""
22408 " upload -<<END /foo\n"
22409 " input line 1\n"
22410 " input line 2\n"
22411 " input line 3\n"
22412 " END\n"
22413 "\n"
22414 msgstr ""
22415
22416 # type: textblock
22417 #. type: textblock
22418 #: ../fish/guestfish.pod:796
22419 msgid ""
22420 "Any string of characters can be used instead of C<END>.  The end marker must "
22421 "appear on a line of its own, without any preceeding or following characters "
22422 "(not even spaces)."
22423 msgstr ""
22424
22425 # type: textblock
22426 #. type: textblock
22427 #: ../fish/guestfish.pod:800
22428 msgid ""
22429 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
22430 "upload local files (so-called \"FileIn\" parameters in the generator)."
22431 msgstr ""
22432
22433 # type: =head1
22434 #. type: =head1
22435 #: ../fish/guestfish.pod:803
22436 msgid "EXIT ON ERROR BEHAVIOUR"
22437 msgstr ""
22438
22439 # type: textblock
22440 #. type: textblock
22441 #: ../fish/guestfish.pod:805
22442 msgid ""
22443 "By default, guestfish will ignore any errors when in interactive mode (ie. "
22444 "taking commands from a human over a tty), and will exit on the first error "
22445 "in non-interactive mode (scripts, commands given on the command line)."
22446 msgstr ""
22447
22448 # type: textblock
22449 #. type: textblock
22450 #: ../fish/guestfish.pod:810
22451 msgid ""
22452 "If you prefix a command with a I<-> character, then that command will not "
22453 "cause guestfish to exit, even if that (one) command returns an error."
22454 msgstr ""
22455
22456 # type: =head1
22457 #. type: =head1
22458 #: ../fish/guestfish.pod:814
22459 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
22460 msgstr ""
22461
22462 # type: textblock
22463 #. type: textblock
22464 #: ../fish/guestfish.pod:816
22465 msgid ""
22466 "Guestfish can be remote-controlled over a socket.  This is useful "
22467 "particularly in shell scripts where you want to make several different "
22468 "changes to a filesystem, but you don't want the overhead of starting up a "
22469 "guestfish process each time."
22470 msgstr ""
22471
22472 # type: textblock
22473 #. type: textblock
22474 #: ../fish/guestfish.pod:821
22475 msgid "Start a guestfish server process using:"
22476 msgstr ""
22477
22478 # type: verbatim
22479 #. type: verbatim
22480 #: ../fish/guestfish.pod:823
22481 #, no-wrap
22482 msgid ""
22483 " eval \"`guestfish --listen`\"\n"
22484 "\n"
22485 msgstr ""
22486
22487 # type: textblock
22488 #. type: textblock
22489 #: ../fish/guestfish.pod:825
22490 msgid "and then send it commands by doing:"
22491 msgstr ""
22492
22493 # type: verbatim
22494 #. type: verbatim
22495 #: ../fish/guestfish.pod:827
22496 #, no-wrap
22497 msgid ""
22498 " guestfish --remote cmd [...]\n"
22499 "\n"
22500 msgstr ""
22501
22502 # type: textblock
22503 #. type: textblock
22504 #: ../fish/guestfish.pod:829
22505 msgid "To cause the server to exit, send it the exit command:"
22506 msgstr ""
22507
22508 # type: verbatim
22509 #. type: verbatim
22510 #: ../fish/guestfish.pod:831
22511 #, no-wrap
22512 msgid ""
22513 " guestfish --remote exit\n"
22514 "\n"
22515 msgstr ""
22516
22517 # type: textblock
22518 #. type: textblock
22519 #: ../fish/guestfish.pod:833
22520 msgid ""
22521 "Note that the server will normally exit if there is an error in a command.  "
22522 "You can change this in the usual way.  See section L</EXIT ON ERROR "
22523 "BEHAVIOUR>."
22524 msgstr ""
22525
22526 # type: =head2
22527 #. type: =head2
22528 #: ../fish/guestfish.pod:837
22529 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
22530 msgstr ""
22531
22532 # type: textblock
22533 #. type: textblock
22534 #: ../fish/guestfish.pod:839
22535 msgid ""
22536 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
22537 "is how the I<--remote> option knows where to send the commands.  You can "
22538 "have several guestfish listener processes running using:"
22539 msgstr ""
22540
22541 # type: verbatim
22542 #. type: verbatim
22543 #: ../fish/guestfish.pod:843
22544 #, no-wrap
22545 msgid ""
22546 " eval \"`guestfish --listen`\"\n"
22547 " pid1=$GUESTFISH_PID\n"
22548 " eval \"`guestfish --listen`\"\n"
22549 " pid2=$GUESTFISH_PID\n"
22550 " ...\n"
22551 " guestfish --remote=$pid1 cmd\n"
22552 " guestfish --remote=$pid2 cmd\n"
22553 "\n"
22554 msgstr ""
22555
22556 # type: =head2
22557 #. type: =head2
22558 #: ../fish/guestfish.pod:851
22559 msgid "REMOTE CONTROL AND CSH"
22560 msgstr ""
22561
22562 # type: textblock
22563 #. type: textblock
22564 #: ../fish/guestfish.pod:853
22565 msgid ""
22566 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
22567 "option:"
22568 msgstr ""
22569
22570 # type: verbatim
22571 #. type: verbatim
22572 #: ../fish/guestfish.pod:856
22573 #, no-wrap
22574 msgid ""
22575 " eval \"`guestfish --listen --csh`\"\n"
22576 "\n"
22577 msgstr ""
22578
22579 # type: =head2
22580 #. type: =head2
22581 #: ../fish/guestfish.pod:858
22582 msgid "REMOTE CONTROL DETAILS"
22583 msgstr ""
22584
22585 # type: textblock
22586 #. type: textblock
22587 #: ../fish/guestfish.pod:860
22588 msgid ""
22589 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
22590 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
22591 "and C<$PID> is the process ID of the server."
22592 msgstr ""
22593
22594 # type: textblock
22595 #. type: textblock
22596 #: ../fish/guestfish.pod:864
22597 msgid "Guestfish client and server versions must match exactly."
22598 msgstr ""
22599
22600 # type: =head1
22601 #. type: =head1
22602 #: ../fish/guestfish.pod:866
22603 msgid "PREPARED DISK IMAGES"
22604 msgstr ""
22605
22606 # type: textblock
22607 #. type: textblock
22608 #: ../fish/guestfish.pod:868
22609 msgid ""
22610 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
22611 "preformatted disk images that guestfish can make for you to save typing.  "
22612 "This is particularly useful for testing purposes.  This option is used "
22613 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
22614 "can be mixed with I<-a>)."
22615 msgstr ""
22616
22617 # type: textblock
22618 #. type: textblock
22619 #: ../fish/guestfish.pod:874
22620 msgid ""
22621 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
22622 "the second and so on.  Existing files in the current directory are "
22623 "I<overwritten>."
22624 msgstr ""
22625
22626 # type: textblock
22627 #. type: textblock
22628 #: ../fish/guestfish.pod:878
22629 msgid ""
22630 "The type briefly describes how the disk should be sized, partitioned, how "
22631 "filesystem(s) should be created, and how content should be added.  "
22632 "Optionally the type can be followed by extra parameters, separated by C<:> "
22633 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
22634 "allocated disk, containing a single partition, with the partition formatted "
22635 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
22636 "disk instead."
22637 msgstr ""
22638
22639 # type: textblock
22640 #. type: textblock
22641 #: ../fish/guestfish.pod:886
22642 msgid "To list the available types and any extra parameters they take, run:"
22643 msgstr ""
22644
22645 # type: textblock
22646 #. type: textblock
22647 #: ../fish/guestfish.pod:890
22648 msgid ""
22649 "Note that the prepared filesystem is not mounted.  You would usually have to "
22650 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
22651 msgstr ""
22652
22653 # type: textblock
22654 #. type: textblock
22655 #: ../fish/guestfish.pod:894
22656 msgid ""
22657 "If any I<-N> or I<--new> options are given, the guest is automatically "
22658 "launched."
22659 msgstr ""
22660
22661 # type: textblock
22662 #. type: textblock
22663 #: ../fish/guestfish.pod:899
22664 msgid "Create a 100MB disk with an ext4-formatted partition:"
22665 msgstr ""
22666
22667 # type: verbatim
22668 #. type: verbatim
22669 #: ../fish/guestfish.pod:901
22670 #, no-wrap
22671 msgid ""
22672 " guestfish -N fs:ext4\n"
22673 "\n"
22674 msgstr ""
22675
22676 # type: textblock
22677 #. type: textblock
22678 #: ../fish/guestfish.pod:903
22679 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
22680 msgstr ""
22681
22682 # type: verbatim
22683 #. type: verbatim
22684 #: ../fish/guestfish.pod:905
22685 #, no-wrap
22686 msgid ""
22687 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
22688 "\n"
22689 msgstr ""
22690
22691 # type: textblock
22692 #. type: textblock
22693 #: ../fish/guestfish.pod:907
22694 msgid "Create a blank 200MB disk:"
22695 msgstr ""
22696
22697 # type: verbatim
22698 #. type: verbatim
22699 #: ../fish/guestfish.pod:909
22700 #, no-wrap
22701 msgid ""
22702 " guestfish -N disk:200M\n"
22703 "\n"
22704 msgstr ""
22705
22706 # type: =head1
22707 #. type: =head1
22708 #: ../fish/guestfish.pod:911
22709 msgid "PROGRESS BARS"
22710 msgstr ""
22711
22712 # type: textblock
22713 #. type: textblock
22714 #: ../fish/guestfish.pod:913
22715 msgid ""
22716 "Some (not all) long-running commands send progress notification messages as "
22717 "they are running.  Guestfish turns these messages into progress bars."
22718 msgstr ""
22719
22720 # type: textblock
22721 #. type: textblock
22722 #: ../fish/guestfish.pod:917
22723 msgid ""
22724 "When a command that supports progress bars takes longer than two seconds to "
22725 "run, and if progress bars are enabled, then you will see one appearing below "
22726 "the command:"
22727 msgstr ""
22728
22729 # type: verbatim
22730 #. type: verbatim
22731 #: ../fish/guestfish.pod:921
22732 #, no-wrap
22733 msgid ""
22734 " ><fs> copy-size /large-file /another-file 2048M\n"
22735 " / 10% [#####-----------------------------------------] 00:30\n"
22736 "\n"
22737 msgstr ""
22738
22739 # type: textblock
22740 #. type: textblock
22741 #: ../fish/guestfish.pod:924
22742 msgid ""
22743 "The spinner on the left hand side moves round once for every progress "
22744 "notification received from the backend.  This is a (reasonably) golden "
22745 "assurance that the command is \"doing something\" even if the progress bar "
22746 "is not moving, because the command is able to send the progress "
22747 "notifications.  When the bar reaches 100% and the command finishes, the "
22748 "spinner disappears."
22749 msgstr ""
22750
22751 # type: textblock
22752 #. type: textblock
22753 #: ../fish/guestfish.pod:931
22754 msgid ""
22755 "Progress bars are enabled by default when guestfish is used interactively.  "
22756 "You can enable them even for non-interactive modes using I<--progress-bars>, "
22757 "and you can disable them completely using I<--no-progress-bars>."
22758 msgstr ""
22759
22760 # type: =head1
22761 #. type: =head1
22762 #: ../fish/guestfish.pod:936
22763 msgid "GUESTFISH COMMANDS"
22764 msgstr ""
22765
22766 # type: textblock
22767 #. type: textblock
22768 #: ../fish/guestfish.pod:938
22769 msgid ""
22770 "The commands in this section are guestfish convenience commands, in other "
22771 "words, they are not part of the L<guestfs(3)> API."
22772 msgstr ""
22773
22774 # type: =head2
22775 #. type: =head2
22776 #: ../fish/guestfish.pod:941
22777 msgid "help"
22778 msgstr ""
22779
22780 # type: verbatim
22781 #. type: verbatim
22782 #: ../fish/guestfish.pod:943
22783 #, no-wrap
22784 msgid ""
22785 " help\n"
22786 " help cmd\n"
22787 "\n"
22788 msgstr ""
22789
22790 # type: textblock
22791 #. type: textblock
22792 #: ../fish/guestfish.pod:946
22793 msgid "Without any parameter, this provides general help."
22794 msgstr ""
22795
22796 # type: textblock
22797 #. type: textblock
22798 #: ../fish/guestfish.pod:948
22799 msgid "With a C<cmd> parameter, this displays detailed help for that command."
22800 msgstr ""
22801
22802 # type: =head2
22803 #. type: =head2
22804 #: ../fish/guestfish.pod:950
22805 msgid "quit | exit"
22806 msgstr ""
22807
22808 # type: textblock
22809 #. type: textblock
22810 #: ../fish/guestfish.pod:952
22811 msgid "This exits guestfish.  You can also use C<^D> key."
22812 msgstr ""
22813
22814 # type: textblock
22815 #. type: textblock
22816 #: ../fish/guestfish.pod:954
22817 msgid "@FISH_COMMANDS@"
22818 msgstr ""
22819
22820 # type: =head1
22821 #. type: =head1
22822 #: ../fish/guestfish.pod:956
22823 msgid "COMMANDS"
22824 msgstr ""
22825
22826 # type: =head1
22827 #. type: =head1
22828 #: ../fish/guestfish.pod:960 ../test-tool/libguestfs-test-tool.pod:83
22829 msgid "EXIT CODE"
22830 msgstr ""
22831
22832 # type: textblock
22833 #. type: textblock
22834 #: ../fish/guestfish.pod:962
22835 msgid ""
22836 "guestfish returns 0 if the commands completed without error, or 1 if there "
22837 "was an error."
22838 msgstr ""
22839
22840 # type: =item
22841 #. type: =item
22842 #: ../fish/guestfish.pod:969
22843 msgid "EDITOR"
22844 msgstr ""
22845
22846 # type: textblock
22847 #. type: textblock
22848 #: ../fish/guestfish.pod:971
22849 msgid ""
22850 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
22851 "C<vi>."
22852 msgstr ""
22853
22854 # type: =item
22855 #. type: =item
22856 #: ../fish/guestfish.pod:974
22857 msgid "GUESTFISH_PID"
22858 msgstr ""
22859
22860 # type: textblock
22861 #. type: textblock
22862 #: ../fish/guestfish.pod:976
22863 msgid ""
22864 "Used with the I<--remote> option to specify the remote guestfish process to "
22865 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
22866 msgstr ""
22867
22868 # type: =item
22869 #. type: =item
22870 #: ../fish/guestfish.pod:980
22871 msgid "HEXEDITOR"
22872 msgstr ""
22873
22874 # type: textblock
22875 #. type: textblock
22876 #: ../fish/guestfish.pod:982
22877 msgid ""
22878 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
22879 "not specified, the external L<hexedit(1)> program is used."
22880 msgstr ""
22881
22882 # type: =item
22883 #. type: =item
22884 #: ../fish/guestfish.pod:986
22885 msgid "HOME"
22886 msgstr ""
22887
22888 # type: textblock
22889 #. type: textblock
22890 #: ../fish/guestfish.pod:988
22891 msgid ""
22892 "If compiled with GNU readline support, various files in the home directory "
22893 "can be used.  See L</FILES>."
22894 msgstr ""
22895
22896 # type: textblock
22897 #. type: textblock
22898 #: ../fish/guestfish.pod:997
22899 msgid ""
22900 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
22901 "effect as using the B<-v> option."
22902 msgstr ""
22903
22904 # type: textblock
22905 #. type: textblock
22906 #: ../fish/guestfish.pod:1009
22907 msgid ""
22908 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
22909 "the discussion of paths in L<guestfs(3)>."
22910 msgstr ""
22911
22912 # type: textblock
22913 #. type: textblock
22914 #: ../fish/guestfish.pod:1020
22915 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
22916 msgstr ""
22917
22918 # type: =item
22919 #. type: =item
22920 #: ../fish/guestfish.pod:1022
22921 msgid "PAGER"
22922 msgstr ""
22923
22924 # type: textblock
22925 #. type: textblock
22926 #: ../fish/guestfish.pod:1024
22927 msgid ""
22928 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
22929 "C<more>."
22930 msgstr ""
22931
22932 # type: =head1
22933 #. type: =head1
22934 #: ../fish/guestfish.pod:1039 ../test-tool/libguestfs-test-tool.pod:88
22935 msgid "FILES"
22936 msgstr ""
22937
22938 # type: =item
22939 #. type: =item
22940 #: ../fish/guestfish.pod:1043
22941 msgid "$HOME/.guestfish"
22942 msgstr ""
22943
22944 # type: textblock
22945 #. type: textblock
22946 #: ../fish/guestfish.pod:1045
22947 msgid ""
22948 "If compiled with GNU readline support, then the command history is saved in "
22949 "this file."
22950 msgstr ""
22951
22952 # type: =item
22953 #. type: =item
22954 #: ../fish/guestfish.pod:1048
22955 msgid "$HOME/.inputrc"
22956 msgstr ""
22957
22958 # type: =item
22959 #. type: =item
22960 #: ../fish/guestfish.pod:1050
22961 msgid "/etc/inputrc"
22962 msgstr ""
22963
22964 # type: textblock
22965 #. type: textblock
22966 #: ../fish/guestfish.pod:1052
22967 msgid ""
22968 "If compiled with GNU readline support, then these files can be used to "
22969 "configure readline.  For further information, please see L<readline(3)/"
22970 "INITIALIZATION FILE>."
22971 msgstr ""
22972
22973 # type: textblock
22974 #. type: textblock
22975 #: ../fish/guestfish.pod:1056
22976 msgid "To write rules which only apply to guestfish, use:"
22977 msgstr ""
22978
22979 # type: verbatim
22980 #. type: verbatim
22981 #: ../fish/guestfish.pod:1058
22982 #, no-wrap
22983 msgid ""
22984 " $if guestfish\n"
22985 " ...\n"
22986 " $endif\n"
22987 "\n"
22988 msgstr ""
22989
22990 # type: textblock
22991 #. type: textblock
22992 #: ../fish/guestfish.pod:1062
22993 msgid ""
22994 "Variables that you can set in inputrc that change the behaviour of guestfish "
22995 "in useful ways include:"
22996 msgstr ""
22997
22998 # type: =item
22999 #. type: =item
23000 #: ../fish/guestfish.pod:1067
23001 msgid "completion-ignore-case (default: on)"
23002 msgstr ""
23003
23004 # type: textblock
23005 #. type: textblock
23006 #: ../fish/guestfish.pod:1069
23007 msgid ""
23008 "By default, guestfish will ignore case when tab-completing paths on the "
23009 "disk.  Use:"
23010 msgstr ""
23011
23012 # type: verbatim
23013 #. type: verbatim
23014 #: ../fish/guestfish.pod:1072
23015 #, no-wrap
23016 msgid ""
23017 " set completion-ignore-case off\n"
23018 "\n"
23019 msgstr ""
23020
23021 # type: textblock
23022 #. type: textblock
23023 #: ../fish/guestfish.pod:1074
23024 msgid "to make guestfish case sensitive."
23025 msgstr ""
23026
23027 # type: =item
23028 #. type: =item
23029 #: ../fish/guestfish.pod:1078
23030 msgid "test1.img"
23031 msgstr ""
23032
23033 # type: =item
23034 #. type: =item
23035 #: ../fish/guestfish.pod:1080
23036 msgid "test2.img (etc)"
23037 msgstr ""
23038
23039 # type: textblock
23040 #. type: textblock
23041 #: ../fish/guestfish.pod:1082
23042 msgid ""
23043 "When using the C<-N> or C<--new> option, the prepared disk or filesystem "
23044 "will be created in the file C<test1.img> in the current directory.  The "
23045 "second use of C<-N> will use C<test2.img> and so on.  Any existing file with "
23046 "the same name will be overwritten."
23047 msgstr ""
23048
23049 # type: textblock
23050 #. type: textblock
23051 #: ../fish/guestfish.pod:1091
23052 msgid ""
23053 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-df(1)>, "
23054 "L<virt-edit(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-"
23055 "filesystems(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)"
23056 ">, L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<virt-win-reg(1)>, "
23057 "L<hexedit(1)>."
23058 msgstr ""
23059
23060 # type: textblock
23061 #. type: textblock
23062 #: ../fish/guestfish.pod:1117 ../test-tool/libguestfs-test-tool.pod:124
23063 #: ../fuse/guestmount.pod:253 ../tools/virt-edit.pl:415
23064 #: ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1512
23065 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:300
23066 #: ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277
23067 msgid ""
23068 "This program is free software; you can redistribute it and/or modify it "
23069 "under the terms of the GNU General Public License as published by the Free "
23070 "Software Foundation; either version 2 of the License, or (at your option) "
23071 "any later version."
23072 msgstr ""
23073
23074 # type: textblock
23075 #. type: textblock
23076 #: ../fish/guestfish.pod:1122 ../test-tool/libguestfs-test-tool.pod:129
23077 #: ../fuse/guestmount.pod:258 ../tools/virt-edit.pl:420
23078 #: ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1517
23079 #: ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:305
23080 #: ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282
23081 msgid ""
23082 "This program is distributed in the hope that it will be useful, but WITHOUT "
23083 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
23084 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
23085 "more details."
23086 msgstr ""
23087
23088 # type: textblock
23089 #. type: textblock
23090 #: ../fish/guestfish.pod:1127 ../test-tool/libguestfs-test-tool.pod:134
23091 #: ../fuse/guestmount.pod:263 ../tools/virt-edit.pl:425
23092 #: ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1522
23093 #: ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:310
23094 #: ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287
23095 msgid ""
23096 "You should have received a copy of the GNU General Public License along with "
23097 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
23098 "Ave, Cambridge, MA 02139, USA."
23099 msgstr ""
23100
23101 # type: =head2
23102 #. type: =head2
23103 #: ../fish/guestfish-actions.pod:1
23104 msgid "add-cdrom"
23105 msgstr ""
23106
23107 # type: verbatim
23108 #. type: verbatim
23109 #: ../fish/guestfish-actions.pod:3
23110 #, no-wrap
23111 msgid ""
23112 " add-cdrom filename\n"
23113 "\n"
23114 msgstr ""
23115
23116 # type: textblock
23117 #. type: textblock
23118 #: ../fish/guestfish-actions.pod:15
23119 msgid ""
23120 "This call checks for the existence of C<filename>.  This stops you from "
23121 "specifying other types of drive which are supported by qemu such as C<nbd:> "
23122 "and C<http:> URLs.  To specify those, use the general L</config> call "
23123 "instead."
23124 msgstr ""
23125
23126 # type: textblock
23127 #. type: textblock
23128 #: ../fish/guestfish-actions.pod:22
23129 msgid ""
23130 "If you just want to add an ISO file (often you use this as an efficient way "
23131 "to transfer large files into the guest), then you should probably use L</add-"
23132 "drive-ro> instead."
23133 msgstr ""
23134
23135 #. type: textblock
23136 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:151
23137 #: ../fish/guestfish-actions.pod:165
23138 msgid ""
23139 "This function is deprecated.  In new code, use the L</add_drive_opts> call "
23140 "instead."
23141 msgstr ""
23142
23143 # type: =head2
23144 #. type: =head2
23145 #: ../fish/guestfish-actions.pod:35
23146 msgid "add-domain"
23147 msgstr ""
23148
23149 # type: =head2
23150 #. type: =head2
23151 #: ../fish/guestfish-actions.pod:37
23152 msgid "domain"
23153 msgstr ""
23154
23155 # type: verbatim
23156 #. type: verbatim
23157 #: ../fish/guestfish-actions.pod:39
23158 #, no-wrap
23159 msgid ""
23160 " add-domain dom [libvirturi:..] [readonly:..] [iface:..]\n"
23161 "\n"
23162 msgstr ""
23163
23164 # type: textblock
23165 #. type: textblock
23166 #: ../fish/guestfish-actions.pod:41
23167 msgid ""
23168 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
23169 "It works by connecting to libvirt, requesting the domain and domain XML from "
23170 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
23171 msgstr ""
23172
23173 # type: textblock
23174 #. type: textblock
23175 #: ../fish/guestfish-actions.pod:64
23176 msgid ""
23177 "The other optional parameters are passed directly through to L</add-drive-"
23178 "opts>."
23179 msgstr ""
23180
23181 # type: textblock
23182 #. type: textblock
23183 #: ../fish/guestfish-actions.pod:67 ../fish/guestfish-actions.pod:131
23184 #: ../fish/guestfish-actions.pod:2845
23185 msgid ""
23186 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
23187 msgstr ""
23188
23189 # type: =head2
23190 #. type: =head2
23191 #: ../fish/guestfish-actions.pod:69
23192 msgid "add-drive"
23193 msgstr ""
23194
23195 # type: verbatim
23196 #. type: verbatim
23197 #: ../fish/guestfish-actions.pod:71
23198 #, no-wrap
23199 msgid ""
23200 " add-drive filename\n"
23201 "\n"
23202 msgstr ""
23203
23204 # type: textblock
23205 #. type: textblock
23206 #: ../fish/guestfish-actions.pod:73
23207 msgid ""
23208 "This function is the equivalent of calling L</add-drive-opts> with no "
23209 "optional parameters, so the disk is added writable, with the format being "
23210 "detected automatically."
23211 msgstr ""
23212
23213 # type: textblock
23214 #. type: textblock
23215 #: ../fish/guestfish-actions.pod:77
23216 msgid ""
23217 "Automatic detection of the format opens you up to a potential security hole "
23218 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
23219 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
23220 "you should think about replacing calls to this function with calls to L</add-"
23221 "drive-opts>, and specifying the format."
23222 msgstr ""
23223
23224 # type: =head2
23225 #. type: =head2
23226 #: ../fish/guestfish-actions.pod:84
23227 msgid "add-drive-opts"
23228 msgstr ""
23229
23230 # type: =head2
23231 #. type: =head2
23232 #: ../fish/guestfish-actions.pod:86
23233 msgid "add"
23234 msgstr ""
23235
23236 # type: verbatim
23237 #. type: verbatim
23238 #: ../fish/guestfish-actions.pod:88
23239 #, no-wrap
23240 msgid ""
23241 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
23242 "\n"
23243 msgstr ""
23244
23245 # type: textblock
23246 #. type: textblock
23247 #: ../fish/guestfish-actions.pod:115
23248 msgid ""
23249 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
23250 "add-drive-ro>) then the format is automatically detected.  Possible formats "
23251 "include C<raw> and C<qcow2>."
23252 msgstr ""
23253
23254 # type: textblock
23255 #. type: textblock
23256 #: ../fish/guestfish-actions.pod:126
23257 msgid ""
23258 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
23259 "add-drive-with-if> call (q.v.)"
23260 msgstr ""
23261
23262 # type: =head2
23263 #. type: =head2
23264 #: ../fish/guestfish-actions.pod:133
23265 msgid "add-drive-ro"
23266 msgstr ""
23267
23268 # type: =head2
23269 #. type: =head2
23270 #: ../fish/guestfish-actions.pod:135
23271 msgid "add-ro"
23272 msgstr ""
23273
23274 # type: verbatim
23275 #. type: verbatim
23276 #: ../fish/guestfish-actions.pod:137
23277 #, no-wrap
23278 msgid ""
23279 " add-drive-ro filename\n"
23280 "\n"
23281 msgstr ""
23282
23283 # type: textblock
23284 #. type: textblock
23285 #: ../fish/guestfish-actions.pod:139
23286 msgid ""
23287 "This function is the equivalent of calling L</add-drive-opts> with the "
23288 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
23289 "is added read-only, with the format being detected automatically."
23290 msgstr ""
23291
23292 # type: =head2
23293 #. type: =head2
23294 #: ../fish/guestfish-actions.pod:144
23295 msgid "add-drive-ro-with-if"
23296 msgstr ""
23297
23298 # type: verbatim
23299 #. type: verbatim
23300 #: ../fish/guestfish-actions.pod:146
23301 #, no-wrap
23302 msgid ""
23303 " add-drive-ro-with-if filename iface\n"
23304 "\n"
23305 msgstr ""
23306
23307 # type: textblock
23308 #. type: textblock
23309 #: ../fish/guestfish-actions.pod:148
23310 msgid ""
23311 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
23312 "interface emulation to use at run time."
23313 msgstr ""
23314
23315 # type: =head2
23316 #. type: =head2
23317 #: ../fish/guestfish-actions.pod:158
23318 msgid "add-drive-with-if"
23319 msgstr ""
23320
23321 # type: verbatim
23322 #. type: verbatim
23323 #: ../fish/guestfish-actions.pod:160
23324 #, no-wrap
23325 msgid ""
23326 " add-drive-with-if filename iface\n"
23327 "\n"
23328 msgstr ""
23329
23330 # type: textblock
23331 #. type: textblock
23332 #: ../fish/guestfish-actions.pod:162
23333 msgid ""
23334 "This is the same as L</add-drive> but it allows you to specify the QEMU "
23335 "interface emulation to use at run time."
23336 msgstr ""
23337
23338 # type: =head2
23339 #. type: =head2
23340 #: ../fish/guestfish-actions.pod:172
23341 msgid "aug-clear"
23342 msgstr ""
23343
23344 # type: verbatim
23345 #. type: verbatim
23346 #: ../fish/guestfish-actions.pod:174
23347 #, no-wrap
23348 msgid ""
23349 " aug-clear augpath\n"
23350 "\n"
23351 msgstr ""
23352
23353 # type: =head2
23354 #. type: =head2
23355 #: ../fish/guestfish-actions.pod:179
23356 msgid "aug-close"
23357 msgstr ""
23358
23359 # type: verbatim
23360 #. type: verbatim
23361 #: ../fish/guestfish-actions.pod:181
23362 #, no-wrap
23363 msgid ""
23364 " aug-close\n"
23365 "\n"
23366 msgstr ""
23367
23368 # type: textblock
23369 #. type: textblock
23370 #: ../fish/guestfish-actions.pod:183
23371 msgid ""
23372 "Close the current Augeas handle and free up any resources used by it.  After "
23373 "calling this, you have to call L</aug-init> again before you can use any "
23374 "other Augeas functions."
23375 msgstr ""
23376
23377 # type: =head2
23378 #. type: =head2
23379 #: ../fish/guestfish-actions.pod:188
23380 msgid "aug-defnode"
23381 msgstr ""
23382
23383 # type: verbatim
23384 #. type: verbatim
23385 #: ../fish/guestfish-actions.pod:190
23386 #, no-wrap
23387 msgid ""
23388 " aug-defnode name expr val\n"
23389 "\n"
23390 msgstr ""
23391
23392 # type: textblock
23393 #. type: textblock
23394 #: ../fish/guestfish-actions.pod:195
23395 msgid ""
23396 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
23397 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
23398 "containing that single node."
23399 msgstr ""
23400
23401 # type: =head2
23402 #. type: =head2
23403 #: ../fish/guestfish-actions.pod:203
23404 msgid "aug-defvar"
23405 msgstr ""
23406
23407 # type: verbatim
23408 #. type: verbatim
23409 #: ../fish/guestfish-actions.pod:205
23410 #, no-wrap
23411 msgid ""
23412 " aug-defvar name expr\n"
23413 "\n"
23414 msgstr ""
23415
23416 # type: =head2
23417 #. type: =head2
23418 #: ../fish/guestfish-actions.pod:214
23419 msgid "aug-get"
23420 msgstr ""
23421
23422 # type: verbatim
23423 #. type: verbatim
23424 #: ../fish/guestfish-actions.pod:216
23425 #, no-wrap
23426 msgid ""
23427 " aug-get augpath\n"
23428 "\n"
23429 msgstr ""
23430
23431 # type: =head2
23432 #. type: =head2
23433 #: ../fish/guestfish-actions.pod:221
23434 msgid "aug-init"
23435 msgstr ""
23436
23437 # type: verbatim
23438 #. type: verbatim
23439 #: ../fish/guestfish-actions.pod:223
23440 #, no-wrap
23441 msgid ""
23442 " aug-init root flags\n"
23443 "\n"
23444 msgstr ""
23445
23446 # type: textblock
23447 #. type: textblock
23448 #: ../fish/guestfish-actions.pod:229
23449 msgid "You must call this before using any other L</aug-*> commands."
23450 msgstr ""
23451
23452 # type: textblock
23453 #. type: textblock
23454 #: ../fish/guestfish-actions.pod:264
23455 msgid "Do not load the tree in L</aug-init>."
23456 msgstr ""
23457
23458 # type: textblock
23459 #. type: textblock
23460 #: ../fish/guestfish-actions.pod:268
23461 msgid "To close the handle, you can call L</aug-close>."
23462 msgstr ""
23463
23464 # type: =head2
23465 #. type: =head2
23466 #: ../fish/guestfish-actions.pod:272
23467 msgid "aug-insert"
23468 msgstr ""
23469
23470 # type: verbatim
23471 #. type: verbatim
23472 #: ../fish/guestfish-actions.pod:274
23473 #, no-wrap
23474 msgid ""
23475 " aug-insert augpath label true|false\n"
23476 "\n"
23477 msgstr ""
23478
23479 # type: =head2
23480 #. type: =head2
23481 #: ../fish/guestfish-actions.pod:284
23482 msgid "aug-load"
23483 msgstr ""
23484
23485 # type: verbatim
23486 #. type: verbatim
23487 #: ../fish/guestfish-actions.pod:286
23488 #, no-wrap
23489 msgid ""
23490 " aug-load\n"
23491 "\n"
23492 msgstr ""
23493
23494 # type: =head2
23495 #. type: =head2
23496 #: ../fish/guestfish-actions.pod:293
23497 msgid "aug-ls"
23498 msgstr ""
23499
23500 # type: verbatim
23501 #. type: verbatim
23502 #: ../fish/guestfish-actions.pod:295
23503 #, no-wrap
23504 msgid ""
23505 " aug-ls augpath\n"
23506 "\n"
23507 msgstr ""
23508
23509 # type: textblock
23510 #. type: textblock
23511 #: ../fish/guestfish-actions.pod:297
23512 msgid ""
23513 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
23514 "resulting nodes into alphabetical order."
23515 msgstr ""
23516
23517 # type: =head2
23518 #. type: =head2
23519 #: ../fish/guestfish-actions.pod:300
23520 msgid "aug-match"
23521 msgstr ""
23522
23523 # type: verbatim
23524 #. type: verbatim
23525 #: ../fish/guestfish-actions.pod:302
23526 #, no-wrap
23527 msgid ""
23528 " aug-match augpath\n"
23529 "\n"
23530 msgstr ""
23531
23532 # type: =head2
23533 #. type: =head2
23534 #: ../fish/guestfish-actions.pod:308
23535 msgid "aug-mv"
23536 msgstr ""
23537
23538 # type: verbatim
23539 #. type: verbatim
23540 #: ../fish/guestfish-actions.pod:310
23541 #, no-wrap
23542 msgid ""
23543 " aug-mv src dest\n"
23544 "\n"
23545 msgstr ""
23546
23547 # type: =head2
23548 #. type: =head2
23549 #: ../fish/guestfish-actions.pod:315
23550 msgid "aug-rm"
23551 msgstr ""
23552
23553 # type: verbatim
23554 #. type: verbatim
23555 #: ../fish/guestfish-actions.pod:317
23556 #, no-wrap
23557 msgid ""
23558 " aug-rm augpath\n"
23559 "\n"
23560 msgstr ""
23561
23562 # type: =head2
23563 #. type: =head2
23564 #: ../fish/guestfish-actions.pod:323
23565 msgid "aug-save"
23566 msgstr ""
23567
23568 # type: verbatim
23569 #. type: verbatim
23570 #: ../fish/guestfish-actions.pod:325
23571 #, no-wrap
23572 msgid ""
23573 " aug-save\n"
23574 "\n"
23575 msgstr ""
23576
23577 # type: textblock
23578 #. type: textblock
23579 #: ../fish/guestfish-actions.pod:329
23580 msgid ""
23581 "The flags which were passed to L</aug-init> affect exactly how files are "
23582 "saved."
23583 msgstr ""
23584
23585 # type: =head2
23586 #. type: =head2
23587 #: ../fish/guestfish-actions.pod:332
23588 msgid "aug-set"
23589 msgstr ""
23590
23591 # type: verbatim
23592 #. type: verbatim
23593 #: ../fish/guestfish-actions.pod:334
23594 #, no-wrap
23595 msgid ""
23596 " aug-set augpath val\n"
23597 "\n"
23598 msgstr ""
23599
23600 # type: textblock
23601 #. type: textblock
23602 #: ../fish/guestfish-actions.pod:338
23603 msgid ""
23604 "In the Augeas API, it is possible to clear a node by setting the value to "
23605 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
23606 "this call.  Instead you must use the L</aug-clear> call."
23607 msgstr ""
23608
23609 # type: =head2
23610 #. type: =head2
23611 #: ../fish/guestfish-actions.pod:343
23612 msgid "available"
23613 msgstr ""
23614
23615 # type: verbatim
23616 #. type: verbatim
23617 #: ../fish/guestfish-actions.pod:345
23618 #, no-wrap
23619 msgid ""
23620 " available 'groups ...'\n"
23621 "\n"
23622 msgstr ""
23623
23624 # type: textblock
23625 #. type: textblock
23626 #: ../fish/guestfish-actions.pod:351
23627 msgid ""
23628 "The libguestfs groups, and the functions that those groups correspond to, "
23629 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
23630 "runtime by calling L</available-all-groups>."
23631 msgstr ""
23632
23633 # type: textblock
23634 #. type: textblock
23635 #: ../fish/guestfish-actions.pod:375
23636 msgid "You must call L</launch> before calling this function."
23637 msgstr ""
23638
23639 # type: textblock
23640 #. type: textblock
23641 #: ../fish/guestfish-actions.pod:397
23642 msgid ""
23643 "This call was added in version C<1.0.80>.  In previous versions of "
23644 "libguestfs all you could do would be to speculatively execute a command to "
23645 "find out if the daemon implemented it.  See also L</version>."
23646 msgstr ""
23647
23648 # type: =head2
23649 #. type: =head2
23650 #: ../fish/guestfish-actions.pod:404
23651 msgid "available-all-groups"
23652 msgstr ""
23653
23654 # type: verbatim
23655 #. type: verbatim
23656 #: ../fish/guestfish-actions.pod:406
23657 #, no-wrap
23658 msgid ""
23659 " available-all-groups\n"
23660 "\n"
23661 msgstr ""
23662
23663 # type: textblock
23664 #. type: textblock
23665 #: ../fish/guestfish-actions.pod:408
23666 msgid ""
23667 "This command returns a list of all optional groups that this daemon knows "
23668 "about.  Note this returns both supported and unsupported groups.  To find "
23669 "out which ones the daemon can actually support you have to call L</"
23670 "available> on each member of the returned list."
23671 msgstr ""
23672
23673 # type: textblock
23674 #. type: textblock
23675 #: ../fish/guestfish-actions.pod:414
23676 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
23677 msgstr ""
23678
23679 # type: =head2
23680 #. type: =head2
23681 #: ../fish/guestfish-actions.pod:416
23682 msgid "base64-in"
23683 msgstr ""
23684
23685 # type: verbatim
23686 #. type: verbatim
23687 #: ../fish/guestfish-actions.pod:418
23688 #, no-wrap
23689 msgid ""
23690 " base64-in (base64file|-) filename\n"
23691 "\n"
23692 msgstr ""
23693
23694 # type: textblock
23695 #. type: textblock
23696 #: ../fish/guestfish-actions.pod:423 ../fish/guestfish-actions.pod:432
23697 #: ../fish/guestfish-actions.pod:656 ../fish/guestfish-actions.pod:825
23698 #: ../fish/guestfish-actions.pod:844 ../fish/guestfish-actions.pod:1218
23699 #: ../fish/guestfish-actions.pod:4209 ../fish/guestfish-actions.pod:4221
23700 #: ../fish/guestfish-actions.pod:4232 ../fish/guestfish-actions.pod:4243
23701 #: ../fish/guestfish-actions.pod:4295 ../fish/guestfish-actions.pod:4304
23702 #: ../fish/guestfish-actions.pod:4358 ../fish/guestfish-actions.pod:4381
23703 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
23704 msgstr ""
23705
23706 # type: =head2
23707 #. type: =head2
23708 #: ../fish/guestfish-actions.pod:425
23709 msgid "base64-out"
23710 msgstr ""
23711
23712 # type: verbatim
23713 #. type: verbatim
23714 #: ../fish/guestfish-actions.pod:427
23715 #, no-wrap
23716 msgid ""
23717 " base64-out filename (base64file|-)\n"
23718 "\n"
23719 msgstr ""
23720
23721 # type: =head2
23722 #. type: =head2
23723 #: ../fish/guestfish-actions.pod:434
23724 msgid "blockdev-flushbufs"
23725 msgstr ""
23726
23727 # type: verbatim
23728 #. type: verbatim
23729 #: ../fish/guestfish-actions.pod:436
23730 #, no-wrap
23731 msgid ""
23732 " blockdev-flushbufs device\n"
23733 "\n"
23734 msgstr ""
23735
23736 # type: =head2
23737 #. type: =head2
23738 #: ../fish/guestfish-actions.pod:443
23739 msgid "blockdev-getbsz"
23740 msgstr ""
23741
23742 # type: verbatim
23743 #. type: verbatim
23744 #: ../fish/guestfish-actions.pod:445
23745 #, no-wrap
23746 msgid ""
23747 " blockdev-getbsz device\n"
23748 "\n"
23749 msgstr ""
23750
23751 # type: =head2
23752 #. type: =head2
23753 #: ../fish/guestfish-actions.pod:454
23754 msgid "blockdev-getro"
23755 msgstr ""
23756
23757 # type: verbatim
23758 #. type: verbatim
23759 #: ../fish/guestfish-actions.pod:456
23760 #, no-wrap
23761 msgid ""
23762 " blockdev-getro device\n"
23763 "\n"
23764 msgstr ""
23765
23766 # type: =head2
23767 #. type: =head2
23768 #: ../fish/guestfish-actions.pod:463
23769 msgid "blockdev-getsize64"
23770 msgstr ""
23771
23772 # type: verbatim
23773 #. type: verbatim
23774 #: ../fish/guestfish-actions.pod:465
23775 #, no-wrap
23776 msgid ""
23777 " blockdev-getsize64 device\n"
23778 "\n"
23779 msgstr ""
23780
23781 # type: textblock
23782 #. type: textblock
23783 #: ../fish/guestfish-actions.pod:469
23784 msgid "See also L</blockdev-getsz>."
23785 msgstr ""
23786
23787 # type: =head2
23788 #. type: =head2
23789 #: ../fish/guestfish-actions.pod:473
23790 msgid "blockdev-getss"
23791 msgstr ""
23792
23793 # type: verbatim
23794 #. type: verbatim
23795 #: ../fish/guestfish-actions.pod:475
23796 #, no-wrap
23797 msgid ""
23798 " blockdev-getss device\n"
23799 "\n"
23800 msgstr ""
23801
23802 # type: textblock
23803 #. type: textblock
23804 #: ../fish/guestfish-actions.pod:480
23805 msgid ""
23806 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
23807 msgstr ""
23808
23809 # type: =head2
23810 #. type: =head2
23811 #: ../fish/guestfish-actions.pod:485
23812 msgid "blockdev-getsz"
23813 msgstr ""
23814
23815 # type: verbatim
23816 #. type: verbatim
23817 #: ../fish/guestfish-actions.pod:487
23818 #, no-wrap
23819 msgid ""
23820 " blockdev-getsz device\n"
23821 "\n"
23822 msgstr ""
23823
23824 # type: textblock
23825 #. type: textblock
23826 #: ../fish/guestfish-actions.pod:492
23827 msgid ""
23828 "See also L</blockdev-getss> for the real sector size of the device, and L</"
23829 "blockdev-getsize64> for the more useful I<size in bytes>."
23830 msgstr ""
23831
23832 # type: =head2
23833 #. type: =head2
23834 #: ../fish/guestfish-actions.pod:498
23835 msgid "blockdev-rereadpt"
23836 msgstr ""
23837
23838 # type: verbatim
23839 #. type: verbatim
23840 #: ../fish/guestfish-actions.pod:500
23841 #, no-wrap
23842 msgid ""
23843 " blockdev-rereadpt device\n"
23844 "\n"
23845 msgstr ""
23846
23847 # type: =head2
23848 #. type: =head2
23849 #: ../fish/guestfish-actions.pod:506
23850 msgid "blockdev-setbsz"
23851 msgstr ""
23852
23853 # type: verbatim
23854 #. type: verbatim
23855 #: ../fish/guestfish-actions.pod:508
23856 #, no-wrap
23857 msgid ""
23858 " blockdev-setbsz device blocksize\n"
23859 "\n"
23860 msgstr ""
23861
23862 # type: =head2
23863 #. type: =head2
23864 #: ../fish/guestfish-actions.pod:517
23865 msgid "blockdev-setro"
23866 msgstr ""
23867
23868 # type: verbatim
23869 #. type: verbatim
23870 #: ../fish/guestfish-actions.pod:519
23871 #, no-wrap
23872 msgid ""
23873 " blockdev-setro device\n"
23874 "\n"
23875 msgstr ""
23876
23877 # type: =head2
23878 #. type: =head2
23879 #: ../fish/guestfish-actions.pod:525
23880 msgid "blockdev-setrw"
23881 msgstr ""
23882
23883 # type: verbatim
23884 #. type: verbatim
23885 #: ../fish/guestfish-actions.pod:527
23886 #, no-wrap
23887 msgid ""
23888 " blockdev-setrw device\n"
23889 "\n"
23890 msgstr ""
23891
23892 # type: =head2
23893 #. type: =head2
23894 #: ../fish/guestfish-actions.pod:533
23895 msgid "case-sensitive-path"
23896 msgstr ""
23897
23898 # type: verbatim
23899 #. type: verbatim
23900 #: ../fish/guestfish-actions.pod:535
23901 #, no-wrap
23902 msgid ""
23903 " case-sensitive-path path\n"
23904 "\n"
23905 msgstr ""
23906
23907 # type: textblock
23908 #. type: textblock
23909 #: ../fish/guestfish-actions.pod:559
23910 msgid ""
23911 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
23912 "WINDOWS/system32\"> (the exact return value would depend on details of how "
23913 "the directories were originally created under Windows)."
23914 msgstr ""
23915
23916 # type: textblock
23917 #. type: textblock
23918 #: ../fish/guestfish-actions.pod:567
23919 msgid "See also L</realpath>."
23920 msgstr ""
23921
23922 # type: =head2
23923 #. type: =head2
23924 #: ../fish/guestfish-actions.pod:569
23925 msgid "cat"
23926 msgstr ""
23927
23928 # type: verbatim
23929 #. type: verbatim
23930 #: ../fish/guestfish-actions.pod:571
23931 #, no-wrap
23932 msgid ""
23933 " cat path\n"
23934 "\n"
23935 msgstr ""
23936
23937 # type: textblock
23938 #. type: textblock
23939 #: ../fish/guestfish-actions.pod:575
23940 msgid ""
23941 "Note that this function cannot correctly handle binary files (specifically, "
23942 "files containing C<\\0> character which is treated as end of string).  For "
23943 "those you need to use the L</read-file> or L</download> functions which have "
23944 "a more complex interface."
23945 msgstr ""
23946
23947 # type: =head2
23948 #. type: =head2
23949 #: ../fish/guestfish-actions.pod:583
23950 msgid "checksum"
23951 msgstr ""
23952
23953 # type: verbatim
23954 #. type: verbatim
23955 #: ../fish/guestfish-actions.pod:585
23956 #, no-wrap
23957 msgid ""
23958 " checksum csumtype path\n"
23959 "\n"
23960 msgstr ""
23961
23962 # type: textblock
23963 #. type: textblock
23964 #: ../fish/guestfish-actions.pod:628
23965 msgid "To get the checksum for a device, use L</checksum-device>."
23966 msgstr ""
23967
23968 # type: textblock
23969 #. type: textblock
23970 #: ../fish/guestfish-actions.pod:630
23971 msgid "To get the checksums for many files, use L</checksums-out>."
23972 msgstr ""
23973
23974 # type: =head2
23975 #. type: =head2
23976 #: ../fish/guestfish-actions.pod:632
23977 msgid "checksum-device"
23978 msgstr ""
23979
23980 # type: verbatim
23981 #. type: verbatim
23982 #: ../fish/guestfish-actions.pod:634
23983 #, no-wrap
23984 msgid ""
23985 " checksum-device csumtype device\n"
23986 "\n"
23987 msgstr ""
23988
23989 # type: textblock
23990 #. type: textblock
23991 #: ../fish/guestfish-actions.pod:636
23992 msgid ""
23993 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
23994 "device named C<device>.  For the types of checksums supported see the L</"
23995 "checksum> command."
23996 msgstr ""
23997
23998 # type: =head2
23999 #. type: =head2
24000 #: ../fish/guestfish-actions.pod:640
24001 msgid "checksums-out"
24002 msgstr ""
24003
24004 # type: verbatim
24005 #. type: verbatim
24006 #: ../fish/guestfish-actions.pod:642
24007 #, no-wrap
24008 msgid ""
24009 " checksums-out csumtype directory (sumsfile|-)\n"
24010 "\n"
24011 msgstr ""
24012
24013 # type: =head2
24014 #. type: =head2
24015 #: ../fish/guestfish-actions.pod:658
24016 msgid "chmod"
24017 msgstr ""
24018
24019 # type: verbatim
24020 #. type: verbatim
24021 #: ../fish/guestfish-actions.pod:660
24022 #, no-wrap
24023 msgid ""
24024 " chmod mode path\n"
24025 "\n"
24026 msgstr ""
24027
24028 # type: =head2
24029 #. type: =head2
24030 #: ../fish/guestfish-actions.pod:671
24031 msgid "chown"
24032 msgstr ""
24033
24034 # type: verbatim
24035 #. type: verbatim
24036 #: ../fish/guestfish-actions.pod:673
24037 #, no-wrap
24038 msgid ""
24039 " chown owner group path\n"
24040 "\n"
24041 msgstr ""
24042
24043 # type: =head2
24044 #. type: =head2
24045 #: ../fish/guestfish-actions.pod:681
24046 msgid "command"
24047 msgstr ""
24048
24049 # type: verbatim
24050 #. type: verbatim
24051 #: ../fish/guestfish-actions.pod:683
24052 #, no-wrap
24053 msgid ""
24054 " command 'arguments ...'\n"
24055 "\n"
24056 msgstr ""
24057
24058 # type: textblock
24059 #. type: textblock
24060 #: ../fish/guestfish-actions.pod:690
24061 msgid ""
24062 "The single parameter is an argv-style list of arguments.  The first element "
24063 "is the name of the program to run.  Subsequent elements are parameters.  The "
24064 "list must be non-empty (ie. must contain a program name).  Note that the "
24065 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
24066 msgstr ""
24067
24068 # type: =head2
24069 #. type: =head2
24070 #: ../fish/guestfish-actions.pod:718
24071 msgid "command-lines"
24072 msgstr ""
24073
24074 # type: verbatim
24075 #. type: verbatim
24076 #: ../fish/guestfish-actions.pod:720
24077 #, no-wrap
24078 msgid ""
24079 " command-lines 'arguments ...'\n"
24080 "\n"
24081 msgstr ""
24082
24083 # type: textblock
24084 #. type: textblock
24085 #: ../fish/guestfish-actions.pod:722
24086 msgid ""
24087 "This is the same as L</command>, but splits the result into a list of lines."
24088 msgstr ""
24089
24090 # type: textblock
24091 #. type: textblock
24092 #: ../fish/guestfish-actions.pod:725
24093 msgid "See also: L</sh-lines>"
24094 msgstr ""
24095
24096 # type: =head2
24097 #. type: =head2
24098 #: ../fish/guestfish-actions.pod:730
24099 msgid "config"
24100 msgstr ""
24101
24102 # type: verbatim
24103 #. type: verbatim
24104 #: ../fish/guestfish-actions.pod:732
24105 #, no-wrap
24106 msgid ""
24107 " config qemuparam qemuvalue\n"
24108 "\n"
24109 msgstr ""
24110
24111 # type: =head2
24112 #. type: =head2
24113 #: ../fish/guestfish-actions.pod:743
24114 msgid "copy-size"
24115 msgstr ""
24116
24117 # type: verbatim
24118 #. type: verbatim
24119 #: ../fish/guestfish-actions.pod:745
24120 #, no-wrap
24121 msgid ""
24122 " copy-size src dest size\n"
24123 "\n"
24124 msgstr ""
24125
24126 # type: =head2
24127 #. type: =head2
24128 #: ../fish/guestfish-actions.pod:753
24129 msgid "cp"
24130 msgstr ""
24131
24132 # type: verbatim
24133 #. type: verbatim
24134 #: ../fish/guestfish-actions.pod:755
24135 #, no-wrap
24136 msgid ""
24137 " cp src dest\n"
24138 "\n"
24139 msgstr ""
24140
24141 # type: =head2
24142 #. type: =head2
24143 #: ../fish/guestfish-actions.pod:760
24144 msgid "cp-a"
24145 msgstr ""
24146
24147 # type: verbatim
24148 #. type: verbatim
24149 #: ../fish/guestfish-actions.pod:762
24150 #, no-wrap
24151 msgid ""
24152 " cp-a src dest\n"
24153 "\n"
24154 msgstr ""
24155
24156 # type: =head2
24157 #. type: =head2
24158 #: ../fish/guestfish-actions.pod:767
24159 msgid "dd"
24160 msgstr ""
24161
24162 # type: verbatim
24163 #. type: verbatim
24164 #: ../fish/guestfish-actions.pod:769
24165 #, no-wrap
24166 msgid ""
24167 " dd src dest\n"
24168 "\n"
24169 msgstr ""
24170
24171 # type: textblock
24172 #. type: textblock
24173 #: ../fish/guestfish-actions.pod:776
24174 msgid ""
24175 "If the destination is a device, it must be as large or larger than the "
24176 "source file or device, otherwise the copy will fail.  This command cannot do "
24177 "partial copies (see L</copy-size>)."
24178 msgstr ""
24179
24180 # type: =head2
24181 #. type: =head2
24182 #: ../fish/guestfish-actions.pod:780
24183 msgid "df"
24184 msgstr ""
24185
24186 # type: verbatim
24187 #. type: verbatim
24188 #: ../fish/guestfish-actions.pod:782
24189 #, no-wrap
24190 msgid ""
24191 " df\n"
24192 "\n"
24193 msgstr ""
24194
24195 # type: textblock
24196 #. type: textblock
24197 #: ../fish/guestfish-actions.pod:786 ../fish/guestfish-actions.pod:797
24198 msgid ""
24199 "This command is mostly useful for interactive sessions.  It is I<not> "
24200 "intended that you try to parse the output string.  Use L</statvfs> from "
24201 "programs."
24202 msgstr ""
24203
24204 # type: =head2
24205 #. type: =head2
24206 #: ../fish/guestfish-actions.pod:790
24207 msgid "df-h"
24208 msgstr ""
24209
24210 # type: verbatim
24211 #. type: verbatim
24212 #: ../fish/guestfish-actions.pod:792
24213 #, no-wrap
24214 msgid ""
24215 " df-h\n"
24216 "\n"
24217 msgstr ""
24218
24219 # type: =head2
24220 #. type: =head2
24221 #: ../fish/guestfish-actions.pod:801
24222 msgid "dmesg"
24223 msgstr ""
24224
24225 # type: verbatim
24226 #. type: verbatim
24227 #: ../fish/guestfish-actions.pod:803
24228 #, no-wrap
24229 msgid ""
24230 " dmesg\n"
24231 "\n"
24232 msgstr ""
24233
24234 # type: textblock
24235 #. type: textblock
24236 #: ../fish/guestfish-actions.pod:809
24237 msgid ""
24238 "Another way to get the same information is to enable verbose messages with "
24239 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
24240 "before running the program."
24241 msgstr ""
24242
24243 # type: =head2
24244 #. type: =head2
24245 #: ../fish/guestfish-actions.pod:814
24246 msgid "download"
24247 msgstr ""
24248
24249 # type: verbatim
24250 #. type: verbatim
24251 #: ../fish/guestfish-actions.pod:816
24252 #, no-wrap
24253 msgid ""
24254 " download remotefilename (filename|-)\n"
24255 "\n"
24256 msgstr ""
24257
24258 # type: textblock
24259 #. type: textblock
24260 #: ../fish/guestfish-actions.pod:823
24261 msgid "See also L</upload>, L</cat>."
24262 msgstr ""
24263
24264 # type: =head2
24265 #. type: =head2
24266 #: ../fish/guestfish-actions.pod:827
24267 msgid "download-offset"
24268 msgstr ""
24269
24270 # type: verbatim
24271 #. type: verbatim
24272 #: ../fish/guestfish-actions.pod:829
24273 #, no-wrap
24274 msgid ""
24275 " download-offset remotefilename (filename|-) offset size\n"
24276 "\n"
24277 msgstr ""
24278
24279 # type: textblock
24280 #. type: textblock
24281 #: ../fish/guestfish-actions.pod:837
24282 msgid ""
24283 "Note that there is no limit on the amount of data that can be downloaded "
24284 "with this call, unlike with L</pread>, and this call always reads the full "
24285 "amount unless an error occurs."
24286 msgstr ""
24287
24288 # type: textblock
24289 #. type: textblock
24290 #: ../fish/guestfish-actions.pod:842
24291 msgid "See also L</download>, L</pread>."
24292 msgstr ""
24293
24294 # type: =head2
24295 #. type: =head2
24296 #: ../fish/guestfish-actions.pod:846
24297 msgid "drop-caches"
24298 msgstr ""
24299
24300 # type: verbatim
24301 #. type: verbatim
24302 #: ../fish/guestfish-actions.pod:848
24303 #, no-wrap
24304 msgid ""
24305 " drop-caches whattodrop\n"
24306 "\n"
24307 msgstr ""
24308
24309 # type: =head2
24310 #. type: =head2
24311 #: ../fish/guestfish-actions.pod:860
24312 msgid "du"
24313 msgstr ""
24314
24315 # type: verbatim
24316 #. type: verbatim
24317 #: ../fish/guestfish-actions.pod:862
24318 #, no-wrap
24319 msgid ""
24320 " du path\n"
24321 "\n"
24322 msgstr ""
24323
24324 # type: =head2
24325 #. type: =head2
24326 #: ../fish/guestfish-actions.pod:874
24327 msgid "e2fsck-f"
24328 msgstr ""
24329
24330 # type: verbatim
24331 #. type: verbatim
24332 #: ../fish/guestfish-actions.pod:876
24333 #, no-wrap
24334 msgid ""
24335 " e2fsck-f device\n"
24336 "\n"
24337 msgstr ""
24338
24339 # type: textblock
24340 #. type: textblock
24341 #: ../fish/guestfish-actions.pod:882
24342 msgid ""
24343 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
24344 "should use L</fsck>."
24345 msgstr ""
24346
24347 # type: =head2
24348 #. type: =head2
24349 #: ../fish/guestfish-actions.pod:885
24350 msgid "echo-daemon"
24351 msgstr ""
24352
24353 # type: verbatim
24354 #. type: verbatim
24355 #: ../fish/guestfish-actions.pod:887
24356 #, no-wrap
24357 msgid ""
24358 " echo-daemon 'words ...'\n"
24359 "\n"
24360 msgstr ""
24361
24362 # type: textblock
24363 #. type: textblock
24364 #: ../fish/guestfish-actions.pod:894
24365 msgid "See also L</ping-daemon>."
24366 msgstr ""
24367
24368 # type: =head2
24369 #. type: =head2
24370 #: ../fish/guestfish-actions.pod:896
24371 msgid "egrep"
24372 msgstr ""
24373
24374 # type: verbatim
24375 #. type: verbatim
24376 #: ../fish/guestfish-actions.pod:898
24377 #, no-wrap
24378 msgid ""
24379 " egrep regex path\n"
24380 "\n"
24381 msgstr ""
24382
24383 # type: =head2
24384 #. type: =head2
24385 #: ../fish/guestfish-actions.pod:906
24386 msgid "egrepi"
24387 msgstr ""
24388
24389 # type: verbatim
24390 #. type: verbatim
24391 #: ../fish/guestfish-actions.pod:908
24392 #, no-wrap
24393 msgid ""
24394 " egrepi regex path\n"
24395 "\n"
24396 msgstr ""
24397
24398 # type: =head2
24399 #. type: =head2
24400 #: ../fish/guestfish-actions.pod:916
24401 msgid "equal"
24402 msgstr ""
24403
24404 # type: verbatim
24405 #. type: verbatim
24406 #: ../fish/guestfish-actions.pod:918
24407 #, no-wrap
24408 msgid ""
24409 " equal file1 file2\n"
24410 "\n"
24411 msgstr ""
24412
24413 # type: =head2
24414 #. type: =head2
24415 #: ../fish/guestfish-actions.pod:925
24416 msgid "exists"
24417 msgstr ""
24418
24419 # type: verbatim
24420 #. type: verbatim
24421 #: ../fish/guestfish-actions.pod:927
24422 #, no-wrap
24423 msgid ""
24424 " exists path\n"
24425 "\n"
24426 msgstr ""
24427
24428 # type: textblock
24429 #. type: textblock
24430 #: ../fish/guestfish-actions.pod:932
24431 msgid "See also L</is-file>, L</is-dir>, L</stat>."
24432 msgstr ""
24433
24434 # type: =head2
24435 #. type: =head2
24436 #: ../fish/guestfish-actions.pod:934
24437 msgid "fallocate"
24438 msgstr ""
24439
24440 # type: verbatim
24441 #. type: verbatim
24442 #: ../fish/guestfish-actions.pod:936
24443 #, no-wrap
24444 msgid ""
24445 " fallocate path len\n"
24446 "\n"
24447 msgstr ""
24448
24449 #. type: textblock
24450 #: ../fish/guestfish-actions.pod:946
24451 msgid ""
24452 "This function is deprecated.  In new code, use the L</fallocate64> call "
24453 "instead."
24454 msgstr ""
24455
24456 # type: =head2
24457 #. type: =head2
24458 #: ../fish/guestfish-actions.pod:953
24459 msgid "fallocate64"
24460 msgstr ""
24461
24462 # type: verbatim
24463 #. type: verbatim
24464 #: ../fish/guestfish-actions.pod:955
24465 #, no-wrap
24466 msgid ""
24467 " fallocate64 path len\n"
24468 "\n"
24469 msgstr ""
24470
24471 # type: textblock
24472 #. type: textblock
24473 #: ../fish/guestfish-actions.pod:961
24474 msgid ""
24475 "Note that this call allocates disk blocks for the file.  To create a sparse "
24476 "file use L</truncate-size> instead."
24477 msgstr ""
24478
24479 # type: textblock
24480 #. type: textblock
24481 #: ../fish/guestfish-actions.pod:964
24482 msgid ""
24483 "The deprecated call L</fallocate> does the same, but owing to an oversight "
24484 "it only allowed 30 bit lengths to be specified, effectively limiting the "
24485 "maximum size of files created through that call to 1GB."
24486 msgstr ""
24487
24488 # type: =head2
24489 #. type: =head2
24490 #: ../fish/guestfish-actions.pod:973
24491 msgid "fgrep"
24492 msgstr ""
24493
24494 # type: verbatim
24495 #. type: verbatim
24496 #: ../fish/guestfish-actions.pod:975
24497 #, no-wrap
24498 msgid ""
24499 " fgrep pattern path\n"
24500 "\n"
24501 msgstr ""
24502
24503 # type: =head2
24504 #. type: =head2
24505 #: ../fish/guestfish-actions.pod:983
24506 msgid "fgrepi"
24507 msgstr ""
24508
24509 # type: verbatim
24510 #. type: verbatim
24511 #: ../fish/guestfish-actions.pod:985
24512 #, no-wrap
24513 msgid ""
24514 " fgrepi pattern path\n"
24515 "\n"
24516 msgstr ""
24517
24518 # type: =head2
24519 #. type: =head2
24520 #: ../fish/guestfish-actions.pod:993
24521 msgid "file"
24522 msgstr ""
24523
24524 # type: verbatim
24525 #. type: verbatim
24526 #: ../fish/guestfish-actions.pod:995
24527 #, no-wrap
24528 msgid ""
24529 " file path\n"
24530 "\n"
24531 msgstr ""
24532
24533 #. type: textblock
24534 #: ../fish/guestfish-actions.pod:1011
24535 msgid ""
24536 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
24537 "(etc)."
24538 msgstr ""
24539
24540 # type: =head2
24541 #. type: =head2
24542 #: ../fish/guestfish-actions.pod:1014
24543 msgid "file-architecture"
24544 msgstr ""
24545
24546 # type: verbatim
24547 #. type: verbatim
24548 #: ../fish/guestfish-actions.pod:1016
24549 #, no-wrap
24550 msgid ""
24551 " file-architecture filename\n"
24552 "\n"
24553 msgstr ""
24554
24555 # type: =head2
24556 #. type: =head2
24557 #: ../fish/guestfish-actions.pod:1119
24558 msgid "filesize"
24559 msgstr ""
24560
24561 # type: verbatim
24562 #. type: verbatim
24563 #: ../fish/guestfish-actions.pod:1121
24564 #, no-wrap
24565 msgid ""
24566 " filesize file\n"
24567 "\n"
24568 msgstr ""
24569
24570 # type: textblock
24571 #. type: textblock
24572 #: ../fish/guestfish-actions.pod:1125
24573 msgid ""
24574 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
24575 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
24576 msgstr ""
24577
24578 # type: =head2
24579 #. type: =head2
24580 #: ../fish/guestfish-actions.pod:1129
24581 msgid "fill"
24582 msgstr ""
24583
24584 # type: verbatim
24585 #. type: verbatim
24586 #: ../fish/guestfish-actions.pod:1131
24587 #, no-wrap
24588 msgid ""
24589 " fill c len path\n"
24590 "\n"
24591 msgstr ""
24592
24593 # type: textblock
24594 #. type: textblock
24595 #: ../fish/guestfish-actions.pod:1137
24596 msgid ""
24597 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
24598 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
24599 "L</fill-pattern>."
24600 msgstr ""
24601
24602 # type: =head2
24603 #. type: =head2
24604 #: ../fish/guestfish-actions.pod:1142
24605 msgid "fill-pattern"
24606 msgstr ""
24607
24608 # type: verbatim
24609 #. type: verbatim
24610 #: ../fish/guestfish-actions.pod:1144
24611 #, no-wrap
24612 msgid ""
24613 " fill-pattern pattern len path\n"
24614 "\n"
24615 msgstr ""
24616
24617 # type: textblock
24618 #. type: textblock
24619 #: ../fish/guestfish-actions.pod:1146
24620 msgid ""
24621 "This function is like L</fill> except that it creates a new file of length "
24622 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
24623 "is truncated if necessary to ensure the length of the file is exactly C<len> "
24624 "bytes."
24625 msgstr ""
24626
24627 # type: =head2
24628 #. type: =head2
24629 #: ../fish/guestfish-actions.pod:1151
24630 msgid "find"
24631 msgstr ""
24632
24633 # type: verbatim
24634 #. type: verbatim
24635 #: ../fish/guestfish-actions.pod:1153
24636 #, no-wrap
24637 msgid ""
24638 " find directory\n"
24639 "\n"
24640 msgstr ""
24641
24642 # type: textblock
24643 #. type: textblock
24644 #: ../fish/guestfish-actions.pod:1167
24645 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
24646 msgstr ""
24647
24648 # type: textblock
24649 #. type: textblock
24650 #: ../fish/guestfish-actions.pod:1180
24651 msgid "See also L</find0>."
24652 msgstr ""
24653
24654 # type: =head2
24655 #. type: =head2
24656 #: ../fish/guestfish-actions.pod:1185
24657 msgid "find0"
24658 msgstr ""
24659
24660 # type: verbatim
24661 #. type: verbatim
24662 #: ../fish/guestfish-actions.pod:1187
24663 #, no-wrap
24664 msgid ""
24665 " find0 directory (files|-)\n"
24666 "\n"
24667 msgstr ""
24668
24669 # type: textblock
24670 #. type: textblock
24671 #: ../fish/guestfish-actions.pod:1193
24672 msgid ""
24673 "This command works the same way as L</find> with the following exceptions:"
24674 msgstr ""
24675
24676 # type: =head2
24677 #. type: =head2
24678 #: ../fish/guestfish-actions.pod:1220
24679 msgid "findfs-label"
24680 msgstr ""
24681
24682 # type: verbatim
24683 #. type: verbatim
24684 #: ../fish/guestfish-actions.pod:1222
24685 #, no-wrap
24686 msgid ""
24687 " findfs-label label\n"
24688 "\n"
24689 msgstr ""
24690
24691 # type: textblock
24692 #. type: textblock
24693 #: ../fish/guestfish-actions.pod:1228
24694 msgid "To find the label of a filesystem, use L</vfs-label>."
24695 msgstr ""
24696
24697 # type: =head2
24698 #. type: =head2
24699 #: ../fish/guestfish-actions.pod:1230
24700 msgid "findfs-uuid"
24701 msgstr ""
24702
24703 # type: verbatim
24704 #. type: verbatim
24705 #: ../fish/guestfish-actions.pod:1232
24706 #, no-wrap
24707 msgid ""
24708 " findfs-uuid uuid\n"
24709 "\n"
24710 msgstr ""
24711
24712 # type: textblock
24713 #. type: textblock
24714 #: ../fish/guestfish-actions.pod:1238
24715 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
24716 msgstr ""
24717
24718 # type: =head2
24719 #. type: =head2
24720 #: ../fish/guestfish-actions.pod:1240
24721 msgid "fsck"
24722 msgstr ""
24723
24724 # type: verbatim
24725 #. type: verbatim
24726 #: ../fish/guestfish-actions.pod:1242
24727 #, no-wrap
24728 msgid ""
24729 " fsck fstype device\n"
24730 "\n"
24731 msgstr ""
24732
24733 # type: =head2
24734 #. type: =head2
24735 #: ../fish/guestfish-actions.pod:1272
24736 msgid "get-append"
24737 msgstr ""
24738
24739 # type: verbatim
24740 #. type: verbatim
24741 #: ../fish/guestfish-actions.pod:1274
24742 #, no-wrap
24743 msgid ""
24744 " get-append\n"
24745 "\n"
24746 msgstr ""
24747
24748 # type: =head2
24749 #. type: =head2
24750 #: ../fish/guestfish-actions.pod:1281
24751 msgid "get-autosync"
24752 msgstr ""
24753
24754 # type: verbatim
24755 #. type: verbatim
24756 #: ../fish/guestfish-actions.pod:1283
24757 #, no-wrap
24758 msgid ""
24759 " get-autosync\n"
24760 "\n"
24761 msgstr ""
24762
24763 # type: =head2
24764 #. type: =head2
24765 #: ../fish/guestfish-actions.pod:1287
24766 msgid "get-direct"
24767 msgstr ""
24768
24769 # type: verbatim
24770 #. type: verbatim
24771 #: ../fish/guestfish-actions.pod:1289
24772 #, no-wrap
24773 msgid ""
24774 " get-direct\n"
24775 "\n"
24776 msgstr ""
24777
24778 # type: =head2
24779 #. type: =head2
24780 #: ../fish/guestfish-actions.pod:1293
24781 msgid "get-e2label"
24782 msgstr ""
24783
24784 # type: verbatim
24785 #. type: verbatim
24786 #: ../fish/guestfish-actions.pod:1295
24787 #, no-wrap
24788 msgid ""
24789 " get-e2label device\n"
24790 "\n"
24791 msgstr ""
24792
24793 #. type: textblock
24794 #: ../fish/guestfish-actions.pod:1300
24795 msgid ""
24796 "This function is deprecated.  In new code, use the L</vfs_label> call "
24797 "instead."
24798 msgstr ""
24799
24800 # type: =head2
24801 #. type: =head2
24802 #: ../fish/guestfish-actions.pod:1307
24803 msgid "get-e2uuid"
24804 msgstr ""
24805
24806 # type: verbatim
24807 #. type: verbatim
24808 #: ../fish/guestfish-actions.pod:1309
24809 #, no-wrap
24810 msgid ""
24811 " get-e2uuid device\n"
24812 "\n"
24813 msgstr ""
24814
24815 #. type: textblock
24816 #: ../fish/guestfish-actions.pod:1314
24817 msgid ""
24818 "This function is deprecated.  In new code, use the L</vfs_uuid> call instead."
24819 msgstr ""
24820
24821 # type: =head2
24822 #. type: =head2
24823 #: ../fish/guestfish-actions.pod:1321
24824 msgid "get-memsize"
24825 msgstr ""
24826
24827 # type: verbatim
24828 #. type: verbatim
24829 #: ../fish/guestfish-actions.pod:1323
24830 #, no-wrap
24831 msgid ""
24832 " get-memsize\n"
24833 "\n"
24834 msgstr ""
24835
24836 # type: textblock
24837 #. type: textblock
24838 #: ../fish/guestfish-actions.pod:1328
24839 msgid ""
24840 "If L</set-memsize> was not called on this handle, and if "
24841 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
24842 "value for memsize."
24843 msgstr ""
24844
24845 # type: =head2
24846 #. type: =head2
24847 #: ../fish/guestfish-actions.pod:1335
24848 msgid "get-network"
24849 msgstr ""
24850
24851 # type: verbatim
24852 #. type: verbatim
24853 #: ../fish/guestfish-actions.pod:1337
24854 #, no-wrap
24855 msgid ""
24856 " get-network\n"
24857 "\n"
24858 msgstr ""
24859
24860 # type: =head2
24861 #. type: =head2
24862 #: ../fish/guestfish-actions.pod:1341
24863 msgid "get-path"
24864 msgstr ""
24865
24866 # type: verbatim
24867 #. type: verbatim
24868 #: ../fish/guestfish-actions.pod:1343
24869 #, no-wrap
24870 msgid ""
24871 " get-path\n"
24872 "\n"
24873 msgstr ""
24874
24875 # type: =head2
24876 #. type: =head2
24877 #: ../fish/guestfish-actions.pod:1350
24878 msgid "get-pid"
24879 msgstr ""
24880
24881 # type: =head2
24882 #. type: =head2
24883 #: ../fish/guestfish-actions.pod:1352
24884 msgid "pid"
24885 msgstr ""
24886
24887 # type: verbatim
24888 #. type: verbatim
24889 #: ../fish/guestfish-actions.pod:1354
24890 #, no-wrap
24891 msgid ""
24892 " get-pid\n"
24893 "\n"
24894 msgstr ""
24895
24896 # type: =head2
24897 #. type: =head2
24898 #: ../fish/guestfish-actions.pod:1361
24899 msgid "get-qemu"
24900 msgstr ""
24901
24902 # type: verbatim
24903 #. type: verbatim
24904 #: ../fish/guestfish-actions.pod:1363
24905 #, no-wrap
24906 msgid ""
24907 " get-qemu\n"
24908 "\n"
24909 msgstr ""
24910
24911 # type: =head2
24912 #. type: =head2
24913 #: ../fish/guestfish-actions.pod:1370
24914 msgid "get-recovery-proc"
24915 msgstr ""
24916
24917 # type: verbatim
24918 #. type: verbatim
24919 #: ../fish/guestfish-actions.pod:1372
24920 #, no-wrap
24921 msgid ""
24922 " get-recovery-proc\n"
24923 "\n"
24924 msgstr ""
24925
24926 # type: =head2
24927 #. type: =head2
24928 #: ../fish/guestfish-actions.pod:1376
24929 msgid "get-selinux"
24930 msgstr ""
24931
24932 # type: verbatim
24933 #. type: verbatim
24934 #: ../fish/guestfish-actions.pod:1378
24935 #, no-wrap
24936 msgid ""
24937 " get-selinux\n"
24938 "\n"
24939 msgstr ""
24940
24941 # type: textblock
24942 #. type: textblock
24943 #: ../fish/guestfish-actions.pod:1380
24944 msgid ""
24945 "This returns the current setting of the selinux flag which is passed to the "
24946 "appliance at boot time.  See L</set-selinux>."
24947 msgstr ""
24948
24949 # type: =head2
24950 #. type: =head2
24951 #: ../fish/guestfish-actions.pod:1386
24952 msgid "get-state"
24953 msgstr ""
24954
24955 # type: verbatim
24956 #. type: verbatim
24957 #: ../fish/guestfish-actions.pod:1388
24958 #, no-wrap
24959 msgid ""
24960 " get-state\n"
24961 "\n"
24962 msgstr ""
24963
24964 # type: =head2
24965 #. type: =head2
24966 #: ../fish/guestfish-actions.pod:1395
24967 msgid "get-trace"
24968 msgstr ""
24969
24970 # type: verbatim
24971 #. type: verbatim
24972 #: ../fish/guestfish-actions.pod:1397
24973 #, no-wrap
24974 msgid ""
24975 " get-trace\n"
24976 "\n"
24977 msgstr ""
24978
24979 # type: =head2
24980 #. type: =head2
24981 #: ../fish/guestfish-actions.pod:1401
24982 msgid "get-umask"
24983 msgstr ""
24984
24985 # type: verbatim
24986 #. type: verbatim
24987 #: ../fish/guestfish-actions.pod:1403
24988 #, no-wrap
24989 msgid ""
24990 " get-umask\n"
24991 "\n"
24992 msgstr ""
24993
24994 # type: textblock
24995 #. type: textblock
24996 #: ../fish/guestfish-actions.pod:1405
24997 msgid ""
24998 "Return the current umask.  By default the umask is C<022> unless it has been "
24999 "set by calling L</umask>."
25000 msgstr ""
25001
25002 # type: =head2
25003 #. type: =head2
25004 #: ../fish/guestfish-actions.pod:1408
25005 msgid "get-verbose"
25006 msgstr ""
25007
25008 # type: verbatim
25009 #. type: verbatim
25010 #: ../fish/guestfish-actions.pod:1410
25011 #, no-wrap
25012 msgid ""
25013 " get-verbose\n"
25014 "\n"
25015 msgstr ""
25016
25017 # type: =head2
25018 #. type: =head2
25019 #: ../fish/guestfish-actions.pod:1414
25020 msgid "getcon"
25021 msgstr ""
25022
25023 # type: verbatim
25024 #. type: verbatim
25025 #: ../fish/guestfish-actions.pod:1416
25026 #, no-wrap
25027 msgid ""
25028 " getcon\n"
25029 "\n"
25030 msgstr ""
25031
25032 # type: textblock
25033 #. type: textblock
25034 #: ../fish/guestfish-actions.pod:1420
25035 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
25036 msgstr ""
25037
25038 # type: =head2
25039 #. type: =head2
25040 #: ../fish/guestfish-actions.pod:1423
25041 msgid "getxattr"
25042 msgstr ""
25043
25044 # type: verbatim
25045 #. type: verbatim
25046 #: ../fish/guestfish-actions.pod:1425
25047 #, no-wrap
25048 msgid ""
25049 " getxattr path name\n"
25050 "\n"
25051 msgstr ""
25052
25053 # type: textblock
25054 #. type: textblock
25055 #: ../fish/guestfish-actions.pod:1427
25056 msgid ""
25057 "Get a single extended attribute from file C<path> named C<name>.  This call "
25058 "follows symlinks.  If you want to lookup an extended attribute for the "
25059 "symlink itself, use L</lgetxattr>."
25060 msgstr ""
25061
25062 # type: textblock
25063 #. type: textblock
25064 #: ../fish/guestfish-actions.pod:1431 ../fish/guestfish-actions.pod:2262
25065 msgid ""
25066 "Normally it is better to get all extended attributes from a file in one go "
25067 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
25068 "buggy and do not provide a way to list out attributes.  For these "
25069 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
25070 "attributes you want in advance and call this function."
25071 msgstr ""
25072
25073 # type: textblock
25074 #. type: textblock
25075 #: ../fish/guestfish-actions.pod:1441
25076 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
25077 msgstr ""
25078
25079 # type: =head2
25080 #. type: =head2
25081 #: ../fish/guestfish-actions.pod:1443
25082 msgid "getxattrs"
25083 msgstr ""
25084
25085 # type: verbatim
25086 #. type: verbatim
25087 #: ../fish/guestfish-actions.pod:1445
25088 #, no-wrap
25089 msgid ""
25090 " getxattrs path\n"
25091 "\n"
25092 msgstr ""
25093
25094 # type: textblock
25095 #. type: textblock
25096 #: ../fish/guestfish-actions.pod:1453
25097 msgid "See also: L</lgetxattrs>, L<attr(5)>."
25098 msgstr ""
25099
25100 # type: =head2
25101 #. type: =head2
25102 #: ../fish/guestfish-actions.pod:1455
25103 msgid "glob-expand"
25104 msgstr ""
25105
25106 # type: verbatim
25107 #. type: verbatim
25108 #: ../fish/guestfish-actions.pod:1457
25109 #, no-wrap
25110 msgid ""
25111 " glob-expand pattern\n"
25112 "\n"
25113 msgstr ""
25114
25115 # type: =head2
25116 #. type: =head2
25117 #: ../fish/guestfish-actions.pod:1470
25118 msgid "grep"
25119 msgstr ""
25120
25121 # type: verbatim
25122 #. type: verbatim
25123 #: ../fish/guestfish-actions.pod:1472
25124 #, no-wrap
25125 msgid ""
25126 " grep regex path\n"
25127 "\n"
25128 msgstr ""
25129
25130 # type: =head2
25131 #. type: =head2
25132 #: ../fish/guestfish-actions.pod:1480
25133 msgid "grepi"
25134 msgstr ""
25135
25136 # type: verbatim
25137 #. type: verbatim
25138 #: ../fish/guestfish-actions.pod:1482
25139 #, no-wrap
25140 msgid ""
25141 " grepi regex path\n"
25142 "\n"
25143 msgstr ""
25144
25145 # type: =head2
25146 #. type: =head2
25147 #: ../fish/guestfish-actions.pod:1490
25148 msgid "grub-install"
25149 msgstr ""
25150
25151 # type: verbatim
25152 #. type: verbatim
25153 #: ../fish/guestfish-actions.pod:1492
25154 #, no-wrap
25155 msgid ""
25156 " grub-install root device\n"
25157 "\n"
25158 msgstr ""
25159
25160 # type: =head2
25161 #. type: =head2
25162 #: ../fish/guestfish-actions.pod:1508
25163 msgid "head"
25164 msgstr ""
25165
25166 # type: verbatim
25167 #. type: verbatim
25168 #: ../fish/guestfish-actions.pod:1510
25169 #, no-wrap
25170 msgid ""
25171 " head path\n"
25172 "\n"
25173 msgstr ""
25174
25175 # type: =head2
25176 #. type: =head2
25177 #: ../fish/guestfish-actions.pod:1518
25178 msgid "head-n"
25179 msgstr ""
25180
25181 # type: verbatim
25182 #. type: verbatim
25183 #: ../fish/guestfish-actions.pod:1520
25184 #, no-wrap
25185 msgid ""
25186 " head-n nrlines path\n"
25187 "\n"
25188 msgstr ""
25189
25190 # type: =head2
25191 #. type: =head2
25192 #: ../fish/guestfish-actions.pod:1533
25193 msgid "hexdump"
25194 msgstr ""
25195
25196 # type: verbatim
25197 #. type: verbatim
25198 #: ../fish/guestfish-actions.pod:1535
25199 #, no-wrap
25200 msgid ""
25201 " hexdump path\n"
25202 "\n"
25203 msgstr ""
25204
25205 # type: =head2
25206 #. type: =head2
25207 #: ../fish/guestfish-actions.pod:1543
25208 msgid "initrd-cat"
25209 msgstr ""
25210
25211 # type: verbatim
25212 #. type: verbatim
25213 #: ../fish/guestfish-actions.pod:1545
25214 #, no-wrap
25215 msgid ""
25216 " initrd-cat initrdpath filename\n"
25217 "\n"
25218 msgstr ""
25219
25220 # type: textblock
25221 #. type: textblock
25222 #: ../fish/guestfish-actions.pod:1557
25223 msgid "See also L</initrd-list>."
25224 msgstr ""
25225
25226 # type: =head2
25227 #. type: =head2
25228 #: ../fish/guestfish-actions.pod:1562
25229 msgid "initrd-list"
25230 msgstr ""
25231
25232 # type: verbatim
25233 #. type: verbatim
25234 #: ../fish/guestfish-actions.pod:1564
25235 #, no-wrap
25236 msgid ""
25237 " initrd-list path\n"
25238 "\n"
25239 msgstr ""
25240
25241 # type: =head2
25242 #. type: =head2
25243 #: ../fish/guestfish-actions.pod:1576
25244 msgid "inotify-add-watch"
25245 msgstr ""
25246
25247 # type: verbatim
25248 #. type: verbatim
25249 #: ../fish/guestfish-actions.pod:1578
25250 #, no-wrap
25251 msgid ""
25252 " inotify-add-watch path mask\n"
25253 "\n"
25254 msgstr ""
25255
25256 # type: =head2
25257 #. type: =head2
25258 #: ../fish/guestfish-actions.pod:1590
25259 msgid "inotify-close"
25260 msgstr ""
25261
25262 # type: verbatim
25263 #. type: verbatim
25264 #: ../fish/guestfish-actions.pod:1592
25265 #, no-wrap
25266 msgid ""
25267 " inotify-close\n"
25268 "\n"
25269 msgstr ""
25270
25271 # type: =head2
25272 #. type: =head2
25273 #: ../fish/guestfish-actions.pod:1598
25274 msgid "inotify-files"
25275 msgstr ""
25276
25277 # type: verbatim
25278 #. type: verbatim
25279 #: ../fish/guestfish-actions.pod:1600
25280 #, no-wrap
25281 msgid ""
25282 " inotify-files\n"
25283 "\n"
25284 msgstr ""
25285
25286 # type: textblock
25287 #. type: textblock
25288 #: ../fish/guestfish-actions.pod:1602
25289 msgid ""
25290 "This function is a helpful wrapper around L</inotify-read> which just "
25291 "returns a list of pathnames of objects that were touched.  The returned "
25292 "pathnames are sorted and deduplicated."
25293 msgstr ""
25294
25295 # type: =head2
25296 #. type: =head2
25297 #: ../fish/guestfish-actions.pod:1606
25298 msgid "inotify-init"
25299 msgstr ""
25300
25301 # type: verbatim
25302 #. type: verbatim
25303 #: ../fish/guestfish-actions.pod:1608
25304 #, no-wrap
25305 msgid ""
25306 " inotify-init maxevents\n"
25307 "\n"
25308 msgstr ""
25309
25310 # type: textblock
25311 #. type: textblock
25312 #: ../fish/guestfish-actions.pod:1614
25313 msgid ""
25314 "C<maxevents> is the maximum number of events which will be queued up between "
25315 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
25316 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
25317 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
25318 "but records the fact that it threw them away by setting a flag "
25319 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
25320 msgstr ""
25321
25322 # type: textblock
25323 #. type: textblock
25324 #: ../fish/guestfish-actions.pod:1624
25325 msgid ""
25326 "Before any events are generated, you have to add some watches to the "
25327 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
25328 "L</inotify-watch-all>."
25329 msgstr ""
25330
25331 # type: textblock
25332 #. type: textblock
25333 #: ../fish/guestfish-actions.pod:1630
25334 msgid ""
25335 "Queued up events should be read periodically by calling L</inotify-read> (or "
25336 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
25337 "If you don't read the events out often enough then you risk the internal "
25338 "queue overflowing."
25339 msgstr ""
25340
25341 # type: textblock
25342 #. type: textblock
25343 #: ../fish/guestfish-actions.pod:1637
25344 msgid ""
25345 "The handle should be closed after use by calling L</inotify-close>.  This "
25346 "also removes any watches automatically."
25347 msgstr ""
25348
25349 # type: =head2
25350 #. type: =head2
25351 #: ../fish/guestfish-actions.pod:1646
25352 msgid "inotify-read"
25353 msgstr ""
25354
25355 # type: verbatim
25356 #. type: verbatim
25357 #: ../fish/guestfish-actions.pod:1648
25358 #, no-wrap
25359 msgid ""
25360 " inotify-read\n"
25361 "\n"
25362 msgstr ""
25363
25364 # type: =head2
25365 #. type: =head2
25366 #: ../fish/guestfish-actions.pod:1661
25367 msgid "inotify-rm-watch"
25368 msgstr ""
25369
25370 # type: verbatim
25371 #. type: verbatim
25372 #: ../fish/guestfish-actions.pod:1663
25373 #, no-wrap
25374 msgid ""
25375 " inotify-rm-watch wd\n"
25376 "\n"
25377 msgstr ""
25378
25379 # type: textblock
25380 #. type: textblock
25381 #: ../fish/guestfish-actions.pod:1665
25382 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
25383 msgstr ""
25384
25385 # type: =head2
25386 #. type: =head2
25387 #: ../fish/guestfish-actions.pod:1668
25388 msgid "inspect-get-arch"
25389 msgstr ""
25390
25391 # type: verbatim
25392 #. type: verbatim
25393 #: ../fish/guestfish-actions.pod:1670
25394 #, no-wrap
25395 msgid ""
25396 " inspect-get-arch root\n"
25397 "\n"
25398 msgstr ""
25399
25400 # type: textblock
25401 #. type: textblock
25402 #: ../fish/guestfish-actions.pod:1672 ../fish/guestfish-actions.pod:1688
25403 #: ../fish/guestfish-actions.pod:1762 ../fish/guestfish-actions.pod:1780
25404 #: ../fish/guestfish-actions.pod:1795 ../fish/guestfish-actions.pod:1816
25405 #: ../fish/guestfish-actions.pod:1831 ../fish/guestfish-actions.pod:1858
25406 #: ../fish/guestfish-actions.pod:1880 ../fish/guestfish-actions.pod:1904
25407 #: ../fish/guestfish-actions.pod:1934 ../fish/guestfish-actions.pod:1969
25408 #: ../fish/guestfish-actions.pod:1985
25409 msgid ""
25410 "This function should only be called with a root device string as returned by "
25411 "L</inspect-os>."
25412 msgstr ""
25413
25414 # type: textblock
25415 #. type: textblock
25416 #: ../fish/guestfish-actions.pod:1675
25417 msgid ""
25418 "This returns the architecture of the inspected operating system.  The "
25419 "possible return values are listed under L</file-architecture>."
25420 msgstr ""
25421
25422 # type: =head2
25423 #. type: =head2
25424 #: ../fish/guestfish-actions.pod:1684
25425 msgid "inspect-get-distro"
25426 msgstr ""
25427
25428 # type: verbatim
25429 #. type: verbatim
25430 #: ../fish/guestfish-actions.pod:1686
25431 #, no-wrap
25432 msgid ""
25433 " inspect-get-distro root\n"
25434 "\n"
25435 msgstr ""
25436
25437 # type: =head2
25438 #. type: =head2
25439 #: ../fish/guestfish-actions.pod:1758
25440 msgid "inspect-get-filesystems"
25441 msgstr ""
25442
25443 # type: verbatim
25444 #. type: verbatim
25445 #: ../fish/guestfish-actions.pod:1760
25446 #, no-wrap
25447 msgid ""
25448 " inspect-get-filesystems root\n"
25449 "\n"
25450 msgstr ""
25451
25452 # type: textblock
25453 #. type: textblock
25454 #: ../fish/guestfish-actions.pod:1773
25455 msgid ""
25456 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25457 "get-mountpoints>."
25458 msgstr ""
25459
25460 # type: =head2
25461 #. type: =head2
25462 #: ../fish/guestfish-actions.pod:1776
25463 msgid "inspect-get-hostname"
25464 msgstr ""
25465
25466 # type: verbatim
25467 #. type: verbatim
25468 #: ../fish/guestfish-actions.pod:1778
25469 #, no-wrap
25470 msgid ""
25471 " inspect-get-hostname root\n"
25472 "\n"
25473 msgstr ""
25474
25475 # type: =head2
25476 #. type: =head2
25477 #: ../fish/guestfish-actions.pod:1791
25478 msgid "inspect-get-major-version"
25479 msgstr ""
25480
25481 # type: verbatim
25482 #. type: verbatim
25483 #: ../fish/guestfish-actions.pod:1793
25484 #, no-wrap
25485 msgid ""
25486 " inspect-get-major-version root\n"
25487 "\n"
25488 msgstr ""
25489
25490 # type: =head2
25491 #. type: =head2
25492 #: ../fish/guestfish-actions.pod:1812
25493 msgid "inspect-get-minor-version"
25494 msgstr ""
25495
25496 # type: verbatim
25497 #. type: verbatim
25498 #: ../fish/guestfish-actions.pod:1814
25499 #, no-wrap
25500 msgid ""
25501 " inspect-get-minor-version root\n"
25502 "\n"
25503 msgstr ""
25504
25505 # type: textblock
25506 #. type: textblock
25507 #: ../fish/guestfish-actions.pod:1824
25508 msgid ""
25509 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25510 "get-major-version>."
25511 msgstr ""
25512
25513 # type: =head2
25514 #. type: =head2
25515 #: ../fish/guestfish-actions.pod:1827
25516 msgid "inspect-get-mountpoints"
25517 msgstr ""
25518
25519 # type: verbatim
25520 #. type: verbatim
25521 #: ../fish/guestfish-actions.pod:1829
25522 #, no-wrap
25523 msgid ""
25524 " inspect-get-mountpoints root\n"
25525 "\n"
25526 msgstr ""
25527
25528 # type: textblock
25529 #. type: textblock
25530 #: ../fish/guestfish-actions.pod:1851
25531 msgid ""
25532 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25533 "get-filesystems>."
25534 msgstr ""
25535
25536 # type: =head2
25537 #. type: =head2
25538 #: ../fish/guestfish-actions.pod:1854
25539 msgid "inspect-get-package-format"
25540 msgstr ""
25541
25542 # type: verbatim
25543 #. type: verbatim
25544 #: ../fish/guestfish-actions.pod:1856
25545 #, no-wrap
25546 msgid ""
25547 " inspect-get-package-format root\n"
25548 "\n"
25549 msgstr ""
25550
25551 # type: textblock
25552 #. type: textblock
25553 #: ../fish/guestfish-actions.pod:1861
25554 msgid ""
25555 "This function and L</inspect-get-package-management> return the package "
25556 "format and package management tool used by the inspected operating system.  "
25557 "For example for Fedora these functions would return C<rpm> (package format) "
25558 "and C<yum> (package management)."
25559 msgstr ""
25560
25561 # type: =head2
25562 #. type: =head2
25563 #: ../fish/guestfish-actions.pod:1876
25564 msgid "inspect-get-package-management"
25565 msgstr ""
25566
25567 # type: verbatim
25568 #. type: verbatim
25569 #: ../fish/guestfish-actions.pod:1878
25570 #, no-wrap
25571 msgid ""
25572 " inspect-get-package-management root\n"
25573 "\n"
25574 msgstr ""
25575
25576 # type: textblock
25577 #. type: textblock
25578 #: ../fish/guestfish-actions.pod:1883
25579 msgid ""
25580 "L</inspect-get-package-format> and this function return the package format "
25581 "and package management tool used by the inspected operating system.  For "
25582 "example for Fedora these functions would return C<rpm> (package format) and "
25583 "C<yum> (package management)."
25584 msgstr ""
25585
25586 # type: =head2
25587 #. type: =head2
25588 #: ../fish/guestfish-actions.pod:1900
25589 msgid "inspect-get-product-name"
25590 msgstr ""
25591
25592 # type: verbatim
25593 #. type: verbatim
25594 #: ../fish/guestfish-actions.pod:1902
25595 #, no-wrap
25596 msgid ""
25597 " inspect-get-product-name root\n"
25598 "\n"
25599 msgstr ""
25600
25601 # type: =head2
25602 #. type: =head2
25603 #: ../fish/guestfish-actions.pod:1917
25604 msgid "inspect-get-roots"
25605 msgstr ""
25606
25607 # type: verbatim
25608 #. type: verbatim
25609 #: ../fish/guestfish-actions.pod:1919
25610 #, no-wrap
25611 msgid ""
25612 " inspect-get-roots\n"
25613 "\n"
25614 msgstr ""
25615
25616 # type: textblock
25617 #. type: textblock
25618 #: ../fish/guestfish-actions.pod:1921
25619 msgid ""
25620 "This function is a convenient way to get the list of root devices, as "
25621 "returned from a previous call to L</inspect-os>, but without redoing the "
25622 "whole inspection process."
25623 msgstr ""
25624
25625 # type: textblock
25626 #. type: textblock
25627 #: ../fish/guestfish-actions.pod:1925
25628 msgid ""
25629 "This returns an empty list if either no root devices were found or the "
25630 "caller has not called L</inspect-os>."
25631 msgstr ""
25632
25633 # type: =head2
25634 #. type: =head2
25635 #: ../fish/guestfish-actions.pod:1930
25636 msgid "inspect-get-type"
25637 msgstr ""
25638
25639 # type: verbatim
25640 #. type: verbatim
25641 #: ../fish/guestfish-actions.pod:1932
25642 #, no-wrap
25643 msgid ""
25644 " inspect-get-type root\n"
25645 "\n"
25646 msgstr ""
25647
25648 # type: =head2
25649 #. type: =head2
25650 #: ../fish/guestfish-actions.pod:1965
25651 msgid "inspect-get-windows-systemroot"
25652 msgstr ""
25653
25654 # type: verbatim
25655 #. type: verbatim
25656 #: ../fish/guestfish-actions.pod:1967
25657 #, no-wrap
25658 msgid ""
25659 " inspect-get-windows-systemroot root\n"
25660 "\n"
25661 msgstr ""
25662
25663 # type: =head2
25664 #. type: =head2
25665 #: ../fish/guestfish-actions.pod:1981
25666 msgid "inspect-list-applications"
25667 msgstr ""
25668
25669 # type: verbatim
25670 #. type: verbatim
25671 #: ../fish/guestfish-actions.pod:1983
25672 #, no-wrap
25673 msgid ""
25674 " inspect-list-applications root\n"
25675 "\n"
25676 msgstr ""
25677
25678 # type: textblock
25679 #. type: textblock
25680 #: ../fish/guestfish-actions.pod:1990
25681 msgid ""
25682 "I<Note:> This call works differently from other parts of the inspection "
25683 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
25684 "then mount up the disks, before calling this.  Listing applications is a "
25685 "significantly more difficult operation which requires access to the full "
25686 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
25687 "are just returning data cached in the libguestfs handle, this call actually "
25688 "reads parts of the mounted filesystems during the call."
25689 msgstr ""
25690
25691 # type: =head2
25692 #. type: =head2
25693 #: ../fish/guestfish-actions.pod:2080
25694 msgid "inspect-os"
25695 msgstr ""
25696
25697 # type: verbatim
25698 #. type: verbatim
25699 #: ../fish/guestfish-actions.pod:2082
25700 #, no-wrap
25701 msgid ""
25702 " inspect-os\n"
25703 "\n"
25704 msgstr ""
25705
25706 # type: textblock
25707 #. type: textblock
25708 #: ../fish/guestfish-actions.pod:2097
25709 msgid ""
25710 "You can pass the root string(s) returned to other L</inspect-get-*> "
25711 "functions in order to query further information about each operating system, "
25712 "such as the name and version."
25713 msgstr ""
25714
25715 # type: textblock
25716 #. type: textblock
25717 #: ../fish/guestfish-actions.pod:2102
25718 msgid ""
25719 "This function uses other libguestfs features such as L</mount-ro> and L</"
25720 "umount-all> in order to mount and unmount filesystems and look at the "
25721 "contents.  This should be called with no disks currently mounted.  The "
25722 "function may also use Augeas, so any existing Augeas handle will be closed."
25723 msgstr ""
25724
25725 # type: textblock
25726 #. type: textblock
25727 #: ../fish/guestfish-actions.pod:2114 ../fish/guestfish-actions.pod:2290
25728 #: ../fish/guestfish-actions.pod:2336
25729 msgid "See also L</list-filesystems>."
25730 msgstr ""
25731
25732 # type: =head2
25733 #. type: =head2
25734 #: ../fish/guestfish-actions.pod:2116
25735 msgid "is-blockdev"
25736 msgstr ""
25737
25738 # type: verbatim
25739 #. type: verbatim
25740 #: ../fish/guestfish-actions.pod:2118
25741 #, no-wrap
25742 msgid ""
25743 " is-blockdev path\n"
25744 "\n"
25745 msgstr ""
25746
25747 # type: textblock
25748 #. type: textblock
25749 #: ../fish/guestfish-actions.pod:2123 ../fish/guestfish-actions.pod:2141
25750 #: ../fish/guestfish-actions.pod:2160 ../fish/guestfish-actions.pod:2169
25751 #: ../fish/guestfish-actions.pod:2179 ../fish/guestfish-actions.pod:2213
25752 #: ../fish/guestfish-actions.pod:2222
25753 msgid "See also L</stat>."
25754 msgstr ""
25755
25756 # type: =head2
25757 #. type: =head2
25758 #: ../fish/guestfish-actions.pod:2125
25759 msgid "is-busy"
25760 msgstr ""
25761
25762 # type: verbatim
25763 #. type: verbatim
25764 #: ../fish/guestfish-actions.pod:2127
25765 #, no-wrap
25766 msgid ""
25767 " is-busy\n"
25768 "\n"
25769 msgstr ""
25770
25771 # type: =head2
25772 #. type: =head2
25773 #: ../fish/guestfish-actions.pod:2134
25774 msgid "is-chardev"
25775 msgstr ""
25776
25777 # type: verbatim
25778 #. type: verbatim
25779 #: ../fish/guestfish-actions.pod:2136
25780 #, no-wrap
25781 msgid ""
25782 " is-chardev path\n"
25783 "\n"
25784 msgstr ""
25785
25786 # type: =head2
25787 #. type: =head2
25788 #: ../fish/guestfish-actions.pod:2143
25789 msgid "is-config"
25790 msgstr ""
25791
25792 # type: verbatim
25793 #. type: verbatim
25794 #: ../fish/guestfish-actions.pod:2145
25795 #, no-wrap
25796 msgid ""
25797 " is-config\n"
25798 "\n"
25799 msgstr ""
25800
25801 # type: =head2
25802 #. type: =head2
25803 #: ../fish/guestfish-actions.pod:2152
25804 msgid "is-dir"
25805 msgstr ""
25806
25807 # type: verbatim
25808 #. type: verbatim
25809 #: ../fish/guestfish-actions.pod:2154
25810 #, no-wrap
25811 msgid ""
25812 " is-dir path\n"
25813 "\n"
25814 msgstr ""
25815
25816 # type: =head2
25817 #. type: =head2
25818 #: ../fish/guestfish-actions.pod:2162
25819 msgid "is-fifo"
25820 msgstr ""
25821
25822 # type: verbatim
25823 #. type: verbatim
25824 #: ../fish/guestfish-actions.pod:2164
25825 #, no-wrap
25826 msgid ""
25827 " is-fifo path\n"
25828 "\n"
25829 msgstr ""
25830
25831 # type: =head2
25832 #. type: =head2
25833 #: ../fish/guestfish-actions.pod:2171
25834 msgid "is-file"
25835 msgstr ""
25836
25837 # type: verbatim
25838 #. type: verbatim
25839 #: ../fish/guestfish-actions.pod:2173
25840 #, no-wrap
25841 msgid ""
25842 " is-file path\n"
25843 "\n"
25844 msgstr ""
25845
25846 # type: =head2
25847 #. type: =head2
25848 #: ../fish/guestfish-actions.pod:2181
25849 msgid "is-launching"
25850 msgstr ""
25851
25852 # type: verbatim
25853 #. type: verbatim
25854 #: ../fish/guestfish-actions.pod:2183
25855 #, no-wrap
25856 msgid ""
25857 " is-launching\n"
25858 "\n"
25859 msgstr ""
25860
25861 # type: =head2
25862 #. type: =head2
25863 #: ../fish/guestfish-actions.pod:2190
25864 msgid "is-lv"
25865 msgstr ""
25866
25867 # type: verbatim
25868 #. type: verbatim
25869 #: ../fish/guestfish-actions.pod:2192
25870 #, no-wrap
25871 msgid ""
25872 " is-lv device\n"
25873 "\n"
25874 msgstr ""
25875
25876 # type: =head2
25877 #. type: =head2
25878 #: ../fish/guestfish-actions.pod:2197
25879 msgid "is-ready"
25880 msgstr ""
25881
25882 # type: verbatim
25883 #. type: verbatim
25884 #: ../fish/guestfish-actions.pod:2199
25885 #, no-wrap
25886 msgid ""
25887 " is-ready\n"
25888 "\n"
25889 msgstr ""
25890
25891 # type: =head2
25892 #. type: =head2
25893 #: ../fish/guestfish-actions.pod:2206
25894 msgid "is-socket"
25895 msgstr ""
25896
25897 # type: verbatim
25898 #. type: verbatim
25899 #: ../fish/guestfish-actions.pod:2208
25900 #, no-wrap
25901 msgid ""
25902 " is-socket path\n"
25903 "\n"
25904 msgstr ""
25905
25906 # type: =head2
25907 #. type: =head2
25908 #: ../fish/guestfish-actions.pod:2215
25909 msgid "is-symlink"
25910 msgstr ""
25911
25912 # type: verbatim
25913 #. type: verbatim
25914 #: ../fish/guestfish-actions.pod:2217
25915 #, no-wrap
25916 msgid ""
25917 " is-symlink path\n"
25918 "\n"
25919 msgstr ""
25920
25921 # type: =head2
25922 #. type: =head2
25923 #: ../fish/guestfish-actions.pod:2224
25924 msgid "kill-subprocess"
25925 msgstr ""
25926
25927 # type: verbatim
25928 #. type: verbatim
25929 #: ../fish/guestfish-actions.pod:2226
25930 #, no-wrap
25931 msgid ""
25932 " kill-subprocess\n"
25933 "\n"
25934 msgstr ""
25935
25936 # type: =head2
25937 #. type: =head2
25938 #: ../fish/guestfish-actions.pod:2230
25939 msgid "launch"
25940 msgstr ""
25941
25942 # type: =head2
25943 #. type: =head2
25944 #: ../fish/guestfish-actions.pod:2232
25945 msgid "run"
25946 msgstr ""
25947
25948 # type: verbatim
25949 #. type: verbatim
25950 #: ../fish/guestfish-actions.pod:2234
25951 #, no-wrap
25952 msgid ""
25953 " launch\n"
25954 "\n"
25955 msgstr ""
25956
25957 # type: =head2
25958 #. type: =head2
25959 #: ../fish/guestfish-actions.pod:2242
25960 msgid "lchown"
25961 msgstr ""
25962
25963 # type: verbatim
25964 #. type: verbatim
25965 #: ../fish/guestfish-actions.pod:2244
25966 #, no-wrap
25967 msgid ""
25968 " lchown owner group path\n"
25969 "\n"
25970 msgstr ""
25971
25972 # type: textblock
25973 #. type: textblock
25974 #: ../fish/guestfish-actions.pod:2246
25975 msgid ""
25976 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
25977 "chown> but if C<path> is a symlink then the link itself is changed, not the "
25978 "target."
25979 msgstr ""
25980
25981 # type: =head2
25982 #. type: =head2
25983 #: ../fish/guestfish-actions.pod:2254
25984 msgid "lgetxattr"
25985 msgstr ""
25986
25987 # type: verbatim
25988 #. type: verbatim
25989 #: ../fish/guestfish-actions.pod:2256
25990 #, no-wrap
25991 msgid ""
25992 " lgetxattr path name\n"
25993 "\n"
25994 msgstr ""
25995
25996 # type: textblock
25997 #. type: textblock
25998 #: ../fish/guestfish-actions.pod:2272
25999 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
26000 msgstr ""
26001
26002 # type: =head2
26003 #. type: =head2
26004 #: ../fish/guestfish-actions.pod:2274
26005 msgid "lgetxattrs"
26006 msgstr ""
26007
26008 # type: verbatim
26009 #. type: verbatim
26010 #: ../fish/guestfish-actions.pod:2276
26011 #, no-wrap
26012 msgid ""
26013 " lgetxattrs path\n"
26014 "\n"
26015 msgstr ""
26016
26017 # type: textblock
26018 #. type: textblock
26019 #: ../fish/guestfish-actions.pod:2278
26020 msgid ""
26021 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
26022 "it returns the extended attributes of the link itself."
26023 msgstr ""
26024
26025 # type: =head2
26026 #. type: =head2
26027 #: ../fish/guestfish-actions.pod:2282
26028 msgid "list-devices"
26029 msgstr ""
26030
26031 # type: verbatim
26032 #. type: verbatim
26033 #: ../fish/guestfish-actions.pod:2284
26034 #, no-wrap
26035 msgid ""
26036 " list-devices\n"
26037 "\n"
26038 msgstr ""
26039
26040 # type: =head2
26041 #. type: =head2
26042 #: ../fish/guestfish-actions.pod:2292
26043 msgid "list-filesystems"
26044 msgstr ""
26045
26046 # type: verbatim
26047 #. type: verbatim
26048 #: ../fish/guestfish-actions.pod:2294
26049 #, no-wrap
26050 msgid ""
26051 " list-filesystems\n"
26052 "\n"
26053 msgstr ""
26054
26055 # type: textblock
26056 #. type: textblock
26057 #: ../fish/guestfish-actions.pod:2313
26058 msgid ""
26059 "This command runs other libguestfs commands, which might include L</mount> "
26060 "and L</umount>, and therefore you should use this soon after launch and only "
26061 "when nothing is mounted."
26062 msgstr ""
26063
26064 # type: textblock
26065 #. type: textblock
26066 #: ../fish/guestfish-actions.pod:2317
26067 msgid ""
26068 "Not all of the filesystems returned will be mountable.  In particular, swap "
26069 "partitions are returned in the list.  Also this command does not check that "
26070 "each filesystem found is valid and mountable, and some filesystems might be "
26071 "mountable but require special options.  Filesystems may not all belong to a "
26072 "single logical operating system (use L</inspect-os> to look for OSes)."
26073 msgstr ""
26074
26075 # type: =head2
26076 #. type: =head2
26077 #: ../fish/guestfish-actions.pod:2325
26078 msgid "list-partitions"
26079 msgstr ""
26080
26081 # type: verbatim
26082 #. type: verbatim
26083 #: ../fish/guestfish-actions.pod:2327
26084 #, no-wrap
26085 msgid ""
26086 " list-partitions\n"
26087 "\n"
26088 msgstr ""
26089
26090 # type: textblock
26091 #. type: textblock
26092 #: ../fish/guestfish-actions.pod:2333
26093 msgid ""
26094 "This does not return logical volumes.  For that you will need to call L</"
26095 "lvs>."
26096 msgstr ""
26097
26098 # type: =head2
26099 #. type: =head2
26100 #: ../fish/guestfish-actions.pod:2338
26101 msgid "ll"
26102 msgstr ""
26103
26104 # type: verbatim
26105 #. type: verbatim
26106 #: ../fish/guestfish-actions.pod:2340
26107 #, no-wrap
26108 msgid ""
26109 " ll directory\n"
26110 "\n"
26111 msgstr ""
26112
26113 # type: =head2
26114 #. type: =head2
26115 #: ../fish/guestfish-actions.pod:2348
26116 msgid "ln"
26117 msgstr ""
26118
26119 # type: verbatim
26120 #. type: verbatim
26121 #: ../fish/guestfish-actions.pod:2350
26122 #, no-wrap
26123 msgid ""
26124 " ln target linkname\n"
26125 "\n"
26126 msgstr ""
26127
26128 # type: =head2
26129 #. type: =head2
26130 #: ../fish/guestfish-actions.pod:2354
26131 msgid "ln-f"
26132 msgstr ""
26133
26134 # type: verbatim
26135 #. type: verbatim
26136 #: ../fish/guestfish-actions.pod:2356
26137 #, no-wrap
26138 msgid ""
26139 " ln-f target linkname\n"
26140 "\n"
26141 msgstr ""
26142
26143 # type: =head2
26144 #. type: =head2
26145 #: ../fish/guestfish-actions.pod:2361
26146 msgid "ln-s"
26147 msgstr ""
26148
26149 # type: verbatim
26150 #. type: verbatim
26151 #: ../fish/guestfish-actions.pod:2363
26152 #, no-wrap
26153 msgid ""
26154 " ln-s target linkname\n"
26155 "\n"
26156 msgstr ""
26157
26158 # type: =head2
26159 #. type: =head2
26160 #: ../fish/guestfish-actions.pod:2367
26161 msgid "ln-sf"
26162 msgstr ""
26163
26164 # type: verbatim
26165 #. type: verbatim
26166 #: ../fish/guestfish-actions.pod:2369
26167 #, no-wrap
26168 msgid ""
26169 " ln-sf target linkname\n"
26170 "\n"
26171 msgstr ""
26172
26173 # type: =head2
26174 #. type: =head2
26175 #: ../fish/guestfish-actions.pod:2374
26176 msgid "lremovexattr"
26177 msgstr ""
26178
26179 # type: verbatim
26180 #. type: verbatim
26181 #: ../fish/guestfish-actions.pod:2376
26182 #, no-wrap
26183 msgid ""
26184 " lremovexattr xattr path\n"
26185 "\n"
26186 msgstr ""
26187
26188 # type: textblock
26189 #. type: textblock
26190 #: ../fish/guestfish-actions.pod:2378
26191 msgid ""
26192 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
26193 "it removes an extended attribute of the link itself."
26194 msgstr ""
26195
26196 # type: =head2
26197 #. type: =head2
26198 #: ../fish/guestfish-actions.pod:2382
26199 msgid "ls"
26200 msgstr ""
26201
26202 # type: verbatim
26203 #. type: verbatim
26204 #: ../fish/guestfish-actions.pod:2384
26205 #, no-wrap
26206 msgid ""
26207 " ls directory\n"
26208 "\n"
26209 msgstr ""
26210
26211 # type: textblock
26212 #. type: textblock
26213 #: ../fish/guestfish-actions.pod:2390
26214 msgid ""
26215 "This command is mostly useful for interactive sessions.  Programs should "
26216 "probably use L</readdir> instead."
26217 msgstr ""
26218
26219 # type: =head2
26220 #. type: =head2
26221 #: ../fish/guestfish-actions.pod:2393
26222 msgid "lsetxattr"
26223 msgstr ""
26224
26225 # type: verbatim
26226 #. type: verbatim
26227 #: ../fish/guestfish-actions.pod:2395
26228 #, no-wrap
26229 msgid ""
26230 " lsetxattr xattr val vallen path\n"
26231 "\n"
26232 msgstr ""
26233
26234 # type: textblock
26235 #. type: textblock
26236 #: ../fish/guestfish-actions.pod:2397
26237 msgid ""
26238 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
26239 "sets an extended attribute of the link itself."
26240 msgstr ""
26241
26242 # type: =head2
26243 #. type: =head2
26244 #: ../fish/guestfish-actions.pod:2401
26245 msgid "lstat"
26246 msgstr ""
26247
26248 # type: verbatim
26249 #. type: verbatim
26250 #: ../fish/guestfish-actions.pod:2403
26251 #, no-wrap
26252 msgid ""
26253 " lstat path\n"
26254 "\n"
26255 msgstr ""
26256
26257 # type: textblock
26258 #. type: textblock
26259 #: ../fish/guestfish-actions.pod:2407
26260 msgid ""
26261 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
26262 "the link is stat-ed, not the file it refers to."
26263 msgstr ""
26264
26265 # type: =head2
26266 #. type: =head2
26267 #: ../fish/guestfish-actions.pod:2413
26268 msgid "lstatlist"
26269 msgstr ""
26270
26271 # type: verbatim
26272 #. type: verbatim
26273 #: ../fish/guestfish-actions.pod:2415
26274 #, no-wrap
26275 msgid ""
26276 " lstatlist path 'names ...'\n"
26277 "\n"
26278 msgstr ""
26279
26280 # type: textblock
26281 #. type: textblock
26282 #: ../fish/guestfish-actions.pod:2417
26283 msgid ""
26284 "This call allows you to perform the L</lstat> operation on multiple files, "
26285 "where all files are in the directory C<path>.  C<names> is the list of files "
26286 "from this directory."
26287 msgstr ""
26288
26289 # type: textblock
26290 #. type: textblock
26291 #: ../fish/guestfish-actions.pod:2426
26292 msgid ""
26293 "This call is intended for programs that want to efficiently list a directory "
26294 "contents without making many round-trips.  See also L</lxattrlist> for a "
26295 "similarly efficient call for getting extended attributes.  Very long "
26296 "directory listings might cause the protocol message size to be exceeded, "
26297 "causing this call to fail.  The caller must split up such requests into "
26298 "smaller groups of names."
26299 msgstr ""
26300
26301 # type: =head2
26302 #. type: =head2
26303 #: ../fish/guestfish-actions.pod:2434
26304 msgid "luks-add-key"
26305 msgstr ""
26306
26307 # type: verbatim
26308 #. type: verbatim
26309 #: ../fish/guestfish-actions.pod:2436
26310 #, no-wrap
26311 msgid ""
26312 " luks-add-key device keyslot\n"
26313 "\n"
26314 msgstr ""
26315
26316 # type: textblock
26317 #. type: textblock
26318 #: ../fish/guestfish-actions.pod:2443
26319 msgid ""
26320 "Note that if C<keyslot> already contains a key, then this command will "
26321 "fail.  You have to use L</luks-kill-slot> first to remove that key."
26322 msgstr ""
26323
26324 # type: textblock
26325 #. type: textblock
26326 #: ../fish/guestfish-actions.pod:2447 ../fish/guestfish-actions.pod:2469
26327 #: ../fish/guestfish-actions.pod:2482 ../fish/guestfish-actions.pod:2496
26328 #: ../fish/guestfish-actions.pod:2519 ../fish/guestfish-actions.pod:2529
26329 msgid ""
26330 "This command has one or more key or passphrase parameters.  Guestfish will "
26331 "prompt for these separately."
26332 msgstr ""
26333
26334 # type: =head2
26335 #. type: =head2
26336 #: ../fish/guestfish-actions.pod:2450
26337 msgid "luks-close"
26338 msgstr ""
26339
26340 # type: verbatim
26341 #. type: verbatim
26342 #: ../fish/guestfish-actions.pod:2452
26343 #, no-wrap
26344 msgid ""
26345 " luks-close device\n"
26346 "\n"
26347 msgstr ""
26348
26349 # type: textblock
26350 #. type: textblock
26351 #: ../fish/guestfish-actions.pod:2454
26352 msgid ""
26353 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
26354 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
26355 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
26356 "block device."
26357 msgstr ""
26358
26359 # type: =head2
26360 #. type: =head2
26361 #: ../fish/guestfish-actions.pod:2460
26362 msgid "luks-format"
26363 msgstr ""
26364
26365 # type: verbatim
26366 #. type: verbatim
26367 #: ../fish/guestfish-actions.pod:2462
26368 #, no-wrap
26369 msgid ""
26370 " luks-format device keyslot\n"
26371 "\n"
26372 msgstr ""
26373
26374 # type: =head2
26375 #. type: =head2
26376 #: ../fish/guestfish-actions.pod:2475
26377 msgid "luks-format-cipher"
26378 msgstr ""
26379
26380 # type: verbatim
26381 #. type: verbatim
26382 #: ../fish/guestfish-actions.pod:2477
26383 #, no-wrap
26384 msgid ""
26385 " luks-format-cipher device keyslot cipher\n"
26386 "\n"
26387 msgstr ""
26388
26389 # type: textblock
26390 #. type: textblock
26391 #: ../fish/guestfish-actions.pod:2479
26392 msgid ""
26393 "This command is the same as L</luks-format> but it also allows you to set "
26394 "the C<cipher> used."
26395 msgstr ""
26396
26397 # type: =head2
26398 #. type: =head2
26399 #: ../fish/guestfish-actions.pod:2488
26400 msgid "luks-kill-slot"
26401 msgstr ""
26402
26403 # type: verbatim
26404 #. type: verbatim
26405 #: ../fish/guestfish-actions.pod:2490
26406 #, no-wrap
26407 msgid ""
26408 " luks-kill-slot device keyslot\n"
26409 "\n"
26410 msgstr ""
26411
26412 # type: =head2
26413 #. type: =head2
26414 #: ../fish/guestfish-actions.pod:2499
26415 msgid "luks-open"
26416 msgstr ""
26417
26418 # type: verbatim
26419 #. type: verbatim
26420 #: ../fish/guestfish-actions.pod:2501
26421 #, no-wrap
26422 msgid ""
26423 " luks-open device mapname\n"
26424 "\n"
26425 msgstr ""
26426
26427 # type: textblock
26428 #. type: textblock
26429 #: ../fish/guestfish-actions.pod:2515
26430 msgid ""
26431 "If this block device contains LVM volume groups, then calling L</vgscan> "
26432 "followed by L</vg-activate-all> will make them visible."
26433 msgstr ""
26434
26435 # type: =head2
26436 #. type: =head2
26437 #: ../fish/guestfish-actions.pod:2522
26438 msgid "luks-open-ro"
26439 msgstr ""
26440
26441 # type: verbatim
26442 #. type: verbatim
26443 #: ../fish/guestfish-actions.pod:2524
26444 #, no-wrap
26445 msgid ""
26446 " luks-open-ro device mapname\n"
26447 "\n"
26448 msgstr ""
26449
26450 # type: textblock
26451 #. type: textblock
26452 #: ../fish/guestfish-actions.pod:2526
26453 msgid ""
26454 "This is the same as L</luks-open> except that a read-only mapping is created."
26455 msgstr ""
26456
26457 # type: =head2
26458 #. type: =head2
26459 #: ../fish/guestfish-actions.pod:2532
26460 msgid "lvcreate"
26461 msgstr ""
26462
26463 # type: verbatim
26464 #. type: verbatim
26465 #: ../fish/guestfish-actions.pod:2534
26466 #, no-wrap
26467 msgid ""
26468 " lvcreate logvol volgroup mbytes\n"
26469 "\n"
26470 msgstr ""
26471
26472 # type: =head2
26473 #. type: =head2
26474 #: ../fish/guestfish-actions.pod:2539
26475 msgid "lvm-canonical-lv-name"
26476 msgstr ""
26477
26478 # type: verbatim
26479 #. type: verbatim
26480 #: ../fish/guestfish-actions.pod:2541
26481 #, no-wrap
26482 msgid ""
26483 " lvm-canonical-lv-name lvname\n"
26484 "\n"
26485 msgstr ""
26486
26487 # type: textblock
26488 #. type: textblock
26489 #: ../fish/guestfish-actions.pod:2550
26490 msgid "See also L</is-lv>."
26491 msgstr ""
26492
26493 # type: =head2
26494 #. type: =head2
26495 #: ../fish/guestfish-actions.pod:2552
26496 msgid "lvm-clear-filter"
26497 msgstr ""
26498
26499 # type: verbatim
26500 #. type: verbatim
26501 #: ../fish/guestfish-actions.pod:2554
26502 #, no-wrap
26503 msgid ""
26504 " lvm-clear-filter\n"
26505 "\n"
26506 msgstr ""
26507
26508 # type: textblock
26509 #. type: textblock
26510 #: ../fish/guestfish-actions.pod:2556
26511 msgid ""
26512 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
26513 "block device."
26514 msgstr ""
26515
26516 # type: =head2
26517 #. type: =head2
26518 #: ../fish/guestfish-actions.pod:2562
26519 msgid "lvm-remove-all"
26520 msgstr ""
26521
26522 # type: verbatim
26523 #. type: verbatim
26524 #: ../fish/guestfish-actions.pod:2564
26525 #, no-wrap
26526 msgid ""
26527 " lvm-remove-all\n"
26528 "\n"
26529 msgstr ""
26530
26531 # type: =head2
26532 #. type: =head2
26533 #: ../fish/guestfish-actions.pod:2572
26534 msgid "lvm-set-filter"
26535 msgstr ""
26536
26537 # type: verbatim
26538 #. type: verbatim
26539 #: ../fish/guestfish-actions.pod:2574
26540 #, no-wrap
26541 msgid ""
26542 " lvm-set-filter 'devices ...'\n"
26543 "\n"
26544 msgstr ""
26545
26546 # type: =head2
26547 #. type: =head2
26548 #: ../fish/guestfish-actions.pod:2599
26549 msgid "lvremove"
26550 msgstr ""
26551
26552 # type: verbatim
26553 #. type: verbatim
26554 #: ../fish/guestfish-actions.pod:2601
26555 #, no-wrap
26556 msgid ""
26557 " lvremove device\n"
26558 "\n"
26559 msgstr ""
26560
26561 # type: =head2
26562 #. type: =head2
26563 #: ../fish/guestfish-actions.pod:2609
26564 msgid "lvrename"
26565 msgstr ""
26566
26567 # type: verbatim
26568 #. type: verbatim
26569 #: ../fish/guestfish-actions.pod:2611
26570 #, no-wrap
26571 msgid ""
26572 " lvrename logvol newlogvol\n"
26573 "\n"
26574 msgstr ""
26575
26576 # type: =head2
26577 #. type: =head2
26578 #: ../fish/guestfish-actions.pod:2615
26579 msgid "lvresize"
26580 msgstr ""
26581
26582 # type: verbatim
26583 #. type: verbatim
26584 #: ../fish/guestfish-actions.pod:2617
26585 #, no-wrap
26586 msgid ""
26587 " lvresize device mbytes\n"
26588 "\n"
26589 msgstr ""
26590
26591 # type: =head2
26592 #. type: =head2
26593 #: ../fish/guestfish-actions.pod:2623
26594 msgid "lvresize-free"
26595 msgstr ""
26596
26597 # type: verbatim
26598 #. type: verbatim
26599 #: ../fish/guestfish-actions.pod:2625
26600 #, no-wrap
26601 msgid ""
26602 " lvresize-free lv percent\n"
26603 "\n"
26604 msgstr ""
26605
26606 # type: =head2
26607 #. type: =head2
26608 #: ../fish/guestfish-actions.pod:2633
26609 msgid "lvs"
26610 msgstr ""
26611
26612 # type: verbatim
26613 #. type: verbatim
26614 #: ../fish/guestfish-actions.pod:2635
26615 #, no-wrap
26616 msgid ""
26617 " lvs\n"
26618 "\n"
26619 msgstr ""
26620
26621 # type: textblock
26622 #. type: textblock
26623 #: ../fish/guestfish-actions.pod:2643
26624 msgid "See also L</lvs-full>, L</list-filesystems>."
26625 msgstr ""
26626
26627 # type: =head2
26628 #. type: =head2
26629 #: ../fish/guestfish-actions.pod:2645
26630 msgid "lvs-full"
26631 msgstr ""
26632
26633 # type: verbatim
26634 #. type: verbatim
26635 #: ../fish/guestfish-actions.pod:2647
26636 #, no-wrap
26637 msgid ""
26638 " lvs-full\n"
26639 "\n"
26640 msgstr ""
26641
26642 # type: =head2
26643 #. type: =head2
26644 #: ../fish/guestfish-actions.pod:2652
26645 msgid "lvuuid"
26646 msgstr ""
26647
26648 # type: verbatim
26649 #. type: verbatim
26650 #: ../fish/guestfish-actions.pod:2654
26651 #, no-wrap
26652 msgid ""
26653 " lvuuid device\n"
26654 "\n"
26655 msgstr ""
26656
26657 # type: =head2
26658 #. type: =head2
26659 #: ../fish/guestfish-actions.pod:2658
26660 msgid "lxattrlist"
26661 msgstr ""
26662
26663 # type: verbatim
26664 #. type: verbatim
26665 #: ../fish/guestfish-actions.pod:2660
26666 #, no-wrap
26667 msgid ""
26668 " lxattrlist path 'names ...'\n"
26669 "\n"
26670 msgstr ""
26671
26672 # type: textblock
26673 #. type: textblock
26674 #: ../fish/guestfish-actions.pod:2676
26675 msgid ""
26676 "This call is intended for programs that want to efficiently list a directory "
26677 "contents without making many round-trips.  See also L</lstatlist> for a "
26678 "similarly efficient call for getting standard stats.  Very long directory "
26679 "listings might cause the protocol message size to be exceeded, causing this "
26680 "call to fail.  The caller must split up such requests into smaller groups of "
26681 "names."
26682 msgstr ""
26683
26684 # type: =head2
26685 #. type: =head2
26686 #: ../fish/guestfish-actions.pod:2684
26687 msgid "mkdir"
26688 msgstr ""
26689
26690 # type: verbatim
26691 #. type: verbatim
26692 #: ../fish/guestfish-actions.pod:2686
26693 #, no-wrap
26694 msgid ""
26695 " mkdir path\n"
26696 "\n"
26697 msgstr ""
26698
26699 # type: =head2
26700 #. type: =head2
26701 #: ../fish/guestfish-actions.pod:2690
26702 msgid "mkdir-mode"
26703 msgstr ""
26704
26705 # type: verbatim
26706 #. type: verbatim
26707 #: ../fish/guestfish-actions.pod:2692
26708 #, no-wrap
26709 msgid ""
26710 " mkdir-mode path mode\n"
26711 "\n"
26712 msgstr ""
26713
26714 # type: textblock
26715 #. type: textblock
26716 #: ../fish/guestfish-actions.pod:2701
26717 msgid "See also L</mkdir>, L</umask>"
26718 msgstr ""
26719
26720 # type: =head2
26721 #. type: =head2
26722 #: ../fish/guestfish-actions.pod:2703
26723 msgid "mkdir-p"
26724 msgstr ""
26725
26726 # type: verbatim
26727 #. type: verbatim
26728 #: ../fish/guestfish-actions.pod:2705
26729 #, no-wrap
26730 msgid ""
26731 " mkdir-p path\n"
26732 "\n"
26733 msgstr ""
26734
26735 # type: =head2
26736 #. type: =head2
26737 #: ../fish/guestfish-actions.pod:2710
26738 msgid "mkdtemp"
26739 msgstr ""
26740
26741 # type: verbatim
26742 #. type: verbatim
26743 #: ../fish/guestfish-actions.pod:2712
26744 #, no-wrap
26745 msgid ""
26746 " mkdtemp template\n"
26747 "\n"
26748 msgstr ""
26749
26750 # type: =head2
26751 #. type: =head2
26752 #: ../fish/guestfish-actions.pod:2733
26753 msgid "mke2fs-J"
26754 msgstr ""
26755
26756 # type: verbatim
26757 #. type: verbatim
26758 #: ../fish/guestfish-actions.pod:2735
26759 #, no-wrap
26760 msgid ""
26761 " mke2fs-J fstype blocksize device journal\n"
26762 "\n"
26763 msgstr ""
26764
26765 # type: textblock
26766 #. type: textblock
26767 #: ../fish/guestfish-actions.pod:2743
26768 msgid "See also L</mke2journal>."
26769 msgstr ""
26770
26771 # type: =head2
26772 #. type: =head2
26773 #: ../fish/guestfish-actions.pod:2745
26774 msgid "mke2fs-JL"
26775 msgstr ""
26776
26777 # type: verbatim
26778 #. type: verbatim
26779 #: ../fish/guestfish-actions.pod:2747
26780 #, no-wrap
26781 msgid ""
26782 " mke2fs-JL fstype blocksize device label\n"
26783 "\n"
26784 msgstr ""
26785
26786 # type: textblock
26787 #. type: textblock
26788 #: ../fish/guestfish-actions.pod:2752
26789 msgid "See also L</mke2journal-L>."
26790 msgstr ""
26791
26792 # type: =head2
26793 #. type: =head2
26794 #: ../fish/guestfish-actions.pod:2754
26795 msgid "mke2fs-JU"
26796 msgstr ""
26797
26798 # type: verbatim
26799 #. type: verbatim
26800 #: ../fish/guestfish-actions.pod:2756
26801 #, no-wrap
26802 msgid ""
26803 " mke2fs-JU fstype blocksize device uuid\n"
26804 "\n"
26805 msgstr ""
26806
26807 # type: textblock
26808 #. type: textblock
26809 #: ../fish/guestfish-actions.pod:2761
26810 msgid "See also L</mke2journal-U>."
26811 msgstr ""
26812
26813 # type: =head2
26814 #. type: =head2
26815 #: ../fish/guestfish-actions.pod:2763
26816 msgid "mke2journal"
26817 msgstr ""
26818
26819 # type: verbatim
26820 #. type: verbatim
26821 #: ../fish/guestfish-actions.pod:2765
26822 #, no-wrap
26823 msgid ""
26824 " mke2journal blocksize device\n"
26825 "\n"
26826 msgstr ""
26827
26828 # type: =head2
26829 #. type: =head2
26830 #: ../fish/guestfish-actions.pod:2772
26831 msgid "mke2journal-L"
26832 msgstr ""
26833
26834 # type: verbatim
26835 #. type: verbatim
26836 #: ../fish/guestfish-actions.pod:2774
26837 #, no-wrap
26838 msgid ""
26839 " mke2journal-L blocksize label device\n"
26840 "\n"
26841 msgstr ""
26842
26843 # type: =head2
26844 #. type: =head2
26845 #: ../fish/guestfish-actions.pod:2778
26846 msgid "mke2journal-U"
26847 msgstr ""
26848
26849 # type: verbatim
26850 #. type: verbatim
26851 #: ../fish/guestfish-actions.pod:2780
26852 #, no-wrap
26853 msgid ""
26854 " mke2journal-U blocksize uuid device\n"
26855 "\n"
26856 msgstr ""
26857
26858 # type: =head2
26859 #. type: =head2
26860 #: ../fish/guestfish-actions.pod:2784
26861 msgid "mkfifo"
26862 msgstr ""
26863
26864 # type: verbatim
26865 #. type: verbatim
26866 #: ../fish/guestfish-actions.pod:2786
26867 #, no-wrap
26868 msgid ""
26869 " mkfifo mode path\n"
26870 "\n"
26871 msgstr ""
26872
26873 # type: textblock
26874 #. type: textblock
26875 #: ../fish/guestfish-actions.pod:2788
26876 msgid ""
26877 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
26878 "is just a convenient wrapper around L</mknod>."
26879 msgstr ""
26880
26881 # type: =head2
26882 #. type: =head2
26883 #: ../fish/guestfish-actions.pod:2794
26884 msgid "mkfs"
26885 msgstr ""
26886
26887 # type: verbatim
26888 #. type: verbatim
26889 #: ../fish/guestfish-actions.pod:2796
26890 #, no-wrap
26891 msgid ""
26892 " mkfs fstype device\n"
26893 "\n"
26894 msgstr ""
26895
26896 # type: =head2
26897 #. type: =head2
26898 #: ../fish/guestfish-actions.pod:2802
26899 msgid "mkfs-b"
26900 msgstr ""
26901
26902 # type: verbatim
26903 #. type: verbatim
26904 #: ../fish/guestfish-actions.pod:2804
26905 #, no-wrap
26906 msgid ""
26907 " mkfs-b fstype blocksize device\n"
26908 "\n"
26909 msgstr ""
26910
26911 # type: textblock
26912 #. type: textblock
26913 #: ../fish/guestfish-actions.pod:2806
26914 msgid ""
26915 "This call is similar to L</mkfs>, but it allows you to control the block "
26916 "size of the resulting filesystem.  Supported block sizes depend on the "
26917 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
26918 msgstr ""
26919
26920 #. type: textblock
26921 #: ../fish/guestfish-actions.pod:2814
26922 msgid ""
26923 "This function is deprecated.  In new code, use the L</mkfs_opts> call "
26924 "instead."
26925 msgstr ""
26926
26927 # type: =head2
26928 #. type: =head2
26929 #: ../fish/guestfish-actions.pod:2821
26930 msgid "mkfs-opts"
26931 msgstr ""
26932
26933 # type: verbatim
26934 #. type: verbatim
26935 #: ../fish/guestfish-actions.pod:2823
26936 #, no-wrap
26937 msgid ""
26938 " mkfs-opts fstype device [blocksize:..]\n"
26939 "\n"
26940 msgstr ""
26941
26942 # type: =head2
26943 #. type: =head2
26944 #: ../fish/guestfish-actions.pod:2847
26945 msgid "mkmountpoint"
26946 msgstr ""
26947
26948 # type: verbatim
26949 #. type: verbatim
26950 #: ../fish/guestfish-actions.pod:2849
26951 #, no-wrap
26952 msgid ""
26953 " mkmountpoint exemptpath\n"
26954 "\n"
26955 msgstr ""
26956
26957 # type: textblock
26958 #. type: textblock
26959 #: ../fish/guestfish-actions.pod:2851
26960 msgid ""
26961 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
26962 "to create extra mountpoints before mounting the first filesystem."
26963 msgstr ""
26964
26965 # type: textblock
26966 #. type: textblock
26967 #: ../fish/guestfish-actions.pod:2875
26968 msgid ""
26969 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
26970 "unexpected errors if you try to mix these calls.  It is safest to manually "
26971 "unmount filesystems and remove mountpoints after use."
26972 msgstr ""
26973
26974 # type: textblock
26975 #. type: textblock
26976 #: ../fish/guestfish-actions.pod:2879
26977 msgid ""
26978 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
26979 "for this to work for manual mountpoints, you must ensure that the innermost "
26980 "mountpoints have the longest pathnames, as in the example code above."
26981 msgstr ""
26982
26983 # type: textblock
26984 #. type: textblock
26985 #: ../fish/guestfish-actions.pod:2886
26986 msgid ""
26987 "Autosync [see L</set-autosync>, this is set by default on handles] means "
26988 "that L</umount-all> is called when the handle is closed which can also "
26989 "trigger these issues."
26990 msgstr ""
26991
26992 # type: =head2
26993 #. type: =head2
26994 #: ../fish/guestfish-actions.pod:2890
26995 msgid "mknod"
26996 msgstr ""
26997
26998 # type: verbatim
26999 #. type: verbatim
27000 #: ../fish/guestfish-actions.pod:2892
27001 #, no-wrap
27002 msgid ""
27003 " mknod mode devmajor devminor path\n"
27004 "\n"
27005 msgstr ""
27006
27007 # type: textblock
27008 #. type: textblock
27009 #: ../fish/guestfish-actions.pod:2902
27010 msgid ""
27011 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
27012 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
27013 "regular file).  These constants are available in the standard Linux header "
27014 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
27015 "wrappers around this command which bitwise OR in the appropriate constant "
27016 "for you."
27017 msgstr ""
27018
27019 # type: =head2
27020 #. type: =head2
27021 #: ../fish/guestfish-actions.pod:2912
27022 msgid "mknod-b"
27023 msgstr ""
27024
27025 # type: verbatim
27026 #. type: verbatim
27027 #: ../fish/guestfish-actions.pod:2914
27028 #, no-wrap
27029 msgid ""
27030 " mknod-b mode devmajor devminor path\n"
27031 "\n"
27032 msgstr ""
27033
27034 # type: textblock
27035 #. type: textblock
27036 #: ../fish/guestfish-actions.pod:2916
27037 msgid ""
27038 "This call creates a block device node called C<path> with mode C<mode> and "
27039 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
27040 "wrapper around L</mknod>."
27041 msgstr ""
27042
27043 # type: =head2
27044 #. type: =head2
27045 #: ../fish/guestfish-actions.pod:2922
27046 msgid "mknod-c"
27047 msgstr ""
27048
27049 # type: verbatim
27050 #. type: verbatim
27051 #: ../fish/guestfish-actions.pod:2924
27052 #, no-wrap
27053 msgid ""
27054 " mknod-c mode devmajor devminor path\n"
27055 "\n"
27056 msgstr ""
27057
27058 # type: textblock
27059 #. type: textblock
27060 #: ../fish/guestfish-actions.pod:2926
27061 msgid ""
27062 "This call creates a char device node called C<path> with mode C<mode> and "
27063 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
27064 "wrapper around L</mknod>."
27065 msgstr ""
27066
27067 # type: =head2
27068 #. type: =head2
27069 #: ../fish/guestfish-actions.pod:2932
27070 msgid "mkswap"
27071 msgstr ""
27072
27073 # type: verbatim
27074 #. type: verbatim
27075 #: ../fish/guestfish-actions.pod:2934
27076 #, no-wrap
27077 msgid ""
27078 " mkswap device\n"
27079 "\n"
27080 msgstr ""
27081
27082 # type: =head2
27083 #. type: =head2
27084 #: ../fish/guestfish-actions.pod:2938
27085 msgid "mkswap-L"
27086 msgstr ""
27087
27088 # type: verbatim
27089 #. type: verbatim
27090 #: ../fish/guestfish-actions.pod:2940
27091 #, no-wrap
27092 msgid ""
27093 " mkswap-L label device\n"
27094 "\n"
27095 msgstr ""
27096
27097 # type: =head2
27098 #. type: =head2
27099 #: ../fish/guestfish-actions.pod:2948
27100 msgid "mkswap-U"
27101 msgstr ""
27102
27103 # type: verbatim
27104 #. type: verbatim
27105 #: ../fish/guestfish-actions.pod:2950
27106 #, no-wrap
27107 msgid ""
27108 " mkswap-U uuid device\n"
27109 "\n"
27110 msgstr ""
27111
27112 # type: =head2
27113 #. type: =head2
27114 #: ../fish/guestfish-actions.pod:2954
27115 msgid "mkswap-file"
27116 msgstr ""
27117
27118 # type: verbatim
27119 #. type: verbatim
27120 #: ../fish/guestfish-actions.pod:2956
27121 #, no-wrap
27122 msgid ""
27123 " mkswap-file path\n"
27124 "\n"
27125 msgstr ""
27126
27127 # type: textblock
27128 #. type: textblock
27129 #: ../fish/guestfish-actions.pod:2960
27130 msgid ""
27131 "This command just writes a swap file signature to an existing file.  To "
27132 "create the file itself, use something like L</fallocate>."
27133 msgstr ""
27134
27135 # type: =head2
27136 #. type: =head2
27137 #: ../fish/guestfish-actions.pod:2963
27138 msgid "modprobe"
27139 msgstr ""
27140
27141 # type: verbatim
27142 #. type: verbatim
27143 #: ../fish/guestfish-actions.pod:2965
27144 #, no-wrap
27145 msgid ""
27146 " modprobe modulename\n"
27147 "\n"
27148 msgstr ""
27149
27150 # type: =head2
27151 #. type: =head2
27152 #: ../fish/guestfish-actions.pod:2972
27153 msgid "mount"
27154 msgstr ""
27155
27156 # type: verbatim
27157 #. type: verbatim
27158 #: ../fish/guestfish-actions.pod:2974
27159 #, no-wrap
27160 msgid ""
27161 " mount device mountpoint\n"
27162 "\n"
27163 msgstr ""
27164
27165 # type: textblock
27166 #. type: textblock
27167 #: ../fish/guestfish-actions.pod:2990
27168 msgid ""
27169 "B<Important note:> When you use this call, the filesystem options C<sync> "
27170 "and C<noatime> are set implicitly.  This was originally done because we "
27171 "thought it would improve reliability, but it turns out that I<-o sync> has a "
27172 "very large negative performance impact and negligible effect on "
27173 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
27174 "code that needs performance, and instead use L</mount-options> (use an empty "
27175 "string for the first parameter if you don't want any options)."
27176 msgstr ""
27177
27178 # type: =head2
27179 #. type: =head2
27180 #: ../fish/guestfish-actions.pod:3000
27181 msgid "mount-loop"
27182 msgstr ""
27183
27184 # type: verbatim
27185 #. type: verbatim
27186 #: ../fish/guestfish-actions.pod:3002
27187 #, no-wrap
27188 msgid ""
27189 " mount-loop file mountpoint\n"
27190 "\n"
27191 msgstr ""
27192
27193 # type: =head2
27194 #. type: =head2
27195 #: ../fish/guestfish-actions.pod:3008
27196 msgid "mount-options"
27197 msgstr ""
27198
27199 # type: verbatim
27200 #. type: verbatim
27201 #: ../fish/guestfish-actions.pod:3010
27202 #, no-wrap
27203 msgid ""
27204 " mount-options options device mountpoint\n"
27205 "\n"
27206 msgstr ""
27207
27208 # type: textblock
27209 #. type: textblock
27210 #: ../fish/guestfish-actions.pod:3012
27211 msgid ""
27212 "This is the same as the L</mount> command, but it allows you to set the "
27213 "mount options as for the L<mount(8)> I<-o> flag."
27214 msgstr ""
27215
27216 # type: =head2
27217 #. type: =head2
27218 #: ../fish/guestfish-actions.pod:3020
27219 msgid "mount-ro"
27220 msgstr ""
27221
27222 # type: verbatim
27223 #. type: verbatim
27224 #: ../fish/guestfish-actions.pod:3022
27225 #, no-wrap
27226 msgid ""
27227 " mount-ro device mountpoint\n"
27228 "\n"
27229 msgstr ""
27230
27231 # type: textblock
27232 #. type: textblock
27233 #: ../fish/guestfish-actions.pod:3024
27234 msgid ""
27235 "This is the same as the L</mount> command, but it mounts the filesystem with "
27236 "the read-only (I<-o ro>) flag."
27237 msgstr ""
27238
27239 # type: =head2
27240 #. type: =head2
27241 #: ../fish/guestfish-actions.pod:3027
27242 msgid "mount-vfs"
27243 msgstr ""
27244
27245 # type: verbatim
27246 #. type: verbatim
27247 #: ../fish/guestfish-actions.pod:3029
27248 #, no-wrap
27249 msgid ""
27250 " mount-vfs options vfstype device mountpoint\n"
27251 "\n"
27252 msgstr ""
27253
27254 # type: textblock
27255 #. type: textblock
27256 #: ../fish/guestfish-actions.pod:3031
27257 msgid ""
27258 "This is the same as the L</mount> command, but it allows you to set both the "
27259 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
27260 msgstr ""
27261
27262 # type: =head2
27263 #. type: =head2
27264 #: ../fish/guestfish-actions.pod:3035
27265 msgid "mountpoints"
27266 msgstr ""
27267
27268 # type: verbatim
27269 #. type: verbatim
27270 #: ../fish/guestfish-actions.pod:3037
27271 #, no-wrap
27272 msgid ""
27273 " mountpoints\n"
27274 "\n"
27275 msgstr ""
27276
27277 # type: textblock
27278 #. type: textblock
27279 #: ../fish/guestfish-actions.pod:3039
27280 msgid ""
27281 "This call is similar to L</mounts>.  That call returns a list of devices.  "
27282 "This one returns a hash table (map) of device name to directory where the "
27283 "device is mounted."
27284 msgstr ""
27285
27286 # type: =head2
27287 #. type: =head2
27288 #: ../fish/guestfish-actions.pod:3043
27289 msgid "mounts"
27290 msgstr ""
27291
27292 # type: verbatim
27293 #. type: verbatim
27294 #: ../fish/guestfish-actions.pod:3045
27295 #, no-wrap
27296 msgid ""
27297 " mounts\n"
27298 "\n"
27299 msgstr ""
27300
27301 # type: textblock
27302 #. type: textblock
27303 #: ../fish/guestfish-actions.pod:3052
27304 msgid "See also: L</mountpoints>"
27305 msgstr ""
27306
27307 # type: =head2
27308 #. type: =head2
27309 #: ../fish/guestfish-actions.pod:3054
27310 msgid "mv"
27311 msgstr ""
27312
27313 # type: verbatim
27314 #. type: verbatim
27315 #: ../fish/guestfish-actions.pod:3056
27316 #, no-wrap
27317 msgid ""
27318 " mv src dest\n"
27319 "\n"
27320 msgstr ""
27321
27322 # type: =head2
27323 #. type: =head2
27324 #: ../fish/guestfish-actions.pod:3061
27325 msgid "ntfs-3g-probe"
27326 msgstr ""
27327
27328 # type: verbatim
27329 #. type: verbatim
27330 #: ../fish/guestfish-actions.pod:3063
27331 #, no-wrap
27332 msgid ""
27333 " ntfs-3g-probe true|false device\n"
27334 "\n"
27335 msgstr ""
27336
27337 # type: =head2
27338 #. type: =head2
27339 #: ../fish/guestfish-actions.pod:3077
27340 msgid "ntfsresize"
27341 msgstr ""
27342
27343 # type: verbatim
27344 #. type: verbatim
27345 #: ../fish/guestfish-actions.pod:3079
27346 #, no-wrap
27347 msgid ""
27348 " ntfsresize device\n"
27349 "\n"
27350 msgstr ""
27351
27352 # type: =head2
27353 #. type: =head2
27354 #: ../fish/guestfish-actions.pod:3094
27355 msgid "ntfsresize-size"
27356 msgstr ""
27357
27358 # type: verbatim
27359 #. type: verbatim
27360 #: ../fish/guestfish-actions.pod:3096
27361 #, no-wrap
27362 msgid ""
27363 " ntfsresize-size device size\n"
27364 "\n"
27365 msgstr ""
27366
27367 # type: textblock
27368 #. type: textblock
27369 #: ../fish/guestfish-actions.pod:3098
27370 msgid ""
27371 "This command is the same as L</ntfsresize> except that it allows you to "
27372 "specify the new size (in bytes) explicitly."
27373 msgstr ""
27374
27375 # type: =head2
27376 #. type: =head2
27377 #: ../fish/guestfish-actions.pod:3101
27378 msgid "part-add"
27379 msgstr ""
27380
27381 # type: verbatim
27382 #. type: verbatim
27383 #: ../fish/guestfish-actions.pod:3103
27384 #, no-wrap
27385 msgid ""
27386 " part-add device prlogex startsect endsect\n"
27387 "\n"
27388 msgstr ""
27389
27390 # type: textblock
27391 #. type: textblock
27392 #: ../fish/guestfish-actions.pod:3105
27393 msgid ""
27394 "This command adds a partition to C<device>.  If there is no partition table "
27395 "on the device, call L</part-init> first."
27396 msgstr ""
27397
27398 # type: textblock
27399 #. type: textblock
27400 #: ../fish/guestfish-actions.pod:3117
27401 msgid ""
27402 "Creating a partition which covers the whole disk is not so easy.  Use L</"
27403 "part-disk> to do that."
27404 msgstr ""
27405
27406 # type: =head2
27407 #. type: =head2
27408 #: ../fish/guestfish-actions.pod:3120
27409 msgid "part-del"
27410 msgstr ""
27411
27412 # type: verbatim
27413 #. type: verbatim
27414 #: ../fish/guestfish-actions.pod:3122
27415 #, no-wrap
27416 msgid ""
27417 " part-del device partnum\n"
27418 "\n"
27419 msgstr ""
27420
27421 # type: =head2
27422 #. type: =head2
27423 #: ../fish/guestfish-actions.pod:3130
27424 msgid "part-disk"
27425 msgstr ""
27426
27427 # type: verbatim
27428 #. type: verbatim
27429 #: ../fish/guestfish-actions.pod:3132
27430 #, no-wrap
27431 msgid ""
27432 " part-disk device parttype\n"
27433 "\n"
27434 msgstr ""
27435
27436 # type: textblock
27437 #. type: textblock
27438 #: ../fish/guestfish-actions.pod:3134
27439 msgid ""
27440 "This command is simply a combination of L</part-init> followed by L</part-"
27441 "add> to create a single primary partition covering the whole disk."
27442 msgstr ""
27443
27444 # type: textblock
27445 #. type: textblock
27446 #: ../fish/guestfish-actions.pod:3138
27447 msgid ""
27448 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
27449 "possible values are described in L</part-init>."
27450 msgstr ""
27451
27452 # type: =head2
27453 #. type: =head2
27454 #: ../fish/guestfish-actions.pod:3144
27455 msgid "part-get-bootable"
27456 msgstr ""
27457
27458 # type: verbatim
27459 #. type: verbatim
27460 #: ../fish/guestfish-actions.pod:3146
27461 #, no-wrap
27462 msgid ""
27463 " part-get-bootable device partnum\n"
27464 "\n"
27465 msgstr ""
27466
27467 # type: textblock
27468 #. type: textblock
27469 #: ../fish/guestfish-actions.pod:3151
27470 msgid "See also L</part-set-bootable>."
27471 msgstr ""
27472
27473 # type: =head2
27474 #. type: =head2
27475 #: ../fish/guestfish-actions.pod:3153
27476 msgid "part-get-mbr-id"
27477 msgstr ""
27478
27479 # type: verbatim
27480 #. type: verbatim
27481 #: ../fish/guestfish-actions.pod:3155
27482 #, no-wrap
27483 msgid ""
27484 " part-get-mbr-id device partnum\n"
27485 "\n"
27486 msgstr ""
27487
27488 # type: textblock
27489 #. type: textblock
27490 #: ../fish/guestfish-actions.pod:3160 ../fish/guestfish-actions.pod:3298
27491 msgid ""
27492 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
27493 "undefined results for other partition table types (see L</part-get-"
27494 "parttype>)."
27495 msgstr ""
27496
27497 # type: =head2
27498 #. type: =head2
27499 #: ../fish/guestfish-actions.pod:3164
27500 msgid "part-get-parttype"
27501 msgstr ""
27502
27503 # type: verbatim
27504 #. type: verbatim
27505 #: ../fish/guestfish-actions.pod:3166
27506 #, no-wrap
27507 msgid ""
27508 " part-get-parttype device\n"
27509 "\n"
27510 msgstr ""
27511
27512 # type: textblock
27513 #. type: textblock
27514 #: ../fish/guestfish-actions.pod:3171
27515 msgid ""
27516 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
27517 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
27518 "possible, although unusual.  See L</part-init> for a full list."
27519 msgstr ""
27520
27521 # type: =head2
27522 #. type: =head2
27523 #: ../fish/guestfish-actions.pod:3176
27524 msgid "part-init"
27525 msgstr ""
27526
27527 # type: verbatim
27528 #. type: verbatim
27529 #: ../fish/guestfish-actions.pod:3178
27530 #, no-wrap
27531 msgid ""
27532 " part-init device parttype\n"
27533 "\n"
27534 msgstr ""
27535
27536 # type: textblock
27537 #. type: textblock
27538 #: ../fish/guestfish-actions.pod:3184
27539 msgid ""
27540 "Initially there are no partitions.  Following this, you should call L</part-"
27541 "add> for each partition required."
27542 msgstr ""
27543
27544 # type: =head2
27545 #. type: =head2
27546 #: ../fish/guestfish-actions.pod:3247
27547 msgid "part-list"
27548 msgstr ""
27549
27550 # type: verbatim
27551 #. type: verbatim
27552 #: ../fish/guestfish-actions.pod:3249
27553 #, no-wrap
27554 msgid ""
27555 " part-list device\n"
27556 "\n"
27557 msgstr ""
27558
27559 # type: textblock
27560 #. type: textblock
27561 #: ../fish/guestfish-actions.pod:3264
27562 msgid ""
27563 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
27564 "the device's sector size, see L</blockdev-getss>."
27565 msgstr ""
27566
27567 # type: =head2
27568 #. type: =head2
27569 #: ../fish/guestfish-actions.pod:3277
27570 msgid "part-set-bootable"
27571 msgstr ""
27572
27573 # type: verbatim
27574 #. type: verbatim
27575 #: ../fish/guestfish-actions.pod:3279
27576 #, no-wrap
27577 msgid ""
27578 " part-set-bootable device partnum true|false\n"
27579 "\n"
27580 msgstr ""
27581
27582 # type: =head2
27583 #. type: =head2
27584 #: ../fish/guestfish-actions.pod:3288
27585 msgid "part-set-mbr-id"
27586 msgstr ""
27587
27588 # type: verbatim
27589 #. type: verbatim
27590 #: ../fish/guestfish-actions.pod:3290
27591 #, no-wrap
27592 msgid ""
27593 " part-set-mbr-id device partnum idbyte\n"
27594 "\n"
27595 msgstr ""
27596
27597 # type: =head2
27598 #. type: =head2
27599 #: ../fish/guestfish-actions.pod:3302
27600 msgid "part-set-name"
27601 msgstr ""
27602
27603 # type: verbatim
27604 #. type: verbatim
27605 #: ../fish/guestfish-actions.pod:3304
27606 #, no-wrap
27607 msgid ""
27608 " part-set-name device partnum name\n"
27609 "\n"
27610 msgstr ""
27611
27612 # type: =head2
27613 #. type: =head2
27614 #: ../fish/guestfish-actions.pod:3312
27615 msgid "part-to-dev"
27616 msgstr ""
27617
27618 # type: verbatim
27619 #. type: verbatim
27620 #: ../fish/guestfish-actions.pod:3314
27621 #, no-wrap
27622 msgid ""
27623 " part-to-dev partition\n"
27624 "\n"
27625 msgstr ""
27626
27627 # type: textblock
27628 #. type: textblock
27629 #: ../fish/guestfish-actions.pod:3320
27630 msgid ""
27631 "The named partition must exist, for example as a string returned from L</"
27632 "list-partitions>."
27633 msgstr ""
27634
27635 # type: =head2
27636 #. type: =head2
27637 #: ../fish/guestfish-actions.pod:3323
27638 msgid "ping-daemon"
27639 msgstr ""
27640
27641 # type: verbatim
27642 #. type: verbatim
27643 #: ../fish/guestfish-actions.pod:3325
27644 #, no-wrap
27645 msgid ""
27646 " ping-daemon\n"
27647 "\n"
27648 msgstr ""
27649
27650 # type: =head2
27651 #. type: =head2
27652 #: ../fish/guestfish-actions.pod:3332
27653 msgid "pread"
27654 msgstr ""
27655
27656 # type: verbatim
27657 #. type: verbatim
27658 #: ../fish/guestfish-actions.pod:3334
27659 #, no-wrap
27660 msgid ""
27661 " pread path count offset\n"
27662 "\n"
27663 msgstr ""
27664
27665 # type: textblock
27666 #. type: textblock
27667 #: ../fish/guestfish-actions.pod:3342
27668 msgid "See also L</pwrite>, L</pread-device>."
27669 msgstr ""
27670
27671 # type: =head2
27672 #. type: =head2
27673 #: ../fish/guestfish-actions.pod:3347
27674 msgid "pread-device"
27675 msgstr ""
27676
27677 # type: verbatim
27678 #. type: verbatim
27679 #: ../fish/guestfish-actions.pod:3349
27680 #, no-wrap
27681 msgid ""
27682 " pread-device device count offset\n"
27683 "\n"
27684 msgstr ""
27685
27686 # type: textblock
27687 #. type: textblock
27688 #: ../fish/guestfish-actions.pod:3357
27689 msgid "See also L</pread>."
27690 msgstr ""
27691
27692 # type: =head2
27693 #. type: =head2
27694 #: ../fish/guestfish-actions.pod:3362
27695 msgid "pvcreate"
27696 msgstr ""
27697
27698 # type: verbatim
27699 #. type: verbatim
27700 #: ../fish/guestfish-actions.pod:3364
27701 #, no-wrap
27702 msgid ""
27703 " pvcreate device\n"
27704 "\n"
27705 msgstr ""
27706
27707 # type: =head2
27708 #. type: =head2
27709 #: ../fish/guestfish-actions.pod:3370
27710 msgid "pvremove"
27711 msgstr ""
27712
27713 # type: verbatim
27714 #. type: verbatim
27715 #: ../fish/guestfish-actions.pod:3372
27716 #, no-wrap
27717 msgid ""
27718 " pvremove device\n"
27719 "\n"
27720 msgstr ""
27721
27722 # type: =head2
27723 #. type: =head2
27724 #: ../fish/guestfish-actions.pod:3381
27725 msgid "pvresize"
27726 msgstr ""
27727
27728 # type: verbatim
27729 #. type: verbatim
27730 #: ../fish/guestfish-actions.pod:3383
27731 #, no-wrap
27732 msgid ""
27733 " pvresize device\n"
27734 "\n"
27735 msgstr ""
27736
27737 # type: =head2
27738 #. type: =head2
27739 #: ../fish/guestfish-actions.pod:3388
27740 msgid "pvresize-size"
27741 msgstr ""
27742
27743 # type: verbatim
27744 #. type: verbatim
27745 #: ../fish/guestfish-actions.pod:3390
27746 #, no-wrap
27747 msgid ""
27748 " pvresize-size device size\n"
27749 "\n"
27750 msgstr ""
27751
27752 # type: textblock
27753 #. type: textblock
27754 #: ../fish/guestfish-actions.pod:3392
27755 msgid ""
27756 "This command is the same as L</pvresize> except that it allows you to "
27757 "specify the new size (in bytes) explicitly."
27758 msgstr ""
27759
27760 # type: =head2
27761 #. type: =head2
27762 #: ../fish/guestfish-actions.pod:3395
27763 msgid "pvs"
27764 msgstr ""
27765
27766 # type: verbatim
27767 #. type: verbatim
27768 #: ../fish/guestfish-actions.pod:3397
27769 #, no-wrap
27770 msgid ""
27771 " pvs\n"
27772 "\n"
27773 msgstr ""
27774
27775 # type: textblock
27776 #. type: textblock
27777 #: ../fish/guestfish-actions.pod:3405
27778 msgid "See also L</pvs-full>."
27779 msgstr ""
27780
27781 # type: =head2
27782 #. type: =head2
27783 #: ../fish/guestfish-actions.pod:3407
27784 msgid "pvs-full"
27785 msgstr ""
27786
27787 # type: verbatim
27788 #. type: verbatim
27789 #: ../fish/guestfish-actions.pod:3409
27790 #, no-wrap
27791 msgid ""
27792 " pvs-full\n"
27793 "\n"
27794 msgstr ""
27795
27796 # type: =head2
27797 #. type: =head2
27798 #: ../fish/guestfish-actions.pod:3414
27799 msgid "pvuuid"
27800 msgstr ""
27801
27802 # type: verbatim
27803 #. type: verbatim
27804 #: ../fish/guestfish-actions.pod:3416
27805 #, no-wrap
27806 msgid ""
27807 " pvuuid device\n"
27808 "\n"
27809 msgstr ""
27810
27811 # type: =head2
27812 #. type: =head2
27813 #: ../fish/guestfish-actions.pod:3420
27814 msgid "pwrite"
27815 msgstr ""
27816
27817 # type: verbatim
27818 #. type: verbatim
27819 #: ../fish/guestfish-actions.pod:3422
27820 #, no-wrap
27821 msgid ""
27822 " pwrite path content offset\n"
27823 "\n"
27824 msgstr ""
27825
27826 # type: textblock
27827 #. type: textblock
27828 #: ../fish/guestfish-actions.pod:3433
27829 msgid "See also L</pread>, L</pwrite-device>."
27830 msgstr ""
27831
27832 # type: =head2
27833 #. type: =head2
27834 #: ../fish/guestfish-actions.pod:3438
27835 msgid "pwrite-device"
27836 msgstr ""
27837
27838 # type: verbatim
27839 #. type: verbatim
27840 #: ../fish/guestfish-actions.pod:3440
27841 #, no-wrap
27842 msgid ""
27843 " pwrite-device device content offset\n"
27844 "\n"
27845 msgstr ""
27846
27847 # type: textblock
27848 #. type: textblock
27849 #: ../fish/guestfish-actions.pod:3450
27850 msgid "See also L</pwrite>."
27851 msgstr ""
27852
27853 # type: =head2
27854 #. type: =head2
27855 #: ../fish/guestfish-actions.pod:3455
27856 msgid "read-file"
27857 msgstr ""
27858
27859 # type: verbatim
27860 #. type: verbatim
27861 #: ../fish/guestfish-actions.pod:3457
27862 #, no-wrap
27863 msgid ""
27864 " read-file path\n"
27865 "\n"
27866 msgstr ""
27867
27868 # type: textblock
27869 #. type: textblock
27870 #: ../fish/guestfish-actions.pod:3462
27871 msgid ""
27872 "Unlike L</cat>, this function can correctly handle files that contain "
27873 "embedded ASCII NUL characters.  However unlike L</download>, this function "
27874 "is limited in the total size of file that can be handled."
27875 msgstr ""
27876
27877 # type: =head2
27878 #. type: =head2
27879 #: ../fish/guestfish-actions.pod:3470
27880 msgid "read-lines"
27881 msgstr ""
27882
27883 # type: verbatim
27884 #. type: verbatim
27885 #: ../fish/guestfish-actions.pod:3472
27886 #, no-wrap
27887 msgid ""
27888 " read-lines path\n"
27889 "\n"
27890 msgstr ""
27891
27892 # type: textblock
27893 #. type: textblock
27894 #: ../fish/guestfish-actions.pod:3479
27895 msgid ""
27896 "Note that this function cannot correctly handle binary files (specifically, "
27897 "files containing C<\\0> character which is treated as end of line).  For "
27898 "those you need to use the L</read-file> function which has a more complex "
27899 "interface."
27900 msgstr ""
27901
27902 # type: =head2
27903 #. type: =head2
27904 #: ../fish/guestfish-actions.pod:3484
27905 msgid "readdir"
27906 msgstr ""
27907
27908 # type: verbatim
27909 #. type: verbatim
27910 #: ../fish/guestfish-actions.pod:3486
27911 #, no-wrap
27912 msgid ""
27913 " readdir dir\n"
27914 "\n"
27915 msgstr ""
27916
27917 # type: textblock
27918 #. type: textblock
27919 #: ../fish/guestfish-actions.pod:3538
27920 msgid ""
27921 "This function is primarily intended for use by programs.  To get a simple "
27922 "list of names, use L</ls>.  To get a printable directory for human "
27923 "consumption, use L</ll>."
27924 msgstr ""
27925
27926 # type: =head2
27927 #. type: =head2
27928 #: ../fish/guestfish-actions.pod:3542
27929 msgid "readlink"
27930 msgstr ""
27931
27932 # type: verbatim
27933 #. type: verbatim
27934 #: ../fish/guestfish-actions.pod:3544
27935 #, no-wrap
27936 msgid ""
27937 " readlink path\n"
27938 "\n"
27939 msgstr ""
27940
27941 # type: =head2
27942 #. type: =head2
27943 #: ../fish/guestfish-actions.pod:3548
27944 msgid "readlinklist"
27945 msgstr ""
27946
27947 # type: verbatim
27948 #. type: verbatim
27949 #: ../fish/guestfish-actions.pod:3550
27950 #, no-wrap
27951 msgid ""
27952 " readlinklist path 'names ...'\n"
27953 "\n"
27954 msgstr ""
27955
27956 # type: =head2
27957 #. type: =head2
27958 #: ../fish/guestfish-actions.pod:3574
27959 msgid "realpath"
27960 msgstr ""
27961
27962 # type: verbatim
27963 #. type: verbatim
27964 #: ../fish/guestfish-actions.pod:3576
27965 #, no-wrap
27966 msgid ""
27967 " realpath path\n"
27968 "\n"
27969 msgstr ""
27970
27971 # type: =head2
27972 #. type: =head2
27973 #: ../fish/guestfish-actions.pod:3581
27974 msgid "removexattr"
27975 msgstr ""
27976
27977 # type: verbatim
27978 #. type: verbatim
27979 #: ../fish/guestfish-actions.pod:3583
27980 #, no-wrap
27981 msgid ""
27982 " removexattr xattr path\n"
27983 "\n"
27984 msgstr ""
27985
27986 # type: textblock
27987 #. type: textblock
27988 #: ../fish/guestfish-actions.pod:3588
27989 msgid "See also: L</lremovexattr>, L<attr(5)>."
27990 msgstr ""
27991
27992 # type: =head2
27993 #. type: =head2
27994 #: ../fish/guestfish-actions.pod:3590
27995 msgid "resize2fs"
27996 msgstr ""
27997
27998 # type: verbatim
27999 #. type: verbatim
28000 #: ../fish/guestfish-actions.pod:3592
28001 #, no-wrap
28002 msgid ""
28003 " resize2fs device\n"
28004 "\n"
28005 msgstr ""
28006
28007 # type: textblock
28008 #. type: textblock
28009 #: ../fish/guestfish-actions.pod:3597
28010 msgid ""
28011 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
28012 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
28013 "gives an error about this and sometimes not.  In any case, it is always safe "
28014 "to call L</e2fsck-f> before calling this function."
28015 msgstr ""
28016
28017 # type: =head2
28018 #. type: =head2
28019 #: ../fish/guestfish-actions.pod:3603
28020 msgid "resize2fs-size"
28021 msgstr ""
28022
28023 # type: verbatim
28024 #. type: verbatim
28025 #: ../fish/guestfish-actions.pod:3605
28026 #, no-wrap
28027 msgid ""
28028 " resize2fs-size device size\n"
28029 "\n"
28030 msgstr ""
28031
28032 # type: textblock
28033 #. type: textblock
28034 #: ../fish/guestfish-actions.pod:3607
28035 msgid ""
28036 "This command is the same as L</resize2fs> except that it allows you to "
28037 "specify the new size (in bytes) explicitly."
28038 msgstr ""
28039
28040 # type: =head2
28041 #. type: =head2
28042 #: ../fish/guestfish-actions.pod:3610
28043 msgid "rm"
28044 msgstr ""
28045
28046 # type: verbatim
28047 #. type: verbatim
28048 #: ../fish/guestfish-actions.pod:3612
28049 #, no-wrap
28050 msgid ""
28051 " rm path\n"
28052 "\n"
28053 msgstr ""
28054
28055 # type: =head2
28056 #. type: =head2
28057 #: ../fish/guestfish-actions.pod:3616
28058 msgid "rm-rf"
28059 msgstr ""
28060
28061 # type: verbatim
28062 #. type: verbatim
28063 #: ../fish/guestfish-actions.pod:3618
28064 #, no-wrap
28065 msgid ""
28066 " rm-rf path\n"
28067 "\n"
28068 msgstr ""
28069
28070 # type: =head2
28071 #. type: =head2
28072 #: ../fish/guestfish-actions.pod:3624
28073 msgid "rmdir"
28074 msgstr ""
28075
28076 # type: verbatim
28077 #. type: verbatim
28078 #: ../fish/guestfish-actions.pod:3626
28079 #, no-wrap
28080 msgid ""
28081 " rmdir path\n"
28082 "\n"
28083 msgstr ""
28084
28085 # type: =head2
28086 #. type: =head2
28087 #: ../fish/guestfish-actions.pod:3630
28088 msgid "rmmountpoint"
28089 msgstr ""
28090
28091 # type: verbatim
28092 #. type: verbatim
28093 #: ../fish/guestfish-actions.pod:3632
28094 #, no-wrap
28095 msgid ""
28096 " rmmountpoint exemptpath\n"
28097 "\n"
28098 msgstr ""
28099
28100 # type: textblock
28101 #. type: textblock
28102 #: ../fish/guestfish-actions.pod:3634
28103 msgid ""
28104 "This calls removes a mountpoint that was previously created with L</"
28105 "mkmountpoint>.  See L</mkmountpoint> for full details."
28106 msgstr ""
28107
28108 # type: =head2
28109 #. type: =head2
28110 #: ../fish/guestfish-actions.pod:3638
28111 msgid "scrub-device"
28112 msgstr ""
28113
28114 # type: verbatim
28115 #. type: verbatim
28116 #: ../fish/guestfish-actions.pod:3640
28117 #, no-wrap
28118 msgid ""
28119 " scrub-device device\n"
28120 "\n"
28121 msgstr ""
28122
28123 # type: =head2
28124 #. type: =head2
28125 #: ../fish/guestfish-actions.pod:3651
28126 msgid "scrub-file"
28127 msgstr ""
28128
28129 # type: verbatim
28130 #. type: verbatim
28131 #: ../fish/guestfish-actions.pod:3653
28132 #, no-wrap
28133 msgid ""
28134 " scrub-file file\n"
28135 "\n"
28136 msgstr ""
28137
28138 # type: =head2
28139 #. type: =head2
28140 #: ../fish/guestfish-actions.pod:3663
28141 msgid "scrub-freespace"
28142 msgstr ""
28143
28144 # type: verbatim
28145 #. type: verbatim
28146 #: ../fish/guestfish-actions.pod:3665
28147 #, no-wrap
28148 msgid ""
28149 " scrub-freespace dir\n"
28150 "\n"
28151 msgstr ""
28152
28153 # type: textblock
28154 #. type: textblock
28155 #: ../fish/guestfish-actions.pod:3667
28156 msgid ""
28157 "This command creates the directory C<dir> and then fills it with files until "
28158 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
28159 "deletes them.  The intention is to scrub any free space on the partition "
28160 "containing C<dir>."
28161 msgstr ""
28162
28163 # type: =head2
28164 #. type: =head2
28165 #: ../fish/guestfish-actions.pod:3676
28166 msgid "set-append"
28167 msgstr ""
28168
28169 # type: =head2
28170 #. type: =head2
28171 #: ../fish/guestfish-actions.pod:3678
28172 msgid "append"
28173 msgstr ""
28174
28175 # type: verbatim
28176 #. type: verbatim
28177 #: ../fish/guestfish-actions.pod:3680
28178 #, no-wrap
28179 msgid ""
28180 " set-append append\n"
28181 "\n"
28182 msgstr ""
28183
28184 # type: =head2
28185 #. type: =head2
28186 #: ../fish/guestfish-actions.pod:3691
28187 msgid "set-autosync"
28188 msgstr ""
28189
28190 # type: =head2
28191 #. type: =head2
28192 #: ../fish/guestfish-actions.pod:3693
28193 msgid "autosync"
28194 msgstr ""
28195
28196 # type: verbatim
28197 #. type: verbatim
28198 #: ../fish/guestfish-actions.pod:3695
28199 #, no-wrap
28200 msgid ""
28201 " set-autosync true|false\n"
28202 "\n"
28203 msgstr ""
28204
28205 # type: textblock
28206 #. type: textblock
28207 #: ../fish/guestfish-actions.pod:3697
28208 msgid ""
28209 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
28210 "effort attempt to run L</umount-all> followed by L</sync> when the handle is "
28211 "closed (also if the program exits without closing handles)."
28212 msgstr ""
28213
28214 # type: =head2
28215 #. type: =head2
28216 #: ../fish/guestfish-actions.pod:3705
28217 msgid "set-direct"
28218 msgstr ""
28219
28220 # type: =head2
28221 #. type: =head2
28222 #: ../fish/guestfish-actions.pod:3707
28223 msgid "direct"
28224 msgstr ""
28225
28226 # type: verbatim
28227 #. type: verbatim
28228 #: ../fish/guestfish-actions.pod:3709
28229 #, no-wrap
28230 msgid ""
28231 " set-direct true|false\n"
28232 "\n"
28233 msgstr ""
28234
28235 # type: textblock
28236 #. type: textblock
28237 #: ../fish/guestfish-actions.pod:3715
28238 msgid ""
28239 "One consequence of this is that log messages aren't caught by the library "
28240 "and handled by L</set-log-message-callback>, but go straight to stdout."
28241 msgstr ""
28242
28243 # type: =head2
28244 #. type: =head2
28245 #: ../fish/guestfish-actions.pod:3724
28246 msgid "set-e2label"
28247 msgstr ""
28248
28249 # type: verbatim
28250 #. type: verbatim
28251 #: ../fish/guestfish-actions.pod:3726
28252 #, no-wrap
28253 msgid ""
28254 " set-e2label device label\n"
28255 "\n"
28256 msgstr ""
28257
28258 # type: textblock
28259 #. type: textblock
28260 #: ../fish/guestfish-actions.pod:3732
28261 msgid ""
28262 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
28263 "label on a filesystem."
28264 msgstr ""
28265
28266 # type: =head2
28267 #. type: =head2
28268 #: ../fish/guestfish-actions.pod:3735
28269 msgid "set-e2uuid"
28270 msgstr ""
28271
28272 # type: verbatim
28273 #. type: verbatim
28274 #: ../fish/guestfish-actions.pod:3737
28275 #, no-wrap
28276 msgid ""
28277 " set-e2uuid device uuid\n"
28278 "\n"
28279 msgstr ""
28280
28281 # type: textblock
28282 #. type: textblock
28283 #: ../fish/guestfish-actions.pod:3744
28284 msgid ""
28285 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
28286 "UUID of a filesystem."
28287 msgstr ""
28288
28289 # type: =head2
28290 #. type: =head2
28291 #: ../fish/guestfish-actions.pod:3747
28292 msgid "set-memsize"
28293 msgstr ""
28294
28295 # type: =head2
28296 #. type: =head2
28297 #: ../fish/guestfish-actions.pod:3749
28298 msgid "memsize"
28299 msgstr ""
28300
28301 # type: verbatim
28302 #. type: verbatim
28303 #: ../fish/guestfish-actions.pod:3751
28304 #, no-wrap
28305 msgid ""
28306 " set-memsize memsize\n"
28307 "\n"
28308 msgstr ""
28309
28310 # type: textblock
28311 #. type: textblock
28312 #: ../fish/guestfish-actions.pod:3753
28313 msgid ""
28314 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
28315 "This only has any effect if called before L</launch>."
28316 msgstr ""
28317
28318 # type: =head2
28319 #. type: =head2
28320 #: ../fish/guestfish-actions.pod:3764
28321 msgid "set-network"
28322 msgstr ""
28323
28324 # type: =head2
28325 #. type: =head2
28326 #: ../fish/guestfish-actions.pod:3766
28327 msgid "network"
28328 msgstr ""
28329
28330 # type: verbatim
28331 #. type: verbatim
28332 #: ../fish/guestfish-actions.pod:3768
28333 #, no-wrap
28334 msgid ""
28335 " set-network true|false\n"
28336 "\n"
28337 msgstr ""
28338
28339 # type: textblock
28340 #. type: textblock
28341 #: ../fish/guestfish-actions.pod:3776
28342 msgid ""
28343 "You must call this before calling L</launch>, otherwise it has no effect."
28344 msgstr ""
28345
28346 # type: =head2
28347 #. type: =head2
28348 #: ../fish/guestfish-actions.pod:3779
28349 msgid "set-path"
28350 msgstr ""
28351
28352 # type: =head2
28353 #. type: =head2
28354 #: ../fish/guestfish-actions.pod:3781
28355 msgid "path"
28356 msgstr ""
28357
28358 # type: verbatim
28359 #. type: verbatim
28360 #: ../fish/guestfish-actions.pod:3783
28361 #, no-wrap
28362 msgid ""
28363 " set-path searchpath\n"
28364 "\n"
28365 msgstr ""
28366
28367 # type: =head2
28368 #. type: =head2
28369 #: ../fish/guestfish-actions.pod:3792
28370 msgid "set-qemu"
28371 msgstr ""
28372
28373 # type: =head2
28374 #. type: =head2
28375 #: ../fish/guestfish-actions.pod:3794
28376 msgid "qemu"
28377 msgstr ""
28378
28379 # type: verbatim
28380 #. type: verbatim
28381 #: ../fish/guestfish-actions.pod:3796
28382 #, no-wrap
28383 msgid ""
28384 " set-qemu qemu\n"
28385 "\n"
28386 msgstr ""
28387
28388 # type: =head2
28389 #. type: =head2
28390 #: ../fish/guestfish-actions.pod:3816
28391 msgid "set-recovery-proc"
28392 msgstr ""
28393
28394 # type: =head2
28395 #. type: =head2
28396 #: ../fish/guestfish-actions.pod:3818
28397 msgid "recovery-proc"
28398 msgstr ""
28399
28400 # type: verbatim
28401 #. type: verbatim
28402 #: ../fish/guestfish-actions.pod:3820
28403 #, no-wrap
28404 msgid ""
28405 " set-recovery-proc true|false\n"
28406 "\n"
28407 msgstr ""
28408
28409 # type: textblock
28410 #. type: textblock
28411 #: ../fish/guestfish-actions.pod:3822
28412 msgid ""
28413 "If this is called with the parameter C<false> then L</launch> does not "
28414 "create a recovery process.  The purpose of the recovery process is to stop "
28415 "runaway qemu processes in the case where the main program aborts abruptly."
28416 msgstr ""
28417
28418 # type: textblock
28419 #. type: textblock
28420 #: ../fish/guestfish-actions.pod:3827
28421 msgid ""
28422 "This only has any effect if called before L</launch>, and the default is "
28423 "true."
28424 msgstr ""
28425
28426 # type: =head2
28427 #. type: =head2
28428 #: ../fish/guestfish-actions.pod:3836
28429 msgid "set-selinux"
28430 msgstr ""
28431
28432 # type: =head2
28433 #. type: =head2
28434 #: ../fish/guestfish-actions.pod:3838
28435 msgid "selinux"
28436 msgstr ""
28437
28438 # type: verbatim
28439 #. type: verbatim
28440 #: ../fish/guestfish-actions.pod:3840
28441 #, no-wrap
28442 msgid ""
28443 " set-selinux true|false\n"
28444 "\n"
28445 msgstr ""
28446
28447 # type: =head2
28448 #. type: =head2
28449 #: ../fish/guestfish-actions.pod:3851
28450 msgid "set-trace"
28451 msgstr ""
28452
28453 # type: =head2
28454 #. type: =head2
28455 #: ../fish/guestfish-actions.pod:3853
28456 msgid "trace"
28457 msgstr ""
28458
28459 # type: verbatim
28460 #. type: verbatim
28461 #: ../fish/guestfish-actions.pod:3855
28462 #, no-wrap
28463 msgid ""
28464 " set-trace true|false\n"
28465 "\n"
28466 msgstr ""
28467
28468 # type: =head2
28469 #. type: =head2
28470 #: ../fish/guestfish-actions.pod:3871
28471 msgid "set-verbose"
28472 msgstr ""
28473
28474 # type: =head2
28475 #. type: =head2
28476 #: ../fish/guestfish-actions.pod:3873
28477 msgid "verbose"
28478 msgstr ""
28479
28480 # type: verbatim
28481 #. type: verbatim
28482 #: ../fish/guestfish-actions.pod:3875
28483 #, no-wrap
28484 msgid ""
28485 " set-verbose true|false\n"
28486 "\n"
28487 msgstr ""
28488
28489 # type: =head2
28490 #. type: =head2
28491 #: ../fish/guestfish-actions.pod:3882
28492 msgid "setcon"
28493 msgstr ""
28494
28495 # type: verbatim
28496 #. type: verbatim
28497 #: ../fish/guestfish-actions.pod:3884
28498 #, no-wrap
28499 msgid ""
28500 " setcon context\n"
28501 "\n"
28502 msgstr ""
28503
28504 # type: =head2
28505 #. type: =head2
28506 #: ../fish/guestfish-actions.pod:3891
28507 msgid "setxattr"
28508 msgstr ""
28509
28510 # type: verbatim
28511 #. type: verbatim
28512 #: ../fish/guestfish-actions.pod:3893
28513 #, no-wrap
28514 msgid ""
28515 " setxattr xattr val vallen path\n"
28516 "\n"
28517 msgstr ""
28518
28519 # type: textblock
28520 #. type: textblock
28521 #: ../fish/guestfish-actions.pod:3899
28522 msgid "See also: L</lsetxattr>, L<attr(5)>."
28523 msgstr ""
28524
28525 # type: =head2
28526 #. type: =head2
28527 #: ../fish/guestfish-actions.pod:3901
28528 msgid "sfdisk"
28529 msgstr ""
28530
28531 # type: verbatim
28532 #. type: verbatim
28533 #: ../fish/guestfish-actions.pod:3903
28534 #, no-wrap
28535 msgid ""
28536 " sfdisk device cyls heads sectors 'lines ...'\n"
28537 "\n"
28538 msgstr ""
28539
28540 # type: textblock
28541 #. type: textblock
28542 #: ../fish/guestfish-actions.pod:3925
28543 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
28544 msgstr ""
28545
28546 # type: =head2
28547 #. type: =head2
28548 #: ../fish/guestfish-actions.pod:3931
28549 msgid "sfdiskM"
28550 msgstr ""
28551
28552 # type: verbatim
28553 #. type: verbatim
28554 #: ../fish/guestfish-actions.pod:3933
28555 #, no-wrap
28556 msgid ""
28557 " sfdiskM device 'lines ...'\n"
28558 "\n"
28559 msgstr ""
28560
28561 # type: textblock
28562 #. type: textblock
28563 #: ../fish/guestfish-actions.pod:3935
28564 msgid ""
28565 "This is a simplified interface to the L</sfdisk> command, where partition "
28566 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
28567 "you don't need to specify the cyls, heads and sectors parameters which were "
28568 "rarely if ever used anyway."
28569 msgstr ""
28570
28571 # type: textblock
28572 #. type: textblock
28573 #: ../fish/guestfish-actions.pod:3941
28574 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
28575 msgstr ""
28576
28577 # type: =head2
28578 #. type: =head2
28579 #: ../fish/guestfish-actions.pod:3947
28580 msgid "sfdisk-N"
28581 msgstr ""
28582
28583 # type: verbatim
28584 #. type: verbatim
28585 #: ../fish/guestfish-actions.pod:3949
28586 #, no-wrap
28587 msgid ""
28588 " sfdisk-N device partnum cyls heads sectors line\n"
28589 "\n"
28590 msgstr ""
28591
28592 # type: textblock
28593 #. type: textblock
28594 #: ../fish/guestfish-actions.pod:3954
28595 msgid ""
28596 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
28597 "cyls/heads/sectors parameters."
28598 msgstr ""
28599
28600 # type: textblock
28601 #. type: textblock
28602 #: ../fish/guestfish-actions.pod:3957
28603 msgid "See also: L</part-add>"
28604 msgstr ""
28605
28606 # type: =head2
28607 #. type: =head2
28608 #: ../fish/guestfish-actions.pod:3962
28609 msgid "sfdisk-disk-geometry"
28610 msgstr ""
28611
28612 # type: verbatim
28613 #. type: verbatim
28614 #: ../fish/guestfish-actions.pod:3964
28615 #, no-wrap
28616 msgid ""
28617 " sfdisk-disk-geometry device\n"
28618 "\n"
28619 msgstr ""
28620
28621 # type: textblock
28622 #. type: textblock
28623 #: ../fish/guestfish-actions.pod:3966
28624 msgid ""
28625 "This displays the disk geometry of C<device> read from the partition table.  "
28626 "Especially in the case where the underlying block device has been resized, "
28627 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
28628 "kernel-geometry>)."
28629 msgstr ""
28630
28631 # type: =head2
28632 #. type: =head2
28633 #: ../fish/guestfish-actions.pod:3974
28634 msgid "sfdisk-kernel-geometry"
28635 msgstr ""
28636
28637 # type: verbatim
28638 #. type: verbatim
28639 #: ../fish/guestfish-actions.pod:3976
28640 #, no-wrap
28641 msgid ""
28642 " sfdisk-kernel-geometry device\n"
28643 "\n"
28644 msgstr ""
28645
28646 # type: =head2
28647 #. type: =head2
28648 #: ../fish/guestfish-actions.pod:3983
28649 msgid "sfdisk-l"
28650 msgstr ""
28651
28652 # type: verbatim
28653 #. type: verbatim
28654 #: ../fish/guestfish-actions.pod:3985
28655 #, no-wrap
28656 msgid ""
28657 " sfdisk-l device\n"
28658 "\n"
28659 msgstr ""
28660
28661 # type: textblock
28662 #. type: textblock
28663 #: ../fish/guestfish-actions.pod:3991
28664 msgid "See also: L</part-list>"
28665 msgstr ""
28666
28667 # type: =head2
28668 #. type: =head2
28669 #: ../fish/guestfish-actions.pod:3993
28670 msgid "sh"
28671 msgstr ""
28672
28673 # type: verbatim
28674 #. type: verbatim
28675 #: ../fish/guestfish-actions.pod:3995
28676 #, no-wrap
28677 msgid ""
28678 " sh command\n"
28679 "\n"
28680 msgstr ""
28681
28682 # type: textblock
28683 #. type: textblock
28684 #: ../fish/guestfish-actions.pod:4000
28685 msgid "This is like L</command>, but passes the command to:"
28686 msgstr ""
28687
28688 # type: textblock
28689 #. type: textblock
28690 #: ../fish/guestfish-actions.pod:4008
28691 msgid "All the provisos about L</command> apply to this call."
28692 msgstr ""
28693
28694 # type: =head2
28695 #. type: =head2
28696 #: ../fish/guestfish-actions.pod:4010
28697 msgid "sh-lines"
28698 msgstr ""
28699
28700 # type: verbatim
28701 #. type: verbatim
28702 #: ../fish/guestfish-actions.pod:4012
28703 #, no-wrap
28704 msgid ""
28705 " sh-lines command\n"
28706 "\n"
28707 msgstr ""
28708
28709 # type: textblock
28710 #. type: textblock
28711 #: ../fish/guestfish-actions.pod:4014
28712 msgid "This is the same as L</sh>, but splits the result into a list of lines."
28713 msgstr ""
28714
28715 # type: textblock
28716 #. type: textblock
28717 #: ../fish/guestfish-actions.pod:4017
28718 msgid "See also: L</command-lines>"
28719 msgstr ""
28720
28721 # type: =head2
28722 #. type: =head2
28723 #: ../fish/guestfish-actions.pod:4019
28724 msgid "sleep"
28725 msgstr ""
28726
28727 # type: verbatim
28728 #. type: verbatim
28729 #: ../fish/guestfish-actions.pod:4021
28730 #, no-wrap
28731 msgid ""
28732 " sleep secs\n"
28733 "\n"
28734 msgstr ""
28735
28736 # type: =head2
28737 #. type: =head2
28738 #: ../fish/guestfish-actions.pod:4025
28739 msgid "stat"
28740 msgstr ""
28741
28742 # type: verbatim
28743 #. type: verbatim
28744 #: ../fish/guestfish-actions.pod:4027
28745 #, no-wrap
28746 msgid ""
28747 " stat path\n"
28748 "\n"
28749 msgstr ""
28750
28751 # type: =head2
28752 #. type: =head2
28753 #: ../fish/guestfish-actions.pod:4033
28754 msgid "statvfs"
28755 msgstr ""
28756
28757 # type: verbatim
28758 #. type: verbatim
28759 #: ../fish/guestfish-actions.pod:4035
28760 #, no-wrap
28761 msgid ""
28762 " statvfs path\n"
28763 "\n"
28764 msgstr ""
28765
28766 # type: =head2
28767 #. type: =head2
28768 #: ../fish/guestfish-actions.pod:4043
28769 msgid "strings"
28770 msgstr ""
28771
28772 # type: verbatim
28773 #. type: verbatim
28774 #: ../fish/guestfish-actions.pod:4045
28775 #, no-wrap
28776 msgid ""
28777 " strings path\n"
28778 "\n"
28779 msgstr ""
28780
28781 # type: =head2
28782 #. type: =head2
28783 #: ../fish/guestfish-actions.pod:4053
28784 msgid "strings-e"
28785 msgstr ""
28786
28787 # type: verbatim
28788 #. type: verbatim
28789 #: ../fish/guestfish-actions.pod:4055
28790 #, no-wrap
28791 msgid ""
28792 " strings-e encoding path\n"
28793 "\n"
28794 msgstr ""
28795
28796 # type: textblock
28797 #. type: textblock
28798 #: ../fish/guestfish-actions.pod:4057
28799 msgid ""
28800 "This is like the L</strings> command, but allows you to specify the encoding "
28801 "of strings that are looked for in the source file C<path>."
28802 msgstr ""
28803
28804 # type: textblock
28805 #. type: textblock
28806 #: ../fish/guestfish-actions.pod:4067
28807 msgid ""
28808 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
28809 "ISO-8859-X (this is what L</strings> uses)."
28810 msgstr ""
28811
28812 # type: =head2
28813 #. type: =head2
28814 #: ../fish/guestfish-actions.pod:4099
28815 msgid "swapoff-device"
28816 msgstr ""
28817
28818 # type: verbatim
28819 #. type: verbatim
28820 #: ../fish/guestfish-actions.pod:4101
28821 #, no-wrap
28822 msgid ""
28823 " swapoff-device device\n"
28824 "\n"
28825 msgstr ""
28826
28827 # type: textblock
28828 #. type: textblock
28829 #: ../fish/guestfish-actions.pod:4103
28830 msgid ""
28831 "This command disables the libguestfs appliance swap device or partition "
28832 "named C<device>.  See L</swapon-device>."
28833 msgstr ""
28834
28835 # type: =head2
28836 #. type: =head2
28837 #: ../fish/guestfish-actions.pod:4107
28838 msgid "swapoff-file"
28839 msgstr ""
28840
28841 # type: verbatim
28842 #. type: verbatim
28843 #: ../fish/guestfish-actions.pod:4109
28844 #, no-wrap
28845 msgid ""
28846 " swapoff-file file\n"
28847 "\n"
28848 msgstr ""
28849
28850 # type: =head2
28851 #. type: =head2
28852 #: ../fish/guestfish-actions.pod:4113
28853 msgid "swapoff-label"
28854 msgstr ""
28855
28856 # type: verbatim
28857 #. type: verbatim
28858 #: ../fish/guestfish-actions.pod:4115
28859 #, no-wrap
28860 msgid ""
28861 " swapoff-label label\n"
28862 "\n"
28863 msgstr ""
28864
28865 # type: =head2
28866 #. type: =head2
28867 #: ../fish/guestfish-actions.pod:4120
28868 msgid "swapoff-uuid"
28869 msgstr ""
28870
28871 # type: verbatim
28872 #. type: verbatim
28873 #: ../fish/guestfish-actions.pod:4122
28874 #, no-wrap
28875 msgid ""
28876 " swapoff-uuid uuid\n"
28877 "\n"
28878 msgstr ""
28879
28880 # type: =head2
28881 #. type: =head2
28882 #: ../fish/guestfish-actions.pod:4127
28883 msgid "swapon-device"
28884 msgstr ""
28885
28886 # type: verbatim
28887 #. type: verbatim
28888 #: ../fish/guestfish-actions.pod:4129
28889 #, no-wrap
28890 msgid ""
28891 " swapon-device device\n"
28892 "\n"
28893 msgstr ""
28894
28895 # type: textblock
28896 #. type: textblock
28897 #: ../fish/guestfish-actions.pod:4131
28898 msgid ""
28899 "This command enables the libguestfs appliance to use the swap device or "
28900 "partition named C<device>.  The increased memory is made available for all "
28901 "commands, for example those run using L</command> or L</sh>."
28902 msgstr ""
28903
28904 # type: =head2
28905 #. type: =head2
28906 #: ../fish/guestfish-actions.pod:4143
28907 msgid "swapon-file"
28908 msgstr ""
28909
28910 # type: verbatim
28911 #. type: verbatim
28912 #: ../fish/guestfish-actions.pod:4145
28913 #, no-wrap
28914 msgid ""
28915 " swapon-file file\n"
28916 "\n"
28917 msgstr ""
28918
28919 # type: textblock
28920 #. type: textblock
28921 #: ../fish/guestfish-actions.pod:4147
28922 msgid ""
28923 "This command enables swap to a file.  See L</swapon-device> for other notes."
28924 msgstr ""
28925
28926 # type: =head2
28927 #. type: =head2
28928 #: ../fish/guestfish-actions.pod:4150
28929 msgid "swapon-label"
28930 msgstr ""
28931
28932 # type: verbatim
28933 #. type: verbatim
28934 #: ../fish/guestfish-actions.pod:4152
28935 #, no-wrap
28936 msgid ""
28937 " swapon-label label\n"
28938 "\n"
28939 msgstr ""
28940
28941 # type: textblock
28942 #. type: textblock
28943 #: ../fish/guestfish-actions.pod:4154
28944 msgid ""
28945 "This command enables swap to a labeled swap partition.  See L</swapon-"
28946 "device> for other notes."
28947 msgstr ""
28948
28949 # type: =head2
28950 #. type: =head2
28951 #: ../fish/guestfish-actions.pod:4157
28952 msgid "swapon-uuid"
28953 msgstr ""
28954
28955 # type: verbatim
28956 #. type: verbatim
28957 #: ../fish/guestfish-actions.pod:4159
28958 #, no-wrap
28959 msgid ""
28960 " swapon-uuid uuid\n"
28961 "\n"
28962 msgstr ""
28963
28964 # type: textblock
28965 #. type: textblock
28966 #: ../fish/guestfish-actions.pod:4161
28967 msgid ""
28968 "This command enables swap to a swap partition with the given UUID.  See L</"
28969 "swapon-device> for other notes."
28970 msgstr ""
28971
28972 # type: =head2
28973 #. type: =head2
28974 #: ../fish/guestfish-actions.pod:4164
28975 msgid "sync"
28976 msgstr ""
28977
28978 # type: verbatim
28979 #. type: verbatim
28980 #: ../fish/guestfish-actions.pod:4166
28981 #, no-wrap
28982 msgid ""
28983 " sync\n"
28984 "\n"
28985 msgstr ""
28986
28987 # type: =head2
28988 #. type: =head2
28989 #: ../fish/guestfish-actions.pod:4174
28990 msgid "tail"
28991 msgstr ""
28992
28993 # type: verbatim
28994 #. type: verbatim
28995 #: ../fish/guestfish-actions.pod:4176
28996 #, no-wrap
28997 msgid ""
28998 " tail path\n"
28999 "\n"
29000 msgstr ""
29001
29002 # type: =head2
29003 #. type: =head2
29004 #: ../fish/guestfish-actions.pod:4184
29005 msgid "tail-n"
29006 msgstr ""
29007
29008 # type: verbatim
29009 #. type: verbatim
29010 #: ../fish/guestfish-actions.pod:4186
29011 #, no-wrap
29012 msgid ""
29013 " tail-n nrlines path\n"
29014 "\n"
29015 msgstr ""
29016
29017 # type: =head2
29018 #. type: =head2
29019 #: ../fish/guestfish-actions.pod:4199
29020 msgid "tar-in"
29021 msgstr ""
29022
29023 # type: verbatim
29024 #. type: verbatim
29025 #: ../fish/guestfish-actions.pod:4201
29026 #, no-wrap
29027 msgid ""
29028 " tar-in (tarfile|-) directory\n"
29029 "\n"
29030 msgstr ""
29031
29032 # type: textblock
29033 #. type: textblock
29034 #: ../fish/guestfish-actions.pod:4206
29035 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
29036 msgstr ""
29037
29038 # type: =head2
29039 #. type: =head2
29040 #: ../fish/guestfish-actions.pod:4211
29041 msgid "tar-out"
29042 msgstr ""
29043
29044 # type: verbatim
29045 #. type: verbatim
29046 #: ../fish/guestfish-actions.pod:4213
29047 #, no-wrap
29048 msgid ""
29049 " tar-out directory (tarfile|-)\n"
29050 "\n"
29051 msgstr ""
29052
29053 # type: textblock
29054 #. type: textblock
29055 #: ../fish/guestfish-actions.pod:4218
29056 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
29057 msgstr ""
29058
29059 # type: =head2
29060 #. type: =head2
29061 #: ../fish/guestfish-actions.pod:4223
29062 msgid "tgz-in"
29063 msgstr ""
29064
29065 # type: verbatim
29066 #. type: verbatim
29067 #: ../fish/guestfish-actions.pod:4225
29068 #, no-wrap
29069 msgid ""
29070 " tgz-in (tarball|-) directory\n"
29071 "\n"
29072 msgstr ""
29073
29074 # type: textblock
29075 #. type: textblock
29076 #: ../fish/guestfish-actions.pod:4230
29077 msgid "To upload an uncompressed tarball, use L</tar-in>."
29078 msgstr ""
29079
29080 # type: =head2
29081 #. type: =head2
29082 #: ../fish/guestfish-actions.pod:4234
29083 msgid "tgz-out"
29084 msgstr ""
29085
29086 # type: verbatim
29087 #. type: verbatim
29088 #: ../fish/guestfish-actions.pod:4236
29089 #, no-wrap
29090 msgid ""
29091 " tgz-out directory (tarball|-)\n"
29092 "\n"
29093 msgstr ""
29094
29095 # type: textblock
29096 #. type: textblock
29097 #: ../fish/guestfish-actions.pod:4241
29098 msgid "To download an uncompressed tarball, use L</tar-out>."
29099 msgstr ""
29100
29101 # type: =head2
29102 #. type: =head2
29103 #: ../fish/guestfish-actions.pod:4245
29104 msgid "touch"
29105 msgstr ""
29106
29107 # type: verbatim
29108 #. type: verbatim
29109 #: ../fish/guestfish-actions.pod:4247
29110 #, no-wrap
29111 msgid ""
29112 " touch path\n"
29113 "\n"
29114 msgstr ""
29115
29116 # type: =head2
29117 #. type: =head2
29118 #: ../fish/guestfish-actions.pod:4256
29119 msgid "truncate"
29120 msgstr ""
29121
29122 # type: verbatim
29123 #. type: verbatim
29124 #: ../fish/guestfish-actions.pod:4258
29125 #, no-wrap
29126 msgid ""
29127 " truncate path\n"
29128 "\n"
29129 msgstr ""
29130
29131 # type: =head2
29132 #. type: =head2
29133 #: ../fish/guestfish-actions.pod:4263
29134 msgid "truncate-size"
29135 msgstr ""
29136
29137 # type: verbatim
29138 #. type: verbatim
29139 #: ../fish/guestfish-actions.pod:4265
29140 #, no-wrap
29141 msgid ""
29142 " truncate-size path size\n"
29143 "\n"
29144 msgstr ""
29145
29146 # type: textblock
29147 #. type: textblock
29148 #: ../fish/guestfish-actions.pod:4270
29149 msgid ""
29150 "If the current file size is less than C<size> then the file is extended to "
29151 "the required size with zero bytes.  This creates a sparse file (ie. disk "
29152 "blocks are not allocated for the file until you write to it).  To create a "
29153 "non-sparse file of zeroes, use L</fallocate64> instead."
29154 msgstr ""
29155
29156 # type: =head2
29157 #. type: =head2
29158 #: ../fish/guestfish-actions.pod:4276
29159 msgid "tune2fs-l"
29160 msgstr ""
29161
29162 # type: verbatim
29163 #. type: verbatim
29164 #: ../fish/guestfish-actions.pod:4278
29165 #, no-wrap
29166 msgid ""
29167 " tune2fs-l device\n"
29168 "\n"
29169 msgstr ""
29170
29171 # type: =head2
29172 #. type: =head2
29173 #: ../fish/guestfish-actions.pod:4288
29174 msgid "txz-in"
29175 msgstr ""
29176
29177 # type: verbatim
29178 #. type: verbatim
29179 #: ../fish/guestfish-actions.pod:4290
29180 #, no-wrap
29181 msgid ""
29182 " txz-in (tarball|-) directory\n"
29183 "\n"
29184 msgstr ""
29185
29186 # type: =head2
29187 #. type: =head2
29188 #: ../fish/guestfish-actions.pod:4297
29189 msgid "txz-out"
29190 msgstr ""
29191
29192 # type: verbatim
29193 #. type: verbatim
29194 #: ../fish/guestfish-actions.pod:4299
29195 #, no-wrap
29196 msgid ""
29197 " txz-out directory (tarball|-)\n"
29198 "\n"
29199 msgstr ""
29200
29201 # type: =head2
29202 #. type: =head2
29203 #: ../fish/guestfish-actions.pod:4306
29204 msgid "umask"
29205 msgstr ""
29206
29207 # type: verbatim
29208 #. type: verbatim
29209 #: ../fish/guestfish-actions.pod:4308
29210 #, no-wrap
29211 msgid ""
29212 " umask mask\n"
29213 "\n"
29214 msgstr ""
29215
29216 # type: textblock
29217 #. type: textblock
29218 #: ../fish/guestfish-actions.pod:4322
29219 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
29220 msgstr ""
29221
29222 # type: =head2
29223 #. type: =head2
29224 #: ../fish/guestfish-actions.pod:4327
29225 msgid "umount"
29226 msgstr ""
29227
29228 # type: =head2
29229 #. type: =head2
29230 #: ../fish/guestfish-actions.pod:4329
29231 msgid "unmount"
29232 msgstr ""
29233
29234 # type: verbatim
29235 #. type: verbatim
29236 #: ../fish/guestfish-actions.pod:4331
29237 #, no-wrap
29238 msgid ""
29239 " umount pathordevice\n"
29240 "\n"
29241 msgstr ""
29242
29243 # type: =head2
29244 #. type: =head2
29245 #: ../fish/guestfish-actions.pod:4337
29246 msgid "umount-all"
29247 msgstr ""
29248
29249 # type: =head2
29250 #. type: =head2
29251 #: ../fish/guestfish-actions.pod:4339
29252 msgid "unmount-all"
29253 msgstr ""
29254
29255 # type: verbatim
29256 #. type: verbatim
29257 #: ../fish/guestfish-actions.pod:4341
29258 #, no-wrap
29259 msgid ""
29260 " umount-all\n"
29261 "\n"
29262 msgstr ""
29263
29264 # type: =head2
29265 #. type: =head2
29266 #: ../fish/guestfish-actions.pod:4347
29267 msgid "upload"
29268 msgstr ""
29269
29270 # type: verbatim
29271 #. type: verbatim
29272 #: ../fish/guestfish-actions.pod:4349
29273 #, no-wrap
29274 msgid ""
29275 " upload (filename|-) remotefilename\n"
29276 "\n"
29277 msgstr ""
29278
29279 # type: textblock
29280 #. type: textblock
29281 #: ../fish/guestfish-actions.pod:4356
29282 msgid "See also L</download>."
29283 msgstr ""
29284
29285 # type: =head2
29286 #. type: =head2
29287 #: ../fish/guestfish-actions.pod:4360
29288 msgid "upload-offset"
29289 msgstr ""
29290
29291 # type: verbatim
29292 #. type: verbatim
29293 #: ../fish/guestfish-actions.pod:4362
29294 #, no-wrap
29295 msgid ""
29296 " upload-offset (filename|-) remotefilename offset\n"
29297 "\n"
29298 msgstr ""
29299
29300 # type: textblock
29301 #. type: textblock
29302 #: ../fish/guestfish-actions.pod:4374
29303 msgid ""
29304 "Note that there is no limit on the amount of data that can be uploaded with "
29305 "this call, unlike with L</pwrite>, and this call always writes the full "
29306 "amount unless an error occurs."
29307 msgstr ""
29308
29309 # type: textblock
29310 #. type: textblock
29311 #: ../fish/guestfish-actions.pod:4379
29312 msgid "See also L</upload>, L</pwrite>."
29313 msgstr ""
29314
29315 # type: =head2
29316 #. type: =head2
29317 #: ../fish/guestfish-actions.pod:4383
29318 msgid "utimens"
29319 msgstr ""
29320
29321 # type: verbatim
29322 #. type: verbatim
29323 #: ../fish/guestfish-actions.pod:4385
29324 #, no-wrap
29325 msgid ""
29326 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
29327 "\n"
29328 msgstr ""
29329
29330 # type: =head2
29331 #. type: =head2
29332 #: ../fish/guestfish-actions.pod:4404
29333 msgid "version"
29334 msgstr ""
29335
29336 # type: verbatim
29337 #. type: verbatim
29338 #: ../fish/guestfish-actions.pod:4406
29339 #, no-wrap
29340 msgid ""
29341 " version\n"
29342 "\n"
29343 msgstr ""
29344
29345 # type: textblock
29346 #. type: textblock
29347 #: ../fish/guestfish-actions.pod:4433
29348 msgid ""
29349 "I<Note:> Don't use this call to test for availability of features.  In "
29350 "enterprise distributions we backport features from later versions into "
29351 "earlier versions, making this an unreliable way to test for features.  Use "
29352 "L</available> instead."
29353 msgstr ""
29354
29355 # type: =head2
29356 #. type: =head2
29357 #: ../fish/guestfish-actions.pod:4439
29358 msgid "vfs-label"
29359 msgstr ""
29360
29361 # type: verbatim
29362 #. type: verbatim
29363 #: ../fish/guestfish-actions.pod:4441
29364 #, no-wrap
29365 msgid ""
29366 " vfs-label device\n"
29367 "\n"
29368 msgstr ""
29369
29370 # type: textblock
29371 #. type: textblock
29372 #: ../fish/guestfish-actions.pod:4448
29373 msgid "To find a filesystem from the label, use L</findfs-label>."
29374 msgstr ""
29375
29376 # type: =head2
29377 #. type: =head2
29378 #: ../fish/guestfish-actions.pod:4450
29379 msgid "vfs-type"
29380 msgstr ""
29381
29382 # type: verbatim
29383 #. type: verbatim
29384 #: ../fish/guestfish-actions.pod:4452
29385 #, no-wrap
29386 msgid ""
29387 " vfs-type device\n"
29388 "\n"
29389 msgstr ""
29390
29391 # type: =head2
29392 #. type: =head2
29393 #: ../fish/guestfish-actions.pod:4462
29394 msgid "vfs-uuid"
29395 msgstr ""
29396
29397 # type: verbatim
29398 #. type: verbatim
29399 #: ../fish/guestfish-actions.pod:4464
29400 #, no-wrap
29401 msgid ""
29402 " vfs-uuid device\n"
29403 "\n"
29404 msgstr ""
29405
29406 # type: textblock
29407 #. type: textblock
29408 #: ../fish/guestfish-actions.pod:4471
29409 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
29410 msgstr ""
29411
29412 # type: =head2
29413 #. type: =head2
29414 #: ../fish/guestfish-actions.pod:4473
29415 msgid "vg-activate"
29416 msgstr ""
29417
29418 # type: verbatim
29419 #. type: verbatim
29420 #: ../fish/guestfish-actions.pod:4475
29421 #, no-wrap
29422 msgid ""
29423 " vg-activate true|false 'volgroups ...'\n"
29424 "\n"
29425 msgstr ""
29426
29427 # type: =head2
29428 #. type: =head2
29429 #: ../fish/guestfish-actions.pod:4488
29430 msgid "vg-activate-all"
29431 msgstr ""
29432
29433 # type: verbatim
29434 #. type: verbatim
29435 #: ../fish/guestfish-actions.pod:4490
29436 #, no-wrap
29437 msgid ""
29438 " vg-activate-all true|false\n"
29439 "\n"
29440 msgstr ""
29441
29442 # type: =head2
29443 #. type: =head2
29444 #: ../fish/guestfish-actions.pod:4500
29445 msgid "vgcreate"
29446 msgstr ""
29447
29448 # type: verbatim
29449 #. type: verbatim
29450 #: ../fish/guestfish-actions.pod:4502
29451 #, no-wrap
29452 msgid ""
29453 " vgcreate volgroup 'physvols ...'\n"
29454 "\n"
29455 msgstr ""
29456
29457 # type: =head2
29458 #. type: =head2
29459 #: ../fish/guestfish-actions.pod:4507
29460 msgid "vglvuuids"
29461 msgstr ""
29462
29463 # type: verbatim
29464 #. type: verbatim
29465 #: ../fish/guestfish-actions.pod:4509
29466 #, no-wrap
29467 msgid ""
29468 " vglvuuids vgname\n"
29469 "\n"
29470 msgstr ""
29471
29472 # type: textblock
29473 #. type: textblock
29474 #: ../fish/guestfish-actions.pod:4514
29475 msgid ""
29476 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
29477 "logical volumes and volume groups."
29478 msgstr ""
29479
29480 # type: textblock
29481 #. type: textblock
29482 #: ../fish/guestfish-actions.pod:4517
29483 msgid "See also L</vgpvuuids>."
29484 msgstr ""
29485
29486 # type: =head2
29487 #. type: =head2
29488 #: ../fish/guestfish-actions.pod:4519
29489 msgid "vgpvuuids"
29490 msgstr ""
29491
29492 # type: verbatim
29493 #. type: verbatim
29494 #: ../fish/guestfish-actions.pod:4521
29495 #, no-wrap
29496 msgid ""
29497 " vgpvuuids vgname\n"
29498 "\n"
29499 msgstr ""
29500
29501 # type: textblock
29502 #. type: textblock
29503 #: ../fish/guestfish-actions.pod:4526
29504 msgid ""
29505 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
29506 "physical volumes and volume groups."
29507 msgstr ""
29508
29509 # type: textblock
29510 #. type: textblock
29511 #: ../fish/guestfish-actions.pod:4529
29512 msgid "See also L</vglvuuids>."
29513 msgstr ""
29514
29515 # type: =head2
29516 #. type: =head2
29517 #: ../fish/guestfish-actions.pod:4531
29518 msgid "vgremove"
29519 msgstr ""
29520
29521 # type: verbatim
29522 #. type: verbatim
29523 #: ../fish/guestfish-actions.pod:4533
29524 #, no-wrap
29525 msgid ""
29526 " vgremove vgname\n"
29527 "\n"
29528 msgstr ""
29529
29530 # type: =head2
29531 #. type: =head2
29532 #: ../fish/guestfish-actions.pod:4540
29533 msgid "vgrename"
29534 msgstr ""
29535
29536 # type: verbatim
29537 #. type: verbatim
29538 #: ../fish/guestfish-actions.pod:4542
29539 #, no-wrap
29540 msgid ""
29541 " vgrename volgroup newvolgroup\n"
29542 "\n"
29543 msgstr ""
29544
29545 # type: =head2
29546 #. type: =head2
29547 #: ../fish/guestfish-actions.pod:4546
29548 msgid "vgs"
29549 msgstr ""
29550
29551 # type: verbatim
29552 #. type: verbatim
29553 #: ../fish/guestfish-actions.pod:4548
29554 #, no-wrap
29555 msgid ""
29556 " vgs\n"
29557 "\n"
29558 msgstr ""
29559
29560 # type: textblock
29561 #. type: textblock
29562 #: ../fish/guestfish-actions.pod:4556
29563 msgid "See also L</vgs-full>."
29564 msgstr ""
29565
29566 # type: =head2
29567 #. type: =head2
29568 #: ../fish/guestfish-actions.pod:4558
29569 msgid "vgs-full"
29570 msgstr ""
29571
29572 # type: verbatim
29573 #. type: verbatim
29574 #: ../fish/guestfish-actions.pod:4560
29575 #, no-wrap
29576 msgid ""
29577 " vgs-full\n"
29578 "\n"
29579 msgstr ""
29580
29581 # type: =head2
29582 #. type: =head2
29583 #: ../fish/guestfish-actions.pod:4565
29584 msgid "vgscan"
29585 msgstr ""
29586
29587 # type: verbatim
29588 #. type: verbatim
29589 #: ../fish/guestfish-actions.pod:4567
29590 #, no-wrap
29591 msgid ""
29592 " vgscan\n"
29593 "\n"
29594 msgstr ""
29595
29596 # type: =head2
29597 #. type: =head2
29598 #: ../fish/guestfish-actions.pod:4572
29599 msgid "vguuid"
29600 msgstr ""
29601
29602 # type: verbatim
29603 #. type: verbatim
29604 #: ../fish/guestfish-actions.pod:4574
29605 #, no-wrap
29606 msgid ""
29607 " vguuid vgname\n"
29608 "\n"
29609 msgstr ""
29610
29611 # type: =head2
29612 #. type: =head2
29613 #: ../fish/guestfish-actions.pod:4578
29614 msgid "wc-c"
29615 msgstr ""
29616
29617 # type: verbatim
29618 #. type: verbatim
29619 #: ../fish/guestfish-actions.pod:4580
29620 #, no-wrap
29621 msgid ""
29622 " wc-c path\n"
29623 "\n"
29624 msgstr ""
29625
29626 # type: =head2
29627 #. type: =head2
29628 #: ../fish/guestfish-actions.pod:4585
29629 msgid "wc-l"
29630 msgstr ""
29631
29632 # type: verbatim
29633 #. type: verbatim
29634 #: ../fish/guestfish-actions.pod:4587
29635 #, no-wrap
29636 msgid ""
29637 " wc-l path\n"
29638 "\n"
29639 msgstr ""
29640
29641 # type: =head2
29642 #. type: =head2
29643 #: ../fish/guestfish-actions.pod:4592
29644 msgid "wc-w"
29645 msgstr ""
29646
29647 # type: verbatim
29648 #. type: verbatim
29649 #: ../fish/guestfish-actions.pod:4594
29650 #, no-wrap
29651 msgid ""
29652 " wc-w path\n"
29653 "\n"
29654 msgstr ""
29655
29656 # type: =head2
29657 #. type: =head2
29658 #: ../fish/guestfish-actions.pod:4599
29659 msgid "write"
29660 msgstr ""
29661
29662 # type: verbatim
29663 #. type: verbatim
29664 #: ../fish/guestfish-actions.pod:4601
29665 #, no-wrap
29666 msgid ""
29667 " write path content\n"
29668 "\n"
29669 msgstr ""
29670
29671 # type: =head2
29672 #. type: =head2
29673 #: ../fish/guestfish-actions.pod:4609
29674 msgid "write-file"
29675 msgstr ""
29676
29677 # type: verbatim
29678 #. type: verbatim
29679 #: ../fish/guestfish-actions.pod:4611
29680 #, no-wrap
29681 msgid ""
29682 " write-file path content size\n"
29683 "\n"
29684 msgstr ""
29685
29686 #. type: textblock
29687 #: ../fish/guestfish-actions.pod:4627
29688 msgid ""
29689 "This function is deprecated.  In new code, use the L</write> call instead."
29690 msgstr ""
29691
29692 # type: =head2
29693 #. type: =head2
29694 #: ../fish/guestfish-actions.pod:4634
29695 msgid "zegrep"
29696 msgstr ""
29697
29698 # type: verbatim
29699 #. type: verbatim
29700 #: ../fish/guestfish-actions.pod:4636
29701 #, no-wrap
29702 msgid ""
29703 " zegrep regex path\n"
29704 "\n"
29705 msgstr ""
29706
29707 # type: =head2
29708 #. type: =head2
29709 #: ../fish/guestfish-actions.pod:4644
29710 msgid "zegrepi"
29711 msgstr ""
29712
29713 # type: verbatim
29714 #. type: verbatim
29715 #: ../fish/guestfish-actions.pod:4646
29716 #, no-wrap
29717 msgid ""
29718 " zegrepi regex path\n"
29719 "\n"
29720 msgstr ""
29721
29722 # type: =head2
29723 #. type: =head2
29724 #: ../fish/guestfish-actions.pod:4654
29725 msgid "zero"
29726 msgstr ""
29727
29728 # type: verbatim
29729 #. type: verbatim
29730 #: ../fish/guestfish-actions.pod:4656
29731 #, no-wrap
29732 msgid ""
29733 " zero device\n"
29734 "\n"
29735 msgstr ""
29736
29737 # type: textblock
29738 #. type: textblock
29739 #: ../fish/guestfish-actions.pod:4664
29740 msgid "See also: L</zero-device>, L</scrub-device>."
29741 msgstr ""
29742
29743 # type: =head2
29744 #. type: =head2
29745 #: ../fish/guestfish-actions.pod:4666
29746 msgid "zero-device"
29747 msgstr ""
29748
29749 # type: verbatim
29750 #. type: verbatim
29751 #: ../fish/guestfish-actions.pod:4668
29752 #, no-wrap
29753 msgid ""
29754 " zero-device device\n"
29755 "\n"
29756 msgstr ""
29757
29758 # type: textblock
29759 #. type: textblock
29760 #: ../fish/guestfish-actions.pod:4670
29761 msgid ""
29762 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
29763 "which just zeroes the first few blocks of a device."
29764 msgstr ""
29765
29766 # type: =head2
29767 #. type: =head2
29768 #: ../fish/guestfish-actions.pod:4677
29769 msgid "zerofree"
29770 msgstr ""
29771
29772 # type: verbatim
29773 #. type: verbatim
29774 #: ../fish/guestfish-actions.pod:4679
29775 #, no-wrap
29776 msgid ""
29777 " zerofree device\n"
29778 "\n"
29779 msgstr ""
29780
29781 # type: =head2
29782 #. type: =head2
29783 #: ../fish/guestfish-actions.pod:4692
29784 msgid "zfgrep"
29785 msgstr ""
29786
29787 # type: verbatim
29788 #. type: verbatim
29789 #: ../fish/guestfish-actions.pod:4694
29790 #, no-wrap
29791 msgid ""
29792 " zfgrep pattern path\n"
29793 "\n"
29794 msgstr ""
29795
29796 # type: =head2
29797 #. type: =head2
29798 #: ../fish/guestfish-actions.pod:4702
29799 msgid "zfgrepi"
29800 msgstr ""
29801
29802 # type: verbatim
29803 #. type: verbatim
29804 #: ../fish/guestfish-actions.pod:4704
29805 #, no-wrap
29806 msgid ""
29807 " zfgrepi pattern path\n"
29808 "\n"
29809 msgstr ""
29810
29811 # type: =head2
29812 #. type: =head2
29813 #: ../fish/guestfish-actions.pod:4712
29814 msgid "zfile"
29815 msgstr ""
29816
29817 # type: verbatim
29818 #. type: verbatim
29819 #: ../fish/guestfish-actions.pod:4714
29820 #, no-wrap
29821 msgid ""
29822 " zfile meth path\n"
29823 "\n"
29824 msgstr ""
29825
29826 # type: textblock
29827 #. type: textblock
29828 #: ../fish/guestfish-actions.pod:4721
29829 msgid ""
29830 "Since 1.0.63, use L</file> instead which can now process compressed files."
29831 msgstr ""
29832
29833 #. type: textblock
29834 #: ../fish/guestfish-actions.pod:4724
29835 msgid ""
29836 "This function is deprecated.  In new code, use the L</file> call instead."
29837 msgstr ""
29838
29839 # type: =head2
29840 #. type: =head2
29841 #: ../fish/guestfish-actions.pod:4731
29842 msgid "zgrep"
29843 msgstr ""
29844
29845 # type: verbatim
29846 #. type: verbatim
29847 #: ../fish/guestfish-actions.pod:4733
29848 #, no-wrap
29849 msgid ""
29850 " zgrep regex path\n"
29851 "\n"
29852 msgstr ""
29853
29854 # type: =head2
29855 #. type: =head2
29856 #: ../fish/guestfish-actions.pod:4741
29857 msgid "zgrepi"
29858 msgstr ""
29859
29860 # type: verbatim
29861 #. type: verbatim
29862 #: ../fish/guestfish-actions.pod:4743
29863 #, no-wrap
29864 msgid ""
29865 " zgrepi regex path\n"
29866 "\n"
29867 msgstr ""
29868
29869 # type: =head2
29870 #. type: =head2
29871 #: ../fish/guestfish-commands.pod:1
29872 msgid "alloc"
29873 msgstr ""
29874
29875 # type: =head2
29876 #. type: =head2
29877 #: ../fish/guestfish-commands.pod:3
29878 msgid "allocate"
29879 msgstr ""
29880
29881 # type: verbatim
29882 #. type: verbatim
29883 #: ../fish/guestfish-commands.pod:5
29884 #, no-wrap
29885 msgid ""
29886 " alloc filename size\n"
29887 "\n"
29888 msgstr ""
29889
29890 # type: textblock
29891 #. type: textblock
29892 #: ../fish/guestfish-commands.pod:7
29893 msgid ""
29894 "This creates an empty (zeroed) file of the given size, and then adds so it "
29895 "can be further examined."
29896 msgstr ""
29897
29898 # type: textblock
29899 #. type: textblock
29900 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
29901 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
29902 msgstr ""
29903
29904 # type: textblock
29905 #. type: textblock
29906 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
29907 msgid "Size can be specified using standard suffixes, eg. C<1M>."
29908 msgstr ""
29909
29910 # type: textblock
29911 #. type: textblock
29912 #: ../fish/guestfish-commands.pod:14
29913 msgid ""
29914 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
29915 "image, see L</PREPARED DISK IMAGES>."
29916 msgstr ""
29917
29918 # type: =head2
29919 #. type: =head2
29920 #: ../fish/guestfish-commands.pod:17
29921 msgid "copy-in"
29922 msgstr ""
29923
29924 # type: verbatim
29925 #. type: verbatim
29926 #: ../fish/guestfish-commands.pod:19
29927 #, no-wrap
29928 msgid ""
29929 " copy-in local [local ...] /remotedir\n"
29930 "\n"
29931 msgstr ""
29932
29933 # type: textblock
29934 #. type: textblock
29935 #: ../fish/guestfish-commands.pod:21
29936 msgid ""
29937 "C<copy-in> copies local files or directories recursively into the disk "
29938 "image, placing them in the directory called C</remotedir> (which must "
29939 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
29940 "other commands as necessary."
29941 msgstr ""
29942
29943 # type: textblock
29944 #. type: textblock
29945 #: ../fish/guestfish-commands.pod:26
29946 msgid ""
29947 "Multiple local files and directories can be specified, but the last "
29948 "parameter must always be a remote directory.  Wildcards cannot be used."
29949 msgstr ""
29950
29951 # type: =head2
29952 #. type: =head2
29953 #: ../fish/guestfish-commands.pod:30
29954 msgid "copy-out"
29955 msgstr ""
29956
29957 # type: verbatim
29958 #. type: verbatim
29959 #: ../fish/guestfish-commands.pod:32
29960 #, no-wrap
29961 msgid ""
29962 " copy-out remote [remote ...] localdir\n"
29963 "\n"
29964 msgstr ""
29965
29966 # type: textblock
29967 #. type: textblock
29968 #: ../fish/guestfish-commands.pod:34
29969 msgid ""
29970 "C<copy-out> copies remote files or directories recursively out of the disk "
29971 "image, placing them on the host disk in a local directory called C<localdir> "
29972 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
29973 "download>, L</tar-out> and other commands as necessary."
29974 msgstr ""
29975
29976 # type: textblock
29977 #. type: textblock
29978 #: ../fish/guestfish-commands.pod:40
29979 msgid ""
29980 "Multiple remote files and directories can be specified, but the last "
29981 "parameter must always be a local directory.  To download to the current "
29982 "directory, use C<.> as in:"
29983 msgstr ""
29984
29985 # type: verbatim
29986 #. type: verbatim
29987 #: ../fish/guestfish-commands.pod:44
29988 #, no-wrap
29989 msgid ""
29990 " copy-out /home .\n"
29991 "\n"
29992 msgstr ""
29993
29994 # type: textblock
29995 #. type: textblock
29996 #: ../fish/guestfish-commands.pod:46
29997 msgid ""
29998 "Wildcards cannot be used in the ordinary command, but you can use them with "
29999 "the help of L</glob> like this:"
30000 msgstr ""
30001
30002 # type: verbatim
30003 #. type: verbatim
30004 #: ../fish/guestfish-commands.pod:49
30005 #, no-wrap
30006 msgid ""
30007 " glob copy-out /home/* .\n"
30008 "\n"
30009 msgstr ""
30010
30011 # type: =head2
30012 #. type: =head2
30013 #: ../fish/guestfish-commands.pod:51
30014 msgid "echo"
30015 msgstr ""
30016
30017 # type: verbatim
30018 #. type: verbatim
30019 #: ../fish/guestfish-commands.pod:53
30020 #, no-wrap
30021 msgid ""
30022 " echo [params ...]\n"
30023 "\n"
30024 msgstr ""
30025
30026 # type: textblock
30027 #. type: textblock
30028 #: ../fish/guestfish-commands.pod:55
30029 msgid "This echos the parameters to the terminal."
30030 msgstr ""
30031
30032 # type: =head2
30033 #. type: =head2
30034 #: ../fish/guestfish-commands.pod:57
30035 msgid "edit"
30036 msgstr ""
30037
30038 # type: =head2
30039 #. type: =head2
30040 #: ../fish/guestfish-commands.pod:59
30041 msgid "vi"
30042 msgstr ""
30043
30044 # type: =head2
30045 #. type: =head2
30046 #: ../fish/guestfish-commands.pod:61
30047 msgid "emacs"
30048 msgstr ""
30049
30050 # type: verbatim
30051 #. type: verbatim
30052 #: ../fish/guestfish-commands.pod:63
30053 #, no-wrap
30054 msgid ""
30055 " edit filename\n"
30056 "\n"
30057 msgstr ""
30058
30059 # type: textblock
30060 #. type: textblock
30061 #: ../fish/guestfish-commands.pod:65
30062 msgid ""
30063 "This is used to edit a file.  It downloads the file, edits it locally using "
30064 "your editor, then uploads the result."
30065 msgstr ""
30066
30067 # type: textblock
30068 #. type: textblock
30069 #: ../fish/guestfish-commands.pod:68
30070 msgid ""
30071 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
30072 "or C<emacs> you will get those corresponding editors."
30073 msgstr ""
30074
30075 # type: =head2
30076 #. type: =head2
30077 #: ../fish/guestfish-commands.pod:72
30078 msgid "glob"
30079 msgstr ""
30080
30081 # type: verbatim
30082 #. type: verbatim
30083 #: ../fish/guestfish-commands.pod:74
30084 #, no-wrap
30085 msgid ""
30086 " glob command args...\n"
30087 "\n"
30088 msgstr ""
30089
30090 # type: textblock
30091 #. type: textblock
30092 #: ../fish/guestfish-commands.pod:76
30093 msgid ""
30094 "Expand wildcards in any paths in the args list, and run C<command> "
30095 "repeatedly on each matching path."
30096 msgstr ""
30097
30098 # type: textblock
30099 #. type: textblock
30100 #: ../fish/guestfish-commands.pod:79
30101 msgid "See L</WILDCARDS AND GLOBBING>."
30102 msgstr ""
30103
30104 # type: =head2
30105 #. type: =head2
30106 #: ../fish/guestfish-commands.pod:81
30107 msgid "hexedit"
30108 msgstr ""
30109
30110 # type: verbatim
30111 #. type: verbatim
30112 #: ../fish/guestfish-commands.pod:83
30113 #, no-wrap
30114 msgid ""
30115 " hexedit <filename|device>\n"
30116 " hexedit <filename|device> <max>\n"
30117 " hexedit <filename|device> <start> <max>\n"
30118 "\n"
30119 msgstr ""
30120
30121 # type: textblock
30122 #. type: textblock
30123 #: ../fish/guestfish-commands.pod:87
30124 msgid ""
30125 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
30126 "device."
30127 msgstr ""
30128
30129 # type: textblock
30130 #. type: textblock
30131 #: ../fish/guestfish-commands.pod:90
30132 msgid ""
30133 "This command works by downloading potentially the whole file or device, "
30134 "editing it locally, then uploading it.  If the file or device is large, you "
30135 "have to specify which part you wish to edit by using C<max> and/or C<start> "
30136 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
30137 "usual modifiers allowed such as C<1M> (1 megabyte)."
30138 msgstr ""
30139
30140 # type: textblock
30141 #. type: textblock
30142 #: ../fish/guestfish-commands.pod:97
30143 msgid "For example to edit the first few sectors of a disk you might do:"
30144 msgstr ""
30145
30146 # type: verbatim
30147 #. type: verbatim
30148 #: ../fish/guestfish-commands.pod:100
30149 #, no-wrap
30150 msgid ""
30151 " hexedit /dev/sda 1M\n"
30152 "\n"
30153 msgstr ""
30154
30155 # type: textblock
30156 #. type: textblock
30157 #: ../fish/guestfish-commands.pod:102
30158 msgid ""
30159 "which would allow you to edit anywhere within the first megabyte of the disk."
30160 msgstr ""
30161
30162 # type: textblock
30163 #. type: textblock
30164 #: ../fish/guestfish-commands.pod:105
30165 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
30166 msgstr ""
30167
30168 # type: verbatim
30169 #. type: verbatim
30170 #: ../fish/guestfish-commands.pod:107
30171 #, no-wrap
30172 msgid ""
30173 " hexedit /dev/sda1 0x400 0x400\n"
30174 "\n"
30175 msgstr ""
30176
30177 # type: textblock
30178 #. type: textblock
30179 #: ../fish/guestfish-commands.pod:109
30180 msgid "(assuming the superblock is in the standard location)."
30181 msgstr ""
30182
30183 # type: textblock
30184 #. type: textblock
30185 #: ../fish/guestfish-commands.pod:111
30186 msgid ""
30187 "This command requires the external L<hexedit(1)> program.  You can specify "
30188 "another program to use by setting the C<HEXEDITOR> environment variable."
30189 msgstr ""
30190
30191 # type: textblock
30192 #. type: textblock
30193 #: ../fish/guestfish-commands.pod:115
30194 msgid "See also L</hexdump>."
30195 msgstr ""
30196
30197 # type: =head2
30198 #. type: =head2
30199 #: ../fish/guestfish-commands.pod:117
30200 msgid "lcd"
30201 msgstr ""
30202
30203 # type: verbatim
30204 #. type: verbatim
30205 #: ../fish/guestfish-commands.pod:119
30206 #, no-wrap
30207 msgid ""
30208 " lcd directory\n"
30209 "\n"
30210 msgstr ""
30211
30212 # type: textblock
30213 #. type: textblock
30214 #: ../fish/guestfish-commands.pod:121
30215 msgid ""
30216 "Change the local directory, ie. the current directory of guestfish itself."
30217 msgstr ""
30218
30219 # type: textblock
30220 #. type: textblock
30221 #: ../fish/guestfish-commands.pod:124
30222 msgid "Note that C<!cd> won't do what you might expect."
30223 msgstr ""
30224
30225 # type: =head2
30226 #. type: =head2
30227 #: ../fish/guestfish-commands.pod:126
30228 msgid "man"
30229 msgstr ""
30230
30231 # type: =head2
30232 #. type: =head2
30233 #: ../fish/guestfish-commands.pod:128
30234 msgid "manual"
30235 msgstr ""
30236
30237 # type: verbatim
30238 #. type: verbatim
30239 #: ../fish/guestfish-commands.pod:130
30240 #, no-wrap
30241 msgid ""
30242 "  man\n"
30243 "\n"
30244 msgstr ""
30245
30246 # type: textblock
30247 #. type: textblock
30248 #: ../fish/guestfish-commands.pod:132
30249 msgid "Opens the manual page for guestfish."
30250 msgstr ""
30251
30252 # type: =head2
30253 #. type: =head2
30254 #: ../fish/guestfish-commands.pod:134
30255 msgid "more"
30256 msgstr ""
30257
30258 # type: =head2
30259 #. type: =head2
30260 #: ../fish/guestfish-commands.pod:136
30261 msgid "less"
30262 msgstr ""
30263
30264 # type: verbatim
30265 #. type: verbatim
30266 #: ../fish/guestfish-commands.pod:138
30267 #, no-wrap
30268 msgid ""
30269 " more filename\n"
30270 "\n"
30271 msgstr ""
30272
30273 # type: verbatim
30274 #. type: verbatim
30275 #: ../fish/guestfish-commands.pod:140
30276 #, no-wrap
30277 msgid ""
30278 " less filename\n"
30279 "\n"
30280 msgstr ""
30281
30282 # type: textblock
30283 #. type: textblock
30284 #: ../fish/guestfish-commands.pod:142
30285 msgid "This is used to view a file."
30286 msgstr ""
30287
30288 # type: textblock
30289 #. type: textblock
30290 #: ../fish/guestfish-commands.pod:144
30291 msgid ""
30292 "The default viewer is C<$PAGER>.  However if you use the alternate command "
30293 "C<less> you will get the C<less> command specifically."
30294 msgstr ""
30295
30296 # type: =head2
30297 #. type: =head2
30298 #: ../fish/guestfish-commands.pod:147
30299 msgid "reopen"
30300 msgstr ""
30301
30302 # type: verbatim
30303 #. type: verbatim
30304 #: ../fish/guestfish-commands.pod:149
30305 #, no-wrap
30306 msgid ""
30307 "  reopen\n"
30308 "\n"
30309 msgstr ""
30310
30311 # type: textblock
30312 #. type: textblock
30313 #: ../fish/guestfish-commands.pod:151
30314 msgid ""
30315 "Close and reopen the libguestfs handle.  It is not necessary to use this "
30316 "normally, because the handle is closed properly when guestfish exits.  "
30317 "However this is occasionally useful for testing."
30318 msgstr ""
30319
30320 # type: =head2
30321 #. type: =head2
30322 #: ../fish/guestfish-commands.pod:155
30323 msgid "sparse"
30324 msgstr ""
30325
30326 # type: verbatim
30327 #. type: verbatim
30328 #: ../fish/guestfish-commands.pod:157
30329 #, no-wrap
30330 msgid ""
30331 " sparse filename size\n"
30332 "\n"
30333 msgstr ""
30334
30335 # type: textblock
30336 #. type: textblock
30337 #: ../fish/guestfish-commands.pod:159
30338 msgid ""
30339 "This creates an empty sparse file of the given size, and then adds so it can "
30340 "be further examined."
30341 msgstr ""
30342
30343 # type: textblock
30344 #. type: textblock
30345 #: ../fish/guestfish-commands.pod:162
30346 msgid ""
30347 "In all respects it works the same as the L</alloc> command, except that the "
30348 "image file is allocated sparsely, which means that disk blocks are not "
30349 "assigned to the file until they are needed.  Sparse disk files only use "
30350 "space when written to, but they are slower and there is a danger you could "
30351 "run out of real disk space during a write operation."
30352 msgstr ""
30353
30354 # type: =head2
30355 #. type: =head2
30356 #: ../fish/guestfish-commands.pod:172
30357 msgid "supported"
30358 msgstr ""
30359
30360 # type: verbatim
30361 #. type: verbatim
30362 #: ../fish/guestfish-commands.pod:174
30363 #, no-wrap
30364 msgid ""
30365 " supported\n"
30366 "\n"
30367 msgstr ""
30368
30369 # type: textblock
30370 #. type: textblock
30371 #: ../fish/guestfish-commands.pod:176
30372 msgid ""
30373 "This command returns a list of the optional groups known to the daemon, and "
30374 "indicates which ones are supported by this build of the libguestfs appliance."
30375 msgstr ""
30376
30377 # type: textblock
30378 #. type: textblock
30379 #: ../fish/guestfish-commands.pod:180
30380 msgid "See also L<guestfs(3)/AVAILABILITY>."
30381 msgstr ""
30382
30383 # type: =head2
30384 #. type: =head2
30385 #: ../fish/guestfish-commands.pod:182
30386 msgid "time"
30387 msgstr ""
30388
30389 # type: verbatim
30390 #. type: verbatim
30391 #: ../fish/guestfish-commands.pod:184
30392 #, no-wrap
30393 msgid ""
30394 " time command args...\n"
30395 "\n"
30396 msgstr ""
30397
30398 # type: textblock
30399 #. type: textblock
30400 #: ../fish/guestfish-commands.pod:186
30401 msgid ""
30402 "Run the command as usual, but print the elapsed time afterwards.  This can "
30403 "be useful for benchmarking operations."
30404 msgstr ""
30405
30406 # type: textblock
30407 #. type: textblock
30408 #: ../test-tool/libguestfs-test-tool.pod:5
30409 msgid "libguestfs-test-tool - End user tests for libguestfs"
30410 msgstr ""
30411
30412 # type: verbatim
30413 #. type: verbatim
30414 #: ../test-tool/libguestfs-test-tool.pod:9
30415 #, no-wrap
30416 msgid ""
30417 " libguestfs-test-tool [--options]\n"
30418 "\n"
30419 msgstr ""
30420
30421 # type: textblock
30422 #. type: textblock
30423 #: ../test-tool/libguestfs-test-tool.pod:13
30424 msgid ""
30425 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
30426 "and developers, to allow them to check basic libguestfs functionality is "
30427 "working.  This is needed because libguestfs occasionally breaks for reasons "
30428 "beyond our control: usually because of changes in the underlying qemu or "
30429 "kernel packages, or the host environment."
30430 msgstr ""
30431
30432 # type: textblock
30433 #. type: textblock
30434 #: ../test-tool/libguestfs-test-tool.pod:20
30435 msgid "If you suspect a problem in libguestfs, then just run:"
30436 msgstr ""
30437
30438 # type: verbatim
30439 #. type: verbatim
30440 #: ../test-tool/libguestfs-test-tool.pod:22
30441 #, no-wrap
30442 msgid ""
30443 " libguestfs-test-tool\n"
30444 "\n"
30445 msgstr ""
30446
30447 # type: textblock
30448 #. type: textblock
30449 #: ../test-tool/libguestfs-test-tool.pod:24
30450 msgid "It will print lots of diagnostic messages."
30451 msgstr ""
30452
30453 # type: textblock
30454 #. type: textblock
30455 #: ../test-tool/libguestfs-test-tool.pod:26
30456 msgid "If it runs to completion successfully, you will see this near the end:"
30457 msgstr ""
30458
30459 # type: verbatim
30460 #. type: verbatim
30461 #: ../test-tool/libguestfs-test-tool.pod:28
30462 #, no-wrap
30463 msgid ""
30464 " ===== TEST FINISHED OK =====\n"
30465 "\n"
30466 msgstr ""
30467
30468 # type: textblock
30469 #. type: textblock
30470 #: ../test-tool/libguestfs-test-tool.pod:30
30471 msgid "and the test tool will exit with code 0."
30472 msgstr ""
30473
30474 # type: textblock
30475 #. type: textblock
30476 #: ../test-tool/libguestfs-test-tool.pod:32
30477 msgid ""
30478 "If it fails (and/or exits with non-zero error code), please paste the "
30479 "B<complete, unedited> output of the test tool into a bug report.  More "
30480 "information about reporting bugs can be found on the L<http://libguestfs.org/"
30481 "> website."
30482 msgstr ""
30483
30484 # type: =item
30485 #. type: =item
30486 #: ../test-tool/libguestfs-test-tool.pod:41
30487 msgid "I<--help>"
30488 msgstr ""
30489
30490 # type: textblock
30491 #. type: textblock
30492 #: ../test-tool/libguestfs-test-tool.pod:43
30493 msgid "Display short usage information and exit."
30494 msgstr ""
30495
30496 # type: =item
30497 #. type: =item
30498 #: ../test-tool/libguestfs-test-tool.pod:45
30499 msgid "I<--helper /path/to/libguestfs-test-tool-helper>"
30500 msgstr ""
30501
30502 # type: textblock
30503 #. type: textblock
30504 #: ../test-tool/libguestfs-test-tool.pod:47
30505 msgid ""
30506 "Pass an alternate name for the helper program.  libguestfs-test-tool will "
30507 "normally look in the C<$libexec> directory that was configured when the tool "
30508 "was built."
30509 msgstr ""
30510
30511 # type: =item
30512 #. type: =item
30513 #: ../test-tool/libguestfs-test-tool.pod:51
30514 msgid "I<--qemu qemu_binary>"
30515 msgstr ""
30516
30517 # type: textblock
30518 #. type: textblock
30519 #: ../test-tool/libguestfs-test-tool.pod:53
30520 msgid ""
30521 "If you have downloaded another qemu binary, point this option at the full "
30522 "path of the binary to try it."
30523 msgstr ""
30524
30525 # type: =item
30526 #. type: =item
30527 #: ../test-tool/libguestfs-test-tool.pod:56
30528 msgid "I<--qemudir qemu_source_dir>"
30529 msgstr ""
30530
30531 # type: textblock
30532 #. type: textblock
30533 #: ../test-tool/libguestfs-test-tool.pod:58
30534 msgid ""
30535 "If you have compiled qemu from source, point this option at the source "
30536 "directory to try it."
30537 msgstr ""
30538
30539 # type: =item
30540 #. type: =item
30541 #: ../test-tool/libguestfs-test-tool.pod:61
30542 msgid "I<--timeout N>"
30543 msgstr ""
30544
30545 # type: textblock
30546 #. type: textblock
30547 #: ../test-tool/libguestfs-test-tool.pod:63
30548 msgid ""
30549 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
30550 "does not usually need to be adjusted unless your machine is very slow."
30551 msgstr ""
30552
30553 # type: =head1
30554 #. type: =head1
30555 #: ../test-tool/libguestfs-test-tool.pod:69
30556 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
30557 msgstr ""
30558
30559 # type: textblock
30560 #. type: textblock
30561 #: ../test-tool/libguestfs-test-tool.pod:71
30562 msgid ""
30563 "If you have compiled another version of qemu from source and would like to "
30564 "try that, then you can use the I<--qemudir> option to point to the qemu "
30565 "source directory."
30566 msgstr ""
30567
30568 # type: textblock
30569 #. type: textblock
30570 #: ../test-tool/libguestfs-test-tool.pod:75
30571 msgid ""
30572 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
30573 "option to point to the binary."
30574 msgstr ""
30575
30576 # type: textblock
30577 #. type: textblock
30578 #: ../test-tool/libguestfs-test-tool.pod:78
30579 msgid ""
30580 "When using an alternate qemu with libguestfs, usually you would need to "
30581 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
30582 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
30583 "use either of the I<--qemudir> or I<--qemu> options."
30584 msgstr ""
30585
30586 # type: textblock
30587 #. type: textblock
30588 #: ../test-tool/libguestfs-test-tool.pod:85
30589 msgid ""
30590 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
30591 "I<1> if there was an error."
30592 msgstr ""
30593
30594 # type: =item
30595 #. type: =item
30596 #: ../test-tool/libguestfs-test-tool.pod:92
30597 msgid "/usr/libexec/libguestfs-test-tool-helper"
30598 msgstr ""
30599
30600 # type: textblock
30601 #. type: textblock
30602 #: ../test-tool/libguestfs-test-tool.pod:94
30603 msgid ""
30604 "This helper program is run inside the appliance and provides additional "
30605 "tests."
30606 msgstr ""
30607
30608 # type: =item
30609 #. type: =item
30610 #: ../test-tool/libguestfs-test-tool.pod:97
30611 msgid "/usr/bin/mkisofs"
30612 msgstr ""
30613
30614 # type: textblock
30615 #. type: textblock
30616 #: ../test-tool/libguestfs-test-tool.pod:99
30617 msgid ""
30618 "The C<mkisofs> command is required in order to construct a CD-ROM ISO file "
30619 "which is used as part of the tests."
30620 msgstr ""
30621
30622 # type: textblock
30623 #. type: textblock
30624 #: ../test-tool/libguestfs-test-tool.pod:106
30625 msgid ""
30626 "For the full list of environment variables which may affect libguestfs, "
30627 "please see the L<guestfs(3)> manual page."
30628 msgstr ""
30629
30630 # type: textblock
30631 #. type: textblock
30632 #: ../test-tool/libguestfs-test-tool.pod:111
30633 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
30634 msgstr ""
30635
30636 # type: textblock
30637 #. type: textblock
30638 #: ../test-tool/libguestfs-test-tool.pod:121
30639 msgid "Copyright (C) 2009 Red Hat Inc.  L<http://libguestfs.org/>"
30640 msgstr ""
30641
30642 # type: textblock
30643 #. type: textblock
30644 #: ../fuse/guestmount.pod:5
30645 msgid ""
30646 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
30647 msgstr ""
30648
30649 # type: verbatim
30650 #. type: verbatim
30651 #: ../fuse/guestmount.pod:9
30652 #, no-wrap
30653 msgid ""
30654 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
30655 "\n"
30656 msgstr ""
30657
30658 # type: verbatim
30659 #. type: verbatim
30660 #: ../fuse/guestmount.pod:11
30661 #, no-wrap
30662 msgid ""
30663 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
30664 "\n"
30665 msgstr ""
30666
30667 # type: verbatim
30668 #. type: verbatim
30669 #: ../fuse/guestmount.pod:13
30670 #, no-wrap
30671 msgid ""
30672 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
30673 "\n"
30674 msgstr ""
30675
30676 # type: textblock
30677 #. type: textblock
30678 #: ../fuse/guestmount.pod:17
30679 msgid ""
30680 "You must I<not> use C<guestmount> in read-write mode on live virtual "
30681 "machines.  If you do this, you risk disk corruption in the VM."
30682 msgstr ""
30683
30684 # type: textblock
30685 #. type: textblock
30686 #: ../fuse/guestmount.pod:22
30687 msgid ""
30688 "The guestmount program can be used to mount virtual machine filesystems and "
30689 "other disk images on the host.  It uses libguestfs for access to the guest "
30690 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
30691 "a mountable device."
30692 msgstr ""
30693
30694 # type: textblock
30695 #. type: textblock
30696 #: ../fuse/guestmount.pod:27
30697 msgid ""
30698 "Along with other options, you have to give at least one device (I<-a> "
30699 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
30700 "option) or use the I<-i> inspection option.  How this works is better "
30701 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
30702 "below."
30703 msgstr ""
30704
30705 # type: textblock
30706 #. type: textblock
30707 #: ../fuse/guestmount.pod:33
30708 msgid ""
30709 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
30710 "by you, and the filesystem will not be visible to any other users unless you "
30711 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
30712 "the filesystem, use the C<fusermount -u> command."
30713 msgstr ""
30714
30715 # type: textblock
30716 #. type: textblock
30717 #: ../fuse/guestmount.pod:41
30718 msgid ""
30719 "For a typical Windows guest which has its main filesystem on the first "
30720 "partition:"
30721 msgstr ""
30722
30723 # type: verbatim
30724 #. type: verbatim
30725 #: ../fuse/guestmount.pod:44
30726 #, no-wrap
30727 msgid ""
30728 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
30729 "\n"
30730 msgstr ""
30731
30732 # type: textblock
30733 #. type: textblock
30734 #: ../fuse/guestmount.pod:46
30735 msgid ""
30736 "For a typical Linux guest which has a /boot filesystem on the first "
30737 "partition, and the root filesystem on a logical volume:"
30738 msgstr ""
30739
30740 # type: verbatim
30741 #. type: verbatim
30742 #: ../fuse/guestmount.pod:49
30743 #, no-wrap
30744 msgid ""
30745 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
30746 "\n"
30747 msgstr ""
30748
30749 # type: textblock
30750 #. type: textblock
30751 #: ../fuse/guestmount.pod:51
30752 msgid "To get libguestfs to detect guest mountpoints for you:"
30753 msgstr ""
30754
30755 # type: verbatim
30756 #. type: verbatim
30757 #: ../fuse/guestmount.pod:53
30758 #, no-wrap
30759 msgid ""
30760 " guestmount -a guest.img -i --ro /mnt\n"
30761 "\n"
30762 msgstr ""
30763
30764 # type: textblock
30765 #. type: textblock
30766 #: ../fuse/guestmount.pod:55
30767 msgid "For a libvirt guest called \"Guest\" you could do:"
30768 msgstr ""
30769
30770 # type: verbatim
30771 #. type: verbatim
30772 #: ../fuse/guestmount.pod:57
30773 #, no-wrap
30774 msgid ""
30775 " guestmount -d Guest -i --ro /mnt\n"
30776 "\n"
30777 msgstr ""
30778
30779 # type: textblock
30780 #. type: textblock
30781 #: ../fuse/guestmount.pod:59
30782 msgid ""
30783 "If you don't know what filesystems are contained in a guest or disk image, "
30784 "use L<virt-filesystems(1)> first:"
30785 msgstr ""
30786
30787 # type: verbatim
30788 #. type: verbatim
30789 #: ../fuse/guestmount.pod:62
30790 #, no-wrap
30791 msgid ""
30792 " virt-filesystems MyGuest\n"
30793 "\n"
30794 msgstr ""
30795
30796 # type: textblock
30797 #. type: textblock
30798 #: ../fuse/guestmount.pod:64
30799 msgid ""
30800 "If you want to trace the libguestfs calls but without excessive debugging "
30801 "information, we recommend:"
30802 msgstr ""
30803
30804 # type: verbatim
30805 #. type: verbatim
30806 #: ../fuse/guestmount.pod:67
30807 #, no-wrap
30808 msgid ""
30809 " guestmount [...] --trace /mnt\n"
30810 "\n"
30811 msgstr ""
30812
30813 # type: textblock
30814 #. type: textblock
30815 #: ../fuse/guestmount.pod:69
30816 msgid "If you want to debug the program, we recommend:"
30817 msgstr ""
30818
30819 # type: verbatim
30820 #. type: verbatim
30821 #: ../fuse/guestmount.pod:71
30822 #, no-wrap
30823 msgid ""
30824 " guestmount [...] --trace --verbose /mnt\n"
30825 "\n"
30826 msgstr ""
30827
30828 # type: =item
30829 #. type: =item
30830 #: ../fuse/guestmount.pod:77
30831 msgid "B<-a image> | B<--add image>"
30832 msgstr ""
30833
30834 # type: textblock
30835 #. type: textblock
30836 #: ../fuse/guestmount.pod:79
30837 msgid "Add a block device or virtual machine image."
30838 msgstr ""
30839
30840 # type: =item
30841 #. type: =item
30842 #: ../fuse/guestmount.pod:84
30843 msgid "B<-c URI> | B<--connect URI>"
30844 msgstr ""
30845
30846 # type: =item
30847 #. type: =item
30848 #: ../fuse/guestmount.pod:90
30849 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
30850 msgstr ""
30851
30852 # type: =item
30853 #. type: =item
30854 #: ../fuse/guestmount.pod:96
30855 msgid "B<--dir-cache-timeout N>"
30856 msgstr ""
30857
30858 # type: textblock
30859 #. type: textblock
30860 #: ../fuse/guestmount.pod:98
30861 msgid ""
30862 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
30863 "seconds.  The readdir cache [actually, there are several semi-independent "
30864 "caches] is populated after a readdir(2) call with the stat and extended "
30865 "attributes of the files in the directory, in anticipation that they will be "
30866 "requested soon after."
30867 msgstr ""
30868
30869 # type: textblock
30870 #. type: textblock
30871 #: ../fuse/guestmount.pod:104
30872 msgid ""
30873 "There is also a different attribute cache implemented by FUSE (see the FUSE "
30874 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
30875 "requests, only cache existing ones."
30876 msgstr ""
30877
30878 # type: =item
30879 #. type: =item
30880 #: ../fuse/guestmount.pod:115
30881 msgid "B<--format=raw|qcow2|..> | B<--format>"
30882 msgstr ""
30883
30884 # type: textblock
30885 #. type: textblock
30886 #: ../fuse/guestmount.pod:122
30887 msgid ""
30888 "If you have untrusted raw-format guest disk images, you should use this "
30889 "option to specify the disk format.  This avoids a possible security problem "
30890 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
30891 "guestfs_add_drive_opts>."
30892 msgstr ""
30893
30894 # type: =item
30895 #. type: =item
30896 #: ../fuse/guestmount.pod:127
30897 msgid "B<--fuse-help>"
30898 msgstr ""
30899
30900 # type: textblock
30901 #. type: textblock
30902 #: ../fuse/guestmount.pod:129
30903 msgid "Display help on special FUSE options (see I<-o> below)."
30904 msgstr ""
30905
30906 # type: textblock
30907 #. type: textblock
30908 #: ../fuse/guestmount.pod:133
30909 msgid "Display brief help and exit."
30910 msgstr ""
30911
30912 # type: =item
30913 #. type: =item
30914 #: ../fuse/guestmount.pod:135
30915 msgid "B<-i> | B<--inspector>"
30916 msgstr ""
30917
30918 # type: =item
30919 #. type: =item
30920 #: ../fuse/guestmount.pod:146
30921 msgid "B<-m dev[:mnt]> | B<--mount dev[:mnt]>"
30922 msgstr ""
30923
30924 # type: textblock
30925 #. type: textblock
30926 #: ../fuse/guestmount.pod:148
30927 msgid ""
30928 "Mount the named partition or logical volume on the given mountpoint B<in the "
30929 "guest> (this has nothing to do with mountpoints in the host)."
30930 msgstr ""
30931
30932 # type: textblock
30933 #. type: textblock
30934 #: ../fuse/guestmount.pod:151
30935 msgid ""
30936 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
30937 "something on C</>."
30938 msgstr ""
30939
30940 # type: =item
30941 #. type: =item
30942 #: ../fuse/guestmount.pod:154
30943 msgid "B<-n> | B<--no-sync>"
30944 msgstr ""
30945
30946 # type: textblock
30947 #. type: textblock
30948 #: ../fuse/guestmount.pod:156
30949 msgid ""
30950 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
30951 "unmounted.  If you specify this option, then we don't attempt to sync the "
30952 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
30953 msgstr ""
30954
30955 # type: =item
30956 #. type: =item
30957 #: ../fuse/guestmount.pod:161
30958 msgid "B<-o option> | B<--option option>"
30959 msgstr ""
30960
30961 # type: textblock
30962 #. type: textblock
30963 #: ../fuse/guestmount.pod:163
30964 msgid "Pass extra options to FUSE."
30965 msgstr ""
30966
30967 # type: textblock
30968 #. type: textblock
30969 #: ../fuse/guestmount.pod:165
30970 msgid ""
30971 "To get a list of all the extra options supported by FUSE, use the command "
30972 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
30973 "of them are a good idea."
30974 msgstr ""
30975
30976 # type: verbatim
30977 #. type: verbatim
30978 #: ../fuse/guestmount.pod:169
30979 #, no-wrap
30980 msgid ""
30981 " guestmount --fuse-help\n"
30982 "\n"
30983 msgstr ""
30984
30985 # type: textblock
30986 #. type: textblock
30987 #: ../fuse/guestmount.pod:171
30988 msgid "Some potentially useful FUSE options:"
30989 msgstr ""
30990
30991 # type: =item
30992 #. type: =item
30993 #: ../fuse/guestmount.pod:175
30994 msgid "B<-o allow_other>"
30995 msgstr ""
30996
30997 # type: textblock
30998 #. type: textblock
30999 #: ../fuse/guestmount.pod:177
31000 msgid "Allow other users to see the filesystem."
31001 msgstr ""
31002
31003 # type: =item
31004 #. type: =item
31005 #: ../fuse/guestmount.pod:179
31006 msgid "B<-o attr_timeout=N>"
31007 msgstr ""
31008
31009 # type: textblock
31010 #. type: textblock
31011 #: ../fuse/guestmount.pod:181
31012 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
31013 msgstr ""
31014
31015 # type: =item
31016 #. type: =item
31017 #: ../fuse/guestmount.pod:183
31018 msgid "B<-o kernel_cache>"
31019 msgstr ""
31020
31021 # type: textblock
31022 #. type: textblock
31023 #: ../fuse/guestmount.pod:185
31024 msgid ""
31025 "Allow the kernel to cache files (reduces the number of reads that have to go "
31026 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
31027 "afford the extra memory usage."
31028 msgstr ""
31029
31030 # type: =item
31031 #. type: =item
31032 #: ../fuse/guestmount.pod:189
31033 msgid "B<-o uid=N> B<-o gid=N>"
31034 msgstr ""
31035
31036 # type: textblock
31037 #. type: textblock
31038 #: ../fuse/guestmount.pod:191
31039 msgid ""
31040 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
31041 "the chosen values."
31042 msgstr ""
31043
31044 # type: =item
31045 #. type: =item
31046 #: ../fuse/guestmount.pod:196
31047 msgid "B<-r> | B<--ro>"
31048 msgstr ""
31049
31050 # type: textblock
31051 #. type: textblock
31052 #: ../fuse/guestmount.pod:198
31053 msgid ""
31054 "Add devices and mount everything read-only.  Also disallow writes and make "
31055 "the disk appear read-only to FUSE."
31056 msgstr ""
31057
31058 # type: textblock
31059 #. type: textblock
31060 #: ../fuse/guestmount.pod:201
31061 msgid ""
31062 "This is highly recommended if you are not going to edit the guest disk.  If "
31063 "the guest is running and this option is I<not> supplied, then there is a "
31064 "strong risk of disk corruption in the guest.  We try to prevent this from "
31065 "happening, but it is not always possible."
31066 msgstr ""
31067
31068 # type: textblock
31069 #. type: textblock
31070 #: ../fuse/guestmount.pod:206
31071 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
31072 msgstr ""
31073
31074 # type: textblock
31075 #. type: textblock
31076 #: ../fuse/guestmount.pod:210
31077 msgid "Enable SELinux support for the guest."
31078 msgstr ""
31079
31080 # type: =item
31081 #. type: =item
31082 #: ../fuse/guestmount.pod:212
31083 msgid "B<-v> | B<--verbose>"
31084 msgstr ""
31085
31086 # type: textblock
31087 #. type: textblock
31088 #: ../fuse/guestmount.pod:214
31089 msgid "Enable verbose messages from underlying libguestfs."
31090 msgstr ""
31091
31092 # type: =item
31093 #. type: =item
31094 #: ../fuse/guestmount.pod:216
31095 msgid "B<-V> | B<--version>"
31096 msgstr ""
31097
31098 # type: textblock
31099 #. type: textblock
31100 #: ../fuse/guestmount.pod:218
31101 msgid "Display the program version and exit."
31102 msgstr ""
31103
31104 # type: =item
31105 #. type: =item
31106 #: ../fuse/guestmount.pod:220
31107 msgid "B<-w> | B<--rw>"
31108 msgstr ""
31109
31110 # type: textblock
31111 #. type: textblock
31112 #: ../fuse/guestmount.pod:222
31113 msgid ""
31114 "This option does nothing at the moment.  See L<guestfish(1)/OPENING DISKS "
31115 "FOR READ AND WRITE>."
31116 msgstr ""
31117
31118 # type: =item
31119 #. type: =item
31120 #: ../fuse/guestmount.pod:225
31121 msgid "B<-x> | B<--trace>"
31122 msgstr ""
31123
31124 # type: textblock
31125 #. type: textblock
31126 #: ../fuse/guestmount.pod:227
31127 msgid "Trace libguestfs calls and entry into each FUSE function."
31128 msgstr ""
31129
31130 # type: textblock
31131 #. type: textblock
31132 #: ../fuse/guestmount.pod:229
31133 msgid "This also stops the daemon from forking into the background."
31134 msgstr ""
31135
31136 # type: textblock
31137 #. type: textblock
31138 #: ../fuse/guestmount.pod:235
31139 msgid ""
31140 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
31141 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
31142 "net/>."
31143 msgstr ""
31144
31145 #. type: textblock
31146 #: ../tools/virt-edit.pl:34
31147 msgid "virt-edit - Edit a file in a virtual machine"
31148 msgstr ""
31149
31150 #. type: verbatim
31151 #: ../tools/virt-edit.pl:38
31152 #, no-wrap
31153 msgid ""
31154 " virt-edit [--options] domname file\n"
31155 "\n"
31156 msgstr ""
31157
31158 #. type: verbatim
31159 #: ../tools/virt-edit.pl:40
31160 #, no-wrap
31161 msgid ""
31162 " virt-edit [--options] disk.img [disk.img ...] file\n"
31163 "\n"
31164 msgstr ""
31165
31166 #. type: verbatim
31167 #: ../tools/virt-edit.pl:42
31168 #, no-wrap
31169 msgid ""
31170 " virt-edit [domname|disk.img] file -e 'expr'\n"
31171 "\n"
31172 msgstr ""
31173
31174 #. type: textblock
31175 #: ../tools/virt-edit.pl:46
31176 msgid ""
31177 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
31178 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
31179 "doing this, but doesn't catch all cases."
31180 msgstr ""
31181
31182 #. type: textblock
31183 #: ../tools/virt-edit.pl:52
31184 msgid ""
31185 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
31186 "the named virtual machine (or disk image)."
31187 msgstr ""
31188
31189 #. type: textblock
31190 #: ../tools/virt-edit.pl:55
31191 msgid "If you want to just view a file, use L<virt-cat(1)>."
31192 msgstr ""
31193
31194 #. type: textblock
31195 #: ../tools/virt-edit.pl:57
31196 msgid ""
31197 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
31198 "USING GUESTFISH> below)."
31199 msgstr ""
31200
31201 #. type: textblock
31202 #: ../tools/virt-edit.pl:60
31203 msgid ""
31204 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
31205 "files.  L<guestfish(1)> can do that and much more."
31206 msgstr ""
31207
31208 #. type: textblock
31209 #: ../tools/virt-edit.pl:65
31210 msgid "Edit the named files interactively:"
31211 msgstr ""
31212
31213 #. type: verbatim
31214 #: ../tools/virt-edit.pl:67
31215 #, no-wrap
31216 msgid ""
31217 " virt-edit mydomain /boot/grub/grub.conf\n"
31218 "\n"
31219 msgstr ""
31220
31221 #. type: verbatim
31222 #: ../tools/virt-edit.pl:69
31223 #, no-wrap
31224 msgid ""
31225 " virt-edit mydomain /etc/passwd\n"
31226 "\n"
31227 msgstr ""
31228
31229 #. type: textblock
31230 #: ../tools/virt-edit.pl:71
31231 msgid ""
31232 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
31233 "below).  To change the init default level to 5:"
31234 msgstr ""
31235
31236 #. type: verbatim
31237 #: ../tools/virt-edit.pl:75
31238 #, no-wrap
31239 msgid ""
31240 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
31241 "\n"
31242 msgstr ""
31243
31244 #. type: textblock
31245 #: ../tools/virt-edit.pl:87 ../tools/virt-win-reg.pl:106
31246 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:108
31247 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
31248 msgid "Display brief help."
31249 msgstr ""
31250
31251 #. type: textblock
31252 #: ../tools/virt-edit.pl:95 ../tools/virt-win-reg.pl:114
31253 #: ../tools/virt-resize.pl:272 ../tools/virt-list-filesystems.pl:71
31254 #: ../tools/virt-tar.pl:116 ../tools/virt-make-fs.pl:171
31255 #: ../tools/virt-list-partitions.pl:72
31256 msgid "Display version number and exit."
31257 msgstr ""
31258
31259 #. type: =item
31260 #: ../tools/virt-edit.pl:101
31261 msgid "B<--backup extension> | B<-b extension>"
31262 msgstr ""
31263
31264 #. type: textblock
31265 #: ../tools/virt-edit.pl:103
31266 msgid ""
31267 "Create a backup of the original file I<in the guest disk image>.  The backup "
31268 "has the original filename with C<extension> added."
31269 msgstr ""
31270
31271 #. type: textblock
31272 #: ../tools/virt-edit.pl:106
31273 msgid ""
31274 "Usually the first character of C<extension> would be a dot C<.> so you would "
31275 "write:"
31276 msgstr ""
31277
31278 #. type: verbatim
31279 #: ../tools/virt-edit.pl:109
31280 #, no-wrap
31281 msgid ""
31282 " virt-edit -b .orig [etc]\n"
31283 "\n"
31284 msgstr ""
31285
31286 #. type: textblock
31287 #: ../tools/virt-edit.pl:111
31288 msgid "By default, no backup file is made."
31289 msgstr ""
31290
31291 #. type: =item
31292 #: ../tools/virt-edit.pl:117 ../tools/virt-win-reg.pl:128
31293 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:122
31294 #: ../tools/virt-list-partitions.pl:78
31295 msgid "B<--connect URI> | B<-c URI>"
31296 msgstr ""
31297
31298 #. type: textblock
31299 #: ../tools/virt-edit.pl:119 ../tools/virt-win-reg.pl:130
31300 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:124
31301 #: ../tools/virt-list-partitions.pl:80
31302 msgid ""
31303 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
31304 "to the default libvirt hypervisor."
31305 msgstr ""
31306
31307 #. type: textblock
31308 #: ../tools/virt-edit.pl:122 ../tools/virt-win-reg.pl:133
31309 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:127
31310 #: ../tools/virt-list-partitions.pl:83
31311 msgid ""
31312 "If you specify guest block devices directly, then libvirt is not used at all."
31313 msgstr ""
31314
31315 #. type: =item
31316 #: ../tools/virt-edit.pl:129 ../tools/virt-win-reg.pl:140
31317 #: ../tools/virt-resize.pl:520 ../tools/virt-list-filesystems.pl:89
31318 #: ../tools/virt-tar.pl:134 ../tools/virt-list-partitions.pl:90
31319 msgid "B<--format> raw"
31320 msgstr ""
31321
31322 #. type: textblock
31323 #: ../tools/virt-edit.pl:131 ../tools/virt-win-reg.pl:142
31324 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:136
31325 #: ../tools/virt-list-partitions.pl:92
31326 msgid ""
31327 "Specify the format of disk images given on the command line.  If this is "
31328 "omitted then the format is autodetected from the content of the disk image."
31329 msgstr ""
31330
31331 #. type: textblock
31332 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:146
31333 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:140
31334 #: ../tools/virt-list-partitions.pl:96
31335 msgid ""
31336 "If disk images are requested from libvirt, then this program asks libvirt "
31337 "for this information.  In this case, the value of the format parameter is "
31338 "ignored."
31339 msgstr ""
31340
31341 #. type: textblock
31342 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:150
31343 #: ../tools/virt-resize.pl:525 ../tools/virt-resize.pl:540
31344 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:144
31345 #: ../tools/virt-list-partitions.pl:100
31346 msgid ""
31347 "If working with untrusted raw-format guest disk images, you should ensure "
31348 "the format is always specified."
31349 msgstr ""
31350
31351 #. type: =item
31352 #: ../tools/virt-edit.pl:146
31353 msgid "B<--expr EXPR> | B<-e EXPR>"
31354 msgstr ""
31355
31356 #. type: textblock
31357 #: ../tools/virt-edit.pl:148
31358 msgid ""
31359 "Instead of launching the external editor, non-interactively apply the Perl "
31360 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
31361 "EDITING> below."
31362 msgstr ""
31363
31364 #. type: textblock
31365 #: ../tools/virt-edit.pl:152
31366 msgid ""
31367 "Be careful to properly quote the expression to prevent it from being altered "
31368 "by the shell."
31369 msgstr ""
31370
31371 #. type: =head1
31372 #: ../tools/virt-edit.pl:272
31373 msgid "NON-INTERACTIVE EDITING"
31374 msgstr ""
31375
31376 #. type: textblock
31377 #: ../tools/virt-edit.pl:274
31378 msgid ""
31379 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
31380 "administrator can interactively edit the file."
31381 msgstr ""
31382
31383 #. type: textblock
31384 #: ../tools/virt-edit.pl:277
31385 msgid ""
31386 "There are two ways also to use C<virt-edit> from scripts in order to make "
31387 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
31388 "like this, it's less error-prone to write scripts directly using the "
31389 "libguestfs API and Augeas for configuration file editing.)"
31390 msgstr ""
31391
31392 #. type: textblock
31393 #: ../tools/virt-edit.pl:283
31394 msgid ""
31395 "The first method is to temporarily set C<$EDITOR> to any script or program "
31396 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
31397 "update C<tmpfile> in place however it likes."
31398 msgstr ""
31399
31400 #. type: textblock
31401 #: ../tools/virt-edit.pl:287
31402 msgid ""
31403 "The second method is to use the C<-e> parameter of C<virt-edit> to run a "
31404 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
31405 "instances of C<foo> with C<bar> in a file:"
31406 msgstr ""
31407
31408 #. type: verbatim
31409 #: ../tools/virt-edit.pl:291
31410 #, no-wrap
31411 msgid ""
31412 " virt-edit domname filename -e 's/foo/bar/'\n"
31413 "\n"
31414 msgstr ""
31415
31416 #. type: textblock
31417 #: ../tools/virt-edit.pl:293
31418 msgid ""
31419 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
31420 "For example to delete root's password you could do:"
31421 msgstr ""
31422
31423 #. type: verbatim
31424 #: ../tools/virt-edit.pl:296
31425 #, no-wrap
31426 msgid ""
31427 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
31428 "\n"
31429 msgstr ""
31430
31431 #. type: textblock
31432 #: ../tools/virt-edit.pl:298
31433 msgid ""
31434 "What really happens is that the snippet is evaluated as a Perl expression "
31435 "for each line of the file.  The line, including the final C<\\n>, is passed "
31436 "in C<$_> and the expression should update C<$_> or leave it unchanged."
31437 msgstr ""
31438
31439 #. type: textblock
31440 #: ../tools/virt-edit.pl:303
31441 msgid ""
31442 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
31443 "C<apache> user account from the password file you can do:"
31444 msgstr ""
31445
31446 #. type: verbatim
31447 #: ../tools/virt-edit.pl:306
31448 #, no-wrap
31449 msgid ""
31450 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
31451 "\n"
31452 msgstr ""
31453
31454 #. type: textblock
31455 #: ../tools/virt-edit.pl:308
31456 msgid ""
31457 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
31458 "the end of the file is rather difficult this way since there is no concept "
31459 "of \"last line of the file\" - your expression just doesn't get called "
31460 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
31461 "want to do this."
31462 msgstr ""
31463
31464 #. type: textblock
31465 #: ../tools/virt-edit.pl:314
31466 msgid ""
31467 "The variable C<$lineno> contains the current line number.  As is "
31468 "traditional, the first line in the file is number C<1>."
31469 msgstr ""
31470
31471 #. type: textblock
31472 #: ../tools/virt-edit.pl:317
31473 msgid ""
31474 "The return value from the expression is ignored, but the expression may call "
31475 "C<die> in order to abort the whole program, leaving the original file "
31476 "untouched."
31477 msgstr ""
31478
31479 #. type: textblock
31480 #: ../tools/virt-edit.pl:321
31481 msgid ""
31482 "Remember when matching the end of a line that C<$_> may contain the final C<"
31483 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
31484 "newline then neither of these.  Thus to match or substitute some text at the "
31485 "end of a line, use this regular expression:"
31486 msgstr ""
31487
31488 #. type: verbatim
31489 #: ../tools/virt-edit.pl:326
31490 #, no-wrap
31491 msgid ""
31492 " /some text(\\r?\\n)?$/\n"
31493 "\n"
31494 msgstr ""
31495
31496 #. type: textblock
31497 #: ../tools/virt-edit.pl:328
31498 msgid ""
31499 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
31500 "$_> itself (since that would remove all newlines from the file):"
31501 msgstr ""
31502
31503 #. type: verbatim
31504 #: ../tools/virt-edit.pl:332
31505 #, no-wrap
31506 msgid ""
31507 " my $m = $_; chomp $m; $m =~ /some text$/\n"
31508 "\n"
31509 msgstr ""
31510
31511 #. type: =head1
31512 #: ../tools/virt-edit.pl:334
31513 msgid "USING GUESTFISH"
31514 msgstr ""
31515
31516 #. type: textblock
31517 #: ../tools/virt-edit.pl:336
31518 msgid ""
31519 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
31520 "C<virt-edit> doesn't work."
31521 msgstr ""
31522
31523 #. type: textblock
31524 #: ../tools/virt-edit.pl:339
31525 msgid "Using C<virt-edit> is approximately equivalent to doing:"
31526 msgstr ""
31527
31528 #. type: verbatim
31529 #: ../tools/virt-edit.pl:341
31530 #, no-wrap
31531 msgid ""
31532 " guestfish --rw -i -d domname edit /file\n"
31533 "\n"
31534 msgstr ""
31535
31536 #. type: textblock
31537 #: ../tools/virt-edit.pl:343
31538 msgid ""
31539 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
31540 "path to the file."
31541 msgstr ""
31542
31543 #. type: textblock
31544 #: ../tools/virt-edit.pl:346
31545 msgid ""
31546 "The command above uses libguestfs's guest inspection feature and so does not "
31547 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
31548 "disk images that don't contain guests.  To edit a file on a disk image "
31549 "directly, use:"
31550 msgstr ""
31551
31552 #. type: verbatim
31553 #: ../tools/virt-edit.pl:351
31554 #, no-wrap
31555 msgid ""
31556 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
31557 "\n"
31558 msgstr ""
31559
31560 #. type: textblock
31561 #: ../tools/virt-edit.pl:353
31562 msgid ""
31563 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
31564 "the disk image to edit, and C</file> is the full path to the file."
31565 msgstr ""
31566
31567 #. type: textblock
31568 #: ../tools/virt-edit.pl:357
31569 msgid ""
31570 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
31571 "C<write> or C<upload> instead:"
31572 msgstr ""
31573
31574 #. type: verbatim
31575 #: ../tools/virt-edit.pl:360
31576 #, no-wrap
31577 msgid ""
31578 " guestfish --rw -i -d domname touch /newfile\n"
31579 "\n"
31580 msgstr ""
31581
31582 #. type: verbatim
31583 #: ../tools/virt-edit.pl:362
31584 #, no-wrap
31585 msgid ""
31586 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
31587 "\n"
31588 msgstr ""
31589
31590 #. type: verbatim
31591 #: ../tools/virt-edit.pl:364
31592 #, no-wrap
31593 msgid ""
31594 " guestfish --rw -i -d domname upload localfile /newfile\n"
31595 "\n"
31596 msgstr ""
31597
31598 #. type: textblock
31599 #: ../tools/virt-edit.pl:366
31600 msgid ""
31601 "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
31602 msgstr ""
31603
31604 #. type: verbatim
31605 #: ../tools/virt-edit.pl:369
31606 #, no-wrap
31607 msgid ""
31608 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
31609 "\n"
31610 msgstr ""
31611
31612 #. type: =item
31613 #: ../tools/virt-edit.pl:379
31614 msgid "C<EDITOR>"
31615 msgstr ""
31616
31617 #. type: textblock
31618 #: ../tools/virt-edit.pl:381
31619 msgid ""
31620 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
31621 "\"emacs -nw\">"
31622 msgstr ""
31623
31624 #. type: textblock
31625 #: ../tools/virt-edit.pl:384
31626 msgid "If not set, C<vi> is used."
31627 msgstr ""
31628
31629 #. type: =head1
31630 #: ../tools/virt-edit.pl:388 ../tools/virt-win-reg.pl:559
31631 #: ../tools/virt-resize.pl:1476 ../tools/virt-list-filesystems.pl:182
31632 #: ../tools/virt-tar.pl:274 ../tools/virt-make-fs.pl:532
31633 #: ../tools/virt-list-partitions.pl:250
31634 msgid "SHELL QUOTING"
31635 msgstr ""
31636
31637 #. type: textblock
31638 #: ../tools/virt-edit.pl:390 ../tools/virt-win-reg.pl:567
31639 #: ../tools/virt-resize.pl:1478 ../tools/virt-list-filesystems.pl:184
31640 #: ../tools/virt-tar.pl:276 ../tools/virt-make-fs.pl:534
31641 #: ../tools/virt-list-partitions.pl:252
31642 msgid ""
31643 "Libvirt guest names can contain arbitrary characters, some of which have "
31644 "meaning to the shell such as C<#> and space.  You may need to quote or "
31645 "escape these characters on the command line.  See the shell manual page L<sh"
31646 "(1)> for details."
31647 msgstr ""
31648
31649 #. type: textblock
31650 #: ../tools/virt-edit.pl:397
31651 msgid ""
31652 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::"
31653 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>, L<perl(1)>, "
31654 "L<perlre(1)>."
31655 msgstr ""
31656
31657 #. type: =head1
31658 #: ../tools/virt-edit.pl:407 ../tools/virt-win-reg.pl:598
31659 #: ../tools/virt-resize.pl:1504 ../tools/virt-list-filesystems.pl:202
31660 #: ../tools/virt-tar.pl:292 ../tools/virt-make-fs.pl:564
31661 #: ../tools/virt-list-partitions.pl:269
31662 msgid "AUTHOR"
31663 msgstr ""
31664
31665 #. type: textblock
31666 #: ../tools/virt-edit.pl:409 ../tools/virt-win-reg.pl:600
31667 #: ../tools/virt-resize.pl:1506 ../tools/virt-list-filesystems.pl:204
31668 #: ../tools/virt-tar.pl:294 ../tools/virt-make-fs.pl:566
31669 #: ../tools/virt-list-partitions.pl:271
31670 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
31671 msgstr ""
31672
31673 #. type: textblock
31674 #: ../tools/virt-edit.pl:413
31675 msgid "Copyright (C) 2009-2011 Red Hat Inc."
31676 msgstr ""
31677
31678 #. type: textblock
31679 #: ../tools/virt-win-reg.pl:37
31680 msgid ""
31681 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
31682 msgstr ""
31683
31684 #. type: verbatim
31685 #: ../tools/virt-win-reg.pl:41
31686 #, no-wrap
31687 msgid ""
31688 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
31689 "\n"
31690 msgstr ""
31691
31692 #. type: verbatim
31693 #: ../tools/virt-win-reg.pl:43
31694 #, no-wrap
31695 msgid ""
31696 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
31697 "\n"
31698 msgstr ""
31699
31700 #. type: verbatim
31701 #: ../tools/virt-win-reg.pl:45
31702 #, no-wrap
31703 msgid ""
31704 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
31705 "\n"
31706 msgstr ""
31707
31708 #. type: verbatim
31709 #: ../tools/virt-win-reg.pl:47
31710 #, no-wrap
31711 msgid ""
31712 " virt-win-reg --merge domname [input.reg ...]\n"
31713 "\n"
31714 msgstr ""
31715
31716 #. type: verbatim
31717 #: ../tools/virt-win-reg.pl:49
31718 #, no-wrap
31719 msgid ""
31720 " virt-win-reg [--options] disk.img ... # instead of domname\n"
31721 "\n"
31722 msgstr ""
31723
31724 #. type: textblock
31725 #: ../tools/virt-win-reg.pl:53
31726 msgid ""
31727 "You must I<not> use C<virt-win-reg> with the C<--merge> option on live "
31728 "virtual machines.  If you do this, you I<will> get irreversible disk "
31729 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
31730 "but doesn't catch all cases."
31731 msgstr ""
31732
31733 #. type: textblock
31734 #: ../tools/virt-win-reg.pl:58
31735 msgid ""
31736 "Modifying the Windows Registry is an inherently risky operation.  The format "
31737 "is deliberately obscure and undocumented, and Registry changes can leave the "
31738 "system unbootable.  Therefore when using the C<--merge> option, make sure "
31739 "you have a reliable backup first."
31740 msgstr ""
31741
31742 #. type: textblock
31743 #: ../tools/virt-win-reg.pl:65
31744 msgid ""
31745 "This program can export and merge Windows Registry entries from a Windows "
31746 "guest."
31747 msgstr ""
31748
31749 #. type: textblock
31750 #: ../tools/virt-win-reg.pl:68
31751 msgid ""
31752 "The first parameter is the libvirt guest name or the raw disk image of a "
31753 "Windows guest."
31754 msgstr ""
31755
31756 #. type: textblock
31757 #: ../tools/virt-win-reg.pl:71
31758 msgid ""
31759 "If C<--merge> is I<not> specified, then the chosen registry key is displayed/"
31760 "exported (recursively).  For example:"
31761 msgstr ""
31762
31763 #. type: verbatim
31764 #: ../tools/virt-win-reg.pl:74
31765 #, no-wrap
31766 msgid ""
31767 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
31768 "\n"
31769 msgstr ""
31770
31771 #. type: textblock
31772 #: ../tools/virt-win-reg.pl:76
31773 msgid ""
31774 "You can also display single values from within registry keys, for example:"
31775 msgstr ""
31776
31777 #. type: verbatim
31778 #: ../tools/virt-win-reg.pl:79
31779 #, no-wrap
31780 msgid ""
31781 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
31782 " $ virt-win-reg Windows7 $cvkey ProductName\n"
31783 " Windows 7 Enterprise\n"
31784 "\n"
31785 msgstr ""
31786
31787 #. type: textblock
31788 #: ../tools/virt-win-reg.pl:83
31789 msgid ""
31790 "With C<--merge>, you can merge a textual regedit file into the Windows "
31791 "Registry:"
31792 msgstr ""
31793
31794 #. type: verbatim
31795 #: ../tools/virt-win-reg.pl:86
31796 #, no-wrap
31797 msgid ""
31798 " $ virt-win-reg --merge Windows7 changes.reg\n"
31799 "\n"
31800 msgstr ""
31801
31802 #. type: =head2
31803 #: ../tools/virt-win-reg.pl:88
31804 msgid "NOTE"
31805 msgstr ""
31806
31807 #. type: textblock
31808 #: ../tools/virt-win-reg.pl:90
31809 msgid ""
31810 "This program is only meant for simple access to the registry.  If you want "
31811 "to do complicated things with the registry, we suggest you download the "
31812 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
31813 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
31814 "L<hivexregedit(1)>."
31815 msgstr ""
31816
31817 #. type: =item
31818 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
31819 msgid "B<--debug>"
31820 msgstr ""
31821
31822 #. type: textblock
31823 #: ../tools/virt-win-reg.pl:122 ../tools/virt-resize.pl:498
31824 msgid "Enable debugging messages."
31825 msgstr ""
31826
31827 #. type: =item
31828 #: ../tools/virt-win-reg.pl:157
31829 msgid "B<--merge>"
31830 msgstr ""
31831
31832 #. type: textblock
31833 #: ../tools/virt-win-reg.pl:159
31834 msgid ""
31835 "In merge mode, this merges a textual regedit file into the Windows Registry "
31836 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
31837 "displays or exports Registry entries instead."
31838 msgstr ""
31839
31840 #. type: textblock
31841 #: ../tools/virt-win-reg.pl:163
31842 msgid ""
31843 "Note that C<--merge> is I<unsafe> to use on live virtual machines, and will "
31844 "result in disk corruption.  However exporting (without this flag)  is always "
31845 "safe."
31846 msgstr ""
31847
31848 #. type: =item
31849 #: ../tools/virt-win-reg.pl:171
31850 msgid "B<--encoding> UTF-16LE|ASCII"
31851 msgstr ""
31852
31853 #. type: textblock
31854 #: ../tools/virt-win-reg.pl:173
31855 msgid ""
31856 "When merging (only), you may need to specify the encoding for strings to be "
31857 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
31858 "(3)/ENCODING STRINGS>."
31859 msgstr ""
31860
31861 #. type: textblock
31862 #: ../tools/virt-win-reg.pl:177
31863 msgid ""
31864 "The default is to use UTF-16LE, which should work with recent versions of "
31865 "Windows."
31866 msgstr ""
31867
31868 #. type: =head1
31869 #: ../tools/virt-win-reg.pl:402
31870 msgid "SUPPORTED SYSTEMS"
31871 msgstr ""
31872
31873 #. type: textblock
31874 #: ../tools/virt-win-reg.pl:404
31875 msgid ""
31876 "The program currently supports Windows NT-derived guests starting with "
31877 "Windows XP through to at least Windows 7."
31878 msgstr ""
31879
31880 #. type: textblock
31881 #: ../tools/virt-win-reg.pl:407
31882 msgid ""
31883 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
31884 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
31885 "and C<HKEY_USERS\\.DEFAULT>."
31886 msgstr ""
31887
31888 #. type: textblock
31889 #: ../tools/virt-win-reg.pl:411
31890 msgid ""
31891 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
31892 "C<HKEY_USERS>."
31893 msgstr ""
31894
31895 #. type: textblock
31896 #: ../tools/virt-win-reg.pl:414
31897 msgid ""
31898 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
31899 "time."
31900 msgstr ""
31901
31902 #. type: =head1
31903 #: ../tools/virt-win-reg.pl:417
31904 msgid "ENCODING"
31905 msgstr ""
31906
31907 #. type: textblock
31908 #: ../tools/virt-win-reg.pl:419
31909 msgid ""
31910 "C<virt-win-reg> expects that regedit files have already been reencoded in "
31911 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
31912 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
31913 "Windows-style line endings, you may need to reencode the whole file before "
31914 "or after processing."
31915 msgstr ""
31916
31917 #. type: textblock
31918 #: ../tools/virt-win-reg.pl:425
31919 msgid ""
31920 "To reencode a file from Windows format to Linux (before processing it with "
31921 "the C<--merge> option), you would do something like this:"
31922 msgstr ""
31923
31924 #. type: verbatim
31925 #: ../tools/virt-win-reg.pl:428
31926 #, no-wrap
31927 msgid ""
31928 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
31929 "\n"
31930 msgstr ""
31931
31932 #. type: textblock
31933 #: ../tools/virt-win-reg.pl:430
31934 msgid ""
31935 "To go in the opposite direction, after exporting and before sending the file "
31936 "to a Windows user, do something like this:"
31937 msgstr ""
31938
31939 #. type: verbatim
31940 #: ../tools/virt-win-reg.pl:433
31941 #, no-wrap
31942 msgid ""
31943 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
31944 "\n"
31945 msgstr ""
31946
31947 #. type: textblock
31948 #: ../tools/virt-win-reg.pl:435
31949 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
31950 msgstr ""
31951
31952 #. type: textblock
31953 #: ../tools/virt-win-reg.pl:437
31954 msgid ""
31955 "If you are unsure about the current encoding, use the L<file(1)> command.  "
31956 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
31957 "style (CRLF) line endings, like this:"
31958 msgstr ""
31959
31960 #. type: verbatim
31961 #: ../tools/virt-win-reg.pl:441
31962 #, no-wrap
31963 msgid ""
31964 " $ file software.reg\n"
31965 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
31966 " with CRLF line terminators\n"
31967 "\n"
31968 msgstr ""
31969
31970 #. type: textblock
31971 #: ../tools/virt-win-reg.pl:445
31972 msgid "This file would need conversion before you could C<--merge> it."
31973 msgstr ""
31974
31975 #. type: =head1
31976 #: ../tools/virt-win-reg.pl:447
31977 msgid "CurrentControlSet etc."
31978 msgstr ""
31979
31980 #. type: textblock
31981 #: ../tools/virt-win-reg.pl:449
31982 msgid ""
31983 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
31984 "Registry at the level of the hive file, and therefore you cannot modify "
31985 "these."
31986 msgstr ""
31987
31988 #. type: textblock
31989 #: ../tools/virt-win-reg.pl:453
31990 msgid ""
31991 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
31992 "circumstances it might refer to another control set.  The way to find out is "
31993 "to look at the C<HKLM\\SYSTEM\\Select> key:"
31994 msgstr ""
31995
31996 #. type: verbatim
31997 #: ../tools/virt-win-reg.pl:457
31998 #, no-wrap
31999 msgid ""
32000 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
32001 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
32002 " \"Current\"=dword:00000001\n"
32003 " \"Default\"=dword:00000001\n"
32004 " \"Failed\"=dword:00000000\n"
32005 " \"LastKnownGood\"=dword:00000002\n"
32006 "\n"
32007 msgstr ""
32008
32009 #. type: textblock
32010 #: ../tools/virt-win-reg.pl:464
32011 msgid "\"Current\" is the one which Windows will choose when it boots."
32012 msgstr ""
32013
32014 #. type: textblock
32015 #: ../tools/virt-win-reg.pl:466
32016 msgid ""
32017 "Similarly, other C<Current...> keys in the path may need to be replaced."
32018 msgstr ""
32019
32020 #. type: =head1
32021 #: ../tools/virt-win-reg.pl:469
32022 msgid "WINDOWS TIPS"
32023 msgstr ""
32024
32025 #. type: textblock
32026 #: ../tools/virt-win-reg.pl:471
32027 msgid ""
32028 "Note that some of these tips modify the guest disk image.  The guest I<must> "
32029 "be shut off, else you will get disk corruption."
32030 msgstr ""
32031
32032 #. type: =head2
32033 #: ../tools/virt-win-reg.pl:474
32034 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
32035 msgstr ""
32036
32037 #. type: textblock
32038 #: ../tools/virt-win-reg.pl:476
32039 msgid ""
32040 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
32041 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
32042 "is uploaded into C<C:\\>:"
32043 msgstr ""
32044
32045 #. type: verbatim
32046 #: ../tools/virt-win-reg.pl:480
32047 #, no-wrap
32048 msgid ""
32049 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
32050 "\n"
32051 msgstr ""
32052
32053 #. type: textblock
32054 #: ../tools/virt-win-reg.pl:482
32055 msgid "Prepare a regedit file containing the registry change:"
32056 msgstr ""
32057
32058 #. type: verbatim
32059 #: ../tools/virt-win-reg.pl:484
32060 #, no-wrap
32061 msgid ""
32062 " cat > test.reg <<'EOF'\n"
32063 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
32064 " \"Test\"=\"c:\\\\test.bat\"\n"
32065 " EOF\n"
32066 "\n"
32067 msgstr ""
32068
32069 #. type: textblock
32070 #: ../tools/virt-win-reg.pl:489
32071 msgid ""
32072 "In this example we use the key C<RunOnce> which means that the script will "
32073 "run precisely once when the first user logs in.  If you want it to run every "
32074 "time a user logs in, replace C<RunOnce> with C<Run>."
32075 msgstr ""
32076
32077 #. type: textblock
32078 #: ../tools/virt-win-reg.pl:493
32079 msgid "Now update the registry:"
32080 msgstr ""
32081
32082 #. type: verbatim
32083 #: ../tools/virt-win-reg.pl:495
32084 #, no-wrap
32085 msgid ""
32086 " virt-win-reg --merge WindowsGuest test.reg\n"
32087 "\n"
32088 msgstr ""
32089
32090 #. type: =head2
32091 #: ../tools/virt-win-reg.pl:497
32092 msgid "INSTALLING A SERVICE"
32093 msgstr ""
32094
32095 #. type: textblock
32096 #: ../tools/virt-win-reg.pl:499
32097 msgid ""
32098 "This section assumes you are familiar with Windows services, and you either "
32099 "have a program which handles the Windows Service Control Protocol directly "
32100 "or you want to run any program using a service wrapper like SrvAny or the "
32101 "free RHSrvAny."
32102 msgstr ""
32103
32104 #. type: textblock
32105 #: ../tools/virt-win-reg.pl:504
32106 msgid ""
32107 "First upload the program and optionally the service wrapper.  In this case "
32108 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
32109 msgstr ""
32110
32111 #. type: verbatim
32112 #: ../tools/virt-win-reg.pl:508
32113 #, no-wrap
32114 msgid ""
32115 " guestfish -i -d WindowsGuest <<EOF\n"
32116 "   upload rhsrvany.exe /rhsrvany.exe\n"
32117 "   upload test.exe /test.exe\n"
32118 " EOF\n"
32119 "\n"
32120 msgstr ""
32121
32122 #. type: textblock
32123 #: ../tools/virt-win-reg.pl:513
32124 msgid ""
32125 "Prepare a regedit file containing the registry changes.  In this example, "
32126 "the first registry change is needed for the service itself or the service "
32127 "wrapper (if used).  The second registry change is only needed because I am "
32128 "using the RHSrvAny service wrapper."
32129 msgstr ""
32130
32131 #. type: verbatim
32132 #: ../tools/virt-win-reg.pl:518
32133 #, no-wrap
32134 msgid ""
32135 " cat > service.reg <<'EOF'\n"
32136 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
32137 " \"Type\"=dword:00000010\n"
32138 " \"Start\"=dword:00000002\n"
32139 " \"ErrorControl\"=dword:00000001\n"
32140 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
32141 " \"DisplayName\"=\"RHSrvAny\"\n"
32142 " \"ObjectName\"=\"NetworkService\"\n"
32143 " \n"
32144 msgstr ""
32145
32146 #. type: verbatim
32147 #: ../tools/virt-win-reg.pl:527
32148 #, no-wrap
32149 msgid ""
32150 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
32151 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
32152 " \"PWD\"=\"c:\\\\Temp\"\n"
32153 " EOF\n"
32154 "\n"
32155 msgstr ""
32156
32157 #. type: textblock
32158 #: ../tools/virt-win-reg.pl:538
32159 msgid ""
32160 "For use of C<ControlSet001> see the section above in this manual page.  You "
32161 "may need to adjust this according to the control set that is in use by the "
32162 "guest."
32163 msgstr ""
32164
32165 #. type: textblock
32166 #: ../tools/virt-win-reg.pl:544
32167 msgid ""
32168 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
32169 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
32170 "privileged account."
32171 msgstr ""
32172
32173 #. type: textblock
32174 #: ../tools/virt-win-reg.pl:550
32175 msgid ""
32176 "For the meaning of the magic numbers, see this Microsoft KB article: "
32177 "L<http://support.microsoft.com/kb/103000>."
32178 msgstr ""
32179
32180 #. type: textblock
32181 #: ../tools/virt-win-reg.pl:555
32182 msgid "Update the registry:"
32183 msgstr ""
32184
32185 #. type: verbatim
32186 #: ../tools/virt-win-reg.pl:557
32187 #, no-wrap
32188 msgid ""
32189 " virt-win-reg --merge WindowsGuest service.reg\n"
32190 "\n"
32191 msgstr ""
32192
32193 #. type: textblock
32194 #: ../tools/virt-win-reg.pl:561
32195 msgid ""
32196 "Be careful when passing parameters containing C<\\> (backslash) in the "
32197 "shell.  Usually you will have to use 'single quotes' or double backslashes "
32198 "(but not both) to protect them from the shell."
32199 msgstr ""
32200
32201 #. type: textblock
32202 #: ../tools/virt-win-reg.pl:565
32203 msgid "Paths and value names are case-insensitive."
32204 msgstr ""
32205
32206 #. type: textblock
32207 #: ../tools/virt-win-reg.pl:574
32208 msgid ""
32209 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
32210 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
32211 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
32212 msgstr ""
32213
32214 #. type: textblock
32215 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
32216 msgid ""
32217 "When reporting bugs, please enable debugging and capture the I<complete> "
32218 "output:"
32219 msgstr ""
32220
32221 #. type: verbatim
32222 #: ../tools/virt-win-reg.pl:592
32223 #, no-wrap
32224 msgid ""
32225 " export LIBGUESTFS_DEBUG=1\n"
32226 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
32227 "\n"
32228 msgstr ""
32229
32230 #. type: textblock
32231 #: ../tools/virt-win-reg.pl:595
32232 msgid ""
32233 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
32234 "redhat.com/>"
32235 msgstr ""
32236
32237 #. type: textblock
32238 #: ../tools/virt-win-reg.pl:604 ../tools/virt-resize.pl:1510
32239 #: ../tools/virt-make-fs.pl:570
32240 msgid "Copyright (C) 2010 Red Hat Inc."
32241 msgstr ""
32242
32243 #. type: textblock
32244 #: ../tools/virt-resize.pl:42
32245 msgid "virt-resize - Resize a virtual machine disk"
32246 msgstr ""
32247
32248 #. type: verbatim
32249 #: ../tools/virt-resize.pl:46
32250 #, no-wrap
32251 msgid ""
32252 " virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
32253 "   [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
32254 "   [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
32255 "\n"
32256 msgstr ""
32257
32258 #. type: textblock
32259 #: ../tools/virt-resize.pl:52
32260 msgid ""
32261 "Virt-resize is a tool which can resize a virtual machine disk, making it "
32262 "larger or smaller overall, and resizing or deleting any partitions contained "
32263 "within."
32264 msgstr ""
32265
32266 #. type: textblock
32267 #: ../tools/virt-resize.pl:56
32268 msgid ""
32269 "Virt-resize B<cannot> resize disk images in-place.  Virt-resize B<should "
32270 "not> be used on live virtual machines - for consistent results, shut the "
32271 "virtual machine down before resizing it."
32272 msgstr ""
32273
32274 #. type: textblock
32275 #: ../tools/virt-resize.pl:60
32276 msgid ""
32277 "If you are not familiar with the associated tools: L<virt-filesystems(1)> "
32278 "and L<virt-df(1)>, we recommend you go and read those manual pages first."
32279 msgstr ""
32280
32281 #. type: textblock
32282 #: ../tools/virt-resize.pl:66
32283 msgid ""
32284 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
32285 "fill the extra 5GB of space."
32286 msgstr ""
32287
32288 #. type: verbatim
32289 #: ../tools/virt-resize.pl:69
32290 #, no-wrap
32291 msgid ""
32292 " truncate -r olddisk newdisk; truncate -s +5G newdisk\n"
32293 " virt-filesystems --long -h --all -a olddisk\n"
32294 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
32295 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
32296 "\n"
32297 msgstr ""
32298
32299 #. type: textblock
32300 #: ../tools/virt-resize.pl:74
32301 msgid ""
32302 "As above, but make the /boot partition 200MB bigger, while giving the "
32303 "remaining space to /dev/sda2:"
32304 msgstr ""
32305
32306 #. type: verbatim
32307 #: ../tools/virt-resize.pl:77
32308 #, no-wrap
32309 msgid ""
32310 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 olddisk newdisk\n"
32311 "\n"
32312 msgstr ""
32313
32314 #. type: textblock
32315 #: ../tools/virt-resize.pl:79
32316 msgid "As above, but the output format will be uncompressed qcow2:"
32317 msgstr ""
32318
32319 #. type: verbatim
32320 #: ../tools/virt-resize.pl:81
32321 #, no-wrap
32322 msgid ""
32323 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
32324 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
32325 "\n"
32326 msgstr ""
32327
32328 #. type: =head1
32329 #: ../tools/virt-resize.pl:84
32330 msgid "DETAILED USAGE"
32331 msgstr ""
32332
32333 #. type: =head2
32334 #: ../tools/virt-resize.pl:86
32335 msgid "EXPANDING A VIRTUAL MACHINE DISK"
32336 msgstr ""
32337
32338 #. type: =item
32339 #: ../tools/virt-resize.pl:90
32340 msgid "1. Shut down the virtual machine"
32341 msgstr ""
32342
32343 #. type: =item
32344 #: ../tools/virt-resize.pl:92
32345 msgid "2. Locate input disk image"
32346 msgstr ""
32347
32348 #. type: textblock
32349 #: ../tools/virt-resize.pl:94
32350 msgid ""
32351 "Locate the input disk image (ie. the file or device on the host containing "
32352 "the guest's disk).  If the guest is managed by libvirt, you can use C<virsh "
32353 "dumpxml> like this to find the disk image name:"
32354 msgstr ""
32355
32356 #. type: verbatim
32357 #: ../tools/virt-resize.pl:98
32358 #, no-wrap
32359 msgid ""
32360 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
32361 " Found 1 nodes:\n"
32362 " -- NODE --\n"
32363 " <source dev=\"/dev/vg/lv_guest\" />\n"
32364 "\n"
32365 msgstr ""
32366
32367 #. type: =item
32368 #: ../tools/virt-resize.pl:103
32369 msgid "3. Look at current sizing"
32370 msgstr ""
32371
32372 #. type: textblock
32373 #: ../tools/virt-resize.pl:105
32374 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
32375 msgstr ""
32376
32377 #. type: verbatim
32378 #: ../tools/virt-resize.pl:108
32379 #, no-wrap
32380 msgid ""
32381 " # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
32382 " Name       Type       Size  Parent\n"
32383 " /dev/sda1  partition  101M  /dev/sda\n"
32384 " /dev/sda2  partition  7.9G  /dev/sda\n"
32385 " /dev/sda   device     8.0G  -\n"
32386 "\n"
32387 msgstr ""
32388
32389 #. type: textblock
32390 #: ../tools/virt-resize.pl:114
32391 msgid ""
32392 "(This example is a virtual machine with an 8 GB disk which we would like to "
32393 "expand up to 10 GB)."
32394 msgstr ""
32395
32396 #. type: =item
32397 #: ../tools/virt-resize.pl:117
32398 msgid "4. Create output disk"
32399 msgstr ""
32400
32401 #. type: textblock
32402 #: ../tools/virt-resize.pl:119
32403 msgid ""
32404 "Virt-resize cannot do in-place disk modifications.  You have to have space "
32405 "to store the resized output disk."
32406 msgstr ""
32407
32408 #. type: textblock
32409 #: ../tools/virt-resize.pl:122
32410 msgid ""
32411 "To store the resized disk image in a file, create a file of a suitable size:"
32412 msgstr ""
32413
32414 #. type: verbatim
32415 #: ../tools/virt-resize.pl:125
32416 #, no-wrap
32417 msgid ""
32418 " # rm -f outdisk\n"
32419 " # truncate -s 10G outdisk\n"
32420 "\n"
32421 msgstr ""
32422
32423 #. type: textblock
32424 #: ../tools/virt-resize.pl:128
32425 msgid "Or use L<lvcreate(1)> to create a logical volume:"
32426 msgstr ""
32427
32428 #. type: verbatim
32429 #: ../tools/virt-resize.pl:130
32430 #, no-wrap
32431 msgid ""
32432 " # lvcreate -L 10G -n lv_name vg_name\n"
32433 "\n"
32434 msgstr ""
32435
32436 #. type: textblock
32437 #: ../tools/virt-resize.pl:132
32438 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
32439 msgstr ""
32440
32441 #. type: verbatim
32442 #: ../tools/virt-resize.pl:134
32443 #, no-wrap
32444 msgid ""
32445 " # virsh pool-list\n"
32446 " # virsh vol-create-as poolname newvol 10G\n"
32447 "\n"
32448 msgstr ""
32449
32450 #. type: =item
32451 #: ../tools/virt-resize.pl:137
32452 msgid "5. Resize"
32453 msgstr ""
32454
32455 #. type: textblock
32456 #: ../tools/virt-resize.pl:139
32457 msgid ""
32458 "virt-resize takes two mandatory parameters, the input disk (eg. device or "
32459 "file) and the output disk.  The output disk is the one created in the "
32460 "previous step."
32461 msgstr ""
32462
32463 #. type: verbatim
32464 #: ../tools/virt-resize.pl:143
32465 #, no-wrap
32466 msgid ""
32467 " # virt-resize indisk outdisk\n"
32468 "\n"
32469 msgstr ""
32470
32471 #. type: textblock
32472 #: ../tools/virt-resize.pl:145
32473 msgid ""
32474 "This command just copies disk image C<indisk> to disk image C<outdisk> "
32475 "I<without> resizing or changing any existing partitions.  If C<outdisk> is "
32476 "larger, then an extra, empty partition is created at the end of the disk "
32477 "covering the extra space.  If C<outdisk> is smaller, then it will give an "
32478 "error."
32479 msgstr ""
32480
32481 #. type: textblock
32482 #: ../tools/virt-resize.pl:151
32483 msgid ""
32484 "More realistically you'd want to expand existing partitions in the disk "
32485 "image by passing extra options (for the full list see the L</OPTIONS> "
32486 "section below)."
32487 msgstr ""
32488
32489 #. type: textblock
32490 #: ../tools/virt-resize.pl:155
32491 msgid ""
32492 "L</--expand> is the most useful option.  It expands the named partition "
32493 "within the disk to fill any extra space:"
32494 msgstr ""
32495
32496 #. type: verbatim
32497 #: ../tools/virt-resize.pl:158
32498 #, no-wrap
32499 msgid ""
32500 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
32501 "\n"
32502 msgstr ""
32503
32504 #. type: textblock
32505 #: ../tools/virt-resize.pl:160
32506 msgid ""
32507 "(In this case, an extra partition is I<not> created at the end of the disk, "
32508 "because there will be no unused space)."
32509 msgstr ""
32510
32511 #. type: textblock
32512 #: ../tools/virt-resize.pl:163
32513 msgid ""
32514 "L</--resize> is the other commonly used option.  The following would "
32515 "increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the "
32516 "rest of the available space:"
32517 msgstr ""
32518
32519 #. type: verbatim
32520 #: ../tools/virt-resize.pl:167
32521 #, no-wrap
32522 msgid ""
32523 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
32524 "     indisk outdisk\n"
32525 "\n"
32526 msgstr ""
32527
32528 #. type: textblock
32529 #: ../tools/virt-resize.pl:170
32530 msgid ""
32531 "If the expanded partition in the image contains a filesystem or LVM PV, then "
32532 "if virt-resize knows how, it will resize the contents, the equivalent of "
32533 "calling a command such as L<pvresize(8)>, L<resize2fs(8)> or L<ntfsresize(8)"
32534 ">.  However virt-resize does not know how to resize some filesystems, so you "
32535 "would have to online resize them after booting the guest."
32536 msgstr ""
32537
32538 #. type: textblock
32539 #: ../tools/virt-resize.pl:177
32540 msgid "Other options are covered below."
32541 msgstr ""
32542
32543 #. type: =item
32544 #: ../tools/virt-resize.pl:179
32545 msgid "6. Test"
32546 msgstr ""
32547
32548 #. type: textblock
32549 #: ../tools/virt-resize.pl:181
32550 msgid "Thoroughly test the new disk image I<before> discarding the old one."
32551 msgstr ""
32552
32553 #. type: textblock
32554 #: ../tools/virt-resize.pl:183
32555 msgid "If you are using libvirt, edit the XML to point at the new disk:"
32556 msgstr ""
32557
32558 #. type: verbatim
32559 #: ../tools/virt-resize.pl:185
32560 #, no-wrap
32561 msgid ""
32562 " # virsh edit guestname\n"
32563 "\n"
32564 msgstr ""
32565
32566 #. type: textblock
32567 #: ../tools/virt-resize.pl:187
32568 msgid ""
32569 "Change E<lt>source ...E<gt>, see L<http://libvirt.org/formatdomain."
32570 "html#elementsDisks>"
32571 msgstr ""
32572
32573 #. type: textblock
32574 #: ../tools/virt-resize.pl:190
32575 msgid "Then start up the domain with the new, resized disk:"
32576 msgstr ""
32577
32578 #. type: verbatim
32579 #: ../tools/virt-resize.pl:192
32580 #, no-wrap
32581 msgid ""
32582 " # virsh start guestname\n"
32583 "\n"
32584 msgstr ""
32585
32586 #. type: textblock
32587 #: ../tools/virt-resize.pl:194
32588 msgid ""
32589 "and check that it still works.  See also the L</NOTES> section below for "
32590 "additional information."
32591 msgstr ""
32592
32593 #. type: =item
32594 #: ../tools/virt-resize.pl:197
32595 msgid "7. Resize LVs etc inside the guest"
32596 msgstr ""
32597
32598 #. type: textblock
32599 #: ../tools/virt-resize.pl:199
32600 msgid "(This can also be done offline using L<guestfish(1)>)"
32601 msgstr ""
32602
32603 #. type: textblock
32604 #: ../tools/virt-resize.pl:201
32605 msgid ""
32606 "Once the guest has booted you should see the new space available, at least "
32607 "for filesystems that virt-resize knows how to resize, and for PVs.  The user "
32608 "may need to resize LVs inside PVs, and also resize filesystem types that "
32609 "virt-resize does not know how to expand."
32610 msgstr ""
32611
32612 #. type: =head2
32613 #: ../tools/virt-resize.pl:208
32614 msgid "SHRINKING A VIRTUAL MACHINE DISK"
32615 msgstr ""
32616
32617 #. type: textblock
32618 #: ../tools/virt-resize.pl:210
32619 msgid ""
32620 "Shrinking is somewhat more complex than expanding, and only an overview is "
32621 "given here."
32622 msgstr ""
32623
32624 #. type: textblock
32625 #: ../tools/virt-resize.pl:213
32626 msgid ""
32627 "Firstly virt-resize will not attempt to shrink any partition content (PVs, "
32628 "filesystems).  The user has to shrink content before passing the disk image "
32629 "to virt-resize, and virt-resize will check that the content has been shrunk "
32630 "properly."
32631 msgstr ""
32632
32633 #. type: textblock
32634 #: ../tools/virt-resize.pl:218
32635 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
32636 msgstr ""
32637
32638 #. type: textblock
32639 #: ../tools/virt-resize.pl:220
32640 msgid ""
32641 "After shrinking PVs and filesystems, shut down the guest, and proceed with "
32642 "steps 3 and 4 above to allocate a new disk image."
32643 msgstr ""
32644
32645 #. type: textblock
32646 #: ../tools/virt-resize.pl:223
32647 msgid ""
32648 "Then run virt-resize with any of the C<--shrink> and/or C<--resize> options."
32649 msgstr ""
32650
32651 #. type: =head2
32652 #: ../tools/virt-resize.pl:226
32653 msgid "IGNORING OR DELETING PARTITIONS"
32654 msgstr ""
32655
32656 #. type: textblock
32657 #: ../tools/virt-resize.pl:228
32658 msgid ""
32659 "virt-resize also gives a convenient way to ignore or delete partitions when "
32660 "copying from the input disk to the output disk.  Ignoring a partition speeds "
32661 "up the copy where you don't care about the existing contents of a "
32662 "partition.  Deleting a partition removes it completely, but note that it "
32663 "also renumbers any partitions after the one which is deleted, which can "
32664 "leave some guests unbootable."
32665 msgstr ""
32666
32667 #. type: =head2
32668 #: ../tools/virt-resize.pl:235
32669 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
32670 msgstr ""
32671
32672 #. type: textblock
32673 #: ../tools/virt-resize.pl:237
32674 msgid ""
32675 "If the input disk is in qcow2 format, then you may prefer that the output is "
32676 "in qcow2 format as well.  Alternately, virt-resize can convert the format on "
32677 "the fly.  The output format is simply determined by the format of the empty "
32678 "output container that you provide.  Thus to create qcow2 output, use:"
32679 msgstr ""
32680
32681 #. type: verbatim
32682 #: ../tools/virt-resize.pl:243
32683 #, no-wrap
32684 msgid ""
32685 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
32686 "\n"
32687 msgstr ""
32688
32689 #. type: textblock
32690 #: ../tools/virt-resize.pl:245
32691 msgid "instead of the truncate command (use C<-c> for a compressed disk)."
32692 msgstr ""
32693
32694 #. type: textblock
32695 #: ../tools/virt-resize.pl:247
32696 msgid "Similarly, to get non-sparse raw output use:"
32697 msgstr ""
32698
32699 #. type: verbatim
32700 #: ../tools/virt-resize.pl:249
32701 #, no-wrap
32702 msgid ""
32703 " fallocate -l size outdisk\n"
32704 "\n"
32705 msgstr ""
32706
32707 #. type: textblock
32708 #: ../tools/virt-resize.pl:251
32709 msgid ""
32710 "(on older systems that don't have the L<fallocate(1)> command use C<dd if=/"
32711 "dev/zero of=outdisk bs=1M count=..>)"
32712 msgstr ""
32713
32714 #. type: textblock
32715 #: ../tools/virt-resize.pl:264
32716 msgid "Display help."
32717 msgstr ""
32718
32719 #. type: =item
32720 #: ../tools/virt-resize.pl:278
32721 msgid "B<--resize part=size>"
32722 msgstr ""
32723
32724 #. type: textblock
32725 #: ../tools/virt-resize.pl:280
32726 msgid ""
32727 "Resize the named partition (expanding or shrinking it) so that it has the "
32728 "given size."
32729 msgstr ""
32730
32731 #. type: textblock
32732 #: ../tools/virt-resize.pl:283
32733 msgid ""
32734 "C<size> can be expressed as an absolute number followed by b/K/M/G/T/P/E to "
32735 "mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or "
32736 "Exabytes; or as a percentage of the current size; or as a relative number or "
32737 "percentage.  For example:"
32738 msgstr ""
32739
32740 #. type: verbatim
32741 #: ../tools/virt-resize.pl:288
32742 #, no-wrap
32743 msgid ""
32744 " --resize /dev/sda2=10G\n"
32745 "\n"
32746 msgstr ""
32747
32748 #. type: verbatim
32749 #: ../tools/virt-resize.pl:290
32750 #, no-wrap
32751 msgid ""
32752 " --resize /dev/sda4=90%\n"
32753 "\n"
32754 msgstr ""
32755
32756 #. type: verbatim
32757 #: ../tools/virt-resize.pl:292
32758 #, no-wrap
32759 msgid ""
32760 " --resize /dev/sda2=+1G\n"
32761 "\n"
32762 msgstr ""
32763
32764 #. type: verbatim
32765 #: ../tools/virt-resize.pl:294
32766 #, no-wrap
32767 msgid ""
32768 " --resize /dev/sda2=-200M\n"
32769 "\n"
32770 msgstr ""
32771
32772 #. type: verbatim
32773 #: ../tools/virt-resize.pl:296
32774 #, no-wrap
32775 msgid ""
32776 " --resize /dev/sda1=+128K\n"
32777 "\n"
32778 msgstr ""
32779
32780 #. type: verbatim
32781 #: ../tools/virt-resize.pl:298
32782 #, no-wrap
32783 msgid ""
32784 " --resize /dev/sda1=+10%\n"
32785 "\n"
32786 msgstr ""
32787
32788 #. type: verbatim
32789 #: ../tools/virt-resize.pl:300
32790 #, no-wrap
32791 msgid ""
32792 " --resize /dev/sda1=-10%\n"
32793 "\n"
32794 msgstr ""
32795
32796 #. type: textblock
32797 #: ../tools/virt-resize.pl:302
32798 msgid ""
32799 "You can increase the size of any partition.  Virt-resize will expand the "
32800 "direct content of the partition if it knows how (see C<--expand> below)."
32801 msgstr ""
32802
32803 #. type: textblock
32804 #: ../tools/virt-resize.pl:306
32805 msgid ""
32806 "You can only I<decrease> the size of partitions that contain filesystems or "
32807 "PVs which have already been shrunk.  Virt-resize will check this has been "
32808 "done before proceeding, or else will print an error (see also C<--resize-"
32809 "force>)."
32810 msgstr ""
32811
32812 #. type: textblock
32813 #: ../tools/virt-resize.pl:311 ../tools/virt-resize.pl:403
32814 #: ../tools/virt-resize.pl:420
32815 msgid "You can give this option multiple times."
32816 msgstr ""
32817
32818 #. type: =item
32819 #: ../tools/virt-resize.pl:317
32820 msgid "B<--resize-force part=size>"
32821 msgstr ""
32822
32823 #. type: textblock
32824 #: ../tools/virt-resize.pl:319
32825 msgid ""
32826 "This is the same as C<--resize> except that it will let you decrease the "
32827 "size of any partition.  Generally this means you will lose any data which "
32828 "was at the end of the partition you shrink, but you may not care about that "
32829 "(eg. if shrinking an unused partition, or if you can easily recreate it such "
32830 "as a swap partition)."
32831 msgstr ""
32832
32833 #. type: textblock
32834 #: ../tools/virt-resize.pl:325
32835 msgid "See also the C<--ignore> option."
32836 msgstr ""
32837
32838 #. type: =item
32839 #: ../tools/virt-resize.pl:331
32840 msgid "B<--expand part>"
32841 msgstr ""
32842
32843 #. type: textblock
32844 #: ../tools/virt-resize.pl:333
32845 msgid ""
32846 "Expand the named partition so it uses up all extra space (space left over "
32847 "after any other resize changes that you request have been done)."
32848 msgstr ""
32849
32850 #. type: textblock
32851 #: ../tools/virt-resize.pl:336
32852 msgid ""
32853 "If virt-resize knows how, it will expand the direct content of the "
32854 "partition.  For example, if the partition is an LVM PV, it will expand the "
32855 "PV to fit (like calling L<pvresize(8)>).  Virt-resize leaves any other "
32856 "content it doesn't know about alone."
32857 msgstr ""
32858
32859 #. type: textblock
32860 #: ../tools/virt-resize.pl:341
32861 msgid "Currently virt-resize can resize:"
32862 msgstr ""
32863
32864 #. type: textblock
32865 #: ../tools/virt-resize.pl:347
32866 msgid ""
32867 "ext2, ext3 and ext4 filesystems when they are contained directly inside a "
32868 "partition."
32869 msgstr ""
32870
32871 #. type: textblock
32872 #: ../tools/virt-resize.pl:352
32873 msgid ""
32874 "NTFS filesystems contained directly in a partition, if libguestfs was "
32875 "compiled with support for NTFS."
32876 msgstr ""
32877
32878 #. type: textblock
32879 #: ../tools/virt-resize.pl:355
32880 msgid ""
32881 "The filesystem must have been shut down consistently last time it was used.  "
32882 "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
32883 "consistency check, so at the first boot after resizing Windows will check "
32884 "the disk."
32885 msgstr ""
32886
32887 #. type: textblock
32888 #: ../tools/virt-resize.pl:362
32889 msgid ""
32890 "LVM PVs (physical volumes).  virt-resize does not usually resize anything "
32891 "inside the PV, but see the C<--LV-expand> option.  The user could also "
32892 "resize LVs as desired after boot."
32893 msgstr ""
32894
32895 #. type: textblock
32896 #: ../tools/virt-resize.pl:368 ../tools/virt-resize.pl:390
32897 msgid "Note that you cannot use C<--expand> and C<--shrink> together."
32898 msgstr ""
32899
32900 #. type: =item
32901 #: ../tools/virt-resize.pl:374
32902 msgid "B<--shrink part>"
32903 msgstr ""
32904
32905 #. type: textblock
32906 #: ../tools/virt-resize.pl:376
32907 msgid ""
32908 "Shrink the named partition until the overall disk image fits in the "
32909 "destination.  The named partition B<must> contain a filesystem or PV which "
32910 "has already been shrunk using another tool (eg. L<guestfish(1)> or other "
32911 "online tools).  Virt-resize will check this and give an error if it has not "
32912 "been done."
32913 msgstr ""
32914
32915 #. type: textblock
32916 #: ../tools/virt-resize.pl:382
32917 msgid ""
32918 "The amount by which the overall disk must be shrunk (after carrying out all "
32919 "other operations requested by the user) is called the \"deficit\".  For "
32920 "example, a straight copy (assume no other operations)  from a 5GB disk image "
32921 "to a 4GB disk image results in a 1GB deficit.  In this case, virt-resize "
32922 "would give an error unless the user specified a partition to shrink and that "
32923 "partition had more than a gigabyte of free space."
32924 msgstr ""
32925
32926 #. type: =item
32927 #: ../tools/virt-resize.pl:396
32928 msgid "B<--ignore part>"
32929 msgstr ""
32930
32931 #. type: textblock
32932 #: ../tools/virt-resize.pl:398
32933 msgid ""
32934 "Ignore the named partition.  Effectively this means the partition is "
32935 "allocated on the destination disk, but the content is not copied across from "
32936 "the source disk.  The content of the partition will be blank (all zero "
32937 "bytes)."
32938 msgstr ""
32939
32940 #. type: =item
32941 #: ../tools/virt-resize.pl:409
32942 msgid "B<--delete part>"
32943 msgstr ""
32944
32945 #. type: textblock
32946 #: ../tools/virt-resize.pl:411
32947 msgid ""
32948 "Delete the named partition.  It would be more accurate to describe this as "
32949 "\"don't copy it over\", since virt-resize doesn't do in-place changes and "
32950 "the original disk image is left intact."
32951 msgstr ""
32952
32953 #. type: textblock
32954 #: ../tools/virt-resize.pl:415
32955 msgid ""
32956 "Note that when you delete a partition, then anything contained in the "
32957 "partition is also deleted.  Furthermore, this causes any partitions that "
32958 "come after to be I<renumbered>, which can easily make your guest unbootable."
32959 msgstr ""
32960
32961 #. type: =item
32962 #: ../tools/virt-resize.pl:426
32963 msgid "B<--LV-expand logvol>"
32964 msgstr ""
32965
32966 #. type: textblock
32967 #: ../tools/virt-resize.pl:428
32968 msgid ""
32969 "This takes the logical volume and, as a final step, expands it to fill all "
32970 "the space available in its volume group.  A typical usage, assuming a Linux "
32971 "guest with a single PV C</dev/sda2> and a root device called C</dev/vg_guest/"
32972 "lv_root> would be:"
32973 msgstr ""
32974
32975 #. type: verbatim
32976 #: ../tools/virt-resize.pl:433
32977 #, no-wrap
32978 msgid ""
32979 " virt-resize indisk outdisk \\\n"
32980 "   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
32981 "\n"
32982 msgstr ""
32983
32984 #. type: textblock
32985 #: ../tools/virt-resize.pl:436
32986 msgid ""
32987 "This would first expand the partition (and PV), and then expand the root "
32988 "device to fill the extra space in the PV."
32989 msgstr ""
32990
32991 #. type: textblock
32992 #: ../tools/virt-resize.pl:439
32993 msgid ""
32994 "The contents of the LV are also resized if virt-resize knows how to do "
32995 "that.  You can stop virt-resize from trying to expand the content by using "
32996 "the option C<--no-expand-content>."
32997 msgstr ""
32998
32999 #. type: textblock
33000 #: ../tools/virt-resize.pl:443
33001 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
33002 msgstr ""
33003
33004 #. type: textblock
33005 #: ../tools/virt-resize.pl:446
33006 msgid ""
33007 "You can give this option multiple times, I<but> it doesn't make sense to do "
33008 "this unless the logical volumes you specify are all in different volume "
33009 "groups."
33010 msgstr ""
33011
33012 #. type: =item
33013 #: ../tools/virt-resize.pl:454
33014 msgid "B<--no-copy-boot-loader>"
33015 msgstr ""
33016
33017 #. type: textblock
33018 #: ../tools/virt-resize.pl:456
33019 msgid ""
33020 "By default, virt-resize copies over some sectors at the start of the disk "
33021 "(up to the beginning of the first partition).  Commonly these sectors "
33022 "contain the Master Boot Record (MBR) and the boot loader, and are required "
33023 "in order for the guest to boot correctly."
33024 msgstr ""
33025
33026 #. type: textblock
33027 #: ../tools/virt-resize.pl:461
33028 msgid ""
33029 "If you specify this flag, then this initial copy is not done.  You may need "
33030 "to reinstall the boot loader in this case."
33031 msgstr ""
33032
33033 #. type: =item
33034 #: ../tools/virt-resize.pl:469
33035 msgid "B<--no-extra-partition>"
33036 msgstr ""
33037
33038 #. type: textblock
33039 #: ../tools/virt-resize.pl:471
33040 msgid ""
33041 "By default, virt-resize creates an extra partition if there is any extra, "
33042 "unused space after all resizing has happened.  Use this option to prevent "
33043 "the extra partition from being created.  If you do this then the extra space "
33044 "will be inaccessible until you run fdisk, parted, or some other partitioning "
33045 "tool in the guest."
33046 msgstr ""
33047
33048 #. type: textblock
33049 #: ../tools/virt-resize.pl:477
33050 msgid ""
33051 "Note that if the surplus space is smaller than 10 MB, no extra partition "
33052 "will be created."
33053 msgstr ""
33054
33055 #. type: =item
33056 #: ../tools/virt-resize.pl:484
33057 msgid "B<--no-expand-content>"
33058 msgstr ""
33059
33060 #. type: textblock
33061 #: ../tools/virt-resize.pl:486
33062 msgid ""
33063 "By default, virt-resize will try to expand the direct contents of "
33064 "partitions, if it knows how (see C<--expand> option above)."
33065 msgstr ""
33066
33067 #. type: textblock
33068 #: ../tools/virt-resize.pl:489
33069 msgid ""
33070 "If you give the C<--no-expand-content> option then virt-resize will not "
33071 "attempt this."
33072 msgstr ""
33073
33074 #. type: =item
33075 #: ../tools/virt-resize.pl:496
33076 msgid "B<-d> | B<--debug>"
33077 msgstr ""
33078
33079 #. type: =item
33080 #: ../tools/virt-resize.pl:504
33081 msgid "B<-n> | B<--dryrun>"
33082 msgstr ""
33083
33084 #. type: textblock
33085 #: ../tools/virt-resize.pl:506
33086 msgid "Print a summary of what would be done, but don't do anything."
33087 msgstr ""
33088
33089 #. type: =item
33090 #: ../tools/virt-resize.pl:512
33091 msgid "B<-q> | B<--quiet>"
33092 msgstr ""
33093
33094 #. type: textblock
33095 #: ../tools/virt-resize.pl:514
33096 msgid "Don't print the summary."
33097 msgstr ""
33098
33099 #. type: textblock
33100 #: ../tools/virt-resize.pl:522
33101 msgid ""
33102 "Specify the format of the input disk image.  If this flag is not given then "
33103 "it is auto-detected from the image itself."
33104 msgstr ""
33105
33106 #. type: textblock
33107 #: ../tools/virt-resize.pl:528
33108 msgid ""
33109 "Note that this option I<does not> affect the output format.  See L</QCOW2 "
33110 "AND NON-SPARSE RAW FORMATS>."
33111 msgstr ""
33112
33113 #. type: =item
33114 #: ../tools/virt-resize.pl:535
33115 msgid "B<--output-format> raw"
33116 msgstr ""
33117
33118 #. type: textblock
33119 #: ../tools/virt-resize.pl:537
33120 msgid ""
33121 "Specify the format of the output disk image.  If this flag is not given then "
33122 "it is auto-detected from the image itself."
33123 msgstr ""
33124
33125 #. type: textblock
33126 #: ../tools/virt-resize.pl:543
33127 msgid ""
33128 "Note that you still need to create the output disk with the right format.  "
33129 "See L</QCOW2 AND NON-SPARSE RAW FORMATS>."
33130 msgstr ""
33131
33132 #. type: =head1
33133 #: ../tools/virt-resize.pl:1419
33134 msgid "NOTES"
33135 msgstr ""
33136
33137 #. type: =head2
33138 #: ../tools/virt-resize.pl:1421
33139 msgid "\"Partition 1 does not end on cylinder boundary.\""
33140 msgstr ""
33141
33142 #. type: textblock
33143 #: ../tools/virt-resize.pl:1423
33144 msgid ""
33145 "Virt-resize aligns partitions to multiples of 64 sectors.  Usually this "
33146 "means the partitions will not be aligned to the ancient CHS geometry.  "
33147 "However CHS geometry is meaningless for disks manufactured since the early "
33148 "1990s, and doubly so for virtual hard drives.  Alignment of partitions to "
33149 "cylinders is not required by any modern operating system."
33150 msgstr ""
33151
33152 #. type: =head2
33153 #: ../tools/virt-resize.pl:1430
33154 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
33155 msgstr ""
33156
33157 #. type: textblock
33158 #: ../tools/virt-resize.pl:1432
33159 msgid ""
33160 "In Windows Vista and later versions, Microsoft switched to using a separate "
33161 "boot partition.  In these VMs, typically C</dev/sda1> is the boot partition "
33162 "and C</dev/sda2> is the main (C:) drive.  We have not had any luck resizing "
33163 "the boot partition.  Doing so seems to break the guest completely.  However "
33164 "expanding the second partition (ie. C: drive) should work."
33165 msgstr ""
33166
33167 #. type: textblock
33168 #: ../tools/virt-resize.pl:1439
33169 msgid ""
33170 "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if "
33171 "NTFS partitions have been expanded.  This is just a safety check and (unless "
33172 "it find errors) is nothing to worry about."
33173 msgstr ""
33174
33175 #. type: =head2
33176 #: ../tools/virt-resize.pl:1443
33177 msgid "GUEST BOOT STUCK AT \"GRUB\""
33178 msgstr ""
33179
33180 #. type: textblock
33181 #: ../tools/virt-resize.pl:1445
33182 msgid ""
33183 "If a Linux guest does not boot after resizing, and the boot is stuck after "
33184 "printing C<GRUB> on the console, try reinstalling grub.  This sometimes "
33185 "happens on older (RHEL 5-era) guests, for reasons we don't fully understand, "
33186 "although we think is to do with partition alignment."
33187 msgstr ""
33188
33189 #. type: verbatim
33190 #: ../tools/virt-resize.pl:1450
33191 #, no-wrap
33192 msgid ""
33193 " guestfish -i -a newdisk\n"
33194 " ><fs> cat /boot/grub/device.map\n"
33195 " # check the contents of this file are sensible or\n"
33196 " # edit the file if necessary\n"
33197 " ><fs> grub-install / /dev/vda\n"
33198 " ><fs> exit\n"
33199 "\n"
33200 msgstr ""
33201
33202 #. type: textblock
33203 #: ../tools/virt-resize.pl:1457
33204 msgid ""
33205 "For more flexible guest reconfiguration, including if you need to specify "
33206 "other parameters to grub-install, use L<virt-rescue(1)>."
33207 msgstr ""
33208
33209 #. type: =head1
33210 #: ../tools/virt-resize.pl:1460
33211 msgid "ALTERNATIVE TOOLS"
33212 msgstr ""
33213
33214 #. type: textblock
33215 #: ../tools/virt-resize.pl:1462
33216 msgid ""
33217 "There are several proprietary tools for resizing partitions.  We won't "
33218 "mention any here."
33219 msgstr ""
33220
33221 #. type: textblock
33222 #: ../tools/virt-resize.pl:1465
33223 msgid ""
33224 "L<parted(8)> and its graphical shell gparted can do some types of resizing "
33225 "operations on disk images.  They can resize and move partitions, but I don't "
33226 "think they can do anything with the contents, and they certainly don't "
33227 "understand LVM."
33228 msgstr ""
33229
33230 #. type: textblock
33231 #: ../tools/virt-resize.pl:1470
33232 msgid ""
33233 "L<guestfish(1)> can do everything that virt-resize can do and a lot more, "
33234 "but at a much lower level.  You will probably end up hand-calculating sector "
33235 "offsets, which is something that virt-resize was designed to avoid.  If you "
33236 "want to see the guestfish-equivalent commands that virt-resize runs, use the "
33237 "C<--debug> flag."
33238 msgstr ""
33239
33240 #. type: textblock
33241 #: ../tools/virt-resize.pl:1485
33242 msgid ""
33243 "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<lvm"
33244 "(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)>, "
33245 "L<virsh(1)>, L<parted(8)>, L<truncate(1)>, L<fallocate(1)>, L<grub(8)>, "
33246 "L<grub-install(8)>, L<virt-rescue(1)>, L<Sys::Guestfs(3)>, L<http://"
33247 "libguestfs.org/>."
33248 msgstr ""
33249
33250 #. type: textblock
33251 #: ../tools/virt-list-filesystems.pl:32
33252 msgid ""
33253 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
33254 msgstr ""
33255
33256 #. type: verbatim
33257 #: ../tools/virt-list-filesystems.pl:36
33258 #, no-wrap
33259 msgid ""
33260 " virt-list-filesystems [--options] domname\n"
33261 "\n"
33262 msgstr ""
33263
33264 #. type: verbatim
33265 #: ../tools/virt-list-filesystems.pl:38
33266 #, no-wrap
33267 msgid ""
33268 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
33269 "\n"
33270 msgstr ""
33271
33272 #. type: textblock
33273 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
33274 msgid ""
33275 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
33276 "replacement."
33277 msgstr ""
33278
33279 #. type: textblock
33280 #: ../tools/virt-list-filesystems.pl:45
33281 msgid ""
33282 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
33283 "are contained in a virtual machine or disk image."
33284 msgstr ""
33285
33286 #. type: textblock
33287 #: ../tools/virt-list-filesystems.pl:49
33288 msgid ""
33289 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
33290 "functionality.  For more complex cases you should look at the L<guestfish(1)"
33291 "> tool."
33292 msgstr ""
33293
33294 #. type: =item
33295 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
33296 msgid "B<-l> | B<--long>"
33297 msgstr ""
33298
33299 #. type: textblock
33300 #: ../tools/virt-list-filesystems.pl:108
33301 msgid ""
33302 "With this option, C<virt-list-filesystems> displays the type of each "
33303 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
33304 msgstr ""
33305
33306 #. type: =item
33307 #: ../tools/virt-list-filesystems.pl:115
33308 msgid "B<-a> | B<--all>"
33309 msgstr ""
33310
33311 #. type: textblock
33312 #: ../tools/virt-list-filesystems.pl:117
33313 msgid ""
33314 "Normally we only show mountable filesystems.  If this option is given then "
33315 "swap devices are shown too."
33316 msgstr ""
33317
33318 #. type: textblock
33319 #: ../tools/virt-list-filesystems.pl:191
33320 msgid ""
33321 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
33322 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
33323 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33324 msgstr ""
33325
33326 #. type: textblock
33327 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:298
33328 msgid "Copyright (C) 2009 Red Hat Inc."
33329 msgstr ""
33330
33331 #. type: textblock
33332 #: ../tools/virt-tar.pl:33
33333 msgid "virt-tar - Extract or upload files to a virtual machine"
33334 msgstr ""
33335
33336 #. type: verbatim
33337 #: ../tools/virt-tar.pl:37
33338 #, no-wrap
33339 msgid ""
33340 " virt-tar [--options] -x domname directory tarball\n"
33341 "\n"
33342 msgstr ""
33343
33344 #. type: verbatim
33345 #: ../tools/virt-tar.pl:39
33346 #, no-wrap
33347 msgid ""
33348 " virt-tar [--options] -u domname tarball directory\n"
33349 "\n"
33350 msgstr ""
33351
33352 #. type: verbatim
33353 #: ../tools/virt-tar.pl:41
33354 #, no-wrap
33355 msgid ""
33356 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
33357 "\n"
33358 msgstr ""
33359
33360 #. type: verbatim
33361 #: ../tools/virt-tar.pl:43
33362 #, no-wrap
33363 msgid ""
33364 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
33365 "\n"
33366 msgstr ""
33367
33368 #. type: textblock
33369 #: ../tools/virt-tar.pl:47
33370 msgid "Download C</home> from the VM into a local tarball:"
33371 msgstr ""
33372
33373 #. type: verbatim
33374 #: ../tools/virt-tar.pl:49
33375 #, no-wrap
33376 msgid ""
33377 " virt-tar -x domname /home home.tar\n"
33378 "\n"
33379 msgstr ""
33380
33381 #. type: verbatim
33382 #: ../tools/virt-tar.pl:51
33383 #, no-wrap
33384 msgid ""
33385 " virt-tar -zx domname /home home.tar.gz\n"
33386 "\n"
33387 msgstr ""
33388
33389 #. type: textblock
33390 #: ../tools/virt-tar.pl:53
33391 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
33392 msgstr ""
33393
33394 #. type: verbatim
33395 #: ../tools/virt-tar.pl:55
33396 #, no-wrap
33397 msgid ""
33398 " virt-tar -u domname uploadstuff.tar /tmp\n"
33399 "\n"
33400 msgstr ""
33401
33402 #. type: verbatim
33403 #: ../tools/virt-tar.pl:57
33404 #, no-wrap
33405 msgid ""
33406 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
33407 "\n"
33408 msgstr ""
33409
33410 #. type: textblock
33411 #: ../tools/virt-tar.pl:61
33412 msgid ""
33413 "You must I<not> use C<virt-tar> with the C<-u> option (upload) on live "
33414 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
33415 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
33416 msgstr ""
33417
33418 #. type: textblock
33419 #: ../tools/virt-tar.pl:66
33420 msgid ""
33421 "You can use C<-x> (extract) on live virtual machines, but you might get "
33422 "inconsistent results or errors if there is filesystem activity inside the "
33423 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
33424 "work, but the only way to guarantee consistent results is if the virtual "
33425 "machine is shut down."
33426 msgstr ""
33427
33428 #. type: textblock
33429 #: ../tools/virt-tar.pl:74
33430 msgid ""
33431 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
33432 "parts of a guest filesystem.  There are many possibilities: making backups, "
33433 "uploading data files, snooping on guest activity, fixing or customizing "
33434 "guests, etc."
33435 msgstr ""
33436
33437 #. type: textblock
33438 #: ../tools/virt-tar.pl:79
33439 msgid ""
33440 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
33441 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
33442 "should look at the L<guestfish(1)> tool."
33443 msgstr ""
33444
33445 #. type: textblock
33446 #: ../tools/virt-tar.pl:83
33447 msgid ""
33448 "There are two modes of operation: C<-x> (eXtract) downloads a directory and "
33449 "its contents (recursively) from the virtual machine into a local tarball.  "
33450 "C<-u> uploads from a local tarball, unpacking it into a directory inside the "
33451 "virtual machine.  You cannot use these two options together."
33452 msgstr ""
33453
33454 #. type: textblock
33455 #: ../tools/virt-tar.pl:89
33456 msgid ""
33457 "In addition, you may need to use the C<-z> (gZip) option to enable "
33458 "compression.  When uploading, you have to specify C<-z> if the upload file "
33459 "is compressed because virt-tar won't detect this on its own."
33460 msgstr ""
33461
33462 #. type: textblock
33463 #: ../tools/virt-tar.pl:93
33464 msgid ""
33465 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
33466 "example it cannot do PKZip files or bzip2 compression.  If you want that "
33467 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
33468 "the L<libguestfs(3)> API)."
33469 msgstr ""
33470
33471 #. type: =item
33472 #: ../tools/virt-tar.pl:151
33473 msgid "B<-x> | B<--extract> | B<--download>"
33474 msgstr ""
33475
33476 #. type: =item
33477 #: ../tools/virt-tar.pl:153
33478 msgid "B<-u> | B<--upload>"
33479 msgstr ""
33480
33481 #. type: textblock
33482 #: ../tools/virt-tar.pl:155
33483 msgid ""
33484 "Use C<-x> to extract (download) a directory from a virtual machine to a "
33485 "local tarball."
33486 msgstr ""
33487
33488 #. type: textblock
33489 #: ../tools/virt-tar.pl:158
33490 msgid ""
33491 "Use C<-u> to upload and unpack from a local tarball into a virtual machine.  "
33492 "Please read the L</WARNING> section above before using this option."
33493 msgstr ""
33494
33495 #. type: textblock
33496 #: ../tools/virt-tar.pl:162
33497 msgid "You must specify exactly one of these options."
33498 msgstr ""
33499
33500 #. type: =item
33501 #: ../tools/virt-tar.pl:168
33502 msgid "B<-z> | B<--gzip>"
33503 msgstr ""
33504
33505 #. type: textblock
33506 #: ../tools/virt-tar.pl:170
33507 msgid "Specify that the input or output tarball is gzip-compressed."
33508 msgstr ""
33509
33510 #. type: textblock
33511 #: ../tools/virt-tar.pl:283
33512 msgid ""
33513 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<Sys::"
33514 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
33515 "org/>."
33516 msgstr ""
33517
33518 #. type: textblock
33519 #: ../tools/virt-make-fs.pl:37
33520 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
33521 msgstr ""
33522
33523 #. type: verbatim
33524 #: ../tools/virt-make-fs.pl:41
33525 #, no-wrap
33526 msgid ""
33527 " virt-make-fs [--options] input.tar output.img\n"
33528 "\n"
33529 msgstr ""
33530
33531 #. type: verbatim
33532 #: ../tools/virt-make-fs.pl:43
33533 #, no-wrap
33534 msgid ""
33535 " virt-make-fs [--options] input.tar.gz output.img\n"
33536 "\n"
33537 msgstr ""
33538
33539 #. type: verbatim
33540 #: ../tools/virt-make-fs.pl:45
33541 #, no-wrap
33542 msgid ""
33543 " virt-make-fs [--options] directory output.img\n"
33544 "\n"
33545 msgstr ""
33546
33547 #. type: textblock
33548 #: ../tools/virt-make-fs.pl:49
33549 msgid ""
33550 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
33551 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
33552 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
33553 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
33554 "you want to attach these filesystems to existing virtual machines (eg. to "
33555 "import large amounts of read-only data to a VM)."
33556 msgstr ""
33557
33558 #. type: textblock
33559 #: ../tools/virt-make-fs.pl:57
33560 msgid "Basic usage is:"
33561 msgstr ""
33562
33563 #. type: verbatim
33564 #: ../tools/virt-make-fs.pl:59
33565 #, no-wrap
33566 msgid ""
33567 " virt-make-fs input output\n"
33568 "\n"
33569 msgstr ""
33570
33571 #. type: textblock
33572 #: ../tools/virt-make-fs.pl:61
33573 msgid ""
33574 "where C<input> is either a directory containing files that you want to add, "
33575 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
33576 "C<output> is a disk image.  The input type is detected automatically.  The "
33577 "output disk image defaults to a raw ext2 image unless you specify extra "
33578 "flags (see L</OPTIONS> below)."
33579 msgstr ""
33580
33581 #. type: =head2
33582 #: ../tools/virt-make-fs.pl:67
33583 msgid "EXTRA SPACE"
33584 msgstr ""
33585
33586 #. type: textblock
33587 #: ../tools/virt-make-fs.pl:69
33588 msgid ""
33589 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
33590 "the files that it contains, but might have extra space.  Depending on how "
33591 "you are going to use the output, you might think this extra space is wasted "
33592 "and want to minimize it, or you might want to leave space so that more files "
33593 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
33594 "but you can use the C<--size> flag to leave space in the filesystem if you "
33595 "want it."
33596 msgstr ""
33597
33598 #. type: textblock
33599 #: ../tools/virt-make-fs.pl:77
33600 msgid ""
33601 "An alternative way to leave extra space but not make the output image any "
33602 "bigger is to use an alternative disk image format (instead of the default "
33603 "\"raw\" format).  Using C<--format=qcow2> will use the native QEmu/KVM qcow2 "
33604 "image format (check your hypervisor supports this before using it).  This "
33605 "allows you to choose a large C<--size> but the extra space won't actually be "
33606 "allocated in the image until you try to store something in it."
33607 msgstr ""
33608
33609 #. type: textblock
33610 #: ../tools/virt-make-fs.pl:85
33611 msgid ""
33612 "Don't forget that you can also use local commands including L<resize2fs(8)> "
33613 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
33614 "to build another image from scratch."
33615 msgstr ""
33616
33617 #. type: =head3
33618 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
33619 #: ../tools/virt-make-fs.pl:142
33620 msgid "EXAMPLE"
33621 msgstr ""
33622
33623 #. type: verbatim
33624 #: ../tools/virt-make-fs.pl:91
33625 #, no-wrap
33626 msgid ""
33627 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
33628 "\n"
33629 msgstr ""
33630
33631 #. type: =head2
33632 #: ../tools/virt-make-fs.pl:93
33633 msgid "FILESYSTEM TYPE"
33634 msgstr ""
33635
33636 #. type: textblock
33637 #: ../tools/virt-make-fs.pl:95
33638 msgid ""
33639 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
33640 "libguestfs supports can be used (but I<not> read-only formats like "
33641 "ISO9660).  Here are some of the more common choices:"
33642 msgstr ""
33643
33644 #. type: =item
33645 #: ../tools/virt-make-fs.pl:101
33646 msgid "I<ext3>"
33647 msgstr ""
33648
33649 #. type: textblock
33650 #: ../tools/virt-make-fs.pl:103
33651 msgid ""
33652 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
33653 "you are not going to use the filesystem in a way that requires the journal, "
33654 "then this is just wasted overhead."
33655 msgstr ""
33656
33657 #. type: =item
33658 #: ../tools/virt-make-fs.pl:107
33659 msgid "I<ntfs> or I<vfat>"
33660 msgstr ""
33661
33662 #. type: textblock
33663 #: ../tools/virt-make-fs.pl:109
33664 msgid "Useful if exporting data to a Windows guest."
33665 msgstr ""
33666
33667 #. type: textblock
33668 #: ../tools/virt-make-fs.pl:111
33669 msgid ""
33670 "I<Note for vfat>: The tar archive or local directory must only contain files "
33671 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
33672 "program running within libguestfs is unable to change the ownership of non-"
33673 "root files, since vfat itself does not support this."
33674 msgstr ""
33675
33676 #. type: =item
33677 #: ../tools/virt-make-fs.pl:116
33678 msgid "I<minix>"
33679 msgstr ""
33680
33681 #. type: textblock
33682 #: ../tools/virt-make-fs.pl:118
33683 msgid ""
33684 "Lower overhead than C<ext2>, but certain limitations on filename length and "
33685 "total filesystem size."
33686 msgstr ""
33687
33688 #. type: verbatim
33689 #: ../tools/virt-make-fs.pl:125
33690 #, no-wrap
33691 msgid ""
33692 " virt-make-fs --type=minix input minixfs.img\n"
33693 "\n"
33694 msgstr ""
33695
33696 #. type: =head2
33697 #: ../tools/virt-make-fs.pl:127
33698 msgid "TO PARTITION OR NOT TO PARTITION"
33699 msgstr ""
33700
33701 #. type: textblock
33702 #: ../tools/virt-make-fs.pl:129
33703 msgid "Optionally virt-make-fs can add a partition table to the output disk."
33704 msgstr ""
33705
33706 #. type: textblock
33707 #: ../tools/virt-make-fs.pl:131
33708 msgid ""
33709 "Adding a partition can make the disk image more compatible with certain "
33710 "virtualized operating systems which don't expect to see a filesystem "
33711 "directly located on a block device (Linux doesn't care and will happily "
33712 "handle both types)."
33713 msgstr ""
33714
33715 #. type: textblock
33716 #: ../tools/virt-make-fs.pl:136
33717 msgid ""
33718 "On the other hand, if you have a partition table then the output image is no "
33719 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
33720 "directly on a partitioned disk image.  (However libguestfs tools such as "
33721 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
33722 msgstr ""
33723
33724 #. type: textblock
33725 #: ../tools/virt-make-fs.pl:144
33726 msgid "Add an MBR partition:"
33727 msgstr ""
33728
33729 #. type: verbatim
33730 #: ../tools/virt-make-fs.pl:146
33731 #, no-wrap
33732 msgid ""
33733 " virt-make-fs --partition -- input disk.img\n"
33734 "\n"
33735 msgstr ""
33736
33737 #. type: textblock
33738 #: ../tools/virt-make-fs.pl:148
33739 msgid ""
33740 "If the output disk image could be terabyte-sized or larger, it's better to "
33741 "use an EFI/GPT-compatible partition table:"
33742 msgstr ""
33743
33744 #. type: verbatim
33745 #: ../tools/virt-make-fs.pl:151
33746 #, no-wrap
33747 msgid ""
33748 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
33749 "\n"
33750 msgstr ""
33751
33752 #. type: textblock
33753 #: ../tools/virt-make-fs.pl:179
33754 msgid "Enable debugging information."
33755 msgstr ""
33756
33757 #. type: =item
33758 #: ../tools/virt-make-fs.pl:185
33759 msgid "B<--size=E<lt>NE<gt>>"
33760 msgstr ""
33761
33762 #. type: =item
33763 #: ../tools/virt-make-fs.pl:187
33764 msgid "B<--size=+E<lt>NE<gt>>"
33765 msgstr ""
33766
33767 #. type: =item
33768 #: ../tools/virt-make-fs.pl:189
33769 msgid "B<-s E<lt>NE<gt>>"
33770 msgstr ""
33771
33772 #. type: =item
33773 #: ../tools/virt-make-fs.pl:191
33774 msgid "B<-s +E<lt>NE<gt>>"
33775 msgstr ""
33776
33777 #. type: textblock
33778 #: ../tools/virt-make-fs.pl:193
33779 msgid ""
33780 "Use the C<--size> (or C<-s>) option to choose the size of the output image."
33781 msgstr ""
33782
33783 #. type: textblock
33784 #: ../tools/virt-make-fs.pl:196
33785 msgid ""
33786 "If this option is I<not> given, then the output image will be just large "
33787 "enough to contain all the files, with not much wasted space."
33788 msgstr ""
33789
33790 #. type: textblock
33791 #: ../tools/virt-make-fs.pl:199
33792 msgid ""
33793 "To choose a fixed size output disk, specify an absolute number followed by b/"
33794 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
33795 "Petabytes or Exabytes.  This must be large enough to contain all the input "
33796 "files, else you will get an error."
33797 msgstr ""
33798
33799 #. type: textblock
33800 #: ../tools/virt-make-fs.pl:204
33801 msgid ""
33802 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
33803 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
33804 "Petabytes or Exabytes.  For example: C<--size=+200M> means enough space for "
33805 "the input files, and (approximately) an extra 200 MB free space."
33806 msgstr ""
33807
33808 #. type: textblock
33809 #: ../tools/virt-make-fs.pl:210
33810 msgid ""
33811 "Note that virt-make-fs estimates free space, and therefore will not produce "
33812 "filesystems containing precisely the free space requested.  (It is much more "
33813 "expensive and time-consuming to produce a filesystem which has precisely the "
33814 "desired free space)."
33815 msgstr ""
33816
33817 #. type: =item
33818 #: ../tools/virt-make-fs.pl:219
33819 msgid "B<--format=E<lt>fmtE<gt>>"
33820 msgstr ""
33821
33822 #. type: =item
33823 #: ../tools/virt-make-fs.pl:221
33824 msgid "B<-F E<lt>fmtE<gt>>"
33825 msgstr ""
33826
33827 #. type: textblock
33828 #: ../tools/virt-make-fs.pl:223
33829 msgid "Choose the output disk image format."
33830 msgstr ""
33831
33832 #. type: textblock
33833 #: ../tools/virt-make-fs.pl:225
33834 msgid "The default is C<raw> (raw disk image)."
33835 msgstr ""
33836
33837 #. type: textblock
33838 #: ../tools/virt-make-fs.pl:227
33839 msgid ""
33840 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
33841 "that would really make sense here is C<qcow2>."
33842 msgstr ""
33843
33844 #. type: =item
33845 #: ../tools/virt-make-fs.pl:234
33846 msgid "B<--type=E<lt>fsE<gt>>"
33847 msgstr ""
33848
33849 #. type: =item
33850 #: ../tools/virt-make-fs.pl:236
33851 msgid "B<-t E<lt>fsE<gt>>"
33852 msgstr ""
33853
33854 #. type: textblock
33855 #: ../tools/virt-make-fs.pl:238
33856 msgid "Choose the output filesystem type."
33857 msgstr ""
33858
33859 #. type: textblock
33860 #: ../tools/virt-make-fs.pl:240
33861 msgid "The default is C<ext2>."
33862 msgstr ""
33863
33864 #. type: textblock
33865 #: ../tools/virt-make-fs.pl:242
33866 msgid ""
33867 "Any filesystem which is supported read-write by libguestfs can be used here."
33868 msgstr ""
33869
33870 #. type: =item
33871 #: ../tools/virt-make-fs.pl:249
33872 msgid "B<--partition>"
33873 msgstr ""
33874
33875 #. type: =item
33876 #: ../tools/virt-make-fs.pl:251
33877 msgid "B<--partition=E<lt>parttypeE<gt>>"
33878 msgstr ""
33879
33880 #. type: textblock
33881 #: ../tools/virt-make-fs.pl:253
33882 msgid ""
33883 "If specified, this flag adds an MBR partition table to the output disk image."
33884 msgstr ""
33885
33886 #. type: textblock
33887 #: ../tools/virt-make-fs.pl:256
33888 msgid ""
33889 "You can change the partition table type, eg. C<--partition=gpt> for large "
33890 "disks."
33891 msgstr ""
33892
33893 #. type: textblock
33894 #: ../tools/virt-make-fs.pl:259
33895 msgid ""
33896 "Note that if you just use a lonesome C<--partition>, the Perl option parser "
33897 "might consider the next parameter to be the partition type.  For example:"
33898 msgstr ""
33899
33900 #. type: verbatim
33901 #: ../tools/virt-make-fs.pl:263
33902 #, no-wrap
33903 msgid ""
33904 " virt-make-fs --partition input.tar ...\n"
33905 "\n"
33906 msgstr ""
33907
33908 #. type: textblock
33909 #: ../tools/virt-make-fs.pl:265
33910 msgid ""
33911 "would cause virt-make-fs to think you wanted to use a partition type of "
33912 "C<input.tar> which is completely wrong.  To avoid this, use C<--> (a double "
33913 "dash) between options and the input file argument:"
33914 msgstr ""
33915
33916 #. type: verbatim
33917 #: ../tools/virt-make-fs.pl:269
33918 #, no-wrap
33919 msgid ""
33920 " virt-make-fs --partition -- input.tar ...\n"
33921 "\n"
33922 msgstr ""
33923
33924 #. type: textblock
33925 #: ../tools/virt-make-fs.pl:541
33926 msgid ""
33927 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<mkisofs(1)>, "
33928 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
33929 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
33930 msgstr ""
33931
33932 #. type: verbatim
33933 #: ../tools/virt-make-fs.pl:558
33934 #, no-wrap
33935 msgid ""
33936 " export LIBGUESTFS_DEBUG=1\n"
33937 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
33938 "\n"
33939 msgstr ""
33940
33941 #. type: textblock
33942 #: ../tools/virt-make-fs.pl:561
33943 msgid ""
33944 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
33945 "redhat.com/>"
33946 msgstr ""
33947
33948 #. type: textblock
33949 #: ../tools/virt-list-partitions.pl:32
33950 msgid ""
33951 "virt-list-partitions - List partitions in a virtual machine or disk image"
33952 msgstr ""
33953
33954 #. type: verbatim
33955 #: ../tools/virt-list-partitions.pl:36
33956 #, no-wrap
33957 msgid ""
33958 " virt-list-partitions [--options] domname\n"
33959 "\n"
33960 msgstr ""
33961
33962 #. type: verbatim
33963 #: ../tools/virt-list-partitions.pl:38
33964 #, no-wrap
33965 msgid ""
33966 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
33967 "\n"
33968 msgstr ""
33969
33970 #. type: textblock
33971 #: ../tools/virt-list-partitions.pl:45
33972 msgid ""
33973 "C<virt-list-partitions> is a command line tool to list the partitions that "
33974 "are contained in a virtual machine or disk image.  It is mainly useful as a "
33975 "first step to using L<virt-resize(1)>."
33976 msgstr ""
33977
33978 #. type: textblock
33979 #: ../tools/virt-list-partitions.pl:50
33980 msgid ""
33981 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
33982 "functionality.  For more complex cases you should look at the L<guestfish(1)"
33983 "> tool."
33984 msgstr ""
33985
33986 #. type: =item
33987 #: ../tools/virt-list-partitions.pl:107
33988 msgid "B<-h> | B<--human-readable>"
33989 msgstr ""
33990
33991 #. type: textblock
33992 #: ../tools/virt-list-partitions.pl:109
33993 msgid "Show sizes in human-readable form (eg. \"1G\")."
33994 msgstr ""
33995
33996 #. type: textblock
33997 #: ../tools/virt-list-partitions.pl:117
33998 msgid ""
33999 "With this option, C<virt-list-partitions> displays the type and size of each "
34000 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
34001 msgstr ""
34002
34003 #. type: =item
34004 #: ../tools/virt-list-partitions.pl:124
34005 msgid "B<-t> | B<--total>"
34006 msgstr ""
34007
34008 #. type: textblock
34009 #: ../tools/virt-list-partitions.pl:126
34010 msgid ""
34011 "Display the total size of each block device (as a separate row or rows)."
34012 msgstr ""
34013
34014 #. type: textblock
34015 #: ../tools/virt-list-partitions.pl:259
34016 msgid ""
34017 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
34018 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
34019 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34020 msgstr ""
34021
34022 #. type: textblock
34023 #: ../tools/virt-list-partitions.pl:275
34024 msgid "Copyright (C) 2009-2010 Red Hat Inc."
34025 msgstr ""