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-05-18 10:02+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-win-reg.pl:35 ../tools/virt-list-filesystems.pl:30
  24 #: ../tools/virt-tar.pl:31 ../tools/virt-make-fs.pl:35
  25 #: ../tools/virt-list-partitions.pl:30
  26 msgid "NAME"
  27 msgstr "名前"
  28
  29 # type: textblock
  30 #. type: textblock
  31 #: ../src/guestfs.pod:5
  32 msgid "guestfs - Library for accessing and modifying virtual machine images"
  33 msgstr ""
  34
  35 # type: =head1
  36 #. type: =head1
  37 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7
  38 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7
  39 #: ../tools/virt-win-reg.pl:39 ../tools/virt-list-filesystems.pl:34
  40 #: ../tools/virt-tar.pl:35 ../tools/virt-make-fs.pl:39
  41 #: ../tools/virt-list-partitions.pl:34
  42 msgid "SYNOPSIS"
  43 msgstr ""
  44
  45 # type: verbatim
  46 #. type: verbatim
  47 #: ../src/guestfs.pod:9
  48 #, no-wrap
  49 msgid ""
  50 " #include <guestfs.h>\n"
  51 " \n"
  52 msgstr ""
  53
  54 # type: verbatim
  55 #. type: verbatim
  56 #: ../src/guestfs.pod:11
  57 #, no-wrap
  58 msgid ""
  59 " guestfs_h *g = guestfs_create ();\n"
  60 " guestfs_add_drive (g, \"guest.img\");\n"
  61 " guestfs_launch (g);\n"
  62 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
  63 " guestfs_touch (g, \"/hello\");\n"
  64 " guestfs_umount (g, \"/\");\n"
  65 " guestfs_close (g);\n"
  66 "\n"
  67 msgstr ""
  68
  69 # type: verbatim
  70 #. type: verbatim
  71 #: ../src/guestfs.pod:19
  72 #, no-wrap
  73 msgid ""
  74 " cc prog.c -o prog -lguestfs\n"
  75 "or:\n"
  76 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
  77 "\n"
  78 msgstr ""
  79
  80 # type: =head1
  81 #. type: =head1
  82 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
  83 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
  84 #: ../tools/virt-win-reg.pl:63 ../tools/virt-list-filesystems.pl:40
  85 #: ../tools/virt-tar.pl:77 ../tools/virt-make-fs.pl:47
  86 #: ../tools/virt-list-partitions.pl:40
  87 msgid "DESCRIPTION"
  88 msgstr ""
  89
  90 # type: textblock
  91 #. type: textblock
  92 #: ../src/guestfs.pod:25
  93 msgid ""
  94 "Libguestfs is a library for accessing and modifying guest disk images.  "
  95 "Amongst the things this is good for: making batch configuration changes to "
  96 "guests, getting disk used/free statistics (see also: virt-df), migrating "
  97 "between virtualization systems (see also: virt-p2v), performing partial "
  98 "backups, performing partial guest clones, cloning guests and changing "
  99 "registry/UUID/hostname info, and much else besides."
 100 msgstr ""
 101
 102 # type: textblock
 103 #. type: textblock
 104 #: ../src/guestfs.pod:33
 105 msgid ""
 106 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
 107 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
 108 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
 109 "qcow2, vmdk."
 110 msgstr ""
 111
 112 # type: textblock
 113 #. type: textblock
 114 #: ../src/guestfs.pod:38
 115 msgid ""
 116 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
 117 "what filesystem is in each LV, etc.).  It can also run commands in the "
 118 "context of the guest.  Also you can access filesystems over FUSE."
 119 msgstr ""
 120
 121 # type: textblock
 122 #. type: textblock
 123 #: ../src/guestfs.pod:43
 124 msgid ""
 125 "Libguestfs is a library that can be linked with C and C++ management "
 126 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
 127 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
 128 "line."
 129 msgstr ""
 130
 131 # type: textblock
 132 #. type: textblock
 133 #: ../src/guestfs.pod:48
 134 msgid ""
 135 "You don't need to be root to use libguestfs, although obviously you do need "
 136 "enough permissions to access the disk images."
 137 msgstr ""
 138
 139 # type: textblock
 140 #. type: textblock
 141 #: ../src/guestfs.pod:51
 142 msgid ""
 143 "Libguestfs is a large API because it can do many things.  For a gentle "
 144 "introduction, please read the L</API OVERVIEW> section next."
 145 msgstr ""
 146
 147 # type: textblock
 148 #. type: textblock
 149 #: ../src/guestfs.pod:54
 150 msgid ""
 151 "There are also some example programs in the L<guestfs-examples(3)> manual "
 152 "page."
 153 msgstr ""
 154
 155 # type: =head1
 156 #. type: =head1
 157 #: ../src/guestfs.pod:57
 158 msgid "API OVERVIEW"
 159 msgstr ""
 160
 161 # type: textblock
 162 #. type: textblock
 163 #: ../src/guestfs.pod:59
 164 msgid ""
 165 "This section provides a gentler overview of the libguestfs API.  We also try "
 166 "to group API calls together, where that may not be obvious from reading "
 167 "about the individual calls in the main section of this manual."
 168 msgstr ""
 169
 170 # type: =head2
 171 #. type: =head2
 172 #: ../src/guestfs.pod:64
 173 msgid "HANDLES"
 174 msgstr ""
 175
 176 # type: textblock
 177 #. type: textblock
 178 #: ../src/guestfs.pod:66
 179 msgid ""
 180 "Before you can use libguestfs calls, you have to create a handle.  Then you "
 181 "must add at least one disk image to the handle, followed by launching the "
 182 "handle, then performing whatever operations you want, and finally closing "
 183 "the handle.  By convention we use the single letter C<g> for the name of the "
 184 "handle variable, although of course you can use any name you want."
 185 msgstr ""
 186
 187 # type: textblock
 188 #. type: textblock
 189 #: ../src/guestfs.pod:73
 190 msgid "The general structure of all libguestfs-using programs looks like this:"
 191 msgstr ""
 192
 193 # type: verbatim
 194 #. type: verbatim
 195 #: ../src/guestfs.pod:76
 196 #, no-wrap
 197 msgid ""
 198 " guestfs_h *g = guestfs_create ();\n"
 199 " \n"
 200 msgstr ""
 201
 202 # type: verbatim
 203 #. type: verbatim
 204 #: ../src/guestfs.pod:78
 205 #, no-wrap
 206 msgid ""
 207 " /* Call guestfs_add_drive additional times if there are\n"
 208 "  * multiple disk images.\n"
 209 "  */\n"
 210 " guestfs_add_drive (g, \"guest.img\");\n"
 211 " \n"
 212 msgstr ""
 213
 214 # type: verbatim
 215 #. type: verbatim
 216 #: ../src/guestfs.pod:83
 217 #, no-wrap
 218 msgid ""
 219 " /* Most manipulation calls won't work until you've launched\n"
 220 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
 221 "  * and _before_ other commands.\n"
 222 "  */\n"
 223 " guestfs_launch (g);\n"
 224 " \n"
 225 msgstr ""
 226
 227 # type: verbatim
 228 #. type: verbatim
 229 #: ../src/guestfs.pod:89
 230 #, no-wrap
 231 msgid ""
 232 " /* Now you can examine what partitions, LVs etc are available.\n"
 233 "  */\n"
 234 " char **partitions = guestfs_list_partitions (g);\n"
 235 " char **logvols = guestfs_lvs (g);\n"
 236 " \n"
 237 msgstr ""
 238
 239 # type: verbatim
 240 #. type: verbatim
 241 #: ../src/guestfs.pod:94
 242 #, no-wrap
 243 msgid ""
 244 " /* To access a filesystem in the image, you must mount it.\n"
 245 "  */\n"
 246 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
 247 " \n"
 248 msgstr ""
 249
 250 #. type: verbatim
 251 #: ../src/guestfs.pod:98
 252 #, no-wrap
 253 msgid ""
 254 " /* Now you can perform filesystem actions on the guest\n"
 255 "  * disk image.\n"
 256 "  */\n"
 257 " guestfs_touch (g, \"/hello\");\n"
 258 " \n"
 259 msgstr ""
 260
 261 # type: verbatim
 262 #. type: verbatim
 263 #: ../src/guestfs.pod:103
 264 #, no-wrap
 265 msgid ""
 266 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
 267 "  * it is done automatically when you close the handle.  See\n"
 268 "  * discussion of autosync in this page.\n"
 269 "  */\n"
 270 " guestfs_sync (g);\n"
 271 " \n"
 272 msgstr ""
 273
 274 # type: verbatim
 275 #. type: verbatim
 276 #: ../src/guestfs.pod:109
 277 #, no-wrap
 278 msgid ""
 279 " /* Close the handle 'g'. */\n"
 280 " guestfs_close (g);\n"
 281 "\n"
 282 msgstr ""
 283
 284 # type: textblock
 285 #. type: textblock
 286 #: ../src/guestfs.pod:112
 287 msgid ""
 288 "The code above doesn't include any error checking.  In real code you should "
 289 "check return values carefully for errors.  In general all functions that "
 290 "return integers return C<-1> on error, and all functions that return "
 291 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
 292 "how to handle errors, and consult the documentation for each function call "
 293 "below to see precisely how they return error indications.  See L<guestfs-"
 294 "examples(3)> for fully worked examples."
 295 msgstr ""
 296
 297 # type: =head2
 298 #. type: =head2
 299 #: ../src/guestfs.pod:121
 300 msgid "DISK IMAGES"
 301 msgstr ""
 302
 303 # type: textblock
 304 #. type: textblock
 305 #: ../src/guestfs.pod:123
 306 msgid ""
 307 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
 308 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
 309 "actual block device, or simply an empty file of zeroes that you have created "
 310 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
 311 "of these."
 312 msgstr ""
 313
 314 # type: textblock
 315 #. type: textblock
 316 #: ../src/guestfs.pod:129
 317 msgid ""
 318 "The call you should use in modern code for adding drives is L</"
 319 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
 320 "specifying that the format is raw, do:"
 321 msgstr ""
 322
 323 # type: verbatim
 324 #. type: verbatim
 325 #: ../src/guestfs.pod:133
 326 #, no-wrap
 327 msgid ""
 328 " guestfs_add_drive_opts (g, filename,\n"
 329 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 330 "                         -1);\n"
 331 "\n"
 332 msgstr ""
 333
 334 # type: textblock
 335 #. type: textblock
 336 #: ../src/guestfs.pod:137
 337 msgid "You can add a disk read-only using:"
 338 msgstr ""
 339
 340 # type: verbatim
 341 #. type: verbatim
 342 #: ../src/guestfs.pod:139
 343 #, no-wrap
 344 msgid ""
 345 " guestfs_add_drive_opts (g, filename,\n"
 346 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 347 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
 348 "                         -1);\n"
 349 "\n"
 350 msgstr ""
 351
 352 # type: textblock
 353 #. type: textblock
 354 #: ../src/guestfs.pod:144
 355 msgid ""
 356 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
 357 "libguestfs won't modify the file."
 358 msgstr ""
 359
 360 # type: textblock
 361 #. type: textblock
 362 #: ../src/guestfs.pod:147
 363 msgid ""
 364 "Be extremely cautious if the disk image is in use, eg. if it is being used "
 365 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
 366 "corruption, but adding it read-only is safe."
 367 msgstr ""
 368
 369 # type: textblock
 370 #. type: textblock
 371 #: ../src/guestfs.pod:151
 372 msgid ""
 373 "You must add at least one disk image, and you may add multiple disk images.  "
 374 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
 375 "first one you added), C</dev/sdb> (for the second one you added), etc."
 376 msgstr ""
 377
 378 # type: textblock
 379 #. type: textblock
 380 #: ../src/guestfs.pod:156
 381 msgid ""
 382 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
 383 "can call L</guestfs_list_devices> to get a list of the device names, in the "
 384 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
 385 msgstr ""
 386
 387 # type: =head2
 388 #. type: =head2
 389 #: ../src/guestfs.pod:161
 390 msgid "MOUNTING"
 391 msgstr ""
 392
 393 #. type: textblock
 394 #: ../src/guestfs.pod:163
 395 msgid ""
 396 "Before you can read or write files, create directories and so on in a disk "
 397 "image that contains filesystems, you have to mount those filesystems using "
 398 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
 399 "a disk image contains (for example) one partition with a filesystem on that "
 400 "partition, then you can mount it directly:"
 401 msgstr ""
 402
 403 #. type: verbatim
 404 #: ../src/guestfs.pod:170
 405 #, no-wrap
 406 msgid ""
 407 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
 408 "\n"
 409 msgstr ""
 410
 411 #. type: textblock
 412 #: ../src/guestfs.pod:172
 413 msgid ""
 414 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
 415 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
 416 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
 417 "that these are libguestfs virtual devices, and are nothing to do with host "
 418 "devices."
 419 msgstr ""
 420
 421 #. type: textblock
 422 #: ../src/guestfs.pod:178
 423 msgid ""
 424 "If you are given a disk image and you don't know what it contains then you "
 425 "have to find out.  Libguestfs can do that too: use L</"
 426 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
 427 "LVs, and either try mounting each to see what is mountable, or else examine "
 428 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
 429 "filesystems, use L</guestfs_list_filesystems>."
 430 msgstr ""
 431
 432 #. type: textblock
 433 #: ../src/guestfs.pod:186
 434 msgid ""
 435 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
 436 "L</INSPECTION> below).  But you might find it easier to look at higher level "
 437 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
 438 msgstr ""
 439
 440 #. type: textblock
 441 #: ../src/guestfs.pod:191
 442 msgid ""
 443 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
 444 "several other variations of the C<guestfs_mount_*> call."
 445 msgstr ""
 446
 447 # type: =head2
 448 #. type: =head2
 449 #: ../src/guestfs.pod:194
 450 msgid "FILESYSTEM ACCESS AND MODIFICATION"
 451 msgstr ""
 452
 453 # type: textblock
 454 #. type: textblock
 455 #: ../src/guestfs.pod:196
 456 msgid ""
 457 "The majority of the libguestfs API consists of fairly low-level calls for "
 458 "accessing and modifying the files, directories, symlinks etc on mounted "
 459 "filesystems.  There are over a hundred such calls which you can find listed "
 460 "in detail below in this man page, and we don't even pretend to cover them "
 461 "all in this overview."
 462 msgstr ""
 463
 464 # type: textblock
 465 #. type: textblock
 466 #: ../src/guestfs.pod:202
 467 msgid ""
 468 "Specify filenames as full paths, starting with C<\"/\"> and including the "
 469 "mount point."
 470 msgstr ""
 471
 472 # type: textblock
 473 #. type: textblock
 474 #: ../src/guestfs.pod:205
 475 msgid ""
 476 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
 477 "the file called C<\"etc/passwd\"> then you could do:"
 478 msgstr ""
 479
 480 # type: verbatim
 481 #. type: verbatim
 482 #: ../src/guestfs.pod:208
 483 #, no-wrap
 484 msgid ""
 485 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
 486 "\n"
 487 msgstr ""
 488
 489 # type: textblock
 490 #. type: textblock
 491 #: ../src/guestfs.pod:210
 492 msgid ""
 493 "This would return C<data> as a newly allocated buffer containing the full "
 494 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
 495 "or C<NULL> if there was an error."
 496 msgstr ""
 497
 498 # type: textblock
 499 #. type: textblock
 500 #: ../src/guestfs.pod:214
 501 msgid ""
 502 "As another example, to create a top-level directory on that filesystem "
 503 "called C<\"var\"> you would do:"
 504 msgstr ""
 505
 506 # type: verbatim
 507 #. type: verbatim
 508 #: ../src/guestfs.pod:217
 509 #, no-wrap
 510 msgid ""
 511 " guestfs_mkdir (g, \"/var\");\n"
 512 "\n"
 513 msgstr ""
 514
 515 # type: textblock
 516 #. type: textblock
 517 #: ../src/guestfs.pod:219
 518 msgid "To create a symlink you could do:"
 519 msgstr ""
 520
 521 # type: verbatim
 522 #. type: verbatim
 523 #: ../src/guestfs.pod:221
 524 #, no-wrap
 525 msgid ""
 526 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
 527 "               \"/etc/rc3.d/S30portmap\");\n"
 528 "\n"
 529 msgstr ""
 530
 531 # type: textblock
 532 #. type: textblock
 533 #: ../src/guestfs.pod:224
 534 msgid ""
 535 "Libguestfs will reject attempts to use relative paths and there is no "
 536 "concept of a current working directory."
 537 msgstr ""
 538
 539 # type: textblock
 540 #. type: textblock
 541 #: ../src/guestfs.pod:227
 542 msgid ""
 543 "Libguestfs can return errors in many situations: for example if the "
 544 "filesystem isn't writable, or if a file or directory that you requested "
 545 "doesn't exist.  If you are using the C API (documented here)  you have to "
 546 "check for those error conditions after each call.  (Other language bindings "
 547 "turn these errors into exceptions)."
 548 msgstr ""
 549
 550 # type: textblock
 551 #. type: textblock
 552 #: ../src/guestfs.pod:233
 553 msgid ""
 554 "File writes are affected by the per-handle umask, set by calling L</"
 555 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
 556 msgstr ""
 557
 558 # type: =head2
 559 #. type: =head2
 560 #: ../src/guestfs.pod:236
 561 msgid "PARTITIONING"
 562 msgstr ""
 563
 564 # type: textblock
 565 #. type: textblock
 566 #: ../src/guestfs.pod:238
 567 msgid ""
 568 "Libguestfs contains API calls to read, create and modify partition tables on "
 569 "disk images."
 570 msgstr ""
 571
 572 # type: textblock
 573 #. type: textblock
 574 #: ../src/guestfs.pod:241
 575 msgid ""
 576 "In the common case where you want to create a single partition covering the "
 577 "whole disk, you should use the L</guestfs_part_disk> call:"
 578 msgstr ""
 579
 580 # type: verbatim
 581 #. type: verbatim
 582 #: ../src/guestfs.pod:245
 583 #, no-wrap
 584 msgid ""
 585 " const char *parttype = \"mbr\";\n"
 586 " if (disk_is_larger_than_2TB)\n"
 587 "   parttype = \"gpt\";\n"
 588 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
 589 "\n"
 590 msgstr ""
 591
 592 # type: textblock
 593 #. type: textblock
 594 #: ../src/guestfs.pod:250
 595 msgid ""
 596 "Obviously this effectively wipes anything that was on that disk image before."
 597 msgstr ""
 598
 599 # type: =head2
 600 #. type: =head2
 601 #: ../src/guestfs.pod:253
 602 msgid "LVM2"
 603 msgstr ""
 604
 605 # type: textblock
 606 #. type: textblock
 607 #: ../src/guestfs.pod:255
 608 msgid ""
 609 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
 610 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
 611 "you familiarize yourself with the concepts of physical volumes, volume "
 612 "groups and logical volumes."
 613 msgstr ""
 614
 615 # type: textblock
 616 #. type: textblock
 617 #: ../src/guestfs.pod:260
 618 msgid ""
 619 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
 620 "tldp.org/HOWTO/LVM-HOWTO/>."
 621 msgstr ""
 622
 623 # type: =head2
 624 #. type: =head2
 625 #: ../src/guestfs.pod:263
 626 msgid "DOWNLOADING"
 627 msgstr ""
 628
 629 #. type: textblock
 630 #: ../src/guestfs.pod:265
 631 msgid ""
 632 "Use L</guestfs_cat> to download small, text only files.  This call is "
 633 "limited to files which are less than 2 MB and which cannot contain any ASCII "
 634 "NUL (C<\\0>) characters.  However the API is very simple to use."
 635 msgstr ""
 636
 637 # type: textblock
 638 #. type: textblock
 639 #: ../src/guestfs.pod:269
 640 msgid ""
 641 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
 642 "bit data, since it returns a (pointer, size) pair.  However it is still "
 643 "limited to \"small\" files, less than 2 MB."
 644 msgstr ""
 645
 646 # type: textblock
 647 #. type: textblock
 648 #: ../src/guestfs.pod:273
 649 msgid ""
 650 "L</guestfs_download> can be used to download any file, with no limits on "
 651 "content or size (even files larger than 4 GB)."
 652 msgstr ""
 653
 654 # type: textblock
 655 #. type: textblock
 656 #: ../src/guestfs.pod:276
 657 msgid ""
 658 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
 659 msgstr ""
 660
 661 # type: =head2
 662 #. type: =head2
 663 #: ../src/guestfs.pod:279
 664 msgid "UPLOADING"
 665 msgstr ""
 666
 667 # type: textblock
 668 #. type: textblock
 669 #: ../src/guestfs.pod:281
 670 msgid ""
 671 "It's often the case that you want to write a file or files to the disk image."
 672 msgstr ""
 673
 674 # type: textblock
 675 #. type: textblock
 676 #: ../src/guestfs.pod:284
 677 msgid ""
 678 "To write a small file with fixed content, use L</guestfs_write>.  To create "
 679 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
 680 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
 681 "of other functions for creating test files, for example L</guestfs_fill> and "
 682 "L</guestfs_fill_pattern>."
 683 msgstr ""
 684
 685 # type: textblock
 686 #. type: textblock
 687 #: ../src/guestfs.pod:290
 688 msgid ""
 689 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
 690 "file content or size (even files larger than 4 GB)."
 691 msgstr ""
 692
 693 # type: textblock
 694 #. type: textblock
 695 #: ../src/guestfs.pod:293
 696 msgid ""
 697 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
 698 msgstr ""
 699
 700 # type: textblock
 701 #. type: textblock
 702 #: ../src/guestfs.pod:295
 703 msgid ""
 704 "However the fastest way to upload I<large numbers of arbitrary files> is to "
 705 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
 706 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
 707 "in a predictable way (eg. adding it last after all other drives) then you "
 708 "can get the device name from L</guestfs_list_devices> and mount it directly "
 709 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
 710 "portable between kernel versions, and they don't support labels or UUIDs.  "
 711 "If you want to pre-build an image or you need to mount it using a label or "
 712 "UUID, use an ISO image instead."
 713 msgstr ""
 714
 715 # type: =head2
 716 #. type: =head2
 717 #: ../src/guestfs.pod:306
 718 msgid "COPYING"
 719 msgstr ""
 720
 721 # type: textblock
 722 #. type: textblock
 723 #: ../src/guestfs.pod:308
 724 msgid ""
 725 "There are various different commands for copying between files and devices "
 726 "and in and out of the guest filesystem.  These are summarised in the table "
 727 "below."
 728 msgstr ""
 729
 730 # type: =item
 731 #. type: =item
 732 #: ../src/guestfs.pod:314
 733 msgid "B<file> to B<file>"
 734 msgstr ""
 735
 736 # type: textblock
 737 #. type: textblock
 738 #: ../src/guestfs.pod:316
 739 msgid ""
 740 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
 741 "directories recursively."
 742 msgstr ""
 743
 744 # type: =item
 745 #. type: =item
 746 #: ../src/guestfs.pod:319
 747 msgid "B<file or device> to B<file or device>"
 748 msgstr ""
 749
 750 # type: textblock
 751 #. type: textblock
 752 #: ../src/guestfs.pod:321
 753 msgid ""
 754 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
 755 "devices in the guest."
 756 msgstr ""
 757
 758 # type: textblock
 759 #. type: textblock
 760 #: ../src/guestfs.pod:324
 761 msgid "Example: duplicate the contents of an LV:"
 762 msgstr ""
 763
 764 # type: verbatim
 765 #. type: verbatim
 766 #: ../src/guestfs.pod:326
 767 #, no-wrap
 768 msgid ""
 769 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
 770 "\n"
 771 msgstr ""
 772
 773 # type: textblock
 774 #. type: textblock
 775 #: ../src/guestfs.pod:328
 776 msgid ""
 777 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
 778 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
 779 "guestfs_copy_size>."
 780 msgstr ""
 781
 782 # type: =item
 783 #. type: =item
 784 #: ../src/guestfs.pod:332
 785 msgid "B<file on the host> to B<file or device>"
 786 msgstr ""
 787
 788 # type: textblock
 789 #. type: textblock
 790 #: ../src/guestfs.pod:334
 791 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
 792 msgstr ""
 793
 794 # type: =item
 795 #. type: =item
 796 #: ../src/guestfs.pod:336
 797 msgid "B<file or device> to B<file on the host>"
 798 msgstr ""
 799
 800 # type: textblock
 801 #. type: textblock
 802 #: ../src/guestfs.pod:338
 803 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
 804 msgstr ""
 805
 806 # type: =head2
 807 #. type: =head2
 808 #: ../src/guestfs.pod:342
 809 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
 810 msgstr ""
 811
 812 # type: textblock
 813 #. type: textblock
 814 #: ../src/guestfs.pod:344
 815 msgid ""
 816 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
 817 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
 818 "appears you can only upload and download to files.  However many Un*x-like "
 819 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
 820 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
 821 "and arbitrary file descriptor N."
 822 msgstr ""
 823
 824 # type: textblock
 825 #. type: textblock
 826 #: ../src/guestfs.pod:352
 827 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
 828 msgstr ""
 829
 830 #. type: verbatim
 831 #: ../src/guestfs.pod:355
 832 #, no-wrap
 833 msgid ""
 834 " guestfs_download (g, filename, \"/dev/stdout\");\n"
 835 "\n"
 836 msgstr ""
 837
 838 #. type: textblock
 839 #: ../src/guestfs.pod:357
 840 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
 841 msgstr ""
 842
 843 #. type: verbatim
 844 #: ../src/guestfs.pod:359
 845 #, no-wrap
 846 msgid ""
 847 " char devfd[64];\n"
 848 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
 849 " guestfs_tar_out (g, \"/\", devfd);\n"
 850 "\n"
 851 msgstr ""
 852
 853 # type: =head2
 854 #. type: =head2
 855 #: ../src/guestfs.pod:363
 856 msgid "LISTING FILES"
 857 msgstr ""
 858
 859 # type: textblock
 860 #. type: textblock
 861 #: ../src/guestfs.pod:365
 862 msgid ""
 863 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
 864 "L<guestfish(1)>-equivalent command C<ll>)."
 865 msgstr ""
 866
 867 # type: textblock
 868 #. type: textblock
 869 #: ../src/guestfs.pod:368
 870 msgid ""
 871 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
 872 "programs, as a flat list of strings."
 873 msgstr ""
 874
 875 # type: textblock
 876 #. type: textblock
 877 #: ../src/guestfs.pod:371
 878 msgid ""
 879 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
 880 "directory, plus additional information about each one.  It is more "
 881 "equivalent to using the L<readdir(3)> call on a local filesystem."
 882 msgstr ""
 883
 884 # type: textblock
 885 #. type: textblock
 886 #: ../src/guestfs.pod:375
 887 msgid ""
 888 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
 889 msgstr ""
 890
 891 # type: =head2
 892 #. type: =head2
 893 #: ../src/guestfs.pod:378
 894 msgid "RUNNING COMMANDS"
 895 msgstr ""
 896
 897 # type: textblock
 898 #. type: textblock
 899 #: ../src/guestfs.pod:380
 900 msgid ""
 901 "Although libguestfs is primarily an API for manipulating files inside guest "
 902 "images, we also provide some limited facilities for running commands inside "
 903 "guests."
 904 msgstr ""
 905
 906 # type: textblock
 907 #. type: textblock
 908 #: ../src/guestfs.pod:384
 909 msgid "There are many limitations to this:"
 910 msgstr ""
 911
 912 # type: =item
 913 #. type: =item
 914 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
 915 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
 916 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064
 917 #: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077
 918 #: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112
 919 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142
 920 #: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154
 921 #: ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652
 922 #: ../src/guestfs.pod:1754 ../src/guestfs.pod:1759 ../src/guestfs.pod:1763
 923 #: ../src/guestfs.pod:1773 ../src/guestfs.pod:2008 ../src/guestfs.pod:2013
 924 #: ../src/guestfs.pod:2019 ../src/guestfs.pod:2027 ../src/guestfs.pod:2381
 925 #: ../src/guestfs.pod:2387 ../src/guestfs.pod:2392 ../src/guestfs.pod:2398
 926 #: ../src/guestfs.pod:2967 ../src/guestfs.pod:2971 ../src/guestfs.pod:2975
 927 #: ../src/guestfs.pod:2979 ../src/guestfs-actions.pod:15
 928 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:583
 929 #: ../src/guestfs-actions.pod:591 ../src/guestfs-actions.pod:598
 930 #: ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:1603
 931 #: ../src/guestfs-actions.pod:1607 ../src/guestfs-actions.pod:1611
 932 #: ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1623
 933 #: ../src/guestfs-actions.pod:1627 ../src/guestfs-actions.pod:1631
 934 #: ../src/guestfs-actions.pod:1641 ../src/guestfs-actions.pod:1645
 935 #: ../src/guestfs-actions.pod:1649 ../src/guestfs-actions.pod:1787
 936 #: ../src/guestfs-actions.pod:1791 ../src/guestfs-actions.pod:1796
 937 #: ../src/guestfs-actions.pod:1801 ../src/guestfs-actions.pod:1862
 938 #: ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:1871
 939 #: ../fish/guestfish.pod:445 ../fish/guestfish.pod:449
 940 #: ../fish/guestfish.pod:453 ../fish/guestfish.pod:457
 941 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
 942 #: ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393
 943 #: ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407
 944 #: ../fish/guestfish-actions.pod:1074 ../fish/guestfish-actions.pod:1078
 945 #: ../fish/guestfish-actions.pod:1082 ../fish/guestfish-actions.pod:1086
 946 #: ../fish/guestfish-actions.pod:1094 ../fish/guestfish-actions.pod:1098
 947 #: ../fish/guestfish-actions.pod:1102 ../fish/guestfish-actions.pod:1112
 948 #: ../fish/guestfish-actions.pod:1116 ../fish/guestfish-actions.pod:1120
 949 #: ../fish/guestfish-actions.pod:1210 ../fish/guestfish-actions.pod:1214
 950 #: ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1224
 951 #: ../fish/guestfish-actions.pod:1266 ../fish/guestfish-actions.pod:1270
 952 #: ../fish/guestfish-actions.pod:1275 ../tools/virt-win-reg.pl:195
 953 #: ../tools/virt-win-reg.pl:200 ../tools/virt-win-reg.pl:206
 954 #: ../tools/virt-win-reg.pl:708 ../tools/virt-win-reg.pl:714
 955 #: ../tools/virt-win-reg.pl:720
 956 msgid "*"
 957 msgstr ""
 958
 959 # type: textblock
 960 #. type: textblock
 961 #: ../src/guestfs.pod:390
 962 msgid ""
 963 "The kernel version that the command runs under will be different from what "
 964 "it expects."
 965 msgstr ""
 966
 967 # type: textblock
 968 #. type: textblock
 969 #: ../src/guestfs.pod:395
 970 msgid ""
 971 "If the command needs to communicate with daemons, then most likely they "
 972 "won't be running."
 973 msgstr ""
 974
 975 # type: textblock
 976 #. type: textblock
 977 #: ../src/guestfs.pod:400
 978 msgid "The command will be running in limited memory."
 979 msgstr ""
 980
 981 # type: textblock
 982 #. type: textblock
 983 #: ../src/guestfs.pod:404
 984 msgid ""
 985 "The network may not be available unless you enable it (see L</"
 986 "guestfs_set_network>)."
 987 msgstr ""
 988
 989 # type: textblock
 990 #. type: textblock
 991 #: ../src/guestfs.pod:409
 992 msgid "Only supports Linux guests (not Windows, BSD, etc)."
 993 msgstr ""
 994
 995 # type: textblock
 996 #. type: textblock
 997 #: ../src/guestfs.pod:413
 998 msgid ""
 999 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1000 msgstr ""
1001
1002 # type: textblock
1003 #. type: textblock
1004 #: ../src/guestfs.pod:418
1005 msgid ""
1006 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1007 "See L</SELINUX> in this manpage."
1008 msgstr ""
1009
1010 # type: textblock
1011 #. type: textblock
1012 #: ../src/guestfs.pod:423
1013 msgid ""
1014 "I<Security:> It is not safe to run commands from untrusted, possibly "
1015 "malicious guests.  These commands may attempt to exploit your program by "
1016 "sending unexpected output.  They could also try to exploit the Linux kernel "
1017 "or qemu provided by the libguestfs appliance.  They could use the network "
1018 "provided by the libguestfs appliance to bypass ordinary network partitions "
1019 "and firewalls.  They could use the elevated privileges or different SELinux "
1020 "context of your program to their advantage."
1021 msgstr ""
1022
1023 # type: textblock
1024 #. type: textblock
1025 #: ../src/guestfs.pod:432
1026 msgid ""
1027 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1028 "(a script which runs when the guest next boots normally), and to have this "
1029 "script run the commands you want in the normal context of the running guest, "
1030 "network security and so on.  For information about other security issues, "
1031 "see L</SECURITY>."
1032 msgstr ""
1033
1034 # type: textblock
1035 #. type: textblock
1036 #: ../src/guestfs.pod:440
1037 msgid ""
1038 "The two main API calls to run commands are L</guestfs_command> and L</"
1039 "guestfs_sh> (there are also variations)."
1040 msgstr ""
1041
1042 # type: textblock
1043 #. type: textblock
1044 #: ../src/guestfs.pod:443
1045 msgid ""
1046 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1047 "shell globs, redirections, etc will work."
1048 msgstr ""
1049
1050 # type: =head2
1051 #. type: =head2
1052 #: ../src/guestfs.pod:446
1053 msgid "CONFIGURATION FILES"
1054 msgstr ""
1055
1056 # type: textblock
1057 #. type: textblock
1058 #: ../src/guestfs.pod:448
1059 msgid ""
1060 "To read and write configuration files in Linux guest filesystems, we "
1061 "strongly recommend using Augeas.  For example, Augeas understands how to "
1062 "read and write, say, a Linux shadow password file or X.org configuration "
1063 "file, and so avoids you having to write that code."
1064 msgstr ""
1065
1066 # type: textblock
1067 #. type: textblock
1068 #: ../src/guestfs.pod:453
1069 msgid ""
1070 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1071 "document Augeas itself here because there is excellent documentation on the "
1072 "L<http://augeas.net/> website."
1073 msgstr ""
1074
1075 # type: textblock
1076 #. type: textblock
1077 #: ../src/guestfs.pod:457
1078 msgid ""
1079 "If you don't want to use Augeas (you fool!) then try calling L</"
1080 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1081 "over."
1082 msgstr ""
1083
1084 # type: =head2
1085 #. type: =head2
1086 #: ../src/guestfs.pod:461
1087 msgid "SELINUX"
1088 msgstr ""
1089
1090 # type: textblock
1091 #. type: textblock
1092 #: ../src/guestfs.pod:463
1093 msgid ""
1094 "We support SELinux guests.  To ensure that labeling happens correctly in "
1095 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1096 msgstr ""
1097
1098 # type: =item
1099 #. type: =item
1100 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395
1101 #: ../src/guestfs.pod:2426
1102 msgid "1."
1103 msgstr ""
1104
1105 # type: textblock
1106 #. type: textblock
1107 #: ../src/guestfs.pod:471
1108 msgid "Before launching, do:"
1109 msgstr ""
1110
1111 # type: verbatim
1112 #. type: verbatim
1113 #: ../src/guestfs.pod:473
1114 #, no-wrap
1115 msgid ""
1116 " guestfs_set_selinux (g, 1);\n"
1117 "\n"
1118 msgstr ""
1119
1120 # type: =item
1121 #. type: =item
1122 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399
1123 #: ../src/guestfs.pod:2451
1124 msgid "2."
1125 msgstr ""
1126
1127 # type: textblock
1128 #. type: textblock
1129 #: ../src/guestfs.pod:477
1130 msgid ""
1131 "After mounting the guest's filesystem(s), load the policy.  This is best "
1132 "done by running the L<load_policy(8)> command in the guest itself:"
1133 msgstr ""
1134
1135 # type: verbatim
1136 #. type: verbatim
1137 #: ../src/guestfs.pod:481
1138 #, no-wrap
1139 msgid ""
1140 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1141 "\n"
1142 msgstr ""
1143
1144 # type: textblock
1145 #. type: textblock
1146 #: ../src/guestfs.pod:483
1147 msgid ""
1148 "(Older versions of C<load_policy> require you to specify the name of the "
1149 "policy file)."
1150 msgstr ""
1151
1152 # type: =item
1153 #. type: =item
1154 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1405
1155 msgid "3."
1156 msgstr ""
1157
1158 # type: textblock
1159 #. type: textblock
1160 #: ../src/guestfs.pod:488
1161 msgid ""
1162 "Optionally, set the security context for the API.  The correct security "
1163 "context to use can only be known by inspecting the guest.  As an example:"
1164 msgstr ""
1165
1166 # type: verbatim
1167 #. type: verbatim
1168 #: ../src/guestfs.pod:492
1169 #, no-wrap
1170 msgid ""
1171 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1172 "\n"
1173 msgstr ""
1174
1175 # type: textblock
1176 #. type: textblock
1177 #: ../src/guestfs.pod:496
1178 msgid "This will work for running commands and editing existing files."
1179 msgstr ""
1180
1181 # type: textblock
1182 #. type: textblock
1183 #: ../src/guestfs.pod:498
1184 msgid ""
1185 "When new files are created, you may need to label them explicitly, for "
1186 "example by running the external command C<restorecon pathname>."
1187 msgstr ""
1188
1189 # type: =head2
1190 #. type: =head2
1191 #: ../src/guestfs.pod:502
1192 msgid "UMASK"
1193 msgstr ""
1194
1195 # type: textblock
1196 #. type: textblock
1197 #: ../src/guestfs.pod:504
1198 msgid ""
1199 "Certain calls are affected by the current file mode creation mask (the "
1200 "\"umask\").  In particular ones which create files or directories, such as "
1201 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1202 "either the default mode that the file is created with or modifies the mode "
1203 "that you supply."
1204 msgstr ""
1205
1206 # type: textblock
1207 #. type: textblock
1208 #: ../src/guestfs.pod:510
1209 msgid ""
1210 "The default umask is C<022>, so files are created with modes such as C<0644> "
1211 "and directories with C<0755>."
1212 msgstr ""
1213
1214 # type: textblock
1215 #. type: textblock
1216 #: ../src/guestfs.pod:513
1217 msgid ""
1218 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1219 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1220 "guestfs_chmod> after creating each file or directory."
1221 msgstr ""
1222
1223 # type: textblock
1224 #. type: textblock
1225 #: ../src/guestfs.pod:517
1226 msgid "For more information about umask, see L<umask(2)>."
1227 msgstr ""
1228
1229 # type: =head1
1230 #. type: =head1
1231 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:767
1232 msgid "ENCRYPTED DISKS"
1233 msgstr ""
1234
1235 # type: textblock
1236 #. type: textblock
1237 #: ../src/guestfs.pod:521
1238 msgid ""
1239 "Libguestfs allows you to access Linux guests which have been encrypted using "
1240 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1241 "standard.  This includes nearly all whole disk encryption systems used by "
1242 "modern Linux guests."
1243 msgstr ""
1244
1245 # type: textblock
1246 #. type: textblock
1247 #: ../src/guestfs.pod:527
1248 msgid ""
1249 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1250 "returns the string C<crypto_LUKS>)."
1251 msgstr ""
1252
1253 # type: textblock
1254 #. type: textblock
1255 #: ../src/guestfs.pod:530
1256 msgid ""
1257 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1258 "will require the passphrase!"
1259 msgstr ""
1260
1261 # type: textblock
1262 #. type: textblock
1263 #: ../src/guestfs.pod:533
1264 msgid ""
1265 "Opening a LUKS device creates a new device mapper device called C</dev/"
1266 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1267 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1268 "from and encrypted to the underlying block device respectively."
1269 msgstr ""
1270
1271 # type: textblock
1272 #. type: textblock
1273 #: ../src/guestfs.pod:539
1274 msgid ""
1275 "LVM volume groups on the device can be made visible by calling L</"
1276 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1277 "(s) can now be mounted in the usual way."
1278 msgstr ""
1279
1280 # type: textblock
1281 #. type: textblock
1282 #: ../src/guestfs.pod:543
1283 msgid ""
1284 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1285 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1286 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1287 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1288 "underlying encrypted block device)."
1289 msgstr ""
1290
1291 # type: =head2
1292 #. type: =head2
1293 #: ../src/guestfs.pod:550
1294 msgid "INSPECTION"
1295 msgstr ""
1296
1297 #. type: textblock
1298 #: ../src/guestfs.pod:552
1299 msgid ""
1300 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1301 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1302 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1303 "version 1.5.3 the most frequently used part of this library has been "
1304 "rewritten in C and moved into the core code)."
1305 msgstr ""
1306
1307 # type: textblock
1308 #. type: textblock
1309 #: ../src/guestfs.pod:559
1310 msgid ""
1311 "Add all disks belonging to the unknown virtual machine and call L</"
1312 "guestfs_launch> in the usual way."
1313 msgstr ""
1314
1315 # type: textblock
1316 #. type: textblock
1317 #: ../src/guestfs.pod:562
1318 msgid ""
1319 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1320 "and certain heuristics, and returns a list of operating systems that were "
1321 "found.  An empty list means none were found.  A single element is the root "
1322 "filesystem of the operating system.  For dual- or multi-boot guests, "
1323 "multiple roots can be returned, each one corresponding to a separate "
1324 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1325 "world of virtualization, but since this scenario can happen, we have built "
1326 "libguestfs to deal with it.)"
1327 msgstr ""
1328
1329 # type: textblock
1330 #. type: textblock
1331 #: ../src/guestfs.pod:571
1332 msgid ""
1333 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1334 "to get additional details about that operating system.  For example, call L</"
1335 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1336 "Windows and Linux-based operating systems respectively."
1337 msgstr ""
1338
1339 # type: textblock
1340 #. type: textblock
1341 #: ../src/guestfs.pod:577
1342 msgid ""
1343 "Un*x-like and Linux-based operating systems usually consist of several "
1344 "filesystems which are mounted at boot time (for example, a separate boot "
1345 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1346 "filesystems correspond to mount points.  Call "
1347 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1348 "hash table like this example:"
1349 msgstr ""
1350
1351 # type: verbatim
1352 #. type: verbatim
1353 #: ../src/guestfs.pod:584
1354 #, no-wrap
1355 msgid ""
1356 " /boot => /dev/sda1\n"
1357 " /     => /dev/vg_guest/lv_root\n"
1358 " /usr  => /dev/vg_guest/lv_usr\n"
1359 "\n"
1360 msgstr ""
1361
1362 # type: textblock
1363 #. type: textblock
1364 #: ../src/guestfs.pod:588
1365 msgid ""
1366 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1367 "filesystems as suggested."
1368 msgstr ""
1369
1370 # type: textblock
1371 #. type: textblock
1372 #: ../src/guestfs.pod:591
1373 msgid ""
1374 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1375 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1376 msgstr ""
1377
1378 # type: textblock
1379 #. type: textblock
1380 #: ../src/guestfs.pod:595
1381 msgid ""
1382 "Inspection currently only works for some common operating systems.  "
1383 "Contributors are welcome to send patches for other operating systems that we "
1384 "currently cannot detect."
1385 msgstr ""
1386
1387 # type: textblock
1388 #. type: textblock
1389 #: ../src/guestfs.pod:599
1390 msgid ""
1391 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1392 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1393 "encrypted devices."
1394 msgstr ""
1395
1396 # type: textblock
1397 #. type: textblock
1398 #: ../src/guestfs.pod:603
1399 msgid ""
1400 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1401 "inspection and caches the results in the guest handle.  Subsequent calls to "
1402 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1403 "read the disks.  If you change the content of the guest disks, you can redo "
1404 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1405 "guestfs_inspect_list_applications> works a little differently from the other "
1406 "calls and does read the disks.  See documentation for that function for "
1407 "details)."
1408 msgstr ""
1409
1410 #. type: =head3
1411 #: ../src/guestfs.pod:612
1412 msgid "INSPECTING INSTALL DISKS"
1413 msgstr ""
1414
1415 #. type: textblock
1416 #: ../src/guestfs.pod:614
1417 msgid ""
1418 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1419 "CDs and more."
1420 msgstr ""
1421
1422 #. type: textblock
1423 #: ../src/guestfs.pod:617
1424 msgid ""
1425 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1426 "system, which currently can be C<installed> (a regular operating system) or "
1427 "C<installer> (some sort of install disk)."
1428 msgstr ""
1429
1430 #. type: textblock
1431 #: ../src/guestfs.pod:621
1432 msgid ""
1433 "Further information is available about the operating system that can be "
1434 "installed using the regular inspection APIs like L</"
1435 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
1436 msgstr ""
1437
1438 #. type: textblock
1439 #: ../src/guestfs.pod:626
1440 msgid ""
1441 "Some additional information specific to installer disks is also available "
1442 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
1443 "guestfs_inspect_is_multipart> calls."
1444 msgstr ""
1445
1446 # type: =head2
1447 #. type: =head2
1448 #: ../src/guestfs.pod:631
1449 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1450 msgstr ""
1451
1452 # type: textblock
1453 #. type: textblock
1454 #: ../src/guestfs.pod:633
1455 msgid ""
1456 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1457 "ntfs-3g.org/> driver."
1458 msgstr ""
1459
1460 # type: =head3
1461 #. type: =head3
1462 #: ../src/guestfs.pod:636
1463 msgid "DRIVE LETTERS AND PATHS"
1464 msgstr ""
1465
1466 # type: textblock
1467 #. type: textblock
1468 #: ../src/guestfs.pod:638
1469 msgid ""
1470 "DOS and Windows still use drive letters, and the filesystems are always "
1471 "treated as case insensitive by Windows itself, and therefore you might find "
1472 "a Windows configuration file referring to a path like C<c:\\windows"
1473 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1474 "might be referred to as C</WINDOWS/System32>."
1475 msgstr ""
1476
1477 #. type: textblock
1478 #: ../src/guestfs.pod:644
1479 msgid ""
1480 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
1481 "L</guestfs_inspect_get_drive_mappings>)"
1482 msgstr ""
1483
1484 #. type: textblock
1485 #: ../src/guestfs.pod:647
1486 msgid ""
1487 "Dealing with separator characters (backslash vs forward slash) is outside "
1488 "the scope of libguestfs, but usually a simple character replacement will "
1489 "work."
1490 msgstr ""
1491
1492 #. type: textblock
1493 #: ../src/guestfs.pod:651
1494 msgid ""
1495 "To resolve the case insensitivity of paths, call L</"
1496 "guestfs_case_sensitive_path>."
1497 msgstr ""
1498
1499 # type: =head3
1500 #. type: =head3
1501 #: ../src/guestfs.pod:654
1502 msgid "ACCESSING THE WINDOWS REGISTRY"
1503 msgstr ""
1504
1505 # type: textblock
1506 #. type: textblock
1507 #: ../src/guestfs.pod:656
1508 msgid ""
1509 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1510 "files, through the library C<hivex> which is part of the libguestfs project "
1511 "although ships as a separate tarball.  You have to locate and download the "
1512 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1513 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1514 "reg(1)> for more help on this issue."
1515 msgstr ""
1516
1517 # type: =head3
1518 #. type: =head3
1519 #: ../src/guestfs.pod:664
1520 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1521 msgstr ""
1522
1523 # type: textblock
1524 #. type: textblock
1525 #: ../src/guestfs.pod:666
1526 msgid ""
1527 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1528 "provide something which looks like a Linux symlink.  The way it tries to do "
1529 "the rewriting is described here:"
1530 msgstr ""
1531
1532 # type: textblock
1533 #. type: textblock
1534 #: ../src/guestfs.pod:670
1535 msgid ""
1536 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1537 "symbolic-links/>"
1538 msgstr ""
1539
1540 # type: textblock
1541 #. type: textblock
1542 #: ../src/guestfs.pod:672
1543 msgid ""
1544 "The essential problem is that ntfs-3g simply does not have enough "
1545 "information to do a correct job.  NTFS links can contain drive letters and "
1546 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1547 "It is almost certainly the case that libguestfs callers should ignore what "
1548 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1549 msgstr ""
1550
1551 # type: textblock
1552 #. type: textblock
1553 #: ../src/guestfs.pod:679
1554 msgid ""
1555 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1556 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1557 "attribute, and read the raw reparse data from that (you can find the format "
1558 "documented in various places around the web)."
1559 msgstr ""
1560
1561 # type: =head3
1562 #. type: =head3
1563 #: ../src/guestfs.pod:684
1564 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1565 msgstr ""
1566
1567 # type: textblock
1568 #. type: textblock
1569 #: ../src/guestfs.pod:686
1570 msgid ""
1571 "There are other useful extended attributes that can be read from ntfs-3g "
1572 "filesystems (using L</guestfs_getxattr>).  See:"
1573 msgstr ""
1574
1575 # type: textblock
1576 #. type: textblock
1577 #: ../src/guestfs.pod:689
1578 msgid ""
1579 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1580 msgstr ""
1581
1582 # type: =head2
1583 #. type: =head2
1584 #: ../src/guestfs.pod:691
1585 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1586 msgstr ""
1587
1588 # type: textblock
1589 #. type: textblock
1590 #: ../src/guestfs.pod:693
1591 msgid ""
1592 "Although we don't want to discourage you from using the C API, we will "
1593 "mention here that the same API is also available in other languages."
1594 msgstr ""
1595
1596 #. type: textblock
1597 #: ../src/guestfs.pod:696
1598 msgid ""
1599 "The API is broadly identical in all supported languages.  This means that "
1600 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1601 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1602 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1603 "each language."
1604 msgstr ""
1605
1606 # type: textblock
1607 #. type: textblock
1608 #: ../src/guestfs.pod:702
1609 msgid ""
1610 "Error messages are automatically transformed into exceptions if the language "
1611 "supports it."
1612 msgstr ""
1613
1614 # type: textblock
1615 #. type: textblock
1616 #: ../src/guestfs.pod:705
1617 msgid ""
1618 "We don't try to \"object orientify\" parts of the API in OO languages, "
1619 "although contributors are welcome to write higher level APIs above what we "
1620 "provide in their favourite languages if they wish."
1621 msgstr ""
1622
1623 # type: =item
1624 #. type: =item
1625 #: ../src/guestfs.pod:711
1626 msgid "B<C++>"
1627 msgstr ""
1628
1629 # type: textblock
1630 #. type: textblock
1631 #: ../src/guestfs.pod:713
1632 msgid ""
1633 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1634 "identical to the C API.  C++ classes and exceptions are not used."
1635 msgstr ""
1636
1637 # type: =item
1638 #. type: =item
1639 #: ../src/guestfs.pod:717
1640 msgid "B<C#>"
1641 msgstr ""
1642
1643 # type: textblock
1644 #. type: textblock
1645 #: ../src/guestfs.pod:719
1646 msgid ""
1647 "The C# bindings are highly experimental.  Please read the warnings at the "
1648 "top of C<csharp/Libguestfs.cs>."
1649 msgstr ""
1650
1651 # type: =item
1652 #. type: =item
1653 #: ../src/guestfs.pod:722
1654 msgid "B<Haskell>"
1655 msgstr ""
1656
1657 # type: textblock
1658 #. type: textblock
1659 #: ../src/guestfs.pod:724
1660 msgid ""
1661 "This is the only language binding that is working but incomplete.  Only "
1662 "calls which return simple integers have been bound in Haskell, and we are "
1663 "looking for help to complete this binding."
1664 msgstr ""
1665
1666 # type: =item
1667 #. type: =item
1668 #: ../src/guestfs.pod:728
1669 msgid "B<Java>"
1670 msgstr ""
1671
1672 # type: textblock
1673 #. type: textblock
1674 #: ../src/guestfs.pod:730
1675 msgid ""
1676 "Full documentation is contained in the Javadoc which is distributed with "
1677 "libguestfs."
1678 msgstr ""
1679
1680 # type: =item
1681 #. type: =item
1682 #: ../src/guestfs.pod:733
1683 msgid "B<OCaml>"
1684 msgstr ""
1685
1686 #. type: textblock
1687 #: ../src/guestfs.pod:735
1688 msgid "See L<guestfs-ocaml(3)>."
1689 msgstr ""
1690
1691 # type: =item
1692 #. type: =item
1693 #: ../src/guestfs.pod:737
1694 msgid "B<Perl>"
1695 msgstr ""
1696
1697 #. type: textblock
1698 #: ../src/guestfs.pod:739
1699 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1700 msgstr ""
1701
1702 # type: =item
1703 #. type: =item
1704 #: ../src/guestfs.pod:741
1705 msgid "B<PHP>"
1706 msgstr ""
1707
1708 # type: textblock
1709 #. type: textblock
1710 #: ../src/guestfs.pod:743
1711 msgid ""
1712 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1713 "the php-libguestfs package for your distribution."
1714 msgstr ""
1715
1716 # type: textblock
1717 #. type: textblock
1718 #: ../src/guestfs.pod:746
1719 msgid "The PHP binding only works correctly on 64 bit machines."
1720 msgstr ""
1721
1722 # type: =item
1723 #. type: =item
1724 #: ../src/guestfs.pod:748
1725 msgid "B<Python>"
1726 msgstr ""
1727
1728 #. type: textblock
1729 #: ../src/guestfs.pod:750
1730 msgid "See L<guestfs-python(3)>."
1731 msgstr ""
1732
1733 # type: =item
1734 #. type: =item
1735 #: ../src/guestfs.pod:752
1736 msgid "B<Ruby>"
1737 msgstr ""
1738
1739 #. type: textblock
1740 #: ../src/guestfs.pod:754
1741 msgid "See L<guestfs-ruby(3)>."
1742 msgstr ""
1743
1744 # type: =item
1745 #. type: =item
1746 #: ../src/guestfs.pod:756
1747 msgid "B<shell scripts>"
1748 msgstr ""
1749
1750 #. type: textblock
1751 #: ../src/guestfs.pod:758
1752 msgid "See L<guestfish(1)>."
1753 msgstr ""
1754
1755 # type: =head2
1756 #. type: =head2
1757 #: ../src/guestfs.pod:762
1758 msgid "LIBGUESTFS GOTCHAS"
1759 msgstr ""
1760
1761 # type: textblock
1762 #. type: textblock
1763 #: ../src/guestfs.pod:764
1764 msgid ""
1765 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1766 "system [...] that works in the way it is documented but is counterintuitive "
1767 "and almost invites mistakes.\""
1768 msgstr ""
1769
1770 # type: textblock
1771 #. type: textblock
1772 #: ../src/guestfs.pod:768
1773 msgid ""
1774 "Since we developed libguestfs and the associated tools, there are several "
1775 "things we would have designed differently, but are now stuck with for "
1776 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1777 "release, you can expect these to change.  Beware of them."
1778 msgstr ""
1779
1780 # type: =item
1781 #. type: =item
1782 #: ../src/guestfs.pod:776
1783 msgid "Autosync / forgetting to sync."
1784 msgstr ""
1785
1786 #. type: textblock
1787 #: ../src/guestfs.pod:778
1788 msgid ""
1789 "I<Update:> Autosync is enabled by default for all API users starting from "
1790 "libguestfs 1.5.24.  This section only applies to older versions."
1791 msgstr ""
1792
1793 # type: textblock
1794 #. type: textblock
1795 #: ../src/guestfs.pod:781
1796 msgid ""
1797 "When modifying a filesystem from C or another language, you B<must> unmount "
1798 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1799 "libguestfs handle.  You can also call:"
1800 msgstr ""
1801
1802 # type: verbatim
1803 #. type: verbatim
1804 #: ../src/guestfs.pod:785
1805 #, no-wrap
1806 msgid ""
1807 " guestfs_set_autosync (g, 1);\n"
1808 "\n"
1809 msgstr ""
1810
1811 # type: textblock
1812 #. type: textblock
1813 #: ../src/guestfs.pod:787
1814 msgid ""
1815 "to have the unmount/sync done automatically for you when the handle 'g' is "
1816 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1817 msgstr ""
1818
1819 # type: textblock
1820 #. type: textblock
1821 #: ../src/guestfs.pod:791
1822 msgid ""
1823 "If you forget to do this, then it is entirely possible that your changes "
1824 "won't be written out, or will be partially written, or (very rarely) that "
1825 "you'll get disk corruption."
1826 msgstr ""
1827
1828 # type: textblock
1829 #. type: textblock
1830 #: ../src/guestfs.pod:795
1831 msgid ""
1832 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1833 "guestfish scripts that forget to sync will work just fine, which can make "
1834 "this very puzzling if you are trying to debug a problem."
1835 msgstr ""
1836
1837 # type: =item
1838 #. type: =item
1839 #: ../src/guestfs.pod:799
1840 msgid "Mount option C<-o sync> should not be the default."
1841 msgstr ""
1842
1843 # type: textblock
1844 #. type: textblock
1845 #: ../src/guestfs.pod:801
1846 msgid ""
1847 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1848 "However C<-o sync> does not add any reliability benefit, but does have a "
1849 "very large performance impact."
1850 msgstr ""
1851
1852 # type: textblock
1853 #. type: textblock
1854 #: ../src/guestfs.pod:805
1855 msgid ""
1856 "The work around is to use L</guestfs_mount_options> and set the mount "
1857 "options that you actually want to use."
1858 msgstr ""
1859
1860 # type: =item
1861 #. type: =item
1862 #: ../src/guestfs.pod:808
1863 msgid "Read-only should be the default."
1864 msgstr ""
1865
1866 # type: textblock
1867 #. type: textblock
1868 #: ../src/guestfs.pod:810
1869 msgid ""
1870 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1871 "specify I<--rw> if you want to make changes to the image."
1872 msgstr ""
1873
1874 # type: textblock
1875 #. type: textblock
1876 #: ../src/guestfs.pod:813
1877 msgid "This would reduce the potential to corrupt live VM images."
1878 msgstr ""
1879
1880 # type: textblock
1881 #. type: textblock
1882 #: ../src/guestfs.pod:815
1883 msgid ""
1884 "Note that many filesystems change the disk when you just mount and unmount, "
1885 "even if you didn't perform any writes.  You need to use L</"
1886 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1887 msgstr ""
1888
1889 # type: =item
1890 #. type: =item
1891 #: ../src/guestfs.pod:819
1892 msgid "guestfish command line is hard to use."
1893 msgstr ""
1894
1895 # type: textblock
1896 #. type: textblock
1897 #: ../src/guestfs.pod:821
1898 msgid ""
1899 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1900 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1901 "exist, so it fails.  In earlier versions of guestfish the error message was "
1902 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1903 "we should have used C<guestfish -c command> to run commands."
1904 msgstr ""
1905
1906 # type: =item
1907 #. type: =item
1908 #: ../src/guestfs.pod:828
1909 msgid "guestfish megabyte modifiers don't work right on all commands"
1910 msgstr ""
1911
1912 # type: textblock
1913 #. type: textblock
1914 #: ../src/guestfs.pod:830
1915 msgid ""
1916 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1917 "other modifiers).  What guestfish actually does is to multiply the number "
1918 "part by the modifier part and pass the result to the C API.  However this "
1919 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1920 "expecting some other unit (eg. megabytes)."
1921 msgstr ""
1922
1923 # type: textblock
1924 #. type: textblock
1925 #: ../src/guestfs.pod:837
1926 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1927 msgstr ""
1928
1929 # type: verbatim
1930 #. type: verbatim
1931 #: ../src/guestfs.pod:839
1932 #, no-wrap
1933 msgid ""
1934 " lvcreate LV VG 100M\n"
1935 "\n"
1936 msgstr ""
1937
1938 # type: textblock
1939 #. type: textblock
1940 #: ../src/guestfs.pod:841
1941 msgid ""
1942 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1943 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1944 "megabytes * megabytes) logical volume.  The error message you get from this "
1945 "is also a little obscure."
1946 msgstr ""
1947
1948 # type: textblock
1949 #. type: textblock
1950 #: ../src/guestfs.pod:846
1951 msgid ""
1952 "This could be fixed in the generator by specially marking parameters and "
1953 "return values which take bytes or other units."
1954 msgstr ""
1955
1956 # type: =item
1957 #. type: =item
1958 #: ../src/guestfs.pod:849
1959 msgid "Ambiguity between devices and paths"
1960 msgstr ""
1961
1962 # type: textblock
1963 #. type: textblock
1964 #: ../src/guestfs.pod:851
1965 msgid ""
1966 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1967 "sdb2>) and a similar pathname.  A file might just happen to be called "
1968 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1969 msgstr ""
1970
1971 # type: textblock
1972 #. type: textblock
1973 #: ../src/guestfs.pod:856
1974 msgid ""
1975 "In the current API we usually resolve this ambiguity by having two separate "
1976 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1977 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1978 "detecting if the path supplied begins with C</dev/>."
1979 msgstr ""
1980
1981 # type: textblock
1982 #. type: textblock
1983 #: ../src/guestfs.pod:862
1984 msgid ""
1985 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1986 "make paths/devices into structured names.  One way to do this would be to "
1987 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1988 "aspect of grub.  Another way would be to use a structured type, equivalent "
1989 "to this OCaml type:"
1990 msgstr ""
1991
1992 # type: verbatim
1993 #. type: verbatim
1994 #: ../src/guestfs.pod:868
1995 #, no-wrap
1996 msgid ""
1997 " type path = Path of string | Device of int | Partition of int * int\n"
1998 "\n"
1999 msgstr ""
2000
2001 # type: textblock
2002 #. type: textblock
2003 #: ../src/guestfs.pod:870
2004 msgid "which would allow you to pass arguments like:"
2005 msgstr ""
2006
2007 # type: verbatim
2008 #. type: verbatim
2009 #: ../src/guestfs.pod:872
2010 #, no-wrap
2011 msgid ""
2012 " Path \"/foo/bar\"\n"
2013 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
2014 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
2015 " Path \"/dev/sdb2\"    (* not a device *)\n"
2016 "\n"
2017 msgstr ""
2018
2019 # type: textblock
2020 #. type: textblock
2021 #: ../src/guestfs.pod:877
2022 msgid ""
2023 "As you can see there are still problems to resolve even with this "
2024 "representation.  Also consider how it might work in guestfish."
2025 msgstr ""
2026
2027 # type: =head2
2028 #. type: =head2
2029 #: ../src/guestfs.pod:882
2030 msgid "KEYS AND PASSPHRASES"
2031 msgstr ""
2032
2033 # type: textblock
2034 #. type: textblock
2035 #: ../src/guestfs.pod:884
2036 msgid ""
2037 "Certain libguestfs calls take a parameter that contains sensitive key "
2038 "material, passed in as a C string."
2039 msgstr ""
2040
2041 # type: textblock
2042 #. type: textblock
2043 #: ../src/guestfs.pod:887
2044 msgid ""
2045 "In the future we would hope to change the libguestfs implementation so that "
2046 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2047 "swap.  However this is I<not> done at the moment, because of the complexity "
2048 "of such an implementation."
2049 msgstr ""
2050
2051 # type: textblock
2052 #. type: textblock
2053 #: ../src/guestfs.pod:892
2054 msgid ""
2055 "Therefore you should be aware that any key parameter you pass to libguestfs "
2056 "might end up being written out to the swap partition.  If this is a concern, "
2057 "scrub the swap partition or don't use libguestfs on encrypted devices."
2058 msgstr ""
2059
2060 # type: =head1
2061 #. type: =head2
2062 #: ../src/guestfs.pod:897
2063 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2064 msgstr ""
2065
2066 # type: textblock
2067 #. type: textblock
2068 #: ../src/guestfs.pod:899
2069 msgid ""
2070 "All high-level libguestfs actions are synchronous.  If you want to use "
2071 "libguestfs asynchronously then you must create a thread."
2072 msgstr ""
2073
2074 # type: textblock
2075 #. type: textblock
2076 #: ../src/guestfs.pod:902
2077 msgid ""
2078 "Only use the handle from a single thread.  Either use the handle exclusively "
2079 "from one thread, or provide your own mutex so that two threads cannot issue "
2080 "calls on the same handle at the same time."
2081 msgstr ""
2082
2083 # type: textblock
2084 #. type: textblock
2085 #: ../src/guestfs.pod:906
2086 msgid ""
2087 "See the graphical program guestfs-browser for one possible architecture for "
2088 "multithreaded programs using libvirt and libguestfs."
2089 msgstr ""
2090
2091 # type: =head1
2092 #. type: =head2
2093 #: ../src/guestfs.pod:909
2094 msgid "PATH"
2095 msgstr ""
2096
2097 #. type: textblock
2098 #: ../src/guestfs.pod:911
2099 msgid ""
2100 "Libguestfs needs a supermin appliance, which it finds by looking along an "
2101 "internal path."
2102 msgstr ""
2103
2104 # type: textblock
2105 #. type: textblock
2106 #: ../src/guestfs.pod:914
2107 msgid ""
2108 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2109 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2110 msgstr ""
2111
2112 # type: textblock
2113 #. type: textblock
2114 #: ../src/guestfs.pod:917
2115 msgid ""
2116 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2117 "to change the directories that libguestfs will search in.  The value is a "
2118 "colon-separated list of paths.  The current directory is I<not> searched "
2119 "unless the path contains an empty element or C<.>.  For example "
2120 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2121 "then C</usr/lib/guestfs>."
2122 msgstr ""
2123
2124 # type: =head1
2125 #. type: =head2
2126 #: ../src/guestfs.pod:924
2127 msgid "QEMU WRAPPERS"
2128 msgstr ""
2129
2130 # type: textblock
2131 #. type: textblock
2132 #: ../src/guestfs.pod:926
2133 msgid ""
2134 "If you want to compile your own qemu, run qemu from a non-standard location, "
2135 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2136 "around qemu."
2137 msgstr ""
2138
2139 # type: textblock
2140 #. type: textblock
2141 #: ../src/guestfs.pod:930
2142 msgid ""
2143 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2144 "last command in the shell script (so that qemu replaces the shell and "
2145 "becomes the direct child of the libguestfs-using program).  If you don't do "
2146 "this, then the qemu process won't be cleaned up correctly."
2147 msgstr ""
2148
2149 # type: textblock
2150 #. type: textblock
2151 #: ../src/guestfs.pod:935
2152 msgid ""
2153 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2154 "source:"
2155 msgstr ""
2156
2157 # type: verbatim
2158 #. type: verbatim
2159 #: ../src/guestfs.pod:938
2160 #, no-wrap
2161 msgid ""
2162 " #!/bin/sh -\n"
2163 " qemudir=/home/rjones/d/qemu\n"
2164 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2165 "\n"
2166 msgstr ""
2167
2168 # type: textblock
2169 #. type: textblock
2170 #: ../src/guestfs.pod:942
2171 msgid ""
2172 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2173 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2174 "example:"
2175 msgstr ""
2176
2177 # type: verbatim
2178 #. type: verbatim
2179 #: ../src/guestfs.pod:946
2180 #, no-wrap
2181 msgid ""
2182 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2183 "\n"
2184 msgstr ""
2185
2186 # type: textblock
2187 #. type: textblock
2188 #: ../src/guestfs.pod:948
2189 msgid ""
2190 "Note that libguestfs also calls qemu with the -help and -version options in "
2191 "order to determine features."
2192 msgstr ""
2193
2194 #. type: =head2
2195 #: ../src/guestfs.pod:951
2196 msgid "ATTACHING TO RUNNING DAEMONS"
2197 msgstr ""
2198
2199 #. type: textblock
2200 #: ../src/guestfs.pod:953
2201 msgid ""
2202 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
2203 "babies.  Use with caution."
2204 msgstr ""
2205
2206 #. type: textblock
2207 #: ../src/guestfs.pod:956
2208 msgid ""
2209 "I<Note (2):> This section explains how to attach to a running daemon from a "
2210 "low level perspective.  For most users, simply using virt tools such as "
2211 "L<guestfish(1)> with the I<--live> option will \"just work\"."
2212 msgstr ""
2213
2214 #. type: =head3
2215 #: ../src/guestfs.pod:960
2216 msgid "Using guestfs_set_attach_method"
2217 msgstr ""
2218
2219 #. type: textblock
2220 #: ../src/guestfs.pod:962
2221 msgid ""
2222 "By calling L</guestfs_set_attach_method> you can change how the library "
2223 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
2224 "ARCHITECTURE> for some background)."
2225 msgstr ""
2226
2227 #. type: textblock
2228 #: ../src/guestfs.pod:966
2229 msgid ""
2230 "The normal attach method is C<appliance>, where a small appliance is created "
2231 "containing the daemon, and then the library connects to this."
2232 msgstr ""
2233
2234 #. type: textblock
2235 #: ../src/guestfs.pod:969
2236 msgid ""
2237 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
2238 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
2239 "daemon over the Unix domain socket."
2240 msgstr ""
2241
2242 #. type: textblock
2243 #: ../src/guestfs.pod:973
2244 msgid ""
2245 "The normal use for this is to connect to a running virtual machine that "
2246 "contains a C<guestfsd> daemon, and send commands so you can read and write "
2247 "files inside the live virtual machine."
2248 msgstr ""
2249
2250 #. type: =head3
2251 #: ../src/guestfs.pod:977
2252 msgid "Using guestfs_add_domain with live flag"
2253 msgstr ""
2254
2255 #. type: textblock
2256 #: ../src/guestfs.pod:979
2257 msgid ""
2258 "L</guestfs_add_domain> provides some help for getting the correct attach "
2259 "method.  If you pass the C<live> option to this function, then (if the "
2260 "virtual machine is running) it will examine the libvirt XML looking for a "
2261 "virtio-serial channel to connect to:"
2262 msgstr ""
2263
2264 #. type: verbatim
2265 #: ../src/guestfs.pod:985
2266 #, no-wrap
2267 msgid ""
2268 " <domain>\n"
2269 "   ...\n"
2270 "   <devices>\n"
2271 "     ...\n"
2272 "     <channel type='unix'>\n"
2273 "       <source mode='bind' path='/path/to/socket'/>\n"
2274 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
2275 "     </channel>\n"
2276 "     ...\n"
2277 "   </devices>\n"
2278 " </domain>\n"
2279 "\n"
2280 msgstr ""
2281
2282 #. type: textblock
2283 #: ../src/guestfs.pod:997
2284 msgid ""
2285 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2286 "method to C<unix:/path/to/socket>."
2287 msgstr ""
2288
2289 #. type: textblock
2290 #: ../src/guestfs.pod:1000
2291 msgid ""
2292 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2293 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2294 "to attach to and modify live virtual machines."
2295 msgstr ""
2296
2297 #. type: textblock
2298 #: ../src/guestfs.pod:1004
2299 msgid ""
2300 "The virtual machine needs to have been set up beforehand so that it has the "
2301 "virtio-serial channel and so that guestfsd is running inside it."
2302 msgstr ""
2303
2304 # type: =head2
2305 #. type: =head2
2306 #: ../src/guestfs.pod:1008
2307 msgid "ABI GUARANTEE"
2308 msgstr ""
2309
2310 # type: textblock
2311 #. type: textblock
2312 #: ../src/guestfs.pod:1010
2313 msgid ""
2314 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2315 "actions as outlined in this section.  Although we will deprecate some "
2316 "actions, for example if they get replaced by newer calls, we will keep the "
2317 "old actions forever.  This allows you the developer to program in confidence "
2318 "against the libguestfs API."
2319 msgstr ""
2320
2321 # type: =head1
2322 #. type: =head2
2323 #: ../src/guestfs.pod:1016
2324 msgid "BLOCK DEVICE NAMING"
2325 msgstr ""
2326
2327 # type: textblock
2328 #. type: textblock
2329 #: ../src/guestfs.pod:1018
2330 msgid ""
2331 "In the kernel there is now quite a profusion of schemata for naming block "
2332 "devices (in this context, by I<block device> I mean a physical or virtual "
2333 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2334 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2335 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2336 "for the old IDE driver (particularly for SATA devices) those devices also "
2337 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2338 "paravirtualized drivers.  This has created several different naming systems, "
2339 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2340 msgstr ""
2341
2342 # type: textblock
2343 #. type: textblock
2344 #: ../src/guestfs.pod:1030
2345 msgid ""
2346 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2347 "Linux kernel to access block devices.  We can run a variety of appliances "
2348 "based on a variety of Linux kernels."
2349 msgstr ""
2350
2351 # type: textblock
2352 #. type: textblock
2353 #: ../src/guestfs.pod:1034
2354 msgid ""
2355 "This causes a problem for libguestfs because many API calls use device or "
2356 "partition names.  Working scripts and the recipe (example) scripts that we "
2357 "make available over the internet could fail if the naming scheme changes."
2358 msgstr ""
2359
2360 # type: textblock
2361 #. type: textblock
2362 #: ../src/guestfs.pod:1039
2363 msgid ""
2364 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2365 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2366 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2367 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2368 msgstr ""
2369
2370 # type: textblock
2371 #. type: textblock
2372 #: ../src/guestfs.pod:1045
2373 msgid ""
2374 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2375 "L</guestfs_list_partitions> and similar calls return the true names of the "
2376 "devices and partitions as known to the appliance."
2377 msgstr ""
2378
2379 # type: =head2
2380 #. type: =head3
2381 #: ../src/guestfs.pod:1050
2382 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2383 msgstr ""
2384
2385 # type: textblock
2386 #. type: textblock
2387 #: ../src/guestfs.pod:1052
2388 msgid ""
2389 "Usually this translation is transparent.  However in some (very rare)  cases "
2390 "you may need to know the exact algorithm.  Such cases include where you use "
2391 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2392 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2393 msgstr ""
2394
2395 # type: textblock
2396 #. type: textblock
2397 #: ../src/guestfs.pod:1058
2398 msgid ""
2399 "The algorithm is applied only to I<parameters> which are known to be either "
2400 "device or partition names.  Return values from functions such as L</"
2401 "guestfs_list_devices> are never changed."
2402 msgstr ""
2403
2404 # type: textblock
2405 #. type: textblock
2406 #: ../src/guestfs.pod:1066
2407 msgid "Is the string a parameter which is a device or partition name?"
2408 msgstr ""
2409
2410 # type: textblock
2411 #. type: textblock
2412 #: ../src/guestfs.pod:1070
2413 msgid "Does the string begin with C</dev/sd>?"
2414 msgstr ""
2415
2416 # type: textblock
2417 #. type: textblock
2418 #: ../src/guestfs.pod:1074
2419 msgid ""
2420 "Does the named device exist? If so, we use that device.  However if I<not> "
2421 "then we continue with this algorithm."
2422 msgstr ""
2423
2424 # type: textblock
2425 #. type: textblock
2426 #: ../src/guestfs.pod:1079
2427 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2428 msgstr ""
2429
2430 # type: textblock
2431 #. type: textblock
2432 #: ../src/guestfs.pod:1081
2433 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2434 msgstr ""
2435
2436 # type: textblock
2437 #. type: textblock
2438 #: ../src/guestfs.pod:1083
2439 msgid "If that named device exists, use it.  If not, continue."
2440 msgstr ""
2441
2442 # type: textblock
2443 #. type: textblock
2444 #: ../src/guestfs.pod:1087
2445 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2446 msgstr ""
2447
2448 # type: textblock
2449 #. type: textblock
2450 #: ../src/guestfs.pod:1089
2451 msgid "If that named device exists, use it.  If not, return an error."
2452 msgstr ""
2453
2454 # type: =head3
2455 #. type: =head3
2456 #: ../src/guestfs.pod:1093
2457 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2458 msgstr ""
2459
2460 # type: textblock
2461 #. type: textblock
2462 #: ../src/guestfs.pod:1095
2463 msgid ""
2464 "Although the standard naming scheme and automatic translation is useful for "
2465 "simple programs and guestfish scripts, for larger programs it is best not to "
2466 "rely on this mechanism."
2467 msgstr ""
2468
2469 # type: textblock
2470 #. type: textblock
2471 #: ../src/guestfs.pod:1099
2472 msgid ""
2473 "Where possible for maximum future portability programs using libguestfs "
2474 "should use these future-proof techniques:"
2475 msgstr ""
2476
2477 # type: textblock
2478 #. type: textblock
2479 #: ../src/guestfs.pod:1106
2480 msgid ""
2481 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2482 "device names, and then use those names directly."
2483 msgstr ""
2484
2485 # type: textblock
2486 #. type: textblock
2487 #: ../src/guestfs.pod:1109
2488 msgid ""
2489 "Since those device names exist by definition, they will never be translated."
2490 msgstr ""
2491
2492 # type: textblock
2493 #. type: textblock
2494 #: ../src/guestfs.pod:1114
2495 msgid ""
2496 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2497 "filesystem labels."
2498 msgstr ""
2499
2500 # type: =head1
2501 #. type: =head1
2502 #: ../src/guestfs.pod:1119
2503 msgid "SECURITY"
2504 msgstr ""
2505
2506 # type: textblock
2507 #. type: textblock
2508 #: ../src/guestfs.pod:1121
2509 msgid ""
2510 "This section discusses security implications of using libguestfs, "
2511 "particularly with untrusted or malicious guests or disk images."
2512 msgstr ""
2513
2514 # type: =head2
2515 #. type: =head2
2516 #: ../src/guestfs.pod:1124
2517 msgid "GENERAL SECURITY CONSIDERATIONS"
2518 msgstr ""
2519
2520 # type: textblock
2521 #. type: textblock
2522 #: ../src/guestfs.pod:1126
2523 msgid ""
2524 "Be careful with any files or data that you download from a guest (by "
2525 "\"download\" we mean not just the L</guestfs_download> command but any "
2526 "command that reads files, filenames, directories or anything else from a "
2527 "disk image).  An attacker could manipulate the data to fool your program "
2528 "into doing the wrong thing.  Consider cases such as:"
2529 msgstr ""
2530
2531 # type: textblock
2532 #. type: textblock
2533 #: ../src/guestfs.pod:1136
2534 msgid "the data (file etc) not being present"
2535 msgstr ""
2536
2537 # type: textblock
2538 #. type: textblock
2539 #: ../src/guestfs.pod:1140
2540 msgid "being present but empty"
2541 msgstr ""
2542
2543 # type: textblock
2544 #. type: textblock
2545 #: ../src/guestfs.pod:1144
2546 msgid "being much larger than normal"
2547 msgstr ""
2548
2549 # type: textblock
2550 #. type: textblock
2551 #: ../src/guestfs.pod:1148
2552 msgid "containing arbitrary 8 bit data"
2553 msgstr ""
2554
2555 # type: textblock
2556 #. type: textblock
2557 #: ../src/guestfs.pod:1152
2558 msgid "being in an unexpected character encoding"
2559 msgstr ""
2560
2561 # type: textblock
2562 #. type: textblock
2563 #: ../src/guestfs.pod:1156
2564 msgid "containing homoglyphs."
2565 msgstr ""
2566
2567 # type: =head2
2568 #. type: =head2
2569 #: ../src/guestfs.pod:1160
2570 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2571 msgstr ""
2572
2573 # type: textblock
2574 #. type: textblock
2575 #: ../src/guestfs.pod:1162
2576 msgid ""
2577 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2578 "(VFS) module can sometimes be escalated into exploits by deliberately "
2579 "creating a malicious, malformed filesystem.  These exploits are very severe "
2580 "for two reasons.  Firstly there are very many filesystem drivers in the "
2581 "kernel, and many of them are infrequently used and not much developer "
2582 "attention has been paid to the code.  Linux userspace helps potential "
2583 "crackers by detecting the filesystem type and automatically choosing the "
2584 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2585 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2586 "exploit (worse in some ways), giving immediate and total access to the "
2587 "system right down to the hardware level."
2588 msgstr ""
2589
2590 # type: textblock
2591 #. type: textblock
2592 #: ../src/guestfs.pod:1175
2593 msgid ""
2594 "That explains why you should never mount a filesystem from an untrusted "
2595 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2596 "inside a qemu virtual machine, usually running as a non-root user.  The "
2597 "attacker would need to write a filesystem which first exploited the kernel, "
2598 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2599 "the libguestfs protocol, and finally to be as serious as the host kernel "
2600 "exploit it would need to escalate its privileges to root.  This multi-step "
2601 "escalation, performed by a static piece of data, is thought to be extremely "
2602 "hard to do, although we never say 'never' about security issues."
2603 msgstr ""
2604
2605 # type: textblock
2606 #. type: textblock
2607 #: ../src/guestfs.pod:1186
2608 msgid ""
2609 "In any case callers can reduce the attack surface by forcing the filesystem "
2610 "type when mounting (use L</guestfs_mount_vfs>)."
2611 msgstr ""
2612
2613 # type: =head2
2614 #. type: =head2
2615 #: ../src/guestfs.pod:1189
2616 msgid "PROTOCOL SECURITY"
2617 msgstr ""
2618
2619 # type: textblock
2620 #. type: textblock
2621 #: ../src/guestfs.pod:1191
2622 msgid ""
2623 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2624 "defined upper message size.  However a program that uses libguestfs must "
2625 "also take care - for example you can write a program that downloads a binary "
2626 "from a disk image and executes it locally, and no amount of protocol "
2627 "security will save you from the consequences."
2628 msgstr ""
2629
2630 # type: =head2
2631 #. type: =head2
2632 #: ../src/guestfs.pod:1197
2633 msgid "INSPECTION SECURITY"
2634 msgstr ""
2635
2636 # type: textblock
2637 #. type: textblock
2638 #: ../src/guestfs.pod:1199
2639 msgid ""
2640 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2641 "directly from the guest, and these could contain any 8 bit data.  Callers "
2642 "should be careful to escape these before printing them to a structured file "
2643 "(for example, use HTML escaping if creating a web page)."
2644 msgstr ""
2645
2646 # type: textblock
2647 #. type: textblock
2648 #: ../src/guestfs.pod:1205
2649 msgid ""
2650 "Guest configuration may be altered in unusual ways by the administrator of "
2651 "the virtual machine, and may not reflect reality (particularly for untrusted "
2652 "or actively malicious guests).  For example we parse the hostname from "
2653 "configuration files like C</etc/sysconfig/network> that we find in the "
2654 "guest, but the guest administrator can easily manipulate these files to "
2655 "provide the wrong hostname."
2656 msgstr ""
2657
2658 # type: textblock
2659 #. type: textblock
2660 #: ../src/guestfs.pod:1213
2661 msgid ""
2662 "The inspection API parses guest configuration using two external libraries: "
2663 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2664 "designed to be robust in the face of malicious data, although denial of "
2665 "service attacks are still possible, for example with oversized configuration "
2666 "files."
2667 msgstr ""
2668
2669 # type: =head2
2670 #. type: =head2
2671 #: ../src/guestfs.pod:1219
2672 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2673 msgstr ""
2674
2675 # type: textblock
2676 #. type: textblock
2677 #: ../src/guestfs.pod:1221
2678 msgid ""
2679 "Be very cautious about running commands from the guest.  By running a "
2680 "command in the guest, you are giving CPU time to a binary that you do not "
2681 "control, under the same user account as the library, albeit wrapped in qemu "
2682 "virtualization.  More information and alternatives can be found in the "
2683 "section L</RUNNING COMMANDS>."
2684 msgstr ""
2685
2686 # type: =head2
2687 #. type: =head2
2688 #: ../src/guestfs.pod:1227
2689 msgid "CVE-2010-3851"
2690 msgstr ""
2691
2692 # type: textblock
2693 #. type: textblock
2694 #: ../src/guestfs.pod:1229
2695 msgid "https://bugzilla.redhat.com/642934"
2696 msgstr ""
2697
2698 # type: textblock
2699 #. type: textblock
2700 #: ../src/guestfs.pod:1231
2701 msgid ""
2702 "This security bug concerns the automatic disk format detection that qemu "
2703 "does on disk images."
2704 msgstr ""
2705
2706 # type: textblock
2707 #. type: textblock
2708 #: ../src/guestfs.pod:1234
2709 msgid ""
2710 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2711 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2712 "for one of the known headers, and if none is found then assuming the disk "
2713 "image must be raw."
2714 msgstr ""
2715
2716 # type: textblock
2717 #. type: textblock
2718 #: ../src/guestfs.pod:1239
2719 msgid ""
2720 "This allows a guest which has been given a raw disk image to write some "
2721 "other header.  At next boot (or when the disk image is accessed by "
2722 "libguestfs) qemu would do autodetection and think the disk image format was, "
2723 "say, qcow2 based on the header written by the guest."
2724 msgstr ""
2725
2726 # type: textblock
2727 #. type: textblock
2728 #: ../src/guestfs.pod:1244
2729 msgid ""
2730 "This in itself would not be a problem, but qcow2 offers many features, one "
2731 "of which is to allow a disk image to refer to another image (called the "
2732 "\"backing disk\").  It does this by placing the path to the backing disk "
2733 "into the qcow2 header.  This path is not validated and could point to any "
2734 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2735 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2736 "control of the attacker."
2737 msgstr ""
2738
2739 # type: textblock
2740 #. type: textblock
2741 #: ../src/guestfs.pod:1252
2742 msgid ""
2743 "In libguestfs this is rather hard to exploit except under two circumstances:"
2744 msgstr ""
2745
2746 # type: textblock
2747 #. type: textblock
2748 #: ../src/guestfs.pod:1259
2749 msgid "You have enabled the network or have opened the disk in write mode."
2750 msgstr ""
2751
2752 # type: textblock
2753 #. type: textblock
2754 #: ../src/guestfs.pod:1263
2755 msgid ""
2756 "You are also running untrusted code from the guest (see L</RUNNING "
2757 "COMMANDS>)."
2758 msgstr ""
2759
2760 # type: textblock
2761 #. type: textblock
2762 #: ../src/guestfs.pod:1268
2763 msgid ""
2764 "The way to avoid this is to specify the expected disk format when adding "
2765 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2766 "should always do this if the disk is raw format, and it's a good idea for "
2767 "other cases too."
2768 msgstr ""
2769
2770 # type: textblock
2771 #. type: textblock
2772 #: ../src/guestfs.pod:1273
2773 msgid ""
2774 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2775 "format is fetched from libvirt and passed through."
2776 msgstr ""
2777
2778 # type: textblock
2779 #. type: textblock
2780 #: ../src/guestfs.pod:1276
2781 msgid ""
2782 "For libguestfs tools, use the I<--format> command line parameter as "
2783 "appropriate."
2784 msgstr ""
2785
2786 # type: =head1
2787 #. type: =head1
2788 #: ../src/guestfs.pod:1279
2789 msgid "CONNECTION MANAGEMENT"
2790 msgstr ""
2791
2792 # type: =head2
2793 #. type: =head2
2794 #: ../src/guestfs.pod:1281
2795 msgid "guestfs_h *"
2796 msgstr ""
2797
2798 # type: textblock
2799 #. type: textblock
2800 #: ../src/guestfs.pod:1283
2801 msgid ""
2802 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2803 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2804 "handle and release all resources used."
2805 msgstr ""
2806
2807 #. type: textblock
2808 #: ../src/guestfs.pod:1287
2809 msgid ""
2810 "For information on using multiple handles and threads, see the section L</"
2811 "MULTIPLE HANDLES AND MULTIPLE THREADS> above."
2812 msgstr ""
2813
2814 # type: =head2
2815 #. type: =head2
2816 #: ../src/guestfs.pod:1290
2817 msgid "guestfs_create"
2818 msgstr ""
2819
2820 # type: verbatim
2821 #. type: verbatim
2822 #: ../src/guestfs.pod:1292
2823 #, no-wrap
2824 msgid ""
2825 " guestfs_h *guestfs_create (void);\n"
2826 "\n"
2827 msgstr ""
2828
2829 # type: textblock
2830 #. type: textblock
2831 #: ../src/guestfs.pod:1294
2832 msgid "Create a connection handle."
2833 msgstr ""
2834
2835 #. type: textblock
2836 #: ../src/guestfs.pod:1296
2837 msgid ""
2838 "On success this returns a non-NULL pointer to a handle.  On error it returns "
2839 "NULL."
2840 msgstr ""
2841
2842 #. type: textblock
2843 #: ../src/guestfs.pod:1299
2844 msgid ""
2845 "You have to \"configure\" the handle after creating it.  This includes "
2846 "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the "
2847 "handle at least once."
2848 msgstr ""
2849
2850 # type: textblock
2851 #. type: textblock
2852 #: ../src/guestfs.pod:1303
2853 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2854 msgstr ""
2855
2856 #. type: textblock
2857 #: ../src/guestfs.pod:1305
2858 msgid ""
2859 "You may also want to configure error handling for the handle.  See the L</"
2860 "ERROR HANDLING> section below."
2861 msgstr ""
2862
2863 # type: =head2
2864 #. type: =head2
2865 #: ../src/guestfs.pod:1308
2866 msgid "guestfs_close"
2867 msgstr ""
2868
2869 # type: verbatim
2870 #. type: verbatim
2871 #: ../src/guestfs.pod:1310
2872 #, no-wrap
2873 msgid ""
2874 " void guestfs_close (guestfs_h *g);\n"
2875 "\n"
2876 msgstr ""
2877
2878 # type: textblock
2879 #. type: textblock
2880 #: ../src/guestfs.pod:1312
2881 msgid "This closes the connection handle and frees up all resources used."
2882 msgstr ""
2883
2884 #. type: textblock
2885 #: ../src/guestfs.pod:1314
2886 msgid ""
2887 "If autosync was set on the handle and the handle was launched, then this "
2888 "implicitly calls various functions to unmount filesystems and sync the "
2889 "disk.  See L</guestfs_set_autosync> for more details."
2890 msgstr ""
2891
2892 #. type: textblock
2893 #: ../src/guestfs.pod:1318
2894 msgid "If a close callback was set on the handle, then it is called."
2895 msgstr ""
2896
2897 # type: =head1
2898 #. type: =head1
2899 #: ../src/guestfs.pod:1320
2900 msgid "ERROR HANDLING"
2901 msgstr ""
2902
2903 # type: textblock
2904 #. type: textblock
2905 #: ../src/guestfs.pod:1322
2906 msgid ""
2907 "API functions can return errors.  For example, almost all functions that "
2908 "return C<int> will return C<-1> to indicate an error."
2909 msgstr ""
2910
2911 # type: textblock
2912 #. type: textblock
2913 #: ../src/guestfs.pod:1325
2914 msgid ""
2915 "Additional information is available for errors: an error message string and "
2916 "optionally an error number (errno) if the thing that failed was a system "
2917 "call."
2918 msgstr ""
2919
2920 # type: textblock
2921 #. type: textblock
2922 #: ../src/guestfs.pod:1329
2923 msgid ""
2924 "You can get at the additional information about the last error on the handle "
2925 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2926 "up an error handler with L</guestfs_set_error_handler>."
2927 msgstr ""
2928
2929 # type: textblock
2930 #. type: textblock
2931 #: ../src/guestfs.pod:1334
2932 msgid ""
2933 "When the handle is created, a default error handler is installed which "
2934 "prints the error message string to C<stderr>.  For small short-running "
2935 "command line programs it is sufficient to do:"
2936 msgstr ""
2937
2938 # type: verbatim
2939 #. type: verbatim
2940 #: ../src/guestfs.pod:1338
2941 #, no-wrap
2942 msgid ""
2943 " if (guestfs_launch (g) == -1)\n"
2944 "   exit (EXIT_FAILURE);\n"
2945 "\n"
2946 msgstr ""
2947
2948 # type: textblock
2949 #. type: textblock
2950 #: ../src/guestfs.pod:1341
2951 msgid ""
2952 "since the default error handler will ensure that an error message has been "
2953 "printed to C<stderr> before the program exits."
2954 msgstr ""
2955
2956 # type: textblock
2957 #. type: textblock
2958 #: ../src/guestfs.pod:1344
2959 msgid ""
2960 "For other programs the caller will almost certainly want to install an "
2961 "alternate error handler or do error handling in-line like this:"
2962 msgstr ""
2963
2964 # type: verbatim
2965 #. type: verbatim
2966 #: ../src/guestfs.pod:1347
2967 #, no-wrap
2968 msgid ""
2969 " g = guestfs_create ();\n"
2970 " \n"
2971 msgstr ""
2972
2973 # type: verbatim
2974 #. type: verbatim
2975 #: ../src/guestfs.pod:1349
2976 #, no-wrap
2977 msgid ""
2978 " /* This disables the default behaviour of printing errors\n"
2979 "    on stderr. */\n"
2980 " guestfs_set_error_handler (g, NULL, NULL);\n"
2981 " \n"
2982 msgstr ""
2983
2984 # type: verbatim
2985 #. type: verbatim
2986 #: ../src/guestfs.pod:1353
2987 #, no-wrap
2988 msgid ""
2989 " if (guestfs_launch (g) == -1) {\n"
2990 "   /* Examine the error message and print it etc. */\n"
2991 "   char *msg = guestfs_last_error (g);\n"
2992 "   int errnum = guestfs_last_errno (g);\n"
2993 "   fprintf (stderr, \"%s\\n\", msg);\n"
2994 "   /* ... */\n"
2995 "  }\n"
2996 "\n"
2997 msgstr ""
2998
2999 # type: textblock
3000 #. type: textblock
3001 #: ../src/guestfs.pod:1361
3002 msgid ""
3003 "Out of memory errors are handled differently.  The default action is to call "
3004 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
3005 "guestfs_set_out_of_memory_handler>."
3006 msgstr ""
3007
3008 # type: textblock
3009 #. type: textblock
3010 #: ../src/guestfs.pod:1365
3011 msgid ""
3012 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
3013 "because there is no handle if this happens there is no way to get additional "
3014 "error information.  However L</guestfs_create> is supposed to be a "
3015 "lightweight operation which can only fail because of insufficient memory (it "
3016 "returns NULL in this case)."
3017 msgstr ""
3018
3019 # type: =head2
3020 #. type: =head2
3021 #: ../src/guestfs.pod:1371
3022 msgid "guestfs_last_error"
3023 msgstr ""
3024
3025 # type: verbatim
3026 #. type: verbatim
3027 #: ../src/guestfs.pod:1373
3028 #, no-wrap
3029 msgid ""
3030 " const char *guestfs_last_error (guestfs_h *g);\n"
3031 "\n"
3032 msgstr ""
3033
3034 # type: textblock
3035 #. type: textblock
3036 #: ../src/guestfs.pod:1375
3037 msgid ""
3038 "This returns the last error message that happened on C<g>.  If there has not "
3039 "been an error since the handle was created, then this returns C<NULL>."
3040 msgstr ""
3041
3042 # type: textblock
3043 #. type: textblock
3044 #: ../src/guestfs.pod:1379
3045 msgid ""
3046 "The lifetime of the returned string is until the next error occurs, or L</"
3047 "guestfs_close> is called."
3048 msgstr ""
3049
3050 # type: =head2
3051 #. type: =head2
3052 #: ../src/guestfs.pod:1382
3053 msgid "guestfs_last_errno"
3054 msgstr ""
3055
3056 # type: verbatim
3057 #. type: verbatim
3058 #: ../src/guestfs.pod:1384
3059 #, no-wrap
3060 msgid ""
3061 " int guestfs_last_errno (guestfs_h *g);\n"
3062 "\n"
3063 msgstr ""
3064
3065 # type: textblock
3066 #. type: textblock
3067 #: ../src/guestfs.pod:1386
3068 msgid "This returns the last error number (errno) that happened on C<g>."
3069 msgstr ""
3070
3071 # type: textblock
3072 #. type: textblock
3073 #: ../src/guestfs.pod:1388
3074 msgid "If successful, an errno integer not equal to zero is returned."
3075 msgstr ""
3076
3077 # type: textblock
3078 #. type: textblock
3079 #: ../src/guestfs.pod:1390
3080 msgid ""
3081 "If no error, this returns 0.  This call can return 0 in three situations:"
3082 msgstr ""
3083
3084 # type: textblock
3085 #. type: textblock
3086 #: ../src/guestfs.pod:1397
3087 msgid "There has not been any error on the handle."
3088 msgstr ""
3089
3090 # type: textblock
3091 #. type: textblock
3092 #: ../src/guestfs.pod:1401
3093 msgid ""
3094 "There has been an error but the errno was meaningless.  This corresponds to "
3095 "the case where the error did not come from a failed system call, but for "
3096 "some other reason."
3097 msgstr ""
3098
3099 # type: textblock
3100 #. type: textblock
3101 #: ../src/guestfs.pod:1407
3102 msgid ""
3103 "There was an error from a failed system call, but for some reason the errno "
3104 "was not captured and returned.  This usually indicates a bug in libguestfs."
3105 msgstr ""
3106
3107 # type: textblock
3108 #. type: textblock
3109 #: ../src/guestfs.pod:1413
3110 msgid ""
3111 "Libguestfs tries to convert the errno from inside the applicance into a "
3112 "corresponding errno for the caller (not entirely trivial: the appliance "
3113 "might be running a completely different operating system from the library "
3114 "and error numbers are not standardized across Un*xen).  If this could not be "
3115 "done, then the error is translated to C<EINVAL>.  In practice this should "
3116 "only happen in very rare circumstances."
3117 msgstr ""
3118
3119 # type: =head2
3120 #. type: =head2
3121 #: ../src/guestfs.pod:1421
3122 msgid "guestfs_set_error_handler"
3123 msgstr ""
3124
3125 # type: verbatim
3126 #. type: verbatim
3127 #: ../src/guestfs.pod:1423
3128 #, no-wrap
3129 msgid ""
3130 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3131 "                                           void *opaque,\n"
3132 "                                           const char *msg);\n"
3133 " void guestfs_set_error_handler (guestfs_h *g,\n"
3134 "                                 guestfs_error_handler_cb cb,\n"
3135 "                                 void *opaque);\n"
3136 "\n"
3137 msgstr ""
3138
3139 # type: textblock
3140 #. type: textblock
3141 #: ../src/guestfs.pod:1430
3142 msgid ""
3143 "The callback C<cb> will be called if there is an error.  The parameters "
3144 "passed to the callback are an opaque data pointer and the error message "
3145 "string."
3146 msgstr ""
3147
3148 # type: textblock
3149 #. type: textblock
3150 #: ../src/guestfs.pod:1434
3151 msgid ""
3152 "C<errno> is not passed to the callback.  To get that the callback must call "
3153 "L</guestfs_last_errno>."
3154 msgstr ""
3155
3156 # type: textblock
3157 #. type: textblock
3158 #: ../src/guestfs.pod:1437
3159 msgid ""
3160 "Note that the message string C<msg> is freed as soon as the callback "
3161 "function returns, so if you want to stash it somewhere you must make your "
3162 "own copy."
3163 msgstr ""
3164
3165 # type: textblock
3166 #. type: textblock
3167 #: ../src/guestfs.pod:1441
3168 msgid "The default handler prints messages on C<stderr>."
3169 msgstr ""
3170
3171 # type: textblock
3172 #. type: textblock
3173 #: ../src/guestfs.pod:1443
3174 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3175 msgstr ""
3176
3177 # type: =head2
3178 #. type: =head2
3179 #: ../src/guestfs.pod:1445
3180 msgid "guestfs_get_error_handler"
3181 msgstr ""
3182
3183 # type: verbatim
3184 #. type: verbatim
3185 #: ../src/guestfs.pod:1447
3186 #, no-wrap
3187 msgid ""
3188 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3189 "                                                     void **opaque_rtn);\n"
3190 "\n"
3191 msgstr ""
3192
3193 # type: textblock
3194 #. type: textblock
3195 #: ../src/guestfs.pod:1450
3196 msgid "Returns the current error handler callback."
3197 msgstr ""
3198
3199 # type: =head2
3200 #. type: =head2
3201 #: ../src/guestfs.pod:1452
3202 msgid "guestfs_set_out_of_memory_handler"
3203 msgstr ""
3204
3205 # type: verbatim
3206 #. type: verbatim
3207 #: ../src/guestfs.pod:1454
3208 #, no-wrap
3209 msgid ""
3210 " typedef void (*guestfs_abort_cb) (void);\n"
3211 " int guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3212 "                                        guestfs_abort_cb);\n"
3213 "\n"
3214 msgstr ""
3215
3216 # type: textblock
3217 #. type: textblock
3218 #: ../src/guestfs.pod:1458
3219 msgid ""
3220 "The callback C<cb> will be called if there is an out of memory situation.  "
3221 "I<Note this callback must not return>."
3222 msgstr ""
3223
3224 # type: textblock
3225 #. type: textblock
3226 #: ../src/guestfs.pod:1461
3227 msgid "The default is to call L<abort(3)>."
3228 msgstr ""
3229
3230 # type: textblock
3231 #. type: textblock
3232 #: ../src/guestfs.pod:1463
3233 msgid ""
3234 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3235 msgstr ""
3236
3237 # type: =head2
3238 #. type: =head2
3239 #: ../src/guestfs.pod:1466
3240 msgid "guestfs_get_out_of_memory_handler"
3241 msgstr ""
3242
3243 # type: verbatim
3244 #. type: verbatim
3245 #: ../src/guestfs.pod:1468
3246 #, no-wrap
3247 msgid ""
3248 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3249 "\n"
3250 msgstr ""
3251
3252 # type: textblock
3253 #. type: textblock
3254 #: ../src/guestfs.pod:1470
3255 msgid "This returns the current out of memory handler."
3256 msgstr ""
3257
3258 # type: =head1
3259 #. type: =head1
3260 #: ../src/guestfs.pod:1472
3261 msgid "API CALLS"
3262 msgstr ""
3263
3264 # type: textblock
3265 #. type: textblock
3266 #: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1010
3267 msgid "@ACTIONS@"
3268 msgstr ""
3269
3270 # type: =head1
3271 #. type: =head1
3272 #: ../src/guestfs.pod:1476
3273 msgid "STRUCTURES"
3274 msgstr ""
3275
3276 # type: textblock
3277 #. type: textblock
3278 #: ../src/guestfs.pod:1478
3279 msgid "@STRUCTS@"
3280 msgstr ""
3281
3282 # type: =head1
3283 #. type: =head1
3284 #: ../src/guestfs.pod:1480
3285 msgid "AVAILABILITY"
3286 msgstr ""
3287
3288 # type: =head2
3289 #. type: =head2
3290 #: ../src/guestfs.pod:1482
3291 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3292 msgstr ""
3293
3294 # type: textblock
3295 #. type: textblock
3296 #: ../src/guestfs.pod:1484
3297 msgid ""
3298 "Using L</guestfs_available> you can test availability of the following "
3299 "groups of functions.  This test queries the appliance to see if the "
3300 "appliance you are currently using supports the functionality."
3301 msgstr ""
3302
3303 # type: textblock
3304 #. type: textblock
3305 #: ../src/guestfs.pod:1489
3306 msgid "@AVAILABILITY@"
3307 msgstr ""
3308
3309 # type: =head2
3310 #. type: =head2
3311 #: ../src/guestfs.pod:1491
3312 msgid "GUESTFISH supported COMMAND"
3313 msgstr ""
3314
3315 # type: textblock
3316 #. type: textblock
3317 #: ../src/guestfs.pod:1493
3318 msgid ""
3319 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3320 "prints out the available groups and whether they are supported by this build "
3321 "of libguestfs.  Note however that you have to do C<run> first."
3322 msgstr ""
3323
3324 # type: =head2
3325 #. type: =head2
3326 #: ../src/guestfs.pod:1498
3327 msgid "SINGLE CALLS AT COMPILE TIME"
3328 msgstr ""
3329
3330 # type: textblock
3331 #. type: textblock
3332 #: ../src/guestfs.pod:1500
3333 msgid ""
3334 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3335 "function, such as:"
3336 msgstr ""
3337
3338 # type: verbatim
3339 #. type: verbatim
3340 #: ../src/guestfs.pod:1503
3341 #, no-wrap
3342 msgid ""
3343 " #define LIBGUESTFS_HAVE_DD 1\n"
3344 "\n"
3345 msgstr ""
3346
3347 # type: textblock
3348 #. type: textblock
3349 #: ../src/guestfs.pod:1505
3350 msgid "if L</guestfs_dd> is available."
3351 msgstr ""
3352
3353 # type: textblock
3354 #. type: textblock
3355 #: ../src/guestfs.pod:1507
3356 msgid ""
3357 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3358 "function is available at compile time, we recommended using build tools such "
3359 "as autoconf or cmake.  For example in autotools you could use:"
3360 msgstr ""
3361
3362 # type: verbatim
3363 #. type: verbatim
3364 #: ../src/guestfs.pod:1512
3365 #, no-wrap
3366 msgid ""
3367 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3368 " AC_CHECK_FUNCS([guestfs_dd])\n"
3369 "\n"
3370 msgstr ""
3371
3372 # type: textblock
3373 #. type: textblock
3374 #: ../src/guestfs.pod:1515
3375 msgid ""
3376 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3377 "in your program."
3378 msgstr ""
3379
3380 # type: =head2
3381 #. type: =head2
3382 #: ../src/guestfs.pod:1518
3383 msgid "SINGLE CALLS AT RUN TIME"
3384 msgstr ""
3385
3386 # type: textblock
3387 #. type: textblock
3388 #: ../src/guestfs.pod:1520
3389 msgid ""
3390 "Testing at compile time doesn't guarantee that a function really exists in "
3391 "the library.  The reason is that you might be dynamically linked against a "
3392 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3393 "This situation unfortunately results in a segmentation fault, which is a "
3394 "shortcoming of the C dynamic linking system itself."
3395 msgstr ""
3396
3397 # type: textblock
3398 #. type: textblock
3399 #: ../src/guestfs.pod:1527
3400 msgid ""
3401 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3402 "in this example program (note that you still need the compile time check as "
3403 "well):"
3404 msgstr ""
3405
3406 # type: verbatim
3407 #. type: verbatim
3408 #: ../src/guestfs.pod:1531
3409 #, no-wrap
3410 msgid ""
3411 " #include <stdio.h>\n"
3412 " #include <stdlib.h>\n"
3413 " #include <unistd.h>\n"
3414 " #include <dlfcn.h>\n"
3415 " #include <guestfs.h>\n"
3416 " \n"
3417 msgstr ""
3418
3419 # type: verbatim
3420 #. type: verbatim
3421 #: ../src/guestfs.pod:1537
3422 #, no-wrap
3423 msgid ""
3424 " main ()\n"
3425 " {\n"
3426 " #ifdef LIBGUESTFS_HAVE_DD\n"
3427 "   void *dl;\n"
3428 "   int has_function;\n"
3429 " \n"
3430 msgstr ""
3431
3432 # type: verbatim
3433 #. type: verbatim
3434 #: ../src/guestfs.pod:1543
3435 #, no-wrap
3436 msgid ""
3437 "   /* Test if the function guestfs_dd is really available. */\n"
3438 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3439 "   if (!dl) {\n"
3440 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3441 "     exit (EXIT_FAILURE);\n"
3442 "   }\n"
3443 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3444 "   dlclose (dl);\n"
3445 " \n"
3446 msgstr ""
3447
3448 # type: verbatim
3449 #. type: verbatim
3450 #: ../src/guestfs.pod:1552
3451 #, no-wrap
3452 msgid ""
3453 "   if (!has_function)\n"
3454 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3455 "   else {\n"
3456 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3457 "     /* Now it's safe to call\n"
3458 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3459 "     */\n"
3460 "   }\n"
3461 " #else\n"
3462 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3463 " #endif\n"
3464 "  }\n"
3465 "\n"
3466 msgstr ""
3467
3468 # type: textblock
3469 #. type: textblock
3470 #: ../src/guestfs.pod:1565
3471 msgid ""
3472 "You may think the above is an awful lot of hassle, and it is.  There are "
3473 "other ways outside of the C linking system to ensure that this kind of "
3474 "incompatibility never arises, such as using package versioning:"
3475 msgstr ""
3476
3477 # type: verbatim
3478 #. type: verbatim
3479 #: ../src/guestfs.pod:1570
3480 #, no-wrap
3481 msgid ""
3482 " Requires: libguestfs >= 1.0.80\n"
3483 "\n"
3484 msgstr ""
3485
3486 # type: =head1
3487 #. type: =head1
3488 #: ../src/guestfs.pod:1572
3489 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3490 msgstr ""
3491
3492 # type: textblock
3493 #. type: textblock
3494 #: ../src/guestfs.pod:1574
3495 msgid ""
3496 "A recent feature of the API is the introduction of calls which take optional "
3497 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3498 "takes variable arguments (ie. C<...>), as in this example:"
3499 msgstr ""
3500
3501 # type: verbatim
3502 #. type: verbatim
3503 #: ../src/guestfs.pod:1579
3504 #, no-wrap
3505 msgid ""
3506 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3507 "\n"
3508 msgstr ""
3509
3510 # type: textblock
3511 #. type: textblock
3512 #: ../src/guestfs.pod:1581
3513 msgid ""
3514 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3515 "call with no optional arguments specified:"
3516 msgstr ""
3517
3518 # type: verbatim
3519 #. type: verbatim
3520 #: ../src/guestfs.pod:1584
3521 #, no-wrap
3522 msgid ""
3523 " guestfs_add_drive_opts (g, filename, -1);\n"
3524 "\n"
3525 msgstr ""
3526
3527 # type: textblock
3528 #. type: textblock
3529 #: ../src/guestfs.pod:1586
3530 msgid "With a single optional argument:"
3531 msgstr ""
3532
3533 # type: verbatim
3534 #. type: verbatim
3535 #: ../src/guestfs.pod:1588
3536 #, no-wrap
3537 msgid ""
3538 " guestfs_add_drive_opts (g, filename,\n"
3539 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3540 "                         -1);\n"
3541 "\n"
3542 msgstr ""
3543
3544 # type: textblock
3545 #. type: textblock
3546 #: ../src/guestfs.pod:1592
3547 msgid "With two:"
3548 msgstr ""
3549
3550 # type: verbatim
3551 #. type: verbatim
3552 #: ../src/guestfs.pod:1594
3553 #, no-wrap
3554 msgid ""
3555 " guestfs_add_drive_opts (g, filename,\n"
3556 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3557 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3558 "                         -1);\n"
3559 "\n"
3560 msgstr ""
3561
3562 # type: textblock
3563 #. type: textblock
3564 #: ../src/guestfs.pod:1599
3565 msgid ""
3566 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3567 "happen!"
3568 msgstr ""
3569
3570 # type: =head2
3571 #. type: =head2
3572 #: ../src/guestfs.pod:1602
3573 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3574 msgstr ""
3575
3576 # type: textblock
3577 #. type: textblock
3578 #: ../src/guestfs.pod:1604
3579 msgid ""
3580 "The second variant has the same name with the suffix C<_va>, which works the "
3581 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3582 "example function, this is declared:"
3583 msgstr ""
3584
3585 # type: verbatim
3586 #. type: verbatim
3587 #: ../src/guestfs.pod:1608
3588 #, no-wrap
3589 msgid ""
3590 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3591 "                                va_list args);\n"
3592 "\n"
3593 msgstr ""
3594
3595 # type: =head2
3596 #. type: =head2
3597 #: ../src/guestfs.pod:1611
3598 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3599 msgstr ""
3600
3601 # type: textblock
3602 #. type: textblock
3603 #: ../src/guestfs.pod:1613
3604 msgid ""
3605 "The third variant is useful where you need to construct these calls.  You "
3606 "pass in a structure where you fill in the optional fields.  The structure "
3607 "has a bitmask as the first element which you must set to indicate which "
3608 "fields you have filled in.  For our example function the structure and call "
3609 "are declared:"
3610 msgstr ""
3611
3612 # type: verbatim
3613 #. type: verbatim
3614 #: ../src/guestfs.pod:1619
3615 #, no-wrap
3616 msgid ""
3617 " struct guestfs_add_drive_opts_argv {\n"
3618 "   uint64_t bitmask;\n"
3619 "   int readonly;\n"
3620 "   const char *format;\n"
3621 "   /* ... */\n"
3622 " };\n"
3623 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3624 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3625 "\n"
3626 msgstr ""
3627
3628 # type: textblock
3629 #. type: textblock
3630 #: ../src/guestfs.pod:1628
3631 msgid "You could call it like this:"
3632 msgstr ""
3633
3634 # type: verbatim
3635 #. type: verbatim
3636 #: ../src/guestfs.pod:1630
3637 #, no-wrap
3638 msgid ""
3639 " struct guestfs_add_drive_opts_argv optargs = {\n"
3640 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3641 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3642 "   .readonly = 1,\n"
3643 "   .format = \"qcow2\"\n"
3644 " };\n"
3645 " \n"
3646 msgstr ""
3647
3648 # type: verbatim
3649 #. type: verbatim
3650 #: ../src/guestfs.pod:1637
3651 #, no-wrap
3652 msgid ""
3653 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3654 "\n"
3655 msgstr ""
3656
3657 # type: textblock
3658 #. type: textblock
3659 #: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11
3660 #: ../src/guestfs-actions.pod:1858 ../fish/guestfish-actions.pod:9
3661 #: ../fish/guestfish-actions.pod:1262 ../tools/virt-win-reg.pl:704
3662 msgid "Notes:"
3663 msgstr ""
3664
3665 # type: textblock
3666 #. type: textblock
3667 #: ../src/guestfs.pod:1645
3668 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3669 msgstr ""
3670
3671 # type: textblock
3672 #. type: textblock
3673 #: ../src/guestfs.pod:1650
3674 msgid "You do not need to fill in all fields of the structure."
3675 msgstr ""
3676
3677 # type: textblock
3678 #. type: textblock
3679 #: ../src/guestfs.pod:1654
3680 msgid ""
3681 "There must be a one-to-one correspondence between fields of the structure "
3682 "that are filled in, and bits set in the bitmask."
3683 msgstr ""
3684
3685 # type: =head2
3686 #. type: =head2
3687 #: ../src/guestfs.pod:1659
3688 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3689 msgstr ""
3690
3691 # type: textblock
3692 #. type: textblock
3693 #: ../src/guestfs.pod:1661
3694 msgid ""
3695 "In other languages, optional arguments are expressed in the way that is "
3696 "natural for that language.  We refer you to the language-specific "
3697 "documentation for more details on that."
3698 msgstr ""
3699
3700 # type: textblock
3701 #. type: textblock
3702 #: ../src/guestfs.pod:1665
3703 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3704 msgstr ""
3705
3706 # type: =head2
3707 #. type: =head2
3708 #: ../src/guestfs.pod:1667
3709 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3710 msgstr ""
3711
3712 #. type: textblock
3713 #: ../src/guestfs.pod:1669
3714 msgid ""
3715 "B<Note:> This section documents the generic event mechanism introduced in "
3716 "libguestfs 1.10, which you should use in new code if possible.  The old "
3717 "functions C<guestfs_set_log_message_callback>, "
3718 "C<guestfs_set_subprocess_quit_callback>, "
3719 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
3720 "C<guestfs_set_progress_callback> are no longer documented in this manual "
3721 "page.  Because of the ABI guarantee, the old functions continue to work."
3722 msgstr ""
3723
3724 #. type: textblock
3725 #: ../src/guestfs.pod:1678
3726 msgid ""
3727 "Handles generate events when certain things happen, such as log messages "
3728 "being generated, progress messages during long-running operations, or the "
3729 "handle being closed.  The API calls described below let you register a "
3730 "callback to be called when events happen.  You can register multiple "
3731 "callbacks (for the same, different or overlapping sets of events), and "
3732 "individually remove callbacks.  If callbacks are not removed, then they "
3733 "remain in force until the handle is closed."
3734 msgstr ""
3735
3736 #. type: textblock
3737 #: ../src/guestfs.pod:1686
3738 msgid ""
3739 "In the current implementation, events are only generated synchronously: that "
3740 "means that events (and hence callbacks) can only happen while you are in the "
3741 "middle of making another libguestfs call.  The callback is called in the "
3742 "same thread."
3743 msgstr ""
3744
3745 #. type: textblock
3746 #: ../src/guestfs.pod:1691
3747 msgid ""
3748 "Events may contain a payload, usually nothing (void), an array of 64 bit "
3749 "unsigned integers, or a message buffer.  Payloads are discussed later on."
3750 msgstr ""
3751
3752 #. type: =head3
3753 #: ../src/guestfs.pod:1695
3754 msgid "CLASSES OF EVENTS"
3755 msgstr ""
3756
3757 #. type: =item
3758 #: ../src/guestfs.pod:1699
3759 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
3760 msgstr ""
3761
3762 #. type: textblock
3763 #: ../src/guestfs.pod:1702
3764 msgid ""
3765 "The callback function will be called while the handle is being closed "
3766 "(synchronously from L</guestfs_close>)."
3767 msgstr ""
3768
3769 # type: textblock
3770 #. type: textblock
3771 #: ../src/guestfs.pod:1705
3772 msgid ""
3773 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3774 "handles that are open when the program exits.  This means that this callback "
3775 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3776 "problems in higher-level languages (eg. if your HLL interpreter has already "
3777 "been cleaned up by the time this is called, and if your callback then jumps "
3778 "into some HLL function)."
3779 msgstr ""
3780
3781 #. type: textblock
3782 #: ../src/guestfs.pod:1712
3783 msgid ""
3784 "If no callback is registered: the handle is closed without any callback "
3785 "being invoked."
3786 msgstr ""
3787
3788 #. type: =item
3789 #: ../src/guestfs.pod:1715
3790 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
3791 msgstr ""
3792
3793 #. type: textblock
3794 #: ../src/guestfs.pod:1718
3795 msgid ""
3796 "The callback function will be called when the child process quits, either "
3797 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3798 "corresponds to a transition from any state to the CONFIG state)."
3799 msgstr ""
3800
3801 #. type: textblock
3802 #: ../src/guestfs.pod:1722 ../src/guestfs.pod:1731
3803 msgid "If no callback is registered: the event is ignored."
3804 msgstr ""
3805
3806 #. type: =item
3807 #: ../src/guestfs.pod:1724
3808 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
3809 msgstr ""
3810
3811 #. type: textblock
3812 #: ../src/guestfs.pod:1727
3813 msgid ""
3814 "The callback function will be called when the child process becomes ready "
3815 "first time after it has been launched.  (This corresponds to a transition "
3816 "from LAUNCHING to the READY state)."
3817 msgstr ""
3818
3819 #. type: =item
3820 #: ../src/guestfs.pod:1733
3821 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
3822 msgstr ""
3823
3824 # type: textblock
3825 #. type: textblock
3826 #: ../src/guestfs.pod:1736
3827 msgid ""
3828 "Some long-running operations can generate progress messages.  If this "
3829 "callback is registered, then it will be called each time a progress message "
3830 "is generated (usually two seconds after the operation started, and three "
3831 "times per second thereafter until it completes, although the frequency may "
3832 "change in future versions)."
3833 msgstr ""
3834
3835 #. type: textblock
3836 #: ../src/guestfs.pod:1742
3837 msgid ""
3838 "The callback receives in the payload four unsigned 64 bit numbers which are "
3839 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
3840 msgstr ""
3841
3842 #. type: textblock
3843 #: ../src/guestfs.pod:1745
3844 msgid ""
3845 "The units of C<total> are not defined, although for some operations C<total> "
3846 "may relate in some way to the amount of data to be transferred (eg. in bytes "
3847 "or megabytes), and C<position> may be the portion which has been transferred."
3848 msgstr ""
3849
3850 # type: textblock
3851 #. type: textblock
3852 #: ../src/guestfs.pod:1750
3853 msgid "The only defined and stable parts of the API are:"
3854 msgstr ""
3855
3856 # type: textblock
3857 #. type: textblock
3858 #: ../src/guestfs.pod:1756
3859 msgid ""
3860 "The callback can display to the user some type of progress bar or indicator "
3861 "which shows the ratio of C<position>:C<total>."
3862 msgstr ""
3863
3864 # type: textblock
3865 #. type: textblock
3866 #: ../src/guestfs.pod:1761
3867 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3868 msgstr ""
3869
3870 #. type: textblock
3871 #: ../src/guestfs.pod:1765
3872 msgid ""
3873 "If any progress notification is sent during a call, then a final progress "
3874 "notification is always sent when C<position> = C<total> (I<unless> the call "
3875 "fails with an error)."
3876 msgstr ""
3877
3878 # type: textblock
3879 #. type: textblock
3880 #: ../src/guestfs.pod:1769
3881 msgid ""
3882 "This is to simplify caller code, so callers can easily set the progress "
3883 "indicator to \"100%\" at the end of the operation, without requiring special "
3884 "code to detect this case."
3885 msgstr ""
3886
3887 #. type: textblock
3888 #: ../src/guestfs.pod:1775
3889 msgid ""
3890 "For some calls we are unable to estimate the progress of the call, but we "
3891 "can still generate progress messages to indicate activity.  This is known as "
3892 "\"pulse mode\", and is directly supported by certain progress bar "
3893 "implementations (eg. GtkProgressBar)."
3894 msgstr ""
3895
3896 #. type: textblock
3897 #: ../src/guestfs.pod:1780
3898 msgid ""
3899 "For these calls, zero or more progress messages are generated with "
3900 "C<position = 0> and C<total = 1>, followed by a final message with "
3901 "C<position = total = 1>."
3902 msgstr ""
3903
3904 #. type: textblock
3905 #: ../src/guestfs.pod:1784
3906 msgid ""
3907 "As noted above, if the call fails with an error then the final message may "
3908 "not be generated."
3909 msgstr ""
3910
3911 #. type: textblock
3912 #: ../src/guestfs.pod:1789
3913 msgid ""
3914 "The callback also receives the procedure number (C<proc_nr>) and serial "
3915 "number (C<serial>) of the call.  These are only useful for debugging "
3916 "protocol issues, and the callback can normally ignore them.  The callback "
3917 "may want to print these numbers in error messages or debugging messages."
3918 msgstr ""
3919
3920 #. type: textblock
3921 #: ../src/guestfs.pod:1795
3922 msgid "If no callback is registered: progress messages are discarded."
3923 msgstr ""
3924
3925 #. type: =item
3926 #: ../src/guestfs.pod:1797
3927 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
3928 msgstr ""
3929
3930 #. type: textblock
3931 #: ../src/guestfs.pod:1800
3932 msgid ""
3933 "The callback function is called whenever a log message is generated by qemu, "
3934 "the appliance kernel, guestfsd (daemon), or utility programs."
3935 msgstr ""
3936
3937 #. type: textblock
3938 #: ../src/guestfs.pod:1803
3939 msgid ""
3940 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
3941 "guestfs_launch>) then additional debug messages are generated."
3942 msgstr ""
3943
3944 #. type: textblock
3945 #: ../src/guestfs.pod:1806 ../src/guestfs.pod:1820
3946 msgid ""
3947 "If no callback is registered: the messages are discarded unless the verbose "
3948 "flag is set in which case they are sent to stderr.  You can override the "
3949 "printing of verbose messages to stderr by setting up a callback."
3950 msgstr ""
3951
3952 #. type: =item
3953 #: ../src/guestfs.pod:1811
3954 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
3955 msgstr ""
3956
3957 #. type: textblock
3958 #: ../src/guestfs.pod:1814
3959 msgid ""
3960 "The callback function is called whenever a log message is generated by the "
3961 "library part of libguestfs."
3962 msgstr ""
3963
3964 #. type: textblock
3965 #: ../src/guestfs.pod:1817
3966 msgid ""
3967 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
3968 "messages are generated."
3969 msgstr ""
3970
3971 #. type: =item
3972 #: ../src/guestfs.pod:1825
3973 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
3974 msgstr ""
3975
3976 #. type: textblock
3977 #: ../src/guestfs.pod:1828
3978 msgid ""
3979 "The callback function is called whenever a trace message is generated.  This "
3980 "only applies if the trace flag (L</guestfs_set_trace>) is set."
3981 msgstr ""
3982
3983 #. type: textblock
3984 #: ../src/guestfs.pod:1831
3985 msgid ""
3986 "If no callback is registered: the messages are sent to stderr.  You can "
3987 "override the printing of trace messages to stderr by setting up a callback."
3988 msgstr ""
3989
3990 #. type: =head3
3991 #: ../src/guestfs.pod:1837
3992 msgid "guestfs_set_event_callback"
3993 msgstr ""
3994
3995 #. type: verbatim
3996 #: ../src/guestfs.pod:1839
3997 #, no-wrap
3998 msgid ""
3999 " int guestfs_set_event_callback (guestfs_h *g,\n"
4000 "                                 guestfs_event_callback cb,\n"
4001 "                                 uint64_t event_bitmask,\n"
4002 "                                 int flags,\n"
4003 "                                 void *opaque);\n"
4004 "\n"
4005 msgstr ""
4006
4007 #. type: textblock
4008 #: ../src/guestfs.pod:1845
4009 msgid ""
4010 "This function registers a callback (C<cb>) for all event classes in the "
4011 "C<event_bitmask>."
4012 msgstr ""
4013
4014 #. type: textblock
4015 #: ../src/guestfs.pod:1848
4016 msgid ""
4017 "For example, to register for all log message events, you could call this "
4018 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
4019 "To register a single callback for all possible classes of events, use "
4020 "C<GUESTFS_EVENT_ALL>."
4021 msgstr ""
4022
4023 #. type: textblock
4024 #: ../src/guestfs.pod:1854
4025 msgid "C<flags> should always be passed as 0."
4026 msgstr ""
4027
4028 #. type: textblock
4029 #: ../src/guestfs.pod:1856
4030 msgid ""
4031 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
4032 "it for any purpose."
4033 msgstr ""
4034
4035 #. type: textblock
4036 #: ../src/guestfs.pod:1859
4037 msgid ""
4038 "The return value is the event handle (an integer) which you can use to "
4039 "delete the callback (see below)."
4040 msgstr ""
4041
4042 #. type: textblock
4043 #: ../src/guestfs.pod:1862
4044 msgid ""
4045 "If there is an error, this function returns C<-1>, and sets the error in the "
4046 "handle in the usual way (see L</guestfs_last_error> etc.)"
4047 msgstr ""
4048
4049 #. type: textblock
4050 #: ../src/guestfs.pod:1865
4051 msgid ""
4052 "Callbacks remain in effect until they are deleted, or until the handle is "
4053 "closed."
4054 msgstr ""
4055
4056 #. type: textblock
4057 #: ../src/guestfs.pod:1868
4058 msgid ""
4059 "In the case where multiple callbacks are registered for a particular event "
4060 "class, all of the callbacks are called.  The order in which multiple "
4061 "callbacks are called is not defined."
4062 msgstr ""
4063
4064 #. type: =head3
4065 #: ../src/guestfs.pod:1872
4066 msgid "guestfs_delete_event_callback"
4067 msgstr ""
4068
4069 #. type: verbatim
4070 #: ../src/guestfs.pod:1874
4071 #, no-wrap
4072 msgid ""
4073 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
4074 "\n"
4075 msgstr ""
4076
4077 #. type: textblock
4078 #: ../src/guestfs.pod:1876
4079 msgid ""
4080 "Delete a callback that was previously registered.  C<event_handle> should be "
4081 "the integer that was returned by a previous call to "
4082 "C<guestfs_set_event_callback> on the same handle."
4083 msgstr ""
4084
4085 #. type: =head3
4086 #: ../src/guestfs.pod:1880
4087 msgid "guestfs_event_callback"
4088 msgstr ""
4089
4090 #. type: verbatim
4091 #: ../src/guestfs.pod:1882
4092 #, no-wrap
4093 msgid ""
4094 " typedef void (*guestfs_event_callback) (\n"
4095 "                  guestfs_h *g,\n"
4096 "                  void *opaque,\n"
4097 "                  uint64_t event,\n"
4098 "                  int event_handle,\n"
4099 "                  int flags,\n"
4100 "                  const char *buf, size_t buf_len,\n"
4101 "                  const uint64_t *array, size_t array_len);\n"
4102 "\n"
4103 msgstr ""
4104
4105 #. type: textblock
4106 #: ../src/guestfs.pod:1891
4107 msgid ""
4108 "This is the type of the event callback function that you have to provide."
4109 msgstr ""
4110
4111 #. type: textblock
4112 #: ../src/guestfs.pod:1894
4113 msgid ""
4114 "The basic parameters are: the handle (C<g>), the opaque user pointer "
4115 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
4116 "handle, and C<flags> which in the current API you should ignore."
4117 msgstr ""
4118
4119 #. type: textblock
4120 #: ../src/guestfs.pod:1898
4121 msgid ""
4122 "The remaining parameters contain the event payload (if any).  Each event may "
4123 "contain a payload, which usually relates to the event class, but for future "
4124 "proofing your code should be written to handle any payload for any event "
4125 "class."
4126 msgstr ""
4127
4128 #. type: textblock
4129 #: ../src/guestfs.pod:1903
4130 msgid ""
4131 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
4132 "there is no message buffer).  Note that this message buffer can contain "
4133 "arbitrary 8 bit data, including NUL bytes."
4134 msgstr ""
4135
4136 #. type: textblock
4137 #: ../src/guestfs.pod:1907
4138 msgid ""
4139 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
4140 "moment this is only used for progress messages."
4141 msgstr ""
4142
4143 #. type: =head3
4144 #: ../src/guestfs.pod:1910
4145 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
4146 msgstr ""
4147
4148 #. type: textblock
4149 #: ../src/guestfs.pod:1912
4150 msgid ""
4151 "One motivation for the generic event API was to allow GUI programs to "
4152 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
4153 "unconditionally to C<stderr>."
4154 msgstr ""
4155
4156 #. type: textblock
4157 #: ../src/guestfs.pod:1916
4158 msgid ""
4159 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
4160 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
4161 "messages are not events; you must capture error messages separately)."
4162 msgstr ""
4163
4164 #. type: textblock
4165 #: ../src/guestfs.pod:1921
4166 msgid ""
4167 "Programs have to set up a callback to capture the classes of events of "
4168 "interest:"
4169 msgstr ""
4170
4171 #. type: verbatim
4172 #: ../src/guestfs.pod:1924
4173 #, no-wrap
4174 msgid ""
4175 " int eh =\n"
4176 "   guestfs_set_event_callback\n"
4177 "     (g, message_callback,\n"
4178 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
4179 "      GUESTFS_EVENT_TRACE,\n"
4180 "      0, NULL) == -1)\n"
4181 " if (eh == -1) {\n"
4182 "   // handle error in the usual way\n"
4183 " }\n"
4184 "\n"
4185 msgstr ""
4186
4187 #. type: textblock
4188 #: ../src/guestfs.pod:1934
4189 msgid ""
4190 "The callback can then direct messages to the appropriate place.  In this "
4191 "example, messages are directed to syslog:"
4192 msgstr ""
4193
4194 #. type: verbatim
4195 #: ../src/guestfs.pod:1937
4196 #, no-wrap
4197 msgid ""
4198 " static void\n"
4199 " message_callback (\n"
4200 "         guestfs_h *g,\n"
4201 "         void *opaque,\n"
4202 "         uint64_t event,\n"
4203 "         int event_handle,\n"
4204 "         int flags,\n"
4205 "         const char *buf, size_t buf_len,\n"
4206 "         const uint64_t *array, size_t array_len)\n"
4207 " {\n"
4208 "   const int priority = LOG_USER|LOG_INFO;\n"
4209 "   if (buf_len > 0)\n"
4210 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
4211 " }\n"
4212 "\n"
4213 msgstr ""
4214
4215 # type: =head1
4216 #. type: =head1
4217 #: ../src/guestfs.pod:1952
4218 msgid "PRIVATE DATA AREA"
4219 msgstr ""
4220
4221 #. type: textblock
4222 #: ../src/guestfs.pod:1954
4223 msgid ""
4224 "You can attach named pieces of private data to the libguestfs handle, fetch "
4225 "them by name, and walk over them, for the lifetime of the handle.  This is "
4226 "called the private data area and is only available from the C API."
4227 msgstr ""
4228
4229 # type: textblock
4230 #. type: textblock
4231 #: ../src/guestfs.pod:1959
4232 msgid "To attach a named piece of data, use the following call:"
4233 msgstr ""
4234
4235 # type: verbatim
4236 #. type: verbatim
4237 #: ../src/guestfs.pod:1961
4238 #, no-wrap
4239 msgid ""
4240 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
4241 "\n"
4242 msgstr ""
4243
4244 #. type: textblock
4245 #: ../src/guestfs.pod:1963
4246 msgid ""
4247 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
4248 "pointer (which can be C<NULL>).  Any previous item with the same key is "
4249 "overwritten."
4250 msgstr ""
4251
4252 #. type: textblock
4253 #: ../src/guestfs.pod:1967
4254 msgid ""
4255 "You can use any C<key> you want, but your key should I<not> start with an "
4256 "underscore character.  Keys beginning with an underscore character are "
4257 "reserved for internal libguestfs purposes (eg. for implementing language "
4258 "bindings).  It is recommended that you prefix the key with some unique "
4259 "string to avoid collisions with other users."
4260 msgstr ""
4261
4262 # type: textblock
4263 #. type: textblock
4264 #: ../src/guestfs.pod:1973
4265 msgid "To retrieve the pointer, use:"
4266 msgstr ""
4267
4268 # type: verbatim
4269 #. type: verbatim
4270 #: ../src/guestfs.pod:1975
4271 #, no-wrap
4272 msgid ""
4273 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
4274 "\n"
4275 msgstr ""
4276
4277 # type: textblock
4278 #. type: textblock
4279 #: ../src/guestfs.pod:1977
4280 msgid ""
4281 "This function returns C<NULL> if either no data is found associated with "
4282 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
4283 "C<NULL>."
4284 msgstr ""
4285
4286 #. type: textblock
4287 #: ../src/guestfs.pod:1981
4288 msgid ""
4289 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
4290 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
4291 "all.  In particular, libguestfs does I<not> try to free the data when the "
4292 "handle is closed.  If the data must be freed, then the caller must either "
4293 "free it before calling L</guestfs_close> or must set up a close callback to "
4294 "do it (see L</GUESTFS_EVENT_CLOSE>)."
4295 msgstr ""
4296
4297 #. type: textblock
4298 #: ../src/guestfs.pod:1988
4299 msgid "To walk over all entries, use these two functions:"
4300 msgstr ""
4301
4302 #. type: verbatim
4303 #: ../src/guestfs.pod:1990
4304 #, no-wrap
4305 msgid ""
4306 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
4307 "\n"
4308 msgstr ""
4309
4310 #. type: verbatim
4311 #: ../src/guestfs.pod:1992
4312 #, no-wrap
4313 msgid ""
4314 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
4315 "\n"
4316 msgstr ""
4317
4318 #. type: textblock
4319 #: ../src/guestfs.pod:1994
4320 msgid ""
4321 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
4322 "not have any particular meaning -- keys are not returned in any defined "
4323 "order).  A pointer to the key is returned in C<*key_rtn> and the "
4324 "corresponding data pointer is returned from the function.  C<NULL> is "
4325 "returned if there are no keys stored in the handle."
4326 msgstr ""
4327
4328 #. type: textblock
4329 #: ../src/guestfs.pod:2000
4330 msgid ""
4331 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
4332 "value of this function is also C<NULL> is there are no further entries to "
4333 "return."
4334 msgstr ""
4335
4336 #. type: textblock
4337 #: ../src/guestfs.pod:2004
4338 msgid "Notes about walking over entries:"
4339 msgstr ""
4340
4341 #. type: textblock
4342 #: ../src/guestfs.pod:2010
4343 msgid ""
4344 "You must not call C<guestfs_set_private> while walking over the entries."
4345 msgstr ""
4346
4347 #. type: textblock
4348 #: ../src/guestfs.pod:2015
4349 msgid ""
4350 "The handle maintains an internal iterator which is reset when you call "
4351 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
4352 "call C<guestfs_set_private>."
4353 msgstr ""
4354
4355 #. type: textblock
4356 #: ../src/guestfs.pod:2021
4357 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
4358 msgstr ""
4359
4360 #. type: verbatim
4361 #: ../src/guestfs.pod:2023
4362 #, no-wrap
4363 msgid ""
4364 " guestfs_set_private (g, key, NULL);\n"
4365 "\n"
4366 msgstr ""
4367
4368 #. type: textblock
4369 #: ../src/guestfs.pod:2025
4370 msgid "then that C<key> is not returned when walking."
4371 msgstr ""
4372
4373 #. type: textblock
4374 #: ../src/guestfs.pod:2029
4375 msgid ""
4376 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
4377 "C<guestfs_next_private> or C<guestfs_set_private>."
4378 msgstr ""
4379
4380 #. type: textblock
4381 #: ../src/guestfs.pod:2035
4382 msgid ""
4383 "The following example code shows how to print all keys and data pointers "
4384 "that are associated with the handle C<g>:"
4385 msgstr ""
4386
4387 #. type: verbatim
4388 #: ../src/guestfs.pod:2038
4389 #, no-wrap
4390 msgid ""
4391 " const char *key;\n"
4392 " void *data = guestfs_first_private (g, &key);\n"
4393 " while (data != NULL)\n"
4394 "   {\n"
4395 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
4396 "     data = guestfs_next_private (g, &key);\n"
4397 "   }\n"
4398 "\n"
4399 msgstr ""
4400
4401 #. type: textblock
4402 #: ../src/guestfs.pod:2046
4403 msgid ""
4404 "More commonly you are only interested in keys that begin with an application-"
4405 "specific prefix C<foo_>.  Modify the loop like so:"
4406 msgstr ""
4407
4408 #. type: verbatim
4409 #: ../src/guestfs.pod:2049
4410 #, no-wrap
4411 msgid ""
4412 " const char *key;\n"
4413 " void *data = guestfs_first_private (g, &key);\n"
4414 " while (data != NULL)\n"
4415 "   {\n"
4416 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4417 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
4418 "     data = guestfs_next_private (g, &key);\n"
4419 "   }\n"
4420 "\n"
4421 msgstr ""
4422
4423 #. type: textblock
4424 #: ../src/guestfs.pod:2058
4425 msgid ""
4426 "If you need to modify keys while walking, then you have to jump back to the "
4427 "beginning of the loop.  For example, to delete all keys prefixed with "
4428 "C<foo_>:"
4429 msgstr ""
4430
4431 #. type: verbatim
4432 #: ../src/guestfs.pod:2062
4433 #, no-wrap
4434 msgid ""
4435 "  const char *key;\n"
4436 "  void *data;\n"
4437 " again:\n"
4438 "  data = guestfs_first_private (g, &key);\n"
4439 "  while (data != NULL)\n"
4440 "    {\n"
4441 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4442 "        {\n"
4443 "          guestfs_set_private (g, key, NULL);\n"
4444 "          /* note that 'key' pointer is now invalid, and so is\n"
4445 "             the internal iterator */\n"
4446 "          goto again;\n"
4447 "        }\n"
4448 "      data = guestfs_next_private (g, &key);\n"
4449 "    }\n"
4450 "\n"
4451 msgstr ""
4452
4453 #. type: textblock
4454 #: ../src/guestfs.pod:2078
4455 msgid ""
4456 "Note that the above loop is guaranteed to terminate because the keys are "
4457 "being deleted, but other manipulations of keys within the loop might not "
4458 "terminate unless you also maintain an indication of which keys have been "
4459 "visited."
4460 msgstr ""
4461
4462 # type: =end
4463 #. type: =end
4464 #: ../src/guestfs.pod:2083 ../src/guestfs.pod:2088
4465 msgid "html"
4466 msgstr ""
4467
4468 # type: textblock
4469 #. type: textblock
4470 #: ../src/guestfs.pod:2085
4471 msgid ""
4472 "<!-- old anchor for the next section --> <a name="
4473 "\"state_machine_and_low_level_event_api\"/>"
4474 msgstr ""
4475
4476 # type: =head1
4477 #. type: =head1
4478 #: ../src/guestfs.pod:2090
4479 msgid "ARCHITECTURE"
4480 msgstr ""
4481
4482 # type: textblock
4483 #. type: textblock
4484 #: ../src/guestfs.pod:2092
4485 msgid ""
4486 "Internally, libguestfs is implemented by running an appliance (a special "
4487 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4488 "process of the main program."
4489 msgstr ""
4490
4491 # type: verbatim
4492 #. type: verbatim
4493 #: ../src/guestfs.pod:2096
4494 #, no-wrap
4495 msgid ""
4496 "  ___________________\n"
4497 " /                   \\\n"
4498 " | main program      |\n"
4499 " |                   |\n"
4500 " |                   |           child process / appliance\n"
4501 " |                   |           __________________________\n"
4502 " |                   |          / qemu                     \\\n"
4503 " +-------------------+   RPC    |      +-----------------+ |\n"
4504 " | libguestfs     <--------------------> guestfsd        | |\n"
4505 " |                   |          |      +-----------------+ |\n"
4506 " \\___________________/          |      | Linux kernel    | |\n"
4507 "                                |      +--^--------------+ |\n"
4508 "                                \\_________|________________/\n"
4509 "                                          |\n"
4510 "                                   _______v______\n"
4511 "                                  /              \\\n"
4512 "                                  | Device or    |\n"
4513 "                                  | disk image   |\n"
4514 "                                  \\______________/\n"
4515 "\n"
4516 msgstr ""
4517
4518 # type: textblock
4519 #. type: textblock
4520 #: ../src/guestfs.pod:2116
4521 msgid ""
4522 "The library, linked to the main program, creates the child process and hence "
4523 "the appliance in the L</guestfs_launch> function."
4524 msgstr ""
4525
4526 # type: textblock
4527 #. type: textblock
4528 #: ../src/guestfs.pod:2119
4529 msgid ""
4530 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4531 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4532 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4533 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4534 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4535 "attached to the qemu process which translates device access by the "
4536 "appliance's Linux kernel into accesses to the image."
4537 msgstr ""
4538
4539 # type: textblock
4540 #. type: textblock
4541 #: ../src/guestfs.pod:2128
4542 msgid ""
4543 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4544 "Although the disk image you are attached to might also be used by some "
4545 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4546 "care if both libguestfs's qemu process and your virtual machine are trying "
4547 "to update the disk image at the same time, since these usually results in "
4548 "massive disk corruption)."
4549 msgstr ""
4550
4551 # type: =head1
4552 #. type: =head1
4553 #: ../src/guestfs.pod:2135
4554 msgid "STATE MACHINE"
4555 msgstr ""
4556
4557 # type: textblock
4558 #. type: textblock
4559 #: ../src/guestfs.pod:2137
4560 msgid "libguestfs uses a state machine to model the child process:"
4561 msgstr ""
4562
4563 # type: verbatim
4564 #. type: verbatim
4565 #: ../src/guestfs.pod:2139
4566 #, no-wrap
4567 msgid ""
4568 "                         |\n"
4569 "                    guestfs_create\n"
4570 "                         |\n"
4571 "                         |\n"
4572 "                     ____V_____\n"
4573 "                    /          \\\n"
4574 "                    |  CONFIG  |\n"
4575 "                    \\__________/\n"
4576 "                     ^ ^   ^  \\\n"
4577 "                    /  |    \\  \\ guestfs_launch\n"
4578 "                   /   |    _\\__V______\n"
4579 "                  /    |   /           \\\n"
4580 "                 /     |   | LAUNCHING |\n"
4581 "                /      |   \\___________/\n"
4582 "               /       |       /\n"
4583 "              /        |  guestfs_launch\n"
4584 "             /         |     /\n"
4585 "    ______  /        __|____V\n"
4586 "   /      \\ ------> /        \\\n"
4587 "   | BUSY |         | READY  |\n"
4588 "   \\______/ <------ \\________/\n"
4589 "\n"
4590 msgstr ""
4591
4592 # type: textblock
4593 #. type: textblock
4594 #: ../src/guestfs.pod:2161
4595 msgid ""
4596 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4597 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4598 "(3) alternating between READY and BUSY as commands are issued to, and "
4599 "carried out by, the child process."
4600 msgstr ""
4601
4602 # type: textblock
4603 #. type: textblock
4604 #: ../src/guestfs.pod:2166
4605 msgid ""
4606 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4607 "asynchronously at any time (eg. due to some internal error), and that causes "
4608 "the state to transition back to CONFIG."
4609 msgstr ""
4610
4611 # type: textblock
4612 #. type: textblock
4613 #: ../src/guestfs.pod:2170
4614 msgid ""
4615 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4616 "issued when in the CONFIG state."
4617 msgstr ""
4618
4619 # type: textblock
4620 #. type: textblock
4621 #: ../src/guestfs.pod:2173
4622 msgid ""
4623 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4624 "L</guestfs_launch> blocks until the child process is READY to accept "
4625 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4626 "moves the state from CONFIG to LAUNCHING while it is running."
4627 msgstr ""
4628
4629 # type: textblock
4630 #. type: textblock
4631 #: ../src/guestfs.pod:2179
4632 msgid ""
4633 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4634 "state.  These API calls block waiting for the command to be carried out (ie. "
4635 "the state to transition to BUSY and then back to READY).  There are no non-"
4636 "blocking versions, and no way to issue more than one command per handle at "
4637 "the same time."
4638 msgstr ""
4639
4640 # type: textblock
4641 #. type: textblock
4642 #: ../src/guestfs.pod:2185
4643 msgid ""
4644 "Finally, the child process sends asynchronous messages back to the main "
4645 "program, such as kernel log messages.  You can register a callback to "
4646 "receive these messages."
4647 msgstr ""
4648
4649 # type: =head1
4650 #. type: =head1
4651 #: ../src/guestfs.pod:2189
4652 msgid "INTERNALS"
4653 msgstr ""
4654
4655 # type: =head2
4656 #. type: =head2
4657 #: ../src/guestfs.pod:2191
4658 msgid "COMMUNICATION PROTOCOL"
4659 msgstr ""
4660
4661 # type: textblock
4662 #. type: textblock
4663 #: ../src/guestfs.pod:2193
4664 msgid ""
4665 "Don't rely on using this protocol directly.  This section documents how it "
4666 "currently works, but it may change at any time."
4667 msgstr ""
4668
4669 # type: textblock
4670 #. type: textblock
4671 #: ../src/guestfs.pod:2196
4672 msgid ""
4673 "The protocol used to talk between the library and the daemon running inside "
4674 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4675 "1014, RFC 1832, RFC 4506)."
4676 msgstr ""
4677
4678 # type: textblock
4679 #. type: textblock
4680 #: ../src/guestfs.pod:2200
4681 msgid ""
4682 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4683 "this file is automatically generated)."
4684 msgstr ""
4685
4686 # type: textblock
4687 #. type: textblock
4688 #: ../src/guestfs.pod:2203
4689 msgid ""
4690 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4691 "and C<FileOut> parameters, which are handled with very simple request/reply "
4692 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4693 "parameters, which use the same request and reply messages, but they may also "
4694 "be followed by files sent using a chunked encoding."
4695 msgstr ""
4696
4697 # type: =head3
4698 #. type: =head3
4699 #: ../src/guestfs.pod:2210
4700 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4701 msgstr ""
4702
4703 # type: textblock
4704 #. type: textblock
4705 #: ../src/guestfs.pod:2212
4706 msgid "For ordinary functions, the request message is:"
4707 msgstr ""
4708
4709 # type: verbatim
4710 #. type: verbatim
4711 #: ../src/guestfs.pod:2214
4712 #, no-wrap
4713 msgid ""
4714 " total length (header + arguments,\n"
4715 "      but not including the length word itself)\n"
4716 " struct guestfs_message_header (encoded as XDR)\n"
4717 " struct guestfs_<foo>_args (encoded as XDR)\n"
4718 "\n"
4719 msgstr ""
4720
4721 # type: textblock
4722 #. type: textblock
4723 #: ../src/guestfs.pod:2219
4724 msgid ""
4725 "The total length field allows the daemon to allocate a fixed size buffer "
4726 "into which it slurps the rest of the message.  As a result, the total length "
4727 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4728 "effective size of any request is limited to somewhere under this size."
4729 msgstr ""
4730
4731 # type: textblock
4732 #. type: textblock
4733 #: ../src/guestfs.pod:2225
4734 msgid ""
4735 "Note also that many functions don't take any arguments, in which case the "
4736 "C<guestfs_I<foo>_args> is completely omitted."
4737 msgstr ""
4738
4739 # type: textblock
4740 #. type: textblock
4741 #: ../src/guestfs.pod:2228
4742 msgid ""
4743 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4744 "receiver knows what type of args structure to expect, or none at all."
4745 msgstr ""
4746
4747 # type: textblock
4748 #. type: textblock
4749 #: ../src/guestfs.pod:2232
4750 msgid ""
4751 "For functions that take optional arguments, the optional arguments are "
4752 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4753 "arguments.  A bitmask in the header indicates which optional arguments are "
4754 "meaningful.  The bitmask is also checked to see if it contains bits set "
4755 "which the daemon does not know about (eg. if more optional arguments were "
4756 "added in a later version of the library), and this causes the call to be "
4757 "rejected."
4758 msgstr ""
4759
4760 # type: textblock
4761 #. type: textblock
4762 #: ../src/guestfs.pod:2240
4763 msgid "The reply message for ordinary functions is:"
4764 msgstr ""
4765
4766 # type: verbatim
4767 #. type: verbatim
4768 #: ../src/guestfs.pod:2242
4769 #, no-wrap
4770 msgid ""
4771 " total length (header + ret,\n"
4772 "      but not including the length word itself)\n"
4773 " struct guestfs_message_header (encoded as XDR)\n"
4774 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4775 "\n"
4776 msgstr ""
4777
4778 # type: textblock
4779 #. type: textblock
4780 #: ../src/guestfs.pod:2247
4781 msgid ""
4782 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4783 "functions that return no formal return values."
4784 msgstr ""
4785
4786 # type: textblock
4787 #. type: textblock
4788 #: ../src/guestfs.pod:2250
4789 msgid ""
4790 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4791 msgstr ""
4792
4793 # type: textblock
4794 #. type: textblock
4795 #: ../src/guestfs.pod:2253
4796 msgid ""
4797 "In the case of an error, a flag is set in the header, and the reply message "
4798 "is slightly changed:"
4799 msgstr ""
4800
4801 # type: verbatim
4802 #. type: verbatim
4803 #: ../src/guestfs.pod:2256
4804 #, no-wrap
4805 msgid ""
4806 " total length (header + error,\n"
4807 "      but not including the length word itself)\n"
4808 " struct guestfs_message_header (encoded as XDR)\n"
4809 " struct guestfs_message_error (encoded as XDR)\n"
4810 "\n"
4811 msgstr ""
4812
4813 # type: textblock
4814 #. type: textblock
4815 #: ../src/guestfs.pod:2261
4816 msgid ""
4817 "The C<guestfs_message_error> structure contains the error message as a "
4818 "string."
4819 msgstr ""
4820
4821 # type: =head3
4822 #. type: =head3
4823 #: ../src/guestfs.pod:2264
4824 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4825 msgstr ""
4826
4827 # type: textblock
4828 #. type: textblock
4829 #: ../src/guestfs.pod:2266
4830 msgid ""
4831 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4832 "The normal request message is sent (see above).  However this is followed by "
4833 "a sequence of file chunks."
4834 msgstr ""
4835
4836 # type: verbatim
4837 #. type: verbatim
4838 #: ../src/guestfs.pod:2270
4839 #, no-wrap
4840 msgid ""
4841 " total length (header + arguments,\n"
4842 "      but not including the length word itself,\n"
4843 "      and not including the chunks)\n"
4844 " struct guestfs_message_header (encoded as XDR)\n"
4845 " struct guestfs_<foo>_args (encoded as XDR)\n"
4846 " sequence of chunks for FileIn param #0\n"
4847 " sequence of chunks for FileIn param #1 etc.\n"
4848 "\n"
4849 msgstr ""
4850
4851 # type: textblock
4852 #. type: textblock
4853 #: ../src/guestfs.pod:2278
4854 msgid "The \"sequence of chunks\" is:"
4855 msgstr ""
4856
4857 # type: verbatim
4858 #. type: verbatim
4859 #: ../src/guestfs.pod:2280
4860 #, no-wrap
4861 msgid ""
4862 " length of chunk (not including length word itself)\n"
4863 " struct guestfs_chunk (encoded as XDR)\n"
4864 " length of chunk\n"
4865 " struct guestfs_chunk (encoded as XDR)\n"
4866 "   ...\n"
4867 " length of chunk\n"
4868 " struct guestfs_chunk (with data.data_len == 0)\n"
4869 "\n"
4870 msgstr ""
4871
4872 # type: textblock
4873 #. type: textblock
4874 #: ../src/guestfs.pod:2288
4875 msgid ""
4876 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4877 "is set in the final chunk to indicate either successful completion or early "
4878 "cancellation."
4879 msgstr ""
4880
4881 # type: textblock
4882 #. type: textblock
4883 #: ../src/guestfs.pod:2292
4884 msgid ""
4885 "At time of writing there are no functions that have more than one FileIn "
4886 "parameter.  However this is (theoretically) supported, by sending the "
4887 "sequence of chunks for each FileIn parameter one after another (from left to "
4888 "right)."
4889 msgstr ""
4890
4891 # type: textblock
4892 #. type: textblock
4893 #: ../src/guestfs.pod:2297
4894 msgid ""
4895 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4896 "transfer.  The library does this by sending a chunk with a special flag set "
4897 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4898 "RPC, does I<not> send any reply, and goes back to reading the next request."
4899 msgstr ""
4900
4901 # type: textblock
4902 #. type: textblock
4903 #: ../src/guestfs.pod:2303
4904 msgid ""
4905 "The daemon may also cancel.  It does this by writing a special word "
4906 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4907 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4908 "cancel chunk).  The special word is chosen so that even if cancellation "
4909 "happens right at the end of the transfer (after the library has finished "
4910 "writing and has started listening for the reply), the \"spurious\" cancel "
4911 "flag will not be confused with the reply message."
4912 msgstr ""
4913
4914 # type: textblock
4915 #. type: textblock
4916 #: ../src/guestfs.pod:2312
4917 msgid ""
4918 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4919 "limit), and also files where the size is not known in advance (eg. from "
4920 "pipes or sockets).  However the chunks are rather small "
4921 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4922 "to keep much in memory."
4923 msgstr ""
4924
4925 # type: =head3
4926 #. type: =head3
4927 #: ../src/guestfs.pod:2318
4928 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4929 msgstr ""
4930
4931 # type: textblock
4932 #. type: textblock
4933 #: ../src/guestfs.pod:2320
4934 msgid ""
4935 "The protocol for FileOut parameters is exactly the same as for FileIn "
4936 "parameters, but with the roles of daemon and library reversed."
4937 msgstr ""
4938
4939 # type: verbatim
4940 #. type: verbatim
4941 #: ../src/guestfs.pod:2323
4942 #, no-wrap
4943 msgid ""
4944 " total length (header + ret,\n"
4945 "      but not including the length word itself,\n"
4946 "      and not including the chunks)\n"
4947 " struct guestfs_message_header (encoded as XDR)\n"
4948 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4949 " sequence of chunks for FileOut param #0\n"
4950 " sequence of chunks for FileOut param #1 etc.\n"
4951 "\n"
4952 msgstr ""
4953
4954 # type: =head3
4955 #. type: =head3
4956 #: ../src/guestfs.pod:2331
4957 msgid "INITIAL MESSAGE"
4958 msgstr ""
4959
4960 # type: textblock
4961 #. type: textblock
4962 #: ../src/guestfs.pod:2333
4963 msgid ""
4964 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4965 "which indicates that the guest and daemon is alive.  This is what L</"
4966 "guestfs_launch> waits for."
4967 msgstr ""
4968
4969 # type: =head3
4970 #. type: =head3
4971 #: ../src/guestfs.pod:2337
4972 msgid "PROGRESS NOTIFICATION MESSAGES"
4973 msgstr ""
4974
4975 # type: textblock
4976 #. type: textblock
4977 #: ../src/guestfs.pod:2339
4978 msgid ""
4979 "The daemon may send progress notification messages at any time.  These are "
4980 "distinguished by the normal length word being replaced by "
4981 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4982 msgstr ""
4983
4984 #. type: textblock
4985 #: ../src/guestfs.pod:2343
4986 msgid ""
4987 "The library turns them into progress callbacks (see L</"
4988 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
4989 "if not."
4990 msgstr ""
4991
4992 # type: textblock
4993 #. type: textblock
4994 #: ../src/guestfs.pod:2347
4995 msgid ""
4996 "The daemon self-limits the frequency of progress messages it sends (see "
4997 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
4998 "messages."
4999 msgstr ""
5000
5001 # type: =head1
5002 #. type: =head1
5003 #: ../src/guestfs.pod:2351
5004 msgid "LIBGUESTFS VERSION NUMBERS"
5005 msgstr ""
5006
5007 # type: textblock
5008 #. type: textblock
5009 #: ../src/guestfs.pod:2353
5010 msgid ""
5011 "Since April 2010, libguestfs has started to make separate development and "
5012 "stable releases, along with corresponding branches in our git repository.  "
5013 "These separate releases can be identified by version number:"
5014 msgstr ""
5015
5016 # type: verbatim
5017 #. type: verbatim
5018 #: ../src/guestfs.pod:2358
5019 #, no-wrap
5020 msgid ""
5021 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
5022 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
5023 "       |\n"
5024 "       v\n"
5025 " 1  .  3  .  5\n"
5026 " ^           ^\n"
5027 " |           |\n"
5028 " |           `-------- sub-version\n"
5029 " |\n"
5030 " `------ always '1' because we don't change the ABI\n"
5031 "\n"
5032 msgstr ""
5033
5034 # type: textblock
5035 #. type: textblock
5036 #: ../src/guestfs.pod:2369
5037 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
5038 msgstr ""
5039
5040 # type: textblock
5041 #. type: textblock
5042 #: ../src/guestfs.pod:2371
5043 msgid ""
5044 "As time passes we cherry pick fixes from the development branch and backport "
5045 "those into the stable branch, the effect being that the stable branch should "
5046 "get more stable and less buggy over time.  So the stable releases are ideal "
5047 "for people who don't need new features but would just like the software to "
5048 "work."
5049 msgstr ""
5050
5051 # type: textblock
5052 #. type: textblock
5053 #: ../src/guestfs.pod:2377
5054 msgid "Our criteria for backporting changes are:"
5055 msgstr ""
5056
5057 # type: textblock
5058 #. type: textblock
5059 #: ../src/guestfs.pod:2383
5060 msgid ""
5061 "Documentation changes which don't affect any code are backported unless the "
5062 "documentation refers to a future feature which is not in stable."
5063 msgstr ""
5064
5065 # type: textblock
5066 #. type: textblock
5067 #: ../src/guestfs.pod:2389
5068 msgid ""
5069 "Bug fixes which are not controversial, fix obvious problems, and have been "
5070 "well tested are backported."
5071 msgstr ""
5072
5073 # type: textblock
5074 #. type: textblock
5075 #: ../src/guestfs.pod:2394
5076 msgid ""
5077 "Simple rearrangements of code which shouldn't affect how it works get "
5078 "backported.  This is so that the code in the two branches doesn't get too "
5079 "far out of step, allowing us to backport future fixes more easily."
5080 msgstr ""
5081
5082 # type: textblock
5083 #. type: textblock
5084 #: ../src/guestfs.pod:2400
5085 msgid ""
5086 "We I<don't> backport new features, new APIs, new tools etc, except in one "
5087 "exceptional case: the new feature is required in order to implement an "
5088 "important bug fix."
5089 msgstr ""
5090
5091 # type: textblock
5092 #. type: textblock
5093 #: ../src/guestfs.pod:2406
5094 msgid ""
5095 "A new stable branch starts when we think the new features in development are "
5096 "substantial and compelling enough over the current stable branch to warrant "
5097 "it.  When that happens we create new stable and development versions 1.N.0 "
5098 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
5099 "stable at this point, but by backporting fixes from development, that branch "
5100 "will stabilize over time."
5101 msgstr ""
5102
5103 #. type: =head1
5104 #: ../src/guestfs.pod:2414
5105 msgid "EXTENDING LIBGUESTFS"
5106 msgstr ""
5107
5108 #. type: =head2
5109 #: ../src/guestfs.pod:2416
5110 msgid "ADDING A NEW API ACTION"
5111 msgstr ""
5112
5113 #. type: textblock
5114 #: ../src/guestfs.pod:2418
5115 msgid ""
5116 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
5117 "documentation) are generated, and this makes it easy to extend the "
5118 "libguestfs API."
5119 msgstr ""
5120
5121 #. type: textblock
5122 #: ../src/guestfs.pod:2422
5123 msgid "To add a new API action there are two changes:"
5124 msgstr ""
5125
5126 #. type: textblock
5127 #: ../src/guestfs.pod:2428
5128 msgid ""
5129 "You need to add a description of the call (name, parameters, return type, "
5130 "tests, documentation) to C<generator/generator_actions.ml>."
5131 msgstr ""
5132
5133 #. type: textblock
5134 #: ../src/guestfs.pod:2431
5135 msgid ""
5136 "There are two sorts of API action, depending on whether the call goes "
5137 "through to the daemon in the appliance, or is serviced entirely by the "
5138 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
5139 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
5140 "an example of the latter, since a trace flag is maintained in the handle and "
5141 "all tracing is done on the library side."
5142 msgstr ""
5143
5144 #. type: textblock
5145 #: ../src/guestfs.pod:2439
5146 msgid ""
5147 "Most new actions are of the first type, and get added to the "
5148 "C<daemon_functions> list.  Each function has a unique procedure number used "
5149 "in the RPC protocol which is assigned to that action when we publish "
5150 "libguestfs and cannot be reused.  Take the latest procedure number and "
5151 "increment it."
5152 msgstr ""
5153
5154 #. type: textblock
5155 #: ../src/guestfs.pod:2445
5156 msgid ""
5157 "For library-only actions of the second type, add to the "
5158 "C<non_daemon_functions> list.  Since these functions are serviced by the "
5159 "library and do not travel over the RPC mechanism to the daemon, these "
5160 "functions do not need a procedure number, and so the procedure number is set "
5161 "to C<-1>."
5162 msgstr ""
5163
5164 #. type: textblock
5165 #: ../src/guestfs.pod:2453
5166 msgid "Implement the action (in C):"
5167 msgstr ""
5168
5169 #. type: textblock
5170 #: ../src/guestfs.pod:2455
5171 msgid ""
5172 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
5173 "C<daemon/> directory."
5174 msgstr ""
5175
5176 #. type: textblock
5177 #: ../src/guestfs.pod:2458
5178 msgid ""
5179 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
5180 "(note: double underscore) in the C<src/> directory."
5181 msgstr ""
5182
5183 #. type: textblock
5184 #: ../src/guestfs.pod:2461
5185 msgid "In either case, use another function as an example of what to do."
5186 msgstr ""
5187
5188 #. type: textblock
5189 #: ../src/guestfs.pod:2465
5190 msgid "After making these changes, use C<make> to compile."
5191 msgstr ""
5192
5193 #. type: textblock
5194 #: ../src/guestfs.pod:2467
5195 msgid ""
5196 "Note that you don't need to implement the RPC, language bindings, manual "
5197 "pages or anything else.  It's all automatically generated from the OCaml "
5198 "description."
5199 msgstr ""
5200
5201 #. type: =head2
5202 #: ../src/guestfs.pod:2471
5203 msgid "ADDING TESTS FOR AN API ACTION"
5204 msgstr ""
5205
5206 #. type: textblock
5207 #: ../src/guestfs.pod:2473
5208 msgid ""
5209 "You can supply zero or as many tests as you want per API call.  The tests "
5210 "can either be added as part of the API description (C<generator/"
5211 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
5212 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
5213 "slower, so if possible use the first method."
5214 msgstr ""
5215
5216 #. type: textblock
5217 #: ../src/guestfs.pod:2479
5218 msgid ""
5219 "The following describes the test environment used when you add an API test "
5220 "in C<generator_actions.ml>."
5221 msgstr ""
5222
5223 #. type: textblock
5224 #: ../src/guestfs.pod:2482
5225 msgid "The test environment has 4 block devices:"
5226 msgstr ""
5227
5228 #. type: =item
5229 #: ../src/guestfs.pod:2486
5230 msgid "C</dev/sda> 500MB"
5231 msgstr ""
5232
5233 #. type: textblock
5234 #: ../src/guestfs.pod:2488
5235 msgid "General block device for testing."
5236 msgstr ""
5237
5238 #. type: =item
5239 #: ../src/guestfs.pod:2490
5240 msgid "C</dev/sdb> 50MB"
5241 msgstr ""
5242
5243 #. type: textblock
5244 #: ../src/guestfs.pod:2492
5245 msgid ""
5246 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
5247 "operations."
5248 msgstr ""
5249
5250 #. type: =item
5251 #: ../src/guestfs.pod:2495
5252 msgid "C</dev/sdc> 10MB"
5253 msgstr ""
5254
5255 #. type: textblock
5256 #: ../src/guestfs.pod:2497
5257 msgid "Used in a few tests where two block devices are needed."
5258 msgstr ""
5259
5260 #. type: =item
5261 #: ../src/guestfs.pod:2499
5262 msgid "C</dev/sdd>"
5263 msgstr ""
5264
5265 #. type: textblock
5266 #: ../src/guestfs.pod:2501
5267 msgid "ISO with fixed content (see C<images/test.iso>)."
5268 msgstr ""
5269
5270 #. type: textblock
5271 #: ../src/guestfs.pod:2505
5272 msgid ""
5273 "To be able to run the tests in a reasonable amount of time, the libguestfs "
5274 "appliance and block devices are reused between tests.  So don't try testing "
5275 "L</guestfs_kill_subprocess> :-x"
5276 msgstr ""
5277
5278 #. type: textblock
5279 #: ../src/guestfs.pod:2509
5280 msgid ""
5281 "Each test starts with an initial scenario, selected using one of the "
5282 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
5283 "initialize the disks mentioned above in a particular way as documented in "
5284 "C<generator_types.ml>.  You should not assume anything about the previous "
5285 "contents of other disks that are not initialized."
5286 msgstr ""
5287
5288 #. type: textblock
5289 #: ../src/guestfs.pod:2515
5290 msgid ""
5291 "You can add a prerequisite clause to any individual test.  This is a run-"
5292 "time check, which, if it fails, causes the test to be skipped.  Useful if "
5293 "testing a command which might not work on all variations of libguestfs "
5294 "builds.  A test that has prerequisite of C<Always> means to run "
5295 "unconditionally."
5296 msgstr ""
5297
5298 #. type: textblock
5299 #: ../src/guestfs.pod:2521
5300 msgid ""
5301 "In addition, packagers can skip individual tests by setting environment "
5302 "variables before running C<make check>."
5303 msgstr ""
5304
5305 #. type: verbatim
5306 #: ../src/guestfs.pod:2524
5307 #, no-wrap
5308 msgid ""
5309 " SKIP_TEST_<CMD>_<NUM>=1\n"
5310 "\n"
5311 msgstr ""
5312
5313 #. type: textblock
5314 #: ../src/guestfs.pod:2526
5315 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
5316 msgstr ""
5317
5318 #. type: textblock
5319 #: ../src/guestfs.pod:2528
5320 msgid "or:"
5321 msgstr ""
5322
5323 #. type: verbatim
5324 #: ../src/guestfs.pod:2530
5325 #, no-wrap
5326 msgid ""
5327 " SKIP_TEST_<CMD>=1\n"
5328 "\n"
5329 msgstr ""
5330
5331 #. type: textblock
5332 #: ../src/guestfs.pod:2532
5333 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
5334 msgstr ""
5335
5336 #. type: textblock
5337 #: ../src/guestfs.pod:2534
5338 msgid "Packagers can run only certain tests by setting for example:"
5339 msgstr ""
5340
5341 #. type: verbatim
5342 #: ../src/guestfs.pod:2536
5343 #, no-wrap
5344 msgid ""
5345 " TEST_ONLY=\"vfs_type zerofree\"\n"
5346 "\n"
5347 msgstr ""
5348
5349 #. type: textblock
5350 #: ../src/guestfs.pod:2538
5351 msgid ""
5352 "See C<capitests/tests.c> for more details of how these environment variables "
5353 "work."
5354 msgstr ""
5355
5356 #. type: =head2
5357 #: ../src/guestfs.pod:2541
5358 msgid "DEBUGGING NEW API ACTIONS"
5359 msgstr ""
5360
5361 #. type: textblock
5362 #: ../src/guestfs.pod:2543
5363 msgid "Test new actions work before submitting them."
5364 msgstr ""
5365
5366 #. type: textblock
5367 #: ../src/guestfs.pod:2545
5368 msgid "You can use guestfish to try out new commands."
5369 msgstr ""
5370
5371 #. type: textblock
5372 #: ../src/guestfs.pod:2547
5373 msgid ""
5374 "Debugging the daemon is a problem because it runs inside a minimal "
5375 "environment.  However you can fprintf messages in the daemon to stderr, and "
5376 "they will show up if you use C<guestfish -v>."
5377 msgstr ""
5378
5379 #. type: =head2
5380 #: ../src/guestfs.pod:2551
5381 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
5382 msgstr ""
5383
5384 #. type: textblock
5385 #: ../src/guestfs.pod:2553
5386 msgid ""
5387 "Our C source code generally adheres to some basic code-formatting "
5388 "conventions.  The existing code base is not totally consistent on this "
5389 "front, but we do prefer that contributed code be formatted similarly.  In "
5390 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
5391 "indentation level, and other than that, follow the K&R style."
5392 msgstr ""
5393
5394 #. type: textblock
5395 #: ../src/guestfs.pod:2559
5396 msgid ""
5397 "If you use Emacs, add the following to one of one of your start-up files (e."
5398 "g., ~/.emacs), to help ensure that you get indentation right:"
5399 msgstr ""
5400
5401 #. type: verbatim
5402 #: ../src/guestfs.pod:2562
5403 #, no-wrap
5404 msgid ""
5405 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
5406 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
5407 " (add-hook 'find-file-hook\n"
5408 "     '(lambda () (if (and buffer-file-name\n"
5409 "                          (string-match \"/libguestfs\\\\>\"\n"
5410 "                              (buffer-file-name))\n"
5411 "                          (not (string-equal mode-name \"Change Log\"))\n"
5412 "                          (not (string-equal mode-name \"Makefile\")))\n"
5413 "                     (setq indent-tabs-mode nil))))\n"
5414 " \n"
5415 msgstr ""
5416
5417 #. type: verbatim
5418 #: ../src/guestfs.pod:2572
5419 #, no-wrap
5420 msgid ""
5421 " ;;; When editing C sources in libguestfs, use this style.\n"
5422 " (defun libguestfs-c-mode ()\n"
5423 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
5424 "   (interactive)\n"
5425 "   (c-set-style \"K&R\")\n"
5426 "   (setq c-indent-level 2)\n"
5427 "   (setq c-basic-offset 2))\n"
5428 " (add-hook 'c-mode-hook\n"
5429 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
5430 "                               (buffer-file-name))\n"
5431 "                           (libguestfs-c-mode))))\n"
5432 "\n"
5433 msgstr ""
5434
5435 #. type: textblock
5436 #: ../src/guestfs.pod:2584
5437 msgid "Enable warnings when compiling (and fix any problems this finds):"
5438 msgstr ""
5439
5440 #. type: verbatim
5441 #: ../src/guestfs.pod:2587
5442 #, no-wrap
5443 msgid ""
5444 " ./configure --enable-gcc-warnings\n"
5445 "\n"
5446 msgstr ""
5447
5448 #. type: textblock
5449 #: ../src/guestfs.pod:2589
5450 msgid "Useful targets are:"
5451 msgstr ""
5452
5453 #. type: verbatim
5454 #: ../src/guestfs.pod:2591
5455 #, no-wrap
5456 msgid ""
5457 " make syntax-check  # checks the syntax of the C code\n"
5458 " make check         # runs the test suite\n"
5459 "\n"
5460 msgstr ""
5461
5462 #. type: =head2
5463 #: ../src/guestfs.pod:2594
5464 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
5465 msgstr ""
5466
5467 #. type: textblock
5468 #: ../src/guestfs.pod:2596
5469 msgid ""
5470 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
5471 "which are used to do shell quoting."
5472 msgstr ""
5473
5474 #. type: =item
5475 #: ../src/guestfs.pod:2601
5476 msgid "%Q"
5477 msgstr ""
5478
5479 #. type: textblock
5480 #: ../src/guestfs.pod:2603
5481 msgid ""
5482 "Simple shell quoted string.  Any spaces or other shell characters are "
5483 "escaped for you."
5484 msgstr ""
5485
5486 #. type: =item
5487 #: ../src/guestfs.pod:2606
5488 msgid "%R"
5489 msgstr ""
5490
5491 #. type: textblock
5492 #: ../src/guestfs.pod:2608
5493 msgid ""
5494 "Same as C<%Q> except the string is treated as a path which is prefixed by "
5495 "the sysroot."
5496 msgstr ""
5497
5498 # type: textblock
5499 #. type: textblock
5500 #: ../src/guestfs.pod:2613 ../fish/guestfish.pod:242 ../fish/guestfish.pod:615
5501 msgid "For example:"
5502 msgstr ""
5503
5504 #. type: verbatim
5505 #: ../src/guestfs.pod:2615
5506 #, no-wrap
5507 msgid ""
5508 " asprintf (&cmd, \"cat %R\", path);\n"
5509 "\n"
5510 msgstr ""
5511
5512 #. type: textblock
5513 #: ../src/guestfs.pod:2617
5514 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5515 msgstr ""
5516
5517 #. type: textblock
5518 #: ../src/guestfs.pod:2619
5519 msgid ""
5520 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5521 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5522 "they are not passed via the shell (instead, straight to exec).  You probably "
5523 "want to use the C<sysroot_path()> function however."
5524 msgstr ""
5525
5526 #. type: =head2
5527 #: ../src/guestfs.pod:2625
5528 msgid "SUBMITTING YOUR NEW API ACTIONS"
5529 msgstr ""
5530
5531 #. type: textblock
5532 #: ../src/guestfs.pod:2627
5533 msgid ""
5534 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5535 "libguestfs> and CC to L<rjones@redhat.com>."
5536 msgstr ""
5537
5538 #. type: =head2
5539 #: ../src/guestfs.pod:2631
5540 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5541 msgstr ""
5542
5543 #. type: textblock
5544 #: ../src/guestfs.pod:2633
5545 msgid "We support i18n (gettext anyhow) in the library."
5546 msgstr ""
5547
5548 #. type: textblock
5549 #: ../src/guestfs.pod:2635
5550 msgid ""
5551 "However many messages come from the daemon, and we don't translate those at "
5552 "the moment.  One reason is that the appliance generally has all locale files "
5553 "removed from it, because they take up a lot of space.  So we'd have to readd "
5554 "some of those, as well as copying our PO files into the appliance."
5555 msgstr ""
5556
5557 #. type: textblock
5558 #: ../src/guestfs.pod:2641
5559 msgid ""
5560 "Debugging messages are never translated, since they are intended for the "
5561 "programmers."
5562 msgstr ""
5563
5564 #. type: =head2
5565 #: ../src/guestfs.pod:2644
5566 msgid "SOURCE CODE SUBDIRECTORIES"
5567 msgstr ""
5568
5569 #. type: =item
5570 #: ../src/guestfs.pod:2648 ../src/guestfs-actions.pod:5847
5571 #: ../fish/guestfish-actions.pod:3932
5572 msgid "C<appliance>"
5573 msgstr ""
5574
5575 #. type: textblock
5576 #: ../src/guestfs.pod:2650
5577 msgid "The libguestfs appliance, build scripts and so on."
5578 msgstr ""
5579
5580 #. type: =item
5581 #: ../src/guestfs.pod:2652
5582 msgid "C<capitests>"
5583 msgstr ""
5584
5585 #. type: textblock
5586 #: ../src/guestfs.pod:2654
5587 msgid "Automated tests of the C API."
5588 msgstr ""
5589
5590 #. type: =item
5591 #: ../src/guestfs.pod:2656
5592 msgid "C<cat>"
5593 msgstr ""
5594
5595 #. type: textblock
5596 #: ../src/guestfs.pod:2658
5597 msgid ""
5598 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5599 "documentation."
5600 msgstr ""
5601
5602 #. type: =item
5603 #: ../src/guestfs.pod:2661
5604 msgid "C<contrib>"
5605 msgstr ""
5606
5607 #. type: textblock
5608 #: ../src/guestfs.pod:2663
5609 msgid "Outside contributions, experimental parts."
5610 msgstr ""
5611
5612 #. type: =item
5613 #: ../src/guestfs.pod:2665
5614 msgid "C<daemon>"
5615 msgstr ""
5616
5617 #. type: textblock
5618 #: ../src/guestfs.pod:2667
5619 msgid ""
5620 "The daemon that runs inside the libguestfs appliance and carries out actions."
5621 msgstr ""
5622
5623 #. type: =item
5624 #: ../src/guestfs.pod:2670
5625 msgid "C<df>"
5626 msgstr ""
5627
5628 #. type: textblock
5629 #: ../src/guestfs.pod:2672
5630 msgid "L<virt-df(1)> command and documentation."
5631 msgstr ""
5632
5633 #. type: =item
5634 #: ../src/guestfs.pod:2674
5635 msgid "C<edit>"
5636 msgstr ""
5637
5638 #. type: textblock
5639 #: ../src/guestfs.pod:2676
5640 msgid "L<virt-edit(1)> command and documentation."
5641 msgstr ""
5642
5643 #. type: =item
5644 #: ../src/guestfs.pod:2678
5645 msgid "C<examples>"
5646 msgstr ""
5647
5648 #. type: textblock
5649 #: ../src/guestfs.pod:2680
5650 msgid "C API example code."
5651 msgstr ""
5652
5653 #. type: =item
5654 #: ../src/guestfs.pod:2682
5655 msgid "C<fish>"
5656 msgstr ""
5657
5658 #. type: textblock
5659 #: ../src/guestfs.pod:2684
5660 msgid ""
5661 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5662 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5663 "L<virt-tar-out(1)>."
5664 msgstr ""
5665
5666 #. type: =item
5667 #: ../src/guestfs.pod:2688
5668 msgid "C<fuse>"
5669 msgstr ""
5670
5671 #. type: textblock
5672 #: ../src/guestfs.pod:2690
5673 msgid ""
5674 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5675 msgstr ""
5676
5677 #. type: =item
5678 #: ../src/guestfs.pod:2692
5679 msgid "C<generator>"
5680 msgstr ""
5681
5682 #. type: textblock
5683 #: ../src/guestfs.pod:2694
5684 msgid ""
5685 "The crucially important generator, used to automatically generate large "
5686 "amounts of boilerplate C code for things like RPC and bindings."
5687 msgstr ""
5688
5689 #. type: =item
5690 #: ../src/guestfs.pod:2697
5691 msgid "C<images>"
5692 msgstr ""
5693
5694 #. type: textblock
5695 #: ../src/guestfs.pod:2699
5696 msgid "Files used by the test suite."
5697 msgstr ""
5698
5699 #. type: textblock
5700 #: ../src/guestfs.pod:2701
5701 msgid "Some \"phony\" guest images which we test against."
5702 msgstr ""
5703
5704 #. type: =item
5705 #: ../src/guestfs.pod:2703
5706 msgid "C<inspector>"
5707 msgstr ""
5708
5709 #. type: textblock
5710 #: ../src/guestfs.pod:2705
5711 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5712 msgstr ""
5713
5714 #. type: =item
5715 #: ../src/guestfs.pod:2707
5716 msgid "C<logo>"
5717 msgstr ""
5718
5719 #. type: textblock
5720 #: ../src/guestfs.pod:2709
5721 msgid "Logo used on the website.  The fish is called Arthur by the way."
5722 msgstr ""
5723
5724 #. type: =item
5725 #: ../src/guestfs.pod:2711
5726 msgid "C<m4>"
5727 msgstr ""
5728
5729 #. type: textblock
5730 #: ../src/guestfs.pod:2713
5731 msgid "M4 macros used by autoconf."
5732 msgstr ""
5733
5734 #. type: =item
5735 #: ../src/guestfs.pod:2715
5736 msgid "C<po>"
5737 msgstr ""
5738
5739 #. type: textblock
5740 #: ../src/guestfs.pod:2717
5741 msgid "Translations of simple gettext strings."
5742 msgstr ""
5743
5744 #. type: =item
5745 #: ../src/guestfs.pod:2719
5746 msgid "C<po-docs>"
5747 msgstr ""
5748
5749 #. type: textblock
5750 #: ../src/guestfs.pod:2721
5751 msgid ""
5752 "The build infrastructure and PO files for translations of manpages and POD "
5753 "files.  Eventually this will be combined with the C<po> directory, but that "
5754 "is rather complicated."
5755 msgstr ""
5756
5757 #. type: =item
5758 #: ../src/guestfs.pod:2725
5759 msgid "C<regressions>"
5760 msgstr ""
5761
5762 #. type: textblock
5763 #: ../src/guestfs.pod:2727
5764 msgid "Regression tests."
5765 msgstr ""
5766
5767 #. type: =item
5768 #: ../src/guestfs.pod:2729
5769 msgid "C<rescue>"
5770 msgstr ""
5771
5772 #. type: textblock
5773 #: ../src/guestfs.pod:2731
5774 msgid "L<virt-rescue(1)> command and documentation."
5775 msgstr ""
5776
5777 #. type: =item
5778 #: ../src/guestfs.pod:2733
5779 msgid "C<src>"
5780 msgstr ""
5781
5782 #. type: textblock
5783 #: ../src/guestfs.pod:2735
5784 msgid "Source code to the C library."
5785 msgstr ""
5786
5787 #. type: =item
5788 #: ../src/guestfs.pod:2737
5789 msgid "C<tools>"
5790 msgstr ""
5791
5792 #. type: textblock
5793 #: ../src/guestfs.pod:2739
5794 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5795 msgstr ""
5796
5797 #. type: =item
5798 #: ../src/guestfs.pod:2741
5799 msgid "C<test-tool>"
5800 msgstr ""
5801
5802 #. type: textblock
5803 #: ../src/guestfs.pod:2743
5804 msgid ""
5805 "Test tool for end users to test if their qemu/kernel combination will work "
5806 "with libguestfs."
5807 msgstr ""
5808
5809 #. type: =item
5810 #: ../src/guestfs.pod:2746
5811 msgid "C<csharp>"
5812 msgstr ""
5813
5814 #. type: =item
5815 #: ../src/guestfs.pod:2748
5816 msgid "C<haskell>"
5817 msgstr ""
5818
5819 #. type: =item
5820 #: ../src/guestfs.pod:2750
5821 msgid "C<java>"
5822 msgstr ""
5823
5824 #. type: =item
5825 #: ../src/guestfs.pod:2752
5826 msgid "C<ocaml>"
5827 msgstr ""
5828
5829 #. type: =item
5830 #: ../src/guestfs.pod:2754
5831 msgid "C<php>"
5832 msgstr ""
5833
5834 #. type: =item
5835 #: ../src/guestfs.pod:2756
5836 msgid "C<perl>"
5837 msgstr ""
5838
5839 #. type: =item
5840 #: ../src/guestfs.pod:2758
5841 msgid "C<python>"
5842 msgstr ""
5843
5844 #. type: =item
5845 #: ../src/guestfs.pod:2760
5846 msgid "C<ruby>"
5847 msgstr ""
5848
5849 #. type: textblock
5850 #: ../src/guestfs.pod:2762
5851 msgid "Language bindings."
5852 msgstr ""
5853
5854 #. type: =head1
5855 #: ../src/guestfs.pod:2766
5856 msgid "LIMITS"
5857 msgstr ""
5858
5859 # type: =head2
5860 #. type: =head2
5861 #: ../src/guestfs.pod:2768
5862 msgid "PROTOCOL LIMITS"
5863 msgstr ""
5864
5865 # type: textblock
5866 #. type: textblock
5867 #: ../src/guestfs.pod:2770
5868 msgid ""
5869 "Internally libguestfs uses a message-based protocol to pass API calls and "
5870 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
5871 "plenty more detail about this).  The maximum message size used by the "
5872 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
5873 "aware of this limit.  The API calls which may be affected are individually "
5874 "documented, with a link back to this section of the documentation."
5875 msgstr ""
5876
5877 # type: textblock
5878 #. type: textblock
5879 #: ../src/guestfs.pod:2778
5880 msgid ""
5881 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
5882 "a simple string.  Because this string is at some point internally encoded as "
5883 "a message, the maximum size that it can return is slightly under 4 MB.  If "
5884 "the requested file is larger than this then you will get an error."
5885 msgstr ""
5886
5887 # type: textblock
5888 #. type: textblock
5889 #: ../src/guestfs.pod:2784
5890 msgid ""
5891 "In order to transfer large files into and out of the guest filesystem, you "
5892 "need to use particular calls that support this.  The sections L</UPLOADING> "
5893 "and L</DOWNLOADING> document how to do this."
5894 msgstr ""
5895
5896 # type: textblock
5897 #. type: textblock
5898 #: ../src/guestfs.pod:2788
5899 msgid ""
5900 "You might also consider mounting the disk image using our FUSE filesystem "
5901 "support (L<guestmount(1)>)."
5902 msgstr ""
5903
5904 #. type: =head2
5905 #: ../src/guestfs.pod:2791
5906 msgid "MAXIMUM NUMBER OF DISKS"
5907 msgstr ""
5908
5909 #. type: textblock
5910 #: ../src/guestfs.pod:2793
5911 msgid "When using virtio disks (the default) the current limit is B<25> disks."
5912 msgstr ""
5913
5914 #. type: textblock
5915 #: ../src/guestfs.pod:2796
5916 msgid ""
5917 "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 "
5918 "slots.  However febootstrap only understands disks with names C</dev/vda> "
5919 "through C</dev/vdz> (26 letters) and it reserves one disk for its own "
5920 "purposes."
5921 msgstr ""
5922
5923 #. type: textblock
5924 #: ../src/guestfs.pod:2801
5925 msgid ""
5926 "We are working to substantially raise this limit in future versions but it "
5927 "requires complex changes to qemu."
5928 msgstr ""
5929
5930 #. type: textblock
5931 #: ../src/guestfs.pod:2804
5932 msgid ""
5933 "In future versions of libguestfs it should also be possible to \"hot plug\" "
5934 "disks (add and remove disks after calling L</guestfs_launch>).  This also "
5935 "requires changes to qemu."
5936 msgstr ""
5937
5938 #. type: =head2
5939 #: ../src/guestfs.pod:2808
5940 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
5941 msgstr ""
5942
5943 #. type: textblock
5944 #: ../src/guestfs.pod:2810
5945 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
5946 msgstr ""
5947
5948 #. type: textblock
5949 #: ../src/guestfs.pod:2812
5950 msgid ""
5951 "This is because it reserves 4 bits for the minor device number (thus C</dev/"
5952 "vda>, and C</dev/vda1> through C</dev/vda15>)."
5953 msgstr ""
5954
5955 #. type: textblock
5956 #: ../src/guestfs.pod:2815
5957 msgid ""
5958 "If you attach a disk with more than 15 partitions, the extra partitions are "
5959 "ignored by libguestfs."
5960 msgstr ""
5961
5962 #. type: =head2
5963 #: ../src/guestfs.pod:2818
5964 msgid "MAXIMUM SIZE OF A DISK"
5965 msgstr ""
5966
5967 #. type: textblock
5968 #: ../src/guestfs.pod:2820
5969 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
5970 msgstr ""
5971
5972 #. type: textblock
5973 #: ../src/guestfs.pod:2822
5974 msgid ""
5975 "We have tested block devices up to 1 exabyte (2**60 or "
5976 "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host "
5977 "filesystem."
5978 msgstr ""
5979
5980 #. type: textblock
5981 #: ../src/guestfs.pod:2826
5982 msgid ""
5983 "Although libguestfs probably does not impose any limit, the underlying host "
5984 "storage will.  If you store disk images on a host ext4 filesystem, then the "
5985 "maximum size will be limited by the maximum ext4 file size (currently 16 "
5986 "TB).  If you store disk images as host logical volumes then you are limited "
5987 "by the maximum size of an LV."
5988 msgstr ""
5989
5990 #. type: textblock
5991 #: ../src/guestfs.pod:2832
5992 msgid ""
5993 "For the hugest disk image files, we recommend using XFS on the host for "
5994 "storage."
5995 msgstr ""
5996
5997 #. type: =head2
5998 #: ../src/guestfs.pod:2835
5999 msgid "MAXIMUM SIZE OF A PARTITION"
6000 msgstr ""
6001
6002 #. type: textblock
6003 #: ../src/guestfs.pod:2837
6004 msgid ""
6005 "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector "
6006 "numbers.  Assuming a 512 byte sector size, this means that MBR cannot "
6007 "address a partition located beyond 2 TB on the disk."
6008 msgstr ""
6009
6010 #. type: textblock
6011 #: ../src/guestfs.pod:2841
6012 msgid ""
6013 "It is recommended that you use GPT partitions on disks which are larger than "
6014 "this size.  GPT uses 64 bit sector numbers and so can address partitions "
6015 "which are theoretically larger than the largest disk we could support."
6016 msgstr ""
6017
6018 #. type: =head2
6019 #: ../src/guestfs.pod:2846
6020 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
6021 msgstr ""
6022
6023 #. type: textblock
6024 #: ../src/guestfs.pod:2848
6025 msgid ""
6026 "This depends on the filesystem type.  libguestfs itself does not impose any "
6027 "known limit.  Consult Wikipedia or the filesystem documentation to find out "
6028 "what these limits are."
6029 msgstr ""
6030
6031 #. type: =head2
6032 #: ../src/guestfs.pod:2852
6033 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
6034 msgstr ""
6035
6036 #. type: textblock
6037 #: ../src/guestfs.pod:2854
6038 msgid ""
6039 "The API functions L</guestfs_upload>, L</guestfs_download>, L</"
6040 "guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized "
6041 "uploads and downloads."
6042 msgstr ""
6043
6044 #. type: =head2
6045 #: ../src/guestfs.pod:2858
6046 msgid "INSPECTION LIMITS"
6047 msgstr ""
6048
6049 #. type: textblock
6050 #: ../src/guestfs.pod:2860
6051 msgid ""
6052 "The inspection code has several arbitrary limits on things like the size of "
6053 "Windows Registry hive it will read, and the length of product name.  These "
6054 "are intended to stop a malicious guest from consuming arbitrary amounts of "
6055 "memory and disk space on the host, and should not be reached in practice.  "
6056 "See the source code for more information."
6057 msgstr ""
6058
6059 # type: =head1
6060 #. type: =head1
6061 #: ../src/guestfs.pod:2866 ../fish/guestfish.pod:1017
6062 #: ../test-tool/libguestfs-test-tool.pod:82
6063 msgid "ENVIRONMENT VARIABLES"
6064 msgstr ""
6065
6066 # type: =item
6067 #. type: =item
6068 #: ../src/guestfs.pod:2870 ../fish/guestfish.pod:1043
6069 msgid "LIBGUESTFS_APPEND"
6070 msgstr ""
6071
6072 # type: textblock
6073 #. type: textblock
6074 #: ../src/guestfs.pod:2872 ../fish/guestfish.pod:1045
6075 msgid "Pass additional options to the guest kernel."
6076 msgstr ""
6077
6078 # type: =item
6079 #. type: =item
6080 #: ../src/guestfs.pod:2874 ../fish/guestfish.pod:1047
6081 msgid "LIBGUESTFS_DEBUG"
6082 msgstr ""
6083
6084 # type: textblock
6085 #. type: textblock
6086 #: ../src/guestfs.pod:2876
6087 msgid ""
6088 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
6089 "effect as calling C<guestfs_set_verbose (g, 1)>."
6090 msgstr ""
6091
6092 # type: =item
6093 #. type: =item
6094 #: ../src/guestfs.pod:2879 ../fish/guestfish.pod:1052
6095 msgid "LIBGUESTFS_MEMSIZE"
6096 msgstr ""
6097
6098 # type: textblock
6099 #. type: textblock
6100 #: ../src/guestfs.pod:2881 ../fish/guestfish.pod:1054
6101 msgid ""
6102 "Set the memory allocated to the qemu process, in megabytes.  For example:"
6103 msgstr ""
6104
6105 # type: verbatim
6106 #. type: verbatim
6107 #: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1057
6108 #, no-wrap
6109 msgid ""
6110 " LIBGUESTFS_MEMSIZE=700\n"
6111 "\n"
6112 msgstr ""
6113
6114 # type: =item
6115 #. type: =item
6116 #: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1059
6117 msgid "LIBGUESTFS_PATH"
6118 msgstr ""
6119
6120 #. type: textblock
6121 #: ../src/guestfs.pod:2888
6122 msgid ""
6123 "Set the path that libguestfs uses to search for a supermin appliance.  See "
6124 "the discussion of paths in section L</PATH> above."
6125 msgstr ""
6126
6127 # type: =item
6128 #. type: =item
6129 #: ../src/guestfs.pod:2891 ../fish/guestfish.pod:1064
6130 msgid "LIBGUESTFS_QEMU"
6131 msgstr ""
6132
6133 # type: textblock
6134 #. type: textblock
6135 #: ../src/guestfs.pod:2893 ../fish/guestfish.pod:1066
6136 msgid ""
6137 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
6138 "which was found at compile time by the configure script is used."
6139 msgstr ""
6140
6141 # type: textblock
6142 #. type: textblock
6143 #: ../src/guestfs.pod:2897
6144 msgid "See also L</QEMU WRAPPERS> above."
6145 msgstr ""
6146
6147 # type: =item
6148 #. type: =item
6149 #: ../src/guestfs.pod:2899 ../fish/guestfish.pod:1070
6150 msgid "LIBGUESTFS_TRACE"
6151 msgstr ""
6152
6153 # type: textblock
6154 #. type: textblock
6155 #: ../src/guestfs.pod:2901
6156 msgid ""
6157 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
6158 "effect as calling C<guestfs_set_trace (g, 1)>."
6159 msgstr ""
6160
6161 # type: =item
6162 #. type: =item
6163 #: ../src/guestfs.pod:2904 ../fish/guestfish.pod:1079
6164 msgid "TMPDIR"
6165 msgstr ""
6166
6167 #. type: textblock
6168 #: ../src/guestfs.pod:2906 ../fish/guestfish.pod:1081
6169 msgid ""
6170 "Location of temporary directory, defaults to C</tmp> except for the cached "
6171 "supermin appliance which defaults to C</var/tmp>."
6172 msgstr ""
6173
6174 #. type: textblock
6175 #: ../src/guestfs.pod:2909 ../fish/guestfish.pod:1084
6176 msgid ""
6177 "If libguestfs was compiled to use the supermin appliance then the real "
6178 "appliance is cached in this directory, shared between all handles belonging "
6179 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
6180 "use in case C</var/tmp> is not large enough."
6181 msgstr ""
6182
6183 # type: =head1
6184 #. type: =head1
6185 #: ../src/guestfs.pod:2917 ../fish/guestfish.pod:1151
6186 #: ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:279
6187 #: ../tools/virt-win-reg.pl:744 ../tools/virt-list-filesystems.pl:189
6188 #: ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539
6189 #: ../tools/virt-list-partitions.pl:257
6190 msgid "SEE ALSO"
6191 msgstr ""
6192
6193 #. type: textblock
6194 #: ../src/guestfs.pod:2919
6195 msgid ""
6196 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-"
6197 "ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-copy-in"
6198 "(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems"
6199 "(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-"
6200 "partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-"
6201 "tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)"
6202 ">, L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
6203 msgstr ""
6204
6205 # type: textblock
6206 #. type: textblock
6207 #: ../src/guestfs.pod:2946
6208 msgid ""
6209 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
6210 "(8)>, L<disktype(1)>."
6211 msgstr ""
6212
6213 # type: =head1
6214 #. type: =head1
6215 #: ../src/guestfs.pod:2953 ../tools/virt-win-reg.pl:759
6216 #: ../tools/virt-make-fs.pl:553
6217 msgid "BUGS"
6218 msgstr ""
6219
6220 # type: textblock
6221 #. type: textblock
6222 #: ../src/guestfs.pod:2955
6223 msgid "To get a list of bugs against libguestfs use this link:"
6224 msgstr ""
6225
6226 # type: textblock
6227 #. type: textblock
6228 #: ../src/guestfs.pod:2957
6229 msgid ""
6230 "L<https://bugzilla.redhat.com/buglist.cgi?"
6231 "component=libguestfs&product=Virtualization+Tools>"
6232 msgstr ""
6233
6234 # type: textblock
6235 #. type: textblock
6236 #: ../src/guestfs.pod:2959
6237 msgid "To report a new bug against libguestfs use this link:"
6238 msgstr ""
6239
6240 # type: textblock
6241 #. type: textblock
6242 #: ../src/guestfs.pod:2961
6243 msgid ""
6244 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
6245 "component=libguestfs&product=Virtualization+Tools>"
6246 msgstr ""
6247
6248 # type: textblock
6249 #. type: textblock
6250 #: ../src/guestfs.pod:2963
6251 msgid "When reporting a bug, please check:"
6252 msgstr ""
6253
6254 # type: textblock
6255 #. type: textblock
6256 #: ../src/guestfs.pod:2969
6257 msgid "That the bug hasn't been reported already."
6258 msgstr ""
6259
6260 # type: textblock
6261 #. type: textblock
6262 #: ../src/guestfs.pod:2973
6263 msgid "That you are testing a recent version."
6264 msgstr ""
6265
6266 # type: textblock
6267 #. type: textblock
6268 #: ../src/guestfs.pod:2977
6269 msgid "Describe the bug accurately, and give a way to reproduce it."
6270 msgstr ""
6271
6272 # type: textblock
6273 #. type: textblock
6274 #: ../src/guestfs.pod:2981
6275 msgid ""
6276 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
6277 "bug report."
6278 msgstr ""
6279
6280 # type: =head1
6281 #. type: =head1
6282 #: ../src/guestfs.pod:2986 ../fish/guestfish.pod:1174
6283 #: ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:290
6284 msgid "AUTHORS"
6285 msgstr ""
6286
6287 # type: textblock
6288 #. type: textblock
6289 #: ../src/guestfs.pod:2988 ../fish/guestfish.pod:1176
6290 #: ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:292
6291 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
6292 msgstr ""
6293
6294 # type: =head1
6295 #. type: =head1
6296 #: ../src/guestfs.pod:2990 ../fish/guestfish.pod:1178
6297 #: ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:294
6298 #: ../tools/virt-win-reg.pl:774 ../tools/virt-list-filesystems.pl:206
6299 #: ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568
6300 #: ../tools/virt-list-partitions.pl:273
6301 msgid "COPYRIGHT"
6302 msgstr ""
6303
6304 #. type: textblock
6305 #: ../src/guestfs.pod:2992 ../fish/guestfish.pod:1180
6306 #: ../test-tool/libguestfs-test-tool.pod:99
6307 msgid "Copyright (C) 2009-2011 Red Hat Inc.  L<http://libguestfs.org/>"
6308 msgstr ""
6309
6310 # type: textblock
6311 #. type: textblock
6312 #: ../src/guestfs.pod:2995
6313 msgid ""
6314 "This library is free software; you can redistribute it and/or modify it "
6315 "under the terms of the GNU Lesser General Public License as published by the "
6316 "Free Software Foundation; either version 2 of the License, or (at your "
6317 "option) any later version."
6318 msgstr ""
6319
6320 # type: textblock
6321 #. type: textblock
6322 #: ../src/guestfs.pod:3000
6323 msgid ""
6324 "This library is distributed in the hope that it will be useful, but WITHOUT "
6325 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
6326 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
6327 "for more details."
6328 msgstr ""
6329
6330 # type: textblock
6331 #. type: textblock
6332 #: ../src/guestfs.pod:3005
6333 msgid ""
6334 "You should have received a copy of the GNU Lesser General Public License "
6335 "along with this library; if not, write to the Free Software Foundation, "
6336 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
6337 msgstr ""
6338
6339 # type: =head2
6340 #. type: =head2
6341 #: ../src/guestfs-actions.pod:1
6342 msgid "guestfs_add_cdrom"
6343 msgstr ""
6344
6345 # type: verbatim
6346 #. type: verbatim
6347 #: ../src/guestfs-actions.pod:3
6348 #, no-wrap
6349 msgid ""
6350 " int\n"
6351 " guestfs_add_cdrom (guestfs_h *g,\n"
6352 "                    const char *filename);\n"
6353 "\n"
6354 msgstr ""
6355
6356 # type: textblock
6357 #. type: textblock
6358 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
6359 msgid "This function adds a virtual CD-ROM disk image to the guest."
6360 msgstr ""
6361
6362 #. type: textblock
6363 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
6364 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
6365 msgstr ""
6366
6367 # type: textblock
6368 #. type: textblock
6369 #: ../src/guestfs-actions.pod:17
6370 msgid ""
6371 "This call checks for the existence of C<filename>.  This stops you from "
6372 "specifying other types of drive which are supported by qemu such as C<nbd:> "
6373 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
6374 "instead."
6375 msgstr ""
6376
6377 # type: textblock
6378 #. type: textblock
6379 #: ../src/guestfs-actions.pod:24
6380 msgid ""
6381 "If you just want to add an ISO file (often you use this as an efficient way "
6382 "to transfer large files into the guest), then you should probably use "
6383 "C<guestfs_add_drive_ro> instead."
6384 msgstr ""
6385
6386 # type: textblock
6387 #. type: textblock
6388 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:140
6389 #: ../src/guestfs-actions.pod:201 ../src/guestfs-actions.pod:238
6390 #: ../src/guestfs-actions.pod:252 ../src/guestfs-actions.pod:273
6391 #: ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:307
6392 #: ../src/guestfs-actions.pod:422 ../src/guestfs-actions.pod:442
6393 #: ../src/guestfs-actions.pod:456 ../src/guestfs-actions.pod:501
6394 #: ../src/guestfs-actions.pod:529 ../src/guestfs-actions.pod:547
6395 #: ../src/guestfs-actions.pod:614 ../src/guestfs-actions.pod:647
6396 #: ../src/guestfs-actions.pod:661 ../src/guestfs-actions.pod:676
6397 #: ../src/guestfs-actions.pod:775 ../src/guestfs-actions.pod:793
6398 #: ../src/guestfs-actions.pod:807 ../src/guestfs-actions.pod:821
6399 #: ../src/guestfs-actions.pod:982 ../src/guestfs-actions.pod:1002
6400 #: ../src/guestfs-actions.pod:1020 ../src/guestfs-actions.pod:1104
6401 #: ../src/guestfs-actions.pod:1122 ../src/guestfs-actions.pod:1141
6402 #: ../src/guestfs-actions.pod:1155 ../src/guestfs-actions.pod:1175
6403 #: ../src/guestfs-actions.pod:1245 ../src/guestfs-actions.pod:1276
6404 #: ../src/guestfs-actions.pod:1301 ../src/guestfs-actions.pod:1343
6405 #: ../src/guestfs-actions.pod:1449 ../src/guestfs-actions.pod:1483
6406 #: ../src/guestfs-actions.pod:1698 ../src/guestfs-actions.pod:1720
6407 #: ../src/guestfs-actions.pod:1807 ../src/guestfs-actions.pod:2269
6408 #: ../src/guestfs-actions.pod:2413 ../src/guestfs-actions.pod:2474
6409 #: ../src/guestfs-actions.pod:2509 ../src/guestfs-actions.pod:3485
6410 #: ../src/guestfs-actions.pod:3500 ../src/guestfs-actions.pod:3525
6411 #: ../src/guestfs-actions.pod:3680 ../src/guestfs-actions.pod:3694
6412 #: ../src/guestfs-actions.pod:3707 ../src/guestfs-actions.pod:3721
6413 #: ../src/guestfs-actions.pod:3736 ../src/guestfs-actions.pod:3772
6414 #: ../src/guestfs-actions.pod:3844 ../src/guestfs-actions.pod:3864
6415 #: ../src/guestfs-actions.pod:3881 ../src/guestfs-actions.pod:3904
6416 #: ../src/guestfs-actions.pod:3927 ../src/guestfs-actions.pod:3959
6417 #: ../src/guestfs-actions.pod:3978 ../src/guestfs-actions.pod:3997
6418 #: ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4044
6419 #: ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4096
6420 #: ../src/guestfs-actions.pod:4109 ../src/guestfs-actions.pod:4124
6421 #: ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:4234
6422 #: ../src/guestfs-actions.pod:4254 ../src/guestfs-actions.pod:4267
6423 #: ../src/guestfs-actions.pod:4318 ../src/guestfs-actions.pod:4336
6424 #: ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:4370
6425 #: ../src/guestfs-actions.pod:4384 ../src/guestfs-actions.pod:4398
6426 #: ../src/guestfs-actions.pod:4415 ../src/guestfs-actions.pod:4430
6427 #: ../src/guestfs-actions.pod:4450 ../src/guestfs-actions.pod:4508
6428 #: ../src/guestfs-actions.pod:4581 ../src/guestfs-actions.pod:4612
6429 #: ../src/guestfs-actions.pod:4631 ../src/guestfs-actions.pod:4650
6430 #: ../src/guestfs-actions.pod:4662 ../src/guestfs-actions.pod:4679
6431 #: ../src/guestfs-actions.pod:4692 ../src/guestfs-actions.pod:4707
6432 #: ../src/guestfs-actions.pod:4722 ../src/guestfs-actions.pod:4757
6433 #: ../src/guestfs-actions.pod:4779 ../src/guestfs-actions.pod:4799
6434 #: ../src/guestfs-actions.pod:4813 ../src/guestfs-actions.pod:4830
6435 #: ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:4916
6436 #: ../src/guestfs-actions.pod:4930 ../src/guestfs-actions.pod:4958
6437 #: ../src/guestfs-actions.pod:4975 ../src/guestfs-actions.pod:4993
6438 #: ../src/guestfs-actions.pod:5127 ../src/guestfs-actions.pod:5184
6439 #: ../src/guestfs-actions.pod:5206 ../src/guestfs-actions.pod:5224
6440 #: ../src/guestfs-actions.pod:5256 ../src/guestfs-actions.pod:5322
6441 #: ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5352
6442 #: ../src/guestfs-actions.pod:5366 ../src/guestfs-actions.pod:5655
6443 #: ../src/guestfs-actions.pod:5674 ../src/guestfs-actions.pod:5693
6444 #: ../src/guestfs-actions.pod:5705 ../src/guestfs-actions.pod:5717
6445 #: ../src/guestfs-actions.pod:5731 ../src/guestfs-actions.pod:5743
6446 #: ../src/guestfs-actions.pod:5757 ../src/guestfs-actions.pod:5773
6447 #: ../src/guestfs-actions.pod:5794 ../src/guestfs-actions.pod:5813
6448 #: ../src/guestfs-actions.pod:5832 ../src/guestfs-actions.pod:5862
6449 #: ../src/guestfs-actions.pod:5878 ../src/guestfs-actions.pod:5901
6450 #: ../src/guestfs-actions.pod:5919 ../src/guestfs-actions.pod:5938
6451 #: ../src/guestfs-actions.pod:5959 ../src/guestfs-actions.pod:5978
6452 #: ../src/guestfs-actions.pod:5995 ../src/guestfs-actions.pod:6023
6453 #: ../src/guestfs-actions.pod:6047 ../src/guestfs-actions.pod:6066
6454 #: ../src/guestfs-actions.pod:6090 ../src/guestfs-actions.pod:6109
6455 #: ../src/guestfs-actions.pod:6124 ../src/guestfs-actions.pod:6143
6456 #: ../src/guestfs-actions.pod:6180 ../src/guestfs-actions.pod:6210
6457 #: ../src/guestfs-actions.pod:6243 ../src/guestfs-actions.pod:6365
6458 #: ../src/guestfs-actions.pod:6486 ../src/guestfs-actions.pod:6498
6459 #: ../src/guestfs-actions.pod:6511 ../src/guestfs-actions.pod:6524
6460 #: ../src/guestfs-actions.pod:6546 ../src/guestfs-actions.pod:6559
6461 #: ../src/guestfs-actions.pod:6572 ../src/guestfs-actions.pod:6585
6462 #: ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:6659
6463 #: ../src/guestfs-actions.pod:6676 ../src/guestfs-actions.pod:6692
6464 #: ../src/guestfs-actions.pod:6708 ../src/guestfs-actions.pod:6725
6465 #: ../src/guestfs-actions.pod:6738 ../src/guestfs-actions.pod:6758
6466 #: ../src/guestfs-actions.pod:6794 ../src/guestfs-actions.pod:6808
6467 #: ../src/guestfs-actions.pod:6849 ../src/guestfs-actions.pod:6862
6468 #: ../src/guestfs-actions.pod:6880 ../src/guestfs-actions.pod:6914
6469 #: ../src/guestfs-actions.pod:6950 ../src/guestfs-actions.pod:7069
6470 #: ../src/guestfs-actions.pod:7087 ../src/guestfs-actions.pod:7101
6471 #: ../src/guestfs-actions.pod:7156 ../src/guestfs-actions.pod:7169
6472 #: ../src/guestfs-actions.pod:7214 ../src/guestfs-actions.pod:7247
6473 #: ../src/guestfs-actions.pod:7308 ../src/guestfs-actions.pod:7334
6474 #: ../src/guestfs-actions.pod:7401 ../src/guestfs-actions.pod:7420
6475 #: ../src/guestfs-actions.pod:7449
6476 msgid "This function returns 0 on success or -1 on error."
6477 msgstr ""
6478
6479 # type: textblock
6480 #. type: textblock
6481 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:254
6482 #: ../src/guestfs-actions.pod:275 ../fish/guestfish-actions.pod:28
6483 #: ../fish/guestfish-actions.pod:163 ../fish/guestfish-actions.pod:177
6484 msgid ""
6485 "This function is deprecated.  In new code, use the C<add_drive_opts> call "
6486 "instead."
6487 msgstr ""
6488
6489 # type: textblock
6490 #. type: textblock
6491 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:257
6492 #: ../src/guestfs-actions.pod:278 ../src/guestfs-actions.pod:1454
6493 #: ../src/guestfs-actions.pod:1947 ../src/guestfs-actions.pod:1968
6494 #: ../src/guestfs-actions.pod:4455 ../src/guestfs-actions.pod:4762
6495 #: ../src/guestfs-actions.pod:6188 ../src/guestfs-actions.pod:6218
6496 #: ../src/guestfs-actions.pod:6251 ../src/guestfs-actions.pod:6310
6497 #: ../src/guestfs-actions.pod:7252 ../src/guestfs-actions.pod:7342
6498 #: ../src/guestfs-actions.pod:7512 ../fish/guestfish-actions.pod:31
6499 #: ../fish/guestfish-actions.pod:166 ../fish/guestfish-actions.pod:180
6500 #: ../fish/guestfish-actions.pod:961 ../fish/guestfish-actions.pod:1321
6501 #: ../fish/guestfish-actions.pod:1335 ../fish/guestfish-actions.pod:3025
6502 #: ../fish/guestfish-actions.pod:3222 ../fish/guestfish-actions.pod:4194
6503 #: ../fish/guestfish-actions.pod:4217 ../fish/guestfish-actions.pod:4239
6504 #: ../fish/guestfish-actions.pod:4277 ../fish/guestfish-actions.pod:4918
6505 #: ../fish/guestfish-actions.pod:5016
6506 msgid ""
6507 "Deprecated functions will not be removed from the API, but the fact that "
6508 "they are deprecated indicates that there are problems with correct use of "
6509 "these functions."
6510 msgstr ""
6511
6512 # type: textblock
6513 #. type: textblock
6514 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:142
6515 #: ../src/guestfs-actions.pod:1106 ../src/guestfs-actions.pod:1919
6516 #: ../src/guestfs-actions.pod:2017 ../src/guestfs-actions.pod:2120
6517 #: ../src/guestfs-actions.pod:3487 ../src/guestfs-actions.pod:3507
6518 #: ../src/guestfs-actions.pod:4766 ../src/guestfs-actions.pod:5880
6519 #: ../src/guestfs-actions.pod:5997 ../src/guestfs-actions.pod:6111
6520 #: ../src/guestfs-actions.pod:6602 ../src/guestfs-actions.pod:6727
6521 #: ../src/guestfs-actions.pod:7256
6522 msgid "(Added in 0.3)"
6523 msgstr ""
6524
6525 # type: =head2
6526 #. type: =head2
6527 #: ../src/guestfs-actions.pod:41
6528 msgid "guestfs_add_domain"
6529 msgstr ""
6530
6531 # type: verbatim
6532 #. type: verbatim
6533 #: ../src/guestfs-actions.pod:43
6534 #, no-wrap
6535 msgid ""
6536 " int\n"
6537 " guestfs_add_domain (guestfs_h *g,\n"
6538 "                     const char *dom,\n"
6539 "                     ...);\n"
6540 "\n"
6541 msgstr ""
6542
6543 # type: textblock
6544 #. type: textblock
6545 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:151
6546 #: ../src/guestfs-actions.pod:4469
6547 msgid ""
6548 "You may supply a list of optional arguments to this call.  Use zero or more "
6549 "of the following pairs of parameters, and terminate the list with C<-1> on "
6550 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
6551 msgstr ""
6552
6553 #. type: verbatim
6554 #: ../src/guestfs-actions.pod:53
6555 #, no-wrap
6556 msgid ""
6557 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
6558 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
6559 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
6560 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
6561 " GUESTFS_ADD_DOMAIN_ALLOWUUID, int allowuuid,\n"
6562 "\n"
6563 msgstr ""
6564
6565 # type: textblock
6566 #. type: textblock
6567 #: ../src/guestfs-actions.pod:59
6568 msgid ""
6569 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
6570 "It works by connecting to libvirt, requesting the domain and domain XML from "
6571 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
6572 "one."
6573 msgstr ""
6574
6575 # type: textblock
6576 #. type: textblock
6577 #: ../src/guestfs-actions.pod:64 ../fish/guestfish-actions.pod:46
6578 msgid ""
6579 "The number of disks added is returned.  This operation is atomic: if an "
6580 "error is returned, then no disks are added."
6581 msgstr ""
6582
6583 # type: textblock
6584 #. type: textblock
6585 #: ../src/guestfs-actions.pod:67 ../fish/guestfish-actions.pod:49
6586 msgid ""
6587 "This function does some minimal checks to make sure the libvirt domain is "
6588 "not running (unless C<readonly> is true).  In a future version we will try "
6589 "to acquire the libvirt lock on each disk."
6590 msgstr ""
6591
6592 # type: textblock
6593 #. type: textblock
6594 #: ../src/guestfs-actions.pod:71 ../fish/guestfish-actions.pod:53
6595 msgid ""
6596 "Disks must be accessible locally.  This often means that adding disks from a "
6597 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
6598 "unless those disks are accessible via the same device path locally too."
6599 msgstr ""
6600
6601 #. type: textblock
6602 #: ../src/guestfs-actions.pod:76 ../fish/guestfish-actions.pod:58
6603 msgid ""
6604 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6605 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
6606 "libvirt URI (or one set through an environment variable, see the libvirt "
6607 "documentation for full details)."
6608 msgstr ""
6609
6610 #. type: textblock
6611 #: ../src/guestfs-actions.pod:82 ../fish/guestfish-actions.pod:64
6612 msgid ""
6613 "The optional C<live> flag controls whether this call will try to connect to "
6614 "a running virtual machine C<guestfsd> process if it sees a suitable "
6615 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
6616 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
6617 "DAEMONS> for more information."
6618 msgstr ""
6619
6620 #. type: textblock
6621 #: ../src/guestfs-actions.pod:89 ../fish/guestfish-actions.pod:71
6622 msgid ""
6623 "If the C<allowuuid> flag is true (default is false) then a UUID I<may> be "
6624 "passed instead of the domain name.  The C<dom> string is treated as a UUID "
6625 "first and looked up, and if that lookup fails then we treat C<dom> as a name "
6626 "as usual."
6627 msgstr ""
6628
6629 # type: textblock
6630 #. type: textblock
6631 #: ../src/guestfs-actions.pod:94
6632 msgid ""
6633 "The other optional parameters are passed directly through to "
6634 "C<guestfs_add_drive_opts>."
6635 msgstr ""
6636
6637 # type: textblock
6638 #. type: textblock
6639 #: ../src/guestfs-actions.pod:97 ../src/guestfs-actions.pod:350
6640 #: ../src/guestfs-actions.pod:515 ../src/guestfs-actions.pod:693
6641 #: ../src/guestfs-actions.pod:724 ../src/guestfs-actions.pod:742
6642 #: ../src/guestfs-actions.pod:761 ../src/guestfs-actions.pod:1321
6643 #: ../src/guestfs-actions.pod:1677 ../src/guestfs-actions.pod:1880
6644 #: ../src/guestfs-actions.pod:1989 ../src/guestfs-actions.pod:2029
6645 #: ../src/guestfs-actions.pod:2084 ../src/guestfs-actions.pod:2107
6646 #: ../src/guestfs-actions.pod:2400 ../src/guestfs-actions.pod:2783
6647 #: ../src/guestfs-actions.pod:2804 ../src/guestfs-actions.pod:4902
6648 #: ../src/guestfs-actions.pod:5030 ../src/guestfs-actions.pod:5436
6649 #: ../src/guestfs-actions.pod:5462 ../src/guestfs-actions.pod:6835
6650 #: ../src/guestfs-actions.pod:7267 ../src/guestfs-actions.pod:7280
6651 #: ../src/guestfs-actions.pod:7293
6652 msgid "On error this function returns -1."
6653 msgstr ""
6654
6655 # type: textblock
6656 #. type: textblock
6657 #: ../src/guestfs-actions.pod:99
6658 msgid "(Added in 1.7.4)"
6659 msgstr ""
6660
6661 # type: =head2
6662 #. type: =head2
6663 #: ../src/guestfs-actions.pod:101
6664 msgid "guestfs_add_domain_va"
6665 msgstr ""
6666
6667 # type: verbatim
6668 #. type: verbatim
6669 #: ../src/guestfs-actions.pod:103
6670 #, no-wrap
6671 msgid ""
6672 " int\n"
6673 " guestfs_add_domain_va (guestfs_h *g,\n"
6674 "                        const char *dom,\n"
6675 "                        va_list args);\n"
6676 "\n"
6677 msgstr ""
6678
6679 # type: textblock
6680 #. type: textblock
6681 #: ../src/guestfs-actions.pod:108
6682 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
6683 msgstr ""
6684
6685 # type: textblock
6686 #. type: textblock
6687 #: ../src/guestfs-actions.pod:110 ../src/guestfs-actions.pod:121
6688 #: ../src/guestfs-actions.pod:214 ../src/guestfs-actions.pod:225
6689 #: ../src/guestfs-actions.pod:4522 ../src/guestfs-actions.pod:4534
6690 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
6691 msgstr ""
6692
6693 # type: =head2
6694 #. type: =head2
6695 #: ../src/guestfs-actions.pod:112
6696 msgid "guestfs_add_domain_argv"
6697 msgstr ""
6698
6699 # type: verbatim
6700 #. type: verbatim
6701 #: ../src/guestfs-actions.pod:114
6702 #, no-wrap
6703 msgid ""
6704 " int\n"
6705 " guestfs_add_domain_argv (guestfs_h *g,\n"
6706 "                          const char *dom,\n"
6707 "                          const struct guestfs_add_domain_argv *optargs);\n"
6708 "\n"
6709 msgstr ""
6710
6711 # type: textblock
6712 #. type: textblock
6713 #: ../src/guestfs-actions.pod:119
6714 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
6715 msgstr ""
6716
6717 # type: =head2
6718 #. type: =head2
6719 #: ../src/guestfs-actions.pod:123
6720 msgid "guestfs_add_drive"
6721 msgstr ""
6722
6723 # type: verbatim
6724 #. type: verbatim
6725 #: ../src/guestfs-actions.pod:125
6726 #, no-wrap
6727 msgid ""
6728 " int\n"
6729 " guestfs_add_drive (guestfs_h *g,\n"
6730 "                    const char *filename);\n"
6731 "\n"
6732 msgstr ""
6733
6734 # type: textblock
6735 #. type: textblock
6736 #: ../src/guestfs-actions.pod:129
6737 msgid ""
6738 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
6739 "optional parameters, so the disk is added writable, with the format being "
6740 "detected automatically."
6741 msgstr ""
6742
6743 # type: textblock
6744 #. type: textblock
6745 #: ../src/guestfs-actions.pod:133
6746 msgid ""
6747 "Automatic detection of the format opens you up to a potential security hole "
6748 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6749 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6750 "you should think about replacing calls to this function with calls to "
6751 "C<guestfs_add_drive_opts>, and specifying the format."
6752 msgstr ""
6753
6754 # type: =head2
6755 #. type: =head2
6756 #: ../src/guestfs-actions.pod:144
6757 msgid "guestfs_add_drive_opts"
6758 msgstr ""
6759
6760 # type: verbatim
6761 #. type: verbatim
6762 #: ../src/guestfs-actions.pod:146
6763 #, no-wrap
6764 msgid ""
6765 " int\n"
6766 " guestfs_add_drive_opts (guestfs_h *g,\n"
6767 "                         const char *filename,\n"
6768 "                         ...);\n"
6769 "\n"
6770 msgstr ""
6771
6772 # type: verbatim
6773 #. type: verbatim
6774 #: ../src/guestfs-actions.pod:156
6775 #, no-wrap
6776 msgid ""
6777 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6778 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6779 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6780 "\n"
6781 msgstr ""
6782
6783 # type: textblock
6784 #. type: textblock
6785 #: ../src/guestfs-actions.pod:160 ../fish/guestfish-actions.pod:102
6786 msgid ""
6787 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6788 "The first time you call this function, the disk appears as C</dev/sda>, the "
6789 "second time as C</dev/sdb>, and so on."
6790 msgstr ""
6791
6792 # type: textblock
6793 #. type: textblock
6794 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:107
6795 msgid ""
6796 "You don't necessarily need to be root when using libguestfs.  However you "
6797 "obviously do need sufficient permissions to access the filename for whatever "
6798 "operations you want to perform (ie. read access if you just want to read the "
6799 "image or write access if you want to modify the image)."
6800 msgstr ""
6801
6802 # type: textblock
6803 #. type: textblock
6804 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:113
6805 msgid "This call checks that C<filename> exists."
6806 msgstr ""
6807
6808 # type: textblock
6809 #. type: textblock
6810 #: ../src/guestfs-actions.pod:173 ../src/guestfs-actions.pod:4480
6811 #: ../fish/guestfish-actions.pod:115 ../fish/guestfish-actions.pod:3036
6812 msgid "The optional arguments are:"
6813 msgstr ""
6814
6815 # type: =item
6816 #. type: =item
6817 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:119
6818 msgid "C<readonly>"
6819 msgstr ""
6820
6821 # type: textblock
6822 #. type: textblock
6823 #: ../src/guestfs-actions.pod:179 ../fish/guestfish-actions.pod:121
6824 msgid ""
6825 "If true then the image is treated as read-only.  Writes are still allowed, "
6826 "but they are stored in a temporary snapshot overlay which is discarded at "
6827 "the end.  The disk that you add is not modified."
6828 msgstr ""
6829
6830 # type: =item
6831 #. type: =item
6832 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:125
6833 msgid "C<format>"
6834 msgstr ""
6835
6836 # type: textblock
6837 #. type: textblock
6838 #: ../src/guestfs-actions.pod:185
6839 msgid ""
6840 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6841 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6842 "Possible formats include C<raw> and C<qcow2>."
6843 msgstr ""
6844
6845 # type: textblock
6846 #. type: textblock
6847 #: ../src/guestfs-actions.pod:189 ../fish/guestfish-actions.pod:131
6848 msgid ""
6849 "Automatic detection of the format opens you up to a potential security hole "
6850 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6851 "RHBZ#642934.  Specifying the format closes this security hole."
6852 msgstr ""
6853
6854 # type: =item
6855 #. type: =item
6856 #: ../src/guestfs-actions.pod:194 ../fish/guestfish-actions.pod:136
6857 msgid "C<iface>"
6858 msgstr ""
6859
6860 # type: textblock
6861 #. type: textblock
6862 #: ../src/guestfs-actions.pod:196
6863 msgid ""
6864 "This rarely-used option lets you emulate the behaviour of the deprecated "
6865 "C<guestfs_add_drive_with_if> call (q.v.)"
6866 msgstr ""
6867
6868 # type: textblock
6869 #. type: textblock
6870 #: ../src/guestfs-actions.pod:203
6871 msgid "(Added in 1.5.23)"
6872 msgstr ""
6873
6874 # type: =head2
6875 #. type: =head2
6876 #: ../src/guestfs-actions.pod:205
6877 msgid "guestfs_add_drive_opts_va"
6878 msgstr ""
6879
6880 # type: verbatim
6881 #. type: verbatim
6882 #: ../src/guestfs-actions.pod:207
6883 #, no-wrap
6884 msgid ""
6885 " int\n"
6886 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6887 "                            const char *filename,\n"
6888 "                            va_list args);\n"
6889 "\n"
6890 msgstr ""
6891
6892 # type: textblock
6893 #. type: textblock
6894 #: ../src/guestfs-actions.pod:212
6895 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6896 msgstr ""
6897
6898 # type: =head2
6899 #. type: =head2
6900 #: ../src/guestfs-actions.pod:216
6901 msgid "guestfs_add_drive_opts_argv"
6902 msgstr ""
6903
6904 # type: verbatim
6905 #. type: verbatim
6906 #: ../src/guestfs-actions.pod:218
6907 #, no-wrap
6908 msgid ""
6909 " int\n"
6910 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6911 "                              const char *filename,\n"
6912 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6913 "\n"
6914 msgstr ""
6915
6916 # type: textblock
6917 #. type: textblock
6918 #: ../src/guestfs-actions.pod:223
6919 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6920 msgstr ""
6921
6922 # type: =head2
6923 #. type: =head2
6924 #: ../src/guestfs-actions.pod:227
6925 msgid "guestfs_add_drive_ro"
6926 msgstr ""
6927
6928 # type: verbatim
6929 #. type: verbatim
6930 #: ../src/guestfs-actions.pod:229
6931 #, no-wrap
6932 msgid ""
6933 " int\n"
6934 " guestfs_add_drive_ro (guestfs_h *g,\n"
6935 "                       const char *filename);\n"
6936 "\n"
6937 msgstr ""
6938
6939 # type: textblock
6940 #. type: textblock
6941 #: ../src/guestfs-actions.pod:233
6942 msgid ""
6943 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6944 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6945 "disk is added read-only, with the format being detected automatically."
6946 msgstr ""
6947
6948 # type: textblock
6949 #. type: textblock
6950 #: ../src/guestfs-actions.pod:240
6951 msgid "(Added in 1.0.38)"
6952 msgstr ""
6953
6954 # type: =head2
6955 #. type: =head2
6956 #: ../src/guestfs-actions.pod:242
6957 msgid "guestfs_add_drive_ro_with_if"
6958 msgstr ""
6959
6960 # type: verbatim
6961 #. type: verbatim
6962 #: ../src/guestfs-actions.pod:244
6963 #, no-wrap
6964 msgid ""
6965 " int\n"
6966 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6967 "                               const char *filename,\n"
6968 "                               const char *iface);\n"
6969 "\n"
6970 msgstr ""
6971
6972 # type: textblock
6973 #. type: textblock
6974 #: ../src/guestfs-actions.pod:249
6975 msgid ""
6976 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6977 "QEMU interface emulation to use at run time."
6978 msgstr ""
6979
6980 # type: textblock
6981 #. type: textblock
6982 #: ../src/guestfs-actions.pod:261 ../src/guestfs-actions.pod:282
6983 #: ../src/guestfs-actions.pod:2359
6984 msgid "(Added in 1.0.84)"
6985 msgstr ""
6986
6987 # type: =head2
6988 #. type: =head2
6989 #: ../src/guestfs-actions.pod:263
6990 msgid "guestfs_add_drive_with_if"
6991 msgstr ""
6992
6993 # type: verbatim
6994 #. type: verbatim
6995 #: ../src/guestfs-actions.pod:265
6996 #, no-wrap
6997 msgid ""
6998 " int\n"
6999 " guestfs_add_drive_with_if (guestfs_h *g,\n"
7000 "                            const char *filename,\n"
7001 "                            const char *iface);\n"
7002 "\n"
7003 msgstr ""
7004
7005 # type: textblock
7006 #. type: textblock
7007 #: ../src/guestfs-actions.pod:270
7008 msgid ""
7009 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
7010 "QEMU interface emulation to use at run time."
7011 msgstr ""
7012
7013 # type: =head2
7014 #. type: =head2
7015 #: ../src/guestfs-actions.pod:284
7016 msgid "guestfs_aug_clear"
7017 msgstr ""
7018
7019 # type: verbatim
7020 #. type: verbatim
7021 #: ../src/guestfs-actions.pod:286
7022 #, no-wrap
7023 msgid ""
7024 " int\n"
7025 " guestfs_aug_clear (guestfs_h *g,\n"
7026 "                    const char *augpath);\n"
7027 "\n"
7028 msgstr ""
7029
7030 # type: textblock
7031 #. type: textblock
7032 #: ../src/guestfs-actions.pod:290 ../fish/guestfish-actions.pod:188
7033 msgid ""
7034 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
7035 "L<augtool(1)> C<clear> command."
7036 msgstr ""
7037
7038 # type: textblock
7039 #. type: textblock
7040 #: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:2109
7041 msgid "(Added in 1.3.4)"
7042 msgstr ""
7043
7044 # type: =head2
7045 #. type: =head2
7046 #: ../src/guestfs-actions.pod:297
7047 msgid "guestfs_aug_close"
7048 msgstr ""
7049
7050 # type: verbatim
7051 #. type: verbatim
7052 #: ../src/guestfs-actions.pod:299
7053 #, no-wrap
7054 msgid ""
7055 " int\n"
7056 " guestfs_aug_close (guestfs_h *g);\n"
7057 "\n"
7058 msgstr ""
7059
7060 # type: textblock
7061 #. type: textblock
7062 #: ../src/guestfs-actions.pod:302
7063 msgid ""
7064 "Close the current Augeas handle and free up any resources used by it.  After "
7065 "calling this, you have to call C<guestfs_aug_init> again before you can use "
7066 "any other Augeas functions."
7067 msgstr ""
7068
7069 # type: textblock
7070 #. type: textblock
7071 #: ../src/guestfs-actions.pod:309 ../src/guestfs-actions.pod:334
7072 #: ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:366
7073 #: ../src/guestfs-actions.pod:424 ../src/guestfs-actions.pod:444
7074 #: ../src/guestfs-actions.pod:458 ../src/guestfs-actions.pod:489
7075 #: ../src/guestfs-actions.pod:503 ../src/guestfs-actions.pod:517
7076 #: ../src/guestfs-actions.pod:531 ../src/guestfs-actions.pod:549
7077 #: ../src/guestfs-actions.pod:5513
7078 msgid "(Added in 0.7)"
7079 msgstr ""
7080
7081 # type: =head2
7082 #. type: =head2
7083 #: ../src/guestfs-actions.pod:311
7084 msgid "guestfs_aug_defnode"
7085 msgstr ""
7086
7087 # type: verbatim
7088 #. type: verbatim
7089 #: ../src/guestfs-actions.pod:313
7090 #, no-wrap
7091 msgid ""
7092 " struct guestfs_int_bool *\n"
7093 " guestfs_aug_defnode (guestfs_h *g,\n"
7094 "                      const char *name,\n"
7095 "                      const char *expr,\n"
7096 "                      const char *val);\n"
7097 "\n"
7098 msgstr ""
7099
7100 # type: textblock
7101 #. type: textblock
7102 #: ../src/guestfs-actions.pod:319 ../fish/guestfish-actions.pod:204
7103 msgid ""
7104 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
7105 msgstr ""
7106
7107 # type: textblock
7108 #. type: textblock
7109 #: ../src/guestfs-actions.pod:322
7110 msgid ""
7111 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
7112 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
7113 "containing that single node."
7114 msgstr ""
7115
7116 # type: textblock
7117 #. type: textblock
7118 #: ../src/guestfs-actions.pod:326 ../fish/guestfish-actions.pod:211
7119 msgid ""
7120 "On success this returns a pair containing the number of nodes in the "
7121 "nodeset, and a boolean flag if a node was created."
7122 msgstr ""
7123
7124 # type: textblock
7125 #. type: textblock
7126 #: ../src/guestfs-actions.pod:330
7127 msgid ""
7128 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
7129 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
7130 msgstr ""
7131
7132 # type: =head2
7133 #. type: =head2
7134 #: ../src/guestfs-actions.pod:336
7135 msgid "guestfs_aug_defvar"
7136 msgstr ""
7137
7138 # type: verbatim
7139 #. type: verbatim
7140 #: ../src/guestfs-actions.pod:338
7141 #, no-wrap
7142 msgid ""
7143 " int\n"
7144 " guestfs_aug_defvar (guestfs_h *g,\n"
7145 "                     const char *name,\n"
7146 "                     const char *expr);\n"
7147 "\n"
7148 msgstr ""
7149
7150 # type: textblock
7151 #. type: textblock
7152 #: ../src/guestfs-actions.pod:343 ../fish/guestfish-actions.pod:219
7153 msgid ""
7154 "Defines an Augeas variable C<name> whose value is the result of evaluating "
7155 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
7156 msgstr ""
7157
7158 # type: textblock
7159 #. type: textblock
7160 #: ../src/guestfs-actions.pod:347 ../fish/guestfish-actions.pod:223
7161 msgid ""
7162 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
7163 "evaluates to something which is not a nodeset."
7164 msgstr ""
7165
7166 # type: =head2
7167 #. type: =head2
7168 #: ../src/guestfs-actions.pod:354
7169 msgid "guestfs_aug_get"
7170 msgstr ""
7171
7172 # type: verbatim
7173 #. type: verbatim
7174 #: ../src/guestfs-actions.pod:356
7175 #, no-wrap
7176 msgid ""
7177 " char *\n"
7178 " guestfs_aug_get (guestfs_h *g,\n"
7179 "                  const char *augpath);\n"
7180 "\n"
7181 msgstr ""
7182
7183 # type: textblock
7184 #. type: textblock
7185 #: ../src/guestfs-actions.pod:360 ../fish/guestfish-actions.pod:230
7186 msgid ""
7187 "Look up the value associated with C<path>.  If C<path> matches exactly one "
7188 "node, the C<value> is returned."
7189 msgstr ""
7190
7191 # type: textblock
7192 #. type: textblock
7193 #: ../src/guestfs-actions.pod:363 ../src/guestfs-actions.pod:863
7194 #: ../src/guestfs-actions.pod:881 ../src/guestfs-actions.pod:941
7195 #: ../src/guestfs-actions.pod:957 ../src/guestfs-actions.pod:1060
7196 #: ../src/guestfs-actions.pod:1190 ../src/guestfs-actions.pod:1207
7197 #: ../src/guestfs-actions.pod:1226 ../src/guestfs-actions.pod:1360
7198 #: ../src/guestfs-actions.pod:1548 ../src/guestfs-actions.pod:1660
7199 #: ../src/guestfs-actions.pod:1823 ../src/guestfs-actions.pod:1840
7200 #: ../src/guestfs-actions.pod:1907 ../src/guestfs-actions.pod:1941
7201 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:2132
7202 #: ../src/guestfs-actions.pod:2324 ../src/guestfs-actions.pod:2531
7203 #: ../src/guestfs-actions.pod:2624 ../src/guestfs-actions.pod:2735
7204 #: ../src/guestfs-actions.pod:2755 ../src/guestfs-actions.pod:2875
7205 #: ../src/guestfs-actions.pod:2906 ../src/guestfs-actions.pod:2930
7206 #: ../src/guestfs-actions.pod:2967 ../src/guestfs-actions.pod:3027
7207 #: ../src/guestfs-actions.pod:3050 ../src/guestfs-actions.pod:3071
7208 #: ../src/guestfs-actions.pod:3666 ../src/guestfs-actions.pod:4016
7209 #: ../src/guestfs-actions.pod:4186 ../src/guestfs-actions.pod:4296
7210 #: ../src/guestfs-actions.pod:5048 ../src/guestfs-actions.pod:5241
7211 #: ../src/guestfs-actions.pod:5411 ../src/guestfs-actions.pod:5589
7212 #: ../src/guestfs-actions.pod:5638 ../src/guestfs-actions.pod:6271
7213 #: ../src/guestfs-actions.pod:6287 ../src/guestfs-actions.pod:6304
7214 #: ../src/guestfs-actions.pod:6335 ../src/guestfs-actions.pod:7009
7215 #: ../src/guestfs-actions.pod:7028 ../src/guestfs-actions.pod:7046
7216 #: ../src/guestfs-actions.pod:7226 ../src/guestfs-actions.pod:7506
7217 msgid ""
7218 "This function returns a string, or NULL on error.  I<The caller must free "
7219 "the returned string after use>."
7220 msgstr ""
7221
7222 # type: =head2
7223 #. type: =head2
7224 #: ../src/guestfs-actions.pod:368
7225 msgid "guestfs_aug_init"
7226 msgstr ""
7227
7228 # type: verbatim
7229 #. type: verbatim
7230 #: ../src/guestfs-actions.pod:370
7231 #, no-wrap
7232 msgid ""
7233 " int\n"
7234 " guestfs_aug_init (guestfs_h *g,\n"
7235 "                   const char *root,\n"
7236 "                   int flags);\n"
7237 "\n"
7238 msgstr ""
7239
7240 # type: textblock
7241 #. type: textblock
7242 #: ../src/guestfs-actions.pod:375 ../fish/guestfish-actions.pod:237
7243 msgid ""
7244 "Create a new Augeas handle for editing configuration files.  If there was "
7245 "any previous Augeas handle associated with this guestfs session, then it is "
7246 "closed."
7247 msgstr ""
7248
7249 # type: textblock
7250 #. type: textblock
7251 #: ../src/guestfs-actions.pod:379
7252 msgid "You must call this before using any other C<guestfs_aug_*> commands."
7253 msgstr ""
7254
7255 # type: textblock
7256 #. type: textblock
7257 #: ../src/guestfs-actions.pod:382 ../fish/guestfish-actions.pod:244
7258 msgid ""
7259 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
7260 msgstr ""
7261
7262 # type: textblock
7263 #. type: textblock
7264 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:247
7265 msgid ""
7266 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
7267 "logical I<or> of the following integers:"
7268 msgstr ""
7269
7270 # type: =item
7271 #. type: =item
7272 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:253
7273 msgid "C<AUG_SAVE_BACKUP> = 1"
7274 msgstr ""
7275
7276 # type: textblock
7277 #. type: textblock
7278 #: ../src/guestfs-actions.pod:393 ../fish/guestfish-actions.pod:255
7279 msgid "Keep the original file with a C<.augsave> extension."
7280 msgstr ""
7281
7282 # type: =item
7283 #. type: =item
7284 #: ../src/guestfs-actions.pod:395 ../fish/guestfish-actions.pod:257
7285 msgid "C<AUG_SAVE_NEWFILE> = 2"
7286 msgstr ""
7287
7288 # type: textblock
7289 #. type: textblock
7290 #: ../src/guestfs-actions.pod:397 ../fish/guestfish-actions.pod:259
7291 msgid ""
7292 "Save changes into a file with extension C<.augnew>, and do not overwrite "
7293 "original.  Overrides C<AUG_SAVE_BACKUP>."
7294 msgstr ""
7295
7296 # type: =item
7297 #. type: =item
7298 #: ../src/guestfs-actions.pod:400 ../fish/guestfish-actions.pod:262
7299 msgid "C<AUG_TYPE_CHECK> = 4"
7300 msgstr ""
7301
7302 # type: textblock
7303 #. type: textblock
7304 #: ../src/guestfs-actions.pod:402 ../fish/guestfish-actions.pod:264
7305 msgid "Typecheck lenses (can be expensive)."
7306 msgstr ""
7307
7308 # type: =item
7309 #. type: =item
7310 #: ../src/guestfs-actions.pod:404 ../fish/guestfish-actions.pod:266
7311 msgid "C<AUG_NO_STDINC> = 8"
7312 msgstr ""
7313
7314 # type: textblock
7315 #. type: textblock
7316 #: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:268
7317 msgid "Do not use standard load path for modules."
7318 msgstr ""
7319
7320 # type: =item
7321 #. type: =item
7322 #: ../src/guestfs-actions.pod:408 ../fish/guestfish-actions.pod:270
7323 msgid "C<AUG_SAVE_NOOP> = 16"
7324 msgstr ""
7325
7326 # type: textblock
7327 #. type: textblock
7328 #: ../src/guestfs-actions.pod:410 ../fish/guestfish-actions.pod:272
7329 msgid "Make save a no-op, just record what would have been changed."
7330 msgstr ""
7331
7332 # type: =item
7333 #. type: =item
7334 #: ../src/guestfs-actions.pod:412 ../fish/guestfish-actions.pod:274
7335 msgid "C<AUG_NO_LOAD> = 32"
7336 msgstr ""
7337
7338 # type: textblock
7339 #. type: textblock
7340 #: ../src/guestfs-actions.pod:414
7341 msgid "Do not load the tree in C<guestfs_aug_init>."
7342 msgstr ""
7343
7344 # type: textblock
7345 #. type: textblock
7346 #: ../src/guestfs-actions.pod:418
7347 msgid "To close the handle, you can call C<guestfs_aug_close>."
7348 msgstr ""
7349
7350 # type: textblock
7351 #. type: textblock
7352 #: ../src/guestfs-actions.pod:420 ../fish/guestfish-actions.pod:282
7353 msgid "To find out more about Augeas, see L<http://augeas.net/>."
7354 msgstr ""
7355
7356 # type: =head2
7357 #. type: =head2
7358 #: ../src/guestfs-actions.pod:426
7359 msgid "guestfs_aug_insert"
7360 msgstr ""
7361
7362 # type: verbatim
7363 #. type: verbatim
7364 #: ../src/guestfs-actions.pod:428
7365 #, no-wrap
7366 msgid ""
7367 " int\n"
7368 " guestfs_aug_insert (guestfs_h *g,\n"
7369 "                     const char *augpath,\n"
7370 "                     const char *label,\n"
7371 "                     int before);\n"
7372 "\n"
7373 msgstr ""
7374
7375 # type: textblock
7376 #. type: textblock
7377 #: ../src/guestfs-actions.pod:434 ../fish/guestfish-actions.pod:288
7378 msgid ""
7379 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
7380 "or after C<path> (depending on the boolean flag C<before>)."
7381 msgstr ""
7382
7383 # type: textblock
7384 #. type: textblock
7385 #: ../src/guestfs-actions.pod:438 ../fish/guestfish-actions.pod:292
7386 msgid ""
7387 "C<path> must match exactly one existing node in the tree, and C<label> must "
7388 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
7389 msgstr ""
7390
7391 # type: =head2
7392 #. type: =head2
7393 #: ../src/guestfs-actions.pod:446
7394 msgid "guestfs_aug_load"
7395 msgstr ""
7396
7397 # type: verbatim
7398 #. type: verbatim
7399 #: ../src/guestfs-actions.pod:448
7400 #, no-wrap
7401 msgid ""
7402 " int\n"
7403 " guestfs_aug_load (guestfs_h *g);\n"
7404 "\n"
7405 msgstr ""
7406
7407 # type: textblock
7408 #. type: textblock
7409 #: ../src/guestfs-actions.pod:451 ../fish/guestfish-actions.pod:300
7410 msgid "Load files into the tree."
7411 msgstr ""
7412
7413 # type: textblock
7414 #. type: textblock
7415 #: ../src/guestfs-actions.pod:453 ../fish/guestfish-actions.pod:302
7416 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
7417 msgstr ""
7418
7419 # type: =head2
7420 #. type: =head2
7421 #: ../src/guestfs-actions.pod:460
7422 msgid "guestfs_aug_ls"
7423 msgstr ""
7424
7425 # type: verbatim
7426 #. type: verbatim
7427 #: ../src/guestfs-actions.pod:462
7428 #, no-wrap
7429 msgid ""
7430 " char **\n"
7431 " guestfs_aug_ls (guestfs_h *g,\n"
7432 "                 const char *augpath);\n"
7433 "\n"
7434 msgstr ""
7435
7436 # type: textblock
7437 #. type: textblock
7438 #: ../src/guestfs-actions.pod:466
7439 msgid ""
7440 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
7441 "sorting the resulting nodes into alphabetical order."
7442 msgstr ""
7443
7444 # type: textblock
7445 #. type: textblock
7446 #: ../src/guestfs-actions.pod:469 ../src/guestfs-actions.pod:485
7447 #: ../src/guestfs-actions.pod:631 ../src/guestfs-actions.pod:1079
7448 #: ../src/guestfs-actions.pod:1375 ../src/guestfs-actions.pod:1394
7449 #: ../src/guestfs-actions.pod:1497 ../src/guestfs-actions.pod:1516
7450 #: ../src/guestfs-actions.pod:1762 ../src/guestfs-actions.pod:2204
7451 #: ../src/guestfs-actions.pod:2220 ../src/guestfs-actions.pod:2239
7452 #: ../src/guestfs-actions.pod:2282 ../src/guestfs-actions.pod:2306
7453 #: ../src/guestfs-actions.pod:2377 ../src/guestfs-actions.pod:2426
7454 #: ../src/guestfs-actions.pod:2693 ../src/guestfs-actions.pod:2984
7455 #: ../src/guestfs-actions.pod:3273 ../src/guestfs-actions.pod:3586
7456 #: ../src/guestfs-actions.pod:3648 ../src/guestfs-actions.pod:3753
7457 #: ../src/guestfs-actions.pod:4158 ../src/guestfs-actions.pod:4863
7458 #: ../src/guestfs-actions.pod:5383 ../src/guestfs-actions.pod:5509
7459 #: ../src/guestfs-actions.pod:5623 ../src/guestfs-actions.pod:6351
7460 #: ../src/guestfs-actions.pod:6412 ../src/guestfs-actions.pod:6467
7461 #: ../src/guestfs-actions.pod:6613 ../src/guestfs-actions.pod:6637
7462 #: ../src/guestfs-actions.pod:7119 ../src/guestfs-actions.pod:7139
7463 #: ../src/guestfs-actions.pod:7186 ../src/guestfs-actions.pod:7358
7464 #: ../src/guestfs-actions.pod:7377 ../src/guestfs-actions.pod:7463
7465 #: ../src/guestfs-actions.pod:7482 ../src/guestfs-actions.pod:7528
7466 #: ../src/guestfs-actions.pod:7547
7467 msgid ""
7468 "This function returns a NULL-terminated array of strings (like L<environ(3)"
7469 ">), or NULL if there was an error.  I<The caller must free the strings and "
7470 "the array after use>."
7471 msgstr ""
7472
7473 # type: textblock
7474 #. type: textblock
7475 #: ../src/guestfs-actions.pod:473 ../src/guestfs-actions.pod:1004
7476 #: ../src/guestfs-actions.pod:1022 ../src/guestfs-actions.pod:1432
7477 #: ../src/guestfs-actions.pod:3351 ../src/guestfs-actions.pod:3382
7478 #: ../src/guestfs-actions.pod:3999 ../src/guestfs-actions.pod:4049
7479 #: ../src/guestfs-actions.pod:4236 ../src/guestfs-actions.pod:4269
7480 #: ../src/guestfs-actions.pod:4432 ../src/guestfs-actions.pod:4867
7481 #: ../src/guestfs-actions.pod:5324 ../src/guestfs-actions.pod:5719
7482 #: ../src/guestfs-actions.pod:5733 ../src/guestfs-actions.pod:5745
7483 #: ../src/guestfs-actions.pod:6192 ../src/guestfs-actions.pod:6851
7484 #: ../src/guestfs-actions.pod:6864 ../src/guestfs-actions.pod:7103
7485 #: ../src/guestfs-actions.pod:7346
7486 msgid "(Added in 0.8)"
7487 msgstr ""
7488
7489 # type: =head2
7490 #. type: =head2
7491 #: ../src/guestfs-actions.pod:475
7492 msgid "guestfs_aug_match"
7493 msgstr ""
7494
7495 # type: verbatim
7496 #. type: verbatim
7497 #: ../src/guestfs-actions.pod:477
7498 #, no-wrap
7499 msgid ""
7500 " char **\n"
7501 " guestfs_aug_match (guestfs_h *g,\n"
7502 "                    const char *augpath);\n"
7503 "\n"
7504 msgstr ""
7505
7506 # type: textblock
7507 #. type: textblock
7508 #: ../src/guestfs-actions.pod:481 ../fish/guestfish-actions.pod:316
7509 msgid ""
7510 "Returns a list of paths which match the path expression C<path>.  The "
7511 "returned paths are sufficiently qualified so that they match exactly one "
7512 "node in the current tree."
7513 msgstr ""
7514
7515 # type: =head2
7516 #. type: =head2
7517 #: ../src/guestfs-actions.pod:491
7518 msgid "guestfs_aug_mv"
7519 msgstr ""
7520
7521 # type: verbatim
7522 #. type: verbatim
7523 #: ../src/guestfs-actions.pod:493
7524 #, no-wrap
7525 msgid ""
7526 " int\n"
7527 " guestfs_aug_mv (guestfs_h *g,\n"
7528 "                 const char *src,\n"
7529 "                 const char *dest);\n"
7530 "\n"
7531 msgstr ""
7532
7533 # type: textblock
7534 #. type: textblock
7535 #: ../src/guestfs-actions.pod:498 ../fish/guestfish-actions.pod:324
7536 msgid ""
7537 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
7538 "C<dest> is overwritten if it exists."
7539 msgstr ""
7540
7541 # type: =head2
7542 #. type: =head2
7543 #: ../src/guestfs-actions.pod:505
7544 msgid "guestfs_aug_rm"
7545 msgstr ""
7546
7547 # type: verbatim
7548 #. type: verbatim
7549 #: ../src/guestfs-actions.pod:507
7550 #, no-wrap
7551 msgid ""
7552 " int\n"
7553 " guestfs_aug_rm (guestfs_h *g,\n"
7554 "                 const char *augpath);\n"
7555 "\n"
7556 msgstr ""
7557
7558 # type: textblock
7559 #. type: textblock
7560 #: ../src/guestfs-actions.pod:511 ../fish/guestfish-actions.pod:331
7561 msgid "Remove C<path> and all of its children."
7562 msgstr ""
7563
7564 # type: textblock
7565 #. type: textblock
7566 #: ../src/guestfs-actions.pod:513 ../fish/guestfish-actions.pod:333
7567 msgid "On success this returns the number of entries which were removed."
7568 msgstr ""
7569
7570 # type: =head2
7571 #. type: =head2
7572 #: ../src/guestfs-actions.pod:519
7573 msgid "guestfs_aug_save"
7574 msgstr ""
7575
7576 # type: verbatim
7577 #. type: verbatim
7578 #: ../src/guestfs-actions.pod:521
7579 #, no-wrap
7580 msgid ""
7581 " int\n"
7582 " guestfs_aug_save (guestfs_h *g);\n"
7583 "\n"
7584 msgstr ""
7585
7586 # type: textblock
7587 #. type: textblock
7588 #: ../src/guestfs-actions.pod:524 ../fish/guestfish-actions.pod:339
7589 msgid "This writes all pending changes to disk."
7590 msgstr ""
7591
7592 # type: textblock
7593 #. type: textblock
7594 #: ../src/guestfs-actions.pod:526
7595 msgid ""
7596 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
7597 "are saved."
7598 msgstr ""
7599
7600 # type: =head2
7601 #. type: =head2
7602 #: ../src/guestfs-actions.pod:533
7603 msgid "guestfs_aug_set"
7604 msgstr ""
7605
7606 # type: verbatim
7607 #. type: verbatim
7608 #: ../src/guestfs-actions.pod:535
7609 #, no-wrap
7610 msgid ""
7611 " int\n"
7612 " guestfs_aug_set (guestfs_h *g,\n"
7613 "                  const char *augpath,\n"
7614 "                  const char *val);\n"
7615 "\n"
7616 msgstr ""
7617
7618 # type: textblock
7619 #. type: textblock
7620 #: ../src/guestfs-actions.pod:540 ../fish/guestfish-actions.pod:348
7621 msgid "Set the value associated with C<path> to C<val>."
7622 msgstr ""
7623
7624 # type: textblock
7625 #. type: textblock
7626 #: ../src/guestfs-actions.pod:542
7627 msgid ""
7628 "In the Augeas API, it is possible to clear a node by setting the value to "
7629 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
7630 "this call.  Instead you must use the C<guestfs_aug_clear> call."
7631 msgstr ""
7632
7633 # type: =head2
7634 #. type: =head2
7635 #: ../src/guestfs-actions.pod:551
7636 msgid "guestfs_available"
7637 msgstr ""
7638
7639 # type: verbatim
7640 #. type: verbatim
7641 #: ../src/guestfs-actions.pod:553
7642 #, no-wrap
7643 msgid ""
7644 " int\n"
7645 " guestfs_available (guestfs_h *g,\n"
7646 "                    char *const *groups);\n"
7647 "\n"
7648 msgstr ""
7649
7650 # type: textblock
7651 #. type: textblock
7652 #: ../src/guestfs-actions.pod:557 ../fish/guestfish-actions.pod:359
7653 msgid ""
7654 "This command is used to check the availability of some groups of "
7655 "functionality in the appliance, which not all builds of the libguestfs "
7656 "appliance will be able to provide."
7657 msgstr ""
7658
7659 # type: textblock
7660 #. type: textblock
7661 #: ../src/guestfs-actions.pod:561
7662 msgid ""
7663 "The libguestfs groups, and the functions that those groups correspond to, "
7664 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
7665 "runtime by calling C<guestfs_available_all_groups>."
7666 msgstr ""
7667
7668 # type: textblock
7669 #. type: textblock
7670 #: ../src/guestfs-actions.pod:566 ../fish/guestfish-actions.pod:368
7671 msgid ""
7672 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7673 "\"]> would check for the availability of the Linux inotify functions and "
7674 "Augeas (configuration file editing) functions."
7675 msgstr ""
7676
7677 # type: textblock
7678 #. type: textblock
7679 #: ../src/guestfs-actions.pod:571 ../fish/guestfish-actions.pod:373
7680 msgid "The command returns no error if I<all> requested groups are available."
7681 msgstr ""
7682
7683 # type: textblock
7684 #. type: textblock
7685 #: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:375
7686 msgid ""
7687 "It fails with an error if one or more of the requested groups is unavailable "
7688 "in the appliance."
7689 msgstr ""
7690
7691 # type: textblock
7692 #. type: textblock
7693 #: ../src/guestfs-actions.pod:576 ../fish/guestfish-actions.pod:378
7694 msgid ""
7695 "If an unknown group name is included in the list of groups then an error is "
7696 "always returned."
7697 msgstr ""
7698
7699 # type: textblock
7700 #. type: textblock
7701 #: ../src/guestfs-actions.pod:579 ../fish/guestfish-actions.pod:381
7702 msgid "I<Notes:>"
7703 msgstr ""
7704
7705 # type: textblock
7706 #. type: textblock
7707 #: ../src/guestfs-actions.pod:585
7708 msgid "You must call C<guestfs_launch> before calling this function."
7709 msgstr ""
7710
7711 # type: textblock
7712 #. type: textblock
7713 #: ../src/guestfs-actions.pod:587 ../fish/guestfish-actions.pod:389
7714 msgid ""
7715 "The reason is because we don't know what groups are supported by the "
7716 "appliance/daemon until it is running and can be queried."
7717 msgstr ""
7718
7719 # type: textblock
7720 #. type: textblock
7721 #: ../src/guestfs-actions.pod:593 ../fish/guestfish-actions.pod:395
7722 msgid ""
7723 "If a group of functions is available, this does not necessarily mean that "
7724 "they will work.  You still have to check for errors when calling individual "
7725 "API functions even if they are available."
7726 msgstr ""
7727
7728 # type: textblock
7729 #. type: textblock
7730 #: ../src/guestfs-actions.pod:600 ../fish/guestfish-actions.pod:402
7731 msgid ""
7732 "It is usually the job of distro packagers to build complete functionality "
7733 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
7734 "with all requirements satisfied, will support everything."
7735 msgstr ""
7736
7737 # type: textblock
7738 #. type: textblock
7739 #: ../src/guestfs-actions.pod:607
7740 msgid ""
7741 "This call was added in version C<1.0.80>.  In previous versions of "
7742 "libguestfs all you could do would be to speculatively execute a command to "
7743 "find out if the daemon implemented it.  See also C<guestfs_version>."
7744 msgstr ""
7745
7746 # type: textblock
7747 #. type: textblock
7748 #: ../src/guestfs-actions.pod:616 ../src/guestfs-actions.pod:1177
7749 msgid "(Added in 1.0.80)"
7750 msgstr ""
7751
7752 # type: =head2
7753 #. type: =head2
7754 #: ../src/guestfs-actions.pod:618
7755 msgid "guestfs_available_all_groups"
7756 msgstr ""
7757
7758 # type: verbatim
7759 #. type: verbatim
7760 #: ../src/guestfs-actions.pod:620
7761 #, no-wrap
7762 msgid ""
7763 " char **\n"
7764 " guestfs_available_all_groups (guestfs_h *g);\n"
7765 "\n"
7766 msgstr ""
7767
7768 # type: textblock
7769 #. type: textblock
7770 #: ../src/guestfs-actions.pod:623
7771 msgid ""
7772 "This command returns a list of all optional groups that this daemon knows "
7773 "about.  Note this returns both supported and unsupported groups.  To find "
7774 "out which ones the daemon can actually support you have to call "
7775 "C<guestfs_available> on each member of the returned list."
7776 msgstr ""
7777
7778 # type: textblock
7779 #. type: textblock
7780 #: ../src/guestfs-actions.pod:629
7781 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7782 msgstr ""
7783
7784 # type: textblock
7785 #. type: textblock
7786 #: ../src/guestfs-actions.pod:635
7787 msgid "(Added in 1.3.15)"
7788 msgstr ""
7789
7790 # type: =head2
7791 #. type: =head2
7792 #: ../src/guestfs-actions.pod:637
7793 msgid "guestfs_base64_in"
7794 msgstr ""
7795
7796 # type: verbatim
7797 #. type: verbatim
7798 #: ../src/guestfs-actions.pod:639
7799 #, no-wrap
7800 msgid ""
7801 " int\n"
7802 " guestfs_base64_in (guestfs_h *g,\n"
7803 "                    const char *base64file,\n"
7804 "                    const char *filename);\n"
7805 "\n"
7806 msgstr ""
7807
7808 # type: textblock
7809 #. type: textblock
7810 #: ../src/guestfs-actions.pod:644 ../fish/guestfish-actions.pod:432
7811 msgid ""
7812 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7813 msgstr ""
7814
7815 # type: textblock
7816 #. type: textblock
7817 #: ../src/guestfs-actions.pod:649 ../src/guestfs-actions.pod:663
7818 msgid "(Added in 1.3.5)"
7819 msgstr ""
7820
7821 # type: =head2
7822 #. type: =head2
7823 #: ../src/guestfs-actions.pod:651
7824 msgid "guestfs_base64_out"
7825 msgstr ""
7826
7827 # type: verbatim
7828 #. type: verbatim
7829 #: ../src/guestfs-actions.pod:653
7830 #, no-wrap
7831 msgid ""
7832 " int\n"
7833 " guestfs_base64_out (guestfs_h *g,\n"
7834 "                     const char *filename,\n"
7835 "                     const char *base64file);\n"
7836 "\n"
7837 msgstr ""
7838
7839 # type: textblock
7840 #. type: textblock
7841 #: ../src/guestfs-actions.pod:658 ../fish/guestfish-actions.pod:441
7842 msgid ""
7843 "This command downloads the contents of C<filename>, writing it out to local "
7844 "file C<base64file> encoded as base64."
7845 msgstr ""
7846
7847 # type: =head2
7848 #. type: =head2
7849 #: ../src/guestfs-actions.pod:665
7850 msgid "guestfs_blockdev_flushbufs"
7851 msgstr ""
7852
7853 # type: verbatim
7854 #. type: verbatim
7855 #: ../src/guestfs-actions.pod:667
7856 #, no-wrap
7857 msgid ""
7858 " int\n"
7859 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7860 "                             const char *device);\n"
7861 "\n"
7862 msgstr ""
7863
7864 # type: textblock
7865 #. type: textblock
7866 #: ../src/guestfs-actions.pod:671 ../fish/guestfish-actions.pod:450
7867 msgid ""
7868 "This tells the kernel to flush internal buffers associated with C<device>."
7869 msgstr ""
7870
7871 # type: textblock
7872 #. type: textblock
7873 #: ../src/guestfs-actions.pod:674 ../src/guestfs-actions.pod:691
7874 #: ../src/guestfs-actions.pod:706 ../src/guestfs-actions.pod:722
7875 #: ../src/guestfs-actions.pod:740 ../src/guestfs-actions.pod:759
7876 #: ../src/guestfs-actions.pod:773 ../src/guestfs-actions.pod:791
7877 #: ../src/guestfs-actions.pod:805 ../src/guestfs-actions.pod:819
7878 #: ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:464
7879 #: ../fish/guestfish-actions.pod:473 ../fish/guestfish-actions.pod:483
7880 #: ../fish/guestfish-actions.pod:495 ../fish/guestfish-actions.pod:508
7881 #: ../fish/guestfish-actions.pod:516 ../fish/guestfish-actions.pod:527
7882 #: ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:543
7883 msgid "This uses the L<blockdev(8)> command."
7884 msgstr ""
7885
7886 # type: textblock
7887 #. type: textblock
7888 #: ../src/guestfs-actions.pod:678 ../src/guestfs-actions.pod:695
7889 #: ../src/guestfs-actions.pod:710 ../src/guestfs-actions.pod:726
7890 #: ../src/guestfs-actions.pod:744 ../src/guestfs-actions.pod:763
7891 #: ../src/guestfs-actions.pod:777 ../src/guestfs-actions.pod:795
7892 #: ../src/guestfs-actions.pod:809 ../src/guestfs-actions.pod:823
7893 msgid "(Added in 0.9.3)"
7894 msgstr ""
7895
7896 # type: =head2
7897 #. type: =head2
7898 #: ../src/guestfs-actions.pod:680
7899 msgid "guestfs_blockdev_getbsz"
7900 msgstr ""
7901
7902 # type: verbatim
7903 #. type: verbatim
7904 #: ../src/guestfs-actions.pod:682
7905 #, no-wrap
7906 msgid ""
7907 " int\n"
7908 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7909 "                          const char *device);\n"
7910 "\n"
7911 msgstr ""
7912
7913 # type: textblock
7914 #. type: textblock
7915 #: ../src/guestfs-actions.pod:686 ../fish/guestfish-actions.pod:459
7916 msgid "This returns the block size of a device."
7917 msgstr ""
7918
7919 # type: textblock
7920 #. type: textblock
7921 #: ../src/guestfs-actions.pod:688 ../src/guestfs-actions.pod:788
7922 #: ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:524
7923 msgid ""
7924 "(Note this is different from both I<size in blocks> and I<filesystem block "
7925 "size>)."
7926 msgstr ""
7927
7928 # type: =head2
7929 #. type: =head2
7930 #: ../src/guestfs-actions.pod:697
7931 msgid "guestfs_blockdev_getro"
7932 msgstr ""
7933
7934 # type: verbatim
7935 #. type: verbatim
7936 #: ../src/guestfs-actions.pod:699
7937 #, no-wrap
7938 msgid ""
7939 " int\n"
7940 " guestfs_blockdev_getro (guestfs_h *g,\n"
7941 "                         const char *device);\n"
7942 "\n"
7943 msgstr ""
7944
7945 # type: textblock
7946 #. type: textblock
7947 #: ../src/guestfs-actions.pod:703 ../fish/guestfish-actions.pod:470
7948 msgid ""
7949 "Returns a boolean indicating if the block device is read-only (true if read-"
7950 "only, false if not)."
7951 msgstr ""
7952
7953 # type: textblock
7954 #. type: textblock
7955 #: ../src/guestfs-actions.pod:708 ../src/guestfs-actions.pod:1415
7956 #: ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1917
7957 #: ../src/guestfs-actions.pod:1928 ../src/guestfs-actions.pod:2000
7958 #: ../src/guestfs-actions.pod:2055 ../src/guestfs-actions.pod:2070
7959 #: ../src/guestfs-actions.pod:2095 ../src/guestfs-actions.pod:2118
7960 #: ../src/guestfs-actions.pod:3091 ../src/guestfs-actions.pod:3108
7961 #: ../src/guestfs-actions.pod:3127 ../src/guestfs-actions.pod:3290
7962 #: ../src/guestfs-actions.pod:3304 ../src/guestfs-actions.pod:3319
7963 #: ../src/guestfs-actions.pod:3333 ../src/guestfs-actions.pod:3349
7964 #: ../src/guestfs-actions.pod:3364 ../src/guestfs-actions.pod:3380
7965 #: ../src/guestfs-actions.pod:3394 ../src/guestfs-actions.pod:3407
7966 #: ../src/guestfs-actions.pod:3421 ../src/guestfs-actions.pod:3436
7967 #: ../src/guestfs-actions.pod:3451 ../src/guestfs-actions.pod:3464
7968 #: ../src/guestfs-actions.pod:3476 ../src/guestfs-actions.pod:5012
7969 msgid "This function returns a C truth value on success or -1 on error."
7970 msgstr ""
7971
7972 # type: =head2
7973 #. type: =head2
7974 #: ../src/guestfs-actions.pod:712
7975 msgid "guestfs_blockdev_getsize64"
7976 msgstr ""
7977
7978 # type: verbatim
7979 #. type: verbatim
7980 #: ../src/guestfs-actions.pod:714
7981 #, no-wrap
7982 msgid ""
7983 " int64_t\n"
7984 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7985 "                             const char *device);\n"
7986 "\n"
7987 msgstr ""
7988
7989 # type: textblock
7990 #. type: textblock
7991 #: ../src/guestfs-actions.pod:718 ../fish/guestfish-actions.pod:479
7992 msgid "This returns the size of the device in bytes."
7993 msgstr ""
7994
7995 # type: textblock
7996 #. type: textblock
7997 #: ../src/guestfs-actions.pod:720
7998 msgid "See also C<guestfs_blockdev_getsz>."
7999 msgstr ""
8000
8001 # type: =head2
8002 #. type: =head2
8003 #: ../src/guestfs-actions.pod:728
8004 msgid "guestfs_blockdev_getss"
8005 msgstr ""
8006
8007 # type: verbatim
8008 #. type: verbatim
8009 #: ../src/guestfs-actions.pod:730
8010 #, no-wrap
8011 msgid ""
8012 " int\n"
8013 " guestfs_blockdev_getss (guestfs_h *g,\n"
8014 "                         const char *device);\n"
8015 "\n"
8016 msgstr ""
8017
8018 # type: textblock
8019 #. type: textblock
8020 #: ../src/guestfs-actions.pod:734 ../fish/guestfish-actions.pod:489
8021 msgid ""
8022 "This returns the size of sectors on a block device.  Usually 512, but can be "
8023 "larger for modern devices."
8024 msgstr ""
8025
8026 # type: textblock
8027 #. type: textblock
8028 #: ../src/guestfs-actions.pod:737
8029 msgid ""
8030 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
8031 "that)."
8032 msgstr ""
8033
8034 # type: =head2
8035 #. type: =head2
8036 #: ../src/guestfs-actions.pod:746
8037 msgid "guestfs_blockdev_getsz"
8038 msgstr ""
8039
8040 # type: verbatim
8041 #. type: verbatim
8042 #: ../src/guestfs-actions.pod:748
8043 #, no-wrap
8044 msgid ""
8045 " int64_t\n"
8046 " guestfs_blockdev_getsz (guestfs_h *g,\n"
8047 "                         const char *device);\n"
8048 "\n"
8049 msgstr ""
8050
8051 # type: textblock
8052 #. type: textblock
8053 #: ../src/guestfs-actions.pod:752 ../fish/guestfish-actions.pod:501
8054 msgid ""
8055 "This returns the size of the device in units of 512-byte sectors (even if "
8056 "the sectorsize isn't 512 bytes ... weird)."
8057 msgstr ""
8058
8059 # type: textblock
8060 #. type: textblock
8061 #: ../src/guestfs-actions.pod:755
8062 msgid ""
8063 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
8064 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
8065 msgstr ""
8066
8067 # type: =head2
8068 #. type: =head2
8069 #: ../src/guestfs-actions.pod:765
8070 msgid "guestfs_blockdev_rereadpt"
8071 msgstr ""
8072
8073 # type: verbatim
8074 #. type: verbatim
8075 #: ../src/guestfs-actions.pod:767
8076 #, no-wrap
8077 msgid ""
8078 " int\n"
8079 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
8080 "                            const char *device);\n"
8081 "\n"
8082 msgstr ""
8083
8084 # type: textblock
8085 #. type: textblock
8086 #: ../src/guestfs-actions.pod:771 ../fish/guestfish-actions.pod:514
8087 msgid "Reread the partition table on C<device>."
8088 msgstr ""
8089
8090 # type: =head2
8091 #. type: =head2
8092 #: ../src/guestfs-actions.pod:779
8093 msgid "guestfs_blockdev_setbsz"
8094 msgstr ""
8095
8096 # type: verbatim
8097 #. type: verbatim
8098 #: ../src/guestfs-actions.pod:781
8099 #, no-wrap
8100 msgid ""
8101 " int\n"
8102 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
8103 "                          const char *device,\n"
8104 "                          int blocksize);\n"
8105 "\n"
8106 msgstr ""
8107
8108 # type: textblock
8109 #. type: textblock
8110 #: ../src/guestfs-actions.pod:786 ../fish/guestfish-actions.pod:522
8111 msgid "This sets the block size of a device."
8112 msgstr ""
8113
8114 # type: =head2
8115 #. type: =head2
8116 #: ../src/guestfs-actions.pod:797
8117 msgid "guestfs_blockdev_setro"
8118 msgstr ""
8119
8120 # type: verbatim
8121 #. type: verbatim
8122 #: ../src/guestfs-actions.pod:799
8123 #, no-wrap
8124 msgid ""
8125 " int\n"
8126 " guestfs_blockdev_setro (guestfs_h *g,\n"
8127 "                         const char *device);\n"
8128 "\n"
8129 msgstr ""
8130
8131 # type: textblock
8132 #. type: textblock
8133 #: ../src/guestfs-actions.pod:803 ../fish/guestfish-actions.pod:533
8134 msgid "Sets the block device named C<device> to read-only."
8135 msgstr ""
8136
8137 # type: =head2
8138 #. type: =head2
8139 #: ../src/guestfs-actions.pod:811
8140 msgid "guestfs_blockdev_setrw"
8141 msgstr ""
8142
8143 # type: verbatim
8144 #. type: verbatim
8145 #: ../src/guestfs-actions.pod:813
8146 #, no-wrap
8147 msgid ""
8148 " int\n"
8149 " guestfs_blockdev_setrw (guestfs_h *g,\n"
8150 "                         const char *device);\n"
8151 "\n"
8152 msgstr ""
8153
8154 # type: textblock
8155 #. type: textblock
8156 #: ../src/guestfs-actions.pod:817 ../fish/guestfish-actions.pod:541
8157 msgid "Sets the block device named C<device> to read-write."
8158 msgstr ""
8159
8160 # type: =head2
8161 #. type: =head2
8162 #: ../src/guestfs-actions.pod:825
8163 msgid "guestfs_case_sensitive_path"
8164 msgstr ""
8165
8166 # type: verbatim
8167 #. type: verbatim
8168 #: ../src/guestfs-actions.pod:827
8169 #, no-wrap
8170 msgid ""
8171 " char *\n"
8172 " guestfs_case_sensitive_path (guestfs_h *g,\n"
8173 "                              const char *path);\n"
8174 "\n"
8175 msgstr ""
8176
8177 # type: textblock
8178 #. type: textblock
8179 #: ../src/guestfs-actions.pod:831 ../fish/guestfish-actions.pod:549
8180 msgid ""
8181 "This can be used to resolve case insensitive paths on a filesystem which is "
8182 "case sensitive.  The use case is to resolve paths which you have read from "
8183 "Windows configuration files or the Windows Registry, to the true path."
8184 msgstr ""
8185
8186 # type: textblock
8187 #. type: textblock
8188 #: ../src/guestfs-actions.pod:836 ../fish/guestfish-actions.pod:554
8189 msgid ""
8190 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
8191 "(and probably others), which is that although the underlying filesystem is "
8192 "case-insensitive, the driver exports the filesystem to Linux as case-"
8193 "sensitive."
8194 msgstr ""
8195
8196 # type: textblock
8197 #. type: textblock
8198 #: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:559
8199 msgid ""
8200 "One consequence of this is that special directories such as C<c:\\windows> "
8201 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
8202 "precise details of how they were created.  In Windows itself this would not "
8203 "be a problem."
8204 msgstr ""
8205
8206 # type: textblock
8207 #. type: textblock
8208 #: ../src/guestfs-actions.pod:847 ../fish/guestfish-actions.pod:565
8209 msgid ""
8210 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
8211 "#posixfilenames1>"
8212 msgstr ""
8213
8214 # type: textblock
8215 #. type: textblock
8216 #: ../src/guestfs-actions.pod:850 ../fish/guestfish-actions.pod:568
8217 msgid ""
8218 "This function resolves the true case of each element in the path and returns "
8219 "the case-sensitive path."
8220 msgstr ""
8221
8222 # type: textblock
8223 #. type: textblock
8224 #: ../src/guestfs-actions.pod:853
8225 msgid ""
8226 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
8227 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
8228 "how the directories were originally created under Windows)."
8229 msgstr ""
8230
8231 # type: textblock
8232 #. type: textblock
8233 #: ../src/guestfs-actions.pod:858 ../fish/guestfish-actions.pod:576
8234 msgid "I<Note>: This function does not handle drive names, backslashes etc."
8235 msgstr ""
8236
8237 # type: textblock
8238 #. type: textblock
8239 #: ../src/guestfs-actions.pod:861
8240 msgid "See also C<guestfs_realpath>."
8241 msgstr ""
8242
8243 # type: textblock
8244 #. type: textblock
8245 #: ../src/guestfs-actions.pod:866 ../src/guestfs-actions.pod:7031
8246 msgid "(Added in 1.0.75)"
8247 msgstr ""
8248
8249 # type: =head2
8250 #. type: =head2
8251 #: ../src/guestfs-actions.pod:868
8252 msgid "guestfs_cat"
8253 msgstr ""
8254
8255 # type: verbatim
8256 #. type: verbatim
8257 #: ../src/guestfs-actions.pod:870
8258 #, no-wrap
8259 msgid ""
8260 " char *\n"
8261 " guestfs_cat (guestfs_h *g,\n"
8262 "              const char *path);\n"
8263 "\n"
8264 msgstr ""
8265
8266 # type: textblock
8267 #. type: textblock
8268 #: ../src/guestfs-actions.pod:874 ../src/guestfs-actions.pod:5499
8269 #: ../fish/guestfish-actions.pod:585 ../fish/guestfish-actions.pod:3691
8270 msgid "Return the contents of the file named C<path>."
8271 msgstr ""
8272
8273 # type: textblock
8274 #. type: textblock
8275 #: ../src/guestfs-actions.pod:876
8276 msgid ""
8277 "Note that this function cannot correctly handle binary files (specifically, "
8278 "files containing C<\\0> character which is treated as end of string).  For "
8279 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
8280 "functions which have a more complex interface."
8281 msgstr ""
8282
8283 # type: textblock
8284 #. type: textblock
8285 #: ../src/guestfs-actions.pod:884 ../src/guestfs-actions.pod:1063
8286 #: ../src/guestfs-actions.pod:1083 ../src/guestfs-actions.pod:1379
8287 #: ../src/guestfs-actions.pod:1398 ../src/guestfs-actions.pod:1501
8288 #: ../src/guestfs-actions.pod:1520 ../src/guestfs-actions.pod:1766
8289 #: ../src/guestfs-actions.pod:2224 ../src/guestfs-actions.pod:2243
8290 #: ../src/guestfs-actions.pod:2286 ../src/guestfs-actions.pod:2310
8291 #: ../src/guestfs-actions.pod:2327 ../src/guestfs-actions.pod:2356
8292 #: ../src/guestfs-actions.pod:5281 ../src/guestfs-actions.pod:5307
8293 #: ../src/guestfs-actions.pod:5438 ../src/guestfs-actions.pod:5464
8294 #: ../src/guestfs-actions.pod:5488 ../src/guestfs-actions.pod:6416
8295 #: ../src/guestfs-actions.pod:6471 ../src/guestfs-actions.pod:6617
8296 #: ../src/guestfs-actions.pod:6641 ../src/guestfs-actions.pod:7310
8297 #: ../src/guestfs-actions.pod:7336 ../src/guestfs-actions.pod:7362
8298 #: ../src/guestfs-actions.pod:7381 ../src/guestfs-actions.pod:7467
8299 #: ../src/guestfs-actions.pod:7486 ../src/guestfs-actions.pod:7532
8300 #: ../src/guestfs-actions.pod:7551 ../fish/guestfish-actions.pod:592
8301 #: ../fish/guestfish-actions.pod:727 ../fish/guestfish-actions.pod:739
8302 #: ../fish/guestfish-actions.pod:915 ../fish/guestfish-actions.pod:925
8303 #: ../fish/guestfish-actions.pod:992 ../fish/guestfish-actions.pod:1002
8304 #: ../fish/guestfish-actions.pod:1194 ../fish/guestfish-actions.pod:1495
8305 #: ../fish/guestfish-actions.pod:1505 ../fish/guestfish-actions.pod:1533
8306 #: ../fish/guestfish-actions.pod:1548 ../fish/guestfish-actions.pod:1558
8307 #: ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:3561
8308 #: ../fish/guestfish-actions.pod:3576 ../fish/guestfish-actions.pod:3652
8309 #: ../fish/guestfish-actions.pod:3669 ../fish/guestfish-actions.pod:3684
8310 #: ../fish/guestfish-actions.pod:4338 ../fish/guestfish-actions.pod:4384
8311 #: ../fish/guestfish-actions.pod:4469 ../fish/guestfish-actions.pod:4484
8312 #: ../fish/guestfish-actions.pod:4894 ../fish/guestfish-actions.pod:4912
8313 #: ../fish/guestfish-actions.pod:4929 ../fish/guestfish-actions.pod:4939
8314 #: ../fish/guestfish-actions.pod:4988 ../fish/guestfish-actions.pod:4998
8315 #: ../fish/guestfish-actions.pod:5027 ../fish/guestfish-actions.pod:5037
8316 msgid ""
8317 "Because of the message protocol, there is a transfer limit of somewhere "
8318 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
8319 msgstr ""
8320
8321 # type: textblock
8322 #. type: textblock
8323 #: ../src/guestfs-actions.pod:887 ../src/guestfs-actions.pod:3590
8324 #: ../src/guestfs-actions.pod:3652 ../src/guestfs-actions.pod:3669
8325 #: ../src/guestfs-actions.pod:3757 ../src/guestfs-actions.pod:4162
8326 #: ../src/guestfs-actions.pod:4176 ../src/guestfs-actions.pod:5387
8327 #: ../src/guestfs-actions.pod:5401 ../src/guestfs-actions.pod:7190
8328 #: ../src/guestfs-actions.pod:7204
8329 msgid "(Added in 0.4)"
8330 msgstr ""
8331
8332 # type: =head2
8333 #. type: =head2
8334 #: ../src/guestfs-actions.pod:889
8335 msgid "guestfs_checksum"
8336 msgstr ""
8337
8338 # type: verbatim
8339 #. type: verbatim
8340 #: ../src/guestfs-actions.pod:891
8341 #, no-wrap
8342 msgid ""
8343 " char *\n"
8344 " guestfs_checksum (guestfs_h *g,\n"
8345 "                   const char *csumtype,\n"
8346 "                   const char *path);\n"
8347 "\n"
8348 msgstr ""
8349
8350 # type: textblock
8351 #. type: textblock
8352 #: ../src/guestfs-actions.pod:896 ../fish/guestfish-actions.pod:599
8353 msgid ""
8354 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
8355 msgstr ""
8356
8357 # type: textblock
8358 #. type: textblock
8359 #: ../src/guestfs-actions.pod:899 ../fish/guestfish-actions.pod:602
8360 msgid ""
8361 "The type of checksum to compute is given by the C<csumtype> parameter which "
8362 "must have one of the following values:"
8363 msgstr ""
8364
8365 # type: =item
8366 #. type: =item
8367 #: ../src/guestfs-actions.pod:904 ../fish/guestfish-actions.pod:607
8368 msgid "C<crc>"
8369 msgstr ""
8370
8371 # type: textblock
8372 #. type: textblock
8373 #: ../src/guestfs-actions.pod:906 ../fish/guestfish-actions.pod:609
8374 msgid ""
8375 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
8376 "C<cksum> command."
8377 msgstr ""
8378
8379 # type: =item
8380 #. type: =item
8381 #: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:612
8382 msgid "C<md5>"
8383 msgstr ""
8384
8385 # type: textblock
8386 #. type: textblock
8387 #: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:614
8388 msgid "Compute the MD5 hash (using the C<md5sum> program)."
8389 msgstr ""
8390
8391 # type: =item
8392 #. type: =item
8393 #: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:616
8394 msgid "C<sha1>"
8395 msgstr ""
8396
8397 # type: textblock
8398 #. type: textblock
8399 #: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:618
8400 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
8401 msgstr ""
8402
8403 # type: =item
8404 #. type: =item
8405 #: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:620
8406 msgid "C<sha224>"
8407 msgstr ""
8408
8409 # type: textblock
8410 #. type: textblock
8411 #: ../src/guestfs-actions.pod:919 ../fish/guestfish-actions.pod:622
8412 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
8413 msgstr ""
8414
8415 # type: =item
8416 #. type: =item
8417 #: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:624
8418 msgid "C<sha256>"
8419 msgstr ""
8420
8421 # type: textblock
8422 #. type: textblock
8423 #: ../src/guestfs-actions.pod:923 ../fish/guestfish-actions.pod:626
8424 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
8425 msgstr ""
8426
8427 # type: =item
8428 #. type: =item
8429 #: ../src/guestfs-actions.pod:925 ../fish/guestfish-actions.pod:628
8430 msgid "C<sha384>"
8431 msgstr ""
8432
8433 # type: textblock
8434 #. type: textblock
8435 #: ../src/guestfs-actions.pod:927 ../fish/guestfish-actions.pod:630
8436 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
8437 msgstr ""
8438
8439 # type: =item
8440 #. type: =item
8441 #: ../src/guestfs-actions.pod:929 ../fish/guestfish-actions.pod:632
8442 msgid "C<sha512>"
8443 msgstr ""
8444
8445 # type: textblock
8446 #. type: textblock
8447 #: ../src/guestfs-actions.pod:931 ../fish/guestfish-actions.pod:634
8448 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
8449 msgstr ""
8450
8451 # type: textblock
8452 #. type: textblock
8453 #: ../src/guestfs-actions.pod:935 ../fish/guestfish-actions.pod:638
8454 msgid "The checksum is returned as a printable string."
8455 msgstr ""
8456
8457 # type: textblock
8458 #. type: textblock
8459 #: ../src/guestfs-actions.pod:937
8460 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
8461 msgstr ""
8462
8463 # type: textblock
8464 #. type: textblock
8465 #: ../src/guestfs-actions.pod:939
8466 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
8467 msgstr ""
8468
8469 # type: textblock
8470 #. type: textblock
8471 #: ../src/guestfs-actions.pod:944 ../src/guestfs-actions.pod:1252
8472 #: ../src/guestfs-actions.pod:2086 ../src/guestfs-actions.pod:3306
8473 #: ../src/guestfs-actions.pod:3335 ../src/guestfs-actions.pod:3396
8474 #: ../src/guestfs-actions.pod:3423 ../src/guestfs-actions.pod:6887
8475 msgid "(Added in 1.0.2)"
8476 msgstr ""
8477
8478 # type: =head2
8479 #. type: =head2
8480 #: ../src/guestfs-actions.pod:946
8481 msgid "guestfs_checksum_device"
8482 msgstr ""
8483
8484 # type: verbatim
8485 #. type: verbatim
8486 #: ../src/guestfs-actions.pod:948
8487 #, no-wrap
8488 msgid ""
8489 " char *\n"
8490 " guestfs_checksum_device (guestfs_h *g,\n"
8491 "                          const char *csumtype,\n"
8492 "                          const char *device);\n"
8493 "\n"
8494 msgstr ""
8495
8496 # type: textblock
8497 #. type: textblock
8498 #: ../src/guestfs-actions.pod:953
8499 msgid ""
8500 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
8501 "device named C<device>.  For the types of checksums supported see the "
8502 "C<guestfs_checksum> command."
8503 msgstr ""
8504
8505 # type: textblock
8506 #. type: textblock
8507 #: ../src/guestfs-actions.pod:960 ../src/guestfs-actions.pod:4918
8508 #: ../src/guestfs-actions.pod:4977 ../src/guestfs-actions.pod:5014
8509 #: ../src/guestfs-actions.pod:5032 ../src/guestfs-actions.pod:5208
8510 #: ../src/guestfs-actions.pod:6796 ../src/guestfs-actions.pod:6810
8511 #: ../src/guestfs-actions.pod:7216
8512 msgid "(Added in 1.3.2)"
8513 msgstr ""
8514
8515 # type: =head2
8516 #. type: =head2
8517 #: ../src/guestfs-actions.pod:962
8518 msgid "guestfs_checksums_out"
8519 msgstr ""
8520
8521 # type: verbatim
8522 #. type: verbatim
8523 #: ../src/guestfs-actions.pod:964
8524 #, no-wrap
8525 msgid ""
8526 " int\n"
8527 " guestfs_checksums_out (guestfs_h *g,\n"
8528 "                        const char *csumtype,\n"
8529 "                        const char *directory,\n"
8530 "                        const char *sumsfile);\n"
8531 "\n"
8532 msgstr ""
8533
8534 # type: textblock
8535 #. type: textblock
8536 #: ../src/guestfs-actions.pod:970 ../fish/guestfish-actions.pod:656
8537 msgid ""
8538 "This command computes the checksums of all regular files in C<directory> and "
8539 "then emits a list of those checksums to the local output file C<sumsfile>."
8540 msgstr ""
8541
8542 # type: textblock
8543 #. type: textblock
8544 #: ../src/guestfs-actions.pod:974 ../fish/guestfish-actions.pod:660
8545 msgid ""
8546 "This can be used for verifying the integrity of a virtual machine.  However "
8547 "to be properly secure you should pay attention to the output of the checksum "
8548 "command (it uses the ones from GNU coreutils).  In particular when the "
8549 "filename is not printable, coreutils uses a special backslash syntax.  For "
8550 "more information, see the GNU coreutils info file."
8551 msgstr ""
8552
8553 # type: textblock
8554 #. type: textblock
8555 #: ../src/guestfs-actions.pod:984
8556 msgid "(Added in 1.3.7)"
8557 msgstr ""
8558
8559 # type: =head2
8560 #. type: =head2
8561 #: ../src/guestfs-actions.pod:986
8562 msgid "guestfs_chmod"
8563 msgstr ""
8564
8565 # type: verbatim
8566 #. type: verbatim
8567 #: ../src/guestfs-actions.pod:988
8568 #, no-wrap
8569 msgid ""
8570 " int\n"
8571 " guestfs_chmod (guestfs_h *g,\n"
8572 "                int mode,\n"
8573 "                const char *path);\n"
8574 "\n"
8575 msgstr ""
8576
8577 # type: textblock
8578 #. type: textblock
8579 #: ../src/guestfs-actions.pod:993 ../fish/guestfish-actions.pod:674
8580 msgid ""
8581 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
8582 "supported."
8583 msgstr ""
8584
8585 # type: textblock
8586 #. type: textblock
8587 #: ../src/guestfs-actions.pod:996 ../fish/guestfish-actions.pod:677
8588 msgid ""
8589 "I<Note>: When using this command from guestfish, C<mode> by default would be "
8590 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
8591 "C<700>."
8592 msgstr ""
8593
8594 # type: textblock
8595 #. type: textblock
8596 #: ../src/guestfs-actions.pod:1000 ../src/guestfs-actions.pod:4413
8597 #: ../src/guestfs-actions.pod:4610 ../src/guestfs-actions.pod:4629
8598 #: ../src/guestfs-actions.pod:4648 ../fish/guestfish-actions.pod:681
8599 #: ../fish/guestfish-actions.pod:3000 ../fish/guestfish-actions.pod:3129
8600 #: ../fish/guestfish-actions.pod:3139 ../fish/guestfish-actions.pod:3149
8601 msgid "The mode actually set is affected by the umask."
8602 msgstr ""
8603
8604 # type: =head2
8605 #. type: =head2
8606 #: ../src/guestfs-actions.pod:1006
8607 msgid "guestfs_chown"
8608 msgstr ""
8609
8610 # type: verbatim
8611 #. type: verbatim
8612 #: ../src/guestfs-actions.pod:1008
8613 #, no-wrap
8614 msgid ""
8615 " int\n"
8616 " guestfs_chown (guestfs_h *g,\n"
8617 "                int owner,\n"
8618 "                int group,\n"
8619 "                const char *path);\n"
8620 "\n"
8621 msgstr ""
8622
8623 # type: textblock
8624 #. type: textblock
8625 #: ../src/guestfs-actions.pod:1014 ../fish/guestfish-actions.pod:687
8626 msgid "Change the file owner to C<owner> and group to C<group>."
8627 msgstr ""
8628
8629 # type: textblock
8630 #. type: textblock
8631 #: ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:3521
8632 #: ../fish/guestfish-actions.pod:689 ../fish/guestfish-actions.pod:2458
8633 msgid ""
8634 "Only numeric uid and gid are supported.  If you want to use names, you will "
8635 "need to locate and parse the password file yourself (Augeas support makes "
8636 "this relatively easy)."
8637 msgstr ""
8638
8639 # type: =head2
8640 #. type: =head2
8641 #: ../src/guestfs-actions.pod:1024
8642 msgid "guestfs_command"
8643 msgstr ""
8644
8645 # type: verbatim
8646 #. type: verbatim
8647 #: ../src/guestfs-actions.pod:1026
8648 #, no-wrap
8649 msgid ""
8650 " char *\n"
8651 " guestfs_command (guestfs_h *g,\n"
8652 "                  char *const *arguments);\n"
8653 "\n"
8654 msgstr ""
8655
8656 # type: textblock
8657 #. type: textblock
8658 #: ../src/guestfs-actions.pod:1030 ../fish/guestfish-actions.pod:697
8659 msgid ""
8660 "This call runs a command from the guest filesystem.  The filesystem must be "
8661 "mounted, and must contain a compatible operating system (ie. something "
8662 "Linux, with the same or compatible processor architecture)."
8663 msgstr ""
8664
8665 # type: textblock
8666 #. type: textblock
8667 #: ../src/guestfs-actions.pod:1035
8668 msgid ""
8669 "The single parameter is an argv-style list of arguments.  The first element "
8670 "is the name of the program to run.  Subsequent elements are parameters.  The "
8671 "list must be non-empty (ie. must contain a program name).  Note that the "
8672 "command runs directly, and is I<not> invoked via the shell (see "
8673 "C<guestfs_sh>)."
8674 msgstr ""
8675
8676 # type: textblock
8677 #. type: textblock
8678 #: ../src/guestfs-actions.pod:1042 ../fish/guestfish-actions.pod:709
8679 msgid "The return value is anything printed to I<stdout> by the command."
8680 msgstr ""
8681
8682 # type: textblock
8683 #. type: textblock
8684 #: ../src/guestfs-actions.pod:1045 ../fish/guestfish-actions.pod:712
8685 msgid ""
8686 "If the command returns a non-zero exit status, then this function returns an "
8687 "error message.  The error message string is the content of I<stderr> from "
8688 "the command."
8689 msgstr ""
8690
8691 # type: textblock
8692 #. type: textblock
8693 #: ../src/guestfs-actions.pod:1049 ../fish/guestfish-actions.pod:716
8694 msgid ""
8695 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
8696 "bin>.  If you require a program from another location, you should provide "
8697 "the full path in the first parameter."
8698 msgstr ""
8699
8700 # type: textblock
8701 #. type: textblock
8702 #: ../src/guestfs-actions.pod:1054 ../fish/guestfish-actions.pod:721
8703 msgid ""
8704 "Shared libraries and data files required by the program must be available on "
8705 "filesystems which are mounted in the correct places.  It is the caller's "
8706 "responsibility to ensure all filesystems that are needed are mounted at the "
8707 "right locations."
8708 msgstr ""
8709
8710 # type: textblock
8711 #. type: textblock
8712 #: ../src/guestfs-actions.pod:1066 ../src/guestfs-actions.pod:1086
8713 #: ../src/guestfs-actions.pod:1551
8714 msgid "(Added in 0.9.1)"
8715 msgstr ""
8716
8717 # type: =head2
8718 #. type: =head2
8719 #: ../src/guestfs-actions.pod:1068
8720 msgid "guestfs_command_lines"
8721 msgstr ""
8722
8723 # type: verbatim
8724 #. type: verbatim
8725 #: ../src/guestfs-actions.pod:1070
8726 #, no-wrap
8727 msgid ""
8728 " char **\n"
8729 " guestfs_command_lines (guestfs_h *g,\n"
8730 "                        char *const *arguments);\n"
8731 "\n"
8732 msgstr ""
8733
8734 # type: textblock
8735 #. type: textblock
8736 #: ../src/guestfs-actions.pod:1074
8737 msgid ""
8738 "This is the same as C<guestfs_command>, but splits the result into a list of "
8739 "lines."
8740 msgstr ""
8741
8742 # type: textblock
8743 #. type: textblock
8744 #: ../src/guestfs-actions.pod:1077
8745 msgid "See also: C<guestfs_sh_lines>"
8746 msgstr ""
8747
8748 # type: =head2
8749 #. type: =head2
8750 #: ../src/guestfs-actions.pod:1088
8751 msgid "guestfs_config"
8752 msgstr ""
8753
8754 # type: verbatim
8755 #. type: verbatim
8756 #: ../src/guestfs-actions.pod:1090
8757 #, no-wrap
8758 msgid ""
8759 " int\n"
8760 " guestfs_config (guestfs_h *g,\n"
8761 "                 const char *qemuparam,\n"
8762 "                 const char *qemuvalue);\n"
8763 "\n"
8764 msgstr ""
8765
8766 #. type: textblock
8767 #: ../src/guestfs-actions.pod:1095 ../fish/guestfish-actions.pod:746
8768 msgid ""
8769 "This can be used to add arbitrary qemu command line parameters of the form "
8770 "I<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8771 "setting some parameters which would interfere with parameters that we use."
8772 msgstr ""
8773
8774 # type: textblock
8775 #. type: textblock
8776 #: ../src/guestfs-actions.pod:1100 ../fish/guestfish-actions.pod:751
8777 msgid "The first character of C<param> string must be a C<-> (dash)."
8778 msgstr ""
8779
8780 # type: textblock
8781 #. type: textblock
8782 #: ../src/guestfs-actions.pod:1102 ../fish/guestfish-actions.pod:753
8783 msgid "C<value> can be NULL."
8784 msgstr ""
8785
8786 # type: =head2
8787 #. type: =head2
8788 #: ../src/guestfs-actions.pod:1108
8789 msgid "guestfs_copy_size"
8790 msgstr ""
8791
8792 # type: verbatim
8793 #. type: verbatim
8794 #: ../src/guestfs-actions.pod:1110
8795 #, no-wrap
8796 msgid ""
8797 " int\n"
8798 " guestfs_copy_size (guestfs_h *g,\n"
8799 "                    const char *src,\n"
8800 "                    const char *dest,\n"
8801 "                    int64_t size);\n"
8802 "\n"
8803 msgstr ""
8804
8805 # type: textblock
8806 #. type: textblock
8807 #: ../src/guestfs-actions.pod:1116 ../fish/guestfish-actions.pod:759
8808 msgid ""
8809 "This command copies exactly C<size> bytes from one source device or file "
8810 "C<src> to another destination device or file C<dest>."
8811 msgstr ""
8812
8813 # type: textblock
8814 #. type: textblock
8815 #: ../src/guestfs-actions.pod:1119 ../fish/guestfish-actions.pod:762
8816 msgid ""
8817 "Note this will fail if the source is too short or if the destination is not "
8818 "large enough."
8819 msgstr ""
8820
8821 #. type: textblock
8822 #: ../src/guestfs-actions.pod:1124 ../src/guestfs-actions.pod:1247
8823 #: ../src/guestfs-actions.pod:1278 ../src/guestfs-actions.pod:1323
8824 #: ../src/guestfs-actions.pod:1700 ../src/guestfs-actions.pod:1722
8825 #: ../src/guestfs-actions.pod:3502 ../src/guestfs-actions.pod:6882
8826 #: ../src/guestfs-actions.pod:6916 ../src/guestfs-actions.pod:7403
8827 #: ../src/guestfs-actions.pod:7422
8828 msgid ""
8829 "This long-running command can generate progress notification messages so "
8830 "that the caller can display a progress bar or indicator.  To receive these "
8831 "messages, the caller must register a progress event callback.  See L<guestfs"
8832 "(3)/GUESTFS_EVENT_PROGRESS>."
8833 msgstr ""
8834
8835 # type: textblock
8836 #. type: textblock
8837 #: ../src/guestfs-actions.pod:1129 ../src/guestfs-actions.pod:4189
8838 #: ../src/guestfs-actions.pod:5414 ../src/guestfs-actions.pod:7123
8839 #: ../src/guestfs-actions.pod:7143 ../src/guestfs-actions.pod:7229
8840 msgid "(Added in 1.0.87)"
8841 msgstr ""
8842
8843 # type: =head2
8844 #. type: =head2
8845 #: ../src/guestfs-actions.pod:1131
8846 msgid "guestfs_cp"
8847 msgstr ""
8848
8849 # type: verbatim
8850 #. type: verbatim
8851 #: ../src/guestfs-actions.pod:1133
8852 #, no-wrap
8853 msgid ""
8854 " int\n"
8855 " guestfs_cp (guestfs_h *g,\n"
8856 "             const char *src,\n"
8857 "             const char *dest);\n"
8858 "\n"
8859 msgstr ""
8860
8861 # type: textblock
8862 #. type: textblock
8863 #: ../src/guestfs-actions.pod:1138 ../fish/guestfish-actions.pod:769
8864 msgid ""
8865 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8866 "destination filename or destination directory."
8867 msgstr ""
8868
8869 # type: textblock
8870 #. type: textblock
8871 #: ../src/guestfs-actions.pod:1143 ../src/guestfs-actions.pod:1157
8872 #: ../src/guestfs-actions.pod:1229 ../src/guestfs-actions.pod:1303
8873 #: ../src/guestfs-actions.pod:1417 ../src/guestfs-actions.pod:4881
8874 #: ../src/guestfs-actions.pod:5258
8875 msgid "(Added in 1.0.18)"
8876 msgstr ""
8877
8878 # type: =head2
8879 #. type: =head2
8880 #: ../src/guestfs-actions.pod:1145
8881 msgid "guestfs_cp_a"
8882 msgstr ""
8883
8884 # type: verbatim
8885 #. type: verbatim
8886 #: ../src/guestfs-actions.pod:1147
8887 #, no-wrap
8888 msgid ""
8889 " int\n"
8890 " guestfs_cp_a (guestfs_h *g,\n"
8891 "               const char *src,\n"
8892 "               const char *dest);\n"
8893 "\n"
8894 msgstr ""
8895
8896 # type: textblock
8897 #. type: textblock
8898 #: ../src/guestfs-actions.pod:1152 ../fish/guestfish-actions.pod:776
8899 msgid ""
8900 "This copies a file or directory from C<src> to C<dest> recursively using the "
8901 "C<cp -a> command."
8902 msgstr ""
8903
8904 # type: =head2
8905 #. type: =head2
8906 #: ../src/guestfs-actions.pod:1159
8907 msgid "guestfs_dd"
8908 msgstr ""
8909
8910 # type: verbatim
8911 #. type: verbatim
8912 #: ../src/guestfs-actions.pod:1161
8913 #, no-wrap
8914 msgid ""
8915 " int\n"
8916 " guestfs_dd (guestfs_h *g,\n"
8917 "             const char *src,\n"
8918 "             const char *dest);\n"
8919 "\n"
8920 msgstr ""
8921
8922 # type: textblock
8923 #. type: textblock
8924 #: ../src/guestfs-actions.pod:1166 ../fish/guestfish-actions.pod:783
8925 msgid ""
8926 "This command copies from one source device or file C<src> to another "
8927 "destination device or file C<dest>.  Normally you would use this to copy to "
8928 "or from a device or partition, for example to duplicate a filesystem."
8929 msgstr ""
8930
8931 # type: textblock
8932 #. type: textblock
8933 #: ../src/guestfs-actions.pod:1171
8934 msgid ""
8935 "If the destination is a device, it must be as large or larger than the "
8936 "source file or device, otherwise the copy will fail.  This command cannot do "
8937 "partial copies (see C<guestfs_copy_size>)."
8938 msgstr ""
8939
8940 # type: =head2
8941 #. type: =head2
8942 #: ../src/guestfs-actions.pod:1179
8943 msgid "guestfs_df"
8944 msgstr ""
8945
8946 # type: verbatim
8947 #. type: verbatim
8948 #: ../src/guestfs-actions.pod:1181
8949 #, no-wrap
8950 msgid ""
8951 " char *\n"
8952 " guestfs_df (guestfs_h *g);\n"
8953 "\n"
8954 msgstr ""
8955
8956 # type: textblock
8957 #. type: textblock
8958 #: ../src/guestfs-actions.pod:1184 ../fish/guestfish-actions.pod:796
8959 msgid "This command runs the C<df> command to report disk space used."
8960 msgstr ""
8961
8962 # type: textblock
8963 #. type: textblock
8964 #: ../src/guestfs-actions.pod:1186 ../src/guestfs-actions.pod:1203
8965 msgid ""
8966 "This command is mostly useful for interactive sessions.  It is I<not> "
8967 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8968 "from programs."
8969 msgstr ""
8970
8971 # type: textblock
8972 #. type: textblock
8973 #: ../src/guestfs-actions.pod:1193 ../src/guestfs-actions.pod:1210
8974 #: ../src/guestfs-actions.pod:1328 ../src/guestfs-actions.pod:2289
8975 #: ../src/guestfs-actions.pod:2313 ../src/guestfs-actions.pod:2381
8976 #: ../src/guestfs-actions.pod:4299 ../src/guestfs-actions.pod:4781
8977 #: ../src/guestfs-actions.pod:6620 ../src/guestfs-actions.pod:6644
8978 #: ../src/guestfs-actions.pod:7269 ../src/guestfs-actions.pod:7282
8979 #: ../src/guestfs-actions.pod:7295
8980 msgid "(Added in 1.0.54)"
8981 msgstr ""
8982
8983 # type: =head2
8984 #. type: =head2
8985 #: ../src/guestfs-actions.pod:1195
8986 msgid "guestfs_df_h"
8987 msgstr ""
8988
8989 # type: verbatim
8990 #. type: verbatim
8991 #: ../src/guestfs-actions.pod:1197
8992 #, no-wrap
8993 msgid ""
8994 " char *\n"
8995 " guestfs_df_h (guestfs_h *g);\n"
8996 "\n"
8997 msgstr ""
8998
8999 # type: textblock
9000 #. type: textblock
9001 #: ../src/guestfs-actions.pod:1200 ../fish/guestfish-actions.pod:806
9002 msgid ""
9003 "This command runs the C<df -h> command to report disk space used in human-"
9004 "readable format."
9005 msgstr ""
9006
9007 # type: =head2
9008 #. type: =head2
9009 #: ../src/guestfs-actions.pod:1212
9010 msgid "guestfs_dmesg"
9011 msgstr ""
9012
9013 # type: verbatim
9014 #. type: verbatim
9015 #: ../src/guestfs-actions.pod:1214
9016 #, no-wrap
9017 msgid ""
9018 " char *\n"
9019 " guestfs_dmesg (guestfs_h *g);\n"
9020 "\n"
9021 msgstr ""
9022
9023 # type: textblock
9024 #. type: textblock
9025 #: ../src/guestfs-actions.pod:1217 ../fish/guestfish-actions.pod:817
9026 msgid ""
9027 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
9028 "This is sometimes useful for extended debugging of problems."
9029 msgstr ""
9030
9031 # type: textblock
9032 #. type: textblock
9033 #: ../src/guestfs-actions.pod:1221
9034 msgid ""
9035 "Another way to get the same information is to enable verbose messages with "
9036 "C<guestfs_set_verbose> or by setting the environment variable "
9037 "C<LIBGUESTFS_DEBUG=1> before running the program."
9038 msgstr ""
9039
9040 # type: =head2
9041 #. type: =head2
9042 #: ../src/guestfs-actions.pod:1231
9043 msgid "guestfs_download"
9044 msgstr ""
9045
9046 # type: verbatim
9047 #. type: verbatim
9048 #: ../src/guestfs-actions.pod:1233
9049 #, no-wrap
9050 msgid ""
9051 " int\n"
9052 " guestfs_download (guestfs_h *g,\n"
9053 "                   const char *remotefilename,\n"
9054 "                   const char *filename);\n"
9055 "\n"
9056 msgstr ""
9057
9058 # type: textblock
9059 #. type: textblock
9060 #: ../src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:1263
9061 #: ../fish/guestfish-actions.pod:830 ../fish/guestfish-actions.pod:843
9062 msgid ""
9063 "Download file C<remotefilename> and save it as C<filename> on the local "
9064 "machine."
9065 msgstr ""
9066
9067 # type: textblock
9068 #. type: textblock
9069 #: ../src/guestfs-actions.pod:1241 ../src/guestfs-actions.pod:6876
9070 #: ../fish/guestfish-actions.pod:833 ../fish/guestfish-actions.pod:4642
9071 msgid "C<filename> can also be a named pipe."
9072 msgstr ""
9073
9074 # type: textblock
9075 #. type: textblock
9076 #: ../src/guestfs-actions.pod:1243
9077 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
9078 msgstr ""
9079
9080 # type: =head2
9081 #. type: =head2
9082 #: ../src/guestfs-actions.pod:1254
9083 msgid "guestfs_download_offset"
9084 msgstr ""
9085
9086 # type: verbatim
9087 #. type: verbatim
9088 #: ../src/guestfs-actions.pod:1256
9089 #, no-wrap
9090 msgid ""
9091 " int\n"
9092 " guestfs_download_offset (guestfs_h *g,\n"
9093 "                          const char *remotefilename,\n"
9094 "                          const char *filename,\n"
9095 "                          int64_t offset,\n"
9096 "                          int64_t size);\n"
9097 "\n"
9098 msgstr ""
9099
9100 # type: textblock
9101 #. type: textblock
9102 #: ../src/guestfs-actions.pod:1266 ../fish/guestfish-actions.pod:846
9103 msgid ""
9104 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
9105 "region must be within the file or device)."
9106 msgstr ""
9107
9108 # type: textblock
9109 #. type: textblock
9110 #: ../src/guestfs-actions.pod:1269
9111 msgid ""
9112 "Note that there is no limit on the amount of data that can be downloaded "
9113 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
9114 "full amount unless an error occurs."
9115 msgstr ""
9116
9117 # type: textblock
9118 #. type: textblock
9119 #: ../src/guestfs-actions.pod:1274
9120 msgid "See also C<guestfs_download>, C<guestfs_pread>."
9121 msgstr ""
9122
9123 # type: textblock
9124 #. type: textblock
9125 #: ../src/guestfs-actions.pod:1283 ../src/guestfs-actions.pod:6921
9126 msgid "(Added in 1.5.17)"
9127 msgstr ""
9128
9129 # type: =head2
9130 #. type: =head2
9131 #: ../src/guestfs-actions.pod:1285
9132 msgid "guestfs_drop_caches"
9133 msgstr ""
9134
9135 # type: verbatim
9136 #. type: verbatim
9137 #: ../src/guestfs-actions.pod:1287
9138 #, no-wrap
9139 msgid ""
9140 " int\n"
9141 " guestfs_drop_caches (guestfs_h *g,\n"
9142 "                      int whattodrop);\n"
9143 "\n"
9144 msgstr ""
9145
9146 # type: textblock
9147 #. type: textblock
9148 #: ../src/guestfs-actions.pod:1291 ../fish/guestfish-actions.pod:862
9149 msgid ""
9150 "This instructs the guest kernel to drop its page cache, and/or dentries and "
9151 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
9152 "to drop, see L<http://linux-mm.org/Drop_Caches>"
9153 msgstr ""
9154
9155 # type: textblock
9156 #. type: textblock
9157 #: ../src/guestfs-actions.pod:1296 ../fish/guestfish-actions.pod:867
9158 msgid "Setting C<whattodrop> to 3 should drop everything."
9159 msgstr ""
9160
9161 # type: textblock
9162 #. type: textblock
9163 #: ../src/guestfs-actions.pod:1298 ../fish/guestfish-actions.pod:869
9164 msgid ""
9165 "This automatically calls L<sync(2)> before the operation, so that the "
9166 "maximum guest memory is freed."
9167 msgstr ""
9168
9169 # type: =head2
9170 #. type: =head2
9171 #: ../src/guestfs-actions.pod:1305
9172 msgid "guestfs_du"
9173 msgstr ""
9174
9175 # type: verbatim
9176 #. type: verbatim
9177 #: ../src/guestfs-actions.pod:1307
9178 #, no-wrap
9179 msgid ""
9180 " int64_t\n"
9181 " guestfs_du (guestfs_h *g,\n"
9182 "             const char *path);\n"
9183 "\n"
9184 msgstr ""
9185
9186 # type: textblock
9187 #. type: textblock
9188 #: ../src/guestfs-actions.pod:1311 ../fish/guestfish-actions.pod:876
9189 msgid ""
9190 "This command runs the C<du -s> command to estimate file space usage for "
9191 "C<path>."
9192 msgstr ""
9193
9194 # type: textblock
9195 #. type: textblock
9196 #: ../src/guestfs-actions.pod:1314 ../fish/guestfish-actions.pod:879
9197 msgid ""
9198 "C<path> can be a file or a directory.  If C<path> is a directory then the "
9199 "estimate includes the contents of the directory and all subdirectories "
9200 "(recursively)."
9201 msgstr ""
9202
9203 # type: textblock
9204 #. type: textblock
9205 #: ../src/guestfs-actions.pod:1318 ../fish/guestfish-actions.pod:883
9206 msgid ""
9207 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
9208 msgstr ""
9209
9210 # type: =head2
9211 #. type: =head2
9212 #: ../src/guestfs-actions.pod:1330
9213 msgid "guestfs_e2fsck_f"
9214 msgstr ""
9215
9216 # type: verbatim
9217 #. type: verbatim
9218 #: ../src/guestfs-actions.pod:1332
9219 #, no-wrap
9220 msgid ""
9221 " int\n"
9222 " guestfs_e2fsck_f (guestfs_h *g,\n"
9223 "                   const char *device);\n"
9224 "\n"
9225 msgstr ""
9226
9227 #. type: textblock
9228 #: ../src/guestfs-actions.pod:1336 ../fish/guestfish-actions.pod:890
9229 msgid ""
9230 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
9231 "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
9232 "clean (I<-f>)."
9233 msgstr ""
9234
9235 # type: textblock
9236 #. type: textblock
9237 #: ../src/guestfs-actions.pod:1340
9238 msgid ""
9239 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
9240 "Normally you should use C<guestfs_fsck>."
9241 msgstr ""
9242
9243 # type: textblock
9244 #. type: textblock
9245 #: ../src/guestfs-actions.pod:1345
9246 msgid "(Added in 1.0.29)"
9247 msgstr ""
9248
9249 # type: =head2
9250 #. type: =head2
9251 #: ../src/guestfs-actions.pod:1347
9252 msgid "guestfs_echo_daemon"
9253 msgstr ""
9254
9255 # type: verbatim
9256 #. type: verbatim
9257 #: ../src/guestfs-actions.pod:1349
9258 #, no-wrap
9259 msgid ""
9260 " char *\n"
9261 " guestfs_echo_daemon (guestfs_h *g,\n"
9262 "                      char *const *words);\n"
9263 "\n"
9264 msgstr ""
9265
9266 # type: textblock
9267 #. type: textblock
9268 #: ../src/guestfs-actions.pod:1353 ../fish/guestfish-actions.pod:901
9269 msgid ""
9270 "This command concatenates the list of C<words> passed with single spaces "
9271 "between them and returns the resulting string."
9272 msgstr ""
9273
9274 # type: textblock
9275 #. type: textblock
9276 #: ../src/guestfs-actions.pod:1356 ../fish/guestfish-actions.pod:904
9277 msgid "You can use this command to test the connection through to the daemon."
9278 msgstr ""
9279
9280 # type: textblock
9281 #. type: textblock
9282 #: ../src/guestfs-actions.pod:1358
9283 msgid "See also C<guestfs_ping_daemon>."
9284 msgstr ""
9285
9286 # type: textblock
9287 #. type: textblock
9288 #: ../src/guestfs-actions.pod:1363 ../src/guestfs-actions.pod:2097
9289 #: ../src/guestfs-actions.pod:6092
9290 msgid "(Added in 1.0.69)"
9291 msgstr ""
9292
9293 # type: =head2
9294 #. type: =head2
9295 #: ../src/guestfs-actions.pod:1365
9296 msgid "guestfs_egrep"
9297 msgstr ""
9298
9299 # type: verbatim
9300 #. type: verbatim
9301 #: ../src/guestfs-actions.pod:1367
9302 #, no-wrap
9303 msgid ""
9304 " char **\n"
9305 " guestfs_egrep (guestfs_h *g,\n"
9306 "                const char *regex,\n"
9307 "                const char *path);\n"
9308 "\n"
9309 msgstr ""
9310
9311 # type: textblock
9312 #. type: textblock
9313 #: ../src/guestfs-actions.pod:1372 ../fish/guestfish-actions.pod:912
9314 msgid ""
9315 "This calls the external C<egrep> program and returns the matching lines."
9316 msgstr ""
9317
9318 # type: textblock
9319 #. type: textblock
9320 #: ../src/guestfs-actions.pod:1382 ../src/guestfs-actions.pod:1401
9321 #: ../src/guestfs-actions.pod:1458 ../src/guestfs-actions.pod:1504
9322 #: ../src/guestfs-actions.pod:1523 ../src/guestfs-actions.pod:2227
9323 #: ../src/guestfs-actions.pod:2246 ../src/guestfs-actions.pod:2402
9324 #: ../src/guestfs-actions.pod:2415 ../src/guestfs-actions.pod:2430
9325 #: ../src/guestfs-actions.pod:2476 ../src/guestfs-actions.pod:2498
9326 #: ../src/guestfs-actions.pod:2511 ../src/guestfs-actions.pod:3682
9327 #: ../src/guestfs-actions.pod:3696 ../src/guestfs-actions.pod:3709
9328 #: ../src/guestfs-actions.pod:3723 ../src/guestfs-actions.pod:4709
9329 #: ../src/guestfs-actions.pod:5592 ../src/guestfs-actions.pod:5641
9330 #: ../src/guestfs-actions.pod:6488 ../src/guestfs-actions.pod:6500
9331 #: ../src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:6526
9332 #: ../src/guestfs-actions.pod:6548 ../src/guestfs-actions.pod:6561
9333 #: ../src/guestfs-actions.pod:6574 ../src/guestfs-actions.pod:6587
9334 #: ../src/guestfs-actions.pod:7365 ../src/guestfs-actions.pod:7384
9335 #: ../src/guestfs-actions.pod:7470 ../src/guestfs-actions.pod:7489
9336 #: ../src/guestfs-actions.pod:7535 ../src/guestfs-actions.pod:7554
9337 msgid "(Added in 1.0.66)"
9338 msgstr ""
9339
9340 # type: =head2
9341 #. type: =head2
9342 #: ../src/guestfs-actions.pod:1384
9343 msgid "guestfs_egrepi"
9344 msgstr ""
9345
9346 # type: verbatim
9347 #. type: verbatim
9348 #: ../src/guestfs-actions.pod:1386
9349 #, no-wrap
9350 msgid ""
9351 " char **\n"
9352 " guestfs_egrepi (guestfs_h *g,\n"
9353 "                 const char *regex,\n"
9354 "                 const char *path);\n"
9355 "\n"
9356 msgstr ""
9357
9358 # type: textblock
9359 #. type: textblock
9360 #: ../src/guestfs-actions.pod:1391 ../fish/guestfish-actions.pod:922
9361 msgid ""
9362 "This calls the external C<egrep -i> program and returns the matching lines."
9363 msgstr ""
9364
9365 # type: =head2
9366 #. type: =head2
9367 #: ../src/guestfs-actions.pod:1403
9368 msgid "guestfs_equal"
9369 msgstr ""
9370
9371 # type: verbatim
9372 #. type: verbatim
9373 #: ../src/guestfs-actions.pod:1405
9374 #, no-wrap
9375 msgid ""
9376 " int\n"
9377 " guestfs_equal (guestfs_h *g,\n"
9378 "                const char *file1,\n"
9379 "                const char *file2);\n"
9380 "\n"
9381 msgstr ""
9382
9383 # type: textblock
9384 #. type: textblock
9385 #: ../src/guestfs-actions.pod:1410 ../fish/guestfish-actions.pod:932
9386 msgid ""
9387 "This compares the two files C<file1> and C<file2> and returns true if their "
9388 "content is exactly equal, or false otherwise."
9389 msgstr ""
9390
9391 # type: textblock
9392 #. type: textblock
9393 #: ../src/guestfs-actions.pod:1413 ../fish/guestfish-actions.pod:935
9394 msgid "The external L<cmp(1)> program is used for the comparison."
9395 msgstr ""
9396
9397 # type: =head2
9398 #. type: =head2
9399 #: ../src/guestfs-actions.pod:1419
9400 msgid "guestfs_exists"
9401 msgstr ""
9402
9403 # type: verbatim
9404 #. type: verbatim
9405 #: ../src/guestfs-actions.pod:1421
9406 #, no-wrap
9407 msgid ""
9408 " int\n"
9409 " guestfs_exists (guestfs_h *g,\n"
9410 "                 const char *path);\n"
9411 "\n"
9412 msgstr ""
9413
9414 # type: textblock
9415 #. type: textblock
9416 #: ../src/guestfs-actions.pod:1425 ../fish/guestfish-actions.pod:941
9417 msgid ""
9418 "This returns C<true> if and only if there is a file, directory (or anything) "
9419 "with the given C<path> name."
9420 msgstr ""
9421
9422 # type: textblock
9423 #. type: textblock
9424 #: ../src/guestfs-actions.pod:1428
9425 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
9426 msgstr ""
9427
9428 # type: =head2
9429 #. type: =head2
9430 #: ../src/guestfs-actions.pod:1434
9431 msgid "guestfs_fallocate"
9432 msgstr ""
9433
9434 # type: verbatim
9435 #. type: verbatim
9436 #: ../src/guestfs-actions.pod:1436
9437 #, no-wrap
9438 msgid ""
9439 " int\n"
9440 " guestfs_fallocate (guestfs_h *g,\n"
9441 "                    const char *path,\n"
9442 "                    int len);\n"
9443 "\n"
9444 msgstr ""
9445
9446 # type: textblock
9447 #. type: textblock
9448 #: ../src/guestfs-actions.pod:1441 ../src/guestfs-actions.pod:1467
9449 #: ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:969
9450 msgid ""
9451 "This command preallocates a file (containing zero bytes) named C<path> of "
9452 "size C<len> bytes.  If the file exists already, it is overwritten."
9453 msgstr ""
9454
9455 # type: textblock
9456 #. type: textblock
9457 #: ../src/guestfs-actions.pod:1445 ../fish/guestfish-actions.pod:954
9458 msgid ""
9459 "Do not confuse this with the guestfish-specific C<alloc> command which "
9460 "allocates a file in the host and attaches it as a device."
9461 msgstr ""
9462
9463 # type: textblock
9464 #. type: textblock
9465 #: ../src/guestfs-actions.pod:1451 ../fish/guestfish-actions.pod:958
9466 msgid ""
9467 "This function is deprecated.  In new code, use the C<fallocate64> call "
9468 "instead."
9469 msgstr ""
9470
9471 # type: =head2
9472 #. type: =head2
9473 #: ../src/guestfs-actions.pod:1460
9474 msgid "guestfs_fallocate64"
9475 msgstr ""
9476
9477 # type: verbatim
9478 #. type: verbatim
9479 #: ../src/guestfs-actions.pod:1462
9480 #, no-wrap
9481 msgid ""
9482 " int\n"
9483 " guestfs_fallocate64 (guestfs_h *g,\n"
9484 "                      const char *path,\n"
9485 "                      int64_t len);\n"
9486 "\n"
9487 msgstr ""
9488
9489 # type: textblock
9490 #. type: textblock
9491 #: ../src/guestfs-actions.pod:1471
9492 msgid ""
9493 "Note that this call allocates disk blocks for the file.  To create a sparse "
9494 "file use C<guestfs_truncate_size> instead."
9495 msgstr ""
9496
9497 # type: textblock
9498 #. type: textblock
9499 #: ../src/guestfs-actions.pod:1474
9500 msgid ""
9501 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
9502 "oversight it only allowed 30 bit lengths to be specified, effectively "
9503 "limiting the maximum size of files created through that call to 1GB."
9504 msgstr ""
9505
9506 # type: textblock
9507 #. type: textblock
9508 #: ../src/guestfs-actions.pod:1479 ../fish/guestfish-actions.pod:981
9509 msgid ""
9510 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
9511 "commands which create a file in the host and attach it as a device."
9512 msgstr ""
9513
9514 # type: textblock
9515 #. type: textblock
9516 #: ../src/guestfs-actions.pod:1485
9517 msgid "(Added in 1.3.17)"
9518 msgstr ""
9519
9520 # type: =head2
9521 #. type: =head2
9522 #: ../src/guestfs-actions.pod:1487
9523 msgid "guestfs_fgrep"
9524 msgstr ""
9525
9526 # type: verbatim
9527 #. type: verbatim
9528 #: ../src/guestfs-actions.pod:1489
9529 #, no-wrap
9530 msgid ""
9531 " char **\n"
9532 " guestfs_fgrep (guestfs_h *g,\n"
9533 "                const char *pattern,\n"
9534 "                const char *path);\n"
9535 "\n"
9536 msgstr ""
9537
9538 # type: textblock
9539 #. type: textblock
9540 #: ../src/guestfs-actions.pod:1494 ../fish/guestfish-actions.pod:989
9541 msgid ""
9542 "This calls the external C<fgrep> program and returns the matching lines."
9543 msgstr ""
9544
9545 # type: =head2
9546 #. type: =head2
9547 #: ../src/guestfs-actions.pod:1506
9548 msgid "guestfs_fgrepi"
9549 msgstr ""
9550
9551 # type: verbatim
9552 #. type: verbatim
9553 #: ../src/guestfs-actions.pod:1508
9554 #, no-wrap
9555 msgid ""
9556 " char **\n"
9557 " guestfs_fgrepi (guestfs_h *g,\n"
9558 "                 const char *pattern,\n"
9559 "                 const char *path);\n"
9560 "\n"
9561 msgstr ""
9562
9563 # type: textblock
9564 #. type: textblock
9565 #: ../src/guestfs-actions.pod:1513 ../fish/guestfish-actions.pod:999
9566 msgid ""
9567 "This calls the external C<fgrep -i> program and returns the matching lines."
9568 msgstr ""
9569
9570 # type: =head2
9571 #. type: =head2
9572 #: ../src/guestfs-actions.pod:1525
9573 msgid "guestfs_file"
9574 msgstr ""
9575
9576 # type: verbatim
9577 #. type: verbatim
9578 #: ../src/guestfs-actions.pod:1527
9579 #, no-wrap
9580 msgid ""
9581 " char *\n"
9582 " guestfs_file (guestfs_h *g,\n"
9583 "               const char *path);\n"
9584 "\n"
9585 msgstr ""
9586
9587 # type: textblock
9588 #. type: textblock
9589 #: ../src/guestfs-actions.pod:1531 ../fish/guestfish-actions.pod:1009
9590 msgid ""
9591 "This call uses the standard L<file(1)> command to determine the type or "
9592 "contents of the file."
9593 msgstr ""
9594
9595 # type: textblock
9596 #. type: textblock
9597 #: ../src/guestfs-actions.pod:1534 ../fish/guestfish-actions.pod:1012
9598 msgid ""
9599 "This call will also transparently look inside various types of compressed "
9600 "file."
9601 msgstr ""
9602
9603 #. type: textblock
9604 #: ../src/guestfs-actions.pod:1537 ../fish/guestfish-actions.pod:1015
9605 msgid ""
9606 "The exact command which runs is C<file -zb path>.  Note in particular that "
9607 "the filename is not prepended to the output (the I<-b> option)."
9608 msgstr ""
9609
9610 #. type: textblock
9611 #: ../src/guestfs-actions.pod:1541 ../fish/guestfish-actions.pod:1019
9612 msgid ""
9613 "The output depends on the output of the underlying L<file(1)> command and it "
9614 "can change in future in ways beyond our control.  In other words, the output "
9615 "is not guaranteed by the ABI."
9616 msgstr ""
9617
9618 #. type: textblock
9619 #: ../src/guestfs-actions.pod:1545
9620 msgid ""
9621 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
9622 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc), C<guestfs_is_zero>."
9623 msgstr ""
9624
9625 # type: =head2
9626 #. type: =head2
9627 #: ../src/guestfs-actions.pod:1553
9628 msgid "guestfs_file_architecture"
9629 msgstr ""
9630
9631 # type: verbatim
9632 #. type: verbatim
9633 #: ../src/guestfs-actions.pod:1555
9634 #, no-wrap
9635 msgid ""
9636 " char *\n"
9637 " guestfs_file_architecture (guestfs_h *g,\n"
9638 "                            const char *filename);\n"
9639 "\n"
9640 msgstr ""
9641
9642 # type: textblock
9643 #. type: textblock
9644 #: ../src/guestfs-actions.pod:1559 ../fish/guestfish-actions.pod:1030
9645 msgid ""
9646 "This detects the architecture of the binary C<filename>, and returns it if "
9647 "known."
9648 msgstr ""
9649
9650 # type: textblock
9651 #. type: textblock
9652 #: ../src/guestfs-actions.pod:1562 ../fish/guestfish-actions.pod:1033
9653 msgid "Currently defined architectures are:"
9654 msgstr ""
9655
9656 # type: =item
9657 #. type: =item
9658 #: ../src/guestfs-actions.pod:1566 ../fish/guestfish-actions.pod:1037
9659 msgid "\"i386\""
9660 msgstr ""
9661
9662 # type: textblock
9663 #. type: textblock
9664 #: ../src/guestfs-actions.pod:1568 ../fish/guestfish-actions.pod:1039
9665 msgid ""
9666 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9667 "irrespective of the precise processor requirements of the binary."
9668 msgstr ""
9669
9670 # type: =item
9671 #. type: =item
9672 #: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1042
9673 msgid "\"x86_64\""
9674 msgstr ""
9675
9676 # type: textblock
9677 #. type: textblock
9678 #: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1044
9679 msgid "64 bit x86-64."
9680 msgstr ""
9681
9682 # type: =item
9683 #. type: =item
9684 #: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1046
9685 msgid "\"sparc\""
9686 msgstr ""
9687
9688 # type: textblock
9689 #. type: textblock
9690 #: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1048
9691 msgid "32 bit SPARC."
9692 msgstr ""
9693
9694 # type: =item
9695 #. type: =item
9696 #: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1050
9697 msgid "\"sparc64\""
9698 msgstr ""
9699
9700 # type: textblock
9701 #. type: textblock
9702 #: ../src/guestfs-actions.pod:1581 ../fish/guestfish-actions.pod:1052
9703 msgid "64 bit SPARC V9 and above."
9704 msgstr ""
9705
9706 # type: =item
9707 #. type: =item
9708 #: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1054
9709 msgid "\"ia64\""
9710 msgstr ""
9711
9712 # type: textblock
9713 #. type: textblock
9714 #: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1056
9715 msgid "Intel Itanium."
9716 msgstr ""
9717
9718 # type: =item
9719 #. type: =item
9720 #: ../src/guestfs-actions.pod:1587 ../fish/guestfish-actions.pod:1058
9721 msgid "\"ppc\""
9722 msgstr ""
9723
9724 # type: textblock
9725 #. type: textblock
9726 #: ../src/guestfs-actions.pod:1589 ../fish/guestfish-actions.pod:1060
9727 msgid "32 bit Power PC."
9728 msgstr ""
9729
9730 # type: =item
9731 #. type: =item
9732 #: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1062
9733 msgid "\"ppc64\""
9734 msgstr ""
9735
9736 # type: textblock
9737 #. type: textblock
9738 #: ../src/guestfs-actions.pod:1593 ../fish/guestfish-actions.pod:1064
9739 msgid "64 bit Power PC."
9740 msgstr ""
9741
9742 # type: textblock
9743 #. type: textblock
9744 #: ../src/guestfs-actions.pod:1597 ../fish/guestfish-actions.pod:1068
9745 msgid "Libguestfs may return other architecture strings in future."
9746 msgstr ""
9747
9748 # type: textblock
9749 #. type: textblock
9750 #: ../src/guestfs-actions.pod:1599 ../fish/guestfish-actions.pod:1070
9751 msgid "The function works on at least the following types of files:"
9752 msgstr ""
9753
9754 # type: textblock
9755 #. type: textblock
9756 #: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1076
9757 msgid "many types of Un*x and Linux binary"
9758 msgstr ""
9759
9760 # type: textblock
9761 #. type: textblock
9762 #: ../src/guestfs-actions.pod:1609 ../fish/guestfish-actions.pod:1080
9763 msgid "many types of Un*x and Linux shared library"
9764 msgstr ""
9765
9766 # type: textblock
9767 #. type: textblock
9768 #: ../src/guestfs-actions.pod:1613 ../fish/guestfish-actions.pod:1084
9769 msgid "Windows Win32 and Win64 binaries"
9770 msgstr ""
9771
9772 # type: textblock
9773 #. type: textblock
9774 #: ../src/guestfs-actions.pod:1617 ../fish/guestfish-actions.pod:1088
9775 msgid "Windows Win32 and Win64 DLLs"
9776 msgstr ""
9777
9778 # type: textblock
9779 #. type: textblock
9780 #: ../src/guestfs-actions.pod:1619 ../fish/guestfish-actions.pod:1090
9781 msgid "Win32 binaries and DLLs return C<i386>."
9782 msgstr ""
9783
9784 # type: textblock
9785 #. type: textblock
9786 #: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1092
9787 msgid "Win64 binaries and DLLs return C<x86_64>."
9788 msgstr ""
9789
9790 # type: textblock
9791 #. type: textblock
9792 #: ../src/guestfs-actions.pod:1625 ../fish/guestfish-actions.pod:1096
9793 msgid "Linux kernel modules"
9794 msgstr ""
9795
9796 # type: textblock
9797 #. type: textblock
9798 #: ../src/guestfs-actions.pod:1629 ../fish/guestfish-actions.pod:1100
9799 msgid "Linux new-style initrd images"
9800 msgstr ""
9801
9802 # type: textblock
9803 #. type: textblock
9804 #: ../src/guestfs-actions.pod:1633 ../fish/guestfish-actions.pod:1104
9805 msgid "some non-x86 Linux vmlinuz kernels"
9806 msgstr ""
9807
9808 # type: textblock
9809 #. type: textblock
9810 #: ../src/guestfs-actions.pod:1637 ../fish/guestfish-actions.pod:1108
9811 msgid "What it can't do currently:"
9812 msgstr ""
9813
9814 # type: textblock
9815 #. type: textblock
9816 #: ../src/guestfs-actions.pod:1643 ../fish/guestfish-actions.pod:1114
9817 msgid "static libraries (libfoo.a)"
9818 msgstr ""
9819
9820 # type: textblock
9821 #. type: textblock
9822 #: ../src/guestfs-actions.pod:1647 ../fish/guestfish-actions.pod:1118
9823 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9824 msgstr ""
9825
9826 # type: textblock
9827 #. type: textblock
9828 #: ../src/guestfs-actions.pod:1651 ../fish/guestfish-actions.pod:1122
9829 msgid "x86 Linux vmlinuz kernels"
9830 msgstr ""
9831
9832 # type: textblock
9833 #. type: textblock
9834 #: ../src/guestfs-actions.pod:1653 ../fish/guestfish-actions.pod:1124
9835 msgid ""
9836 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9837 "compressed code, and are horribly hard to unpack.  If you want to find the "
9838 "architecture of a kernel, use the architecture of the associated initrd or "
9839 "kernel module(s) instead."
9840 msgstr ""
9841
9842 # type: textblock
9843 #. type: textblock
9844 #: ../src/guestfs-actions.pod:1663 ../src/guestfs-actions.pod:1826
9845 #: ../src/guestfs-actions.pod:1843 ../src/guestfs-actions.pod:2534
9846 #: ../src/guestfs-actions.pod:2627 ../src/guestfs-actions.pod:2697
9847 #: ../src/guestfs-actions.pod:2785 ../src/guestfs-actions.pod:2806
9848 #: ../src/guestfs-actions.pod:2849 ../src/guestfs-actions.pod:2933
9849 #: ../src/guestfs-actions.pod:3030 ../src/guestfs-actions.pod:3277
9850 #: ../src/guestfs-actions.pod:3409
9851 msgid "(Added in 1.5.3)"
9852 msgstr ""
9853
9854 # type: =head2
9855 #. type: =head2
9856 #: ../src/guestfs-actions.pod:1665
9857 msgid "guestfs_filesize"
9858 msgstr ""
9859
9860 # type: verbatim
9861 #. type: verbatim
9862 #: ../src/guestfs-actions.pod:1667
9863 #, no-wrap
9864 msgid ""
9865 " int64_t\n"
9866 " guestfs_filesize (guestfs_h *g,\n"
9867 "                   const char *file);\n"
9868 "\n"
9869 msgstr ""
9870
9871 # type: textblock
9872 #. type: textblock
9873 #: ../src/guestfs-actions.pod:1671 ../fish/guestfish-actions.pod:1135
9874 msgid "This command returns the size of C<file> in bytes."
9875 msgstr ""
9876
9877 # type: textblock
9878 #. type: textblock
9879 #: ../src/guestfs-actions.pod:1673
9880 msgid ""
9881 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9882 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9883 "devices, use C<guestfs_blockdev_getsize64>."
9884 msgstr ""
9885
9886 # type: textblock
9887 #. type: textblock
9888 #: ../src/guestfs-actions.pod:1679
9889 msgid "(Added in 1.0.82)"
9890 msgstr ""
9891
9892 # type: =head2
9893 #. type: =head2
9894 #: ../src/guestfs-actions.pod:1681
9895 msgid "guestfs_fill"
9896 msgstr ""
9897
9898 # type: verbatim
9899 #. type: verbatim
9900 #: ../src/guestfs-actions.pod:1683
9901 #, no-wrap
9902 msgid ""
9903 " int\n"
9904 " guestfs_fill (guestfs_h *g,\n"
9905 "               int c,\n"
9906 "               int len,\n"
9907 "               const char *path);\n"
9908 "\n"
9909 msgstr ""
9910
9911 # type: textblock
9912 #. type: textblock
9913 #: ../src/guestfs-actions.pod:1689 ../fish/guestfish-actions.pod:1145
9914 msgid ""
9915 "This command creates a new file called C<path>.  The initial content of the "
9916 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9917 "[0..255]>."
9918 msgstr ""
9919
9920 # type: textblock
9921 #. type: textblock
9922 #: ../src/guestfs-actions.pod:1693
9923 msgid ""
9924 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9925 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9926 "bytes use C<guestfs_fill_pattern>."
9927 msgstr ""
9928
9929 # type: textblock
9930 #. type: textblock
9931 #: ../src/guestfs-actions.pod:1705
9932 msgid "(Added in 1.0.79)"
9933 msgstr ""
9934
9935 # type: =head2
9936 #. type: =head2
9937 #: ../src/guestfs-actions.pod:1707
9938 msgid "guestfs_fill_pattern"
9939 msgstr ""
9940
9941 # type: verbatim
9942 #. type: verbatim
9943 #: ../src/guestfs-actions.pod:1709
9944 #, no-wrap
9945 msgid ""
9946 " int\n"
9947 " guestfs_fill_pattern (guestfs_h *g,\n"
9948 "                       const char *pattern,\n"
9949 "                       int len,\n"
9950 "                       const char *path);\n"
9951 "\n"
9952 msgstr ""
9953
9954 # type: textblock
9955 #. type: textblock
9956 #: ../src/guestfs-actions.pod:1715
9957 msgid ""
9958 "This function is like C<guestfs_fill> except that it creates a new file of "
9959 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9960 "pattern is truncated if necessary to ensure the length of the file is "
9961 "exactly C<len> bytes."
9962 msgstr ""
9963
9964 # type: textblock
9965 #. type: textblock
9966 #: ../src/guestfs-actions.pod:1727
9967 msgid "(Added in 1.3.12)"
9968 msgstr ""
9969
9970 # type: =head2
9971 #. type: =head2
9972 #: ../src/guestfs-actions.pod:1729
9973 msgid "guestfs_find"
9974 msgstr ""
9975
9976 # type: verbatim
9977 #. type: verbatim
9978 #: ../src/guestfs-actions.pod:1731
9979 #, no-wrap
9980 msgid ""
9981 " char **\n"
9982 " guestfs_find (guestfs_h *g,\n"
9983 "               const char *directory);\n"
9984 "\n"
9985 msgstr ""
9986
9987 # type: textblock
9988 #. type: textblock
9989 #: ../src/guestfs-actions.pod:1735 ../fish/guestfish-actions.pod:1167
9990 msgid ""
9991 "This command lists out all files and directories, recursively, starting at "
9992 "C<directory>.  It is essentially equivalent to running the shell command "
9993 "C<find directory -print> but some post-processing happens on the output, "
9994 "described below."
9995 msgstr ""
9996
9997 # type: textblock
9998 #. type: textblock
9999 #: ../src/guestfs-actions.pod:1740 ../fish/guestfish-actions.pod:1172
10000 msgid ""
10001 "This returns a list of strings I<without any prefix>.  Thus if the directory "
10002 "structure was:"
10003 msgstr ""
10004
10005 # type: verbatim
10006 #. type: verbatim
10007 #: ../src/guestfs-actions.pod:1743 ../fish/guestfish-actions.pod:1175
10008 #, no-wrap
10009 msgid ""
10010 " /tmp/a\n"
10011 " /tmp/b\n"
10012 " /tmp/c/d\n"
10013 "\n"
10014 msgstr ""
10015
10016 # type: textblock
10017 #. type: textblock
10018 #: ../src/guestfs-actions.pod:1747
10019 msgid ""
10020 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
10021 msgstr ""
10022
10023 # type: verbatim
10024 #. type: verbatim
10025 #: ../src/guestfs-actions.pod:1750 ../fish/guestfish-actions.pod:1182
10026 #, no-wrap
10027 msgid ""
10028 " a\n"
10029 " b\n"
10030 " c\n"
10031 " c/d\n"
10032 "\n"
10033 msgstr ""
10034
10035 # type: textblock
10036 #. type: textblock
10037 #: ../src/guestfs-actions.pod:1755 ../fish/guestfish-actions.pod:1187
10038 msgid "If C<directory> is not a directory, then this command returns an error."
10039 msgstr ""
10040
10041 # type: textblock
10042 #. type: textblock
10043 #: ../src/guestfs-actions.pod:1758 ../fish/guestfish-actions.pod:1190
10044 msgid "The returned list is sorted."
10045 msgstr ""
10046
10047 # type: textblock
10048 #. type: textblock
10049 #: ../src/guestfs-actions.pod:1760
10050 msgid "See also C<guestfs_find0>."
10051 msgstr ""
10052
10053 # type: textblock
10054 #. type: textblock
10055 #: ../src/guestfs-actions.pod:1769 ../src/guestfs-actions.pod:4126
10056 #: ../src/guestfs-actions.pod:5676
10057 msgid "(Added in 1.0.27)"
10058 msgstr ""
10059
10060 # type: =head2
10061 #. type: =head2
10062 #: ../src/guestfs-actions.pod:1771
10063 msgid "guestfs_find0"
10064 msgstr ""
10065
10066 # type: verbatim
10067 #. type: verbatim
10068 #: ../src/guestfs-actions.pod:1773
10069 #, no-wrap
10070 msgid ""
10071 " int\n"
10072 " guestfs_find0 (guestfs_h *g,\n"
10073 "                const char *directory,\n"
10074 "                const char *files);\n"
10075 "\n"
10076 msgstr ""
10077
10078 # type: textblock
10079 #. type: textblock
10080 #: ../src/guestfs-actions.pod:1778 ../fish/guestfish-actions.pod:1201
10081 msgid ""
10082 "This command lists out all files and directories, recursively, starting at "
10083 "C<directory>, placing the resulting list in the external file called "
10084 "C<files>."
10085 msgstr ""
10086
10087 # type: textblock
10088 #. type: textblock
10089 #: ../src/guestfs-actions.pod:1782
10090 msgid ""
10091 "This command works the same way as C<guestfs_find> with the following "
10092 "exceptions:"
10093 msgstr ""
10094
10095 # type: textblock
10096 #. type: textblock
10097 #: ../src/guestfs-actions.pod:1789 ../fish/guestfish-actions.pod:1212
10098 msgid "The resulting list is written to an external file."
10099 msgstr ""
10100
10101 # type: textblock
10102 #. type: textblock
10103 #: ../src/guestfs-actions.pod:1793 ../fish/guestfish-actions.pod:1216
10104 msgid ""
10105 "Items (filenames) in the result are separated by C<\\0> characters.  See "
10106 "L<find(1)> option I<-print0>."
10107 msgstr ""
10108
10109 # type: textblock
10110 #. type: textblock
10111 #: ../src/guestfs-actions.pod:1798 ../fish/guestfish-actions.pod:1221
10112 msgid "This command is not limited in the number of names that it can return."
10113 msgstr ""
10114
10115 # type: textblock
10116 #. type: textblock
10117 #: ../src/guestfs-actions.pod:1803 ../fish/guestfish-actions.pod:1226
10118 msgid "The result list is not sorted."
10119 msgstr ""
10120
10121 # type: textblock
10122 #. type: textblock
10123 #: ../src/guestfs-actions.pod:1809
10124 msgid "(Added in 1.0.74)"
10125 msgstr ""
10126
10127 # type: =head2
10128 #. type: =head2
10129 #: ../src/guestfs-actions.pod:1811
10130 msgid "guestfs_findfs_label"
10131 msgstr ""
10132
10133 # type: verbatim
10134 #. type: verbatim
10135 #: ../src/guestfs-actions.pod:1813
10136 #, no-wrap
10137 msgid ""
10138 " char *\n"
10139 " guestfs_findfs_label (guestfs_h *g,\n"
10140 "                       const char *label);\n"
10141 "\n"
10142 msgstr ""
10143
10144 # type: textblock
10145 #. type: textblock
10146 #: ../src/guestfs-actions.pod:1817 ../fish/guestfish-actions.pod:1236
10147 msgid ""
10148 "This command searches the filesystems and returns the one which has the "
10149 "given label.  An error is returned if no such filesystem can be found."
10150 msgstr ""
10151
10152 # type: textblock
10153 #. type: textblock
10154 #: ../src/guestfs-actions.pod:1821
10155 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
10156 msgstr ""
10157
10158 # type: =head2
10159 #. type: =head2
10160 #: ../src/guestfs-actions.pod:1828
10161 msgid "guestfs_findfs_uuid"
10162 msgstr ""
10163
10164 # type: verbatim
10165 #. type: verbatim
10166 #: ../src/guestfs-actions.pod:1830
10167 #, no-wrap
10168 msgid ""
10169 " char *\n"
10170 " guestfs_findfs_uuid (guestfs_h *g,\n"
10171 "                      const char *uuid);\n"
10172 "\n"
10173 msgstr ""
10174
10175 # type: textblock
10176 #. type: textblock
10177 #: ../src/guestfs-actions.pod:1834 ../fish/guestfish-actions.pod:1246
10178 msgid ""
10179 "This command searches the filesystems and returns the one which has the "
10180 "given UUID.  An error is returned if no such filesystem can be found."
10181 msgstr ""
10182
10183 # type: textblock
10184 #. type: textblock
10185 #: ../src/guestfs-actions.pod:1838
10186 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
10187 msgstr ""
10188
10189 # type: =head2
10190 #. type: =head2
10191 #: ../src/guestfs-actions.pod:1845
10192 msgid "guestfs_fsck"
10193 msgstr ""
10194
10195 # type: verbatim
10196 #. type: verbatim
10197 #: ../src/guestfs-actions.pod:1847
10198 #, no-wrap
10199 msgid ""
10200 " int\n"
10201 " guestfs_fsck (guestfs_h *g,\n"
10202 "               const char *fstype,\n"
10203 "               const char *device);\n"
10204 "\n"
10205 msgstr ""
10206
10207 # type: textblock
10208 #. type: textblock
10209 #: ../src/guestfs-actions.pod:1852 ../fish/guestfish-actions.pod:1256
10210 msgid ""
10211 "This runs the filesystem checker (fsck) on C<device> which should have "
10212 "filesystem type C<fstype>."
10213 msgstr ""
10214
10215 # type: textblock
10216 #. type: textblock
10217 #: ../src/guestfs-actions.pod:1855 ../fish/guestfish-actions.pod:1259
10218 msgid ""
10219 "The returned integer is the status.  See L<fsck(8)> for the list of status "
10220 "codes from C<fsck>."
10221 msgstr ""
10222
10223 # type: textblock
10224 #. type: textblock
10225 #: ../src/guestfs-actions.pod:1864 ../fish/guestfish-actions.pod:1268
10226 msgid "Multiple status codes can be summed together."
10227 msgstr ""
10228
10229 # type: textblock
10230 #. type: textblock
10231 #: ../src/guestfs-actions.pod:1868 ../fish/guestfish-actions.pod:1272
10232 msgid ""
10233 "A non-zero return code can mean \"success\", for example if errors have been "
10234 "corrected on the filesystem."
10235 msgstr ""
10236
10237 # type: textblock
10238 #. type: textblock
10239 #: ../src/guestfs-actions.pod:1873 ../fish/guestfish-actions.pod:1277
10240 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
10241 msgstr ""
10242
10243 # type: textblock
10244 #. type: textblock
10245 #: ../src/guestfs-actions.pod:1878 ../fish/guestfish-actions.pod:1282
10246 msgid ""
10247 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
10248 msgstr ""
10249
10250 # type: textblock
10251 #. type: textblock
10252 #: ../src/guestfs-actions.pod:1882 ../src/guestfs-actions.pod:7408
10253 msgid "(Added in 1.0.16)"
10254 msgstr ""
10255
10256 # type: =head2
10257 #. type: =head2
10258 #: ../src/guestfs-actions.pod:1884
10259 msgid "guestfs_get_append"
10260 msgstr ""
10261
10262 # type: verbatim
10263 #. type: verbatim
10264 #: ../src/guestfs-actions.pod:1886
10265 #, no-wrap
10266 msgid ""
10267 " const char *\n"
10268 " guestfs_get_append (guestfs_h *g);\n"
10269 "\n"
10270 msgstr ""
10271
10272 # type: textblock
10273 #. type: textblock
10274 #: ../src/guestfs-actions.pod:1889 ../fish/guestfish-actions.pod:1288
10275 msgid ""
10276 "Return the additional kernel options which are added to the guest kernel "
10277 "command line."
10278 msgstr ""
10279
10280 # type: textblock
10281 #. type: textblock
10282 #: ../src/guestfs-actions.pod:1892 ../fish/guestfish-actions.pod:1291
10283 msgid "If C<NULL> then no options are added."
10284 msgstr ""
10285
10286 # type: textblock
10287 #. type: textblock
10288 #: ../src/guestfs-actions.pod:1894
10289 msgid ""
10290 "This function returns a string which may be NULL.  There is no way to return "
10291 "an error from this function.  The string is owned by the guest handle and "
10292 "must I<not> be freed."
10293 msgstr ""
10294
10295 # type: textblock
10296 #. type: textblock
10297 #: ../src/guestfs-actions.pod:1898 ../src/guestfs-actions.pod:5354
10298 #: ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:6255
10299 #: ../src/guestfs-actions.pod:6274 ../src/guestfs-actions.pod:6290
10300 #: ../src/guestfs-actions.pod:6314 ../src/guestfs-actions.pod:7071
10301 #: ../src/guestfs-actions.pod:7089 ../src/guestfs-actions.pod:7451
10302 msgid "(Added in 1.0.26)"
10303 msgstr ""
10304
10305 #. type: =head2
10306 #: ../src/guestfs-actions.pod:1900
10307 msgid "guestfs_get_attach_method"
10308 msgstr ""
10309
10310 #. type: verbatim
10311 #: ../src/guestfs-actions.pod:1902
10312 #, no-wrap
10313 msgid ""
10314 " char *\n"
10315 " guestfs_get_attach_method (guestfs_h *g);\n"
10316 "\n"
10317 msgstr ""
10318
10319 #. type: textblock
10320 #: ../src/guestfs-actions.pod:1905
10321 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
10322 msgstr ""
10323
10324 # type: =head2
10325 #. type: =head2
10326 #: ../src/guestfs-actions.pod:1910
10327 msgid "guestfs_get_autosync"
10328 msgstr ""
10329
10330 # type: verbatim
10331 #. type: verbatim
10332 #: ../src/guestfs-actions.pod:1912
10333 #, no-wrap
10334 msgid ""
10335 " int\n"
10336 " guestfs_get_autosync (guestfs_h *g);\n"
10337 "\n"
10338 msgstr ""
10339
10340 # type: textblock
10341 #. type: textblock
10342 #: ../src/guestfs-actions.pod:1915 ../fish/guestfish-actions.pod:1303
10343 msgid "Get the autosync flag."
10344 msgstr ""
10345
10346 # type: =head2
10347 #. type: =head2
10348 #: ../src/guestfs-actions.pod:1921
10349 msgid "guestfs_get_direct"
10350 msgstr ""
10351
10352 # type: verbatim
10353 #. type: verbatim
10354 #: ../src/guestfs-actions.pod:1923
10355 #, no-wrap
10356 msgid ""
10357 " int\n"
10358 " guestfs_get_direct (guestfs_h *g);\n"
10359 "\n"
10360 msgstr ""
10361
10362 # type: textblock
10363 #. type: textblock
10364 #: ../src/guestfs-actions.pod:1926 ../fish/guestfish-actions.pod:1309
10365 msgid "Return the direct appliance mode flag."
10366 msgstr ""
10367
10368 # type: textblock
10369 #. type: textblock
10370 #: ../src/guestfs-actions.pod:1930 ../src/guestfs-actions.pod:5903
10371 msgid "(Added in 1.0.72)"
10372 msgstr ""
10373
10374 # type: =head2
10375 #. type: =head2
10376 #: ../src/guestfs-actions.pod:1932
10377 msgid "guestfs_get_e2label"
10378 msgstr ""
10379
10380 # type: verbatim
10381 #. type: verbatim
10382 #: ../src/guestfs-actions.pod:1934
10383 #, no-wrap
10384 msgid ""
10385 " char *\n"
10386 " guestfs_get_e2label (guestfs_h *g,\n"
10387 "                      const char *device);\n"
10388 "\n"
10389 msgstr ""
10390
10391 # type: textblock
10392 #. type: textblock
10393 #: ../src/guestfs-actions.pod:1938 ../fish/guestfish-actions.pod:1315
10394 msgid ""
10395 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
10396 msgstr ""
10397
10398 # type: textblock
10399 #. type: textblock
10400 #: ../src/guestfs-actions.pod:1944 ../fish/guestfish-actions.pod:1318
10401 msgid ""
10402 "This function is deprecated.  In new code, use the C<vfs_label> call instead."
10403 msgstr ""
10404
10405 # type: textblock
10406 #. type: textblock
10407 #: ../src/guestfs-actions.pod:1951 ../src/guestfs-actions.pod:1972
10408 #: ../src/guestfs-actions.pod:5921 ../src/guestfs-actions.pod:5940
10409 msgid "(Added in 1.0.15)"
10410 msgstr ""
10411
10412 # type: =head2
10413 #. type: =head2
10414 #: ../src/guestfs-actions.pod:1953
10415 msgid "guestfs_get_e2uuid"
10416 msgstr ""
10417
10418 # type: verbatim
10419 #. type: verbatim
10420 #: ../src/guestfs-actions.pod:1955
10421 #, no-wrap
10422 msgid ""
10423 " char *\n"
10424 " guestfs_get_e2uuid (guestfs_h *g,\n"
10425 "                     const char *device);\n"
10426 "\n"
10427 msgstr ""
10428
10429 # type: textblock
10430 #. type: textblock
10431 #: ../src/guestfs-actions.pod:1959 ../fish/guestfish-actions.pod:1329
10432 msgid ""
10433 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
10434 msgstr ""
10435
10436 # type: textblock
10437 #. type: textblock
10438 #: ../src/guestfs-actions.pod:1965 ../fish/guestfish-actions.pod:1332
10439 msgid ""
10440 "This function is deprecated.  In new code, use the C<vfs_uuid> call instead."
10441 msgstr ""
10442
10443 # type: =head2
10444 #. type: =head2
10445 #: ../src/guestfs-actions.pod:1974
10446 msgid "guestfs_get_memsize"
10447 msgstr ""
10448
10449 # type: verbatim
10450 #. type: verbatim
10451 #: ../src/guestfs-actions.pod:1976
10452 #, no-wrap
10453 msgid ""
10454 " int\n"
10455 " guestfs_get_memsize (guestfs_h *g);\n"
10456 "\n"
10457 msgstr ""
10458
10459 # type: textblock
10460 #. type: textblock
10461 #: ../src/guestfs-actions.pod:1979 ../fish/guestfish-actions.pod:1343
10462 msgid ""
10463 "This gets the memory size in megabytes allocated to the qemu subprocess."
10464 msgstr ""
10465
10466 # type: textblock
10467 #. type: textblock
10468 #: ../src/guestfs-actions.pod:1982
10469 msgid ""
10470 "If C<guestfs_set_memsize> was not called on this handle, and if "
10471 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
10472 "value for memsize."
10473 msgstr ""
10474
10475 # type: textblock
10476 #. type: textblock
10477 #: ../src/guestfs-actions.pod:1986 ../src/guestfs-actions.pod:2067
10478 #: ../src/guestfs-actions.pod:5956 ../src/guestfs-actions.pod:6063
10479 #: ../fish/guestfish-actions.pod:1350 ../fish/guestfish-actions.pod:1401
10480 #: ../fish/guestfish-actions.pod:4017 ../fish/guestfish-actions.pod:4104
10481 msgid ""
10482 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
10483 msgstr ""
10484
10485 # type: textblock
10486 #. type: textblock
10487 #: ../src/guestfs-actions.pod:1991 ../src/guestfs-actions.pod:4417
10488 #: ../src/guestfs-actions.pod:4614 ../src/guestfs-actions.pod:4633
10489 #: ../src/guestfs-actions.pod:4652 ../src/guestfs-actions.pod:4664
10490 #: ../src/guestfs-actions.pod:4681 ../src/guestfs-actions.pod:4694
10491 #: ../src/guestfs-actions.pod:5579 ../src/guestfs-actions.pod:5961
10492 #: ../src/guestfs-actions.pod:6222 ../src/guestfs-actions.pod:6837
10493 msgid "(Added in 1.0.55)"
10494 msgstr ""
10495
10496 # type: =head2
10497 #. type: =head2
10498 #: ../src/guestfs-actions.pod:1993
10499 msgid "guestfs_get_network"
10500 msgstr ""
10501
10502 # type: verbatim
10503 #. type: verbatim
10504 #: ../src/guestfs-actions.pod:1995
10505 #, no-wrap
10506 msgid ""
10507 " int\n"
10508 " guestfs_get_network (guestfs_h *g);\n"
10509 "\n"
10510 msgstr ""
10511
10512 # type: textblock
10513 #. type: textblock
10514 #: ../src/guestfs-actions.pod:1998 ../fish/guestfish-actions.pod:1357
10515 msgid "This returns the enable network flag."
10516 msgstr ""
10517
10518 # type: textblock
10519 #. type: textblock
10520 #: ../src/guestfs-actions.pod:2002 ../src/guestfs-actions.pod:5980
10521 msgid "(Added in 1.5.4)"
10522 msgstr ""
10523
10524 # type: =head2
10525 #. type: =head2
10526 #: ../src/guestfs-actions.pod:2004
10527 msgid "guestfs_get_path"
10528 msgstr ""
10529
10530 # type: verbatim
10531 #. type: verbatim
10532 #: ../src/guestfs-actions.pod:2006
10533 #, no-wrap
10534 msgid ""
10535 " const char *\n"
10536 " guestfs_get_path (guestfs_h *g);\n"
10537 "\n"
10538 msgstr ""
10539
10540 # type: textblock
10541 #. type: textblock
10542 #: ../src/guestfs-actions.pod:2009 ../fish/guestfish-actions.pod:1363
10543 msgid "Return the current search path."
10544 msgstr ""
10545
10546 # type: textblock
10547 #. type: textblock
10548 #: ../src/guestfs-actions.pod:2011 ../fish/guestfish-actions.pod:1365
10549 msgid ""
10550 "This is always non-NULL.  If it wasn't set already, then this will return "
10551 "the default path."
10552 msgstr ""
10553
10554 # type: textblock
10555 #. type: textblock
10556 #: ../src/guestfs-actions.pod:2014 ../src/guestfs-actions.pod:2043
10557 msgid ""
10558 "This function returns a string, or NULL on error.  The string is owned by "
10559 "the guest handle and must I<not> be freed."
10560 msgstr ""
10561
10562 # type: =head2
10563 #. type: =head2
10564 #: ../src/guestfs-actions.pod:2019
10565 msgid "guestfs_get_pid"
10566 msgstr ""
10567
10568 # type: verbatim
10569 #. type: verbatim
10570 #: ../src/guestfs-actions.pod:2021
10571 #, no-wrap
10572 msgid ""
10573 " int\n"
10574 " guestfs_get_pid (guestfs_h *g);\n"
10575 "\n"
10576 msgstr ""
10577
10578 # type: textblock
10579 #. type: textblock
10580 #: ../src/guestfs-actions.pod:2024 ../fish/guestfish-actions.pod:1374
10581 msgid ""
10582 "Return the process ID of the qemu subprocess.  If there is no qemu "
10583 "subprocess, then this will return an error."
10584 msgstr ""
10585
10586 # type: textblock
10587 #. type: textblock
10588 #: ../src/guestfs-actions.pod:2027 ../fish/guestfish-actions.pod:1377
10589 msgid "This is an internal call used for debugging and testing."
10590 msgstr ""
10591
10592 # type: textblock
10593 #. type: textblock
10594 #: ../src/guestfs-actions.pod:2031
10595 msgid "(Added in 1.0.56)"
10596 msgstr ""
10597
10598 # type: =head2
10599 #. type: =head2
10600 #: ../src/guestfs-actions.pod:2033
10601 msgid "guestfs_get_qemu"
10602 msgstr ""
10603
10604 # type: verbatim
10605 #. type: verbatim
10606 #: ../src/guestfs-actions.pod:2035
10607 #, no-wrap
10608 msgid ""
10609 " const char *\n"
10610 " guestfs_get_qemu (guestfs_h *g);\n"
10611 "\n"
10612 msgstr ""
10613
10614 # type: textblock
10615 #. type: textblock
10616 #: ../src/guestfs-actions.pod:2038 ../fish/guestfish-actions.pod:1383
10617 msgid "Return the current qemu binary."
10618 msgstr ""
10619
10620 # type: textblock
10621 #. type: textblock
10622 #: ../src/guestfs-actions.pod:2040 ../fish/guestfish-actions.pod:1385
10623 msgid ""
10624 "This is always non-NULL.  If it wasn't set already, then this will return "
10625 "the default qemu binary name."
10626 msgstr ""
10627
10628 # type: textblock
10629 #. type: textblock
10630 #: ../src/guestfs-actions.pod:2046 ../src/guestfs-actions.pod:6025
10631 msgid "(Added in 1.0.6)"
10632 msgstr ""
10633
10634 # type: =head2
10635 #. type: =head2
10636 #: ../src/guestfs-actions.pod:2048
10637 msgid "guestfs_get_recovery_proc"
10638 msgstr ""
10639
10640 # type: verbatim
10641 #. type: verbatim
10642 #: ../src/guestfs-actions.pod:2050
10643 #, no-wrap
10644 msgid ""
10645 " int\n"
10646 " guestfs_get_recovery_proc (guestfs_h *g);\n"
10647 "\n"
10648 msgstr ""
10649
10650 # type: textblock
10651 #. type: textblock
10652 #: ../src/guestfs-actions.pod:2053 ../fish/guestfish-actions.pod:1392
10653 msgid "Return the recovery process enabled flag."
10654 msgstr ""
10655
10656 # type: textblock
10657 #. type: textblock
10658 #: ../src/guestfs-actions.pod:2057 ../src/guestfs-actions.pod:3527
10659 #: ../src/guestfs-actions.pod:3824 ../src/guestfs-actions.pod:4224
10660 #: ../src/guestfs-actions.pod:4256 ../src/guestfs-actions.pod:5284
10661 #: ../src/guestfs-actions.pod:5627 ../src/guestfs-actions.pod:6049
10662 #: ../src/guestfs-actions.pod:6740 ../src/guestfs-actions.pod:6760
10663 #: ../src/guestfs-actions.pod:6952
10664 msgid "(Added in 1.0.77)"
10665 msgstr ""
10666
10667 # type: =head2
10668 #. type: =head2
10669 #: ../src/guestfs-actions.pod:2059
10670 msgid "guestfs_get_selinux"
10671 msgstr ""
10672
10673 # type: verbatim
10674 #. type: verbatim
10675 #: ../src/guestfs-actions.pod:2061
10676 #, no-wrap
10677 msgid ""
10678 " int\n"
10679 " guestfs_get_selinux (guestfs_h *g);\n"
10680 "\n"
10681 msgstr ""
10682
10683 # type: textblock
10684 #. type: textblock
10685 #: ../src/guestfs-actions.pod:2064
10686 msgid ""
10687 "This returns the current setting of the selinux flag which is passed to the "
10688 "appliance at boot time.  See C<guestfs_set_selinux>."
10689 msgstr ""
10690
10691 # type: textblock
10692 #. type: textblock
10693 #: ../src/guestfs-actions.pod:2072 ../src/guestfs-actions.pod:2135
10694 #: ../src/guestfs-actions.pod:6068 ../src/guestfs-actions.pod:6126
10695 msgid "(Added in 1.0.67)"
10696 msgstr ""
10697
10698 # type: =head2
10699 #. type: =head2
10700 #: ../src/guestfs-actions.pod:2074
10701 msgid "guestfs_get_state"
10702 msgstr ""
10703
10704 # type: verbatim
10705 #. type: verbatim
10706 #: ../src/guestfs-actions.pod:2076
10707 #, no-wrap
10708 msgid ""
10709 " int\n"
10710 " guestfs_get_state (guestfs_h *g);\n"
10711 "\n"
10712 msgstr ""
10713
10714 # type: textblock
10715 #. type: textblock
10716 #: ../src/guestfs-actions.pod:2079 ../fish/guestfish-actions.pod:1408
10717 msgid ""
10718 "This returns the current state as an opaque integer.  This is only useful "
10719 "for printing debug and internal error messages."
10720 msgstr ""
10721
10722 # type: textblock
10723 #. type: textblock
10724 #: ../src/guestfs-actions.pod:2082 ../src/guestfs-actions.pod:3302
10725 #: ../src/guestfs-actions.pod:3331 ../src/guestfs-actions.pod:3392
10726 #: ../src/guestfs-actions.pod:3419 ../fish/guestfish-actions.pod:1411
10727 #: ../fish/guestfish-actions.pod:2325 ../fish/guestfish-actions.pod:2343
10728 #: ../fish/guestfish-actions.pod:2381 ../fish/guestfish-actions.pod:2397
10729 msgid "For more information on states, see L<guestfs(3)>."
10730 msgstr ""
10731
10732 # type: =head2
10733 #. type: =head2
10734 #: ../src/guestfs-actions.pod:2088
10735 msgid "guestfs_get_trace"
10736 msgstr ""
10737
10738 # type: verbatim
10739 #. type: verbatim
10740 #: ../src/guestfs-actions.pod:2090
10741 #, no-wrap
10742 msgid ""
10743 " int\n"
10744 " guestfs_get_trace (guestfs_h *g);\n"
10745 "\n"
10746 msgstr ""
10747
10748 # type: textblock
10749 #. type: textblock
10750 #: ../src/guestfs-actions.pod:2093 ../fish/guestfish-actions.pod:1417
10751 msgid "Return the command trace flag."
10752 msgstr ""
10753
10754 # type: =head2
10755 #. type: =head2
10756 #: ../src/guestfs-actions.pod:2099
10757 msgid "guestfs_get_umask"
10758 msgstr ""
10759
10760 # type: verbatim
10761 #. type: verbatim
10762 #: ../src/guestfs-actions.pod:2101
10763 #, no-wrap
10764 msgid ""
10765 " int\n"
10766 " guestfs_get_umask (guestfs_h *g);\n"
10767 "\n"
10768 msgstr ""
10769
10770 # type: textblock
10771 #. type: textblock
10772 #: ../src/guestfs-actions.pod:2104
10773 msgid ""
10774 "Return the current umask.  By default the umask is C<022> unless it has been "
10775 "set by calling C<guestfs_umask>."
10776 msgstr ""
10777
10778 # type: =head2
10779 #. type: =head2
10780 #: ../src/guestfs-actions.pod:2111
10781 msgid "guestfs_get_verbose"
10782 msgstr ""
10783
10784 # type: verbatim
10785 #. type: verbatim
10786 #: ../src/guestfs-actions.pod:2113
10787 #, no-wrap
10788 msgid ""
10789 " int\n"
10790 " guestfs_get_verbose (guestfs_h *g);\n"
10791 "\n"
10792 msgstr ""
10793
10794 # type: textblock
10795 #. type: textblock
10796 #: ../src/guestfs-actions.pod:2116 ../fish/guestfish-actions.pod:1430
10797 msgid "This returns the verbose messages flag."
10798 msgstr ""
10799
10800 # type: =head2
10801 #. type: =head2
10802 #: ../src/guestfs-actions.pod:2122
10803 msgid "guestfs_getcon"
10804 msgstr ""
10805
10806 # type: verbatim
10807 #. type: verbatim
10808 #: ../src/guestfs-actions.pod:2124
10809 #, no-wrap
10810 msgid ""
10811 " char *\n"
10812 " guestfs_getcon (guestfs_h *g);\n"
10813 "\n"
10814 msgstr ""
10815
10816 # type: textblock
10817 #. type: textblock
10818 #: ../src/guestfs-actions.pod:2127 ../fish/guestfish-actions.pod:1436
10819 msgid "This gets the SELinux security context of the daemon."
10820 msgstr ""
10821
10822 # type: textblock
10823 #. type: textblock
10824 #: ../src/guestfs-actions.pod:2129
10825 msgid ""
10826 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10827 msgstr ""
10828
10829 # type: =head2
10830 #. type: =head2
10831 #: ../src/guestfs-actions.pod:2137
10832 msgid "guestfs_getxattr"
10833 msgstr ""
10834
10835 # type: verbatim
10836 #. type: verbatim
10837 #: ../src/guestfs-actions.pod:2139
10838 #, no-wrap
10839 msgid ""
10840 " char *\n"
10841 " guestfs_getxattr (guestfs_h *g,\n"
10842 "                   const char *path,\n"
10843 "                   const char *name,\n"
10844 "                   size_t *size_r);\n"
10845 "\n"
10846 msgstr ""
10847
10848 # type: textblock
10849 #. type: textblock
10850 #: ../src/guestfs-actions.pod:2145
10851 msgid ""
10852 "Get a single extended attribute from file C<path> named C<name>.  This call "
10853 "follows symlinks.  If you want to lookup an extended attribute for the "
10854 "symlink itself, use C<guestfs_lgetxattr>."
10855 msgstr ""
10856
10857 # type: textblock
10858 #. type: textblock
10859 #: ../src/guestfs-actions.pod:2149 ../src/guestfs-actions.pod:3541
10860 msgid ""
10861 "Normally it is better to get all extended attributes from a file in one go "
10862 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10863 "implementations are buggy and do not provide a way to list out attributes.  "
10864 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10865 "extended attributes you want in advance and call this function."
10866 msgstr ""
10867
10868 # type: textblock
10869 #. type: textblock
10870 #: ../src/guestfs-actions.pod:2156 ../src/guestfs-actions.pod:3548
10871 #: ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:2477
10872 msgid ""
10873 "Extended attribute values are blobs of binary data.  If there is no extended "
10874 "attribute named C<name>, this returns an error."
10875 msgstr ""
10876
10877 # type: textblock
10878 #. type: textblock
10879 #: ../src/guestfs-actions.pod:2159
10880 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10881 msgstr ""
10882
10883 # type: textblock
10884 #. type: textblock
10885 #: ../src/guestfs-actions.pod:2161 ../src/guestfs-actions.pod:2352
10886 #: ../src/guestfs-actions.pod:3553 ../src/guestfs-actions.pod:5277
10887 #: ../src/guestfs-actions.pod:5303 ../src/guestfs-actions.pod:5484
10888 msgid ""
10889 "This function returns a buffer, or NULL on error.  The size of the returned "
10890 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10891 "after use>."
10892 msgstr ""
10893
10894 #. type: textblock
10895 #: ../src/guestfs-actions.pod:2165 ../src/guestfs-actions.pod:3557
10896 msgid "(Added in 1.7.24)"
10897 msgstr ""
10898
10899 # type: =head2
10900 #. type: =head2
10901 #: ../src/guestfs-actions.pod:2167
10902 msgid "guestfs_getxattrs"
10903 msgstr ""
10904
10905 # type: verbatim
10906 #. type: verbatim
10907 #: ../src/guestfs-actions.pod:2169
10908 #, no-wrap
10909 msgid ""
10910 " struct guestfs_xattr_list *\n"
10911 " guestfs_getxattrs (guestfs_h *g,\n"
10912 "                    const char *path);\n"
10913 "\n"
10914 msgstr ""
10915
10916 # type: textblock
10917 #. type: textblock
10918 #: ../src/guestfs-actions.pod:2173 ../fish/guestfish-actions.pod:1465
10919 msgid ""
10920 "This call lists the extended attributes of the file or directory C<path>."
10921 msgstr ""
10922
10923 # type: textblock
10924 #. type: textblock
10925 #: ../src/guestfs-actions.pod:2176 ../fish/guestfish-actions.pod:1468
10926 msgid ""
10927 "At the system call level, this is a combination of the L<listxattr(2)> and "
10928 "L<getxattr(2)> calls."
10929 msgstr ""
10930
10931 # type: textblock
10932 #. type: textblock
10933 #: ../src/guestfs-actions.pod:2179
10934 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10935 msgstr ""
10936
10937 # type: textblock
10938 #. type: textblock
10939 #: ../src/guestfs-actions.pod:2181 ../src/guestfs-actions.pod:3569
10940 #: ../src/guestfs-actions.pod:4220
10941 msgid ""
10942 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10943 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10944 msgstr ""
10945
10946 # type: textblock
10947 #. type: textblock
10948 #: ../src/guestfs-actions.pod:2185 ../src/guestfs-actions.pod:3573
10949 #: ../src/guestfs-actions.pod:3738 ../src/guestfs-actions.pod:3774
10950 #: ../src/guestfs-actions.pod:5657 ../src/guestfs-actions.pod:6145
10951 #: ../src/guestfs-actions.pod:7516
10952 msgid "(Added in 1.0.59)"
10953 msgstr ""
10954
10955 # type: =head2
10956 #. type: =head2
10957 #: ../src/guestfs-actions.pod:2187
10958 msgid "guestfs_glob_expand"
10959 msgstr ""
10960
10961 # type: verbatim
10962 #. type: verbatim
10963 #: ../src/guestfs-actions.pod:2189
10964 #, no-wrap
10965 msgid ""
10966 " char **\n"
10967 " guestfs_glob_expand (guestfs_h *g,\n"
10968 "                      const char *pattern);\n"
10969 "\n"
10970 msgstr ""
10971
10972 # type: textblock
10973 #. type: textblock
10974 #: ../src/guestfs-actions.pod:2193 ../fish/guestfish-actions.pod:1477
10975 msgid ""
10976 "This command searches for all the pathnames matching C<pattern> according to "
10977 "the wildcard expansion rules used by the shell."
10978 msgstr ""
10979
10980 # type: textblock
10981 #. type: textblock
10982 #: ../src/guestfs-actions.pod:2197 ../fish/guestfish-actions.pod:1481
10983 msgid ""
10984 "If no paths match, then this returns an empty list (note: not an error)."
10985 msgstr ""
10986
10987 # type: textblock
10988 #. type: textblock
10989 #: ../src/guestfs-actions.pod:2200 ../fish/guestfish-actions.pod:1484
10990 msgid ""
10991 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10992 "GLOB_BRACE>.  See that manual page for more details."
10993 msgstr ""
10994
10995 # type: textblock
10996 #. type: textblock
10997 #: ../src/guestfs-actions.pod:2208 ../src/guestfs-actions.pod:6338
10998 #: ../src/guestfs-actions.pod:6355
10999 msgid "(Added in 1.0.50)"
11000 msgstr ""
11001
11002 # type: =head2
11003 #. type: =head2
11004 #: ../src/guestfs-actions.pod:2210
11005 msgid "guestfs_grep"
11006 msgstr ""
11007
11008 # type: verbatim
11009 #. type: verbatim
11010 #: ../src/guestfs-actions.pod:2212
11011 #, no-wrap
11012 msgid ""
11013 " char **\n"
11014 " guestfs_grep (guestfs_h *g,\n"
11015 "               const char *regex,\n"
11016 "               const char *path);\n"
11017 "\n"
11018 msgstr ""
11019
11020 # type: textblock
11021 #. type: textblock
11022 #: ../src/guestfs-actions.pod:2217 ../fish/guestfish-actions.pod:1492
11023 msgid "This calls the external C<grep> program and returns the matching lines."
11024 msgstr ""
11025
11026 # type: =head2
11027 #. type: =head2
11028 #: ../src/guestfs-actions.pod:2229
11029 msgid "guestfs_grepi"
11030 msgstr ""
11031
11032 # type: verbatim
11033 #. type: verbatim
11034 #: ../src/guestfs-actions.pod:2231
11035 #, no-wrap
11036 msgid ""
11037 " char **\n"
11038 " guestfs_grepi (guestfs_h *g,\n"
11039 "                const char *regex,\n"
11040 "                const char *path);\n"
11041 "\n"
11042 msgstr ""
11043
11044 # type: textblock
11045 #. type: textblock
11046 #: ../src/guestfs-actions.pod:2236 ../fish/guestfish-actions.pod:1502
11047 msgid ""
11048 "This calls the external C<grep -i> program and returns the matching lines."
11049 msgstr ""
11050
11051 # type: =head2
11052 #. type: =head2
11053 #: ../src/guestfs-actions.pod:2248
11054 msgid "guestfs_grub_install"
11055 msgstr ""
11056
11057 # type: verbatim
11058 #. type: verbatim
11059 #: ../src/guestfs-actions.pod:2250
11060 #, no-wrap
11061 msgid ""
11062 " int\n"
11063 " guestfs_grub_install (guestfs_h *g,\n"
11064 "                       const char *root,\n"
11065 "                       const char *device);\n"
11066 "\n"
11067 msgstr ""
11068
11069 # type: textblock
11070 #. type: textblock
11071 #: ../src/guestfs-actions.pod:2255 ../fish/guestfish-actions.pod:1512
11072 msgid ""
11073 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
11074 "the root directory being C<root>."
11075 msgstr ""
11076
11077 # type: textblock
11078 #. type: textblock
11079 #: ../src/guestfs-actions.pod:2258 ../fish/guestfish-actions.pod:1515
11080 msgid ""
11081 "Note: If grub-install reports the error \"No suitable drive was found in the "
11082 "generated device map.\" it may be that you need to create a C</boot/grub/"
11083 "device.map> file first that contains the mapping between grub device names "
11084 "and Linux device names.  It is usually sufficient to create a file "
11085 "containing:"
11086 msgstr ""
11087
11088 # type: verbatim
11089 #. type: verbatim
11090 #: ../src/guestfs-actions.pod:2265 ../fish/guestfish-actions.pod:1522
11091 #, no-wrap
11092 msgid ""
11093 " (hd0) /dev/vda\n"
11094 "\n"
11095 msgstr ""
11096
11097 # type: textblock
11098 #. type: textblock
11099 #: ../src/guestfs-actions.pod:2267 ../fish/guestfish-actions.pod:1524
11100 msgid "replacing C</dev/vda> with the name of the installation device."
11101 msgstr ""
11102
11103 # type: textblock
11104 #. type: textblock
11105 #: ../src/guestfs-actions.pod:2271
11106 msgid "(Added in 1.0.17)"
11107 msgstr ""
11108
11109 # type: =head2
11110 #. type: =head2
11111 #: ../src/guestfs-actions.pod:2273
11112 msgid "guestfs_head"
11113 msgstr ""
11114
11115 # type: verbatim
11116 #. type: verbatim
11117 #: ../src/guestfs-actions.pod:2275
11118 #, no-wrap
11119 msgid ""
11120 " char **\n"
11121 " guestfs_head (guestfs_h *g,\n"
11122 "               const char *path);\n"
11123 "\n"
11124 msgstr ""
11125
11126 # type: textblock
11127 #. type: textblock
11128 #: ../src/guestfs-actions.pod:2279 ../fish/guestfish-actions.pod:1530
11129 msgid ""
11130 "This command returns up to the first 10 lines of a file as a list of strings."
11131 msgstr ""
11132
11133 # type: =head2
11134 #. type: =head2
11135 #: ../src/guestfs-actions.pod:2291
11136 msgid "guestfs_head_n"
11137 msgstr ""
11138
11139 # type: verbatim
11140 #. type: verbatim
11141 #: ../src/guestfs-actions.pod:2293
11142 #, no-wrap
11143 msgid ""
11144 " char **\n"
11145 " guestfs_head_n (guestfs_h *g,\n"
11146 "                 int nrlines,\n"
11147 "                 const char *path);\n"
11148 "\n"
11149 msgstr ""
11150
11151 # type: textblock
11152 #. type: textblock
11153 #: ../src/guestfs-actions.pod:2298 ../fish/guestfish-actions.pod:1540
11154 msgid ""
11155 "If the parameter C<nrlines> is a positive number, this returns the first "
11156 "C<nrlines> lines of the file C<path>."
11157 msgstr ""
11158
11159 # type: textblock
11160 #. type: textblock
11161 #: ../src/guestfs-actions.pod:2301 ../fish/guestfish-actions.pod:1543
11162 msgid ""
11163 "If the parameter C<nrlines> is a negative number, this returns lines from "
11164 "the file C<path>, excluding the last C<nrlines> lines."
11165 msgstr ""
11166
11167 # type: textblock
11168 #. type: textblock
11169 #: ../src/guestfs-actions.pod:2304 ../src/guestfs-actions.pod:6635
11170 #: ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:4482
11171 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
11172 msgstr ""
11173
11174 # type: =head2
11175 #. type: =head2
11176 #: ../src/guestfs-actions.pod:2315
11177 msgid "guestfs_hexdump"
11178 msgstr ""
11179
11180 # type: verbatim
11181 #. type: verbatim
11182 #: ../src/guestfs-actions.pod:2317
11183 #, no-wrap
11184 msgid ""
11185 " char *\n"
11186 " guestfs_hexdump (guestfs_h *g,\n"
11187 "                  const char *path);\n"
11188 "\n"
11189 msgstr ""
11190
11191 # type: textblock
11192 #. type: textblock
11193 #: ../src/guestfs-actions.pod:2321 ../fish/guestfish-actions.pod:1555
11194 msgid ""
11195 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
11196 "readable, canonical hex dump of the file."
11197 msgstr ""
11198
11199 # type: textblock
11200 #. type: textblock
11201 #: ../src/guestfs-actions.pod:2330 ../src/guestfs-actions.pod:6419
11202 #: ../src/guestfs-actions.pod:6474
11203 msgid "(Added in 1.0.22)"
11204 msgstr ""
11205
11206 # type: =head2
11207 #. type: =head2
11208 #: ../src/guestfs-actions.pod:2332
11209 msgid "guestfs_initrd_cat"
11210 msgstr ""
11211
11212 # type: verbatim
11213 #. type: verbatim
11214 #: ../src/guestfs-actions.pod:2334
11215 #, no-wrap
11216 msgid ""
11217 " char *\n"
11218 " guestfs_initrd_cat (guestfs_h *g,\n"
11219 "                     const char *initrdpath,\n"
11220 "                     const char *filename,\n"
11221 "                     size_t *size_r);\n"
11222 "\n"
11223 msgstr ""
11224
11225 # type: textblock
11226 #. type: textblock
11227 #: ../src/guestfs-actions.pod:2340 ../fish/guestfish-actions.pod:1565
11228 msgid ""
11229 "This command unpacks the file C<filename> from the initrd file called "
11230 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
11231 "character."
11232 msgstr ""
11233
11234 # type: textblock
11235 #. type: textblock
11236 #: ../src/guestfs-actions.pod:2344 ../fish/guestfish-actions.pod:1569
11237 msgid ""
11238 "For example, in guestfish you could use the following command to examine the "
11239 "boot script (usually called C</init>)  contained in a Linux initrd or "
11240 "initramfs image:"
11241 msgstr ""
11242
11243 # type: verbatim
11244 #. type: verbatim
11245 #: ../src/guestfs-actions.pod:2348 ../fish/guestfish-actions.pod:1573
11246 #, no-wrap
11247 msgid ""
11248 " initrd-cat /boot/initrd-<version>.img init\n"
11249 "\n"
11250 msgstr ""
11251
11252 # type: textblock
11253 #. type: textblock
11254 #: ../src/guestfs-actions.pod:2350
11255 msgid "See also C<guestfs_initrd_list>."
11256 msgstr ""
11257
11258 # type: =head2
11259 #. type: =head2
11260 #: ../src/guestfs-actions.pod:2361
11261 msgid "guestfs_initrd_list"
11262 msgstr ""
11263
11264 # type: verbatim
11265 #. type: verbatim
11266 #: ../src/guestfs-actions.pod:2363
11267 #, no-wrap
11268 msgid ""
11269 " char **\n"
11270 " guestfs_initrd_list (guestfs_h *g,\n"
11271 "                      const char *path);\n"
11272 "\n"
11273 msgstr ""
11274
11275 # type: textblock
11276 #. type: textblock
11277 #: ../src/guestfs-actions.pod:2367 ../fish/guestfish-actions.pod:1584
11278 msgid "This command lists out files contained in an initrd."
11279 msgstr ""
11280
11281 # type: textblock
11282 #. type: textblock
11283 #: ../src/guestfs-actions.pod:2369 ../fish/guestfish-actions.pod:1586
11284 msgid ""
11285 "The files are listed without any initial C</> character.  The files are "
11286 "listed in the order they appear (not necessarily alphabetical).  Directory "
11287 "names are listed as separate items."
11288 msgstr ""
11289
11290 # type: textblock
11291 #. type: textblock
11292 #: ../src/guestfs-actions.pod:2373 ../fish/guestfish-actions.pod:1590
11293 msgid ""
11294 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
11295 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
11296 "files)."
11297 msgstr ""
11298
11299 # type: =head2
11300 #. type: =head2
11301 #: ../src/guestfs-actions.pod:2383
11302 msgid "guestfs_inotify_add_watch"
11303 msgstr ""
11304
11305 # type: verbatim
11306 #. type: verbatim
11307 #: ../src/guestfs-actions.pod:2385
11308 #, no-wrap
11309 msgid ""
11310 " int64_t\n"
11311 " guestfs_inotify_add_watch (guestfs_h *g,\n"
11312 "                            const char *path,\n"
11313 "                            int mask);\n"
11314 "\n"
11315 msgstr ""
11316
11317 # type: textblock
11318 #. type: textblock
11319 #: ../src/guestfs-actions.pod:2390 ../fish/guestfish-actions.pod:1598
11320 msgid "Watch C<path> for the events listed in C<mask>."
11321 msgstr ""
11322
11323 # type: textblock
11324 #. type: textblock
11325 #: ../src/guestfs-actions.pod:2392 ../fish/guestfish-actions.pod:1600
11326 msgid ""
11327 "Note that if C<path> is a directory then events within that directory are "
11328 "watched, but this does I<not> happen recursively (in subdirectories)."
11329 msgstr ""
11330
11331 # type: textblock
11332 #. type: textblock
11333 #: ../src/guestfs-actions.pod:2396 ../fish/guestfish-actions.pod:1604
11334 msgid ""
11335 "Note for non-C or non-Linux callers: the inotify events are defined by the "
11336 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
11337 msgstr ""
11338
11339 # type: =head2
11340 #. type: =head2
11341 #: ../src/guestfs-actions.pod:2404
11342 msgid "guestfs_inotify_close"
11343 msgstr ""
11344
11345 # type: verbatim
11346 #. type: verbatim
11347 #: ../src/guestfs-actions.pod:2406
11348 #, no-wrap
11349 msgid ""
11350 " int\n"
11351 " guestfs_inotify_close (guestfs_h *g);\n"
11352 "\n"
11353 msgstr ""
11354
11355 # type: textblock
11356 #. type: textblock
11357 #: ../src/guestfs-actions.pod:2409 ../fish/guestfish-actions.pod:1612
11358 msgid ""
11359 "This closes the inotify handle which was previously opened by inotify_init.  "
11360 "It removes all watches, throws away any pending events, and deallocates all "
11361 "resources."
11362 msgstr ""
11363
11364 # type: =head2
11365 #. type: =head2
11366 #: ../src/guestfs-actions.pod:2417
11367 msgid "guestfs_inotify_files"
11368 msgstr ""
11369
11370 # type: verbatim
11371 #. type: verbatim
11372 #: ../src/guestfs-actions.pod:2419
11373 #, no-wrap
11374 msgid ""
11375 " char **\n"
11376 " guestfs_inotify_files (guestfs_h *g);\n"
11377 "\n"
11378 msgstr ""
11379
11380 # type: textblock
11381 #. type: textblock
11382 #: ../src/guestfs-actions.pod:2422
11383 msgid ""
11384 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
11385 "returns a list of pathnames of objects that were touched.  The returned "
11386 "pathnames are sorted and deduplicated."
11387 msgstr ""
11388
11389 # type: =head2
11390 #. type: =head2
11391 #: ../src/guestfs-actions.pod:2432
11392 msgid "guestfs_inotify_init"
11393 msgstr ""
11394
11395 # type: verbatim
11396 #. type: verbatim
11397 #: ../src/guestfs-actions.pod:2434
11398 #, no-wrap
11399 msgid ""
11400 " int\n"
11401 " guestfs_inotify_init (guestfs_h *g,\n"
11402 "                       int maxevents);\n"
11403 "\n"
11404 msgstr ""
11405
11406 # type: textblock
11407 #. type: textblock
11408 #: ../src/guestfs-actions.pod:2438 ../fish/guestfish-actions.pod:1628
11409 msgid ""
11410 "This command creates a new inotify handle.  The inotify subsystem can be "
11411 "used to notify events which happen to objects in the guest filesystem."
11412 msgstr ""
11413
11414 # type: textblock
11415 #. type: textblock
11416 #: ../src/guestfs-actions.pod:2442
11417 msgid ""
11418 "C<maxevents> is the maximum number of events which will be queued up between "
11419 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
11420 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
11421 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
11422 "throws away events, but records the fact that it threw them away by setting "
11423 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
11424 "C<guestfs_inotify_read>)."
11425 msgstr ""
11426
11427 # type: textblock
11428 #. type: textblock
11429 #: ../src/guestfs-actions.pod:2452
11430 msgid ""
11431 "Before any events are generated, you have to add some watches to the "
11432 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
11433 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
11434 msgstr ""
11435
11436 # type: textblock
11437 #. type: textblock
11438 #: ../src/guestfs-actions.pod:2458
11439 msgid ""
11440 "Queued up events should be read periodically by calling "
11441 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
11442 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
11443 "often enough then you risk the internal queue overflowing."
11444 msgstr ""
11445
11446 # type: textblock
11447 #. type: textblock
11448 #: ../src/guestfs-actions.pod:2465
11449 msgid ""
11450 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
11451 "This also removes any watches automatically."
11452 msgstr ""
11453
11454 # type: textblock
11455 #. type: textblock
11456 #: ../src/guestfs-actions.pod:2469 ../fish/guestfish-actions.pod:1659
11457 msgid ""
11458 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
11459 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
11460 "that there is one global inotify handle per libguestfs instance."
11461 msgstr ""
11462
11463 # type: =head2
11464 #. type: =head2
11465 #: ../src/guestfs-actions.pod:2478
11466 msgid "guestfs_inotify_read"
11467 msgstr ""
11468
11469 # type: verbatim
11470 #. type: verbatim
11471 #: ../src/guestfs-actions.pod:2480
11472 #, no-wrap
11473 msgid ""
11474 " struct guestfs_inotify_event_list *\n"
11475 " guestfs_inotify_read (guestfs_h *g);\n"
11476 "\n"
11477 msgstr ""
11478
11479 # type: textblock
11480 #. type: textblock
11481 #: ../src/guestfs-actions.pod:2483 ../fish/guestfish-actions.pod:1668
11482 msgid ""
11483 "Return the complete queue of events that have happened since the previous "
11484 "read call."
11485 msgstr ""
11486
11487 # type: textblock
11488 #. type: textblock
11489 #: ../src/guestfs-actions.pod:2486 ../fish/guestfish-actions.pod:1671
11490 msgid "If no events have happened, this returns an empty list."
11491 msgstr ""
11492
11493 # type: textblock
11494 #. type: textblock
11495 #: ../src/guestfs-actions.pod:2488 ../fish/guestfish-actions.pod:1673
11496 msgid ""
11497 "I<Note>: In order to make sure that all events have been read, you must call "
11498 "this function repeatedly until it returns an empty list.  The reason is that "
11499 "the call will read events up to the maximum appliance-to-host message size "
11500 "and leave remaining events in the queue."
11501 msgstr ""
11502
11503 # type: textblock
11504 #. type: textblock
11505 #: ../src/guestfs-actions.pod:2494
11506 msgid ""
11507 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
11508 "there was an error.  I<The caller must call "
11509 "C<guestfs_free_inotify_event_list> after use>."
11510 msgstr ""
11511
11512 # type: =head2
11513 #. type: =head2
11514 #: ../src/guestfs-actions.pod:2500
11515 msgid "guestfs_inotify_rm_watch"
11516 msgstr ""
11517
11518 # type: verbatim
11519 #. type: verbatim
11520 #: ../src/guestfs-actions.pod:2502
11521 #, no-wrap
11522 msgid ""
11523 " int\n"
11524 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
11525 "                           int wd);\n"
11526 "\n"
11527 msgstr ""
11528
11529 # type: textblock
11530 #. type: textblock
11531 #: ../src/guestfs-actions.pod:2506
11532 msgid ""
11533 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
11534 msgstr ""
11535
11536 # type: =head2
11537 #. type: =head2
11538 #: ../src/guestfs-actions.pod:2513
11539 msgid "guestfs_inspect_get_arch"
11540 msgstr ""
11541
11542 # type: verbatim
11543 #. type: verbatim
11544 #: ../src/guestfs-actions.pod:2515
11545 #, no-wrap
11546 msgid ""
11547 " char *\n"
11548 " guestfs_inspect_get_arch (guestfs_h *g,\n"
11549 "                           const char *root);\n"
11550 "\n"
11551 msgstr ""
11552
11553 # type: textblock
11554 #. type: textblock
11555 #: ../src/guestfs-actions.pod:2519 ../src/guestfs-actions.pod:2542
11556 #: ../src/guestfs-actions.pod:2635 ../src/guestfs-actions.pod:2679
11557 #: ../src/guestfs-actions.pod:2705 ../src/guestfs-actions.pod:2744
11558 #: ../src/guestfs-actions.pod:2766 ../src/guestfs-actions.pod:2793
11559 #: ../src/guestfs-actions.pod:2814 ../src/guestfs-actions.pod:2857
11560 #: ../src/guestfs-actions.pod:2886 ../src/guestfs-actions.pod:2917
11561 #: ../src/guestfs-actions.pod:2941 ../src/guestfs-actions.pod:2996
11562 #: ../src/guestfs-actions.pod:3038 ../src/guestfs-actions.pod:3059
11563 #: ../src/guestfs-actions.pod:3082 ../src/guestfs-actions.pod:3099
11564 #: ../src/guestfs-actions.pod:3116 ../src/guestfs-actions.pod:3135
11565 msgid ""
11566 "This function should only be called with a root device string as returned by "
11567 "C<guestfs_inspect_os>."
11568 msgstr ""
11569
11570 # type: textblock
11571 #. type: textblock
11572 #: ../src/guestfs-actions.pod:2522
11573 msgid ""
11574 "This returns the architecture of the inspected operating system.  The "
11575 "possible return values are listed under C<guestfs_file_architecture>."
11576 msgstr ""
11577
11578 # type: textblock
11579 #. type: textblock
11580 #: ../src/guestfs-actions.pod:2526 ../fish/guestfish-actions.pod:1697
11581 msgid ""
11582 "If the architecture could not be determined, then the string C<unknown> is "
11583 "returned."
11584 msgstr ""
11585
11586 # type: textblock
11587 #. type: textblock
11588 #: ../src/guestfs-actions.pod:2529 ../src/guestfs-actions.pod:2622
11589 #: ../src/guestfs-actions.pod:2733 ../src/guestfs-actions.pod:2753
11590 #: ../src/guestfs-actions.pod:2781 ../src/guestfs-actions.pod:2873
11591 #: ../src/guestfs-actions.pod:2904 ../src/guestfs-actions.pod:2928
11592 #: ../src/guestfs-actions.pod:2982 ../src/guestfs-actions.pod:3025
11593 #: ../src/guestfs-actions.pod:3048 ../src/guestfs-actions.pod:3069
11594 #: ../src/guestfs-actions.pod:3089 ../src/guestfs-actions.pod:3106
11595 #: ../src/guestfs-actions.pod:3125 ../src/guestfs-actions.pod:3228
11596 #: ../src/guestfs-actions.pod:3269 ../fish/guestfish-actions.pod:1700
11597 #: ../fish/guestfish-actions.pod:1786 ../fish/guestfish-actions.pod:1874
11598 #: ../fish/guestfish-actions.pod:1889 ../fish/guestfish-actions.pod:1910
11599 #: ../fish/guestfish-actions.pod:1980 ../fish/guestfish-actions.pod:2004
11600 #: ../fish/guestfish-actions.pod:2021 ../fish/guestfish-actions.pod:2064
11601 #: ../fish/guestfish-actions.pod:2099 ../fish/guestfish-actions.pod:2115
11602 #: ../fish/guestfish-actions.pod:2131 ../fish/guestfish-actions.pod:2144
11603 #: ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2172
11604 #: ../fish/guestfish-actions.pod:2271 ../fish/guestfish-actions.pod:2305
11605 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
11606 msgstr ""
11607
11608 # type: =head2
11609 #. type: =head2
11610 #: ../src/guestfs-actions.pod:2536
11611 msgid "guestfs_inspect_get_distro"
11612 msgstr ""
11613
11614 # type: verbatim
11615 #. type: verbatim
11616 #: ../src/guestfs-actions.pod:2538
11617 #, no-wrap
11618 msgid ""
11619 " char *\n"
11620 " guestfs_inspect_get_distro (guestfs_h *g,\n"
11621 "                             const char *root);\n"
11622 "\n"
11623 msgstr ""
11624
11625 # type: textblock
11626 #. type: textblock
11627 #: ../src/guestfs-actions.pod:2545 ../fish/guestfish-actions.pod:1709
11628 msgid ""
11629 "This returns the distro (distribution) of the inspected operating system."
11630 msgstr ""
11631
11632 # type: textblock
11633 #. type: textblock
11634 #: ../src/guestfs-actions.pod:2548 ../fish/guestfish-actions.pod:1712
11635 msgid "Currently defined distros are:"
11636 msgstr ""
11637
11638 # type: =item
11639 #. type: =item
11640 #: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1716
11641 msgid "\"archlinux\""
11642 msgstr ""
11643
11644 # type: textblock
11645 #. type: textblock
11646 #: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1718
11647 msgid "Arch Linux."
11648 msgstr ""
11649
11650 #. type: =item
11651 #: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1720
11652 msgid "\"centos\""
11653 msgstr ""
11654
11655 #. type: textblock
11656 #: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1722
11657 msgid "CentOS."
11658 msgstr ""
11659
11660 # type: =item
11661 #. type: =item
11662 #: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1724
11663 msgid "\"debian\""
11664 msgstr ""
11665
11666 # type: textblock
11667 #. type: textblock
11668 #: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1726
11669 msgid "Debian."
11670 msgstr ""
11671
11672 # type: =item
11673 #. type: =item
11674 #: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1728
11675 msgid "\"fedora\""
11676 msgstr ""
11677
11678 # type: textblock
11679 #. type: textblock
11680 #: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1730
11681 msgid "Fedora."
11682 msgstr ""
11683
11684 # type: =item
11685 #. type: =item
11686 #: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1732
11687 msgid "\"gentoo\""
11688 msgstr ""
11689
11690 # type: textblock
11691 #. type: textblock
11692 #: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1734
11693 msgid "Gentoo."
11694 msgstr ""
11695
11696 # type: =item
11697 #. type: =item
11698 #: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1736
11699 msgid "\"linuxmint\""
11700 msgstr ""
11701
11702 # type: textblock
11703 #. type: textblock
11704 #: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1738
11705 msgid "Linux Mint."
11706 msgstr ""
11707
11708 # type: =item
11709 #. type: =item
11710 #: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1740
11711 msgid "\"mandriva\""
11712 msgstr ""
11713
11714 # type: textblock
11715 #. type: textblock
11716 #: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1742
11717 msgid "Mandriva."
11718 msgstr ""
11719
11720 # type: =item
11721 #. type: =item
11722 #: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1744
11723 msgid "\"meego\""
11724 msgstr ""
11725
11726 # type: textblock
11727 #. type: textblock
11728 #: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1746
11729 msgid "MeeGo."
11730 msgstr ""
11731
11732 # type: =item
11733 #. type: =item
11734 #: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1748
11735 msgid "\"pardus\""
11736 msgstr ""
11737
11738 # type: textblock
11739 #. type: textblock
11740 #: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1750
11741 msgid "Pardus."
11742 msgstr ""
11743
11744 # type: =item
11745 #. type: =item
11746 #: ../src/guestfs-actions.pod:2588 ../fish/guestfish-actions.pod:1752
11747 msgid "\"redhat-based\""
11748 msgstr ""
11749
11750 # type: textblock
11751 #. type: textblock
11752 #: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1754
11753 msgid "Some Red Hat-derived distro."
11754 msgstr ""
11755
11756 # type: =item
11757 #. type: =item
11758 #: ../src/guestfs-actions.pod:2592 ../fish/guestfish-actions.pod:1756
11759 msgid "\"rhel\""
11760 msgstr ""
11761
11762 #. type: textblock
11763 #: ../src/guestfs-actions.pod:2594 ../fish/guestfish-actions.pod:1758
11764 msgid "Red Hat Enterprise Linux."
11765 msgstr ""
11766
11767 #. type: =item
11768 #: ../src/guestfs-actions.pod:2596 ../fish/guestfish-actions.pod:1760
11769 msgid "\"scientificlinux\""
11770 msgstr ""
11771
11772 #. type: textblock
11773 #: ../src/guestfs-actions.pod:2598 ../fish/guestfish-actions.pod:1762
11774 msgid "Scientific Linux."
11775 msgstr ""
11776
11777 #. type: =item
11778 #: ../src/guestfs-actions.pod:2600 ../fish/guestfish-actions.pod:1764
11779 msgid "\"slackware\""
11780 msgstr ""
11781
11782 #. type: textblock
11783 #: ../src/guestfs-actions.pod:2602 ../fish/guestfish-actions.pod:1766
11784 msgid "Slackware."
11785 msgstr ""
11786
11787 # type: =item
11788 #. type: =item
11789 #: ../src/guestfs-actions.pod:2604 ../fish/guestfish-actions.pod:1768
11790 msgid "\"ubuntu\""
11791 msgstr ""
11792
11793 # type: textblock
11794 #. type: textblock
11795 #: ../src/guestfs-actions.pod:2606 ../fish/guestfish-actions.pod:1770
11796 msgid "Ubuntu."
11797 msgstr ""
11798
11799 # type: =item
11800 #. type: =item
11801 #: ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2724
11802 #: ../src/guestfs-actions.pod:3016 ../fish/guestfish-actions.pod:1772
11803 #: ../fish/guestfish-actions.pod:1865 ../fish/guestfish-actions.pod:2090
11804 msgid "\"unknown\""
11805 msgstr ""
11806
11807 # type: textblock
11808 #. type: textblock
11809 #: ../src/guestfs-actions.pod:2610 ../fish/guestfish-actions.pod:1774
11810 msgid "The distro could not be determined."
11811 msgstr ""
11812
11813 # type: =item
11814 #. type: =item
11815 #: ../src/guestfs-actions.pod:2612 ../src/guestfs-actions.pod:3008
11816 #: ../fish/guestfish-actions.pod:1776 ../fish/guestfish-actions.pod:2082
11817 msgid "\"windows\""
11818 msgstr ""
11819
11820 # type: textblock
11821 #. type: textblock
11822 #: ../src/guestfs-actions.pod:2614 ../fish/guestfish-actions.pod:1778
11823 msgid ""
11824 "Windows does not have distributions.  This string is returned if the OS type "
11825 "is Windows."
11826 msgstr ""
11827
11828 # type: textblock
11829 #. type: textblock
11830 #: ../src/guestfs-actions.pod:2619 ../src/guestfs-actions.pod:2730
11831 #: ../src/guestfs-actions.pod:3022 ../fish/guestfish-actions.pod:1783
11832 #: ../fish/guestfish-actions.pod:1871 ../fish/guestfish-actions.pod:2096
11833 msgid ""
11834 "Future versions of libguestfs may return other strings here.  The caller "
11835 "should be prepared to handle any string."
11836 msgstr ""
11837
11838 #. type: =head2
11839 #: ../src/guestfs-actions.pod:2629
11840 msgid "guestfs_inspect_get_drive_mappings"
11841 msgstr ""
11842
11843 #. type: verbatim
11844 #: ../src/guestfs-actions.pod:2631
11845 #, no-wrap
11846 msgid ""
11847 " char **\n"
11848 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
11849 "                                     const char *root);\n"
11850 "\n"
11851 msgstr ""
11852
11853 #. type: textblock
11854 #: ../src/guestfs-actions.pod:2638 ../fish/guestfish-actions.pod:1795
11855 msgid ""
11856 "This call is useful for Windows which uses a primitive system of assigning "
11857 "drive letters (like \"C:\") to partitions.  This inspection API examines the "
11858 "Windows Registry to find out how disks/partitions are mapped to drive "
11859 "letters, and returns a hash table as in the example below:"
11860 msgstr ""
11861
11862 #. type: verbatim
11863 #: ../src/guestfs-actions.pod:2644 ../fish/guestfish-actions.pod:1801
11864 #, no-wrap
11865 msgid ""
11866 " C      =>     /dev/vda2\n"
11867 " E      =>     /dev/vdb1\n"
11868 " F      =>     /dev/vdc1\n"
11869 "\n"
11870 msgstr ""
11871
11872 #. type: textblock
11873 #: ../src/guestfs-actions.pod:2648 ../fish/guestfish-actions.pod:1805
11874 msgid ""
11875 "Note that keys are drive letters.  For Windows, the key is case insensitive "
11876 "and just contains the drive letter, without the customary colon separator "
11877 "character."
11878 msgstr ""
11879
11880 #. type: textblock
11881 #: ../src/guestfs-actions.pod:2652 ../fish/guestfish-actions.pod:1809
11882 msgid ""
11883 "In future we may support other operating systems that also used drive "
11884 "letters, but the keys for those might not be case insensitive and might be "
11885 "longer than 1 character.  For example in OS-9, hard drives were named C<h0>, "
11886 "C<h1> etc."
11887 msgstr ""
11888
11889 #. type: textblock
11890 #: ../src/guestfs-actions.pod:2657 ../fish/guestfish-actions.pod:1814
11891 msgid ""
11892 "For Windows guests, currently only hard drive mappings are returned.  "
11893 "Removable disks (eg. DVD-ROMs) are ignored."
11894 msgstr ""
11895
11896 #. type: textblock
11897 #: ../src/guestfs-actions.pod:2660 ../fish/guestfish-actions.pod:1817
11898 msgid ""
11899 "For guests that do not use drive mappings, or if the drive mappings could "
11900 "not be determined, this returns an empty hash table."
11901 msgstr ""
11902
11903 #. type: textblock
11904 #: ../src/guestfs-actions.pod:2663
11905 msgid ""
11906 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11907 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
11908 msgstr ""
11909
11910 # type: textblock
11911 #. type: textblock
11912 #: ../src/guestfs-actions.pod:2667 ../src/guestfs-actions.pod:2843
11913 #: ../src/guestfs-actions.pod:3626 ../src/guestfs-actions.pod:4843
11914 #: ../src/guestfs-actions.pod:6776
11915 msgid ""
11916 "This function returns a NULL-terminated array of strings, or NULL if there "
11917 "was an error.  The array of strings will always have length C<2n+1>, where "
11918 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11919 "caller must free the strings and the array after use>."
11920 msgstr ""
11921
11922 # type: =head2
11923 #. type: =head2
11924 #: ../src/guestfs-actions.pod:2673
11925 msgid "guestfs_inspect_get_filesystems"
11926 msgstr ""
11927
11928 # type: verbatim
11929 #. type: verbatim
11930 #: ../src/guestfs-actions.pod:2675
11931 #, no-wrap
11932 msgid ""
11933 " char **\n"
11934 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11935 "                                  const char *root);\n"
11936 "\n"
11937 msgstr ""
11938
11939 # type: textblock
11940 #. type: textblock
11941 #: ../src/guestfs-actions.pod:2682 ../fish/guestfish-actions.pod:1831
11942 msgid ""
11943 "This returns a list of all the filesystems that we think are associated with "
11944 "this operating system.  This includes the root filesystem, other ordinary "
11945 "filesystems, and non-mounted devices like swap partitions."
11946 msgstr ""
11947
11948 # type: textblock
11949 #. type: textblock
11950 #: ../src/guestfs-actions.pod:2687 ../fish/guestfish-actions.pod:1836
11951 msgid ""
11952 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11953 "to be shared between operating systems."
11954 msgstr ""
11955
11956 # type: textblock
11957 #. type: textblock
11958 #: ../src/guestfs-actions.pod:2690
11959 msgid ""
11960 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11961 "C<guestfs_inspect_get_mountpoints>."
11962 msgstr ""
11963
11964 #. type: =head2
11965 #: ../src/guestfs-actions.pod:2699
11966 msgid "guestfs_inspect_get_format"
11967 msgstr ""
11968
11969 #. type: verbatim
11970 #: ../src/guestfs-actions.pod:2701
11971 #, no-wrap
11972 msgid ""
11973 " char *\n"
11974 " guestfs_inspect_get_format (guestfs_h *g,\n"
11975 "                             const char *root);\n"
11976 "\n"
11977 msgstr ""
11978
11979 #. type: textblock
11980 #: ../src/guestfs-actions.pod:2708 ../fish/guestfish-actions.pod:1849
11981 msgid ""
11982 "This returns the format of the inspected operating system.  You can use it "
11983 "to detect install images, live CDs and similar."
11984 msgstr ""
11985
11986 #. type: textblock
11987 #: ../src/guestfs-actions.pod:2711 ../fish/guestfish-actions.pod:1852
11988 msgid "Currently defined formats are:"
11989 msgstr ""
11990
11991 #. type: =item
11992 #: ../src/guestfs-actions.pod:2715 ../fish/guestfish-actions.pod:1856
11993 msgid "\"installed\""
11994 msgstr ""
11995
11996 #. type: textblock
11997 #: ../src/guestfs-actions.pod:2717 ../fish/guestfish-actions.pod:1858
11998 msgid "This is an installed operating system."
11999 msgstr ""
12000
12001 #. type: =item
12002 #: ../src/guestfs-actions.pod:2719 ../fish/guestfish-actions.pod:1860
12003 msgid "\"installer\""
12004 msgstr ""
12005
12006 #. type: textblock
12007 #: ../src/guestfs-actions.pod:2721 ../fish/guestfish-actions.pod:1862
12008 msgid ""
12009 "The disk image being inspected is not an installed operating system, but a "
12010 "I<bootable> install disk, live CD, or similar."
12011 msgstr ""
12012
12013 #. type: textblock
12014 #: ../src/guestfs-actions.pod:2726 ../fish/guestfish-actions.pod:1867
12015 msgid "The format of this disk image is not known."
12016 msgstr ""
12017
12018 # type: =head2
12019 #. type: =head2
12020 #: ../src/guestfs-actions.pod:2738
12021 msgid "guestfs_inspect_get_hostname"
12022 msgstr ""
12023
12024 # type: verbatim
12025 #. type: verbatim
12026 #: ../src/guestfs-actions.pod:2740
12027 #, no-wrap
12028 msgid ""
12029 " char *\n"
12030 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
12031 "                               const char *root);\n"
12032 "\n"
12033 msgstr ""
12034
12035 # type: textblock
12036 #. type: textblock
12037 #: ../src/guestfs-actions.pod:2747 ../fish/guestfish-actions.pod:1883
12038 msgid ""
12039 "This function returns the hostname of the operating system as found by "
12040 "inspection of the guest's configuration files."
12041 msgstr ""
12042
12043 # type: textblock
12044 #. type: textblock
12045 #: ../src/guestfs-actions.pod:2750 ../fish/guestfish-actions.pod:1886
12046 msgid ""
12047 "If the hostname could not be determined, then the string C<unknown> is "
12048 "returned."
12049 msgstr ""
12050
12051 # type: textblock
12052 #. type: textblock
12053 #: ../src/guestfs-actions.pod:2758
12054 msgid "(Added in 1.7.9)"
12055 msgstr ""
12056
12057 # type: =head2
12058 #. type: =head2
12059 #: ../src/guestfs-actions.pod:2760
12060 msgid "guestfs_inspect_get_major_version"
12061 msgstr ""
12062
12063 # type: verbatim
12064 #. type: verbatim
12065 #: ../src/guestfs-actions.pod:2762
12066 #, no-wrap
12067 msgid ""
12068 " int\n"
12069 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
12070 "                                    const char *root);\n"
12071 "\n"
12072 msgstr ""
12073
12074 # type: textblock
12075 #. type: textblock
12076 #: ../src/guestfs-actions.pod:2769 ../fish/guestfish-actions.pod:1898
12077 msgid ""
12078 "This returns the major version number of the inspected operating system."
12079 msgstr ""
12080
12081 # type: textblock
12082 #. type: textblock
12083 #: ../src/guestfs-actions.pod:2772 ../fish/guestfish-actions.pod:1901
12084 msgid ""
12085 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
12086 "popular public names used by the operating system.  Notably the operating "
12087 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
12088 "1).  You can find out the real versions corresponding to releases of Windows "
12089 "by consulting Wikipedia or MSDN."
12090 msgstr ""
12091
12092 # type: textblock
12093 #. type: textblock
12094 #: ../src/guestfs-actions.pod:2779 ../src/guestfs-actions.pod:2799
12095 #: ../fish/guestfish-actions.pod:1908 ../fish/guestfish-actions.pod:1922
12096 msgid "If the version could not be determined, then C<0> is returned."
12097 msgstr ""
12098
12099 # type: =head2
12100 #. type: =head2
12101 #: ../src/guestfs-actions.pod:2787
12102 msgid "guestfs_inspect_get_minor_version"
12103 msgstr ""
12104
12105 # type: verbatim
12106 #. type: verbatim
12107 #: ../src/guestfs-actions.pod:2789
12108 #, no-wrap
12109 msgid ""
12110 " int\n"
12111 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
12112 "                                    const char *root);\n"
12113 "\n"
12114 msgstr ""
12115
12116 # type: textblock
12117 #. type: textblock
12118 #: ../src/guestfs-actions.pod:2796 ../fish/guestfish-actions.pod:1919
12119 msgid ""
12120 "This returns the minor version number of the inspected operating system."
12121 msgstr ""
12122
12123 # type: textblock
12124 #. type: textblock
12125 #: ../src/guestfs-actions.pod:2801
12126 msgid ""
12127 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12128 "C<guestfs_inspect_get_major_version>."
12129 msgstr ""
12130
12131 # type: =head2
12132 #. type: =head2
12133 #: ../src/guestfs-actions.pod:2808
12134 msgid "guestfs_inspect_get_mountpoints"
12135 msgstr ""
12136
12137 # type: verbatim
12138 #. type: verbatim
12139 #: ../src/guestfs-actions.pod:2810
12140 #, no-wrap
12141 msgid ""
12142 " char **\n"
12143 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
12144 "                                  const char *root);\n"
12145 "\n"
12146 msgstr ""
12147
12148 #. type: textblock
12149 #: ../src/guestfs-actions.pod:2817 ../fish/guestfish-actions.pod:1934
12150 msgid ""
12151 "This returns a hash of where we think the filesystems associated with this "
12152 "operating system should be mounted.  Callers should note that this is at "
12153 "best an educated guess made by reading configuration files such as C</etc/"
12154 "fstab>.  I<In particular note> that this may return filesystems which are "
12155 "non-existent or not mountable and callers should be prepared to handle or "
12156 "ignore failures if they try to mount them."
12157 msgstr ""
12158
12159 # type: textblock
12160 #. type: textblock
12161 #: ../src/guestfs-actions.pod:2826 ../fish/guestfish-actions.pod:1943
12162 msgid ""
12163 "Each element in the returned hashtable has a key which is the path of the "
12164 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
12165 "mounted there (eg. C</dev/sda1>)."
12166 msgstr ""
12167
12168 # type: textblock
12169 #. type: textblock
12170 #: ../src/guestfs-actions.pod:2831 ../fish/guestfish-actions.pod:1948
12171 msgid ""
12172 "Non-mounted devices such as swap devices are I<not> returned in this list."
12173 msgstr ""
12174
12175 #. type: textblock
12176 #: ../src/guestfs-actions.pod:2834
12177 msgid ""
12178 "For operating systems like Windows which still use drive letters, this call "
12179 "will only return an entry for the first drive \"mounted on\" C</>.  For "
12180 "information about the mapping of drive letters to partitions, see "
12181 "C<guestfs_inspect_get_drive_mappings>."
12182 msgstr ""
12183
12184 # type: textblock
12185 #. type: textblock
12186 #: ../src/guestfs-actions.pod:2840
12187 msgid ""
12188 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12189 "C<guestfs_inspect_get_filesystems>."
12190 msgstr ""
12191
12192 # type: =head2
12193 #. type: =head2
12194 #: ../src/guestfs-actions.pod:2851
12195 msgid "guestfs_inspect_get_package_format"
12196 msgstr ""
12197
12198 # type: verbatim
12199 #. type: verbatim
12200 #: ../src/guestfs-actions.pod:2853
12201 #, no-wrap
12202 msgid ""
12203 " char *\n"
12204 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
12205 "                                     const char *root);\n"
12206 "\n"
12207 msgstr ""
12208
12209 # type: textblock
12210 #. type: textblock
12211 #: ../src/guestfs-actions.pod:2860
12212 msgid ""
12213 "This function and C<guestfs_inspect_get_package_management> return the "
12214 "package format and package management tool used by the inspected operating "
12215 "system.  For example for Fedora these functions would return C<rpm> (package "
12216 "format) and C<yum> (package management)."
12217 msgstr ""
12218
12219 # type: textblock
12220 #. type: textblock
12221 #: ../src/guestfs-actions.pod:2866 ../fish/guestfish-actions.pod:1973
12222 msgid ""
12223 "This returns the string C<unknown> if we could not determine the package "
12224 "format I<or> if the operating system does not have a real packaging system "
12225 "(eg. Windows)."
12226 msgstr ""
12227
12228 # type: textblock
12229 #. type: textblock
12230 #: ../src/guestfs-actions.pod:2870 ../fish/guestfish-actions.pod:1977
12231 msgid ""
12232 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
12233 "Future versions of libguestfs may return other strings."
12234 msgstr ""
12235
12236 # type: textblock
12237 #. type: textblock
12238 #: ../src/guestfs-actions.pod:2878 ../src/guestfs-actions.pod:2909
12239 msgid "(Added in 1.7.5)"
12240 msgstr ""
12241
12242 # type: =head2
12243 #. type: =head2
12244 #: ../src/guestfs-actions.pod:2880
12245 msgid "guestfs_inspect_get_package_management"
12246 msgstr ""
12247
12248 # type: verbatim
12249 #. type: verbatim
12250 #: ../src/guestfs-actions.pod:2882
12251 #, no-wrap
12252 msgid ""
12253 " char *\n"
12254 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
12255 "                                         const char *root);\n"
12256 "\n"
12257 msgstr ""
12258
12259 # type: textblock
12260 #. type: textblock
12261 #: ../src/guestfs-actions.pod:2889
12262 msgid ""
12263 "C<guestfs_inspect_get_package_format> and this function return the package "
12264 "format and package management tool used by the inspected operating system.  "
12265 "For example for Fedora these functions would return C<rpm> (package format) "
12266 "and C<yum> (package management)."
12267 msgstr ""
12268
12269 # type: textblock
12270 #. type: textblock
12271 #: ../src/guestfs-actions.pod:2895 ../fish/guestfish-actions.pod:1995
12272 msgid ""
12273 "This returns the string C<unknown> if we could not determine the package "
12274 "management tool I<or> if the operating system does not have a real packaging "
12275 "system (eg. Windows)."
12276 msgstr ""
12277
12278 # type: textblock
12279 #. type: textblock
12280 #: ../src/guestfs-actions.pod:2899 ../fish/guestfish-actions.pod:1999
12281 msgid ""
12282 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
12283 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
12284 "libguestfs may return other strings."
12285 msgstr ""
12286
12287 # type: =head2
12288 #. type: =head2
12289 #: ../src/guestfs-actions.pod:2911
12290 msgid "guestfs_inspect_get_product_name"
12291 msgstr ""
12292
12293 # type: verbatim
12294 #. type: verbatim
12295 #: ../src/guestfs-actions.pod:2913
12296 #, no-wrap
12297 msgid ""
12298 " char *\n"
12299 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
12300 "                                   const char *root);\n"
12301 "\n"
12302 msgstr ""
12303
12304 # type: textblock
12305 #. type: textblock
12306 #: ../src/guestfs-actions.pod:2920 ../fish/guestfish-actions.pod:2013
12307 msgid ""
12308 "This returns the product name of the inspected operating system.  The "
12309 "product name is generally some freeform string which can be displayed to the "
12310 "user, but should not be parsed by programs."
12311 msgstr ""
12312
12313 # type: textblock
12314 #. type: textblock
12315 #: ../src/guestfs-actions.pod:2925 ../fish/guestfish-actions.pod:2018
12316 msgid ""
12317 "If the product name could not be determined, then the string C<unknown> is "
12318 "returned."
12319 msgstr ""
12320
12321 #. type: =head2
12322 #: ../src/guestfs-actions.pod:2935
12323 msgid "guestfs_inspect_get_product_variant"
12324 msgstr ""
12325
12326 #. type: verbatim
12327 #: ../src/guestfs-actions.pod:2937
12328 #, no-wrap
12329 msgid ""
12330 " char *\n"
12331 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
12332 "                                      const char *root);\n"
12333 "\n"
12334 msgstr ""
12335
12336 #. type: textblock
12337 #: ../src/guestfs-actions.pod:2944 ../fish/guestfish-actions.pod:2030
12338 msgid "This returns the product variant of the inspected operating system."
12339 msgstr ""
12340
12341 #. type: textblock
12342 #: ../src/guestfs-actions.pod:2947 ../fish/guestfish-actions.pod:2033
12343 msgid ""
12344 "For Windows guests, this returns the contents of the Registry key C<HKLM"
12345 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
12346 "is usually a string such as C<Client> or C<Server> (other values are "
12347 "possible).  This can be used to distinguish consumer and enterprise versions "
12348 "of Windows that have the same version number (for example, Windows 7 and "
12349 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
12350 "the latter is C<Server>)."
12351 msgstr ""
12352
12353 #. type: textblock
12354 #: ../src/guestfs-actions.pod:2956 ../fish/guestfish-actions.pod:2042
12355 msgid ""
12356 "For enterprise Linux guests, in future we intend this to return the product "
12357 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
12358 "implemented at present."
12359 msgstr ""
12360
12361 #. type: textblock
12362 #: ../src/guestfs-actions.pod:2960 ../fish/guestfish-actions.pod:2046
12363 msgid ""
12364 "If the product variant could not be determined, then the string C<unknown> "
12365 "is returned."
12366 msgstr ""
12367
12368 #. type: textblock
12369 #: ../src/guestfs-actions.pod:2963
12370 msgid ""
12371 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12372 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
12373 msgstr ""
12374
12375 # type: =head2
12376 #. type: =head2
12377 #: ../src/guestfs-actions.pod:2970
12378 msgid "guestfs_inspect_get_roots"
12379 msgstr ""
12380
12381 # type: verbatim
12382 #. type: verbatim
12383 #: ../src/guestfs-actions.pod:2972
12384 #, no-wrap
12385 msgid ""
12386 " char **\n"
12387 " guestfs_inspect_get_roots (guestfs_h *g);\n"
12388 "\n"
12389 msgstr ""
12390
12391 # type: textblock
12392 #. type: textblock
12393 #: ../src/guestfs-actions.pod:2975
12394 msgid ""
12395 "This function is a convenient way to get the list of root devices, as "
12396 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
12397 "the whole inspection process."
12398 msgstr ""
12399
12400 # type: textblock
12401 #. type: textblock
12402 #: ../src/guestfs-actions.pod:2979
12403 msgid ""
12404 "This returns an empty list if either no root devices were found or the "
12405 "caller has not called C<guestfs_inspect_os>."
12406 msgstr ""
12407
12408 # type: textblock
12409 #. type: textblock
12410 #: ../src/guestfs-actions.pod:2988
12411 msgid "(Added in 1.7.3)"
12412 msgstr ""
12413
12414 # type: =head2
12415 #. type: =head2
12416 #: ../src/guestfs-actions.pod:2990
12417 msgid "guestfs_inspect_get_type"
12418 msgstr ""
12419
12420 # type: verbatim
12421 #. type: verbatim
12422 #: ../src/guestfs-actions.pod:2992
12423 #, no-wrap
12424 msgid ""
12425 " char *\n"
12426 " guestfs_inspect_get_type (guestfs_h *g,\n"
12427 "                           const char *root);\n"
12428 "\n"
12429 msgstr ""
12430
12431 # type: textblock
12432 #. type: textblock
12433 #: ../src/guestfs-actions.pod:2999 ../fish/guestfish-actions.pod:2073
12434 msgid ""
12435 "This returns the type of the inspected operating system.  Currently defined "
12436 "types are:"
12437 msgstr ""
12438
12439 # type: =item
12440 #. type: =item
12441 #: ../src/guestfs-actions.pod:3004 ../fish/guestfish-actions.pod:2078
12442 msgid "\"linux\""
12443 msgstr ""
12444
12445 # type: textblock
12446 #. type: textblock
12447 #: ../src/guestfs-actions.pod:3006 ../fish/guestfish-actions.pod:2080
12448 msgid "Any Linux-based operating system."
12449 msgstr ""
12450
12451 # type: textblock
12452 #. type: textblock
12453 #: ../src/guestfs-actions.pod:3010 ../fish/guestfish-actions.pod:2084
12454 msgid "Any Microsoft Windows operating system."
12455 msgstr ""
12456
12457 # type: =item
12458 #. type: =item
12459 #: ../src/guestfs-actions.pod:3012 ../fish/guestfish-actions.pod:2086
12460 msgid "\"freebsd\""
12461 msgstr ""
12462
12463 # type: textblock
12464 #. type: textblock
12465 #: ../src/guestfs-actions.pod:3014 ../fish/guestfish-actions.pod:2088
12466 msgid "FreeBSD."
12467 msgstr ""
12468
12469 # type: textblock
12470 #. type: textblock
12471 #: ../src/guestfs-actions.pod:3018 ../fish/guestfish-actions.pod:2092
12472 msgid "The operating system type could not be determined."
12473 msgstr ""
12474
12475 #. type: =head2
12476 #: ../src/guestfs-actions.pod:3032
12477 msgid "guestfs_inspect_get_windows_current_control_set"
12478 msgstr ""
12479
12480 #. type: verbatim
12481 #: ../src/guestfs-actions.pod:3034
12482 #, no-wrap
12483 msgid ""
12484 " char *\n"
12485 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
12486 "                                                  const char *root);\n"
12487 "\n"
12488 msgstr ""
12489
12490 #. type: textblock
12491 #: ../src/guestfs-actions.pod:3041 ../fish/guestfish-actions.pod:2108
12492 msgid ""
12493 "This returns the Windows CurrentControlSet of the inspected guest.  The "
12494 "CurrentControlSet is a registry key name such as C<ControlSet001>."
12495 msgstr ""
12496
12497 #. type: textblock
12498 #: ../src/guestfs-actions.pod:3044 ../fish/guestfish-actions.pod:2111
12499 msgid ""
12500 "This call assumes that the guest is Windows and that the Registry could be "
12501 "examined by inspection.  If this is not the case then an error is returned."
12502 msgstr ""
12503
12504 # type: =head2
12505 #. type: =head2
12506 #: ../src/guestfs-actions.pod:3053
12507 msgid "guestfs_inspect_get_windows_systemroot"
12508 msgstr ""
12509
12510 # type: verbatim
12511 #. type: verbatim
12512 #: ../src/guestfs-actions.pod:3055
12513 #, no-wrap
12514 msgid ""
12515 " char *\n"
12516 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
12517 "                                         const char *root);\n"
12518 "\n"
12519 msgstr ""
12520
12521 # type: textblock
12522 #. type: textblock
12523 #: ../src/guestfs-actions.pod:3062 ../fish/guestfish-actions.pod:2124
12524 msgid ""
12525 "This returns the Windows systemroot of the inspected guest.  The systemroot "
12526 "is a directory path such as C</WINDOWS>."
12527 msgstr ""
12528
12529 # type: textblock
12530 #. type: textblock
12531 #: ../src/guestfs-actions.pod:3065 ../fish/guestfish-actions.pod:2127
12532 msgid ""
12533 "This call assumes that the guest is Windows and that the systemroot could be "
12534 "determined by inspection.  If this is not the case then an error is returned."
12535 msgstr ""
12536
12537 # type: textblock
12538 #. type: textblock
12539 #: ../src/guestfs-actions.pod:3074
12540 msgid "(Added in 1.5.25)"
12541 msgstr ""
12542
12543 #. type: =head2
12544 #: ../src/guestfs-actions.pod:3076
12545 msgid "guestfs_inspect_is_live"
12546 msgstr ""
12547
12548 #. type: verbatim
12549 #: ../src/guestfs-actions.pod:3078
12550 #, no-wrap
12551 msgid ""
12552 " int\n"
12553 " guestfs_inspect_is_live (guestfs_h *g,\n"
12554 "                          const char *root);\n"
12555 "\n"
12556 msgstr ""
12557
12558 #. type: textblock
12559 #: ../src/guestfs-actions.pod:3085
12560 msgid ""
12561 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12562 "disk), then this returns true if a live image was detected on the disk."
12563 msgstr ""
12564
12565 #. type: =head2
12566 #: ../src/guestfs-actions.pod:3093
12567 msgid "guestfs_inspect_is_multipart"
12568 msgstr ""
12569
12570 #. type: verbatim
12571 #: ../src/guestfs-actions.pod:3095
12572 #, no-wrap
12573 msgid ""
12574 " int\n"
12575 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
12576 "                               const char *root);\n"
12577 "\n"
12578 msgstr ""
12579
12580 #. type: textblock
12581 #: ../src/guestfs-actions.pod:3102
12582 msgid ""
12583 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12584 "disk), then this returns true if the disk is part of a set."
12585 msgstr ""
12586
12587 #. type: =head2
12588 #: ../src/guestfs-actions.pod:3110
12589 msgid "guestfs_inspect_is_netinst"
12590 msgstr ""
12591
12592 #. type: verbatim
12593 #: ../src/guestfs-actions.pod:3112
12594 #, no-wrap
12595 msgid ""
12596 " int\n"
12597 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
12598 "                             const char *root);\n"
12599 "\n"
12600 msgstr ""
12601
12602 #. type: textblock
12603 #: ../src/guestfs-actions.pod:3119
12604 msgid ""
12605 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12606 "disk), then this returns true if the disk is a network installer, ie. not a "
12607 "self-contained install CD but one which is likely to require network access "
12608 "to complete the install."
12609 msgstr ""
12610
12611 # type: =head2
12612 #. type: =head2
12613 #: ../src/guestfs-actions.pod:3129
12614 msgid "guestfs_inspect_list_applications"
12615 msgstr ""
12616
12617 # type: verbatim
12618 #. type: verbatim
12619 #: ../src/guestfs-actions.pod:3131
12620 #, no-wrap
12621 msgid ""
12622 " struct guestfs_application_list *\n"
12623 " guestfs_inspect_list_applications (guestfs_h *g,\n"
12624 "                                    const char *root);\n"
12625 "\n"
12626 msgstr ""
12627
12628 # type: textblock
12629 #. type: textblock
12630 #: ../src/guestfs-actions.pod:3138 ../fish/guestfish-actions.pod:2181
12631 msgid "Return the list of applications installed in the operating system."
12632 msgstr ""
12633
12634 # type: textblock
12635 #. type: textblock
12636 #: ../src/guestfs-actions.pod:3140
12637 msgid ""
12638 "I<Note:> This call works differently from other parts of the inspection "
12639 "API.  You have to call C<guestfs_inspect_os>, then "
12640 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
12641 "this.  Listing applications is a significantly more difficult operation "
12642 "which requires access to the full filesystem.  Also note that unlike the "
12643 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
12644 "the libguestfs handle, this call actually reads parts of the mounted "
12645 "filesystems during the call."
12646 msgstr ""
12647
12648 # type: textblock
12649 #. type: textblock
12650 #: ../src/guestfs-actions.pod:3150 ../fish/guestfish-actions.pod:2193
12651 msgid ""
12652 "This returns an empty list if the inspection code was not able to determine "
12653 "the list of applications."
12654 msgstr ""
12655
12656 # type: textblock
12657 #. type: textblock
12658 #: ../src/guestfs-actions.pod:3153 ../fish/guestfish-actions.pod:2196
12659 msgid "The application structure contains the following fields:"
12660 msgstr ""
12661
12662 # type: =item
12663 #. type: =item
12664 #: ../src/guestfs-actions.pod:3157 ../fish/guestfish-actions.pod:2200
12665 msgid "C<app_name>"
12666 msgstr ""
12667
12668 # type: textblock
12669 #. type: textblock
12670 #: ../src/guestfs-actions.pod:3159 ../fish/guestfish-actions.pod:2202
12671 msgid ""
12672 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
12673 "guests, this is the package name."
12674 msgstr ""
12675
12676 # type: =item
12677 #. type: =item
12678 #: ../src/guestfs-actions.pod:3162 ../fish/guestfish-actions.pod:2205
12679 msgid "C<app_display_name>"
12680 msgstr ""
12681
12682 # type: textblock
12683 #. type: textblock
12684 #: ../src/guestfs-actions.pod:3164 ../fish/guestfish-actions.pod:2207
12685 msgid ""
12686 "The display name of the application, sometimes localized to the install "
12687 "language of the guest operating system."
12688 msgstr ""
12689
12690 # type: textblock
12691 #. type: textblock
12692 #: ../src/guestfs-actions.pod:3167 ../fish/guestfish-actions.pod:2210
12693 msgid ""
12694 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
12695 "to display something can use C<app_name> instead."
12696 msgstr ""
12697
12698 # type: =item
12699 #. type: =item
12700 #: ../src/guestfs-actions.pod:3170 ../fish/guestfish-actions.pod:2213
12701 msgid "C<app_epoch>"
12702 msgstr ""
12703
12704 # type: textblock
12705 #. type: textblock
12706 #: ../src/guestfs-actions.pod:3172 ../fish/guestfish-actions.pod:2215
12707 msgid ""
12708 "For package managers which use epochs, this contains the epoch of the "
12709 "package (an integer).  If unavailable, this is returned as C<0>."
12710 msgstr ""
12711
12712 # type: =item
12713 #. type: =item
12714 #: ../src/guestfs-actions.pod:3175 ../fish/guestfish-actions.pod:2218
12715 msgid "C<app_version>"
12716 msgstr ""
12717
12718 # type: textblock
12719 #. type: textblock
12720 #: ../src/guestfs-actions.pod:3177 ../fish/guestfish-actions.pod:2220
12721 msgid ""
12722 "The version string of the application or package.  If unavailable this is "
12723 "returned as an empty string C<\"\">."
12724 msgstr ""
12725
12726 # type: =item
12727 #. type: =item
12728 #: ../src/guestfs-actions.pod:3180 ../fish/guestfish-actions.pod:2223
12729 msgid "C<app_release>"
12730 msgstr ""
12731
12732 # type: textblock
12733 #. type: textblock
12734 #: ../src/guestfs-actions.pod:3182 ../fish/guestfish-actions.pod:2225
12735 msgid ""
12736 "The release string of the application or package, for package managers that "
12737 "use this.  If unavailable this is returned as an empty string C<\"\">."
12738 msgstr ""
12739
12740 # type: =item
12741 #. type: =item
12742 #: ../src/guestfs-actions.pod:3186 ../fish/guestfish-actions.pod:2229
12743 msgid "C<app_install_path>"
12744 msgstr ""
12745
12746 # type: textblock
12747 #. type: textblock
12748 #: ../src/guestfs-actions.pod:3188 ../fish/guestfish-actions.pod:2231
12749 msgid ""
12750 "The installation path of the application (on operating systems such as "
12751 "Windows which use installation paths).  This path is in the format used by "
12752 "the guest operating system, it is not a libguestfs path."
12753 msgstr ""
12754
12755 # type: textblock
12756 #. type: textblock
12757 #: ../src/guestfs-actions.pod:3193 ../fish/guestfish-actions.pod:2236
12758 msgid "If unavailable this is returned as an empty string C<\"\">."
12759 msgstr ""
12760
12761 # type: =item
12762 #. type: =item
12763 #: ../src/guestfs-actions.pod:3195 ../fish/guestfish-actions.pod:2238
12764 msgid "C<app_trans_path>"
12765 msgstr ""
12766
12767 # type: textblock
12768 #. type: textblock
12769 #: ../src/guestfs-actions.pod:3197 ../fish/guestfish-actions.pod:2240
12770 msgid ""
12771 "The install path translated into a libguestfs path.  If unavailable this is "
12772 "returned as an empty string C<\"\">."
12773 msgstr ""
12774
12775 # type: =item
12776 #. type: =item
12777 #: ../src/guestfs-actions.pod:3200 ../fish/guestfish-actions.pod:2243
12778 msgid "C<app_publisher>"
12779 msgstr ""
12780
12781 # type: textblock
12782 #. type: textblock
12783 #: ../src/guestfs-actions.pod:3202 ../fish/guestfish-actions.pod:2245
12784 msgid ""
12785 "The name of the publisher of the application, for package managers that use "
12786 "this.  If unavailable this is returned as an empty string C<\"\">."
12787 msgstr ""
12788
12789 # type: =item
12790 #. type: =item
12791 #: ../src/guestfs-actions.pod:3206 ../fish/guestfish-actions.pod:2249
12792 msgid "C<app_url>"
12793 msgstr ""
12794
12795 # type: textblock
12796 #. type: textblock
12797 #: ../src/guestfs-actions.pod:3208 ../fish/guestfish-actions.pod:2251
12798 msgid ""
12799 "The URL (eg. upstream URL) of the application.  If unavailable this is "
12800 "returned as an empty string C<\"\">."
12801 msgstr ""
12802
12803 # type: =item
12804 #. type: =item
12805 #: ../src/guestfs-actions.pod:3211 ../fish/guestfish-actions.pod:2254
12806 msgid "C<app_source_package>"
12807 msgstr ""
12808
12809 # type: textblock
12810 #. type: textblock
12811 #: ../src/guestfs-actions.pod:3213 ../fish/guestfish-actions.pod:2256
12812 msgid ""
12813 "For packaging systems which support this, the name of the source package.  "
12814 "If unavailable this is returned as an empty string C<\"\">."
12815 msgstr ""
12816
12817 # type: =item
12818 #. type: =item
12819 #: ../src/guestfs-actions.pod:3216 ../fish/guestfish-actions.pod:2259
12820 msgid "C<app_summary>"
12821 msgstr ""
12822
12823 # type: textblock
12824 #. type: textblock
12825 #: ../src/guestfs-actions.pod:3218 ../fish/guestfish-actions.pod:2261
12826 msgid ""
12827 "A short (usually one line) description of the application or package.  If "
12828 "unavailable this is returned as an empty string C<\"\">."
12829 msgstr ""
12830
12831 # type: =item
12832 #. type: =item
12833 #: ../src/guestfs-actions.pod:3221 ../fish/guestfish-actions.pod:2264
12834 msgid "C<app_description>"
12835 msgstr ""
12836
12837 # type: textblock
12838 #. type: textblock
12839 #: ../src/guestfs-actions.pod:3223 ../fish/guestfish-actions.pod:2266
12840 msgid ""
12841 "A longer description of the application or package.  If unavailable this is "
12842 "returned as an empty string C<\"\">."
12843 msgstr ""
12844
12845 # type: textblock
12846 #. type: textblock
12847 #: ../src/guestfs-actions.pod:3230
12848 msgid ""
12849 "This function returns a C<struct guestfs_application_list *>, or NULL if "
12850 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
12851 "after use>."
12852 msgstr ""
12853
12854 # type: textblock
12855 #. type: textblock
12856 #: ../src/guestfs-actions.pod:3234
12857 msgid "(Added in 1.7.8)"
12858 msgstr ""
12859
12860 # type: =head2
12861 #. type: =head2
12862 #: ../src/guestfs-actions.pod:3236
12863 msgid "guestfs_inspect_os"
12864 msgstr ""
12865
12866 # type: verbatim
12867 #. type: verbatim
12868 #: ../src/guestfs-actions.pod:3238
12869 #, no-wrap
12870 msgid ""
12871 " char **\n"
12872 " guestfs_inspect_os (guestfs_h *g);\n"
12873 "\n"
12874 msgstr ""
12875
12876 # type: textblock
12877 #. type: textblock
12878 #: ../src/guestfs-actions.pod:3241 ../fish/guestfish-actions.pod:2277
12879 msgid ""
12880 "This function uses other libguestfs functions and certain heuristics to "
12881 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
12882 "for operating systems."
12883 msgstr ""
12884
12885 # type: textblock
12886 #. type: textblock
12887 #: ../src/guestfs-actions.pod:3245 ../fish/guestfish-actions.pod:2281
12888 msgid "The list returned is empty if no operating systems were found."
12889 msgstr ""
12890
12891 # type: textblock
12892 #. type: textblock
12893 #: ../src/guestfs-actions.pod:3247 ../fish/guestfish-actions.pod:2283
12894 msgid ""
12895 "If one operating system was found, then this returns a list with a single "
12896 "element, which is the name of the root filesystem of this operating system.  "
12897 "It is also possible for this function to return a list containing more than "
12898 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
12899 "element being the root filesystem of one of the operating systems."
12900 msgstr ""
12901
12902 # type: textblock
12903 #. type: textblock
12904 #: ../src/guestfs-actions.pod:3254
12905 msgid ""
12906 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
12907 "functions in order to query further information about each operating system, "
12908 "such as the name and version."
12909 msgstr ""
12910
12911 # type: textblock
12912 #. type: textblock
12913 #: ../src/guestfs-actions.pod:3259
12914 msgid ""
12915 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
12916 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
12917 "the contents.  This should be called with no disks currently mounted.  The "
12918 "function may also use Augeas, so any existing Augeas handle will be closed."
12919 msgstr ""
12920
12921 # type: textblock
12922 #. type: textblock
12923 #: ../src/guestfs-actions.pod:3265 ../fish/guestfish-actions.pod:2301
12924 msgid ""
12925 "This function cannot decrypt encrypted disks.  The caller must do that first "
12926 "(supplying the necessary keys) if the disk is encrypted."
12927 msgstr ""
12928
12929 # type: textblock
12930 #. type: textblock
12931 #: ../src/guestfs-actions.pod:3271 ../src/guestfs-actions.pod:3584
12932 #: ../src/guestfs-actions.pod:3646
12933 msgid "See also C<guestfs_list_filesystems>."
12934 msgstr ""
12935
12936 # type: =head2
12937 #. type: =head2
12938 #: ../src/guestfs-actions.pod:3279
12939 msgid "guestfs_is_blockdev"
12940 msgstr ""
12941
12942 # type: verbatim
12943 #. type: verbatim
12944 #: ../src/guestfs-actions.pod:3281
12945 #, no-wrap
12946 msgid ""
12947 " int\n"
12948 " guestfs_is_blockdev (guestfs_h *g,\n"
12949 "                      const char *path);\n"
12950 "\n"
12951 msgstr ""
12952
12953 # type: textblock
12954 #. type: textblock
12955 #: ../src/guestfs-actions.pod:3285 ../fish/guestfish-actions.pod:2313
12956 msgid ""
12957 "This returns C<true> if and only if there is a block device with the given "
12958 "C<path> name."
12959 msgstr ""
12960
12961 # type: textblock
12962 #. type: textblock
12963 #: ../src/guestfs-actions.pod:3288 ../src/guestfs-actions.pod:3317
12964 #: ../src/guestfs-actions.pod:3347 ../src/guestfs-actions.pod:3362
12965 #: ../src/guestfs-actions.pod:3378 ../src/guestfs-actions.pod:3434
12966 #: ../src/guestfs-actions.pod:3449
12967 msgid "See also C<guestfs_stat>."
12968 msgstr ""
12969
12970 # type: textblock
12971 #. type: textblock
12972 #: ../src/guestfs-actions.pod:3292 ../src/guestfs-actions.pod:3321
12973 #: ../src/guestfs-actions.pod:3366 ../src/guestfs-actions.pod:3438
12974 #: ../src/guestfs-actions.pod:3453
12975 msgid "(Added in 1.5.10)"
12976 msgstr ""
12977
12978 # type: =head2
12979 #. type: =head2
12980 #: ../src/guestfs-actions.pod:3294
12981 msgid "guestfs_is_busy"
12982 msgstr ""
12983
12984 # type: verbatim
12985 #. type: verbatim
12986 #: ../src/guestfs-actions.pod:3296
12987 #, no-wrap
12988 msgid ""
12989 " int\n"
12990 " guestfs_is_busy (guestfs_h *g);\n"
12991 "\n"
12992 msgstr ""
12993
12994 # type: textblock
12995 #. type: textblock
12996 #: ../src/guestfs-actions.pod:3299 ../fish/guestfish-actions.pod:2322
12997 msgid ""
12998 "This returns true iff this handle is busy processing a command (in the "
12999 "C<BUSY> state)."
13000 msgstr ""
13001
13002 # type: =head2
13003 #. type: =head2
13004 #: ../src/guestfs-actions.pod:3308
13005 msgid "guestfs_is_chardev"
13006 msgstr ""
13007
13008 # type: verbatim
13009 #. type: verbatim
13010 #: ../src/guestfs-actions.pod:3310
13011 #, no-wrap
13012 msgid ""
13013 " int\n"
13014 " guestfs_is_chardev (guestfs_h *g,\n"
13015 "                     const char *path);\n"
13016 "\n"
13017 msgstr ""
13018
13019 # type: textblock
13020 #. type: textblock
13021 #: ../src/guestfs-actions.pod:3314 ../fish/guestfish-actions.pod:2331
13022 msgid ""
13023 "This returns C<true> if and only if there is a character device with the "
13024 "given C<path> name."
13025 msgstr ""
13026
13027 # type: =head2
13028 #. type: =head2
13029 #: ../src/guestfs-actions.pod:3323
13030 msgid "guestfs_is_config"
13031 msgstr ""
13032
13033 # type: verbatim
13034 #. type: verbatim
13035 #: ../src/guestfs-actions.pod:3325
13036 #, no-wrap
13037 msgid ""
13038 " int\n"
13039 " guestfs_is_config (guestfs_h *g);\n"
13040 "\n"
13041 msgstr ""
13042
13043 # type: textblock
13044 #. type: textblock
13045 #: ../src/guestfs-actions.pod:3328 ../fish/guestfish-actions.pod:2340
13046 msgid ""
13047 "This returns true iff this handle is being configured (in the C<CONFIG> "
13048 "state)."
13049 msgstr ""
13050
13051 # type: =head2
13052 #. type: =head2
13053 #: ../src/guestfs-actions.pod:3337
13054 msgid "guestfs_is_dir"
13055 msgstr ""
13056
13057 # type: verbatim
13058 #. type: verbatim
13059 #: ../src/guestfs-actions.pod:3339
13060 #, no-wrap
13061 msgid ""
13062 " int\n"
13063 " guestfs_is_dir (guestfs_h *g,\n"
13064 "                 const char *path);\n"
13065 "\n"
13066 msgstr ""
13067
13068 # type: textblock
13069 #. type: textblock
13070 #: ../src/guestfs-actions.pod:3343 ../fish/guestfish-actions.pod:2349
13071 msgid ""
13072 "This returns C<true> if and only if there is a directory with the given "
13073 "C<path> name.  Note that it returns false for other objects like files."
13074 msgstr ""
13075
13076 # type: =head2
13077 #. type: =head2
13078 #: ../src/guestfs-actions.pod:3353
13079 msgid "guestfs_is_fifo"
13080 msgstr ""
13081
13082 # type: verbatim
13083 #. type: verbatim
13084 #: ../src/guestfs-actions.pod:3355
13085 #, no-wrap
13086 msgid ""
13087 " int\n"
13088 " guestfs_is_fifo (guestfs_h *g,\n"
13089 "                  const char *path);\n"
13090 "\n"
13091 msgstr ""
13092
13093 # type: textblock
13094 #. type: textblock
13095 #: ../src/guestfs-actions.pod:3359 ../fish/guestfish-actions.pod:2359
13096 msgid ""
13097 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
13098 "given C<path> name."
13099 msgstr ""
13100
13101 # type: =head2
13102 #. type: =head2
13103 #: ../src/guestfs-actions.pod:3368
13104 msgid "guestfs_is_file"
13105 msgstr ""
13106
13107 # type: verbatim
13108 #. type: verbatim
13109 #: ../src/guestfs-actions.pod:3370
13110 #, no-wrap
13111 msgid ""
13112 " int\n"
13113 " guestfs_is_file (guestfs_h *g,\n"
13114 "                  const char *path);\n"
13115 "\n"
13116 msgstr ""
13117
13118 # type: textblock
13119 #. type: textblock
13120 #: ../src/guestfs-actions.pod:3374 ../fish/guestfish-actions.pod:2368
13121 msgid ""
13122 "This returns C<true> if and only if there is a regular file with the given "
13123 "C<path> name.  Note that it returns false for other objects like directories."
13124 msgstr ""
13125
13126 # type: =head2
13127 #. type: =head2
13128 #: ../src/guestfs-actions.pod:3384
13129 msgid "guestfs_is_launching"
13130 msgstr ""
13131
13132 # type: verbatim
13133 #. type: verbatim
13134 #: ../src/guestfs-actions.pod:3386
13135 #, no-wrap
13136 msgid ""
13137 " int\n"
13138 " guestfs_is_launching (guestfs_h *g);\n"
13139 "\n"
13140 msgstr ""
13141
13142 # type: textblock
13143 #. type: textblock
13144 #: ../src/guestfs-actions.pod:3389 ../fish/guestfish-actions.pod:2378
13145 msgid ""
13146 "This returns true iff this handle is launching the subprocess (in the "
13147 "C<LAUNCHING> state)."
13148 msgstr ""
13149
13150 # type: =head2
13151 #. type: =head2
13152 #: ../src/guestfs-actions.pod:3398
13153 msgid "guestfs_is_lv"
13154 msgstr ""
13155
13156 # type: verbatim
13157 #. type: verbatim
13158 #: ../src/guestfs-actions.pod:3400
13159 #, no-wrap
13160 msgid ""
13161 " int\n"
13162 " guestfs_is_lv (guestfs_h *g,\n"
13163 "                const char *device);\n"
13164 "\n"
13165 msgstr ""
13166
13167 # type: textblock
13168 #. type: textblock
13169 #: ../src/guestfs-actions.pod:3404 ../fish/guestfish-actions.pod:2387
13170 msgid ""
13171 "This command tests whether C<device> is a logical volume, and returns true "
13172 "iff this is the case."
13173 msgstr ""
13174
13175 # type: =head2
13176 #. type: =head2
13177 #: ../src/guestfs-actions.pod:3411
13178 msgid "guestfs_is_ready"
13179 msgstr ""
13180
13181 # type: verbatim
13182 #. type: verbatim
13183 #: ../src/guestfs-actions.pod:3413
13184 #, no-wrap
13185 msgid ""
13186 " int\n"
13187 " guestfs_is_ready (guestfs_h *g);\n"
13188 "\n"
13189 msgstr ""
13190
13191 # type: textblock
13192 #. type: textblock
13193 #: ../src/guestfs-actions.pod:3416 ../fish/guestfish-actions.pod:2394
13194 msgid ""
13195 "This returns true iff this handle is ready to accept commands (in the "
13196 "C<READY> state)."
13197 msgstr ""
13198
13199 # type: =head2
13200 #. type: =head2
13201 #: ../src/guestfs-actions.pod:3425
13202 msgid "guestfs_is_socket"
13203 msgstr ""
13204
13205 # type: verbatim
13206 #. type: verbatim
13207 #: ../src/guestfs-actions.pod:3427
13208 #, no-wrap
13209 msgid ""
13210 " int\n"
13211 " guestfs_is_socket (guestfs_h *g,\n"
13212 "                    const char *path);\n"
13213 "\n"
13214 msgstr ""
13215
13216 # type: textblock
13217 #. type: textblock
13218 #: ../src/guestfs-actions.pod:3431 ../fish/guestfish-actions.pod:2403
13219 msgid ""
13220 "This returns C<true> if and only if there is a Unix domain socket with the "
13221 "given C<path> name."
13222 msgstr ""
13223
13224 # type: =head2
13225 #. type: =head2
13226 #: ../src/guestfs-actions.pod:3440
13227 msgid "guestfs_is_symlink"
13228 msgstr ""
13229
13230 # type: verbatim
13231 #. type: verbatim
13232 #: ../src/guestfs-actions.pod:3442
13233 #, no-wrap
13234 msgid ""
13235 " int\n"
13236 " guestfs_is_symlink (guestfs_h *g,\n"
13237 "                     const char *path);\n"
13238 "\n"
13239 msgstr ""
13240
13241 # type: textblock
13242 #. type: textblock
13243 #: ../src/guestfs-actions.pod:3446 ../fish/guestfish-actions.pod:2412
13244 msgid ""
13245 "This returns C<true> if and only if there is a symbolic link with the given "
13246 "C<path> name."
13247 msgstr ""
13248
13249 #. type: =head2
13250 #: ../src/guestfs-actions.pod:3455
13251 msgid "guestfs_is_zero"
13252 msgstr ""
13253
13254 #. type: verbatim
13255 #: ../src/guestfs-actions.pod:3457
13256 #, no-wrap
13257 msgid ""
13258 " int\n"
13259 " guestfs_is_zero (guestfs_h *g,\n"
13260 "                  const char *path);\n"
13261 "\n"
13262 msgstr ""
13263
13264 #. type: textblock
13265 #: ../src/guestfs-actions.pod:3461 ../fish/guestfish-actions.pod:2421
13266 msgid ""
13267 "This returns true iff the file exists and the file is empty or it contains "
13268 "all zero bytes."
13269 msgstr ""
13270
13271 #. type: =head2
13272 #: ../src/guestfs-actions.pod:3466
13273 msgid "guestfs_is_zero_device"
13274 msgstr ""
13275
13276 #. type: verbatim
13277 #: ../src/guestfs-actions.pod:3468
13278 #, no-wrap
13279 msgid ""
13280 " int\n"
13281 " guestfs_is_zero_device (guestfs_h *g,\n"
13282 "                         const char *device);\n"
13283 "\n"
13284 msgstr ""
13285
13286 #. type: textblock
13287 #: ../src/guestfs-actions.pod:3472 ../fish/guestfish-actions.pod:2428
13288 msgid "This returns true iff the device exists and contains all zero bytes."
13289 msgstr ""
13290
13291 #. type: textblock
13292 #: ../src/guestfs-actions.pod:3474 ../fish/guestfish-actions.pod:2430
13293 msgid "Note that for large devices this can take a long time to run."
13294 msgstr ""
13295
13296 # type: =head2
13297 #. type: =head2
13298 #: ../src/guestfs-actions.pod:3478
13299 msgid "guestfs_kill_subprocess"
13300 msgstr ""
13301
13302 # type: verbatim
13303 #. type: verbatim
13304 #: ../src/guestfs-actions.pod:3480
13305 #, no-wrap
13306 msgid ""
13307 " int\n"
13308 " guestfs_kill_subprocess (guestfs_h *g);\n"
13309 "\n"
13310 msgstr ""
13311
13312 # type: textblock
13313 #. type: textblock
13314 #: ../src/guestfs-actions.pod:3483 ../fish/guestfish-actions.pod:2436
13315 msgid "This kills the qemu subprocess.  You should never need to call this."
13316 msgstr ""
13317
13318 # type: =head2
13319 #. type: =head2
13320 #: ../src/guestfs-actions.pod:3489
13321 msgid "guestfs_launch"
13322 msgstr ""
13323
13324 # type: verbatim
13325 #. type: verbatim
13326 #: ../src/guestfs-actions.pod:3491
13327 #, no-wrap
13328 msgid ""
13329 " int\n"
13330 " guestfs_launch (guestfs_h *g);\n"
13331 "\n"
13332 msgstr ""
13333
13334 # type: textblock
13335 #. type: textblock
13336 #: ../src/guestfs-actions.pod:3494 ../fish/guestfish-actions.pod:2444
13337 msgid ""
13338 "Internally libguestfs is implemented by running a virtual machine using "
13339 "L<qemu(1)>."
13340 msgstr ""
13341
13342 # type: textblock
13343 #. type: textblock
13344 #: ../src/guestfs-actions.pod:3497 ../fish/guestfish-actions.pod:2447
13345 msgid ""
13346 "You should call this after configuring the handle (eg. adding drives) but "
13347 "before performing any actions."
13348 msgstr ""
13349
13350 # type: =head2
13351 #. type: =head2
13352 #: ../src/guestfs-actions.pod:3509
13353 msgid "guestfs_lchown"
13354 msgstr ""
13355
13356 # type: verbatim
13357 #. type: verbatim
13358 #: ../src/guestfs-actions.pod:3511
13359 #, no-wrap
13360 msgid ""
13361 " int\n"
13362 " guestfs_lchown (guestfs_h *g,\n"
13363 "                 int owner,\n"
13364 "                 int group,\n"
13365 "                 const char *path);\n"
13366 "\n"
13367 msgstr ""
13368
13369 # type: textblock
13370 #. type: textblock
13371 #: ../src/guestfs-actions.pod:3517
13372 msgid ""
13373 "Change the file owner to C<owner> and group to C<group>.  This is like "
13374 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
13375 "changed, not the target."
13376 msgstr ""
13377
13378 # type: =head2
13379 #. type: =head2
13380 #: ../src/guestfs-actions.pod:3529
13381 msgid "guestfs_lgetxattr"
13382 msgstr ""
13383
13384 # type: verbatim
13385 #. type: verbatim
13386 #: ../src/guestfs-actions.pod:3531
13387 #, no-wrap
13388 msgid ""
13389 " char *\n"
13390 " guestfs_lgetxattr (guestfs_h *g,\n"
13391 "                    const char *path,\n"
13392 "                    const char *name,\n"
13393 "                    size_t *size_r);\n"
13394 "\n"
13395 msgstr ""
13396
13397 # type: textblock
13398 #. type: textblock
13399 #: ../src/guestfs-actions.pod:3537 ../fish/guestfish-actions.pod:2466
13400 msgid ""
13401 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
13402 "is a symlink, then this call returns an extended attribute from the symlink."
13403 msgstr ""
13404
13405 # type: textblock
13406 #. type: textblock
13407 #: ../src/guestfs-actions.pod:3551
13408 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
13409 msgstr ""
13410
13411 # type: =head2
13412 #. type: =head2
13413 #: ../src/guestfs-actions.pod:3559
13414 msgid "guestfs_lgetxattrs"
13415 msgstr ""
13416
13417 # type: verbatim
13418 #. type: verbatim
13419 #: ../src/guestfs-actions.pod:3561
13420 #, no-wrap
13421 msgid ""
13422 " struct guestfs_xattr_list *\n"
13423 " guestfs_lgetxattrs (guestfs_h *g,\n"
13424 "                     const char *path);\n"
13425 "\n"
13426 msgstr ""
13427
13428 # type: textblock
13429 #. type: textblock
13430 #: ../src/guestfs-actions.pod:3565
13431 msgid ""
13432 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
13433 "then it returns the extended attributes of the link itself."
13434 msgstr ""
13435
13436 # type: =head2
13437 #. type: =head2
13438 #: ../src/guestfs-actions.pod:3575
13439 msgid "guestfs_list_devices"
13440 msgstr ""
13441
13442 # type: verbatim
13443 #. type: verbatim
13444 #: ../src/guestfs-actions.pod:3577
13445 #, no-wrap
13446 msgid ""
13447 " char **\n"
13448 " guestfs_list_devices (guestfs_h *g);\n"
13449 "\n"
13450 msgstr ""
13451
13452 # type: textblock
13453 #. type: textblock
13454 #: ../src/guestfs-actions.pod:3580 ../fish/guestfish-actions.pod:2494
13455 msgid "List all the block devices."
13456 msgstr ""
13457
13458 # type: textblock
13459 #. type: textblock
13460 #: ../src/guestfs-actions.pod:3582 ../fish/guestfish-actions.pod:2496
13461 msgid "The full block device names are returned, eg. C</dev/sda>."
13462 msgstr ""
13463
13464 # type: =head2
13465 #. type: =head2
13466 #: ../src/guestfs-actions.pod:3592
13467 msgid "guestfs_list_filesystems"
13468 msgstr ""
13469
13470 # type: verbatim
13471 #. type: verbatim
13472 #: ../src/guestfs-actions.pod:3594
13473 #, no-wrap
13474 msgid ""
13475 " char **\n"
13476 " guestfs_list_filesystems (guestfs_h *g);\n"
13477 "\n"
13478 msgstr ""
13479
13480 # type: textblock
13481 #. type: textblock
13482 #: ../src/guestfs-actions.pod:3597 ../fish/guestfish-actions.pod:2504
13483 msgid ""
13484 "This inspection command looks for filesystems on partitions, block devices "
13485 "and logical volumes, returning a list of devices containing filesystems and "
13486 "their type."
13487 msgstr ""
13488
13489 # type: textblock
13490 #. type: textblock
13491 #: ../src/guestfs-actions.pod:3601 ../fish/guestfish-actions.pod:2508
13492 msgid ""
13493 "The return value is a hash, where the keys are the devices containing "
13494 "filesystems, and the values are the filesystem types.  For example:"
13495 msgstr ""
13496
13497 # type: verbatim
13498 #. type: verbatim
13499 #: ../src/guestfs-actions.pod:3605 ../fish/guestfish-actions.pod:2512
13500 #, no-wrap
13501 msgid ""
13502 " \"/dev/sda1\" => \"ntfs\"\n"
13503 " \"/dev/sda2\" => \"ext2\"\n"
13504 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
13505 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
13506 "\n"
13507 msgstr ""
13508
13509 # type: textblock
13510 #. type: textblock
13511 #: ../src/guestfs-actions.pod:3610 ../fish/guestfish-actions.pod:2517
13512 msgid ""
13513 "The value can have the special value \"unknown\", meaning the content of the "
13514 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
13515 msgstr ""
13516
13517 # type: textblock
13518 #. type: textblock
13519 #: ../src/guestfs-actions.pod:3614
13520 msgid ""
13521 "This command runs other libguestfs commands, which might include "
13522 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
13523 "soon after launch and only when nothing is mounted."
13524 msgstr ""
13525
13526 # type: textblock
13527 #. type: textblock
13528 #: ../src/guestfs-actions.pod:3618
13529 msgid ""
13530 "Not all of the filesystems returned will be mountable.  In particular, swap "
13531 "partitions are returned in the list.  Also this command does not check that "
13532 "each filesystem found is valid and mountable, and some filesystems might be "
13533 "mountable but require special options.  Filesystems may not all belong to a "
13534 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
13535 msgstr ""
13536
13537 # type: textblock
13538 #. type: textblock
13539 #: ../src/guestfs-actions.pod:3632 ../src/guestfs-actions.pod:5244
13540 msgid "(Added in 1.5.15)"
13541 msgstr ""
13542
13543 # type: =head2
13544 #. type: =head2
13545 #: ../src/guestfs-actions.pod:3634
13546 msgid "guestfs_list_partitions"
13547 msgstr ""
13548
13549 # type: verbatim
13550 #. type: verbatim
13551 #: ../src/guestfs-actions.pod:3636
13552 #, no-wrap
13553 msgid ""
13554 " char **\n"
13555 " guestfs_list_partitions (guestfs_h *g);\n"
13556 "\n"
13557 msgstr ""
13558
13559 # type: textblock
13560 #. type: textblock
13561 #: ../src/guestfs-actions.pod:3639 ../fish/guestfish-actions.pod:2537
13562 msgid "List all the partitions detected on all block devices."
13563 msgstr ""
13564
13565 # type: textblock
13566 #. type: textblock
13567 #: ../src/guestfs-actions.pod:3641 ../fish/guestfish-actions.pod:2539
13568 msgid "The full partition device names are returned, eg. C</dev/sda1>"
13569 msgstr ""
13570
13571 # type: textblock
13572 #. type: textblock
13573 #: ../src/guestfs-actions.pod:3643
13574 msgid ""
13575 "This does not return logical volumes.  For that you will need to call "
13576 "C<guestfs_lvs>."
13577 msgstr ""
13578
13579 # type: =head2
13580 #. type: =head2
13581 #: ../src/guestfs-actions.pod:3654
13582 msgid "guestfs_ll"
13583 msgstr ""
13584
13585 # type: verbatim
13586 #. type: verbatim
13587 #: ../src/guestfs-actions.pod:3656
13588 #, no-wrap
13589 msgid ""
13590 " char *\n"
13591 " guestfs_ll (guestfs_h *g,\n"
13592 "             const char *directory);\n"
13593 "\n"
13594 msgstr ""
13595
13596 # type: textblock
13597 #. type: textblock
13598 #: ../src/guestfs-actions.pod:3660 ../fish/guestfish-actions.pod:2550
13599 msgid ""
13600 "List the files in C<directory> (relative to the root directory, there is no "
13601 "cwd) in the format of 'ls -la'."
13602 msgstr ""
13603
13604 # type: textblock
13605 #. type: textblock
13606 #: ../src/guestfs-actions.pod:3663 ../fish/guestfish-actions.pod:2553
13607 msgid ""
13608 "This command is mostly useful for interactive sessions.  It is I<not> "
13609 "intended that you try to parse the output string."
13610 msgstr ""
13611
13612 # type: =head2
13613 #. type: =head2
13614 #: ../src/guestfs-actions.pod:3671
13615 msgid "guestfs_ln"
13616 msgstr ""
13617
13618 # type: verbatim
13619 #. type: verbatim
13620 #: ../src/guestfs-actions.pod:3673
13621 #, no-wrap
13622 msgid ""
13623 " int\n"
13624 " guestfs_ln (guestfs_h *g,\n"
13625 "             const char *target,\n"
13626 "             const char *linkname);\n"
13627 "\n"
13628 msgstr ""
13629
13630 # type: textblock
13631 #. type: textblock
13632 #: ../src/guestfs-actions.pod:3678 ../fish/guestfish-actions.pod:2560
13633 msgid "This command creates a hard link using the C<ln> command."
13634 msgstr ""
13635
13636 # type: =head2
13637 #. type: =head2
13638 #: ../src/guestfs-actions.pod:3684
13639 msgid "guestfs_ln_f"
13640 msgstr ""
13641
13642 # type: verbatim
13643 #. type: verbatim
13644 #: ../src/guestfs-actions.pod:3686
13645 #, no-wrap
13646 msgid ""
13647 " int\n"
13648 " guestfs_ln_f (guestfs_h *g,\n"
13649 "               const char *target,\n"
13650 "               const char *linkname);\n"
13651 "\n"
13652 msgstr ""
13653
13654 #. type: textblock
13655 #: ../src/guestfs-actions.pod:3691 ../fish/guestfish-actions.pod:2566
13656 msgid ""
13657 "This command creates a hard link using the C<ln -f> command.  The I<-f> "
13658 "option removes the link (C<linkname>) if it exists already."
13659 msgstr ""
13660
13661 # type: =head2
13662 #. type: =head2
13663 #: ../src/guestfs-actions.pod:3698
13664 msgid "guestfs_ln_s"
13665 msgstr ""
13666
13667 # type: verbatim
13668 #. type: verbatim
13669 #: ../src/guestfs-actions.pod:3700
13670 #, no-wrap
13671 msgid ""
13672 " int\n"
13673 " guestfs_ln_s (guestfs_h *g,\n"
13674 "               const char *target,\n"
13675 "               const char *linkname);\n"
13676 "\n"
13677 msgstr ""
13678
13679 # type: textblock
13680 #. type: textblock
13681 #: ../src/guestfs-actions.pod:3705 ../fish/guestfish-actions.pod:2573
13682 msgid "This command creates a symbolic link using the C<ln -s> command."
13683 msgstr ""
13684
13685 # type: =head2
13686 #. type: =head2
13687 #: ../src/guestfs-actions.pod:3711
13688 msgid "guestfs_ln_sf"
13689 msgstr ""
13690
13691 # type: verbatim
13692 #. type: verbatim
13693 #: ../src/guestfs-actions.pod:3713
13694 #, no-wrap
13695 msgid ""
13696 " int\n"
13697 " guestfs_ln_sf (guestfs_h *g,\n"
13698 "                const char *target,\n"
13699 "                const char *linkname);\n"
13700 "\n"
13701 msgstr ""
13702
13703 #. type: textblock
13704 #: ../src/guestfs-actions.pod:3718 ../fish/guestfish-actions.pod:2579
13705 msgid ""
13706 "This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
13707 "option removes the link (C<linkname>) if it exists already."
13708 msgstr ""
13709
13710 # type: =head2
13711 #. type: =head2
13712 #: ../src/guestfs-actions.pod:3725
13713 msgid "guestfs_lremovexattr"
13714 msgstr ""
13715
13716 # type: verbatim
13717 #. type: verbatim
13718 #: ../src/guestfs-actions.pod:3727
13719 #, no-wrap
13720 msgid ""
13721 " int\n"
13722 " guestfs_lremovexattr (guestfs_h *g,\n"
13723 "                       const char *xattr,\n"
13724 "                       const char *path);\n"
13725 "\n"
13726 msgstr ""
13727
13728 # type: textblock
13729 #. type: textblock
13730 #: ../src/guestfs-actions.pod:3732
13731 msgid ""
13732 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
13733 "link, then it removes an extended attribute of the link itself."
13734 msgstr ""
13735
13736 # type: =head2
13737 #. type: =head2
13738 #: ../src/guestfs-actions.pod:3740
13739 msgid "guestfs_ls"
13740 msgstr ""
13741
13742 # type: verbatim
13743 #. type: verbatim
13744 #: ../src/guestfs-actions.pod:3742
13745 #, no-wrap
13746 msgid ""
13747 " char **\n"
13748 " guestfs_ls (guestfs_h *g,\n"
13749 "             const char *directory);\n"
13750 "\n"
13751 msgstr ""
13752
13753 # type: textblock
13754 #. type: textblock
13755 #: ../src/guestfs-actions.pod:3746 ../fish/guestfish-actions.pod:2594
13756 msgid ""
13757 "List the files in C<directory> (relative to the root directory, there is no "
13758 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
13759 msgstr ""
13760
13761 # type: textblock
13762 #. type: textblock
13763 #: ../src/guestfs-actions.pod:3750
13764 msgid ""
13765 "This command is mostly useful for interactive sessions.  Programs should "
13766 "probably use C<guestfs_readdir> instead."
13767 msgstr ""
13768
13769 # type: =head2
13770 #. type: =head2
13771 #: ../src/guestfs-actions.pod:3759
13772 msgid "guestfs_lsetxattr"
13773 msgstr ""
13774
13775 # type: verbatim
13776 #. type: verbatim
13777 #: ../src/guestfs-actions.pod:3761
13778 #, no-wrap
13779 msgid ""
13780 " int\n"
13781 " guestfs_lsetxattr (guestfs_h *g,\n"
13782 "                    const char *xattr,\n"
13783 "                    const char *val,\n"
13784 "                    int vallen,\n"
13785 "                    const char *path);\n"
13786 "\n"
13787 msgstr ""
13788
13789 # type: textblock
13790 #. type: textblock
13791 #: ../src/guestfs-actions.pod:3768
13792 msgid ""
13793 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
13794 "then it sets an extended attribute of the link itself."
13795 msgstr ""
13796
13797 # type: =head2
13798 #. type: =head2
13799 #: ../src/guestfs-actions.pod:3776
13800 msgid "guestfs_lstat"
13801 msgstr ""
13802
13803 # type: verbatim
13804 #. type: verbatim
13805 #: ../src/guestfs-actions.pod:3778
13806 #, no-wrap
13807 msgid ""
13808 " struct guestfs_stat *\n"
13809 " guestfs_lstat (guestfs_h *g,\n"
13810 "                const char *path);\n"
13811 "\n"
13812 msgstr ""
13813
13814 # type: textblock
13815 #. type: textblock
13816 #: ../src/guestfs-actions.pod:3782 ../src/guestfs-actions.pod:6375
13817 #: ../fish/guestfish-actions.pod:2613 ../fish/guestfish-actions.pod:4317
13818 msgid "Returns file information for the given C<path>."
13819 msgstr ""
13820
13821 # type: textblock
13822 #. type: textblock
13823 #: ../src/guestfs-actions.pod:3784
13824 msgid ""
13825 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
13826 "link, then the link is stat-ed, not the file it refers to."
13827 msgstr ""
13828
13829 # type: textblock
13830 #. type: textblock
13831 #: ../src/guestfs-actions.pod:3788 ../fish/guestfish-actions.pod:2619
13832 msgid "This is the same as the C<lstat(2)> system call."
13833 msgstr ""
13834
13835 # type: textblock
13836 #. type: textblock
13837 #: ../src/guestfs-actions.pod:3790 ../src/guestfs-actions.pod:6379
13838 msgid ""
13839 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
13840 "error.  I<The caller must call C<guestfs_free_stat> after use>."
13841 msgstr ""
13842
13843 # type: textblock
13844 #. type: textblock
13845 #: ../src/guestfs-actions.pod:3794 ../src/guestfs-actions.pod:6383
13846 #: ../src/guestfs-actions.pod:6401 ../src/guestfs-actions.pod:6782
13847 msgid "(Added in 0.9.2)"
13848 msgstr ""
13849
13850 # type: =head2
13851 #. type: =head2
13852 #: ../src/guestfs-actions.pod:3796
13853 msgid "guestfs_lstatlist"
13854 msgstr ""
13855
13856 # type: verbatim
13857 #. type: verbatim
13858 #: ../src/guestfs-actions.pod:3798
13859 #, no-wrap
13860 msgid ""
13861 " struct guestfs_stat_list *\n"
13862 " guestfs_lstatlist (guestfs_h *g,\n"
13863 "                    const char *path,\n"
13864 "                    char *const *names);\n"
13865 "\n"
13866 msgstr ""
13867
13868 # type: textblock
13869 #. type: textblock
13870 #: ../src/guestfs-actions.pod:3803
13871 msgid ""
13872 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
13873 "files, where all files are in the directory C<path>.  C<names> is the list "
13874 "of files from this directory."
13875 msgstr ""
13876
13877 # type: textblock
13878 #. type: textblock
13879 #: ../src/guestfs-actions.pod:3807 ../fish/guestfish-actions.pod:2629
13880 msgid ""
13881 "On return you get a list of stat structs, with a one-to-one correspondence "
13882 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
13883 "then the C<ino> field of that structure is set to C<-1>."
13884 msgstr ""
13885
13886 # type: textblock
13887 #. type: textblock
13888 #: ../src/guestfs-actions.pod:3812
13889 msgid ""
13890 "This call is intended for programs that want to efficiently list a directory "
13891 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
13892 "for a similarly efficient call for getting extended attributes.  Very long "
13893 "directory listings might cause the protocol message size to be exceeded, "
13894 "causing this call to fail.  The caller must split up such requests into "
13895 "smaller groups of names."
13896 msgstr ""
13897
13898 # type: textblock
13899 #. type: textblock
13900 #: ../src/guestfs-actions.pod:3820
13901 msgid ""
13902 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
13903 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
13904 msgstr ""
13905
13906 # type: =head2
13907 #. type: =head2
13908 #: ../src/guestfs-actions.pod:3826
13909 msgid "guestfs_luks_add_key"
13910 msgstr ""
13911
13912 # type: verbatim
13913 #. type: verbatim
13914 #: ../src/guestfs-actions.pod:3828
13915 #, no-wrap
13916 msgid ""
13917 " int\n"
13918 " guestfs_luks_add_key (guestfs_h *g,\n"
13919 "                       const char *device,\n"
13920 "                       const char *key,\n"
13921 "                       const char *newkey,\n"
13922 "                       int keyslot);\n"
13923 "\n"
13924 msgstr ""
13925
13926 # type: textblock
13927 #. type: textblock
13928 #: ../src/guestfs-actions.pod:3835 ../fish/guestfish-actions.pod:2646
13929 msgid ""
13930 "This command adds a new key on LUKS device C<device>.  C<key> is any "
13931 "existing key, and is used to access the device.  C<newkey> is the new key to "
13932 "add.  C<keyslot> is the key slot that will be replaced."
13933 msgstr ""
13934
13935 # type: textblock
13936 #. type: textblock
13937 #: ../src/guestfs-actions.pod:3840
13938 msgid ""
13939 "Note that if C<keyslot> already contains a key, then this command will "
13940 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
13941 msgstr ""
13942
13943 # type: textblock
13944 #. type: textblock
13945 #: ../src/guestfs-actions.pod:3846 ../src/guestfs-actions.pod:3886
13946 #: ../src/guestfs-actions.pod:3909 ../src/guestfs-actions.pod:3929
13947 #: ../src/guestfs-actions.pod:3961 ../src/guestfs-actions.pod:3980
13948 msgid ""
13949 "This function takes a key or passphrase parameter which could contain "
13950 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
13951 "information."
13952 msgstr ""
13953
13954 # type: textblock
13955 #. type: textblock
13956 #: ../src/guestfs-actions.pod:3850 ../src/guestfs-actions.pod:3890
13957 #: ../src/guestfs-actions.pod:3913 ../src/guestfs-actions.pod:3933
13958 msgid "(Added in 1.5.2)"
13959 msgstr ""
13960
13961 # type: =head2
13962 #. type: =head2
13963 #: ../src/guestfs-actions.pod:3852
13964 msgid "guestfs_luks_close"
13965 msgstr ""
13966
13967 # type: verbatim
13968 #. type: verbatim
13969 #: ../src/guestfs-actions.pod:3854
13970 #, no-wrap
13971 msgid ""
13972 " int\n"
13973 " guestfs_luks_close (guestfs_h *g,\n"
13974 "                     const char *device);\n"
13975 "\n"
13976 msgstr ""
13977
13978 # type: textblock
13979 #. type: textblock
13980 #: ../src/guestfs-actions.pod:3858
13981 msgid ""
13982 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
13983 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
13984 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
13985 "underlying block device."
13986 msgstr ""
13987
13988 # type: textblock
13989 #. type: textblock
13990 #: ../src/guestfs-actions.pod:3866 ../src/guestfs-actions.pod:3965
13991 #: ../src/guestfs-actions.pod:3984 ../src/guestfs-actions.pod:4034
13992 #: ../src/guestfs-actions.pod:4082
13993 msgid "(Added in 1.5.1)"
13994 msgstr ""
13995
13996 # type: =head2
13997 #. type: =head2
13998 #: ../src/guestfs-actions.pod:3868
13999 msgid "guestfs_luks_format"
14000 msgstr ""
14001
14002 # type: verbatim
14003 #. type: verbatim
14004 #: ../src/guestfs-actions.pod:3870
14005 #, no-wrap
14006 msgid ""
14007 " int\n"
14008 " guestfs_luks_format (guestfs_h *g,\n"
14009 "                      const char *device,\n"
14010 "                      const char *key,\n"
14011 "                      int keyslot);\n"
14012 "\n"
14013 msgstr ""
14014
14015 # type: textblock
14016 #. type: textblock
14017 #: ../src/guestfs-actions.pod:3876 ../fish/guestfish-actions.pod:2672
14018 msgid ""
14019 "This command erases existing data on C<device> and formats the device as a "
14020 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
14021 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
14022 msgstr ""
14023
14024 # type: textblock
14025 #. type: textblock
14026 #: ../src/guestfs-actions.pod:3883 ../src/guestfs-actions.pod:3906
14027 #: ../src/guestfs-actions.pod:4046 ../src/guestfs-actions.pod:4995
14028 #: ../src/guestfs-actions.pod:5775 ../src/guestfs-actions.pod:6182
14029 #: ../src/guestfs-actions.pod:6212 ../src/guestfs-actions.pod:6245
14030 #: ../src/guestfs-actions.pod:7427 ../fish/guestfish-actions.pod:2680
14031 #: ../fish/guestfish-actions.pod:2693 ../fish/guestfish-actions.pod:2777
14032 #: ../fish/guestfish-actions.pod:3358 ../fish/guestfish-actions.pod:3878
14033 #: ../fish/guestfish-actions.pod:4188 ../fish/guestfish-actions.pod:4211
14034 #: ../fish/guestfish-actions.pod:4233 ../fish/guestfish-actions.pod:4963
14035 msgid ""
14036 "B<This command is dangerous.  Without careful use you can easily destroy all "
14037 "your data>."
14038 msgstr ""
14039
14040 # type: =head2
14041 #. type: =head2
14042 #: ../src/guestfs-actions.pod:3892
14043 msgid "guestfs_luks_format_cipher"
14044 msgstr ""
14045
14046 # type: verbatim
14047 #. type: verbatim
14048 #: ../src/guestfs-actions.pod:3894
14049 #, no-wrap
14050 msgid ""
14051 " int\n"
14052 " guestfs_luks_format_cipher (guestfs_h *g,\n"
14053 "                             const char *device,\n"
14054 "                             const char *key,\n"
14055 "                             int keyslot,\n"
14056 "                             const char *cipher);\n"
14057 "\n"
14058 msgstr ""
14059
14060 # type: textblock
14061 #. type: textblock
14062 #: ../src/guestfs-actions.pod:3901
14063 msgid ""
14064 "This command is the same as C<guestfs_luks_format> but it also allows you to "
14065 "set the C<cipher> used."
14066 msgstr ""
14067
14068 # type: =head2
14069 #. type: =head2
14070 #: ../src/guestfs-actions.pod:3915
14071 msgid "guestfs_luks_kill_slot"
14072 msgstr ""
14073
14074 # type: verbatim
14075 #. type: verbatim
14076 #: ../src/guestfs-actions.pod:3917
14077 #, no-wrap
14078 msgid ""
14079 " int\n"
14080 " guestfs_luks_kill_slot (guestfs_h *g,\n"
14081 "                         const char *device,\n"
14082 "                         const char *key,\n"
14083 "                         int keyslot);\n"
14084 "\n"
14085 msgstr ""
14086
14087 # type: textblock
14088 #. type: textblock
14089 #: ../src/guestfs-actions.pod:3923 ../fish/guestfish-actions.pod:2700
14090 msgid ""
14091 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
14092 "device C<device>.  C<key> must be one of the I<other> keys."
14093 msgstr ""
14094
14095 # type: =head2
14096 #. type: =head2
14097 #: ../src/guestfs-actions.pod:3935
14098 msgid "guestfs_luks_open"
14099 msgstr ""
14100
14101 # type: verbatim
14102 #. type: verbatim
14103 #: ../src/guestfs-actions.pod:3937
14104 #, no-wrap
14105 msgid ""
14106 " int\n"
14107 " guestfs_luks_open (guestfs_h *g,\n"
14108 "                    const char *device,\n"
14109 "                    const char *key,\n"
14110 "                    const char *mapname);\n"
14111 "\n"
14112 msgstr ""
14113
14114 # type: textblock
14115 #. type: textblock
14116 #: ../src/guestfs-actions.pod:3943 ../fish/guestfish-actions.pod:2711
14117 msgid ""
14118 "This command opens a block device which has been encrypted according to the "
14119 "Linux Unified Key Setup (LUKS) standard."
14120 msgstr ""
14121
14122 # type: textblock
14123 #. type: textblock
14124 #: ../src/guestfs-actions.pod:3946 ../fish/guestfish-actions.pod:2714
14125 msgid "C<device> is the encrypted block device or partition."
14126 msgstr ""
14127
14128 # type: textblock
14129 #. type: textblock
14130 #: ../src/guestfs-actions.pod:3948 ../fish/guestfish-actions.pod:2716
14131 msgid ""
14132 "The caller must supply one of the keys associated with the LUKS block "
14133 "device, in the C<key> parameter."
14134 msgstr ""
14135
14136 # type: textblock
14137 #. type: textblock
14138 #: ../src/guestfs-actions.pod:3951 ../fish/guestfish-actions.pod:2719
14139 msgid ""
14140 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
14141 "writes to this block device are decrypted from and encrypted to the "
14142 "underlying C<device> respectively."
14143 msgstr ""
14144
14145 # type: textblock
14146 #. type: textblock
14147 #: ../src/guestfs-actions.pod:3955
14148 msgid ""
14149 "If this block device contains LVM volume groups, then calling "
14150 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
14151 "visible."
14152 msgstr ""
14153
14154 # type: =head2
14155 #. type: =head2
14156 #: ../src/guestfs-actions.pod:3967
14157 msgid "guestfs_luks_open_ro"
14158 msgstr ""
14159
14160 # type: verbatim
14161 #. type: verbatim
14162 #: ../src/guestfs-actions.pod:3969
14163 #, no-wrap
14164 msgid ""
14165 " int\n"
14166 " guestfs_luks_open_ro (guestfs_h *g,\n"
14167 "                       const char *device,\n"
14168 "                       const char *key,\n"
14169 "                       const char *mapname);\n"
14170 "\n"
14171 msgstr ""
14172
14173 # type: textblock
14174 #. type: textblock
14175 #: ../src/guestfs-actions.pod:3975
14176 msgid ""
14177 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
14178 "created."
14179 msgstr ""
14180
14181 # type: =head2
14182 #. type: =head2
14183 #: ../src/guestfs-actions.pod:3986
14184 msgid "guestfs_lvcreate"
14185 msgstr ""
14186
14187 # type: verbatim
14188 #. type: verbatim
14189 #: ../src/guestfs-actions.pod:3988
14190 #, no-wrap
14191 msgid ""
14192 " int\n"
14193 " guestfs_lvcreate (guestfs_h *g,\n"
14194 "                   const char *logvol,\n"
14195 "                   const char *volgroup,\n"
14196 "                   int mbytes);\n"
14197 "\n"
14198 msgstr ""
14199
14200 # type: textblock
14201 #. type: textblock
14202 #: ../src/guestfs-actions.pod:3994 ../fish/guestfish-actions.pod:2744
14203 msgid ""
14204 "This creates an LVM logical volume called C<logvol> on the volume group "
14205 "C<volgroup>, with C<size> megabytes."
14206 msgstr ""
14207
14208 # type: =head2
14209 #. type: =head2
14210 #: ../src/guestfs-actions.pod:4001
14211 msgid "guestfs_lvm_canonical_lv_name"
14212 msgstr ""
14213
14214 # type: verbatim
14215 #. type: verbatim
14216 #: ../src/guestfs-actions.pod:4003
14217 #, no-wrap
14218 msgid ""
14219 " char *\n"
14220 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
14221 "                                const char *lvname);\n"
14222 "\n"
14223 msgstr ""
14224
14225 # type: textblock
14226 #. type: textblock
14227 #: ../src/guestfs-actions.pod:4007 ../fish/guestfish-actions.pod:2751
14228 msgid ""
14229 "This converts alternative naming schemes for LVs that you might find to the "
14230 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
14231 "LV>."
14232 msgstr ""
14233
14234 # type: textblock
14235 #. type: textblock
14236 #: ../src/guestfs-actions.pod:4011 ../fish/guestfish-actions.pod:2755
14237 msgid ""
14238 "This command returns an error if the C<lvname> parameter does not refer to a "
14239 "logical volume."
14240 msgstr ""
14241
14242 # type: textblock
14243 #. type: textblock
14244 #: ../src/guestfs-actions.pod:4014
14245 msgid "See also C<guestfs_is_lv>."
14246 msgstr ""
14247
14248 # type: textblock
14249 #. type: textblock
14250 #: ../src/guestfs-actions.pod:4019
14251 msgid "(Added in 1.5.24)"
14252 msgstr ""
14253
14254 # type: =head2
14255 #. type: =head2
14256 #: ../src/guestfs-actions.pod:4021
14257 msgid "guestfs_lvm_clear_filter"
14258 msgstr ""
14259
14260 # type: verbatim
14261 #. type: verbatim
14262 #: ../src/guestfs-actions.pod:4023
14263 #, no-wrap
14264 msgid ""
14265 " int\n"
14266 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
14267 "\n"
14268 msgstr ""
14269
14270 # type: textblock
14271 #. type: textblock
14272 #: ../src/guestfs-actions.pod:4026
14273 msgid ""
14274 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
14275 "see every block device."
14276 msgstr ""
14277
14278 # type: textblock
14279 #. type: textblock
14280 #: ../src/guestfs-actions.pod:4029 ../src/guestfs-actions.pod:4071
14281 #: ../fish/guestfish-actions.pod:2767 ../fish/guestfish-actions.pod:2798
14282 msgid ""
14283 "This command also clears the LVM cache and performs a volume group scan."
14284 msgstr ""
14285
14286 # type: =head2
14287 #. type: =head2
14288 #: ../src/guestfs-actions.pod:4036
14289 msgid "guestfs_lvm_remove_all"
14290 msgstr ""
14291
14292 # type: verbatim
14293 #. type: verbatim
14294 #: ../src/guestfs-actions.pod:4038
14295 #, no-wrap
14296 msgid ""
14297 " int\n"
14298 " guestfs_lvm_remove_all (guestfs_h *g);\n"
14299 "\n"
14300 msgstr ""
14301
14302 # type: textblock
14303 #. type: textblock
14304 #: ../src/guestfs-actions.pod:4041 ../fish/guestfish-actions.pod:2774
14305 msgid ""
14306 "This command removes all LVM logical volumes, volume groups and physical "
14307 "volumes."
14308 msgstr ""
14309
14310 # type: =head2
14311 #. type: =head2
14312 #: ../src/guestfs-actions.pod:4051
14313 msgid "guestfs_lvm_set_filter"
14314 msgstr ""
14315
14316 # type: verbatim
14317 #. type: verbatim
14318 #: ../src/guestfs-actions.pod:4053
14319 #, no-wrap
14320 msgid ""
14321 " int\n"
14322 " guestfs_lvm_set_filter (guestfs_h *g,\n"
14323 "                         char *const *devices);\n"
14324 "\n"
14325 msgstr ""
14326
14327 # type: textblock
14328 #. type: textblock
14329 #: ../src/guestfs-actions.pod:4057 ../fish/guestfish-actions.pod:2784
14330 msgid ""
14331 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
14332 "block devices in the list C<devices>, and will ignore all other attached "
14333 "block devices."
14334 msgstr ""
14335
14336 # type: textblock
14337 #. type: textblock
14338 #: ../src/guestfs-actions.pod:4061 ../fish/guestfish-actions.pod:2788
14339 msgid ""
14340 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
14341 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
14342 "there are two types of duplication possible: either cloned PVs/VGs which "
14343 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
14344 "same name.  In normal operation you cannot create this situation, but you "
14345 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
14346 "inside the LVM metadata."
14347 msgstr ""
14348
14349 # type: textblock
14350 #. type: textblock
14351 #: ../src/guestfs-actions.pod:4074 ../fish/guestfish-actions.pod:2801
14352 msgid "You can filter whole block devices or individual partitions."
14353 msgstr ""
14354
14355 # type: textblock
14356 #. type: textblock
14357 #: ../src/guestfs-actions.pod:4076 ../fish/guestfish-actions.pod:2803
14358 msgid ""
14359 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
14360 "filesystem), even if you are not filtering out that VG."
14361 msgstr ""
14362
14363 # type: =head2
14364 #. type: =head2
14365 #: ../src/guestfs-actions.pod:4084
14366 msgid "guestfs_lvremove"
14367 msgstr ""
14368
14369 # type: verbatim
14370 #. type: verbatim
14371 #: ../src/guestfs-actions.pod:4086
14372 #, no-wrap
14373 msgid ""
14374 " int\n"
14375 " guestfs_lvremove (guestfs_h *g,\n"
14376 "                   const char *device);\n"
14377 "\n"
14378 msgstr ""
14379
14380 # type: textblock
14381 #. type: textblock
14382 #: ../src/guestfs-actions.pod:4090 ../fish/guestfish-actions.pod:2811
14383 msgid ""
14384 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
14385 "LV, such as C</dev/VG/LV>."
14386 msgstr ""
14387
14388 # type: textblock
14389 #. type: textblock
14390 #: ../src/guestfs-actions.pod:4093 ../fish/guestfish-actions.pod:2814
14391 msgid ""
14392 "You can also remove all LVs in a volume group by specifying the VG name, C</"
14393 "dev/VG>."
14394 msgstr ""
14395
14396 # type: textblock
14397 #. type: textblock
14398 #: ../src/guestfs-actions.pod:4098 ../src/guestfs-actions.pod:5341
14399 #: ../src/guestfs-actions.pod:7158
14400 msgid "(Added in 1.0.13)"
14401 msgstr ""
14402
14403 # type: =head2
14404 #. type: =head2
14405 #: ../src/guestfs-actions.pod:4100
14406 msgid "guestfs_lvrename"
14407 msgstr ""
14408
14409 # type: verbatim
14410 #. type: verbatim
14411 #: ../src/guestfs-actions.pod:4102
14412 #, no-wrap
14413 msgid ""
14414 " int\n"
14415 " guestfs_lvrename (guestfs_h *g,\n"
14416 "                   const char *logvol,\n"
14417 "                   const char *newlogvol);\n"
14418 "\n"
14419 msgstr ""
14420
14421 # type: textblock
14422 #. type: textblock
14423 #: ../src/guestfs-actions.pod:4107 ../fish/guestfish-actions.pod:2821
14424 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
14425 msgstr ""
14426
14427 # type: textblock
14428 #. type: textblock
14429 #: ../src/guestfs-actions.pod:4111 ../src/guestfs-actions.pod:7171
14430 msgid "(Added in 1.0.83)"
14431 msgstr ""
14432
14433 # type: =head2
14434 #. type: =head2
14435 #: ../src/guestfs-actions.pod:4113
14436 msgid "guestfs_lvresize"
14437 msgstr ""
14438
14439 # type: verbatim
14440 #. type: verbatim
14441 #: ../src/guestfs-actions.pod:4115
14442 #, no-wrap
14443 msgid ""
14444 " int\n"
14445 " guestfs_lvresize (guestfs_h *g,\n"
14446 "                   const char *device,\n"
14447 "                   int mbytes);\n"
14448 "\n"
14449 msgstr ""
14450
14451 # type: textblock
14452 #. type: textblock
14453 #: ../src/guestfs-actions.pod:4120 ../fish/guestfish-actions.pod:2827
14454 msgid ""
14455 "This resizes (expands or shrinks) an existing LVM logical volume to "
14456 "C<mbytes>.  When reducing, data in the reduced part is lost."
14457 msgstr ""
14458
14459 # type: =head2
14460 #. type: =head2
14461 #: ../src/guestfs-actions.pod:4128
14462 msgid "guestfs_lvresize_free"
14463 msgstr ""
14464
14465 # type: verbatim
14466 #. type: verbatim
14467 #: ../src/guestfs-actions.pod:4130
14468 #, no-wrap
14469 msgid ""
14470 " int\n"
14471 " guestfs_lvresize_free (guestfs_h *g,\n"
14472 "                        const char *lv,\n"
14473 "                        int percent);\n"
14474 "\n"
14475 msgstr ""
14476
14477 # type: textblock
14478 #. type: textblock
14479 #: ../src/guestfs-actions.pod:4135 ../fish/guestfish-actions.pod:2835
14480 msgid ""
14481 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
14482 "remaining free space in the volume group.  Commonly you would call this with "
14483 "pc = 100 which expands the logical volume as much as possible, using all "
14484 "remaining free space in the volume group."
14485 msgstr ""
14486
14487 # type: textblock
14488 #. type: textblock
14489 #: ../src/guestfs-actions.pod:4143
14490 msgid "(Added in 1.3.3)"
14491 msgstr ""
14492
14493 # type: =head2
14494 #. type: =head2
14495 #: ../src/guestfs-actions.pod:4145
14496 msgid "guestfs_lvs"
14497 msgstr ""
14498
14499 # type: verbatim
14500 #. type: verbatim
14501 #: ../src/guestfs-actions.pod:4147
14502 #, no-wrap
14503 msgid ""
14504 " char **\n"
14505 " guestfs_lvs (guestfs_h *g);\n"
14506 "\n"
14507 msgstr ""
14508
14509 # type: textblock
14510 #. type: textblock
14511 #: ../src/guestfs-actions.pod:4150 ../fish/guestfish-actions.pod:2845
14512 msgid ""
14513 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14514 "(8)> command."
14515 msgstr ""
14516
14517 # type: textblock
14518 #. type: textblock
14519 #: ../src/guestfs-actions.pod:4153 ../fish/guestfish-actions.pod:2848
14520 msgid ""
14521 "This returns a list of the logical volume device names (eg. C</dev/"
14522 "VolGroup00/LogVol00>)."
14523 msgstr ""
14524
14525 # type: textblock
14526 #. type: textblock
14527 #: ../src/guestfs-actions.pod:4156
14528 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
14529 msgstr ""
14530
14531 # type: =head2
14532 #. type: =head2
14533 #: ../src/guestfs-actions.pod:4164
14534 msgid "guestfs_lvs_full"
14535 msgstr ""
14536
14537 # type: verbatim
14538 #. type: verbatim
14539 #: ../src/guestfs-actions.pod:4166
14540 #, no-wrap
14541 msgid ""
14542 " struct guestfs_lvm_lv_list *\n"
14543 " guestfs_lvs_full (guestfs_h *g);\n"
14544 "\n"
14545 msgstr ""
14546
14547 # type: textblock
14548 #. type: textblock
14549 #: ../src/guestfs-actions.pod:4169 ../fish/guestfish-actions.pod:2857
14550 msgid ""
14551 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14552 "(8)> command.  The \"full\" version includes all fields."
14553 msgstr ""
14554
14555 # type: textblock
14556 #. type: textblock
14557 #: ../src/guestfs-actions.pod:4172
14558 msgid ""
14559 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
14560 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
14561 msgstr ""
14562
14563 # type: =head2
14564 #. type: =head2
14565 #: ../src/guestfs-actions.pod:4178
14566 msgid "guestfs_lvuuid"
14567 msgstr ""
14568
14569 # type: verbatim
14570 #. type: verbatim
14571 #: ../src/guestfs-actions.pod:4180
14572 #, no-wrap
14573 msgid ""
14574 " char *\n"
14575 " guestfs_lvuuid (guestfs_h *g,\n"
14576 "                 const char *device);\n"
14577 "\n"
14578 msgstr ""
14579
14580 # type: textblock
14581 #. type: textblock
14582 #: ../src/guestfs-actions.pod:4184 ../fish/guestfish-actions.pod:2864
14583 msgid "This command returns the UUID of the LVM LV C<device>."
14584 msgstr ""
14585
14586 # type: =head2
14587 #. type: =head2
14588 #: ../src/guestfs-actions.pod:4191
14589 msgid "guestfs_lxattrlist"
14590 msgstr ""
14591
14592 # type: verbatim
14593 #. type: verbatim
14594 #: ../src/guestfs-actions.pod:4193
14595 #, no-wrap
14596 msgid ""
14597 " struct guestfs_xattr_list *\n"
14598 " guestfs_lxattrlist (guestfs_h *g,\n"
14599 "                     const char *path,\n"
14600 "                     char *const *names);\n"
14601 "\n"
14602 msgstr ""
14603
14604 # type: textblock
14605 #. type: textblock
14606 #: ../src/guestfs-actions.pod:4198 ../fish/guestfish-actions.pod:2870
14607 msgid ""
14608 "This call allows you to get the extended attributes of multiple files, where "
14609 "all files are in the directory C<path>.  C<names> is the list of files from "
14610 "this directory."
14611 msgstr ""
14612
14613 # type: textblock
14614 #. type: textblock
14615 #: ../src/guestfs-actions.pod:4202 ../fish/guestfish-actions.pod:2874
14616 msgid ""
14617 "On return you get a flat list of xattr structs which must be interpreted "
14618 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
14619 "C<attrval> in this struct is zero-length to indicate there was an error "
14620 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
14621 "number (the number of following attributes for this file, which could be C<"
14622 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
14623 "for the first named file.  This repeats for the second and subsequent files."
14624 msgstr ""
14625
14626 # type: textblock
14627 #. type: textblock
14628 #: ../src/guestfs-actions.pod:4212
14629 msgid ""
14630 "This call is intended for programs that want to efficiently list a directory "
14631 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
14632 "a similarly efficient call for getting standard stats.  Very long directory "
14633 "listings might cause the protocol message size to be exceeded, causing this "
14634 "call to fail.  The caller must split up such requests into smaller groups of "
14635 "names."
14636 msgstr ""
14637
14638 # type: =head2
14639 #. type: =head2
14640 #: ../src/guestfs-actions.pod:4226
14641 msgid "guestfs_mkdir"
14642 msgstr ""
14643
14644 # type: verbatim
14645 #. type: verbatim
14646 #: ../src/guestfs-actions.pod:4228
14647 #, no-wrap
14648 msgid ""
14649 " int\n"
14650 " guestfs_mkdir (guestfs_h *g,\n"
14651 "                const char *path);\n"
14652 "\n"
14653 msgstr ""
14654
14655 # type: textblock
14656 #. type: textblock
14657 #: ../src/guestfs-actions.pod:4232 ../fish/guestfish-actions.pod:2896
14658 msgid "Create a directory named C<path>."
14659 msgstr ""
14660
14661 # type: =head2
14662 #. type: =head2
14663 #: ../src/guestfs-actions.pod:4238
14664 msgid "guestfs_mkdir_mode"
14665 msgstr ""
14666
14667 # type: verbatim
14668 #. type: verbatim
14669 #: ../src/guestfs-actions.pod:4240
14670 #, no-wrap
14671 msgid ""
14672 " int\n"
14673 " guestfs_mkdir_mode (guestfs_h *g,\n"
14674 "                     const char *path,\n"
14675 "                     int mode);\n"
14676 "\n"
14677 msgstr ""
14678
14679 # type: textblock
14680 #. type: textblock
14681 #: ../src/guestfs-actions.pod:4245 ../fish/guestfish-actions.pod:2902
14682 msgid ""
14683 "This command creates a directory, setting the initial permissions of the "
14684 "directory to C<mode>."
14685 msgstr ""
14686
14687 # type: textblock
14688 #. type: textblock
14689 #: ../src/guestfs-actions.pod:4248 ../fish/guestfish-actions.pod:2905
14690 msgid ""
14691 "For common Linux filesystems, the actual mode which is set will be C<mode & "
14692 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
14693 "other ways."
14694 msgstr ""
14695
14696 # type: textblock
14697 #. type: textblock
14698 #: ../src/guestfs-actions.pod:4252
14699 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
14700 msgstr ""
14701
14702 # type: =head2
14703 #. type: =head2
14704 #: ../src/guestfs-actions.pod:4258
14705 msgid "guestfs_mkdir_p"
14706 msgstr ""
14707
14708 # type: verbatim
14709 #. type: verbatim
14710 #: ../src/guestfs-actions.pod:4260
14711 #, no-wrap
14712 msgid ""
14713 " int\n"
14714 " guestfs_mkdir_p (guestfs_h *g,\n"
14715 "                  const char *path);\n"
14716 "\n"
14717 msgstr ""
14718
14719 # type: textblock
14720 #. type: textblock
14721 #: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:2915
14722 msgid ""
14723 "Create a directory named C<path>, creating any parent directories as "
14724 "necessary.  This is like the C<mkdir -p> shell command."
14725 msgstr ""
14726
14727 # type: =head2
14728 #. type: =head2
14729 #: ../src/guestfs-actions.pod:4271
14730 msgid "guestfs_mkdtemp"
14731 msgstr ""
14732
14733 # type: verbatim
14734 #. type: verbatim
14735 #: ../src/guestfs-actions.pod:4273
14736 #, no-wrap
14737 msgid ""
14738 " char *\n"
14739 " guestfs_mkdtemp (guestfs_h *g,\n"
14740 "                  const char *template);\n"
14741 "\n"
14742 msgstr ""
14743
14744 # type: textblock
14745 #. type: textblock
14746 #: ../src/guestfs-actions.pod:4277 ../fish/guestfish-actions.pod:2922
14747 msgid ""
14748 "This command creates a temporary directory.  The C<template> parameter "
14749 "should be a full pathname for the temporary directory name with the final "
14750 "six characters being \"XXXXXX\"."
14751 msgstr ""
14752
14753 # type: textblock
14754 #. type: textblock
14755 #: ../src/guestfs-actions.pod:4282 ../fish/guestfish-actions.pod:2927
14756 msgid ""
14757 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
14758 "being suitable for Windows filesystems."
14759 msgstr ""
14760
14761 # type: textblock
14762 #. type: textblock
14763 #: ../src/guestfs-actions.pod:4285 ../fish/guestfish-actions.pod:2930
14764 msgid "The name of the temporary directory that was created is returned."
14765 msgstr ""
14766
14767 # type: textblock
14768 #. type: textblock
14769 #: ../src/guestfs-actions.pod:4288 ../fish/guestfish-actions.pod:2933
14770 msgid "The temporary directory is created with mode 0700 and is owned by root."
14771 msgstr ""
14772
14773 # type: textblock
14774 #. type: textblock
14775 #: ../src/guestfs-actions.pod:4291 ../fish/guestfish-actions.pod:2936
14776 msgid ""
14777 "The caller is responsible for deleting the temporary directory and its "
14778 "contents after use."
14779 msgstr ""
14780
14781 # type: textblock
14782 #. type: textblock
14783 #: ../src/guestfs-actions.pod:4294 ../fish/guestfish-actions.pod:2939
14784 msgid "See also: L<mkdtemp(3)>"
14785 msgstr ""
14786
14787 # type: =head2
14788 #. type: =head2
14789 #: ../src/guestfs-actions.pod:4301
14790 msgid "guestfs_mke2fs_J"
14791 msgstr ""
14792
14793 # type: verbatim
14794 #. type: verbatim
14795 #: ../src/guestfs-actions.pod:4303
14796 #, no-wrap
14797 msgid ""
14798 " int\n"
14799 " guestfs_mke2fs_J (guestfs_h *g,\n"
14800 "                   const char *fstype,\n"
14801 "                   int blocksize,\n"
14802 "                   const char *device,\n"
14803 "                   const char *journal);\n"
14804 "\n"
14805 msgstr ""
14806
14807 # type: textblock
14808 #. type: textblock
14809 #: ../src/guestfs-actions.pod:4310 ../fish/guestfish-actions.pod:2945
14810 msgid ""
14811 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14812 "C<journal>.  It is equivalent to the command:"
14813 msgstr ""
14814
14815 # type: verbatim
14816 #. type: verbatim
14817 #: ../src/guestfs-actions.pod:4314 ../fish/guestfish-actions.pod:2949
14818 #, no-wrap
14819 msgid ""
14820 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
14821 "\n"
14822 msgstr ""
14823
14824 # type: textblock
14825 #. type: textblock
14826 #: ../src/guestfs-actions.pod:4316
14827 msgid "See also C<guestfs_mke2journal>."
14828 msgstr ""
14829
14830 # type: textblock
14831 #. type: textblock
14832 #: ../src/guestfs-actions.pod:4320 ../src/guestfs-actions.pod:4338
14833 #: ../src/guestfs-actions.pod:4356 ../src/guestfs-actions.pod:4372
14834 #: ../src/guestfs-actions.pod:4386 ../src/guestfs-actions.pod:4400
14835 #: ../src/guestfs-actions.pod:4459 ../src/guestfs-actions.pod:4724
14836 msgid "(Added in 1.0.68)"
14837 msgstr ""
14838
14839 # type: =head2
14840 #. type: =head2
14841 #: ../src/guestfs-actions.pod:4322
14842 msgid "guestfs_mke2fs_JL"
14843 msgstr ""
14844
14845 # type: verbatim
14846 #. type: verbatim
14847 #: ../src/guestfs-actions.pod:4324
14848 #, no-wrap
14849 msgid ""
14850 " int\n"
14851 " guestfs_mke2fs_JL (guestfs_h *g,\n"
14852 "                    const char *fstype,\n"
14853 "                    int blocksize,\n"
14854 "                    const char *device,\n"
14855 "                    const char *label);\n"
14856 "\n"
14857 msgstr ""
14858
14859 # type: textblock
14860 #. type: textblock
14861 #: ../src/guestfs-actions.pod:4331 ../fish/guestfish-actions.pod:2957
14862 msgid ""
14863 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14864 "the journal labeled C<label>."
14865 msgstr ""
14866
14867 # type: textblock
14868 #. type: textblock
14869 #: ../src/guestfs-actions.pod:4334
14870 msgid "See also C<guestfs_mke2journal_L>."
14871 msgstr ""
14872
14873 # type: =head2
14874 #. type: =head2
14875 #: ../src/guestfs-actions.pod:4340
14876 msgid "guestfs_mke2fs_JU"
14877 msgstr ""
14878
14879 # type: verbatim
14880 #. type: verbatim
14881 #: ../src/guestfs-actions.pod:4342
14882 #, no-wrap
14883 msgid ""
14884 " int\n"
14885 " guestfs_mke2fs_JU (guestfs_h *g,\n"
14886 "                    const char *fstype,\n"
14887 "                    int blocksize,\n"
14888 "                    const char *device,\n"
14889 "                    const char *uuid);\n"
14890 "\n"
14891 msgstr ""
14892
14893 # type: textblock
14894 #. type: textblock
14895 #: ../src/guestfs-actions.pod:4349 ../fish/guestfish-actions.pod:2966
14896 msgid ""
14897 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14898 "the journal with UUID C<uuid>."
14899 msgstr ""
14900
14901 # type: textblock
14902 #. type: textblock
14903 #: ../src/guestfs-actions.pod:4352
14904 msgid "See also C<guestfs_mke2journal_U>."
14905 msgstr ""
14906
14907 # type: =head2
14908 #. type: =head2
14909 #: ../src/guestfs-actions.pod:4358
14910 msgid "guestfs_mke2journal"
14911 msgstr ""
14912
14913 # type: verbatim
14914 #. type: verbatim
14915 #: ../src/guestfs-actions.pod:4360
14916 #, no-wrap
14917 msgid ""
14918 " int\n"
14919 " guestfs_mke2journal (guestfs_h *g,\n"
14920 "                      int blocksize,\n"
14921 "                      const char *device);\n"
14922 "\n"
14923 msgstr ""
14924
14925 # type: textblock
14926 #. type: textblock
14927 #: ../src/guestfs-actions.pod:4365 ../fish/guestfish-actions.pod:2975
14928 msgid ""
14929 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
14930 "command:"
14931 msgstr ""
14932
14933 # type: verbatim
14934 #. type: verbatim
14935 #: ../src/guestfs-actions.pod:4368 ../fish/guestfish-actions.pod:2978
14936 #, no-wrap
14937 msgid ""
14938 " mke2fs -O journal_dev -b blocksize device\n"
14939 "\n"
14940 msgstr ""
14941
14942 # type: =head2
14943 #. type: =head2
14944 #: ../src/guestfs-actions.pod:4374
14945 msgid "guestfs_mke2journal_L"
14946 msgstr ""
14947
14948 # type: verbatim
14949 #. type: verbatim
14950 #: ../src/guestfs-actions.pod:4376
14951 #, no-wrap
14952 msgid ""
14953 " int\n"
14954 " guestfs_mke2journal_L (guestfs_h *g,\n"
14955 "                        int blocksize,\n"
14956 "                        const char *label,\n"
14957 "                        const char *device);\n"
14958 "\n"
14959 msgstr ""
14960
14961 # type: textblock
14962 #. type: textblock
14963 #: ../src/guestfs-actions.pod:4382 ../fish/guestfish-actions.pod:2984
14964 msgid "This creates an ext2 external journal on C<device> with label C<label>."
14965 msgstr ""
14966
14967 # type: =head2
14968 #. type: =head2
14969 #: ../src/guestfs-actions.pod:4388
14970 msgid "guestfs_mke2journal_U"
14971 msgstr ""
14972
14973 # type: verbatim
14974 #. type: verbatim
14975 #: ../src/guestfs-actions.pod:4390
14976 #, no-wrap
14977 msgid ""
14978 " int\n"
14979 " guestfs_mke2journal_U (guestfs_h *g,\n"
14980 "                        int blocksize,\n"
14981 "                        const char *uuid,\n"
14982 "                        const char *device);\n"
14983 "\n"
14984 msgstr ""
14985
14986 # type: textblock
14987 #. type: textblock
14988 #: ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:2990
14989 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
14990 msgstr ""
14991
14992 # type: =head2
14993 #. type: =head2
14994 #: ../src/guestfs-actions.pod:4402
14995 msgid "guestfs_mkfifo"
14996 msgstr ""
14997
14998 # type: verbatim
14999 #. type: verbatim
15000 #: ../src/guestfs-actions.pod:4404
15001 #, no-wrap
15002 msgid ""
15003 " int\n"
15004 " guestfs_mkfifo (guestfs_h *g,\n"
15005 "                 int mode,\n"
15006 "                 const char *path);\n"
15007 "\n"
15008 msgstr ""
15009
15010 # type: textblock
15011 #. type: textblock
15012 #: ../src/guestfs-actions.pod:4409
15013 msgid ""
15014 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
15015 "is just a convenient wrapper around C<guestfs_mknod>."
15016 msgstr ""
15017
15018 # type: =head2
15019 #. type: =head2
15020 #: ../src/guestfs-actions.pod:4419
15021 msgid "guestfs_mkfs"
15022 msgstr ""
15023
15024 # type: verbatim
15025 #. type: verbatim
15026 #: ../src/guestfs-actions.pod:4421
15027 #, no-wrap
15028 msgid ""
15029 " int\n"
15030 " guestfs_mkfs (guestfs_h *g,\n"
15031 "               const char *fstype,\n"
15032 "               const char *device);\n"
15033 "\n"
15034 msgstr ""
15035
15036 # type: textblock
15037 #. type: textblock
15038 #: ../src/guestfs-actions.pod:4426 ../fish/guestfish-actions.pod:3006
15039 msgid ""
15040 "This creates a filesystem on C<device> (usually a partition or LVM logical "
15041 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
15042 msgstr ""
15043
15044 # type: =head2
15045 #. type: =head2
15046 #: ../src/guestfs-actions.pod:4434
15047 msgid "guestfs_mkfs_b"
15048 msgstr ""
15049
15050 # type: verbatim
15051 #. type: verbatim
15052 #: ../src/guestfs-actions.pod:4436
15053 #, no-wrap
15054 msgid ""
15055 " int\n"
15056 " guestfs_mkfs_b (guestfs_h *g,\n"
15057 "                 const char *fstype,\n"
15058 "                 int blocksize,\n"
15059 "                 const char *device);\n"
15060 "\n"
15061 msgstr ""
15062
15063 # type: textblock
15064 #. type: textblock
15065 #: ../src/guestfs-actions.pod:4442
15066 msgid ""
15067 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
15068 "block size of the resulting filesystem.  Supported block sizes depend on the "
15069 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
15070 msgstr ""
15071
15072 # type: textblock
15073 #. type: textblock
15074 #: ../src/guestfs-actions.pod:4447 ../src/guestfs-actions.pod:4490
15075 #: ../fish/guestfish-actions.pod:3019 ../fish/guestfish-actions.pod:3046
15076 msgid ""
15077 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
15078 "cluster size."
15079 msgstr ""
15080
15081 # type: textblock
15082 #. type: textblock
15083 #: ../src/guestfs-actions.pod:4452 ../fish/guestfish-actions.pod:3022
15084 msgid ""
15085 "This function is deprecated.  In new code, use the C<mkfs_opts> call instead."
15086 msgstr ""
15087
15088 # type: =head2
15089 #. type: =head2
15090 #: ../src/guestfs-actions.pod:4461
15091 msgid "guestfs_mkfs_opts"
15092 msgstr ""
15093
15094 # type: verbatim
15095 #. type: verbatim
15096 #: ../src/guestfs-actions.pod:4463
15097 #, no-wrap
15098 msgid ""
15099 " int\n"
15100 " guestfs_mkfs_opts (guestfs_h *g,\n"
15101 "                    const char *fstype,\n"
15102 "                    const char *device,\n"
15103 "                    ...);\n"
15104 "\n"
15105 msgstr ""
15106
15107 #. type: verbatim
15108 #: ../src/guestfs-actions.pod:4474
15109 #, no-wrap
15110 msgid ""
15111 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
15112 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
15113 "\n"
15114 msgstr ""
15115
15116 # type: textblock
15117 #. type: textblock
15118 #: ../src/guestfs-actions.pod:4477 ../fish/guestfish-actions.pod:3033
15119 msgid ""
15120 "This function creates a filesystem on C<device>.  The filesystem type is "
15121 "C<fstype>, for example C<ext3>."
15122 msgstr ""
15123
15124 # type: =item
15125 #. type: =item
15126 #: ../src/guestfs-actions.pod:4484 ../fish/guestfish-actions.pod:3040
15127 msgid "C<blocksize>"
15128 msgstr ""
15129
15130 # type: textblock
15131 #. type: textblock
15132 #: ../src/guestfs-actions.pod:4486 ../fish/guestfish-actions.pod:3042
15133 msgid ""
15134 "The filesystem block size.  Supported block sizes depend on the filesystem "
15135 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
15136 "filesystems."
15137 msgstr ""
15138
15139 #. type: textblock
15140 #: ../src/guestfs-actions.pod:4493 ../fish/guestfish-actions.pod:3049
15141 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
15142 msgstr ""
15143
15144 #. type: =item
15145 #: ../src/guestfs-actions.pod:4495 ../fish/guestfish-actions.pod:3051
15146 msgid "C<features>"
15147 msgstr ""
15148
15149 #. type: textblock
15150 #: ../src/guestfs-actions.pod:4497 ../fish/guestfish-actions.pod:3053
15151 msgid "This passes the I<-O> parameter to the external mkfs program."
15152 msgstr ""
15153
15154 #. type: textblock
15155 #: ../src/guestfs-actions.pod:4499 ../fish/guestfish-actions.pod:3055
15156 msgid ""
15157 "For certain filesystem types, this allows extra filesystem features to be "
15158 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
15159 msgstr ""
15160
15161 #. type: textblock
15162 #: ../src/guestfs-actions.pod:4503 ../fish/guestfish-actions.pod:3059
15163 msgid ""
15164 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
15165 "type."
15166 msgstr ""
15167
15168 #. type: textblock
15169 #: ../src/guestfs-actions.pod:4510
15170 msgid "(Added in 1.7.19)"
15171 msgstr ""
15172
15173 # type: =head2
15174 #. type: =head2
15175 #: ../src/guestfs-actions.pod:4512
15176 msgid "guestfs_mkfs_opts_va"
15177 msgstr ""
15178
15179 # type: verbatim
15180 #. type: verbatim
15181 #: ../src/guestfs-actions.pod:4514
15182 #, no-wrap
15183 msgid ""
15184 " int\n"
15185 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
15186 "                       const char *fstype,\n"
15187 "                       const char *device,\n"
15188 "                       va_list args);\n"
15189 "\n"
15190 msgstr ""
15191
15192 # type: textblock
15193 #. type: textblock
15194 #: ../src/guestfs-actions.pod:4520
15195 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
15196 msgstr ""
15197
15198 # type: =head2
15199 #. type: =head2
15200 #: ../src/guestfs-actions.pod:4524
15201 msgid "guestfs_mkfs_opts_argv"
15202 msgstr ""
15203
15204 # type: verbatim
15205 #. type: verbatim
15206 #: ../src/guestfs-actions.pod:4526
15207 #, no-wrap
15208 msgid ""
15209 " int\n"
15210 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
15211 "                         const char *fstype,\n"
15212 "                         const char *device,\n"
15213 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
15214 "\n"
15215 msgstr ""
15216
15217 # type: textblock
15218 #. type: textblock
15219 #: ../src/guestfs-actions.pod:4532
15220 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
15221 msgstr ""
15222
15223 # type: =head2
15224 #. type: =head2
15225 #: ../src/guestfs-actions.pod:4536
15226 msgid "guestfs_mkmountpoint"
15227 msgstr ""
15228
15229 # type: verbatim
15230 #. type: verbatim
15231 #: ../src/guestfs-actions.pod:4538
15232 #, no-wrap
15233 msgid ""
15234 " int\n"
15235 " guestfs_mkmountpoint (guestfs_h *g,\n"
15236 "                       const char *exemptpath);\n"
15237 "\n"
15238 msgstr ""
15239
15240 # type: textblock
15241 #. type: textblock
15242 #: ../src/guestfs-actions.pod:4542
15243 msgid ""
15244 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
15245 "that can be used to create extra mountpoints before mounting the first "
15246 "filesystem."
15247 msgstr ""
15248
15249 # type: textblock
15250 #. type: textblock
15251 #: ../src/guestfs-actions.pod:4546 ../fish/guestfish-actions.pod:3074
15252 msgid ""
15253 "These calls are I<only> necessary in some very limited circumstances, mainly "
15254 "the case where you want to mount a mix of unrelated and/or read-only "
15255 "filesystems together."
15256 msgstr ""
15257
15258 # type: textblock
15259 #. type: textblock
15260 #: ../src/guestfs-actions.pod:4550 ../fish/guestfish-actions.pod:3078
15261 msgid ""
15262 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
15263 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
15264 "inside that.  You can unpack this as follows in guestfish:"
15265 msgstr ""
15266
15267 # type: verbatim
15268 #. type: verbatim
15269 #: ../src/guestfs-actions.pod:4555 ../fish/guestfish-actions.pod:3083
15270 #, no-wrap
15271 msgid ""
15272 " add-ro Fedora-11-i686-Live.iso\n"
15273 " run\n"
15274 " mkmountpoint /cd\n"
15275 " mkmountpoint /sqsh\n"
15276 " mkmountpoint /ext3fs\n"
15277 " mount /dev/sda /cd\n"
15278 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
15279 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
15280 "\n"
15281 msgstr ""
15282
15283 # type: textblock
15284 #. type: textblock
15285 #: ../src/guestfs-actions.pod:4564 ../fish/guestfish-actions.pod:3092
15286 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
15287 msgstr ""
15288
15289 # type: textblock
15290 #. type: textblock
15291 #: ../src/guestfs-actions.pod:4566
15292 msgid ""
15293 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
15294 "may get unexpected errors if you try to mix these calls.  It is safest to "
15295 "manually unmount filesystems and remove mountpoints after use."
15296 msgstr ""
15297
15298 # type: textblock
15299 #. type: textblock
15300 #: ../src/guestfs-actions.pod:4570
15301 msgid ""
15302 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
15303 "first, so for this to work for manual mountpoints, you must ensure that the "
15304 "innermost mountpoints have the longest pathnames, as in the example code "
15305 "above."
15306 msgstr ""
15307
15308 # type: textblock
15309 #. type: textblock
15310 #: ../src/guestfs-actions.pod:4575 ../fish/guestfish-actions.pod:3103
15311 msgid ""
15312 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
15313 msgstr ""
15314
15315 #. type: textblock
15316 #: ../src/guestfs-actions.pod:4577
15317 msgid ""
15318 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
15319 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
15320 "can also trigger these issues."
15321 msgstr ""
15322
15323 # type: textblock
15324 #. type: textblock
15325 #: ../src/guestfs-actions.pod:4583 ../src/guestfs-actions.pod:4849
15326 #: ../src/guestfs-actions.pod:5759
15327 msgid "(Added in 1.0.62)"
15328 msgstr ""
15329
15330 # type: =head2
15331 #. type: =head2
15332 #: ../src/guestfs-actions.pod:4585
15333 msgid "guestfs_mknod"
15334 msgstr ""
15335
15336 # type: verbatim
15337 #. type: verbatim
15338 #: ../src/guestfs-actions.pod:4587
15339 #, no-wrap
15340 msgid ""
15341 " int\n"
15342 " guestfs_mknod (guestfs_h *g,\n"
15343 "                int mode,\n"
15344 "                int devmajor,\n"
15345 "                int devminor,\n"
15346 "                const char *path);\n"
15347 "\n"
15348 msgstr ""
15349
15350 # type: textblock
15351 #. type: textblock
15352 #: ../src/guestfs-actions.pod:4594 ../fish/guestfish-actions.pod:3113
15353 msgid ""
15354 "This call creates block or character special devices, or named pipes (FIFOs)."
15355 msgstr ""
15356
15357 # type: textblock
15358 #. type: textblock
15359 #: ../src/guestfs-actions.pod:4597 ../fish/guestfish-actions.pod:3116
15360 msgid ""
15361 "The C<mode> parameter should be the mode, using the standard constants.  "
15362 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
15363 "used when creating block and character special devices."
15364 msgstr ""
15365
15366 # type: textblock
15367 #. type: textblock
15368 #: ../src/guestfs-actions.pod:4602
15369 msgid ""
15370 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
15371 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
15372 "regular file).  These constants are available in the standard Linux header "
15373 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
15374 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
15375 "the appropriate constant for you."
15376 msgstr ""
15377
15378 # type: =head2
15379 #. type: =head2
15380 #: ../src/guestfs-actions.pod:4616
15381 msgid "guestfs_mknod_b"
15382 msgstr ""
15383
15384 # type: verbatim
15385 #. type: verbatim
15386 #: ../src/guestfs-actions.pod:4618
15387 #, no-wrap
15388 msgid ""
15389 " int\n"
15390 " guestfs_mknod_b (guestfs_h *g,\n"
15391 "                  int mode,\n"
15392 "                  int devmajor,\n"
15393 "                  int devminor,\n"
15394 "                  const char *path);\n"
15395 "\n"
15396 msgstr ""
15397
15398 # type: textblock
15399 #. type: textblock
15400 #: ../src/guestfs-actions.pod:4625
15401 msgid ""
15402 "This call creates a block device node called C<path> with mode C<mode> and "
15403 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15404 "wrapper around C<guestfs_mknod>."
15405 msgstr ""
15406
15407 # type: =head2
15408 #. type: =head2
15409 #: ../src/guestfs-actions.pod:4635
15410 msgid "guestfs_mknod_c"
15411 msgstr ""
15412
15413 # type: verbatim
15414 #. type: verbatim
15415 #: ../src/guestfs-actions.pod:4637
15416 #, no-wrap
15417 msgid ""
15418 " int\n"
15419 " guestfs_mknod_c (guestfs_h *g,\n"
15420 "                  int mode,\n"
15421 "                  int devmajor,\n"
15422 "                  int devminor,\n"
15423 "                  const char *path);\n"
15424 "\n"
15425 msgstr ""
15426
15427 # type: textblock
15428 #. type: textblock
15429 #: ../src/guestfs-actions.pod:4644
15430 msgid ""
15431 "This call creates a char device node called C<path> with mode C<mode> and "
15432 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15433 "wrapper around C<guestfs_mknod>."
15434 msgstr ""
15435
15436 # type: =head2
15437 #. type: =head2
15438 #: ../src/guestfs-actions.pod:4654
15439 msgid "guestfs_mkswap"
15440 msgstr ""
15441
15442 # type: verbatim
15443 #. type: verbatim
15444 #: ../src/guestfs-actions.pod:4656
15445 #, no-wrap
15446 msgid ""
15447 " int\n"
15448 " guestfs_mkswap (guestfs_h *g,\n"
15449 "                 const char *device);\n"
15450 "\n"
15451 msgstr ""
15452
15453 # type: textblock
15454 #. type: textblock
15455 #: ../src/guestfs-actions.pod:4660 ../fish/guestfish-actions.pod:3155
15456 msgid "Create a swap partition on C<device>."
15457 msgstr ""
15458
15459 # type: =head2
15460 #. type: =head2
15461 #: ../src/guestfs-actions.pod:4666
15462 msgid "guestfs_mkswap_L"
15463 msgstr ""
15464
15465 # type: verbatim
15466 #. type: verbatim
15467 #: ../src/guestfs-actions.pod:4668
15468 #, no-wrap
15469 msgid ""
15470 " int\n"
15471 " guestfs_mkswap_L (guestfs_h *g,\n"
15472 "                   const char *label,\n"
15473 "                   const char *device);\n"
15474 "\n"
15475 msgstr ""
15476
15477 # type: textblock
15478 #. type: textblock
15479 #: ../src/guestfs-actions.pod:4673 ../fish/guestfish-actions.pod:3161
15480 msgid "Create a swap partition on C<device> with label C<label>."
15481 msgstr ""
15482
15483 # type: textblock
15484 #. type: textblock
15485 #: ../src/guestfs-actions.pod:4675 ../fish/guestfish-actions.pod:3163
15486 msgid ""
15487 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
15488 "sda>), just to a partition.  This appears to be a limitation of the kernel "
15489 "or swap tools."
15490 msgstr ""
15491
15492 # type: =head2
15493 #. type: =head2
15494 #: ../src/guestfs-actions.pod:4683
15495 msgid "guestfs_mkswap_U"
15496 msgstr ""
15497
15498 # type: verbatim
15499 #. type: verbatim
15500 #: ../src/guestfs-actions.pod:4685
15501 #, no-wrap
15502 msgid ""
15503 " int\n"
15504 " guestfs_mkswap_U (guestfs_h *g,\n"
15505 "                   const char *uuid,\n"
15506 "                   const char *device);\n"
15507 "\n"
15508 msgstr ""
15509
15510 # type: textblock
15511 #. type: textblock
15512 #: ../src/guestfs-actions.pod:4690 ../fish/guestfish-actions.pod:3171
15513 msgid "Create a swap partition on C<device> with UUID C<uuid>."
15514 msgstr ""
15515
15516 # type: =head2
15517 #. type: =head2
15518 #: ../src/guestfs-actions.pod:4696
15519 msgid "guestfs_mkswap_file"
15520 msgstr ""
15521
15522 # type: verbatim
15523 #. type: verbatim
15524 #: ../src/guestfs-actions.pod:4698
15525 #, no-wrap
15526 msgid ""
15527 " int\n"
15528 " guestfs_mkswap_file (guestfs_h *g,\n"
15529 "                      const char *path);\n"
15530 "\n"
15531 msgstr ""
15532
15533 # type: textblock
15534 #. type: textblock
15535 #: ../src/guestfs-actions.pod:4702 ../fish/guestfish-actions.pod:3177
15536 msgid "Create a swap file."
15537 msgstr ""
15538
15539 # type: textblock
15540 #. type: textblock
15541 #: ../src/guestfs-actions.pod:4704
15542 msgid ""
15543 "This command just writes a swap file signature to an existing file.  To "
15544 "create the file itself, use something like C<guestfs_fallocate>."
15545 msgstr ""
15546
15547 # type: =head2
15548 #. type: =head2
15549 #: ../src/guestfs-actions.pod:4711
15550 msgid "guestfs_modprobe"
15551 msgstr ""
15552
15553 # type: verbatim
15554 #. type: verbatim
15555 #: ../src/guestfs-actions.pod:4713
15556 #, no-wrap
15557 msgid ""
15558 " int\n"
15559 " guestfs_modprobe (guestfs_h *g,\n"
15560 "                   const char *modulename);\n"
15561 "\n"
15562 msgstr ""
15563
15564 # type: textblock
15565 #. type: textblock
15566 #: ../src/guestfs-actions.pod:4717 ../fish/guestfish-actions.pod:3186
15567 msgid "This loads a kernel module in the appliance."
15568 msgstr ""
15569
15570 # type: textblock
15571 #. type: textblock
15572 #: ../src/guestfs-actions.pod:4719 ../fish/guestfish-actions.pod:3188
15573 msgid ""
15574 "The kernel module must have been whitelisted when libguestfs was built (see "
15575 "C<appliance/kmod.whitelist.in> in the source)."
15576 msgstr ""
15577
15578 # type: =head2
15579 #. type: =head2
15580 #: ../src/guestfs-actions.pod:4726
15581 msgid "guestfs_mount"
15582 msgstr ""
15583
15584 # type: verbatim
15585 #. type: verbatim
15586 #: ../src/guestfs-actions.pod:4728
15587 #, no-wrap
15588 msgid ""
15589 " int\n"
15590 " guestfs_mount (guestfs_h *g,\n"
15591 "                const char *device,\n"
15592 "                const char *mountpoint);\n"
15593 "\n"
15594 msgstr ""
15595
15596 # type: textblock
15597 #. type: textblock
15598 #: ../src/guestfs-actions.pod:4733 ../fish/guestfish-actions.pod:3195
15599 msgid ""
15600 "Mount a guest disk at a position in the filesystem.  Block devices are named "
15601 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
15602 "those block devices contain partitions, they will have the usual names (eg. "
15603 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
15604 msgstr ""
15605
15606 # type: textblock
15607 #. type: textblock
15608 #: ../src/guestfs-actions.pod:4739 ../fish/guestfish-actions.pod:3201
15609 msgid ""
15610 "The rules are the same as for L<mount(2)>: A filesystem must first be "
15611 "mounted on C</> before others can be mounted.  Other filesystems can only be "
15612 "mounted on directories which already exist."
15613 msgstr ""
15614
15615 # type: textblock
15616 #. type: textblock
15617 #: ../src/guestfs-actions.pod:4744 ../fish/guestfish-actions.pod:3206
15618 msgid ""
15619 "The mounted filesystem is writable, if we have sufficient permissions on the "
15620 "underlying device."
15621 msgstr ""
15622
15623 # type: textblock
15624 #. type: textblock
15625 #: ../src/guestfs-actions.pod:4747
15626 msgid ""
15627 "B<Important note:> When you use this call, the filesystem options C<sync> "
15628 "and C<noatime> are set implicitly.  This was originally done because we "
15629 "thought it would improve reliability, but it turns out that I<-o sync> has a "
15630 "very large negative performance impact and negligible effect on "
15631 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
15632 "in any code that needs performance, and instead use C<guestfs_mount_options> "
15633 "(use an empty string for the first parameter if you don't want any options)."
15634 msgstr ""
15635
15636 #. type: textblock
15637 #: ../src/guestfs-actions.pod:4759 ../fish/guestfish-actions.pod:3219
15638 msgid ""
15639 "This function is deprecated.  In new code, use the C<mount_options> call "
15640 "instead."
15641 msgstr ""
15642
15643 # type: =head2
15644 #. type: =head2
15645 #: ../src/guestfs-actions.pod:4768
15646 msgid "guestfs_mount_loop"
15647 msgstr ""
15648
15649 # type: verbatim
15650 #. type: verbatim
15651 #: ../src/guestfs-actions.pod:4770
15652 #, no-wrap
15653 msgid ""
15654 " int\n"
15655 " guestfs_mount_loop (guestfs_h *g,\n"
15656 "                     const char *file,\n"
15657 "                     const char *mountpoint);\n"
15658 "\n"
15659 msgstr ""
15660
15661 # type: textblock
15662 #. type: textblock
15663 #: ../src/guestfs-actions.pod:4775 ../fish/guestfish-actions.pod:3230
15664 msgid ""
15665 "This command lets you mount C<file> (a filesystem image in a file) on a "
15666 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
15667 "mountpoint>."
15668 msgstr ""
15669
15670 # type: =head2
15671 #. type: =head2
15672 #: ../src/guestfs-actions.pod:4783
15673 msgid "guestfs_mount_options"
15674 msgstr ""
15675
15676 # type: verbatim
15677 #. type: verbatim
15678 #: ../src/guestfs-actions.pod:4785
15679 #, no-wrap
15680 msgid ""
15681 " int\n"
15682 " guestfs_mount_options (guestfs_h *g,\n"
15683 "                        const char *options,\n"
15684 "                        const char *device,\n"
15685 "                        const char *mountpoint);\n"
15686 "\n"
15687 msgstr ""
15688
15689 # type: textblock
15690 #. type: textblock
15691 #: ../src/guestfs-actions.pod:4791
15692 msgid ""
15693 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15694 "the mount options as for the L<mount(8)> I<-o> flag."
15695 msgstr ""
15696
15697 # type: textblock
15698 #. type: textblock
15699 #: ../src/guestfs-actions.pod:4795 ../fish/guestfish-actions.pod:3242
15700 msgid ""
15701 "If the C<options> parameter is an empty string, then no options are passed "
15702 "(all options default to whatever the filesystem uses)."
15703 msgstr ""
15704
15705 # type: textblock
15706 #. type: textblock
15707 #: ../src/guestfs-actions.pod:4801 ../src/guestfs-actions.pod:4815
15708 #: ../src/guestfs-actions.pod:4832
15709 msgid "(Added in 1.0.10)"
15710 msgstr ""
15711
15712 # type: =head2
15713 #. type: =head2
15714 #: ../src/guestfs-actions.pod:4803
15715 msgid "guestfs_mount_ro"
15716 msgstr ""
15717
15718 # type: verbatim
15719 #. type: verbatim
15720 #: ../src/guestfs-actions.pod:4805
15721 #, no-wrap
15722 msgid ""
15723 " int\n"
15724 " guestfs_mount_ro (guestfs_h *g,\n"
15725 "                   const char *device,\n"
15726 "                   const char *mountpoint);\n"
15727 "\n"
15728 msgstr ""
15729
15730 # type: textblock
15731 #. type: textblock
15732 #: ../src/guestfs-actions.pod:4810
15733 msgid ""
15734 "This is the same as the C<guestfs_mount> command, but it mounts the "
15735 "filesystem with the read-only (I<-o ro>) flag."
15736 msgstr ""
15737
15738 # type: =head2
15739 #. type: =head2
15740 #: ../src/guestfs-actions.pod:4817
15741 msgid "guestfs_mount_vfs"
15742 msgstr ""
15743
15744 # type: verbatim
15745 #. type: verbatim
15746 #: ../src/guestfs-actions.pod:4819
15747 #, no-wrap
15748 msgid ""
15749 " int\n"
15750 " guestfs_mount_vfs (guestfs_h *g,\n"
15751 "                    const char *options,\n"
15752 "                    const char *vfstype,\n"
15753 "                    const char *device,\n"
15754 "                    const char *mountpoint);\n"
15755 "\n"
15756 msgstr ""
15757
15758 # type: textblock
15759 #. type: textblock
15760 #: ../src/guestfs-actions.pod:4826
15761 msgid ""
15762 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15763 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
15764 "t> flags."
15765 msgstr ""
15766
15767 # type: =head2
15768 #. type: =head2
15769 #: ../src/guestfs-actions.pod:4834
15770 msgid "guestfs_mountpoints"
15771 msgstr ""
15772
15773 # type: verbatim
15774 #. type: verbatim
15775 #: ../src/guestfs-actions.pod:4836
15776 #, no-wrap
15777 msgid ""
15778 " char **\n"
15779 " guestfs_mountpoints (guestfs_h *g);\n"
15780 "\n"
15781 msgstr ""
15782
15783 # type: textblock
15784 #. type: textblock
15785 #: ../src/guestfs-actions.pod:4839
15786 msgid ""
15787 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
15788 "devices.  This one returns a hash table (map) of device name to directory "
15789 "where the device is mounted."
15790 msgstr ""
15791
15792 # type: =head2
15793 #. type: =head2
15794 #: ../src/guestfs-actions.pod:4851
15795 msgid "guestfs_mounts"
15796 msgstr ""
15797
15798 # type: verbatim
15799 #. type: verbatim
15800 #: ../src/guestfs-actions.pod:4853
15801 #, no-wrap
15802 msgid ""
15803 " char **\n"
15804 " guestfs_mounts (guestfs_h *g);\n"
15805 "\n"
15806 msgstr ""
15807
15808 # type: textblock
15809 #. type: textblock
15810 #: ../src/guestfs-actions.pod:4856 ../fish/guestfish-actions.pod:3273
15811 msgid ""
15812 "This returns the list of currently mounted filesystems.  It returns the list "
15813 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
15814 msgstr ""
15815
15816 # type: textblock
15817 #. type: textblock
15818 #: ../src/guestfs-actions.pod:4859 ../fish/guestfish-actions.pod:3276
15819 msgid "Some internal mounts are not shown."
15820 msgstr ""
15821
15822 # type: textblock
15823 #. type: textblock
15824 #: ../src/guestfs-actions.pod:4861
15825 msgid "See also: C<guestfs_mountpoints>"
15826 msgstr ""
15827
15828 # type: =head2
15829 #. type: =head2
15830 #: ../src/guestfs-actions.pod:4869
15831 msgid "guestfs_mv"
15832 msgstr ""
15833
15834 # type: verbatim
15835 #. type: verbatim
15836 #: ../src/guestfs-actions.pod:4871
15837 #, no-wrap
15838 msgid ""
15839 " int\n"
15840 " guestfs_mv (guestfs_h *g,\n"
15841 "             const char *src,\n"
15842 "             const char *dest);\n"
15843 "\n"
15844 msgstr ""
15845
15846 # type: textblock
15847 #. type: textblock
15848 #: ../src/guestfs-actions.pod:4876 ../fish/guestfish-actions.pod:3284
15849 msgid ""
15850 "This moves a file from C<src> to C<dest> where C<dest> is either a "
15851 "destination filename or destination directory."
15852 msgstr ""
15853
15854 # type: =head2
15855 #. type: =head2
15856 #: ../src/guestfs-actions.pod:4883
15857 msgid "guestfs_ntfs_3g_probe"
15858 msgstr ""
15859
15860 # type: verbatim
15861 #. type: verbatim
15862 #: ../src/guestfs-actions.pod:4885
15863 #, no-wrap
15864 msgid ""
15865 " int\n"
15866 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
15867 "                        int rw,\n"
15868 "                        const char *device);\n"
15869 "\n"
15870 msgstr ""
15871
15872 # type: textblock
15873 #. type: textblock
15874 #: ../src/guestfs-actions.pod:4890 ../fish/guestfish-actions.pod:3291
15875 msgid ""
15876 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
15877 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
15878 "write, and some cannot be mounted at all)."
15879 msgstr ""
15880
15881 # type: textblock
15882 #. type: textblock
15883 #: ../src/guestfs-actions.pod:4894 ../fish/guestfish-actions.pod:3295
15884 msgid ""
15885 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
15886 "can be mounted read-write.  Set it to false if you want to test if the "
15887 "volume can be mounted read-only."
15888 msgstr ""
15889
15890 # type: textblock
15891 #. type: textblock
15892 #: ../src/guestfs-actions.pod:4898 ../fish/guestfish-actions.pod:3299
15893 msgid ""
15894 "The return value is an integer which C<0> if the operation would succeed, or "
15895 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
15896 msgstr ""
15897
15898 # type: textblock
15899 #. type: textblock
15900 #: ../src/guestfs-actions.pod:4904
15901 msgid "(Added in 1.0.43)"
15902 msgstr ""
15903
15904 # type: =head2
15905 #. type: =head2
15906 #: ../src/guestfs-actions.pod:4906
15907 msgid "guestfs_ntfsresize"
15908 msgstr ""
15909
15910 # type: verbatim
15911 #. type: verbatim
15912 #: ../src/guestfs-actions.pod:4908
15913 #, no-wrap
15914 msgid ""
15915 " int\n"
15916 " guestfs_ntfsresize (guestfs_h *g,\n"
15917 "                     const char *device);\n"
15918 "\n"
15919 msgstr ""
15920
15921 # type: textblock
15922 #. type: textblock
15923 #: ../src/guestfs-actions.pod:4912 ../fish/guestfish-actions.pod:3307
15924 msgid ""
15925 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
15926 "size of the underlying device.  See also L<ntfsresize(8)>."
15927 msgstr ""
15928
15929 # type: =head2
15930 #. type: =head2
15931 #: ../src/guestfs-actions.pod:4920
15932 msgid "guestfs_ntfsresize_size"
15933 msgstr ""
15934
15935 # type: verbatim
15936 #. type: verbatim
15937 #: ../src/guestfs-actions.pod:4922
15938 #, no-wrap
15939 msgid ""
15940 " int\n"
15941 " guestfs_ntfsresize_size (guestfs_h *g,\n"
15942 "                          const char *device,\n"
15943 "                          int64_t size);\n"
15944 "\n"
15945 msgstr ""
15946
15947 # type: textblock
15948 #. type: textblock
15949 #: ../src/guestfs-actions.pod:4927
15950 msgid ""
15951 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
15952 "to specify the new size (in bytes) explicitly."
15953 msgstr ""
15954
15955 # type: textblock
15956 #. type: textblock
15957 #: ../src/guestfs-actions.pod:4932 ../src/guestfs-actions.pod:5368
15958 #: ../src/guestfs-actions.pod:5441 ../src/guestfs-actions.pod:5707
15959 #: ../src/guestfs-actions.pod:7313
15960 msgid "(Added in 1.3.14)"
15961 msgstr ""
15962
15963 # type: =head2
15964 #. type: =head2
15965 #: ../src/guestfs-actions.pod:4934
15966 msgid "guestfs_part_add"
15967 msgstr ""
15968
15969 # type: verbatim
15970 #. type: verbatim
15971 #: ../src/guestfs-actions.pod:4936
15972 #, no-wrap
15973 msgid ""
15974 " int\n"
15975 " guestfs_part_add (guestfs_h *g,\n"
15976 "                   const char *device,\n"
15977 "                   const char *prlogex,\n"
15978 "                   int64_t startsect,\n"
15979 "                   int64_t endsect);\n"
15980 "\n"
15981 msgstr ""
15982
15983 # type: textblock
15984 #. type: textblock
15985 #: ../src/guestfs-actions.pod:4943
15986 msgid ""
15987 "This command adds a partition to C<device>.  If there is no partition table "
15988 "on the device, call C<guestfs_part_init> first."
15989 msgstr ""
15990
15991 # type: textblock
15992 #. type: textblock
15993 #: ../src/guestfs-actions.pod:4946 ../fish/guestfish-actions.pod:3325
15994 msgid ""
15995 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
15996 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
15997 "C<logical>) and C<e> (or C<extended>) partition types."
15998 msgstr ""
15999
16000 # type: textblock
16001 #. type: textblock
16002 #: ../src/guestfs-actions.pod:4951 ../fish/guestfish-actions.pod:3330
16003 msgid ""
16004 "C<startsect> and C<endsect> are the start and end of the partition in "
16005 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
16006 "from the end of the disk (C<-1> is the last sector)."
16007 msgstr ""
16008
16009 # type: textblock
16010 #. type: textblock
16011 #: ../src/guestfs-actions.pod:4955
16012 msgid ""
16013 "Creating a partition which covers the whole disk is not so easy.  Use "
16014 "C<guestfs_part_disk> to do that."
16015 msgstr ""
16016
16017 # type: textblock
16018 #. type: textblock
16019 #: ../src/guestfs-actions.pod:4960 ../src/guestfs-actions.pod:4998
16020 #: ../src/guestfs-actions.pod:5051 ../src/guestfs-actions.pod:5129
16021 #: ../src/guestfs-actions.pod:5167 ../src/guestfs-actions.pod:5186
16022 #: ../src/guestfs-actions.pod:5226
16023 msgid "(Added in 1.0.78)"
16024 msgstr ""
16025
16026 # type: =head2
16027 #. type: =head2
16028 #: ../src/guestfs-actions.pod:4962
16029 msgid "guestfs_part_del"
16030 msgstr ""
16031
16032 # type: verbatim
16033 #. type: verbatim
16034 #: ../src/guestfs-actions.pod:4964
16035 #, no-wrap
16036 msgid ""
16037 " int\n"
16038 " guestfs_part_del (guestfs_h *g,\n"
16039 "                   const char *device,\n"
16040 "                   int partnum);\n"
16041 "\n"
16042 msgstr ""
16043
16044 # type: textblock
16045 #. type: textblock
16046 #: ../src/guestfs-actions.pod:4969 ../fish/guestfish-actions.pod:3341
16047 msgid "This command deletes the partition numbered C<partnum> on C<device>."
16048 msgstr ""
16049
16050 # type: textblock
16051 #. type: textblock
16052 #: ../src/guestfs-actions.pod:4971 ../fish/guestfish-actions.pod:3343
16053 msgid ""
16054 "Note that in the case of MBR partitioning, deleting an extended partition "
16055 "also deletes any logical partitions it contains."
16056 msgstr ""
16057
16058 # type: =head2
16059 #. type: =head2
16060 #: ../src/guestfs-actions.pod:4979
16061 msgid "guestfs_part_disk"
16062 msgstr ""
16063
16064 # type: verbatim
16065 #. type: verbatim
16066 #: ../src/guestfs-actions.pod:4981
16067 #, no-wrap
16068 msgid ""
16069 " int\n"
16070 " guestfs_part_disk (guestfs_h *g,\n"
16071 "                    const char *device,\n"
16072 "                    const char *parttype);\n"
16073 "\n"
16074 msgstr ""
16075
16076 # type: textblock
16077 #. type: textblock
16078 #: ../src/guestfs-actions.pod:4986
16079 msgid ""
16080 "This command is simply a combination of C<guestfs_part_init> followed by "
16081 "C<guestfs_part_add> to create a single primary partition covering the whole "
16082 "disk."
16083 msgstr ""
16084
16085 # type: textblock
16086 #. type: textblock
16087 #: ../src/guestfs-actions.pod:4990
16088 msgid ""
16089 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
16090 "possible values are described in C<guestfs_part_init>."
16091 msgstr ""
16092
16093 # type: =head2
16094 #. type: =head2
16095 #: ../src/guestfs-actions.pod:5000
16096 msgid "guestfs_part_get_bootable"
16097 msgstr ""
16098
16099 # type: verbatim
16100 #. type: verbatim
16101 #: ../src/guestfs-actions.pod:5002
16102 #, no-wrap
16103 msgid ""
16104 " int\n"
16105 " guestfs_part_get_bootable (guestfs_h *g,\n"
16106 "                            const char *device,\n"
16107 "                            int partnum);\n"
16108 "\n"
16109 msgstr ""
16110
16111 # type: textblock
16112 #. type: textblock
16113 #: ../src/guestfs-actions.pod:5007 ../fish/guestfish-actions.pod:3365
16114 msgid ""
16115 "This command returns true if the partition C<partnum> on C<device> has the "
16116 "bootable flag set."
16117 msgstr ""
16118
16119 # type: textblock
16120 #. type: textblock
16121 #: ../src/guestfs-actions.pod:5010
16122 msgid "See also C<guestfs_part_set_bootable>."
16123 msgstr ""
16124
16125 # type: =head2
16126 #. type: =head2
16127 #: ../src/guestfs-actions.pod:5016
16128 msgid "guestfs_part_get_mbr_id"
16129 msgstr ""
16130
16131 # type: verbatim
16132 #. type: verbatim
16133 #: ../src/guestfs-actions.pod:5018
16134 #, no-wrap
16135 msgid ""
16136 " int\n"
16137 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
16138 "                          const char *device,\n"
16139 "                          int partnum);\n"
16140 "\n"
16141 msgstr ""
16142
16143 # type: textblock
16144 #. type: textblock
16145 #: ../src/guestfs-actions.pod:5023 ../fish/guestfish-actions.pod:3374
16146 msgid ""
16147 "Returns the MBR type byte (also known as the ID byte) from the numbered "
16148 "partition C<partnum>."
16149 msgstr ""
16150
16151 # type: textblock
16152 #. type: textblock
16153 #: ../src/guestfs-actions.pod:5026 ../src/guestfs-actions.pod:5202
16154 msgid ""
16155 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
16156 "undefined results for other partition table types (see "
16157 "C<guestfs_part_get_parttype>)."
16158 msgstr ""
16159
16160 # type: =head2
16161 #. type: =head2
16162 #: ../src/guestfs-actions.pod:5034
16163 msgid "guestfs_part_get_parttype"
16164 msgstr ""
16165
16166 # type: verbatim
16167 #. type: verbatim
16168 #: ../src/guestfs-actions.pod:5036
16169 #, no-wrap
16170 msgid ""
16171 " char *\n"
16172 " guestfs_part_get_parttype (guestfs_h *g,\n"
16173 "                            const char *device);\n"
16174 "\n"
16175 msgstr ""
16176
16177 # type: textblock
16178 #. type: textblock
16179 #: ../src/guestfs-actions.pod:5040 ../fish/guestfish-actions.pod:3385
16180 msgid ""
16181 "This command examines the partition table on C<device> and returns the "
16182 "partition table type (format) being used."
16183 msgstr ""
16184
16185 # type: textblock
16186 #. type: textblock
16187 #: ../src/guestfs-actions.pod:5043
16188 msgid ""
16189 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
16190 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
16191 "possible, although unusual.  See C<guestfs_part_init> for a full list."
16192 msgstr ""
16193
16194 # type: =head2
16195 #. type: =head2
16196 #: ../src/guestfs-actions.pod:5053
16197 msgid "guestfs_part_init"
16198 msgstr ""
16199
16200 # type: verbatim
16201 #. type: verbatim
16202 #: ../src/guestfs-actions.pod:5055
16203 #, no-wrap
16204 msgid ""
16205 " int\n"
16206 " guestfs_part_init (guestfs_h *g,\n"
16207 "                    const char *device,\n"
16208 "                    const char *parttype);\n"
16209 "\n"
16210 msgstr ""
16211
16212 # type: textblock
16213 #. type: textblock
16214 #: ../src/guestfs-actions.pod:5060 ../fish/guestfish-actions.pod:3397
16215 msgid ""
16216 "This creates an empty partition table on C<device> of one of the partition "
16217 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
16218 "(for large disks)."
16219 msgstr ""
16220
16221 # type: textblock
16222 #. type: textblock
16223 #: ../src/guestfs-actions.pod:5064
16224 msgid ""
16225 "Initially there are no partitions.  Following this, you should call "
16226 "C<guestfs_part_add> for each partition required."
16227 msgstr ""
16228
16229 # type: textblock
16230 #. type: textblock
16231 #: ../src/guestfs-actions.pod:5067 ../fish/guestfish-actions.pod:3404
16232 msgid "Possible values for C<parttype> are:"
16233 msgstr ""
16234
16235 # type: =item
16236 #. type: =item
16237 #: ../src/guestfs-actions.pod:5071 ../fish/guestfish-actions.pod:3408
16238 msgid "B<efi> | B<gpt>"
16239 msgstr ""
16240
16241 # type: textblock
16242 #. type: textblock
16243 #: ../src/guestfs-actions.pod:5073 ../fish/guestfish-actions.pod:3410
16244 msgid "Intel EFI / GPT partition table."
16245 msgstr ""
16246
16247 # type: textblock
16248 #. type: textblock
16249 #: ../src/guestfs-actions.pod:5075 ../fish/guestfish-actions.pod:3412
16250 msgid ""
16251 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
16252 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
16253 "the C<mbr> format."
16254 msgstr ""
16255
16256 # type: =item
16257 #. type: =item
16258 #: ../src/guestfs-actions.pod:5079 ../fish/guestfish-actions.pod:3416
16259 msgid "B<mbr> | B<msdos>"
16260 msgstr ""
16261
16262 # type: textblock
16263 #. type: textblock
16264 #: ../src/guestfs-actions.pod:5081 ../fish/guestfish-actions.pod:3418
16265 msgid ""
16266 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
16267 "Windows.  This partition type will B<only> work for device sizes up to 2 "
16268 "TB.  For large disks we recommend using C<gpt>."
16269 msgstr ""
16270
16271 # type: textblock
16272 #. type: textblock
16273 #: ../src/guestfs-actions.pod:5088 ../fish/guestfish-actions.pod:3425
16274 msgid ""
16275 "Other partition table types that may work but are not supported include:"
16276 msgstr ""
16277
16278 # type: =item
16279 #. type: =item
16280 #: ../src/guestfs-actions.pod:5093 ../fish/guestfish-actions.pod:3430
16281 msgid "B<aix>"
16282 msgstr ""
16283
16284 # type: textblock
16285 #. type: textblock
16286 #: ../src/guestfs-actions.pod:5095 ../fish/guestfish-actions.pod:3432
16287 msgid "AIX disk labels."
16288 msgstr ""
16289
16290 # type: =item
16291 #. type: =item
16292 #: ../src/guestfs-actions.pod:5097 ../fish/guestfish-actions.pod:3434
16293 msgid "B<amiga> | B<rdb>"
16294 msgstr ""
16295
16296 # type: textblock
16297 #. type: textblock
16298 #: ../src/guestfs-actions.pod:5099 ../fish/guestfish-actions.pod:3436
16299 msgid "Amiga \"Rigid Disk Block\" format."
16300 msgstr ""
16301
16302 # type: =item
16303 #. type: =item
16304 #: ../src/guestfs-actions.pod:5101 ../fish/guestfish-actions.pod:3438
16305 msgid "B<bsd>"
16306 msgstr ""
16307
16308 # type: textblock
16309 #. type: textblock
16310 #: ../src/guestfs-actions.pod:5103 ../fish/guestfish-actions.pod:3440
16311 msgid "BSD disk labels."
16312 msgstr ""
16313
16314 # type: =item
16315 #. type: =item
16316 #: ../src/guestfs-actions.pod:5105 ../fish/guestfish-actions.pod:3442
16317 msgid "B<dasd>"
16318 msgstr ""
16319
16320 # type: textblock
16321 #. type: textblock
16322 #: ../src/guestfs-actions.pod:5107 ../fish/guestfish-actions.pod:3444
16323 msgid "DASD, used on IBM mainframes."
16324 msgstr ""
16325
16326 # type: =item
16327 #. type: =item
16328 #: ../src/guestfs-actions.pod:5109 ../fish/guestfish-actions.pod:3446
16329 msgid "B<dvh>"
16330 msgstr ""
16331
16332 # type: textblock
16333 #. type: textblock
16334 #: ../src/guestfs-actions.pod:5111 ../fish/guestfish-actions.pod:3448
16335 msgid "MIPS/SGI volumes."
16336 msgstr ""
16337
16338 # type: =item
16339 #. type: =item
16340 #: ../src/guestfs-actions.pod:5113 ../fish/guestfish-actions.pod:3450
16341 msgid "B<mac>"
16342 msgstr ""
16343
16344 # type: textblock
16345 #. type: textblock
16346 #: ../src/guestfs-actions.pod:5115 ../fish/guestfish-actions.pod:3452
16347 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
16348 msgstr ""
16349
16350 # type: =item
16351 #. type: =item
16352 #: ../src/guestfs-actions.pod:5117 ../fish/guestfish-actions.pod:3454
16353 msgid "B<pc98>"
16354 msgstr ""
16355
16356 # type: textblock
16357 #. type: textblock
16358 #: ../src/guestfs-actions.pod:5119 ../fish/guestfish-actions.pod:3456
16359 msgid "NEC PC-98 format, common in Japan apparently."
16360 msgstr ""
16361
16362 # type: =item
16363 #. type: =item
16364 #: ../src/guestfs-actions.pod:5121 ../fish/guestfish-actions.pod:3458
16365 msgid "B<sun>"
16366 msgstr ""
16367
16368 # type: textblock
16369 #. type: textblock
16370 #: ../src/guestfs-actions.pod:5123 ../fish/guestfish-actions.pod:3460
16371 msgid "Sun disk labels."
16372 msgstr ""
16373
16374 # type: =head2
16375 #. type: =head2
16376 #: ../src/guestfs-actions.pod:5131
16377 msgid "guestfs_part_list"
16378 msgstr ""
16379
16380 # type: verbatim
16381 #. type: verbatim
16382 #: ../src/guestfs-actions.pod:5133
16383 #, no-wrap
16384 msgid ""
16385 " struct guestfs_partition_list *\n"
16386 " guestfs_part_list (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:5137 ../fish/guestfish-actions.pod:3468
16394 msgid ""
16395 "This command parses the partition table on C<device> and returns the list of "
16396 "partitions found."
16397 msgstr ""
16398
16399 # type: textblock
16400 #. type: textblock
16401 #: ../src/guestfs-actions.pod:5140 ../fish/guestfish-actions.pod:3471
16402 msgid "The fields in the returned structure are:"
16403 msgstr ""
16404
16405 # type: =item
16406 #. type: =item
16407 #: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:3475
16408 msgid "B<part_num>"
16409 msgstr ""
16410
16411 # type: textblock
16412 #. type: textblock
16413 #: ../src/guestfs-actions.pod:5146 ../fish/guestfish-actions.pod:3477
16414 msgid "Partition number, counting from 1."
16415 msgstr ""
16416
16417 # type: =item
16418 #. type: =item
16419 #: ../src/guestfs-actions.pod:5148 ../fish/guestfish-actions.pod:3479
16420 msgid "B<part_start>"
16421 msgstr ""
16422
16423 # type: textblock
16424 #. type: textblock
16425 #: ../src/guestfs-actions.pod:5150
16426 msgid ""
16427 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
16428 "the device's sector size, see C<guestfs_blockdev_getss>."
16429 msgstr ""
16430
16431 # type: =item
16432 #. type: =item
16433 #: ../src/guestfs-actions.pod:5153 ../fish/guestfish-actions.pod:3484
16434 msgid "B<part_end>"
16435 msgstr ""
16436
16437 # type: textblock
16438 #. type: textblock
16439 #: ../src/guestfs-actions.pod:5155 ../fish/guestfish-actions.pod:3486
16440 msgid "End of the partition in bytes."
16441 msgstr ""
16442
16443 # type: =item
16444 #. type: =item
16445 #: ../src/guestfs-actions.pod:5157 ../fish/guestfish-actions.pod:3488
16446 msgid "B<part_size>"
16447 msgstr ""
16448
16449 # type: textblock
16450 #. type: textblock
16451 #: ../src/guestfs-actions.pod:5159 ../fish/guestfish-actions.pod:3490
16452 msgid "Size of the partition in bytes."
16453 msgstr ""
16454
16455 # type: textblock
16456 #. type: textblock
16457 #: ../src/guestfs-actions.pod:5163
16458 msgid ""
16459 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
16460 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
16461 "use>."
16462 msgstr ""
16463
16464 # type: =head2
16465 #. type: =head2
16466 #: ../src/guestfs-actions.pod:5169
16467 msgid "guestfs_part_set_bootable"
16468 msgstr ""
16469
16470 # type: verbatim
16471 #. type: verbatim
16472 #: ../src/guestfs-actions.pod:5171
16473 #, no-wrap
16474 msgid ""
16475 " int\n"
16476 " guestfs_part_set_bootable (guestfs_h *g,\n"
16477 "                            const char *device,\n"
16478 "                            int partnum,\n"
16479 "                            int bootable);\n"
16480 "\n"
16481 msgstr ""
16482
16483 # type: textblock
16484 #. type: textblock
16485 #: ../src/guestfs-actions.pod:5177 ../fish/guestfish-actions.pod:3498
16486 msgid ""
16487 "This sets the bootable flag on partition numbered C<partnum> on device "
16488 "C<device>.  Note that partitions are numbered from 1."
16489 msgstr ""
16490
16491 # type: textblock
16492 #. type: textblock
16493 #: ../src/guestfs-actions.pod:5180 ../fish/guestfish-actions.pod:3501
16494 msgid ""
16495 "The bootable flag is used by some operating systems (notably Windows) to "
16496 "determine which partition to boot from.  It is by no means universally "
16497 "recognized."
16498 msgstr ""
16499
16500 # type: =head2
16501 #. type: =head2
16502 #: ../src/guestfs-actions.pod:5188
16503 msgid "guestfs_part_set_mbr_id"
16504 msgstr ""
16505
16506 # type: verbatim
16507 #. type: verbatim
16508 #: ../src/guestfs-actions.pod:5190
16509 #, no-wrap
16510 msgid ""
16511 " int\n"
16512 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
16513 "                          const char *device,\n"
16514 "                          int partnum,\n"
16515 "                          int idbyte);\n"
16516 "\n"
16517 msgstr ""
16518
16519 # type: textblock
16520 #. type: textblock
16521 #: ../src/guestfs-actions.pod:5196 ../fish/guestfish-actions.pod:3509
16522 msgid ""
16523 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
16524 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
16525 "documentation are in fact hexadecimal numbers, but usually documented "
16526 "without any leading \"0x\" which might be confusing."
16527 msgstr ""
16528
16529 # type: =head2
16530 #. type: =head2
16531 #: ../src/guestfs-actions.pod:5210
16532 msgid "guestfs_part_set_name"
16533 msgstr ""
16534
16535 # type: verbatim
16536 #. type: verbatim
16537 #: ../src/guestfs-actions.pod:5212
16538 #, no-wrap
16539 msgid ""
16540 " int\n"
16541 " guestfs_part_set_name (guestfs_h *g,\n"
16542 "                        const char *device,\n"
16543 "                        int partnum,\n"
16544 "                        const char *name);\n"
16545 "\n"
16546 msgstr ""
16547
16548 # type: textblock
16549 #. type: textblock
16550 #: ../src/guestfs-actions.pod:5218 ../fish/guestfish-actions.pod:3523
16551 msgid ""
16552 "This sets the partition name on partition numbered C<partnum> on device "
16553 "C<device>.  Note that partitions are numbered from 1."
16554 msgstr ""
16555
16556 # type: textblock
16557 #. type: textblock
16558 #: ../src/guestfs-actions.pod:5221 ../fish/guestfish-actions.pod:3526
16559 msgid ""
16560 "The partition name can only be set on certain types of partition table.  "
16561 "This works on C<gpt> but not on C<mbr> partitions."
16562 msgstr ""
16563
16564 # type: =head2
16565 #. type: =head2
16566 #: ../src/guestfs-actions.pod:5228
16567 msgid "guestfs_part_to_dev"
16568 msgstr ""
16569
16570 # type: verbatim
16571 #. type: verbatim
16572 #: ../src/guestfs-actions.pod:5230
16573 #, no-wrap
16574 msgid ""
16575 " char *\n"
16576 " guestfs_part_to_dev (guestfs_h *g,\n"
16577 "                      const char *partition);\n"
16578 "\n"
16579 msgstr ""
16580
16581 # type: textblock
16582 #. type: textblock
16583 #: ../src/guestfs-actions.pod:5234 ../fish/guestfish-actions.pod:3533
16584 msgid ""
16585 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
16586 "partition number, returning the device name (eg. \"/dev/sdb\")."
16587 msgstr ""
16588
16589 # type: textblock
16590 #. type: textblock
16591 #: ../src/guestfs-actions.pod:5238
16592 msgid ""
16593 "The named partition must exist, for example as a string returned from "
16594 "C<guestfs_list_partitions>."
16595 msgstr ""
16596
16597 # type: =head2
16598 #. type: =head2
16599 #: ../src/guestfs-actions.pod:5246
16600 msgid "guestfs_ping_daemon"
16601 msgstr ""
16602
16603 # type: verbatim
16604 #. type: verbatim
16605 #: ../src/guestfs-actions.pod:5248
16606 #, no-wrap
16607 msgid ""
16608 " int\n"
16609 " guestfs_ping_daemon (guestfs_h *g);\n"
16610 "\n"
16611 msgstr ""
16612
16613 # type: textblock
16614 #. type: textblock
16615 #: ../src/guestfs-actions.pod:5251 ../fish/guestfish-actions.pod:3544
16616 msgid ""
16617 "This is a test probe into the guestfs daemon running inside the qemu "
16618 "subprocess.  Calling this function checks that the daemon responds to the "
16619 "ping message, without affecting the daemon or attached block device(s) in "
16620 "any other way."
16621 msgstr ""
16622
16623 # type: =head2
16624 #. type: =head2
16625 #: ../src/guestfs-actions.pod:5260
16626 msgid "guestfs_pread"
16627 msgstr ""
16628
16629 # type: verbatim
16630 #. type: verbatim
16631 #: ../src/guestfs-actions.pod:5262
16632 #, no-wrap
16633 msgid ""
16634 " char *\n"
16635 " guestfs_pread (guestfs_h *g,\n"
16636 "                const char *path,\n"
16637 "                int count,\n"
16638 "                int64_t offset,\n"
16639 "                size_t *size_r);\n"
16640 "\n"
16641 msgstr ""
16642
16643 # type: textblock
16644 #. type: textblock
16645 #: ../src/guestfs-actions.pod:5269 ../fish/guestfish-actions.pod:3553
16646 msgid ""
16647 "This command lets you read part of a file.  It reads C<count> bytes of the "
16648 "file, starting at C<offset>, from file C<path>."
16649 msgstr ""
16650
16651 # type: textblock
16652 #. type: textblock
16653 #: ../src/guestfs-actions.pod:5272 ../src/guestfs-actions.pod:5298
16654 #: ../fish/guestfish-actions.pod:3556 ../fish/guestfish-actions.pod:3571
16655 msgid ""
16656 "This may read fewer bytes than requested.  For further details see the "
16657 "L<pread(2)> system call."
16658 msgstr ""
16659
16660 # type: textblock
16661 #. type: textblock
16662 #: ../src/guestfs-actions.pod:5275
16663 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
16664 msgstr ""
16665
16666 # type: =head2
16667 #. type: =head2
16668 #: ../src/guestfs-actions.pod:5286
16669 msgid "guestfs_pread_device"
16670 msgstr ""
16671
16672 # type: verbatim
16673 #. type: verbatim
16674 #: ../src/guestfs-actions.pod:5288
16675 #, no-wrap
16676 msgid ""
16677 " char *\n"
16678 " guestfs_pread_device (guestfs_h *g,\n"
16679 "                       const char *device,\n"
16680 "                       int count,\n"
16681 "                       int64_t offset,\n"
16682 "                       size_t *size_r);\n"
16683 "\n"
16684 msgstr ""
16685
16686 # type: textblock
16687 #. type: textblock
16688 #: ../src/guestfs-actions.pod:5295 ../fish/guestfish-actions.pod:3568
16689 msgid ""
16690 "This command lets you read part of a file.  It reads C<count> bytes of "
16691 "C<device>, starting at C<offset>."
16692 msgstr ""
16693
16694 # type: textblock
16695 #. type: textblock
16696 #: ../src/guestfs-actions.pod:5301
16697 msgid "See also C<guestfs_pread>."
16698 msgstr ""
16699
16700 # type: textblock
16701 #. type: textblock
16702 #: ../src/guestfs-actions.pod:5310
16703 msgid "(Added in 1.5.21)"
16704 msgstr ""
16705
16706 # type: =head2
16707 #. type: =head2
16708 #: ../src/guestfs-actions.pod:5312
16709 msgid "guestfs_pvcreate"
16710 msgstr ""
16711
16712 # type: verbatim
16713 #. type: verbatim
16714 #: ../src/guestfs-actions.pod:5314
16715 #, no-wrap
16716 msgid ""
16717 " int\n"
16718 " guestfs_pvcreate (guestfs_h *g,\n"
16719 "                   const char *device);\n"
16720 "\n"
16721 msgstr ""
16722
16723 # type: textblock
16724 #. type: textblock
16725 #: ../src/guestfs-actions.pod:5318 ../fish/guestfish-actions.pod:3583
16726 msgid ""
16727 "This creates an LVM physical volume on the named C<device>, where C<device> "
16728 "should usually be a partition name such as C</dev/sda1>."
16729 msgstr ""
16730
16731 # type: =head2
16732 #. type: =head2
16733 #: ../src/guestfs-actions.pod:5326
16734 msgid "guestfs_pvremove"
16735 msgstr ""
16736
16737 # type: verbatim
16738 #. type: verbatim
16739 #: ../src/guestfs-actions.pod:5328
16740 #, no-wrap
16741 msgid ""
16742 " int\n"
16743 " guestfs_pvremove (guestfs_h *g,\n"
16744 "                   const char *device);\n"
16745 "\n"
16746 msgstr ""
16747
16748 # type: textblock
16749 #. type: textblock
16750 #: ../src/guestfs-actions.pod:5332 ../fish/guestfish-actions.pod:3591
16751 msgid ""
16752 "This wipes a physical volume C<device> so that LVM will no longer recognise "
16753 "it."
16754 msgstr ""
16755
16756 # type: textblock
16757 #. type: textblock
16758 #: ../src/guestfs-actions.pod:5335 ../fish/guestfish-actions.pod:3594
16759 msgid ""
16760 "The implementation uses the C<pvremove> command which refuses to wipe "
16761 "physical volumes that contain any volume groups, so you have to remove those "
16762 "first."
16763 msgstr ""
16764
16765 # type: =head2
16766 #. type: =head2
16767 #: ../src/guestfs-actions.pod:5343
16768 msgid "guestfs_pvresize"
16769 msgstr ""
16770
16771 # type: verbatim
16772 #. type: verbatim
16773 #: ../src/guestfs-actions.pod:5345
16774 #, no-wrap
16775 msgid ""
16776 " int\n"
16777 " guestfs_pvresize (guestfs_h *g,\n"
16778 "                   const char *device);\n"
16779 "\n"
16780 msgstr ""
16781
16782 # type: textblock
16783 #. type: textblock
16784 #: ../src/guestfs-actions.pod:5349 ../fish/guestfish-actions.pod:3602
16785 msgid ""
16786 "This resizes (expands or shrinks) an existing LVM physical volume to match "
16787 "the new size of the underlying device."
16788 msgstr ""
16789
16790 # type: =head2
16791 #. type: =head2
16792 #: ../src/guestfs-actions.pod:5356
16793 msgid "guestfs_pvresize_size"
16794 msgstr ""
16795
16796 # type: verbatim
16797 #. type: verbatim
16798 #: ../src/guestfs-actions.pod:5358
16799 #, no-wrap
16800 msgid ""
16801 " int\n"
16802 " guestfs_pvresize_size (guestfs_h *g,\n"
16803 "                        const char *device,\n"
16804 "                        int64_t size);\n"
16805 "\n"
16806 msgstr ""
16807
16808 # type: textblock
16809 #. type: textblock
16810 #: ../src/guestfs-actions.pod:5363
16811 msgid ""
16812 "This command is the same as C<guestfs_pvresize> except that it allows you to "
16813 "specify the new size (in bytes) explicitly."
16814 msgstr ""
16815
16816 # type: =head2
16817 #. type: =head2
16818 #: ../src/guestfs-actions.pod:5370
16819 msgid "guestfs_pvs"
16820 msgstr ""
16821
16822 # type: verbatim
16823 #. type: verbatim
16824 #: ../src/guestfs-actions.pod:5372
16825 #, no-wrap
16826 msgid ""
16827 " char **\n"
16828 " guestfs_pvs (guestfs_h *g);\n"
16829 "\n"
16830 msgstr ""
16831
16832 # type: textblock
16833 #. type: textblock
16834 #: ../src/guestfs-actions.pod:5375 ../fish/guestfish-actions.pod:3616
16835 msgid ""
16836 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16837 "(8)> command."
16838 msgstr ""
16839
16840 # type: textblock
16841 #. type: textblock
16842 #: ../src/guestfs-actions.pod:5378 ../fish/guestfish-actions.pod:3619
16843 msgid ""
16844 "This returns a list of just the device names that contain PVs (eg. C</dev/"
16845 "sda2>)."
16846 msgstr ""
16847
16848 # type: textblock
16849 #. type: textblock
16850 #: ../src/guestfs-actions.pod:5381
16851 msgid "See also C<guestfs_pvs_full>."
16852 msgstr ""
16853
16854 # type: =head2
16855 #. type: =head2
16856 #: ../src/guestfs-actions.pod:5389
16857 msgid "guestfs_pvs_full"
16858 msgstr ""
16859
16860 # type: verbatim
16861 #. type: verbatim
16862 #: ../src/guestfs-actions.pod:5391
16863 #, no-wrap
16864 msgid ""
16865 " struct guestfs_lvm_pv_list *\n"
16866 " guestfs_pvs_full (guestfs_h *g);\n"
16867 "\n"
16868 msgstr ""
16869
16870 # type: textblock
16871 #. type: textblock
16872 #: ../src/guestfs-actions.pod:5394 ../fish/guestfish-actions.pod:3628
16873 msgid ""
16874 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16875 "(8)> command.  The \"full\" version includes all fields."
16876 msgstr ""
16877
16878 # type: textblock
16879 #. type: textblock
16880 #: ../src/guestfs-actions.pod:5397
16881 msgid ""
16882 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
16883 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
16884 msgstr ""
16885
16886 # type: =head2
16887 #. type: =head2
16888 #: ../src/guestfs-actions.pod:5403
16889 msgid "guestfs_pvuuid"
16890 msgstr ""
16891
16892 # type: verbatim
16893 #. type: verbatim
16894 #: ../src/guestfs-actions.pod:5405
16895 #, no-wrap
16896 msgid ""
16897 " char *\n"
16898 " guestfs_pvuuid (guestfs_h *g,\n"
16899 "                 const char *device);\n"
16900 "\n"
16901 msgstr ""
16902
16903 # type: textblock
16904 #. type: textblock
16905 #: ../src/guestfs-actions.pod:5409 ../fish/guestfish-actions.pod:3635
16906 msgid "This command returns the UUID of the LVM PV C<device>."
16907 msgstr ""
16908
16909 # type: =head2
16910 #. type: =head2
16911 #: ../src/guestfs-actions.pod:5416
16912 msgid "guestfs_pwrite"
16913 msgstr ""
16914
16915 # type: verbatim
16916 #. type: verbatim
16917 #: ../src/guestfs-actions.pod:5418
16918 #, no-wrap
16919 msgid ""
16920 " int\n"
16921 " guestfs_pwrite (guestfs_h *g,\n"
16922 "                 const char *path,\n"
16923 "                 const char *content,\n"
16924 "                 size_t content_size,\n"
16925 "                 int64_t offset);\n"
16926 "\n"
16927 msgstr ""
16928
16929 # type: textblock
16930 #. type: textblock
16931 #: ../src/guestfs-actions.pod:5425 ../fish/guestfish-actions.pod:3641
16932 msgid ""
16933 "This command writes to part of a file.  It writes the data buffer C<content> "
16934 "to the file C<path> starting at offset C<offset>."
16935 msgstr ""
16936
16937 # type: textblock
16938 #. type: textblock
16939 #: ../src/guestfs-actions.pod:5428 ../fish/guestfish-actions.pod:3644
16940 msgid ""
16941 "This command implements the L<pwrite(2)> system call, and like that system "
16942 "call it may not write the full data requested.  The return value is the "
16943 "number of bytes that were actually written to the file.  This could even be "
16944 "0, although short writes are unlikely for regular files in ordinary "
16945 "circumstances."
16946 msgstr ""
16947
16948 # type: textblock
16949 #. type: textblock
16950 #: ../src/guestfs-actions.pod:5434
16951 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
16952 msgstr ""
16953
16954 # type: =head2
16955 #. type: =head2
16956 #: ../src/guestfs-actions.pod:5443
16957 msgid "guestfs_pwrite_device"
16958 msgstr ""
16959
16960 # type: verbatim
16961 #. type: verbatim
16962 #: ../src/guestfs-actions.pod:5445
16963 #, no-wrap
16964 msgid ""
16965 " int\n"
16966 " guestfs_pwrite_device (guestfs_h *g,\n"
16967 "                        const char *device,\n"
16968 "                        const char *content,\n"
16969 "                        size_t content_size,\n"
16970 "                        int64_t offset);\n"
16971 "\n"
16972 msgstr ""
16973
16974 # type: textblock
16975 #. type: textblock
16976 #: ../src/guestfs-actions.pod:5452 ../fish/guestfish-actions.pod:3659
16977 msgid ""
16978 "This command writes to part of a device.  It writes the data buffer "
16979 "C<content> to C<device> starting at offset C<offset>."
16980 msgstr ""
16981
16982 # type: textblock
16983 #. type: textblock
16984 #: ../src/guestfs-actions.pod:5455 ../fish/guestfish-actions.pod:3662
16985 msgid ""
16986 "This command implements the L<pwrite(2)> system call, and like that system "
16987 "call it may not write the full data requested (although short writes to disk "
16988 "devices and partitions are probably impossible with standard Linux kernels)."
16989 msgstr ""
16990
16991 # type: textblock
16992 #. type: textblock
16993 #: ../src/guestfs-actions.pod:5460
16994 msgid "See also C<guestfs_pwrite>."
16995 msgstr ""
16996
16997 # type: textblock
16998 #. type: textblock
16999 #: ../src/guestfs-actions.pod:5467
17000 msgid "(Added in 1.5.20)"
17001 msgstr ""
17002
17003 # type: =head2
17004 #. type: =head2
17005 #: ../src/guestfs-actions.pod:5469
17006 msgid "guestfs_read_file"
17007 msgstr ""
17008
17009 # type: verbatim
17010 #. type: verbatim
17011 #: ../src/guestfs-actions.pod:5471
17012 #, no-wrap
17013 msgid ""
17014 " char *\n"
17015 " guestfs_read_file (guestfs_h *g,\n"
17016 "                    const char *path,\n"
17017 "                    size_t *size_r);\n"
17018 "\n"
17019 msgstr ""
17020
17021 # type: textblock
17022 #. type: textblock
17023 #: ../src/guestfs-actions.pod:5476 ../fish/guestfish-actions.pod:3676
17024 msgid "This calls returns the contents of the file C<path> as a buffer."
17025 msgstr ""
17026
17027 # type: textblock
17028 #. type: textblock
17029 #: ../src/guestfs-actions.pod:5479
17030 msgid ""
17031 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
17032 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
17033 "function is limited in the total size of file that can be handled."
17034 msgstr ""
17035
17036 # type: textblock
17037 #. type: textblock
17038 #: ../src/guestfs-actions.pod:5491
17039 msgid "(Added in 1.0.63)"
17040 msgstr ""
17041
17042 # type: =head2
17043 #. type: =head2
17044 #: ../src/guestfs-actions.pod:5493
17045 msgid "guestfs_read_lines"
17046 msgstr ""
17047
17048 # type: verbatim
17049 #. type: verbatim
17050 #: ../src/guestfs-actions.pod:5495
17051 #, no-wrap
17052 msgid ""
17053 " char **\n"
17054 " guestfs_read_lines (guestfs_h *g,\n"
17055 "                     const char *path);\n"
17056 "\n"
17057 msgstr ""
17058
17059 # type: textblock
17060 #. type: textblock
17061 #: ../src/guestfs-actions.pod:5501 ../fish/guestfish-actions.pod:3693
17062 msgid ""
17063 "The file contents are returned as a list of lines.  Trailing C<LF> and "
17064 "C<CRLF> character sequences are I<not> returned."
17065 msgstr ""
17066
17067 # type: textblock
17068 #. type: textblock
17069 #: ../src/guestfs-actions.pod:5504
17070 msgid ""
17071 "Note that this function cannot correctly handle binary files (specifically, "
17072 "files containing C<\\0> character which is treated as end of line).  For "
17073 "those you need to use the C<guestfs_read_file> function which has a more "
17074 "complex interface."
17075 msgstr ""
17076
17077 # type: =head2
17078 #. type: =head2
17079 #: ../src/guestfs-actions.pod:5515
17080 msgid "guestfs_readdir"
17081 msgstr ""
17082
17083 # type: verbatim
17084 #. type: verbatim
17085 #: ../src/guestfs-actions.pod:5517
17086 #, no-wrap
17087 msgid ""
17088 " struct guestfs_dirent_list *\n"
17089 " guestfs_readdir (guestfs_h *g,\n"
17090 "                  const char *dir);\n"
17091 "\n"
17092 msgstr ""
17093
17094 # type: textblock
17095 #. type: textblock
17096 #: ../src/guestfs-actions.pod:5521 ../fish/guestfish-actions.pod:3705
17097 msgid "This returns the list of directory entries in directory C<dir>."
17098 msgstr ""
17099
17100 # type: textblock
17101 #. type: textblock
17102 #: ../src/guestfs-actions.pod:5523 ../fish/guestfish-actions.pod:3707
17103 msgid ""
17104 "All entries in the directory are returned, including C<.> and C<..>.  The "
17105 "entries are I<not> sorted, but returned in the same order as the underlying "
17106 "filesystem."
17107 msgstr ""
17108
17109 # type: textblock
17110 #. type: textblock
17111 #: ../src/guestfs-actions.pod:5527 ../fish/guestfish-actions.pod:3711
17112 msgid ""
17113 "Also this call returns basic file type information about each file.  The "
17114 "C<ftyp> field will contain one of the following characters:"
17115 msgstr ""
17116
17117 # type: =item
17118 #. type: =item
17119 #: ../src/guestfs-actions.pod:5532 ../fish/guestfish-actions.pod:3716
17120 msgid "'b'"
17121 msgstr ""
17122
17123 # type: textblock
17124 #. type: textblock
17125 #: ../src/guestfs-actions.pod:5534 ../fish/guestfish-actions.pod:3718
17126 msgid "Block special"
17127 msgstr ""
17128
17129 # type: =item
17130 #. type: =item
17131 #: ../src/guestfs-actions.pod:5536 ../fish/guestfish-actions.pod:3720
17132 msgid "'c'"
17133 msgstr ""
17134
17135 # type: textblock
17136 #. type: textblock
17137 #: ../src/guestfs-actions.pod:5538 ../fish/guestfish-actions.pod:3722
17138 msgid "Char special"
17139 msgstr ""
17140
17141 # type: =item
17142 #. type: =item
17143 #: ../src/guestfs-actions.pod:5540 ../fish/guestfish-actions.pod:3724
17144 msgid "'d'"
17145 msgstr ""
17146
17147 # type: textblock
17148 #. type: textblock
17149 #: ../src/guestfs-actions.pod:5542 ../fish/guestfish-actions.pod:3726
17150 msgid "Directory"
17151 msgstr ""
17152
17153 # type: =item
17154 #. type: =item
17155 #: ../src/guestfs-actions.pod:5544 ../fish/guestfish-actions.pod:3728
17156 msgid "'f'"
17157 msgstr ""
17158
17159 # type: textblock
17160 #. type: textblock
17161 #: ../src/guestfs-actions.pod:5546 ../fish/guestfish-actions.pod:3730
17162 msgid "FIFO (named pipe)"
17163 msgstr ""
17164
17165 # type: =item
17166 #. type: =item
17167 #: ../src/guestfs-actions.pod:5548 ../fish/guestfish-actions.pod:3732
17168 msgid "'l'"
17169 msgstr ""
17170
17171 # type: textblock
17172 #. type: textblock
17173 #: ../src/guestfs-actions.pod:5550 ../fish/guestfish-actions.pod:3734
17174 msgid "Symbolic link"
17175 msgstr ""
17176
17177 # type: =item
17178 #. type: =item
17179 #: ../src/guestfs-actions.pod:5552 ../fish/guestfish-actions.pod:3736
17180 msgid "'r'"
17181 msgstr ""
17182
17183 # type: textblock
17184 #. type: textblock
17185 #: ../src/guestfs-actions.pod:5554 ../fish/guestfish-actions.pod:3738
17186 msgid "Regular file"
17187 msgstr ""
17188
17189 # type: =item
17190 #. type: =item
17191 #: ../src/guestfs-actions.pod:5556 ../fish/guestfish-actions.pod:3740
17192 msgid "'s'"
17193 msgstr ""
17194
17195 # type: textblock
17196 #. type: textblock
17197 #: ../src/guestfs-actions.pod:5558 ../fish/guestfish-actions.pod:3742
17198 msgid "Socket"
17199 msgstr ""
17200
17201 # type: =item
17202 #. type: =item
17203 #: ../src/guestfs-actions.pod:5560 ../fish/guestfish-actions.pod:3744
17204 msgid "'u'"
17205 msgstr ""
17206
17207 # type: textblock
17208 #. type: textblock
17209 #: ../src/guestfs-actions.pod:5562 ../fish/guestfish-actions.pod:3746
17210 msgid "Unknown file type"
17211 msgstr ""
17212
17213 # type: =item
17214 #. type: =item
17215 #: ../src/guestfs-actions.pod:5564 ../fish/guestfish-actions.pod:3748
17216 msgid "'?'"
17217 msgstr ""
17218
17219 # type: textblock
17220 #. type: textblock
17221 #: ../src/guestfs-actions.pod:5566 ../fish/guestfish-actions.pod:3750
17222 msgid ""
17223 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
17224 msgstr ""
17225
17226 # type: textblock
17227 #. type: textblock
17228 #: ../src/guestfs-actions.pod:5571
17229 msgid ""
17230 "This function is primarily intended for use by programs.  To get a simple "
17231 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
17232 "consumption, use C<guestfs_ll>."
17233 msgstr ""
17234
17235 # type: textblock
17236 #. type: textblock
17237 #: ../src/guestfs-actions.pod:5575
17238 msgid ""
17239 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
17240 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
17241 msgstr ""
17242
17243 # type: =head2
17244 #. type: =head2
17245 #: ../src/guestfs-actions.pod:5581
17246 msgid "guestfs_readlink"
17247 msgstr ""
17248
17249 # type: verbatim
17250 #. type: verbatim
17251 #: ../src/guestfs-actions.pod:5583
17252 #, no-wrap
17253 msgid ""
17254 " char *\n"
17255 " guestfs_readlink (guestfs_h *g,\n"
17256 "                   const char *path);\n"
17257 "\n"
17258 msgstr ""
17259
17260 # type: textblock
17261 #. type: textblock
17262 #: ../src/guestfs-actions.pod:5587 ../fish/guestfish-actions.pod:3763
17263 msgid "This command reads the target of a symbolic link."
17264 msgstr ""
17265
17266 # type: =head2
17267 #. type: =head2
17268 #: ../src/guestfs-actions.pod:5594
17269 msgid "guestfs_readlinklist"
17270 msgstr ""
17271
17272 # type: verbatim
17273 #. type: verbatim
17274 #: ../src/guestfs-actions.pod:5596
17275 #, no-wrap
17276 msgid ""
17277 " char **\n"
17278 " guestfs_readlinklist (guestfs_h *g,\n"
17279 "                       const char *path,\n"
17280 "                       char *const *names);\n"
17281 "\n"
17282 msgstr ""
17283
17284 # type: textblock
17285 #. type: textblock
17286 #: ../src/guestfs-actions.pod:5601 ../fish/guestfish-actions.pod:3769
17287 msgid ""
17288 "This call allows you to do a C<readlink> operation on multiple files, where "
17289 "all files are in the directory C<path>.  C<names> is the list of files from "
17290 "this directory."
17291 msgstr ""
17292
17293 # type: textblock
17294 #. type: textblock
17295 #: ../src/guestfs-actions.pod:5605 ../fish/guestfish-actions.pod:3773
17296 msgid ""
17297 "On return you get a list of strings, with a one-to-one correspondence to the "
17298 "C<names> list.  Each string is the value of the symbolic link."
17299 msgstr ""
17300
17301 # type: textblock
17302 #. type: textblock
17303 #: ../src/guestfs-actions.pod:5609 ../fish/guestfish-actions.pod:3777
17304 msgid ""
17305 "If the C<readlink(2)> operation fails on any name, then the corresponding "
17306 "result string is the empty string C<\"\">.  However the whole operation is "
17307 "completed even if there were C<readlink(2)> errors, and so you can call this "
17308 "function with names where you don't know if they are symbolic links already "
17309 "(albeit slightly less efficient)."
17310 msgstr ""
17311
17312 # type: textblock
17313 #. type: textblock
17314 #: ../src/guestfs-actions.pod:5616 ../fish/guestfish-actions.pod:3784
17315 msgid ""
17316 "This call is intended for programs that want to efficiently list a directory "
17317 "contents without making many round-trips.  Very long directory listings "
17318 "might cause the protocol message size to be exceeded, causing this call to "
17319 "fail.  The caller must split up such requests into smaller groups of names."
17320 msgstr ""
17321
17322 # type: =head2
17323 #. type: =head2
17324 #: ../src/guestfs-actions.pod:5629
17325 msgid "guestfs_realpath"
17326 msgstr ""
17327
17328 # type: verbatim
17329 #. type: verbatim
17330 #: ../src/guestfs-actions.pod:5631
17331 #, no-wrap
17332 msgid ""
17333 " char *\n"
17334 " guestfs_realpath (guestfs_h *g,\n"
17335 "                   const char *path);\n"
17336 "\n"
17337 msgstr ""
17338
17339 # type: textblock
17340 #. type: textblock
17341 #: ../src/guestfs-actions.pod:5635 ../fish/guestfish-actions.pod:3795
17342 msgid ""
17343 "Return the canonicalized absolute pathname of C<path>.  The returned path "
17344 "has no C<.>, C<..> or symbolic link path elements."
17345 msgstr ""
17346
17347 # type: =head2
17348 #. type: =head2
17349 #: ../src/guestfs-actions.pod:5643
17350 msgid "guestfs_removexattr"
17351 msgstr ""
17352
17353 # type: verbatim
17354 #. type: verbatim
17355 #: ../src/guestfs-actions.pod:5645
17356 #, no-wrap
17357 msgid ""
17358 " int\n"
17359 " guestfs_removexattr (guestfs_h *g,\n"
17360 "                      const char *xattr,\n"
17361 "                      const char *path);\n"
17362 "\n"
17363 msgstr ""
17364
17365 # type: textblock
17366 #. type: textblock
17367 #: ../src/guestfs-actions.pod:5650 ../fish/guestfish-actions.pod:3802
17368 msgid ""
17369 "This call removes the extended attribute named C<xattr> of the file C<path>."
17370 msgstr ""
17371
17372 # type: textblock
17373 #. type: textblock
17374 #: ../src/guestfs-actions.pod:5653
17375 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
17376 msgstr ""
17377
17378 # type: =head2
17379 #. type: =head2
17380 #: ../src/guestfs-actions.pod:5659
17381 msgid "guestfs_resize2fs"
17382 msgstr ""
17383
17384 # type: verbatim
17385 #. type: verbatim
17386 #: ../src/guestfs-actions.pod:5661
17387 #, no-wrap
17388 msgid ""
17389 " int\n"
17390 " guestfs_resize2fs (guestfs_h *g,\n"
17391 "                    const char *device);\n"
17392 "\n"
17393 msgstr ""
17394
17395 # type: textblock
17396 #. type: textblock
17397 #: ../src/guestfs-actions.pod:5665 ../fish/guestfish-actions.pod:3811
17398 msgid ""
17399 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
17400 "underlying device."
17401 msgstr ""
17402
17403 # type: textblock
17404 #. type: textblock
17405 #: ../src/guestfs-actions.pod:5668
17406 msgid ""
17407 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
17408 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
17409 "sometimes gives an error about this and sometimes not.  In any case, it is "
17410 "always safe to call C<guestfs_e2fsck_f> before calling this function."
17411 msgstr ""
17412
17413 #. type: =head2
17414 #: ../src/guestfs-actions.pod:5678
17415 msgid "guestfs_resize2fs_M"
17416 msgstr ""
17417
17418 #. type: verbatim
17419 #: ../src/guestfs-actions.pod:5680
17420 #, no-wrap
17421 msgid ""
17422 " int\n"
17423 " guestfs_resize2fs_M (guestfs_h *g,\n"
17424 "                      const char *device);\n"
17425 "\n"
17426 msgstr ""
17427
17428 #. type: textblock
17429 #: ../src/guestfs-actions.pod:5684
17430 msgid ""
17431 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
17432 "resized to its minimum size.  This works like the I<-M> option to the "
17433 "C<resize2fs> command."
17434 msgstr ""
17435
17436 #. type: textblock
17437 #: ../src/guestfs-actions.pod:5688
17438 msgid ""
17439 "To get the resulting size of the filesystem you should call "
17440 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
17441 "These two numbers, multiplied together, give the resulting size of the "
17442 "minimal filesystem in bytes."
17443 msgstr ""
17444
17445 # type: =head2
17446 #. type: =head2
17447 #: ../src/guestfs-actions.pod:5695
17448 msgid "guestfs_resize2fs_size"
17449 msgstr ""
17450
17451 # type: verbatim
17452 #. type: verbatim
17453 #: ../src/guestfs-actions.pod:5697
17454 #, no-wrap
17455 msgid ""
17456 " int\n"
17457 " guestfs_resize2fs_size (guestfs_h *g,\n"
17458 "                         const char *device,\n"
17459 "                         int64_t size);\n"
17460 "\n"
17461 msgstr ""
17462
17463 # type: textblock
17464 #. type: textblock
17465 #: ../src/guestfs-actions.pod:5702
17466 msgid ""
17467 "This command is the same as C<guestfs_resize2fs> except that it allows you "
17468 "to specify the new size (in bytes) explicitly."
17469 msgstr ""
17470
17471 # type: =head2
17472 #. type: =head2
17473 #: ../src/guestfs-actions.pod:5709
17474 msgid "guestfs_rm"
17475 msgstr ""
17476
17477 # type: verbatim
17478 #. type: verbatim
17479 #: ../src/guestfs-actions.pod:5711
17480 #, no-wrap
17481 msgid ""
17482 " int\n"
17483 " guestfs_rm (guestfs_h *g,\n"
17484 "             const char *path);\n"
17485 "\n"
17486 msgstr ""
17487
17488 # type: textblock
17489 #. type: textblock
17490 #: ../src/guestfs-actions.pod:5715 ../fish/guestfish-actions.pod:3844
17491 msgid "Remove the single file C<path>."
17492 msgstr ""
17493
17494 # type: =head2
17495 #. type: =head2
17496 #: ../src/guestfs-actions.pod:5721
17497 msgid "guestfs_rm_rf"
17498 msgstr ""
17499
17500 # type: verbatim
17501 #. type: verbatim
17502 #: ../src/guestfs-actions.pod:5723
17503 #, no-wrap
17504 msgid ""
17505 " int\n"
17506 " guestfs_rm_rf (guestfs_h *g,\n"
17507 "                const char *path);\n"
17508 "\n"
17509 msgstr ""
17510
17511 # type: textblock
17512 #. type: textblock
17513 #: ../src/guestfs-actions.pod:5727 ../fish/guestfish-actions.pod:3850
17514 msgid ""
17515 "Remove the file or directory C<path>, recursively removing the contents if "
17516 "its a directory.  This is like the C<rm -rf> shell command."
17517 msgstr ""
17518
17519 # type: =head2
17520 #. type: =head2
17521 #: ../src/guestfs-actions.pod:5735
17522 msgid "guestfs_rmdir"
17523 msgstr ""
17524
17525 # type: verbatim
17526 #. type: verbatim
17527 #: ../src/guestfs-actions.pod:5737
17528 #, no-wrap
17529 msgid ""
17530 " int\n"
17531 " guestfs_rmdir (guestfs_h *g,\n"
17532 "                const char *path);\n"
17533 "\n"
17534 msgstr ""
17535
17536 # type: textblock
17537 #. type: textblock
17538 #: ../src/guestfs-actions.pod:5741 ../fish/guestfish-actions.pod:3858
17539 msgid "Remove the single directory C<path>."
17540 msgstr ""
17541
17542 # type: =head2
17543 #. type: =head2
17544 #: ../src/guestfs-actions.pod:5747
17545 msgid "guestfs_rmmountpoint"
17546 msgstr ""
17547
17548 # type: verbatim
17549 #. type: verbatim
17550 #: ../src/guestfs-actions.pod:5749
17551 #, no-wrap
17552 msgid ""
17553 " int\n"
17554 " guestfs_rmmountpoint (guestfs_h *g,\n"
17555 "                       const char *exemptpath);\n"
17556 "\n"
17557 msgstr ""
17558
17559 # type: textblock
17560 #. type: textblock
17561 #: ../src/guestfs-actions.pod:5753
17562 msgid ""
17563 "This calls removes a mountpoint that was previously created with "
17564 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
17565 msgstr ""
17566
17567 # type: =head2
17568 #. type: =head2
17569 #: ../src/guestfs-actions.pod:5761
17570 msgid "guestfs_scrub_device"
17571 msgstr ""
17572
17573 # type: verbatim
17574 #. type: verbatim
17575 #: ../src/guestfs-actions.pod:5763
17576 #, no-wrap
17577 msgid ""
17578 " int\n"
17579 " guestfs_scrub_device (guestfs_h *g,\n"
17580 "                       const char *device);\n"
17581 "\n"
17582 msgstr ""
17583
17584 # type: textblock
17585 #. type: textblock
17586 #: ../src/guestfs-actions.pod:5767 ../fish/guestfish-actions.pod:3872
17587 msgid ""
17588 "This command writes patterns over C<device> to make data retrieval more "
17589 "difficult."
17590 msgstr ""
17591
17592 # type: textblock
17593 #. type: textblock
17594 #: ../src/guestfs-actions.pod:5770 ../src/guestfs-actions.pod:5791
17595 #: ../src/guestfs-actions.pod:5810 ../fish/guestfish-actions.pod:3875
17596 #: ../fish/guestfish-actions.pod:3890 ../fish/guestfish-actions.pod:3903
17597 msgid ""
17598 "It is an interface to the L<scrub(1)> program.  See that manual page for "
17599 "more details."
17600 msgstr ""
17601
17602 # type: textblock
17603 #. type: textblock
17604 #: ../src/guestfs-actions.pod:5778 ../src/guestfs-actions.pod:5796
17605 #: ../src/guestfs-actions.pod:5815
17606 msgid "(Added in 1.0.52)"
17607 msgstr ""
17608
17609 # type: =head2
17610 #. type: =head2
17611 #: ../src/guestfs-actions.pod:5780
17612 msgid "guestfs_scrub_file"
17613 msgstr ""
17614
17615 # type: verbatim
17616 #. type: verbatim
17617 #: ../src/guestfs-actions.pod:5782
17618 #, no-wrap
17619 msgid ""
17620 " int\n"
17621 " guestfs_scrub_file (guestfs_h *g,\n"
17622 "                     const char *file);\n"
17623 "\n"
17624 msgstr ""
17625
17626 # type: textblock
17627 #. type: textblock
17628 #: ../src/guestfs-actions.pod:5786 ../fish/guestfish-actions.pod:3885
17629 msgid ""
17630 "This command writes patterns over a file to make data retrieval more "
17631 "difficult."
17632 msgstr ""
17633
17634 # type: textblock
17635 #. type: textblock
17636 #: ../src/guestfs-actions.pod:5789 ../fish/guestfish-actions.pod:3888
17637 msgid "The file is I<removed> after scrubbing."
17638 msgstr ""
17639
17640 # type: =head2
17641 #. type: =head2
17642 #: ../src/guestfs-actions.pod:5798
17643 msgid "guestfs_scrub_freespace"
17644 msgstr ""
17645
17646 # type: verbatim
17647 #. type: verbatim
17648 #: ../src/guestfs-actions.pod:5800
17649 #, no-wrap
17650 msgid ""
17651 " int\n"
17652 " guestfs_scrub_freespace (guestfs_h *g,\n"
17653 "                          const char *dir);\n"
17654 "\n"
17655 msgstr ""
17656
17657 # type: textblock
17658 #. type: textblock
17659 #: ../src/guestfs-actions.pod:5804
17660 msgid ""
17661 "This command creates the directory C<dir> and then fills it with files until "
17662 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
17663 "and deletes them.  The intention is to scrub any free space on the partition "
17664 "containing C<dir>."
17665 msgstr ""
17666
17667 # type: =head2
17668 #. type: =head2
17669 #: ../src/guestfs-actions.pod:5817
17670 msgid "guestfs_set_append"
17671 msgstr ""
17672
17673 # type: verbatim
17674 #. type: verbatim
17675 #: ../src/guestfs-actions.pod:5819
17676 #, no-wrap
17677 msgid ""
17678 " int\n"
17679 " guestfs_set_append (guestfs_h *g,\n"
17680 "                     const char *append);\n"
17681 "\n"
17682 msgstr ""
17683
17684 # type: textblock
17685 #. type: textblock
17686 #: ../src/guestfs-actions.pod:5823 ../fish/guestfish-actions.pod:3912
17687 msgid ""
17688 "This function is used to add additional options to the guest kernel command "
17689 "line."
17690 msgstr ""
17691
17692 # type: textblock
17693 #. type: textblock
17694 #: ../src/guestfs-actions.pod:5826 ../fish/guestfish-actions.pod:3915
17695 msgid ""
17696 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
17697 "environment variable."
17698 msgstr ""
17699
17700 # type: textblock
17701 #. type: textblock
17702 #: ../src/guestfs-actions.pod:5829 ../fish/guestfish-actions.pod:3918
17703 msgid ""
17704 "Setting C<append> to C<NULL> means I<no> additional options are passed "
17705 "(libguestfs always adds a few of its own)."
17706 msgstr ""
17707
17708 #. type: =head2
17709 #: ../src/guestfs-actions.pod:5836
17710 msgid "guestfs_set_attach_method"
17711 msgstr ""
17712
17713 #. type: verbatim
17714 #: ../src/guestfs-actions.pod:5838
17715 #, no-wrap
17716 msgid ""
17717 " int\n"
17718 " guestfs_set_attach_method (guestfs_h *g,\n"
17719 "                            const char *attachmethod);\n"
17720 "\n"
17721 msgstr ""
17722
17723 #. type: textblock
17724 #: ../src/guestfs-actions.pod:5842 ../fish/guestfish-actions.pod:3927
17725 msgid ""
17726 "Set the method that libguestfs uses to connect to the back end guestfsd "
17727 "daemon.  Possible methods are:"
17728 msgstr ""
17729
17730 #. type: textblock
17731 #: ../src/guestfs-actions.pod:5849 ../fish/guestfish-actions.pod:3934
17732 msgid ""
17733 "Launch an appliance and connect to it.  This is the ordinary method and the "
17734 "default."
17735 msgstr ""
17736
17737 #. type: =item
17738 #: ../src/guestfs-actions.pod:5852 ../fish/guestfish-actions.pod:3937
17739 msgid "C<unix:I<path>>"
17740 msgstr ""
17741
17742 #. type: textblock
17743 #: ../src/guestfs-actions.pod:5854 ../fish/guestfish-actions.pod:3939
17744 msgid "Connect to the Unix domain socket I<path>."
17745 msgstr ""
17746
17747 #. type: textblock
17748 #: ../src/guestfs-actions.pod:5856 ../fish/guestfish-actions.pod:3941
17749 msgid ""
17750 "This method lets you connect to an existing daemon or (using virtio-serial) "
17751 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
17752 "RUNNING DAEMONS>."
17753 msgstr ""
17754
17755 # type: =head2
17756 #. type: =head2
17757 #: ../src/guestfs-actions.pod:5864
17758 msgid "guestfs_set_autosync"
17759 msgstr ""
17760
17761 # type: verbatim
17762 #. type: verbatim
17763 #: ../src/guestfs-actions.pod:5866
17764 #, no-wrap
17765 msgid ""
17766 " int\n"
17767 " guestfs_set_autosync (guestfs_h *g,\n"
17768 "                       int autosync);\n"
17769 "\n"
17770 msgstr ""
17771
17772 #. type: textblock
17773 #: ../src/guestfs-actions.pod:5870 ../fish/guestfish-actions.pod:3953
17774 msgid ""
17775 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
17776 "effort attempt to make filesystems consistent and synchronized when the "
17777 "handle is closed (also if the program exits without closing handles)."
17778 msgstr ""
17779
17780 # type: textblock
17781 #. type: textblock
17782 #: ../src/guestfs-actions.pod:5875 ../fish/guestfish-actions.pod:3958
17783 msgid ""
17784 "This is enabled by default (since libguestfs 1.5.24, previously it was "
17785 "disabled by default)."
17786 msgstr ""
17787
17788 # type: =head2
17789 #. type: =head2
17790 #: ../src/guestfs-actions.pod:5882
17791 msgid "guestfs_set_direct"
17792 msgstr ""
17793
17794 # type: verbatim
17795 #. type: verbatim
17796 #: ../src/guestfs-actions.pod:5884
17797 #, no-wrap
17798 msgid ""
17799 " int\n"
17800 " guestfs_set_direct (guestfs_h *g,\n"
17801 "                     int direct);\n"
17802 "\n"
17803 msgstr ""
17804
17805 # type: textblock
17806 #. type: textblock
17807 #: ../src/guestfs-actions.pod:5888 ../fish/guestfish-actions.pod:3967
17808 msgid ""
17809 "If the direct appliance mode flag is enabled, then stdin and stdout are "
17810 "passed directly through to the appliance once it is launched."
17811 msgstr ""
17812
17813 # type: textblock
17814 #. type: textblock
17815 #: ../src/guestfs-actions.pod:5892
17816 msgid ""
17817 "One consequence of this is that log messages aren't caught by the library "
17818 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
17819 "stdout."
17820 msgstr ""
17821
17822 # type: textblock
17823 #. type: textblock
17824 #: ../src/guestfs-actions.pod:5896 ../fish/guestfish-actions.pod:3975
17825 msgid "You probably don't want to use this unless you know what you are doing."
17826 msgstr ""
17827
17828 # type: textblock
17829 #. type: textblock
17830 #: ../src/guestfs-actions.pod:5899 ../fish/guestfish-actions.pod:3978
17831 msgid "The default is disabled."
17832 msgstr ""
17833
17834 # type: =head2
17835 #. type: =head2
17836 #: ../src/guestfs-actions.pod:5905
17837 msgid "guestfs_set_e2label"
17838 msgstr ""
17839
17840 # type: verbatim
17841 #. type: verbatim
17842 #: ../src/guestfs-actions.pod:5907
17843 #, no-wrap
17844 msgid ""
17845 " int\n"
17846 " guestfs_set_e2label (guestfs_h *g,\n"
17847 "                      const char *device,\n"
17848 "                      const char *label);\n"
17849 "\n"
17850 msgstr ""
17851
17852 # type: textblock
17853 #. type: textblock
17854 #: ../src/guestfs-actions.pod:5912 ../fish/guestfish-actions.pod:3984
17855 msgid ""
17856 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
17857 "C<label>.  Filesystem labels are limited to 16 characters."
17858 msgstr ""
17859
17860 # type: textblock
17861 #. type: textblock
17862 #: ../src/guestfs-actions.pod:5916
17863 msgid ""
17864 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
17865 "the existing label on a filesystem."
17866 msgstr ""
17867
17868 # type: =head2
17869 #. type: =head2
17870 #: ../src/guestfs-actions.pod:5923
17871 msgid "guestfs_set_e2uuid"
17872 msgstr ""
17873
17874 # type: verbatim
17875 #. type: verbatim
17876 #: ../src/guestfs-actions.pod:5925
17877 #, no-wrap
17878 msgid ""
17879 " int\n"
17880 " guestfs_set_e2uuid (guestfs_h *g,\n"
17881 "                     const char *device,\n"
17882 "                     const char *uuid);\n"
17883 "\n"
17884 msgstr ""
17885
17886 # type: textblock
17887 #. type: textblock
17888 #: ../src/guestfs-actions.pod:5930 ../fish/guestfish-actions.pod:3995
17889 msgid ""
17890 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
17891 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
17892 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
17893 msgstr ""
17894
17895 # type: textblock
17896 #. type: textblock
17897 #: ../src/guestfs-actions.pod:5935
17898 msgid ""
17899 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
17900 "the existing UUID of a filesystem."
17901 msgstr ""
17902
17903 # type: =head2
17904 #. type: =head2
17905 #: ../src/guestfs-actions.pod:5942
17906 msgid "guestfs_set_memsize"
17907 msgstr ""
17908
17909 # type: verbatim
17910 #. type: verbatim
17911 #: ../src/guestfs-actions.pod:5944
17912 #, no-wrap
17913 msgid ""
17914 " int\n"
17915 " guestfs_set_memsize (guestfs_h *g,\n"
17916 "                      int memsize);\n"
17917 "\n"
17918 msgstr ""
17919
17920 # type: textblock
17921 #. type: textblock
17922 #: ../src/guestfs-actions.pod:5948
17923 msgid ""
17924 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
17925 "This only has any effect if called before C<guestfs_launch>."
17926 msgstr ""
17927
17928 # type: textblock
17929 #. type: textblock
17930 #: ../src/guestfs-actions.pod:5952 ../fish/guestfish-actions.pod:4013
17931 msgid ""
17932 "You can also change this by setting the environment variable "
17933 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
17934 msgstr ""
17935
17936 # type: =head2
17937 #. type: =head2
17938 #: ../src/guestfs-actions.pod:5963
17939 msgid "guestfs_set_network"
17940 msgstr ""
17941
17942 # type: verbatim
17943 #. type: verbatim
17944 #: ../src/guestfs-actions.pod:5965
17945 #, no-wrap
17946 msgid ""
17947 " int\n"
17948 " guestfs_set_network (guestfs_h *g,\n"
17949 "                      int network);\n"
17950 "\n"
17951 msgstr ""
17952
17953 # type: textblock
17954 #. type: textblock
17955 #: ../src/guestfs-actions.pod:5969 ../fish/guestfish-actions.pod:4026
17956 msgid ""
17957 "If C<network> is true, then the network is enabled in the libguestfs "
17958 "appliance.  The default is false."
17959 msgstr ""
17960
17961 # type: textblock
17962 #. type: textblock
17963 #: ../src/guestfs-actions.pod:5972 ../fish/guestfish-actions.pod:4029
17964 msgid ""
17965 "This affects whether commands are able to access the network (see L<guestfs"
17966 "(3)/RUNNING COMMANDS>)."
17967 msgstr ""
17968
17969 # type: textblock
17970 #. type: textblock
17971 #: ../src/guestfs-actions.pod:5975
17972 msgid ""
17973 "You must call this before calling C<guestfs_launch>, otherwise it has no "
17974 "effect."
17975 msgstr ""
17976
17977 # type: =head2
17978 #. type: =head2
17979 #: ../src/guestfs-actions.pod:5982
17980 msgid "guestfs_set_path"
17981 msgstr ""
17982
17983 # type: verbatim
17984 #. type: verbatim
17985 #: ../src/guestfs-actions.pod:5984
17986 #, no-wrap
17987 msgid ""
17988 " int\n"
17989 " guestfs_set_path (guestfs_h *g,\n"
17990 "                   const char *searchpath);\n"
17991 "\n"
17992 msgstr ""
17993
17994 # type: textblock
17995 #. type: textblock
17996 #: ../src/guestfs-actions.pod:5988 ../fish/guestfish-actions.pod:4041
17997 msgid "Set the path that libguestfs searches for kernel and initrd.img."
17998 msgstr ""
17999
18000 # type: textblock
18001 #. type: textblock
18002 #: ../src/guestfs-actions.pod:5990 ../fish/guestfish-actions.pod:4043
18003 msgid ""
18004 "The default is C<$libdir/guestfs> unless overridden by setting "
18005 "C<LIBGUESTFS_PATH> environment variable."
18006 msgstr ""
18007
18008 # type: textblock
18009 #. type: textblock
18010 #: ../src/guestfs-actions.pod:5993 ../fish/guestfish-actions.pod:4046
18011 msgid "Setting C<path> to C<NULL> restores the default path."
18012 msgstr ""
18013
18014 # type: =head2
18015 #. type: =head2
18016 #: ../src/guestfs-actions.pod:5999
18017 msgid "guestfs_set_qemu"
18018 msgstr ""
18019
18020 # type: verbatim
18021 #. type: verbatim
18022 #: ../src/guestfs-actions.pod:6001
18023 #, no-wrap
18024 msgid ""
18025 " int\n"
18026 " guestfs_set_qemu (guestfs_h *g,\n"
18027 "                   const char *qemu);\n"
18028 "\n"
18029 msgstr ""
18030
18031 # type: textblock
18032 #. type: textblock
18033 #: ../src/guestfs-actions.pod:6005 ../fish/guestfish-actions.pod:4054
18034 msgid "Set the qemu binary that we will use."
18035 msgstr ""
18036
18037 # type: textblock
18038 #. type: textblock
18039 #: ../src/guestfs-actions.pod:6007 ../fish/guestfish-actions.pod:4056
18040 msgid ""
18041 "The default is chosen when the library was compiled by the configure script."
18042 msgstr ""
18043
18044 # type: textblock
18045 #. type: textblock
18046 #: ../src/guestfs-actions.pod:6010 ../fish/guestfish-actions.pod:4059
18047 msgid ""
18048 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
18049 "variable."
18050 msgstr ""
18051
18052 # type: textblock
18053 #. type: textblock
18054 #: ../src/guestfs-actions.pod:6013 ../fish/guestfish-actions.pod:4062
18055 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
18056 msgstr ""
18057
18058 # type: textblock
18059 #. type: textblock
18060 #: ../src/guestfs-actions.pod:6015 ../fish/guestfish-actions.pod:4064
18061 msgid ""
18062 "Note that you should call this function as early as possible after creating "
18063 "the handle.  This is because some pre-launch operations depend on testing "
18064 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
18065 "don't retest features, and so you might see inconsistent results.  Using the "
18066 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
18067 "the qemu binary at the same time as the handle is created."
18068 msgstr ""
18069
18070 # type: =head2
18071 #. type: =head2
18072 #: ../src/guestfs-actions.pod:6027
18073 msgid "guestfs_set_recovery_proc"
18074 msgstr ""
18075
18076 # type: verbatim
18077 #. type: verbatim
18078 #: ../src/guestfs-actions.pod:6029
18079 #, no-wrap
18080 msgid ""
18081 " int\n"
18082 " guestfs_set_recovery_proc (guestfs_h *g,\n"
18083 "                            int recoveryproc);\n"
18084 "\n"
18085 msgstr ""
18086
18087 # type: textblock
18088 #. type: textblock
18089 #: ../src/guestfs-actions.pod:6033
18090 msgid ""
18091 "If this is called with the parameter C<false> then C<guestfs_launch> does "
18092 "not create a recovery process.  The purpose of the recovery process is to "
18093 "stop runaway qemu processes in the case where the main program aborts "
18094 "abruptly."
18095 msgstr ""
18096
18097 # type: textblock
18098 #. type: textblock
18099 #: ../src/guestfs-actions.pod:6038
18100 msgid ""
18101 "This only has any effect if called before C<guestfs_launch>, and the default "
18102 "is true."
18103 msgstr ""
18104
18105 # type: textblock
18106 #. type: textblock
18107 #: ../src/guestfs-actions.pod:6041 ../fish/guestfish-actions.pod:4086
18108 msgid ""
18109 "About the only time when you would want to disable this is if the main "
18110 "process will fork itself into the background (\"daemonize\" itself).  In "
18111 "this case the recovery process thinks that the main program has disappeared "
18112 "and so kills qemu, which is not very helpful."
18113 msgstr ""
18114
18115 # type: =head2
18116 #. type: =head2
18117 #: ../src/guestfs-actions.pod:6051
18118 msgid "guestfs_set_selinux"
18119 msgstr ""
18120
18121 # type: verbatim
18122 #. type: verbatim
18123 #: ../src/guestfs-actions.pod:6053
18124 #, no-wrap
18125 msgid ""
18126 " int\n"
18127 " guestfs_set_selinux (guestfs_h *g,\n"
18128 "                      int selinux);\n"
18129 "\n"
18130 msgstr ""
18131
18132 # type: textblock
18133 #. type: textblock
18134 #: ../src/guestfs-actions.pod:6057 ../fish/guestfish-actions.pod:4098
18135 msgid ""
18136 "This sets the selinux flag that is passed to the appliance at boot time.  "
18137 "The default is C<selinux=0> (disabled)."
18138 msgstr ""
18139
18140 # type: textblock
18141 #. type: textblock
18142 #: ../src/guestfs-actions.pod:6060 ../fish/guestfish-actions.pod:4101
18143 msgid ""
18144 "Note that if SELinux is enabled, it is always in Permissive mode "
18145 "(C<enforcing=0>)."
18146 msgstr ""
18147
18148 # type: =head2
18149 #. type: =head2
18150 #: ../src/guestfs-actions.pod:6070
18151 msgid "guestfs_set_trace"
18152 msgstr ""
18153
18154 # type: verbatim
18155 #. type: verbatim
18156 #: ../src/guestfs-actions.pod:6072
18157 #, no-wrap
18158 msgid ""
18159 " int\n"
18160 " guestfs_set_trace (guestfs_h *g,\n"
18161 "                    int trace);\n"
18162 "\n"
18163 msgstr ""
18164
18165 #. type: textblock
18166 #: ../src/guestfs-actions.pod:6076 ../fish/guestfish-actions.pod:4113
18167 msgid ""
18168 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
18169 "return values are traced."
18170 msgstr ""
18171
18172 # type: textblock
18173 #. type: textblock
18174 #: ../src/guestfs-actions.pod:6079 ../fish/guestfish-actions.pod:4116
18175 msgid ""
18176 "If you want to trace C API calls into libguestfs (and other libraries) then "
18177 "possibly a better way is to use the external ltrace(1) command."
18178 msgstr ""
18179
18180 # type: textblock
18181 #. type: textblock
18182 #: ../src/guestfs-actions.pod:6083 ../fish/guestfish-actions.pod:4120
18183 msgid ""
18184 "Command traces are disabled unless the environment variable "
18185 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
18186 msgstr ""
18187
18188 #. type: textblock
18189 #: ../src/guestfs-actions.pod:6086
18190 msgid ""
18191 "Trace messages are normally sent to C<stderr>, unless you register a "
18192 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
18193 msgstr ""
18194
18195 # type: =head2
18196 #. type: =head2
18197 #: ../src/guestfs-actions.pod:6094
18198 msgid "guestfs_set_verbose"
18199 msgstr ""
18200
18201 # type: verbatim
18202 #. type: verbatim
18203 #: ../src/guestfs-actions.pod:6096
18204 #, no-wrap
18205 msgid ""
18206 " int\n"
18207 " guestfs_set_verbose (guestfs_h *g,\n"
18208 "                      int verbose);\n"
18209 "\n"
18210 msgstr ""
18211
18212 #. type: textblock
18213 #: ../src/guestfs-actions.pod:6100 ../fish/guestfish-actions.pod:4133
18214 msgid "If C<verbose> is true, this turns on verbose messages."
18215 msgstr ""
18216
18217 # type: textblock
18218 #. type: textblock
18219 #: ../src/guestfs-actions.pod:6102 ../fish/guestfish-actions.pod:4135
18220 msgid ""
18221 "Verbose messages are disabled unless the environment variable "
18222 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
18223 msgstr ""
18224
18225 #. type: textblock
18226 #: ../src/guestfs-actions.pod:6105
18227 msgid ""
18228 "Verbose messages are normally sent to C<stderr>, unless you register a "
18229 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
18230 msgstr ""
18231
18232 # type: =head2
18233 #. type: =head2
18234 #: ../src/guestfs-actions.pod:6113
18235 msgid "guestfs_setcon"
18236 msgstr ""
18237
18238 # type: verbatim
18239 #. type: verbatim
18240 #: ../src/guestfs-actions.pod:6115
18241 #, no-wrap
18242 msgid ""
18243 " int\n"
18244 " guestfs_setcon (guestfs_h *g,\n"
18245 "                 const char *context);\n"
18246 "\n"
18247 msgstr ""
18248
18249 # type: textblock
18250 #. type: textblock
18251 #: ../src/guestfs-actions.pod:6119 ../fish/guestfish-actions.pod:4146
18252 msgid ""
18253 "This sets the SELinux security context of the daemon to the string "
18254 "C<context>."
18255 msgstr ""
18256
18257 # type: textblock
18258 #. type: textblock
18259 #: ../src/guestfs-actions.pod:6122 ../fish/guestfish-actions.pod:4149
18260 msgid "See the documentation about SELINUX in L<guestfs(3)>."
18261 msgstr ""
18262
18263 # type: =head2
18264 #. type: =head2
18265 #: ../src/guestfs-actions.pod:6128
18266 msgid "guestfs_setxattr"
18267 msgstr ""
18268
18269 # type: verbatim
18270 #. type: verbatim
18271 #: ../src/guestfs-actions.pod:6130
18272 #, no-wrap
18273 msgid ""
18274 " int\n"
18275 " guestfs_setxattr (guestfs_h *g,\n"
18276 "                   const char *xattr,\n"
18277 "                   const char *val,\n"
18278 "                   int vallen,\n"
18279 "                   const char *path);\n"
18280 "\n"
18281 msgstr ""
18282
18283 # type: textblock
18284 #. type: textblock
18285 #: ../src/guestfs-actions.pod:6137 ../fish/guestfish-actions.pod:4155
18286 msgid ""
18287 "This call sets the extended attribute named C<xattr> of the file C<path> to "
18288 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
18289 msgstr ""
18290
18291 # type: textblock
18292 #. type: textblock
18293 #: ../src/guestfs-actions.pod:6141
18294 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
18295 msgstr ""
18296
18297 # type: =head2
18298 #. type: =head2
18299 #: ../src/guestfs-actions.pod:6147
18300 msgid "guestfs_sfdisk"
18301 msgstr ""
18302
18303 # type: verbatim
18304 #. type: verbatim
18305 #: ../src/guestfs-actions.pod:6149
18306 #, no-wrap
18307 msgid ""
18308 " int\n"
18309 " guestfs_sfdisk (guestfs_h *g,\n"
18310 "                 const char *device,\n"
18311 "                 int cyls,\n"
18312 "                 int heads,\n"
18313 "                 int sectors,\n"
18314 "                 char *const *lines);\n"
18315 "\n"
18316 msgstr ""
18317
18318 # type: textblock
18319 #. type: textblock
18320 #: ../src/guestfs-actions.pod:6157 ../fish/guestfish-actions.pod:4165
18321 msgid ""
18322 "This is a direct interface to the L<sfdisk(8)> program for creating "
18323 "partitions on block devices."
18324 msgstr ""
18325
18326 # type: textblock
18327 #. type: textblock
18328 #: ../src/guestfs-actions.pod:6160 ../fish/guestfish-actions.pod:4168
18329 msgid "C<device> should be a block device, for example C</dev/sda>."
18330 msgstr ""
18331
18332 # type: textblock
18333 #. type: textblock
18334 #: ../src/guestfs-actions.pod:6162 ../fish/guestfish-actions.pod:4170
18335 msgid ""
18336 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
18337 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
18338 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
18339 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
18340 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
18341 "the kernel) cannot work out the right geometry and you will need to tell it."
18342 msgstr ""
18343
18344 # type: textblock
18345 #. type: textblock
18346 #: ../src/guestfs-actions.pod:6170 ../fish/guestfish-actions.pod:4178
18347 msgid ""
18348 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
18349 "refer to the L<sfdisk(8)> manpage."
18350 msgstr ""
18351
18352 # type: textblock
18353 #. type: textblock
18354 #: ../src/guestfs-actions.pod:6173 ../fish/guestfish-actions.pod:4181
18355 msgid ""
18356 "To create a single partition occupying the whole disk, you would pass "
18357 "C<lines> as a single element list, when the single element being the string "
18358 "C<,> (comma)."
18359 msgstr ""
18360
18361 # type: textblock
18362 #. type: textblock
18363 #: ../src/guestfs-actions.pod:6177
18364 msgid ""
18365 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
18366 msgstr ""
18367
18368 #. type: textblock
18369 #: ../src/guestfs-actions.pod:6185 ../src/guestfs-actions.pod:6215
18370 #: ../src/guestfs-actions.pod:6248 ../fish/guestfish-actions.pod:4191
18371 #: ../fish/guestfish-actions.pod:4214 ../fish/guestfish-actions.pod:4236
18372 msgid ""
18373 "This function is deprecated.  In new code, use the C<part_add> call instead."
18374 msgstr ""
18375
18376 # type: =head2
18377 #. type: =head2
18378 #: ../src/guestfs-actions.pod:6194
18379 msgid "guestfs_sfdiskM"
18380 msgstr ""
18381
18382 # type: verbatim
18383 #. type: verbatim
18384 #: ../src/guestfs-actions.pod:6196
18385 #, no-wrap
18386 msgid ""
18387 " int\n"
18388 " guestfs_sfdiskM (guestfs_h *g,\n"
18389 "                  const char *device,\n"
18390 "                  char *const *lines);\n"
18391 "\n"
18392 msgstr ""
18393
18394 # type: textblock
18395 #. type: textblock
18396 #: ../src/guestfs-actions.pod:6201
18397 msgid ""
18398 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
18399 "partition sizes are specified in megabytes only (rounded to the nearest "
18400 "cylinder) and you don't need to specify the cyls, heads and sectors "
18401 "parameters which were rarely if ever used anyway."
18402 msgstr ""
18403
18404 # type: textblock
18405 #. type: textblock
18406 #: ../src/guestfs-actions.pod:6207
18407 msgid ""
18408 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
18409 "C<guestfs_part_disk>"
18410 msgstr ""
18411
18412 # type: =head2
18413 #. type: =head2
18414 #: ../src/guestfs-actions.pod:6224
18415 msgid "guestfs_sfdisk_N"
18416 msgstr ""
18417
18418 # type: verbatim
18419 #. type: verbatim
18420 #: ../src/guestfs-actions.pod:6226
18421 #, no-wrap
18422 msgid ""
18423 " int\n"
18424 " guestfs_sfdisk_N (guestfs_h *g,\n"
18425 "                   const char *device,\n"
18426 "                   int partnum,\n"
18427 "                   int cyls,\n"
18428 "                   int heads,\n"
18429 "                   int sectors,\n"
18430 "                   const char *line);\n"
18431 "\n"
18432 msgstr ""
18433
18434 # type: textblock
18435 #. type: textblock
18436 #: ../src/guestfs-actions.pod:6235 ../fish/guestfish-actions.pod:4225
18437 msgid ""
18438 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
18439 "(note: C<n> counts from 1)."
18440 msgstr ""
18441
18442 # type: textblock
18443 #. type: textblock
18444 #: ../src/guestfs-actions.pod:6238
18445 msgid ""
18446 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
18447 "for the cyls/heads/sectors parameters."
18448 msgstr ""
18449
18450 # type: textblock
18451 #. type: textblock
18452 #: ../src/guestfs-actions.pod:6241
18453 msgid "See also: C<guestfs_part_add>"
18454 msgstr ""
18455
18456 # type: =head2
18457 #. type: =head2
18458 #: ../src/guestfs-actions.pod:6257
18459 msgid "guestfs_sfdisk_disk_geometry"
18460 msgstr ""
18461
18462 # type: verbatim
18463 #. type: verbatim
18464 #: ../src/guestfs-actions.pod:6259
18465 #, no-wrap
18466 msgid ""
18467 " char *\n"
18468 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
18469 "                               const char *device);\n"
18470 "\n"
18471 msgstr ""
18472
18473 # type: textblock
18474 #. type: textblock
18475 #: ../src/guestfs-actions.pod:6263
18476 msgid ""
18477 "This displays the disk geometry of C<device> read from the partition table.  "
18478 "Especially in the case where the underlying block device has been resized, "
18479 "this can be different from the kernel's idea of the geometry (see "
18480 "C<guestfs_sfdisk_kernel_geometry>)."
18481 msgstr ""
18482
18483 # type: textblock
18484 #. type: textblock
18485 #: ../src/guestfs-actions.pod:6268 ../src/guestfs-actions.pod:6284
18486 #: ../fish/guestfish-actions.pod:4252 ../fish/guestfish-actions.pod:4261
18487 msgid "The result is in human-readable format, and not designed to be parsed."
18488 msgstr ""
18489
18490 # type: =head2
18491 #. type: =head2
18492 #: ../src/guestfs-actions.pod:6276
18493 msgid "guestfs_sfdisk_kernel_geometry"
18494 msgstr ""
18495
18496 # type: verbatim
18497 #. type: verbatim
18498 #: ../src/guestfs-actions.pod:6278
18499 #, no-wrap
18500 msgid ""
18501 " char *\n"
18502 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
18503 "                                 const char *device);\n"
18504 "\n"
18505 msgstr ""
18506
18507 # type: textblock
18508 #. type: textblock
18509 #: ../src/guestfs-actions.pod:6282 ../fish/guestfish-actions.pod:4259
18510 msgid "This displays the kernel's idea of the geometry of C<device>."
18511 msgstr ""
18512
18513 # type: =head2
18514 #. type: =head2
18515 #: ../src/guestfs-actions.pod:6292
18516 msgid "guestfs_sfdisk_l"
18517 msgstr ""
18518
18519 # type: verbatim
18520 #. type: verbatim
18521 #: ../src/guestfs-actions.pod:6294
18522 #, no-wrap
18523 msgid ""
18524 " char *\n"
18525 " guestfs_sfdisk_l (guestfs_h *g,\n"
18526 "                   const char *device);\n"
18527 "\n"
18528 msgstr ""
18529
18530 # type: textblock
18531 #. type: textblock
18532 #: ../src/guestfs-actions.pod:6298 ../fish/guestfish-actions.pod:4268
18533 msgid ""
18534 "This displays the partition table on C<device>, in the human-readable output "
18535 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
18536 msgstr ""
18537
18538 # type: textblock
18539 #. type: textblock
18540 #: ../src/guestfs-actions.pod:6302
18541 msgid "See also: C<guestfs_part_list>"
18542 msgstr ""
18543
18544 #. type: textblock
18545 #: ../src/guestfs-actions.pod:6307 ../fish/guestfish-actions.pod:4274
18546 msgid ""
18547 "This function is deprecated.  In new code, use the C<part_list> call instead."
18548 msgstr ""
18549
18550 # type: =head2
18551 #. type: =head2
18552 #: ../src/guestfs-actions.pod:6316
18553 msgid "guestfs_sh"
18554 msgstr ""
18555
18556 # type: verbatim
18557 #. type: verbatim
18558 #: ../src/guestfs-actions.pod:6318
18559 #, no-wrap
18560 msgid ""
18561 " char *\n"
18562 " guestfs_sh (guestfs_h *g,\n"
18563 "             const char *command);\n"
18564 "\n"
18565 msgstr ""
18566
18567 # type: textblock
18568 #. type: textblock
18569 #: ../src/guestfs-actions.pod:6322 ../fish/guestfish-actions.pod:4285
18570 msgid ""
18571 "This call runs a command from the guest filesystem via the guest's C</bin/"
18572 "sh>."
18573 msgstr ""
18574
18575 # type: textblock
18576 #. type: textblock
18577 #: ../src/guestfs-actions.pod:6325
18578 msgid "This is like C<guestfs_command>, but passes the command to:"
18579 msgstr ""
18580
18581 # type: verbatim
18582 #. type: verbatim
18583 #: ../src/guestfs-actions.pod:6327 ../fish/guestfish-actions.pod:4290
18584 #, no-wrap
18585 msgid ""
18586 " /bin/sh -c \"command\"\n"
18587 "\n"
18588 msgstr ""
18589
18590 # type: textblock
18591 #. type: textblock
18592 #: ../src/guestfs-actions.pod:6329 ../fish/guestfish-actions.pod:4292
18593 msgid ""
18594 "Depending on the guest's shell, this usually results in wildcards being "
18595 "expanded, shell expressions being interpolated and so on."
18596 msgstr ""
18597
18598 # type: textblock
18599 #. type: textblock
18600 #: ../src/guestfs-actions.pod:6333
18601 msgid "All the provisos about C<guestfs_command> apply to this call."
18602 msgstr ""
18603
18604 # type: =head2
18605 #. type: =head2
18606 #: ../src/guestfs-actions.pod:6340
18607 msgid "guestfs_sh_lines"
18608 msgstr ""
18609
18610 # type: verbatim
18611 #. type: verbatim
18612 #: ../src/guestfs-actions.pod:6342
18613 #, no-wrap
18614 msgid ""
18615 " char **\n"
18616 " guestfs_sh_lines (guestfs_h *g,\n"
18617 "                   const char *command);\n"
18618 "\n"
18619 msgstr ""
18620
18621 # type: textblock
18622 #. type: textblock
18623 #: ../src/guestfs-actions.pod:6346
18624 msgid ""
18625 "This is the same as C<guestfs_sh>, but splits the result into a list of "
18626 "lines."
18627 msgstr ""
18628
18629 # type: textblock
18630 #. type: textblock
18631 #: ../src/guestfs-actions.pod:6349
18632 msgid "See also: C<guestfs_command_lines>"
18633 msgstr ""
18634
18635 # type: =head2
18636 #. type: =head2
18637 #: ../src/guestfs-actions.pod:6357
18638 msgid "guestfs_sleep"
18639 msgstr ""
18640
18641 # type: verbatim
18642 #. type: verbatim
18643 #: ../src/guestfs-actions.pod:6359
18644 #, no-wrap
18645 msgid ""
18646 " int\n"
18647 " guestfs_sleep (guestfs_h *g,\n"
18648 "                int secs);\n"
18649 "\n"
18650 msgstr ""
18651
18652 # type: textblock
18653 #. type: textblock
18654 #: ../src/guestfs-actions.pod:6363 ../fish/guestfish-actions.pod:4311
18655 msgid "Sleep for C<secs> seconds."
18656 msgstr ""
18657
18658 # type: textblock
18659 #. type: textblock
18660 #: ../src/guestfs-actions.pod:6367
18661 msgid "(Added in 1.0.41)"
18662 msgstr ""
18663
18664 # type: =head2
18665 #. type: =head2
18666 #: ../src/guestfs-actions.pod:6369 ../src/guestfs-structs.pod:109
18667 msgid "guestfs_stat"
18668 msgstr ""
18669
18670 # type: verbatim
18671 #. type: verbatim
18672 #: ../src/guestfs-actions.pod:6371
18673 #, no-wrap
18674 msgid ""
18675 " struct guestfs_stat *\n"
18676 " guestfs_stat (guestfs_h *g,\n"
18677 "               const char *path);\n"
18678 "\n"
18679 msgstr ""
18680
18681 # type: textblock
18682 #. type: textblock
18683 #: ../src/guestfs-actions.pod:6377 ../fish/guestfish-actions.pod:4319
18684 msgid "This is the same as the C<stat(2)> system call."
18685 msgstr ""
18686
18687 # type: =head2
18688 #. type: =head2
18689 #: ../src/guestfs-actions.pod:6385 ../src/guestfs-structs.pod:135
18690 msgid "guestfs_statvfs"
18691 msgstr ""
18692
18693 # type: verbatim
18694 #. type: verbatim
18695 #: ../src/guestfs-actions.pod:6387
18696 #, no-wrap
18697 msgid ""
18698 " struct guestfs_statvfs *\n"
18699 " guestfs_statvfs (guestfs_h *g,\n"
18700 "                  const char *path);\n"
18701 "\n"
18702 msgstr ""
18703
18704 # type: textblock
18705 #. type: textblock
18706 #: ../src/guestfs-actions.pod:6391 ../fish/guestfish-actions.pod:4325
18707 msgid ""
18708 "Returns file system statistics for any mounted file system.  C<path> should "
18709 "be a file or directory in the mounted file system (typically it is the mount "
18710 "point itself, but it doesn't need to be)."
18711 msgstr ""
18712
18713 # type: textblock
18714 #. type: textblock
18715 #: ../src/guestfs-actions.pod:6395 ../fish/guestfish-actions.pod:4329
18716 msgid "This is the same as the C<statvfs(2)> system call."
18717 msgstr ""
18718
18719 # type: textblock
18720 #. type: textblock
18721 #: ../src/guestfs-actions.pod:6397
18722 msgid ""
18723 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
18724 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
18725 msgstr ""
18726
18727 # type: =head2
18728 #. type: =head2
18729 #: ../src/guestfs-actions.pod:6403
18730 msgid "guestfs_strings"
18731 msgstr ""
18732
18733 # type: verbatim
18734 #. type: verbatim
18735 #: ../src/guestfs-actions.pod:6405
18736 #, no-wrap
18737 msgid ""
18738 " char **\n"
18739 " guestfs_strings (guestfs_h *g,\n"
18740 "                  const char *path);\n"
18741 "\n"
18742 msgstr ""
18743
18744 # type: textblock
18745 #. type: textblock
18746 #: ../src/guestfs-actions.pod:6409 ../fish/guestfish-actions.pod:4335
18747 msgid ""
18748 "This runs the L<strings(1)> command on a file and returns the list of "
18749 "printable strings found."
18750 msgstr ""
18751
18752 # type: =head2
18753 #. type: =head2
18754 #: ../src/guestfs-actions.pod:6421
18755 msgid "guestfs_strings_e"
18756 msgstr ""
18757
18758 # type: verbatim
18759 #. type: verbatim
18760 #: ../src/guestfs-actions.pod:6423
18761 #, no-wrap
18762 msgid ""
18763 " char **\n"
18764 " guestfs_strings_e (guestfs_h *g,\n"
18765 "                    const char *encoding,\n"
18766 "                    const char *path);\n"
18767 "\n"
18768 msgstr ""
18769
18770 # type: textblock
18771 #. type: textblock
18772 #: ../src/guestfs-actions.pod:6428
18773 msgid ""
18774 "This is like the C<guestfs_strings> command, but allows you to specify the "
18775 "encoding of strings that are looked for in the source file C<path>."
18776 msgstr ""
18777
18778 # type: textblock
18779 #. type: textblock
18780 #: ../src/guestfs-actions.pod:6432 ../fish/guestfish-actions.pod:4349
18781 msgid "Allowed encodings are:"
18782 msgstr ""
18783
18784 # type: =item
18785 #. type: =item
18786 #: ../src/guestfs-actions.pod:6436 ../fish/guestfish-actions.pod:4353
18787 msgid "s"
18788 msgstr ""
18789
18790 # type: textblock
18791 #. type: textblock
18792 #: ../src/guestfs-actions.pod:6438
18793 msgid ""
18794 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
18795 "ISO-8859-X (this is what C<guestfs_strings> uses)."
18796 msgstr ""
18797
18798 # type: =item
18799 #. type: =item
18800 #: ../src/guestfs-actions.pod:6441 ../fish/guestfish-actions.pod:4358
18801 msgid "S"
18802 msgstr ""
18803
18804 # type: textblock
18805 #. type: textblock
18806 #: ../src/guestfs-actions.pod:6443 ../fish/guestfish-actions.pod:4360
18807 msgid "Single 8-bit-byte characters."
18808 msgstr ""
18809
18810 # type: =item
18811 #. type: =item
18812 #: ../src/guestfs-actions.pod:6445 ../fish/guestfish-actions.pod:4362
18813 msgid "b"
18814 msgstr ""
18815
18816 # type: textblock
18817 #. type: textblock
18818 #: ../src/guestfs-actions.pod:6447 ../fish/guestfish-actions.pod:4364
18819 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
18820 msgstr ""
18821
18822 # type: =item
18823 #. type: =item
18824 #: ../src/guestfs-actions.pod:6450 ../fish/guestfish-actions.pod:4367
18825 msgid "l (lower case letter L)"
18826 msgstr ""
18827
18828 # type: textblock
18829 #. type: textblock
18830 #: ../src/guestfs-actions.pod:6452 ../fish/guestfish-actions.pod:4369
18831 msgid ""
18832 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
18833 "examining binaries in Windows guests."
18834 msgstr ""
18835
18836 # type: =item
18837 #. type: =item
18838 #: ../src/guestfs-actions.pod:6455 ../fish/guestfish-actions.pod:4372
18839 msgid "B"
18840 msgstr ""
18841
18842 # type: textblock
18843 #. type: textblock
18844 #: ../src/guestfs-actions.pod:6457 ../fish/guestfish-actions.pod:4374
18845 msgid "32-bit big endian such as UCS-4BE."
18846 msgstr ""
18847
18848 # type: =item
18849 #. type: =item
18850 #: ../src/guestfs-actions.pod:6459 ../fish/guestfish-actions.pod:4376
18851 msgid "L"
18852 msgstr ""
18853
18854 # type: textblock
18855 #. type: textblock
18856 #: ../src/guestfs-actions.pod:6461 ../fish/guestfish-actions.pod:4378
18857 msgid "32-bit little endian such as UCS-4LE."
18858 msgstr ""
18859
18860 # type: textblock
18861 #. type: textblock
18862 #: ../src/guestfs-actions.pod:6465 ../fish/guestfish-actions.pod:4382
18863 msgid "The returned strings are transcoded to UTF-8."
18864 msgstr ""
18865
18866 # type: =head2
18867 #. type: =head2
18868 #: ../src/guestfs-actions.pod:6476
18869 msgid "guestfs_swapoff_device"
18870 msgstr ""
18871
18872 # type: verbatim
18873 #. type: verbatim
18874 #: ../src/guestfs-actions.pod:6478
18875 #, no-wrap
18876 msgid ""
18877 " int\n"
18878 " guestfs_swapoff_device (guestfs_h *g,\n"
18879 "                         const char *device);\n"
18880 "\n"
18881 msgstr ""
18882
18883 # type: textblock
18884 #. type: textblock
18885 #: ../src/guestfs-actions.pod:6482
18886 msgid ""
18887 "This command disables the libguestfs appliance swap device or partition "
18888 "named C<device>.  See C<guestfs_swapon_device>."
18889 msgstr ""
18890
18891 # type: =head2
18892 #. type: =head2
18893 #: ../src/guestfs-actions.pod:6490
18894 msgid "guestfs_swapoff_file"
18895 msgstr ""
18896
18897 # type: verbatim
18898 #. type: verbatim
18899 #: ../src/guestfs-actions.pod:6492
18900 #, no-wrap
18901 msgid ""
18902 " int\n"
18903 " guestfs_swapoff_file (guestfs_h *g,\n"
18904 "                       const char *file);\n"
18905 "\n"
18906 msgstr ""
18907
18908 # type: textblock
18909 #. type: textblock
18910 #: ../src/guestfs-actions.pod:6496 ../fish/guestfish-actions.pod:4399
18911 msgid "This command disables the libguestfs appliance swap on file."
18912 msgstr ""
18913
18914 # type: =head2
18915 #. type: =head2
18916 #: ../src/guestfs-actions.pod:6502
18917 msgid "guestfs_swapoff_label"
18918 msgstr ""
18919
18920 # type: verbatim
18921 #. type: verbatim
18922 #: ../src/guestfs-actions.pod:6504
18923 #, no-wrap
18924 msgid ""
18925 " int\n"
18926 " guestfs_swapoff_label (guestfs_h *g,\n"
18927 "                        const char *label);\n"
18928 "\n"
18929 msgstr ""
18930
18931 # type: textblock
18932 #. type: textblock
18933 #: ../src/guestfs-actions.pod:6508 ../fish/guestfish-actions.pod:4405
18934 msgid ""
18935 "This command disables the libguestfs appliance swap on labeled swap "
18936 "partition."
18937 msgstr ""
18938
18939 # type: =head2
18940 #. type: =head2
18941 #: ../src/guestfs-actions.pod:6515
18942 msgid "guestfs_swapoff_uuid"
18943 msgstr ""
18944
18945 # type: verbatim
18946 #. type: verbatim
18947 #: ../src/guestfs-actions.pod:6517
18948 #, no-wrap
18949 msgid ""
18950 " int\n"
18951 " guestfs_swapoff_uuid (guestfs_h *g,\n"
18952 "                       const char *uuid);\n"
18953 "\n"
18954 msgstr ""
18955
18956 # type: textblock
18957 #. type: textblock
18958 #: ../src/guestfs-actions.pod:6521 ../fish/guestfish-actions.pod:4412
18959 msgid ""
18960 "This command disables the libguestfs appliance swap partition with the given "
18961 "UUID."
18962 msgstr ""
18963
18964 # type: =head2
18965 #. type: =head2
18966 #: ../src/guestfs-actions.pod:6528
18967 msgid "guestfs_swapon_device"
18968 msgstr ""
18969
18970 # type: verbatim
18971 #. type: verbatim
18972 #: ../src/guestfs-actions.pod:6530
18973 #, no-wrap
18974 msgid ""
18975 " int\n"
18976 " guestfs_swapon_device (guestfs_h *g,\n"
18977 "                        const char *device);\n"
18978 "\n"
18979 msgstr ""
18980
18981 # type: textblock
18982 #. type: textblock
18983 #: ../src/guestfs-actions.pod:6534
18984 msgid ""
18985 "This command enables the libguestfs appliance to use the swap device or "
18986 "partition named C<device>.  The increased memory is made available for all "
18987 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
18988 msgstr ""
18989
18990 # type: textblock
18991 #. type: textblock
18992 #: ../src/guestfs-actions.pod:6539 ../fish/guestfish-actions.pod:4424
18993 msgid ""
18994 "Note that you should not swap to existing guest swap partitions unless you "
18995 "know what you are doing.  They may contain hibernation information, or other "
18996 "information that the guest doesn't want you to trash.  You also risk leaking "
18997 "information about the host to the guest this way.  Instead, attach a new "
18998 "host device to the guest and swap on that."
18999 msgstr ""
19000
19001 # type: =head2
19002 #. type: =head2
19003 #: ../src/guestfs-actions.pod:6550
19004 msgid "guestfs_swapon_file"
19005 msgstr ""
19006
19007 # type: verbatim
19008 #. type: verbatim
19009 #: ../src/guestfs-actions.pod:6552
19010 #, no-wrap
19011 msgid ""
19012 " int\n"
19013 " guestfs_swapon_file (guestfs_h *g,\n"
19014 "                      const char *file);\n"
19015 "\n"
19016 msgstr ""
19017
19018 # type: textblock
19019 #. type: textblock
19020 #: ../src/guestfs-actions.pod:6556
19021 msgid ""
19022 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
19023 "notes."
19024 msgstr ""
19025
19026 # type: =head2
19027 #. type: =head2
19028 #: ../src/guestfs-actions.pod:6563
19029 msgid "guestfs_swapon_label"
19030 msgstr ""
19031
19032 # type: verbatim
19033 #. type: verbatim
19034 #: ../src/guestfs-actions.pod:6565
19035 #, no-wrap
19036 msgid ""
19037 " int\n"
19038 " guestfs_swapon_label (guestfs_h *g,\n"
19039 "                       const char *label);\n"
19040 "\n"
19041 msgstr ""
19042
19043 # type: textblock
19044 #. type: textblock
19045 #: ../src/guestfs-actions.pod:6569
19046 msgid ""
19047 "This command enables swap to a labeled swap partition.  See "
19048 "C<guestfs_swapon_device> for other notes."
19049 msgstr ""
19050
19051 # type: =head2
19052 #. type: =head2
19053 #: ../src/guestfs-actions.pod:6576
19054 msgid "guestfs_swapon_uuid"
19055 msgstr ""
19056
19057 # type: verbatim
19058 #. type: verbatim
19059 #: ../src/guestfs-actions.pod:6578
19060 #, no-wrap
19061 msgid ""
19062 " int\n"
19063 " guestfs_swapon_uuid (guestfs_h *g,\n"
19064 "                      const char *uuid);\n"
19065 "\n"
19066 msgstr ""
19067
19068 # type: textblock
19069 #. type: textblock
19070 #: ../src/guestfs-actions.pod:6582
19071 msgid ""
19072 "This command enables swap to a swap partition with the given UUID.  See "
19073 "C<guestfs_swapon_device> for other notes."
19074 msgstr ""
19075
19076 # type: =head2
19077 #. type: =head2
19078 #: ../src/guestfs-actions.pod:6589
19079 msgid "guestfs_sync"
19080 msgstr ""
19081
19082 # type: verbatim
19083 #. type: verbatim
19084 #: ../src/guestfs-actions.pod:6591
19085 #, no-wrap
19086 msgid ""
19087 " int\n"
19088 " guestfs_sync (guestfs_h *g);\n"
19089 "\n"
19090 msgstr ""
19091
19092 # type: textblock
19093 #. type: textblock
19094 #: ../src/guestfs-actions.pod:6594 ../fish/guestfish-actions.pod:4456
19095 msgid ""
19096 "This syncs the disk, so that any writes are flushed through to the "
19097 "underlying disk image."
19098 msgstr ""
19099
19100 # type: textblock
19101 #. type: textblock
19102 #: ../src/guestfs-actions.pod:6597 ../fish/guestfish-actions.pod:4459
19103 msgid ""
19104 "You should always call this if you have modified a disk image, before "
19105 "closing the handle."
19106 msgstr ""
19107
19108 # type: =head2
19109 #. type: =head2
19110 #: ../src/guestfs-actions.pod:6604
19111 msgid "guestfs_tail"
19112 msgstr ""
19113
19114 # type: verbatim
19115 #. type: verbatim
19116 #: ../src/guestfs-actions.pod:6606
19117 #, no-wrap
19118 msgid ""
19119 " char **\n"
19120 " guestfs_tail (guestfs_h *g,\n"
19121 "               const char *path);\n"
19122 "\n"
19123 msgstr ""
19124
19125 # type: textblock
19126 #. type: textblock
19127 #: ../src/guestfs-actions.pod:6610 ../fish/guestfish-actions.pod:4466
19128 msgid ""
19129 "This command returns up to the last 10 lines of a file as a list of strings."
19130 msgstr ""
19131
19132 # type: =head2
19133 #. type: =head2
19134 #: ../src/guestfs-actions.pod:6622
19135 msgid "guestfs_tail_n"
19136 msgstr ""
19137
19138 # type: verbatim
19139 #. type: verbatim
19140 #: ../src/guestfs-actions.pod:6624
19141 #, no-wrap
19142 msgid ""
19143 " char **\n"
19144 " guestfs_tail_n (guestfs_h *g,\n"
19145 "                 int nrlines,\n"
19146 "                 const char *path);\n"
19147 "\n"
19148 msgstr ""
19149
19150 # type: textblock
19151 #. type: textblock
19152 #: ../src/guestfs-actions.pod:6629 ../fish/guestfish-actions.pod:4476
19153 msgid ""
19154 "If the parameter C<nrlines> is a positive number, this returns the last "
19155 "C<nrlines> lines of the file C<path>."
19156 msgstr ""
19157
19158 # type: textblock
19159 #. type: textblock
19160 #: ../src/guestfs-actions.pod:6632 ../fish/guestfish-actions.pod:4479
19161 msgid ""
19162 "If the parameter C<nrlines> is a negative number, this returns lines from "
19163 "the file C<path>, starting with the C<-nrlines>th line."
19164 msgstr ""
19165
19166 # type: =head2
19167 #. type: =head2
19168 #: ../src/guestfs-actions.pod:6646
19169 msgid "guestfs_tar_in"
19170 msgstr ""
19171
19172 # type: verbatim
19173 #. type: verbatim
19174 #: ../src/guestfs-actions.pod:6648
19175 #, no-wrap
19176 msgid ""
19177 " int\n"
19178 " guestfs_tar_in (guestfs_h *g,\n"
19179 "                 const char *tarfile,\n"
19180 "                 const char *directory);\n"
19181 "\n"
19182 msgstr ""
19183
19184 # type: textblock
19185 #. type: textblock
19186 #: ../src/guestfs-actions.pod:6653 ../fish/guestfish-actions.pod:4491
19187 msgid ""
19188 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
19189 "tar file) into C<directory>."
19190 msgstr ""
19191
19192 # type: textblock
19193 #. type: textblock
19194 #: ../src/guestfs-actions.pod:6656
19195 msgid ""
19196 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
19197 msgstr ""
19198
19199 # type: textblock
19200 #. type: textblock
19201 #: ../src/guestfs-actions.pod:6661 ../src/guestfs-actions.pod:6678
19202 #: ../src/guestfs-actions.pod:6694 ../src/guestfs-actions.pod:6710
19203 msgid "(Added in 1.0.3)"
19204 msgstr ""
19205
19206 # type: =head2
19207 #. type: =head2
19208 #: ../src/guestfs-actions.pod:6663
19209 msgid "guestfs_tar_out"
19210 msgstr ""
19211
19212 # type: verbatim
19213 #. type: verbatim
19214 #: ../src/guestfs-actions.pod:6665
19215 #, no-wrap
19216 msgid ""
19217 " int\n"
19218 " guestfs_tar_out (guestfs_h *g,\n"
19219 "                  const char *directory,\n"
19220 "                  const char *tarfile);\n"
19221 "\n"
19222 msgstr ""
19223
19224 # type: textblock
19225 #. type: textblock
19226 #: ../src/guestfs-actions.pod:6670 ../fish/guestfish-actions.pod:4503
19227 msgid ""
19228 "This command packs the contents of C<directory> and downloads it to local "
19229 "file C<tarfile>."
19230 msgstr ""
19231
19232 # type: textblock
19233 #. type: textblock
19234 #: ../src/guestfs-actions.pod:6673
19235 msgid ""
19236 "To download a compressed tarball, use C<guestfs_tgz_out> or "
19237 "C<guestfs_txz_out>."
19238 msgstr ""
19239
19240 # type: =head2
19241 #. type: =head2
19242 #: ../src/guestfs-actions.pod:6680
19243 msgid "guestfs_tgz_in"
19244 msgstr ""
19245
19246 # type: verbatim
19247 #. type: verbatim
19248 #: ../src/guestfs-actions.pod:6682
19249 #, no-wrap
19250 msgid ""
19251 " int\n"
19252 " guestfs_tgz_in (guestfs_h *g,\n"
19253 "                 const char *tarball,\n"
19254 "                 const char *directory);\n"
19255 "\n"
19256 msgstr ""
19257
19258 # type: textblock
19259 #. type: textblock
19260 #: ../src/guestfs-actions.pod:6687 ../fish/guestfish-actions.pod:4515
19261 msgid ""
19262 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
19263 "tar file) into C<directory>."
19264 msgstr ""
19265
19266 # type: textblock
19267 #. type: textblock
19268 #: ../src/guestfs-actions.pod:6690
19269 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
19270 msgstr ""
19271
19272 # type: =head2
19273 #. type: =head2
19274 #: ../src/guestfs-actions.pod:6696
19275 msgid "guestfs_tgz_out"
19276 msgstr ""
19277
19278 # type: verbatim
19279 #. type: verbatim
19280 #: ../src/guestfs-actions.pod:6698
19281 #, no-wrap
19282 msgid ""
19283 " int\n"
19284 " guestfs_tgz_out (guestfs_h *g,\n"
19285 "                  const char *directory,\n"
19286 "                  const char *tarball);\n"
19287 "\n"
19288 msgstr ""
19289
19290 # type: textblock
19291 #. type: textblock
19292 #: ../src/guestfs-actions.pod:6703 ../fish/guestfish-actions.pod:4526
19293 msgid ""
19294 "This command packs the contents of C<directory> and downloads it to local "
19295 "file C<tarball>."
19296 msgstr ""
19297
19298 # type: textblock
19299 #. type: textblock
19300 #: ../src/guestfs-actions.pod:6706
19301 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
19302 msgstr ""
19303
19304 # type: =head2
19305 #. type: =head2
19306 #: ../src/guestfs-actions.pod:6712
19307 msgid "guestfs_touch"
19308 msgstr ""
19309
19310 # type: verbatim
19311 #. type: verbatim
19312 #: ../src/guestfs-actions.pod:6714
19313 #, no-wrap
19314 msgid ""
19315 " int\n"
19316 " guestfs_touch (guestfs_h *g,\n"
19317 "                const char *path);\n"
19318 "\n"
19319 msgstr ""
19320
19321 # type: textblock
19322 #. type: textblock
19323 #: ../src/guestfs-actions.pod:6718 ../fish/guestfish-actions.pod:4537
19324 msgid ""
19325 "Touch acts like the L<touch(1)> command.  It can be used to update the "
19326 "timestamps on a file, or, if the file does not exist, to create a new zero-"
19327 "length file."
19328 msgstr ""
19329
19330 # type: textblock
19331 #. type: textblock
19332 #: ../src/guestfs-actions.pod:6722 ../fish/guestfish-actions.pod:4541
19333 msgid ""
19334 "This command only works on regular files, and will fail on other file types "
19335 "such as directories, symbolic links, block special etc."
19336 msgstr ""
19337
19338 # type: =head2
19339 #. type: =head2
19340 #: ../src/guestfs-actions.pod:6729
19341 msgid "guestfs_truncate"
19342 msgstr ""
19343
19344 # type: verbatim
19345 #. type: verbatim
19346 #: ../src/guestfs-actions.pod:6731
19347 #, no-wrap
19348 msgid ""
19349 " int\n"
19350 " guestfs_truncate (guestfs_h *g,\n"
19351 "                   const char *path);\n"
19352 "\n"
19353 msgstr ""
19354
19355 # type: textblock
19356 #. type: textblock
19357 #: ../src/guestfs-actions.pod:6735 ../fish/guestfish-actions.pod:4548
19358 msgid ""
19359 "This command truncates C<path> to a zero-length file.  The file must exist "
19360 "already."
19361 msgstr ""
19362
19363 # type: =head2
19364 #. type: =head2
19365 #: ../src/guestfs-actions.pod:6742
19366 msgid "guestfs_truncate_size"
19367 msgstr ""
19368
19369 # type: verbatim
19370 #. type: verbatim
19371 #: ../src/guestfs-actions.pod:6744
19372 #, no-wrap
19373 msgid ""
19374 " int\n"
19375 " guestfs_truncate_size (guestfs_h *g,\n"
19376 "                        const char *path,\n"
19377 "                        int64_t size);\n"
19378 "\n"
19379 msgstr ""
19380
19381 # type: textblock
19382 #. type: textblock
19383 #: ../src/guestfs-actions.pod:6749 ../fish/guestfish-actions.pod:4555
19384 msgid ""
19385 "This command truncates C<path> to size C<size> bytes.  The file must exist "
19386 "already."
19387 msgstr ""
19388
19389 # type: textblock
19390 #. type: textblock
19391 #: ../src/guestfs-actions.pod:6752
19392 msgid ""
19393 "If the current file size is less than C<size> then the file is extended to "
19394 "the required size with zero bytes.  This creates a sparse file (ie. disk "
19395 "blocks are not allocated for the file until you write to it).  To create a "
19396 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
19397 msgstr ""
19398
19399 # type: =head2
19400 #. type: =head2
19401 #: ../src/guestfs-actions.pod:6762
19402 msgid "guestfs_tune2fs_l"
19403 msgstr ""
19404
19405 # type: verbatim
19406 #. type: verbatim
19407 #: ../src/guestfs-actions.pod:6764
19408 #, no-wrap
19409 msgid ""
19410 " char **\n"
19411 " guestfs_tune2fs_l (guestfs_h *g,\n"
19412 "                    const char *device);\n"
19413 "\n"
19414 msgstr ""
19415
19416 # type: textblock
19417 #. type: textblock
19418 #: ../src/guestfs-actions.pod:6768 ../fish/guestfish-actions.pod:4568
19419 msgid ""
19420 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
19421 "C<device>."
19422 msgstr ""
19423
19424 # type: textblock
19425 #. type: textblock
19426 #: ../src/guestfs-actions.pod:6771 ../fish/guestfish-actions.pod:4571
19427 msgid ""
19428 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
19429 "for more details.  The list of fields returned isn't clearly defined, and "
19430 "depends on both the version of C<tune2fs> that libguestfs was built against, "
19431 "and the filesystem itself."
19432 msgstr ""
19433
19434 # type: =head2
19435 #. type: =head2
19436 #: ../src/guestfs-actions.pod:6784
19437 msgid "guestfs_txz_in"
19438 msgstr ""
19439
19440 # type: verbatim
19441 #. type: verbatim
19442 #: ../src/guestfs-actions.pod:6786
19443 #, no-wrap
19444 msgid ""
19445 " int\n"
19446 " guestfs_txz_in (guestfs_h *g,\n"
19447 "                 const char *tarball,\n"
19448 "                 const char *directory);\n"
19449 "\n"
19450 msgstr ""
19451
19452 # type: textblock
19453 #. type: textblock
19454 #: ../src/guestfs-actions.pod:6791 ../fish/guestfish-actions.pod:4580
19455 msgid ""
19456 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
19457 "tar file) into C<directory>."
19458 msgstr ""
19459
19460 # type: =head2
19461 #. type: =head2
19462 #: ../src/guestfs-actions.pod:6798
19463 msgid "guestfs_txz_out"
19464 msgstr ""
19465
19466 # type: verbatim
19467 #. type: verbatim
19468 #: ../src/guestfs-actions.pod:6800
19469 #, no-wrap
19470 msgid ""
19471 " int\n"
19472 " guestfs_txz_out (guestfs_h *g,\n"
19473 "                  const char *directory,\n"
19474 "                  const char *tarball);\n"
19475 "\n"
19476 msgstr ""
19477
19478 # type: textblock
19479 #. type: textblock
19480 #: ../src/guestfs-actions.pod:6805 ../fish/guestfish-actions.pod:4589
19481 msgid ""
19482 "This command packs the contents of C<directory> and downloads it to local "
19483 "file C<tarball> (as an xz compressed tar archive)."
19484 msgstr ""
19485
19486 # type: =head2
19487 #. type: =head2
19488 #: ../src/guestfs-actions.pod:6812
19489 msgid "guestfs_umask"
19490 msgstr ""
19491
19492 # type: verbatim
19493 #. type: verbatim
19494 #: ../src/guestfs-actions.pod:6814
19495 #, no-wrap
19496 msgid ""
19497 " int\n"
19498 " guestfs_umask (guestfs_h *g,\n"
19499 "                int mask);\n"
19500 "\n"
19501 msgstr ""
19502
19503 # type: textblock
19504 #. type: textblock
19505 #: ../src/guestfs-actions.pod:6818 ../fish/guestfish-actions.pod:4598
19506 msgid ""
19507 "This function sets the mask used for creating new files and device nodes to "
19508 "C<mask & 0777>."
19509 msgstr ""
19510
19511 # type: textblock
19512 #. type: textblock
19513 #: ../src/guestfs-actions.pod:6821 ../fish/guestfish-actions.pod:4601
19514 msgid ""
19515 "Typical umask values would be C<022> which creates new files with "
19516 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
19517 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
19518 msgstr ""
19519
19520 # type: textblock
19521 #. type: textblock
19522 #: ../src/guestfs-actions.pod:6826 ../fish/guestfish-actions.pod:4606
19523 msgid ""
19524 "The default umask is C<022>.  This is important because it means that "
19525 "directories and device nodes will be created with C<0644> or C<0755> mode "
19526 "even if you specify C<0777>."
19527 msgstr ""
19528
19529 # type: textblock
19530 #. type: textblock
19531 #: ../src/guestfs-actions.pod:6830
19532 msgid ""
19533 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
19534 "C<guestfs_mkdir>."
19535 msgstr ""
19536
19537 # type: textblock
19538 #. type: textblock
19539 #: ../src/guestfs-actions.pod:6833 ../fish/guestfish-actions.pod:4613
19540 msgid "This call returns the previous umask."
19541 msgstr ""
19542
19543 # type: =head2
19544 #. type: =head2
19545 #: ../src/guestfs-actions.pod:6839
19546 msgid "guestfs_umount"
19547 msgstr ""
19548
19549 # type: verbatim
19550 #. type: verbatim
19551 #: ../src/guestfs-actions.pod:6841
19552 #, no-wrap
19553 msgid ""
19554 " int\n"
19555 " guestfs_umount (guestfs_h *g,\n"
19556 "                 const char *pathordevice);\n"
19557 "\n"
19558 msgstr ""
19559
19560 # type: textblock
19561 #. type: textblock
19562 #: ../src/guestfs-actions.pod:6845 ../fish/guestfish-actions.pod:4621
19563 msgid ""
19564 "This unmounts the given filesystem.  The filesystem may be specified either "
19565 "by its mountpoint (path) or the device which contains the filesystem."
19566 msgstr ""
19567
19568 # type: =head2
19569 #. type: =head2
19570 #: ../src/guestfs-actions.pod:6853
19571 msgid "guestfs_umount_all"
19572 msgstr ""
19573
19574 # type: verbatim
19575 #. type: verbatim
19576 #: ../src/guestfs-actions.pod:6855
19577 #, no-wrap
19578 msgid ""
19579 " int\n"
19580 " guestfs_umount_all (guestfs_h *g);\n"
19581 "\n"
19582 msgstr ""
19583
19584 # type: textblock
19585 #. type: textblock
19586 #: ../src/guestfs-actions.pod:6858 ../fish/guestfish-actions.pod:4631
19587 msgid "This unmounts all mounted filesystems."
19588 msgstr ""
19589
19590 # type: textblock
19591 #. type: textblock
19592 #: ../src/guestfs-actions.pod:6860 ../fish/guestfish-actions.pod:4633
19593 msgid "Some internal mounts are not unmounted by this call."
19594 msgstr ""
19595
19596 # type: =head2
19597 #. type: =head2
19598 #: ../src/guestfs-actions.pod:6866
19599 msgid "guestfs_upload"
19600 msgstr ""
19601
19602 # type: verbatim
19603 #. type: verbatim
19604 #: ../src/guestfs-actions.pod:6868
19605 #, no-wrap
19606 msgid ""
19607 " int\n"
19608 " guestfs_upload (guestfs_h *g,\n"
19609 "                 const char *filename,\n"
19610 "                 const char *remotefilename);\n"
19611 "\n"
19612 msgstr ""
19613
19614 # type: textblock
19615 #. type: textblock
19616 #: ../src/guestfs-actions.pod:6873 ../src/guestfs-actions.pod:6897
19617 #: ../fish/guestfish-actions.pod:4639 ../fish/guestfish-actions.pod:4652
19618 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
19619 msgstr ""
19620
19621 # type: textblock
19622 #. type: textblock
19623 #: ../src/guestfs-actions.pod:6878
19624 msgid "See also C<guestfs_download>."
19625 msgstr ""
19626
19627 # type: =head2
19628 #. type: =head2
19629 #: ../src/guestfs-actions.pod:6889
19630 msgid "guestfs_upload_offset"
19631 msgstr ""
19632
19633 # type: verbatim
19634 #. type: verbatim
19635 #: ../src/guestfs-actions.pod:6891
19636 #, no-wrap
19637 msgid ""
19638 " int\n"
19639 " guestfs_upload_offset (guestfs_h *g,\n"
19640 "                        const char *filename,\n"
19641 "                        const char *remotefilename,\n"
19642 "                        int64_t offset);\n"
19643 "\n"
19644 msgstr ""
19645
19646 # type: textblock
19647 #. type: textblock
19648 #: ../src/guestfs-actions.pod:6900 ../fish/guestfish-actions.pod:4655
19649 msgid ""
19650 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
19651 "The intention is to overwrite parts of existing files or devices, although "
19652 "if a non-existant file is specified then it is created with a \"hole\" "
19653 "before C<offset>.  The size of the data written is implicit in the size of "
19654 "the source C<filename>."
19655 msgstr ""
19656
19657 # type: textblock
19658 #. type: textblock
19659 #: ../src/guestfs-actions.pod:6907
19660 msgid ""
19661 "Note that there is no limit on the amount of data that can be uploaded with "
19662 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
19663 "full amount unless an error occurs."
19664 msgstr ""
19665
19666 # type: textblock
19667 #. type: textblock
19668 #: ../src/guestfs-actions.pod:6912
19669 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
19670 msgstr ""
19671
19672 # type: =head2
19673 #. type: =head2
19674 #: ../src/guestfs-actions.pod:6923
19675 msgid "guestfs_utimens"
19676 msgstr ""
19677
19678 # type: verbatim
19679 #. type: verbatim
19680 #: ../src/guestfs-actions.pod:6925
19681 #, no-wrap
19682 msgid ""
19683 " int\n"
19684 " guestfs_utimens (guestfs_h *g,\n"
19685 "                  const char *path,\n"
19686 "                  int64_t atsecs,\n"
19687 "                  int64_t atnsecs,\n"
19688 "                  int64_t mtsecs,\n"
19689 "                  int64_t mtnsecs);\n"
19690 "\n"
19691 msgstr ""
19692
19693 # type: textblock
19694 #. type: textblock
19695 #: ../src/guestfs-actions.pod:6933 ../fish/guestfish-actions.pod:4675
19696 msgid "This command sets the timestamps of a file with nanosecond precision."
19697 msgstr ""
19698
19699 # type: textblock
19700 #. type: textblock
19701 #: ../src/guestfs-actions.pod:6936 ../fish/guestfish-actions.pod:4678
19702 msgid ""
19703 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
19704 "from the epoch."
19705 msgstr ""
19706
19707 # type: textblock
19708 #. type: textblock
19709 #: ../src/guestfs-actions.pod:6939 ../fish/guestfish-actions.pod:4681
19710 msgid ""
19711 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
19712 "nanoseconds from the epoch."
19713 msgstr ""
19714
19715 # type: textblock
19716 #. type: textblock
19717 #: ../src/guestfs-actions.pod:6942 ../fish/guestfish-actions.pod:4684
19718 msgid ""
19719 "If the C<*nsecs> field contains the special value C<-1> then the "
19720 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
19721 "ignored in this case)."
19722 msgstr ""
19723
19724 # type: textblock
19725 #. type: textblock
19726 #: ../src/guestfs-actions.pod:6946 ../fish/guestfish-actions.pod:4688
19727 msgid ""
19728 "If the C<*nsecs> field contains the special value C<-2> then the "
19729 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
19730 "in this case)."
19731 msgstr ""
19732
19733 # type: =head2
19734 #. type: =head2
19735 #: ../src/guestfs-actions.pod:6954 ../src/guestfs-structs.pod:175
19736 msgid "guestfs_version"
19737 msgstr ""
19738
19739 # type: verbatim
19740 #. type: verbatim
19741 #: ../src/guestfs-actions.pod:6956
19742 #, no-wrap
19743 msgid ""
19744 " struct guestfs_version *\n"
19745 " guestfs_version (guestfs_h *g);\n"
19746 "\n"
19747 msgstr ""
19748
19749 # type: textblock
19750 #. type: textblock
19751 #: ../src/guestfs-actions.pod:6959 ../fish/guestfish-actions.pod:4696
19752 msgid ""
19753 "Return the libguestfs version number that the program is linked against."
19754 msgstr ""
19755
19756 # type: textblock
19757 #. type: textblock
19758 #: ../src/guestfs-actions.pod:6962 ../fish/guestfish-actions.pod:4699
19759 msgid ""
19760 "Note that because of dynamic linking this is not necessarily the version of "
19761 "libguestfs that you compiled against.  You can compile the program, and then "
19762 "at runtime dynamically link against a completely different C<libguestfs.so> "
19763 "library."
19764 msgstr ""
19765
19766 # type: textblock
19767 #. type: textblock
19768 #: ../src/guestfs-actions.pod:6967 ../fish/guestfish-actions.pod:4704
19769 msgid ""
19770 "This call was added in version C<1.0.58>.  In previous versions of "
19771 "libguestfs there was no way to get the version number.  From C code you can "
19772 "use dynamic linker functions to find out if this symbol exists (if it "
19773 "doesn't, then it's an earlier version)."
19774 msgstr ""
19775
19776 # type: textblock
19777 #. type: textblock
19778 #: ../src/guestfs-actions.pod:6973 ../fish/guestfish-actions.pod:4710
19779 msgid ""
19780 "The call returns a structure with four elements.  The first three (C<major>, "
19781 "C<minor> and C<release>) are numbers and correspond to the usual version "
19782 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
19783 "but may be used for distro-specific information."
19784 msgstr ""
19785
19786 # type: textblock
19787 #. type: textblock
19788 #: ../src/guestfs-actions.pod:6979 ../fish/guestfish-actions.pod:4716
19789 msgid ""
19790 "To construct the original version string: C<$major.$minor.$release$extra>"
19791 msgstr ""
19792
19793 # type: textblock
19794 #. type: textblock
19795 #: ../src/guestfs-actions.pod:6982 ../fish/guestfish-actions.pod:4719
19796 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
19797 msgstr ""
19798
19799 # type: textblock
19800 #. type: textblock
19801 #: ../src/guestfs-actions.pod:6984
19802 msgid ""
19803 "I<Note:> Don't use this call to test for availability of features.  In "
19804 "enterprise distributions we backport features from later versions into "
19805 "earlier versions, making this an unreliable way to test for features.  Use "
19806 "C<guestfs_available> instead."
19807 msgstr ""
19808
19809 # type: textblock
19810 #. type: textblock
19811 #: ../src/guestfs-actions.pod:6990
19812 msgid ""
19813 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
19814 "error.  I<The caller must call C<guestfs_free_version> after use>."
19815 msgstr ""
19816
19817 # type: textblock
19818 #. type: textblock
19819 #: ../src/guestfs-actions.pod:6994
19820 msgid "(Added in 1.0.58)"
19821 msgstr ""
19822
19823 # type: =head2
19824 #. type: =head2
19825 #: ../src/guestfs-actions.pod:6996
19826 msgid "guestfs_vfs_label"
19827 msgstr ""
19828
19829 # type: verbatim
19830 #. type: verbatim
19831 #: ../src/guestfs-actions.pod:6998
19832 #, no-wrap
19833 msgid ""
19834 " char *\n"
19835 " guestfs_vfs_label (guestfs_h *g,\n"
19836 "                    const char *device);\n"
19837 "\n"
19838 msgstr ""
19839
19840 # type: textblock
19841 #. type: textblock
19842 #: ../src/guestfs-actions.pod:7002 ../fish/guestfish-actions.pod:4731
19843 msgid "This returns the filesystem label of the filesystem on C<device>."
19844 msgstr ""
19845
19846 # type: textblock
19847 #. type: textblock
19848 #: ../src/guestfs-actions.pod:7005 ../fish/guestfish-actions.pod:4734
19849 msgid "If the filesystem is unlabeled, this returns the empty string."
19850 msgstr ""
19851
19852 # type: textblock
19853 #. type: textblock
19854 #: ../src/guestfs-actions.pod:7007
19855 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
19856 msgstr ""
19857
19858 # type: textblock
19859 #. type: textblock
19860 #: ../src/guestfs-actions.pod:7012 ../src/guestfs-actions.pod:7049
19861 msgid "(Added in 1.3.18)"
19862 msgstr ""
19863
19864 # type: =head2
19865 #. type: =head2
19866 #: ../src/guestfs-actions.pod:7014
19867 msgid "guestfs_vfs_type"
19868 msgstr ""
19869
19870 # type: verbatim
19871 #. type: verbatim
19872 #: ../src/guestfs-actions.pod:7016
19873 #, no-wrap
19874 msgid ""
19875 " char *\n"
19876 " guestfs_vfs_type (guestfs_h *g,\n"
19877 "                   const char *device);\n"
19878 "\n"
19879 msgstr ""
19880
19881 # type: textblock
19882 #. type: textblock
19883 #: ../src/guestfs-actions.pod:7020 ../fish/guestfish-actions.pod:4742
19884 msgid ""
19885 "This command gets the filesystem type corresponding to the filesystem on "
19886 "C<device>."
19887 msgstr ""
19888
19889 # type: textblock
19890 #. type: textblock
19891 #: ../src/guestfs-actions.pod:7023 ../fish/guestfish-actions.pod:4745
19892 msgid ""
19893 "For most filesystems, the result is the name of the Linux VFS module which "
19894 "would be used to mount this filesystem if you mounted it without specifying "
19895 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
19896 msgstr ""
19897
19898 # type: =head2
19899 #. type: =head2
19900 #: ../src/guestfs-actions.pod:7033
19901 msgid "guestfs_vfs_uuid"
19902 msgstr ""
19903
19904 # type: verbatim
19905 #. type: verbatim
19906 #: ../src/guestfs-actions.pod:7035
19907 #, no-wrap
19908 msgid ""
19909 " char *\n"
19910 " guestfs_vfs_uuid (guestfs_h *g,\n"
19911 "                   const char *device);\n"
19912 "\n"
19913 msgstr ""
19914
19915 # type: textblock
19916 #. type: textblock
19917 #: ../src/guestfs-actions.pod:7039 ../fish/guestfish-actions.pod:4754
19918 msgid "This returns the filesystem UUID of the filesystem on C<device>."
19919 msgstr ""
19920
19921 # type: textblock
19922 #. type: textblock
19923 #: ../src/guestfs-actions.pod:7042 ../fish/guestfish-actions.pod:4757
19924 msgid "If the filesystem does not have a UUID, this returns the empty string."
19925 msgstr ""
19926
19927 # type: textblock
19928 #. type: textblock
19929 #: ../src/guestfs-actions.pod:7044
19930 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
19931 msgstr ""
19932
19933 # type: =head2
19934 #. type: =head2
19935 #: ../src/guestfs-actions.pod:7051
19936 msgid "guestfs_vg_activate"
19937 msgstr ""
19938
19939 # type: verbatim
19940 #. type: verbatim
19941 #: ../src/guestfs-actions.pod:7053
19942 #, no-wrap
19943 msgid ""
19944 " int\n"
19945 " guestfs_vg_activate (guestfs_h *g,\n"
19946 "                      int activate,\n"
19947 "                      char *const *volgroups);\n"
19948 "\n"
19949 msgstr ""
19950
19951 # type: textblock
19952 #. type: textblock
19953 #: ../src/guestfs-actions.pod:7058 ../fish/guestfish-actions.pod:4765
19954 msgid ""
19955 "This command activates or (if C<activate> is false) deactivates all logical "
19956 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
19957 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
19958 "deactivated, then those devices disappear."
19959 msgstr ""
19960
19961 # type: textblock
19962 #. type: textblock
19963 #: ../src/guestfs-actions.pod:7064 ../fish/guestfish-actions.pod:4771
19964 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
19965 msgstr ""
19966
19967 # type: textblock
19968 #. type: textblock
19969 #: ../src/guestfs-actions.pod:7066 ../fish/guestfish-actions.pod:4773
19970 msgid ""
19971 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
19972 "activated or deactivated."
19973 msgstr ""
19974
19975 # type: =head2
19976 #. type: =head2
19977 #: ../src/guestfs-actions.pod:7073
19978 msgid "guestfs_vg_activate_all"
19979 msgstr ""
19980
19981 # type: verbatim
19982 #. type: verbatim
19983 #: ../src/guestfs-actions.pod:7075
19984 #, no-wrap
19985 msgid ""
19986 " int\n"
19987 " guestfs_vg_activate_all (guestfs_h *g,\n"
19988 "                          int activate);\n"
19989 "\n"
19990 msgstr ""
19991
19992 # type: textblock
19993 #. type: textblock
19994 #: ../src/guestfs-actions.pod:7079 ../fish/guestfish-actions.pod:4780
19995 msgid ""
19996 "This command activates or (if C<activate> is false) deactivates all logical "
19997 "volumes in all volume groups.  If activated, then they are made known to the "
19998 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
19999 "those devices disappear."
20000 msgstr ""
20001
20002 # type: textblock
20003 #. type: textblock
20004 #: ../src/guestfs-actions.pod:7085 ../fish/guestfish-actions.pod:4786
20005 msgid "This command is the same as running C<vgchange -a y|n>"
20006 msgstr ""
20007
20008 # type: =head2
20009 #. type: =head2
20010 #: ../src/guestfs-actions.pod:7091
20011 msgid "guestfs_vgcreate"
20012 msgstr ""
20013
20014 # type: verbatim
20015 #. type: verbatim
20016 #: ../src/guestfs-actions.pod:7093
20017 #, no-wrap
20018 msgid ""
20019 " int\n"
20020 " guestfs_vgcreate (guestfs_h *g,\n"
20021 "                   const char *volgroup,\n"
20022 "                   char *const *physvols);\n"
20023 "\n"
20024 msgstr ""
20025
20026 # type: textblock
20027 #. type: textblock
20028 #: ../src/guestfs-actions.pod:7098 ../fish/guestfish-actions.pod:4792
20029 msgid ""
20030 "This creates an LVM volume group called C<volgroup> from the non-empty list "
20031 "of physical volumes C<physvols>."
20032 msgstr ""
20033
20034 # type: =head2
20035 #. type: =head2
20036 #: ../src/guestfs-actions.pod:7105
20037 msgid "guestfs_vglvuuids"
20038 msgstr ""
20039
20040 # type: verbatim
20041 #. type: verbatim
20042 #: ../src/guestfs-actions.pod:7107
20043 #, no-wrap
20044 msgid ""
20045 " char **\n"
20046 " guestfs_vglvuuids (guestfs_h *g,\n"
20047 "                    const char *vgname);\n"
20048 "\n"
20049 msgstr ""
20050
20051 # type: textblock
20052 #. type: textblock
20053 #: ../src/guestfs-actions.pod:7111 ../fish/guestfish-actions.pod:4799
20054 msgid ""
20055 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
20056 "volumes created in this volume group."
20057 msgstr ""
20058
20059 # type: textblock
20060 #. type: textblock
20061 #: ../src/guestfs-actions.pod:7114
20062 msgid ""
20063 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
20064 "associate logical volumes and volume groups."
20065 msgstr ""
20066
20067 # type: textblock
20068 #. type: textblock
20069 #: ../src/guestfs-actions.pod:7117
20070 msgid "See also C<guestfs_vgpvuuids>."
20071 msgstr ""
20072
20073 # type: =head2
20074 #. type: =head2
20075 #: ../src/guestfs-actions.pod:7125
20076 msgid "guestfs_vgpvuuids"
20077 msgstr ""
20078
20079 # type: verbatim
20080 #. type: verbatim
20081 #: ../src/guestfs-actions.pod:7127
20082 #, no-wrap
20083 msgid ""
20084 " char **\n"
20085 " guestfs_vgpvuuids (guestfs_h *g,\n"
20086 "                    const char *vgname);\n"
20087 "\n"
20088 msgstr ""
20089
20090 # type: textblock
20091 #. type: textblock
20092 #: ../src/guestfs-actions.pod:7131 ../fish/guestfish-actions.pod:4811
20093 msgid ""
20094 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
20095 "volumes that this volume group resides on."
20096 msgstr ""
20097
20098 # type: textblock
20099 #. type: textblock
20100 #: ../src/guestfs-actions.pod:7134
20101 msgid ""
20102 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
20103 "associate physical volumes and volume groups."
20104 msgstr ""
20105
20106 # type: textblock
20107 #. type: textblock
20108 #: ../src/guestfs-actions.pod:7137
20109 msgid "See also C<guestfs_vglvuuids>."
20110 msgstr ""
20111
20112 # type: =head2
20113 #. type: =head2
20114 #: ../src/guestfs-actions.pod:7145
20115 msgid "guestfs_vgremove"
20116 msgstr ""
20117
20118 # type: verbatim
20119 #. type: verbatim
20120 #: ../src/guestfs-actions.pod:7147
20121 #, no-wrap
20122 msgid ""
20123 " int\n"
20124 " guestfs_vgremove (guestfs_h *g,\n"
20125 "                   const char *vgname);\n"
20126 "\n"
20127 msgstr ""
20128
20129 # type: textblock
20130 #. type: textblock
20131 #: ../src/guestfs-actions.pod:7151 ../fish/guestfish-actions.pod:4823
20132 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
20133 msgstr ""
20134
20135 # type: textblock
20136 #. type: textblock
20137 #: ../src/guestfs-actions.pod:7153 ../fish/guestfish-actions.pod:4825
20138 msgid ""
20139 "This also forcibly removes all logical volumes in the volume group (if any)."
20140 msgstr ""
20141
20142 # type: =head2
20143 #. type: =head2
20144 #: ../src/guestfs-actions.pod:7160
20145 msgid "guestfs_vgrename"
20146 msgstr ""
20147
20148 # type: verbatim
20149 #. type: verbatim
20150 #: ../src/guestfs-actions.pod:7162
20151 #, no-wrap
20152 msgid ""
20153 " int\n"
20154 " guestfs_vgrename (guestfs_h *g,\n"
20155 "                   const char *volgroup,\n"
20156 "                   const char *newvolgroup);\n"
20157 "\n"
20158 msgstr ""
20159
20160 # type: textblock
20161 #. type: textblock
20162 #: ../src/guestfs-actions.pod:7167 ../fish/guestfish-actions.pod:4832
20163 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
20164 msgstr ""
20165
20166 # type: =head2
20167 #. type: =head2
20168 #: ../src/guestfs-actions.pod:7173
20169 msgid "guestfs_vgs"
20170 msgstr ""
20171
20172 # type: verbatim
20173 #. type: verbatim
20174 #: ../src/guestfs-actions.pod:7175
20175 #, no-wrap
20176 msgid ""
20177 " char **\n"
20178 " guestfs_vgs (guestfs_h *g);\n"
20179 "\n"
20180 msgstr ""
20181
20182 # type: textblock
20183 #. type: textblock
20184 #: ../src/guestfs-actions.pod:7178 ../fish/guestfish-actions.pod:4838
20185 msgid ""
20186 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
20187 "> command."
20188 msgstr ""
20189
20190 # type: textblock
20191 #. type: textblock
20192 #: ../src/guestfs-actions.pod:7181 ../fish/guestfish-actions.pod:4841
20193 msgid ""
20194 "This returns a list of just the volume group names that were detected (eg. "
20195 "C<VolGroup00>)."
20196 msgstr ""
20197
20198 # type: textblock
20199 #. type: textblock
20200 #: ../src/guestfs-actions.pod:7184
20201 msgid "See also C<guestfs_vgs_full>."
20202 msgstr ""
20203
20204 # type: =head2
20205 #. type: =head2
20206 #: ../src/guestfs-actions.pod:7192
20207 msgid "guestfs_vgs_full"
20208 msgstr ""
20209
20210 # type: verbatim
20211 #. type: verbatim
20212 #: ../src/guestfs-actions.pod:7194
20213 #, no-wrap
20214 msgid ""
20215 " struct guestfs_lvm_vg_list *\n"
20216 " guestfs_vgs_full (guestfs_h *g);\n"
20217 "\n"
20218 msgstr ""
20219
20220 # type: textblock
20221 #. type: textblock
20222 #: ../src/guestfs-actions.pod:7197 ../fish/guestfish-actions.pod:4850
20223 msgid ""
20224 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
20225 "> command.  The \"full\" version includes all fields."
20226 msgstr ""
20227
20228 # type: textblock
20229 #. type: textblock
20230 #: ../src/guestfs-actions.pod:7200
20231 msgid ""
20232 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
20233 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
20234 msgstr ""
20235
20236 # type: =head2
20237 #. type: =head2
20238 #: ../src/guestfs-actions.pod:7206
20239 msgid "guestfs_vgscan"
20240 msgstr ""
20241
20242 # type: verbatim
20243 #. type: verbatim
20244 #: ../src/guestfs-actions.pod:7208
20245 #, no-wrap
20246 msgid ""
20247 " int\n"
20248 " guestfs_vgscan (guestfs_h *g);\n"
20249 "\n"
20250 msgstr ""
20251
20252 # type: textblock
20253 #. type: textblock
20254 #: ../src/guestfs-actions.pod:7211 ../fish/guestfish-actions.pod:4857
20255 msgid ""
20256 "This rescans all block devices and rebuilds the list of LVM physical "
20257 "volumes, volume groups and logical volumes."
20258 msgstr ""
20259
20260 # type: =head2
20261 #. type: =head2
20262 #: ../src/guestfs-actions.pod:7218
20263 msgid "guestfs_vguuid"
20264 msgstr ""
20265
20266 # type: verbatim
20267 #. type: verbatim
20268 #: ../src/guestfs-actions.pod:7220
20269 #, no-wrap
20270 msgid ""
20271 " char *\n"
20272 " guestfs_vguuid (guestfs_h *g,\n"
20273 "                 const char *vgname);\n"
20274 "\n"
20275 msgstr ""
20276
20277 # type: textblock
20278 #. type: textblock
20279 #: ../src/guestfs-actions.pod:7224 ../fish/guestfish-actions.pod:4864
20280 msgid "This command returns the UUID of the LVM VG named C<vgname>."
20281 msgstr ""
20282
20283 # type: =head2
20284 #. type: =head2
20285 #: ../src/guestfs-actions.pod:7231
20286 msgid "guestfs_wait_ready"
20287 msgstr ""
20288
20289 # type: verbatim
20290 #. type: verbatim
20291 #: ../src/guestfs-actions.pod:7233
20292 #, no-wrap
20293 msgid ""
20294 " int\n"
20295 " guestfs_wait_ready (guestfs_h *g);\n"
20296 "\n"
20297 msgstr ""
20298
20299 # type: textblock
20300 #. type: textblock
20301 #: ../src/guestfs-actions.pod:7236
20302 msgid "This function is a no op."
20303 msgstr ""
20304
20305 # type: textblock
20306 #. type: textblock
20307 #: ../src/guestfs-actions.pod:7238
20308 msgid ""
20309 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
20310 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
20311 "is no longer necessary because C<guestfs_launch> now does the waiting."
20312 msgstr ""
20313
20314 # type: textblock
20315 #. type: textblock
20316 #: ../src/guestfs-actions.pod:7243
20317 msgid ""
20318 "If you see any calls to this function in code then you can just remove them, "
20319 "unless you want to retain compatibility with older versions of the API."
20320 msgstr ""
20321
20322 #. type: textblock
20323 #: ../src/guestfs-actions.pod:7249
20324 msgid ""
20325 "This function is deprecated.  In new code, use the C<launch> call instead."
20326 msgstr ""
20327
20328 # type: =head2
20329 #. type: =head2
20330 #: ../src/guestfs-actions.pod:7258
20331 msgid "guestfs_wc_c"
20332 msgstr ""
20333
20334 # type: verbatim
20335 #. type: verbatim
20336 #: ../src/guestfs-actions.pod:7260
20337 #, no-wrap
20338 msgid ""
20339 " int\n"
20340 " guestfs_wc_c (guestfs_h *g,\n"
20341 "               const char *path);\n"
20342 "\n"
20343 msgstr ""
20344
20345 # type: textblock
20346 #. type: textblock
20347 #: ../src/guestfs-actions.pod:7264 ../fish/guestfish-actions.pod:4870
20348 msgid ""
20349 "This command counts the characters in a file, using the C<wc -c> external "
20350 "command."
20351 msgstr ""
20352
20353 # type: =head2
20354 #. type: =head2
20355 #: ../src/guestfs-actions.pod:7271
20356 msgid "guestfs_wc_l"
20357 msgstr ""
20358
20359 # type: verbatim
20360 #. type: verbatim
20361 #: ../src/guestfs-actions.pod:7273
20362 #, no-wrap
20363 msgid ""
20364 " int\n"
20365 " guestfs_wc_l (guestfs_h *g,\n"
20366 "               const char *path);\n"
20367 "\n"
20368 msgstr ""
20369
20370 # type: textblock
20371 #. type: textblock
20372 #: ../src/guestfs-actions.pod:7277 ../fish/guestfish-actions.pod:4877
20373 msgid ""
20374 "This command counts the lines in a file, using the C<wc -l> external command."
20375 msgstr ""
20376
20377 # type: =head2
20378 #. type: =head2
20379 #: ../src/guestfs-actions.pod:7284
20380 msgid "guestfs_wc_w"
20381 msgstr ""
20382
20383 # type: verbatim
20384 #. type: verbatim
20385 #: ../src/guestfs-actions.pod:7286
20386 #, no-wrap
20387 msgid ""
20388 " int\n"
20389 " guestfs_wc_w (guestfs_h *g,\n"
20390 "               const char *path);\n"
20391 "\n"
20392 msgstr ""
20393
20394 # type: textblock
20395 #. type: textblock
20396 #: ../src/guestfs-actions.pod:7290 ../fish/guestfish-actions.pod:4884
20397 msgid ""
20398 "This command counts the words in a file, using the C<wc -w> external command."
20399 msgstr ""
20400
20401 # type: =head2
20402 #. type: =head2
20403 #: ../src/guestfs-actions.pod:7297
20404 msgid "guestfs_write"
20405 msgstr ""
20406
20407 # type: verbatim
20408 #. type: verbatim
20409 #: ../src/guestfs-actions.pod:7299
20410 #, no-wrap
20411 msgid ""
20412 " int\n"
20413 " guestfs_write (guestfs_h *g,\n"
20414 "                const char *path,\n"
20415 "                const char *content,\n"
20416 "                size_t content_size);\n"
20417 "\n"
20418 msgstr ""
20419
20420 # type: textblock
20421 #. type: textblock
20422 #: ../src/guestfs-actions.pod:7305 ../fish/guestfish-actions.pod:4891
20423 msgid ""
20424 "This call creates a file called C<path>.  The content of the file is the "
20425 "string C<content> (which can contain any 8 bit data)."
20426 msgstr ""
20427
20428 # type: =head2
20429 #. type: =head2
20430 #: ../src/guestfs-actions.pod:7315
20431 msgid "guestfs_write_file"
20432 msgstr ""
20433
20434 # type: verbatim
20435 #. type: verbatim
20436 #: ../src/guestfs-actions.pod:7317
20437 #, no-wrap
20438 msgid ""
20439 " int\n"
20440 " guestfs_write_file (guestfs_h *g,\n"
20441 "                     const char *path,\n"
20442 "                     const char *content,\n"
20443 "                     int size);\n"
20444 "\n"
20445 msgstr ""
20446
20447 # type: textblock
20448 #. type: textblock
20449 #: ../src/guestfs-actions.pod:7323 ../fish/guestfish-actions.pod:4901
20450 msgid ""
20451 "This call creates a file called C<path>.  The contents of the file is the "
20452 "string C<content> (which can contain any 8 bit data), with length C<size>."
20453 msgstr ""
20454
20455 # type: textblock
20456 #. type: textblock
20457 #: ../src/guestfs-actions.pod:7327 ../fish/guestfish-actions.pod:4905
20458 msgid ""
20459 "As a special case, if C<size> is C<0> then the length is calculated using "
20460 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
20461 msgstr ""
20462
20463 # type: textblock
20464 #. type: textblock
20465 #: ../src/guestfs-actions.pod:7331 ../fish/guestfish-actions.pod:4909
20466 msgid ""
20467 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
20468 "I<not> work, even if the length is specified."
20469 msgstr ""
20470
20471 # type: textblock
20472 #. type: textblock
20473 #: ../src/guestfs-actions.pod:7339 ../fish/guestfish-actions.pod:4915
20474 msgid ""
20475 "This function is deprecated.  In new code, use the C<write> call instead."
20476 msgstr ""
20477
20478 # type: =head2
20479 #. type: =head2
20480 #: ../src/guestfs-actions.pod:7348
20481 msgid "guestfs_zegrep"
20482 msgstr ""
20483
20484 # type: verbatim
20485 #. type: verbatim
20486 #: ../src/guestfs-actions.pod:7350
20487 #, no-wrap
20488 msgid ""
20489 " char **\n"
20490 " guestfs_zegrep (guestfs_h *g,\n"
20491 "                 const char *regex,\n"
20492 "                 const char *path);\n"
20493 "\n"
20494 msgstr ""
20495
20496 # type: textblock
20497 #. type: textblock
20498 #: ../src/guestfs-actions.pod:7355 ../fish/guestfish-actions.pod:4926
20499 msgid ""
20500 "This calls the external C<zegrep> program and returns the matching lines."
20501 msgstr ""
20502
20503 # type: =head2
20504 #. type: =head2
20505 #: ../src/guestfs-actions.pod:7367
20506 msgid "guestfs_zegrepi"
20507 msgstr ""
20508
20509 # type: verbatim
20510 #. type: verbatim
20511 #: ../src/guestfs-actions.pod:7369
20512 #, no-wrap
20513 msgid ""
20514 " char **\n"
20515 " guestfs_zegrepi (guestfs_h *g,\n"
20516 "                  const char *regex,\n"
20517 "                  const char *path);\n"
20518 "\n"
20519 msgstr ""
20520
20521 # type: textblock
20522 #. type: textblock
20523 #: ../src/guestfs-actions.pod:7374 ../fish/guestfish-actions.pod:4936
20524 msgid ""
20525 "This calls the external C<zegrep -i> program and returns the matching lines."
20526 msgstr ""
20527
20528 # type: =head2
20529 #. type: =head2
20530 #: ../src/guestfs-actions.pod:7386
20531 msgid "guestfs_zero"
20532 msgstr ""
20533
20534 # type: verbatim
20535 #. type: verbatim
20536 #: ../src/guestfs-actions.pod:7388
20537 #, no-wrap
20538 msgid ""
20539 " int\n"
20540 " guestfs_zero (guestfs_h *g,\n"
20541 "               const char *device);\n"
20542 "\n"
20543 msgstr ""
20544
20545 # type: textblock
20546 #. type: textblock
20547 #: ../src/guestfs-actions.pod:7392 ../fish/guestfish-actions.pod:4946
20548 msgid "This command writes zeroes over the first few blocks of C<device>."
20549 msgstr ""
20550
20551 # type: textblock
20552 #. type: textblock
20553 #: ../src/guestfs-actions.pod:7394 ../fish/guestfish-actions.pod:4948
20554 msgid ""
20555 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
20556 "securely wipe the device).  It should be sufficient to remove any partition "
20557 "tables, filesystem superblocks and so on."
20558 msgstr ""
20559
20560 #. type: textblock
20561 #: ../src/guestfs-actions.pod:7398
20562 msgid ""
20563 "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>, "
20564 "C<guestfs_is_zero_device>"
20565 msgstr ""
20566
20567 # type: =head2
20568 #. type: =head2
20569 #: ../src/guestfs-actions.pod:7410
20570 msgid "guestfs_zero_device"
20571 msgstr ""
20572
20573 # type: verbatim
20574 #. type: verbatim
20575 #: ../src/guestfs-actions.pod:7412
20576 #, no-wrap
20577 msgid ""
20578 " int\n"
20579 " guestfs_zero_device (guestfs_h *g,\n"
20580 "                      const char *device);\n"
20581 "\n"
20582 msgstr ""
20583
20584 # type: textblock
20585 #. type: textblock
20586 #: ../src/guestfs-actions.pod:7416
20587 msgid ""
20588 "This command writes zeroes over the entire C<device>.  Compare with "
20589 "C<guestfs_zero> which just zeroes the first few blocks of a device."
20590 msgstr ""
20591
20592 # type: textblock
20593 #. type: textblock
20594 #: ../src/guestfs-actions.pod:7430
20595 msgid "(Added in 1.3.1)"
20596 msgstr ""
20597
20598 # type: =head2
20599 #. type: =head2
20600 #: ../src/guestfs-actions.pod:7432
20601 msgid "guestfs_zerofree"
20602 msgstr ""
20603
20604 # type: verbatim
20605 #. type: verbatim
20606 #: ../src/guestfs-actions.pod:7434
20607 #, no-wrap
20608 msgid ""
20609 " int\n"
20610 " guestfs_zerofree (guestfs_h *g,\n"
20611 "                   const char *device);\n"
20612 "\n"
20613 msgstr ""
20614
20615 # type: textblock
20616 #. type: textblock
20617 #: ../src/guestfs-actions.pod:7438 ../fish/guestfish-actions.pod:4970
20618 msgid ""
20619 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
20620 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
20621 "possible to compress the filesystem more effectively."
20622 msgstr ""
20623
20624 # type: textblock
20625 #. type: textblock
20626 #: ../src/guestfs-actions.pod:7443 ../fish/guestfish-actions.pod:4975
20627 msgid "You should B<not> run this program if the filesystem is mounted."
20628 msgstr ""
20629
20630 # type: textblock
20631 #. type: textblock
20632 #: ../src/guestfs-actions.pod:7446 ../fish/guestfish-actions.pod:4978
20633 msgid ""
20634 "It is possible that using this program can damage the filesystem or data on "
20635 "the filesystem."
20636 msgstr ""
20637
20638 # type: =head2
20639 #. type: =head2
20640 #: ../src/guestfs-actions.pod:7453
20641 msgid "guestfs_zfgrep"
20642 msgstr ""
20643
20644 # type: verbatim
20645 #. type: verbatim
20646 #: ../src/guestfs-actions.pod:7455
20647 #, no-wrap
20648 msgid ""
20649 " char **\n"
20650 " guestfs_zfgrep (guestfs_h *g,\n"
20651 "                 const char *pattern,\n"
20652 "                 const char *path);\n"
20653 "\n"
20654 msgstr ""
20655
20656 # type: textblock
20657 #. type: textblock
20658 #: ../src/guestfs-actions.pod:7460 ../fish/guestfish-actions.pod:4985
20659 msgid ""
20660 "This calls the external C<zfgrep> program and returns the matching lines."
20661 msgstr ""
20662
20663 # type: =head2
20664 #. type: =head2
20665 #: ../src/guestfs-actions.pod:7472
20666 msgid "guestfs_zfgrepi"
20667 msgstr ""
20668
20669 # type: verbatim
20670 #. type: verbatim
20671 #: ../src/guestfs-actions.pod:7474
20672 #, no-wrap
20673 msgid ""
20674 " char **\n"
20675 " guestfs_zfgrepi (guestfs_h *g,\n"
20676 "                  const char *pattern,\n"
20677 "                  const char *path);\n"
20678 "\n"
20679 msgstr ""
20680
20681 # type: textblock
20682 #. type: textblock
20683 #: ../src/guestfs-actions.pod:7479 ../fish/guestfish-actions.pod:4995
20684 msgid ""
20685 "This calls the external C<zfgrep -i> program and returns the matching lines."
20686 msgstr ""
20687
20688 # type: =head2
20689 #. type: =head2
20690 #: ../src/guestfs-actions.pod:7491
20691 msgid "guestfs_zfile"
20692 msgstr ""
20693
20694 # type: verbatim
20695 #. type: verbatim
20696 #: ../src/guestfs-actions.pod:7493
20697 #, no-wrap
20698 msgid ""
20699 " char *\n"
20700 " guestfs_zfile (guestfs_h *g,\n"
20701 "                const char *meth,\n"
20702 "                const char *path);\n"
20703 "\n"
20704 msgstr ""
20705
20706 # type: textblock
20707 #. type: textblock
20708 #: ../src/guestfs-actions.pod:7498 ../fish/guestfish-actions.pod:5005
20709 msgid ""
20710 "This command runs C<file> after first decompressing C<path> using C<method>."
20711 msgstr ""
20712
20713 # type: textblock
20714 #. type: textblock
20715 #: ../src/guestfs-actions.pod:7501 ../fish/guestfish-actions.pod:5008
20716 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
20717 msgstr ""
20718
20719 # type: textblock
20720 #. type: textblock
20721 #: ../src/guestfs-actions.pod:7503
20722 msgid ""
20723 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
20724 "files."
20725 msgstr ""
20726
20727 # type: textblock
20728 #. type: textblock
20729 #: ../src/guestfs-actions.pod:7509 ../fish/guestfish-actions.pod:5013
20730 msgid ""
20731 "This function is deprecated.  In new code, use the C<file> call instead."
20732 msgstr ""
20733
20734 # type: =head2
20735 #. type: =head2
20736 #: ../src/guestfs-actions.pod:7518
20737 msgid "guestfs_zgrep"
20738 msgstr ""
20739
20740 # type: verbatim
20741 #. type: verbatim
20742 #: ../src/guestfs-actions.pod:7520
20743 #, no-wrap
20744 msgid ""
20745 " char **\n"
20746 " guestfs_zgrep (guestfs_h *g,\n"
20747 "                const char *regex,\n"
20748 "                const char *path);\n"
20749 "\n"
20750 msgstr ""
20751
20752 # type: textblock
20753 #. type: textblock
20754 #: ../src/guestfs-actions.pod:7525 ../fish/guestfish-actions.pod:5024
20755 msgid ""
20756 "This calls the external C<zgrep> program and returns the matching lines."
20757 msgstr ""
20758
20759 # type: =head2
20760 #. type: =head2
20761 #: ../src/guestfs-actions.pod:7537
20762 msgid "guestfs_zgrepi"
20763 msgstr ""
20764
20765 # type: verbatim
20766 #. type: verbatim
20767 #: ../src/guestfs-actions.pod:7539
20768 #, no-wrap
20769 msgid ""
20770 " char **\n"
20771 " guestfs_zgrepi (guestfs_h *g,\n"
20772 "                 const char *regex,\n"
20773 "                 const char *path);\n"
20774 "\n"
20775 msgstr ""
20776
20777 # type: textblock
20778 #. type: textblock
20779 #: ../src/guestfs-actions.pod:7544 ../fish/guestfish-actions.pod:5034
20780 msgid ""
20781 "This calls the external C<zgrep -i> program and returns the matching lines."
20782 msgstr ""
20783
20784 # type: =item
20785 #. type: =item
20786 #: ../src/guestfs-availability.pod:3
20787 msgid "B<augeas>"
20788 msgstr ""
20789
20790 # type: textblock
20791 #. type: textblock
20792 #: ../src/guestfs-availability.pod:5
20793 msgid ""
20794 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
20795 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
20796 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
20797 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
20798 "L</guestfs_aug_save> L</guestfs_aug_set>"
20799 msgstr ""
20800
20801 # type: =item
20802 #. type: =item
20803 #: ../src/guestfs-availability.pod:21
20804 msgid "B<inotify>"
20805 msgstr ""
20806
20807 # type: textblock
20808 #. type: textblock
20809 #: ../src/guestfs-availability.pod:23
20810 msgid ""
20811 "The following functions: L</guestfs_inotify_add_watch> L</"
20812 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
20813 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
20814 msgstr ""
20815
20816 # type: =item
20817 #. type: =item
20818 #: ../src/guestfs-availability.pod:31
20819 msgid "B<linuxfsuuid>"
20820 msgstr ""
20821
20822 # type: textblock
20823 #. type: textblock
20824 #: ../src/guestfs-availability.pod:33
20825 msgid ""
20826 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
20827 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
20828 msgstr ""
20829
20830 # type: =item
20831 #. type: =item
20832 #: ../src/guestfs-availability.pod:40
20833 msgid "B<linuxmodules>"
20834 msgstr ""
20835
20836 # type: textblock
20837 #. type: textblock
20838 #: ../src/guestfs-availability.pod:42
20839 msgid "The following functions: L</guestfs_modprobe>"
20840 msgstr ""
20841
20842 # type: =item
20843 #. type: =item
20844 #: ../src/guestfs-availability.pod:45
20845 msgid "B<linuxxattrs>"
20846 msgstr ""
20847
20848 # type: textblock
20849 #. type: textblock
20850 #: ../src/guestfs-availability.pod:47
20851 msgid ""
20852 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
20853 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
20854 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
20855 "guestfs_setxattr>"
20856 msgstr ""
20857
20858 # type: =item
20859 #. type: =item
20860 #: ../src/guestfs-availability.pod:58
20861 msgid "B<luks>"
20862 msgstr ""
20863
20864 # type: textblock
20865 #. type: textblock
20866 #: ../src/guestfs-availability.pod:60
20867 msgid ""
20868 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
20869 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
20870 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
20871 msgstr ""
20872
20873 # type: =item
20874 #. type: =item
20875 #: ../src/guestfs-availability.pod:69
20876 msgid "B<lvm2>"
20877 msgstr ""
20878
20879 # type: textblock
20880 #. type: textblock
20881 #: ../src/guestfs-availability.pod:71
20882 msgid ""
20883 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
20884 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
20885 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
20886 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
20887 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
20888 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
20889 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
20890 msgstr ""
20891
20892 # type: =item
20893 #. type: =item
20894 #: ../src/guestfs-availability.pod:94
20895 msgid "B<mknod>"
20896 msgstr ""
20897
20898 # type: textblock
20899 #. type: textblock
20900 #: ../src/guestfs-availability.pod:96
20901 msgid ""
20902 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
20903 "guestfs_mknod_b> L</guestfs_mknod_c>"
20904 msgstr ""
20905
20906 # type: =item
20907 #. type: =item
20908 #: ../src/guestfs-availability.pod:102
20909 msgid "B<ntfs3g>"
20910 msgstr ""
20911
20912 # type: textblock
20913 #. type: textblock
20914 #: ../src/guestfs-availability.pod:104
20915 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
20916 msgstr ""
20917
20918 # type: =item
20919 #. type: =item
20920 #: ../src/guestfs-availability.pod:107
20921 msgid "B<ntfsprogs>"
20922 msgstr ""
20923
20924 # type: textblock
20925 #. type: textblock
20926 #: ../src/guestfs-availability.pod:109
20927 msgid ""
20928 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
20929 msgstr ""
20930
20931 # type: =item
20932 #. type: =item
20933 #: ../src/guestfs-availability.pod:113
20934 msgid "B<realpath>"
20935 msgstr ""
20936
20937 # type: textblock
20938 #. type: textblock
20939 #: ../src/guestfs-availability.pod:115
20940 msgid "The following functions: L</guestfs_realpath>"
20941 msgstr ""
20942
20943 # type: =item
20944 #. type: =item
20945 #: ../src/guestfs-availability.pod:118
20946 msgid "B<scrub>"
20947 msgstr ""
20948
20949 # type: textblock
20950 #. type: textblock
20951 #: ../src/guestfs-availability.pod:120
20952 msgid ""
20953 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
20954 "guestfs_scrub_freespace>"
20955 msgstr ""
20956
20957 # type: =item
20958 #. type: =item
20959 #: ../src/guestfs-availability.pod:125
20960 msgid "B<selinux>"
20961 msgstr ""
20962
20963 # type: textblock
20964 #. type: textblock
20965 #: ../src/guestfs-availability.pod:127
20966 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
20967 msgstr ""
20968
20969 # type: =item
20970 #. type: =item
20971 #: ../src/guestfs-availability.pod:131
20972 msgid "B<xz>"
20973 msgstr ""
20974
20975 # type: textblock
20976 #. type: textblock
20977 #: ../src/guestfs-availability.pod:133
20978 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
20979 msgstr ""
20980
20981 # type: =item
20982 #. type: =item
20983 #: ../src/guestfs-availability.pod:137
20984 msgid "B<zerofree>"
20985 msgstr ""
20986
20987 # type: textblock
20988 #. type: textblock
20989 #: ../src/guestfs-availability.pod:139
20990 msgid "The following functions: L</guestfs_zerofree>"
20991 msgstr ""
20992
20993 # type: =head2
20994 #. type: =head2
20995 #: ../src/guestfs-structs.pod:1
20996 msgid "guestfs_int_bool"
20997 msgstr ""
20998
20999 # type: verbatim
21000 #. type: verbatim
21001 #: ../src/guestfs-structs.pod:3
21002 #, no-wrap
21003 msgid ""
21004 " struct guestfs_int_bool {\n"
21005 "   int32_t i;\n"
21006 "   int32_t b;\n"
21007 " };\n"
21008 " \n"
21009 msgstr ""
21010
21011 # type: verbatim
21012 #. type: verbatim
21013 #: ../src/guestfs-structs.pod:8
21014 #, no-wrap
21015 msgid ""
21016 " struct guestfs_int_bool_list {\n"
21017 "   uint32_t len; /* Number of elements in list. */\n"
21018 "   struct guestfs_int_bool *val; /* Elements. */\n"
21019 " };\n"
21020 " \n"
21021 msgstr ""
21022
21023 # type: verbatim
21024 #. type: verbatim
21025 #: ../src/guestfs-structs.pod:13
21026 #, no-wrap
21027 msgid ""
21028 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
21029 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
21030 "\n"
21031 msgstr ""
21032
21033 # type: =head2
21034 #. type: =head2
21035 #: ../src/guestfs-structs.pod:16
21036 msgid "guestfs_lvm_pv"
21037 msgstr ""
21038
21039 # type: verbatim
21040 #. type: verbatim
21041 #: ../src/guestfs-structs.pod:18
21042 #, no-wrap
21043 msgid ""
21044 " struct guestfs_lvm_pv {\n"
21045 "   char *pv_name;\n"
21046 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21047 "   char pv_uuid[32];\n"
21048 "   char *pv_fmt;\n"
21049 "   uint64_t pv_size;\n"
21050 "   uint64_t dev_size;\n"
21051 "   uint64_t pv_free;\n"
21052 "   uint64_t pv_used;\n"
21053 "   char *pv_attr;\n"
21054 "   int64_t pv_pe_count;\n"
21055 "   int64_t pv_pe_alloc_count;\n"
21056 "   char *pv_tags;\n"
21057 "   uint64_t pe_start;\n"
21058 "   int64_t pv_mda_count;\n"
21059 "   uint64_t pv_mda_free;\n"
21060 " };\n"
21061 " \n"
21062 msgstr ""
21063
21064 # type: verbatim
21065 #. type: verbatim
21066 #: ../src/guestfs-structs.pod:36
21067 #, no-wrap
21068 msgid ""
21069 " struct guestfs_lvm_pv_list {\n"
21070 "   uint32_t len; /* Number of elements in list. */\n"
21071 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
21072 " };\n"
21073 " \n"
21074 msgstr ""
21075
21076 # type: verbatim
21077 #. type: verbatim
21078 #: ../src/guestfs-structs.pod:41
21079 #, no-wrap
21080 msgid ""
21081 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
21082 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
21083 "\n"
21084 msgstr ""
21085
21086 # type: =head2
21087 #. type: =head2
21088 #: ../src/guestfs-structs.pod:44
21089 msgid "guestfs_lvm_vg"
21090 msgstr ""
21091
21092 # type: verbatim
21093 #. type: verbatim
21094 #: ../src/guestfs-structs.pod:46
21095 #, no-wrap
21096 msgid ""
21097 " struct guestfs_lvm_vg {\n"
21098 "   char *vg_name;\n"
21099 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21100 "   char vg_uuid[32];\n"
21101 "   char *vg_fmt;\n"
21102 "   char *vg_attr;\n"
21103 "   uint64_t vg_size;\n"
21104 "   uint64_t vg_free;\n"
21105 "   char *vg_sysid;\n"
21106 "   uint64_t vg_extent_size;\n"
21107 "   int64_t vg_extent_count;\n"
21108 "   int64_t vg_free_count;\n"
21109 "   int64_t max_lv;\n"
21110 "   int64_t max_pv;\n"
21111 "   int64_t pv_count;\n"
21112 "   int64_t lv_count;\n"
21113 "   int64_t snap_count;\n"
21114 "   int64_t vg_seqno;\n"
21115 "   char *vg_tags;\n"
21116 "   int64_t vg_mda_count;\n"
21117 "   uint64_t vg_mda_free;\n"
21118 " };\n"
21119 " \n"
21120 msgstr ""
21121
21122 # type: verbatim
21123 #. type: verbatim
21124 #: ../src/guestfs-structs.pod:69
21125 #, no-wrap
21126 msgid ""
21127 " struct guestfs_lvm_vg_list {\n"
21128 "   uint32_t len; /* Number of elements in list. */\n"
21129 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
21130 " };\n"
21131 " \n"
21132 msgstr ""
21133
21134 # type: verbatim
21135 #. type: verbatim
21136 #: ../src/guestfs-structs.pod:74
21137 #, no-wrap
21138 msgid ""
21139 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
21140 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
21141 "\n"
21142 msgstr ""
21143
21144 # type: =head2
21145 #. type: =head2
21146 #: ../src/guestfs-structs.pod:77
21147 msgid "guestfs_lvm_lv"
21148 msgstr ""
21149
21150 # type: verbatim
21151 #. type: verbatim
21152 #: ../src/guestfs-structs.pod:79
21153 #, no-wrap
21154 msgid ""
21155 " struct guestfs_lvm_lv {\n"
21156 "   char *lv_name;\n"
21157 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21158 "   char lv_uuid[32];\n"
21159 "   char *lv_attr;\n"
21160 "   int64_t lv_major;\n"
21161 "   int64_t lv_minor;\n"
21162 "   int64_t lv_kernel_major;\n"
21163 "   int64_t lv_kernel_minor;\n"
21164 "   uint64_t lv_size;\n"
21165 "   int64_t seg_count;\n"
21166 "   char *origin;\n"
21167 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
21168 "   float snap_percent;\n"
21169 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
21170 "   float copy_percent;\n"
21171 "   char *move_pv;\n"
21172 "   char *lv_tags;\n"
21173 "   char *mirror_log;\n"
21174 "   char *modules;\n"
21175 " };\n"
21176 " \n"
21177 msgstr ""
21178
21179 # type: verbatim
21180 #. type: verbatim
21181 #: ../src/guestfs-structs.pod:101
21182 #, no-wrap
21183 msgid ""
21184 " struct guestfs_lvm_lv_list {\n"
21185 "   uint32_t len; /* Number of elements in list. */\n"
21186 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
21187 " };\n"
21188 " \n"
21189 msgstr ""
21190
21191 # type: verbatim
21192 #. type: verbatim
21193 #: ../src/guestfs-structs.pod:106
21194 #, no-wrap
21195 msgid ""
21196 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
21197 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
21198 "\n"
21199 msgstr ""
21200
21201 # type: verbatim
21202 #. type: verbatim
21203 #: ../src/guestfs-structs.pod:111
21204 #, no-wrap
21205 msgid ""
21206 " struct guestfs_stat {\n"
21207 "   int64_t dev;\n"
21208 "   int64_t ino;\n"
21209 "   int64_t mode;\n"
21210 "   int64_t nlink;\n"
21211 "   int64_t uid;\n"
21212 "   int64_t gid;\n"
21213 "   int64_t rdev;\n"
21214 "   int64_t size;\n"
21215 "   int64_t blksize;\n"
21216 "   int64_t blocks;\n"
21217 "   int64_t atime;\n"
21218 "   int64_t mtime;\n"
21219 "   int64_t ctime;\n"
21220 " };\n"
21221 " \n"
21222 msgstr ""
21223
21224 # type: verbatim
21225 #. type: verbatim
21226 #: ../src/guestfs-structs.pod:127
21227 #, no-wrap
21228 msgid ""
21229 " struct guestfs_stat_list {\n"
21230 "   uint32_t len; /* Number of elements in list. */\n"
21231 "   struct guestfs_stat *val; /* Elements. */\n"
21232 " };\n"
21233 " \n"
21234 msgstr ""
21235
21236 # type: verbatim
21237 #. type: verbatim
21238 #: ../src/guestfs-structs.pod:132
21239 #, no-wrap
21240 msgid ""
21241 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
21242 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
21243 "\n"
21244 msgstr ""
21245
21246 # type: verbatim
21247 #. type: verbatim
21248 #: ../src/guestfs-structs.pod:137
21249 #, no-wrap
21250 msgid ""
21251 " struct guestfs_statvfs {\n"
21252 "   int64_t bsize;\n"
21253 "   int64_t frsize;\n"
21254 "   int64_t blocks;\n"
21255 "   int64_t bfree;\n"
21256 "   int64_t bavail;\n"
21257 "   int64_t files;\n"
21258 "   int64_t ffree;\n"
21259 "   int64_t favail;\n"
21260 "   int64_t fsid;\n"
21261 "   int64_t flag;\n"
21262 "   int64_t namemax;\n"
21263 " };\n"
21264 " \n"
21265 msgstr ""
21266
21267 # type: verbatim
21268 #. type: verbatim
21269 #: ../src/guestfs-structs.pod:151
21270 #, no-wrap
21271 msgid ""
21272 " struct guestfs_statvfs_list {\n"
21273 "   uint32_t len; /* Number of elements in list. */\n"
21274 "   struct guestfs_statvfs *val; /* Elements. */\n"
21275 " };\n"
21276 " \n"
21277 msgstr ""
21278
21279 # type: verbatim
21280 #. type: verbatim
21281 #: ../src/guestfs-structs.pod:156
21282 #, no-wrap
21283 msgid ""
21284 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
21285 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
21286 "\n"
21287 msgstr ""
21288
21289 # type: =head2
21290 #. type: =head2
21291 #: ../src/guestfs-structs.pod:159
21292 msgid "guestfs_dirent"
21293 msgstr ""
21294
21295 # type: verbatim
21296 #. type: verbatim
21297 #: ../src/guestfs-structs.pod:161
21298 #, no-wrap
21299 msgid ""
21300 " struct guestfs_dirent {\n"
21301 "   int64_t ino;\n"
21302 "   char ftyp;\n"
21303 "   char *name;\n"
21304 " };\n"
21305 " \n"
21306 msgstr ""
21307
21308 # type: verbatim
21309 #. type: verbatim
21310 #: ../src/guestfs-structs.pod:167
21311 #, no-wrap
21312 msgid ""
21313 " struct guestfs_dirent_list {\n"
21314 "   uint32_t len; /* Number of elements in list. */\n"
21315 "   struct guestfs_dirent *val; /* Elements. */\n"
21316 " };\n"
21317 " \n"
21318 msgstr ""
21319
21320 # type: verbatim
21321 #. type: verbatim
21322 #: ../src/guestfs-structs.pod:172
21323 #, no-wrap
21324 msgid ""
21325 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
21326 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
21327 "\n"
21328 msgstr ""
21329
21330 # type: verbatim
21331 #. type: verbatim
21332 #: ../src/guestfs-structs.pod:177
21333 #, no-wrap
21334 msgid ""
21335 " struct guestfs_version {\n"
21336 "   int64_t major;\n"
21337 "   int64_t minor;\n"
21338 "   int64_t release;\n"
21339 "   char *extra;\n"
21340 " };\n"
21341 " \n"
21342 msgstr ""
21343
21344 # type: verbatim
21345 #. type: verbatim
21346 #: ../src/guestfs-structs.pod:184
21347 #, no-wrap
21348 msgid ""
21349 " struct guestfs_version_list {\n"
21350 "   uint32_t len; /* Number of elements in list. */\n"
21351 "   struct guestfs_version *val; /* Elements. */\n"
21352 " };\n"
21353 " \n"
21354 msgstr ""
21355
21356 # type: verbatim
21357 #. type: verbatim
21358 #: ../src/guestfs-structs.pod:189
21359 #, no-wrap
21360 msgid ""
21361 " void guestfs_free_version (struct guestfs_free_version *);\n"
21362 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
21363 "\n"
21364 msgstr ""
21365
21366 # type: =head2
21367 #. type: =head2
21368 #: ../src/guestfs-structs.pod:192
21369 msgid "guestfs_xattr"
21370 msgstr ""
21371
21372 # type: verbatim
21373 #. type: verbatim
21374 #: ../src/guestfs-structs.pod:194
21375 #, no-wrap
21376 msgid ""
21377 " struct guestfs_xattr {\n"
21378 "   char *attrname;\n"
21379 "   /* The next two fields describe a byte array. */\n"
21380 "   uint32_t attrval_len;\n"
21381 "   char *attrval;\n"
21382 " };\n"
21383 " \n"
21384 msgstr ""
21385
21386 # type: verbatim
21387 #. type: verbatim
21388 #: ../src/guestfs-structs.pod:201
21389 #, no-wrap
21390 msgid ""
21391 " struct guestfs_xattr_list {\n"
21392 "   uint32_t len; /* Number of elements in list. */\n"
21393 "   struct guestfs_xattr *val; /* Elements. */\n"
21394 " };\n"
21395 " \n"
21396 msgstr ""
21397
21398 # type: verbatim
21399 #. type: verbatim
21400 #: ../src/guestfs-structs.pod:206
21401 #, no-wrap
21402 msgid ""
21403 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
21404 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
21405 "\n"
21406 msgstr ""
21407
21408 # type: =head2
21409 #. type: =head2
21410 #: ../src/guestfs-structs.pod:209
21411 msgid "guestfs_inotify_event"
21412 msgstr ""
21413
21414 # type: verbatim
21415 #. type: verbatim
21416 #: ../src/guestfs-structs.pod:211
21417 #, no-wrap
21418 msgid ""
21419 " struct guestfs_inotify_event {\n"
21420 "   int64_t in_wd;\n"
21421 "   uint32_t in_mask;\n"
21422 "   uint32_t in_cookie;\n"
21423 "   char *in_name;\n"
21424 " };\n"
21425 " \n"
21426 msgstr ""
21427
21428 # type: verbatim
21429 #. type: verbatim
21430 #: ../src/guestfs-structs.pod:218
21431 #, no-wrap
21432 msgid ""
21433 " struct guestfs_inotify_event_list {\n"
21434 "   uint32_t len; /* Number of elements in list. */\n"
21435 "   struct guestfs_inotify_event *val; /* Elements. */\n"
21436 " };\n"
21437 " \n"
21438 msgstr ""
21439
21440 # type: verbatim
21441 #. type: verbatim
21442 #: ../src/guestfs-structs.pod:223
21443 #, no-wrap
21444 msgid ""
21445 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
21446 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
21447 "\n"
21448 msgstr ""
21449
21450 # type: =head2
21451 #. type: =head2
21452 #: ../src/guestfs-structs.pod:226
21453 msgid "guestfs_partition"
21454 msgstr ""
21455
21456 # type: verbatim
21457 #. type: verbatim
21458 #: ../src/guestfs-structs.pod:228
21459 #, no-wrap
21460 msgid ""
21461 " struct guestfs_partition {\n"
21462 "   int32_t part_num;\n"
21463 "   uint64_t part_start;\n"
21464 "   uint64_t part_end;\n"
21465 "   uint64_t part_size;\n"
21466 " };\n"
21467 " \n"
21468 msgstr ""
21469
21470 # type: verbatim
21471 #. type: verbatim
21472 #: ../src/guestfs-structs.pod:235
21473 #, no-wrap
21474 msgid ""
21475 " struct guestfs_partition_list {\n"
21476 "   uint32_t len; /* Number of elements in list. */\n"
21477 "   struct guestfs_partition *val; /* Elements. */\n"
21478 " };\n"
21479 " \n"
21480 msgstr ""
21481
21482 # type: verbatim
21483 #. type: verbatim
21484 #: ../src/guestfs-structs.pod:240
21485 #, no-wrap
21486 msgid ""
21487 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
21488 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
21489 "\n"
21490 msgstr ""
21491
21492 # type: =head2
21493 #. type: =head2
21494 #: ../src/guestfs-structs.pod:243
21495 msgid "guestfs_application"
21496 msgstr ""
21497
21498 # type: verbatim
21499 #. type: verbatim
21500 #: ../src/guestfs-structs.pod:245
21501 #, no-wrap
21502 msgid ""
21503 " struct guestfs_application {\n"
21504 "   char *app_name;\n"
21505 "   char *app_display_name;\n"
21506 "   int32_t app_epoch;\n"
21507 "   char *app_version;\n"
21508 "   char *app_release;\n"
21509 "   char *app_install_path;\n"
21510 "   char *app_trans_path;\n"
21511 "   char *app_publisher;\n"
21512 "   char *app_url;\n"
21513 "   char *app_source_package;\n"
21514 "   char *app_summary;\n"
21515 "   char *app_description;\n"
21516 " };\n"
21517 " \n"
21518 msgstr ""
21519
21520 # type: verbatim
21521 #. type: verbatim
21522 #: ../src/guestfs-structs.pod:260
21523 #, no-wrap
21524 msgid ""
21525 " struct guestfs_application_list {\n"
21526 "   uint32_t len; /* Number of elements in list. */\n"
21527 "   struct guestfs_application *val; /* Elements. */\n"
21528 " };\n"
21529 " \n"
21530 msgstr ""
21531
21532 # type: verbatim
21533 #. type: verbatim
21534 #: ../src/guestfs-structs.pod:265
21535 #, no-wrap
21536 msgid ""
21537 " void guestfs_free_application (struct guestfs_free_application *);\n"
21538 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
21539 "\n"
21540 msgstr ""
21541
21542 # type: textblock
21543 #. type: textblock
21544 #: ../fish/guestfish.pod:5
21545 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
21546 msgstr ""
21547
21548 # type: verbatim
21549 #. type: verbatim
21550 #: ../fish/guestfish.pod:9
21551 #, no-wrap
21552 msgid ""
21553 " guestfish [--options] [commands]\n"
21554 "\n"
21555 msgstr ""
21556
21557 # type: verbatim
21558 #. type: verbatim
21559 #: ../fish/guestfish.pod:11
21560 #, no-wrap
21561 msgid ""
21562 " guestfish\n"
21563 "\n"
21564 msgstr ""
21565
21566 # type: verbatim
21567 #. type: verbatim
21568 #: ../fish/guestfish.pod:13
21569 #, no-wrap
21570 msgid ""
21571 " guestfish [--ro|--rw] -a disk.img\n"
21572 "\n"
21573 msgstr ""
21574
21575 # type: verbatim
21576 #. type: verbatim
21577 #: ../fish/guestfish.pod:15
21578 #, no-wrap
21579 msgid ""
21580 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
21581 "\n"
21582 msgstr ""
21583
21584 # type: verbatim
21585 #. type: verbatim
21586 #: ../fish/guestfish.pod:17
21587 #, no-wrap
21588 msgid ""
21589 " guestfish -d libvirt-domain\n"
21590 "\n"
21591 msgstr ""
21592
21593 # type: verbatim
21594 #. type: verbatim
21595 #: ../fish/guestfish.pod:19
21596 #, no-wrap
21597 msgid ""
21598 " guestfish [--ro|--rw] -a disk.img -i\n"
21599 "\n"
21600 msgstr ""
21601
21602 # type: verbatim
21603 #. type: verbatim
21604 #: ../fish/guestfish.pod:21
21605 #, no-wrap
21606 msgid ""
21607 " guestfish -d libvirt-domain -i\n"
21608 "\n"
21609 msgstr ""
21610
21611 # type: =head1
21612 #. type: =head1
21613 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15
21614 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
21615 msgid "WARNING"
21616 msgstr ""
21617
21618 # type: textblock
21619 #. type: textblock
21620 #: ../fish/guestfish.pod:25
21621 msgid ""
21622 "Using guestfish in read/write mode on live virtual machines can be "
21623 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
21624 "option to use guestfish safely if the disk image or virtual machine might be "
21625 "live."
21626 msgstr ""
21627
21628 # type: textblock
21629 #. type: textblock
21630 #: ../fish/guestfish.pod:32
21631 msgid ""
21632 "Guestfish is a shell and command-line tool for examining and modifying "
21633 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
21634 "functionality of the guestfs API, see L<guestfs(3)>."
21635 msgstr ""
21636
21637 # type: textblock
21638 #. type: textblock
21639 #: ../fish/guestfish.pod:36
21640 msgid ""
21641 "Guestfish gives you structured access to the libguestfs API, from shell "
21642 "scripts or the command line or interactively.  If you want to rescue a "
21643 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
21644 "command."
21645 msgstr ""
21646
21647 # type: =head1
21648 #. type: =head1
21649 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:949
21650 #: ../fuse/guestmount.pod:39 ../tools/virt-tar.pl:50
21651 msgid "EXAMPLES"
21652 msgstr ""
21653
21654 # type: =head2
21655 #. type: =head2
21656 #: ../fish/guestfish.pod:43
21657 msgid "As an interactive shell"
21658 msgstr ""
21659
21660 # type: verbatim
21661 #. type: verbatim
21662 #: ../fish/guestfish.pod:45
21663 #, no-wrap
21664 msgid ""
21665 " $ guestfish\n"
21666 " \n"
21667 msgstr ""
21668
21669 # type: verbatim
21670 #. type: verbatim
21671 #: ../fish/guestfish.pod:47
21672 #, no-wrap
21673 msgid ""
21674 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
21675 " editing virtual machine filesystems.\n"
21676 " \n"
21677 msgstr ""
21678
21679 # type: verbatim
21680 #. type: verbatim
21681 #: ../fish/guestfish.pod:50
21682 #, no-wrap
21683 msgid ""
21684 " Type: 'help' for a list of commands\n"
21685 "       'man' to read the manual\n"
21686 "       'quit' to quit the shell\n"
21687 " \n"
21688 msgstr ""
21689
21690 # type: verbatim
21691 #. type: verbatim
21692 #: ../fish/guestfish.pod:54
21693 #, no-wrap
21694 msgid ""
21695 " ><fs> add-ro disk.img\n"
21696 " ><fs> run\n"
21697 " ><fs> list-filesystems\n"
21698 " /dev/sda1: ext4\n"
21699 " /dev/vg_guest/lv_root: ext4\n"
21700 " /dev/vg_guest/lv_swap: swap\n"
21701 " ><fs> mount /dev/vg_guest/lv_root /\n"
21702 " ><fs> cat /etc/fstab\n"
21703 " # /etc/fstab\n"
21704 " # Created by anaconda\n"
21705 " [...]\n"
21706 " ><fs> exit\n"
21707 "\n"
21708 msgstr ""
21709
21710 # type: =head2
21711 #. type: =head2
21712 #: ../fish/guestfish.pod:67
21713 msgid "From shell scripts"
21714 msgstr ""
21715
21716 # type: textblock
21717 #. type: textblock
21718 #: ../fish/guestfish.pod:69
21719 msgid "Create a new C</etc/motd> file in a guest or disk image:"
21720 msgstr ""
21721
21722 # type: verbatim
21723 #. type: verbatim
21724 #: ../fish/guestfish.pod:71
21725 #, no-wrap
21726 msgid ""
21727 " guestfish <<_EOF_\n"
21728 " add disk.img\n"
21729 " run\n"
21730 " mount /dev/vg_guest/lv_root /\n"
21731 " write /etc/motd \"Welcome, new users\"\n"
21732 " _EOF_\n"
21733 "\n"
21734 msgstr ""
21735
21736 # type: textblock
21737 #. type: textblock
21738 #: ../fish/guestfish.pod:78
21739 msgid "List the LVM logical volumes in a disk image:"
21740 msgstr ""
21741
21742 # type: verbatim
21743 #. type: verbatim
21744 #: ../fish/guestfish.pod:80
21745 #, no-wrap
21746 msgid ""
21747 " guestfish -a disk.img --ro <<_EOF_\n"
21748 " run\n"
21749 " lvs\n"
21750 " _EOF_\n"
21751 "\n"
21752 msgstr ""
21753
21754 # type: textblock
21755 #. type: textblock
21756 #: ../fish/guestfish.pod:85
21757 msgid "List all the filesystems in a disk image:"
21758 msgstr ""
21759
21760 # type: verbatim
21761 #. type: verbatim
21762 #: ../fish/guestfish.pod:87
21763 #, no-wrap
21764 msgid ""
21765 " guestfish -a disk.img --ro <<_EOF_\n"
21766 " run\n"
21767 " list-filesystems\n"
21768 " _EOF_\n"
21769 "\n"
21770 msgstr ""
21771
21772 # type: =head2
21773 #. type: =head2
21774 #: ../fish/guestfish.pod:92
21775 msgid "On one command line"
21776 msgstr ""
21777
21778 # type: textblock
21779 #. type: textblock
21780 #: ../fish/guestfish.pod:94
21781 msgid "Update C</etc/resolv.conf> in a guest:"
21782 msgstr ""
21783
21784 # type: verbatim
21785 #. type: verbatim
21786 #: ../fish/guestfish.pod:96
21787 #, no-wrap
21788 msgid ""
21789 " guestfish \\\n"
21790 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
21791 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
21792 "\n"
21793 msgstr ""
21794
21795 # type: textblock
21796 #. type: textblock
21797 #: ../fish/guestfish.pod:100
21798 msgid "Edit C</boot/grub/grub.conf> interactively:"
21799 msgstr ""
21800
21801 # type: verbatim
21802 #. type: verbatim
21803 #: ../fish/guestfish.pod:102
21804 #, no-wrap
21805 msgid ""
21806 " guestfish --rw --add disk.img \\\n"
21807 "   --mount /dev/vg_guest/lv_root \\\n"
21808 "   --mount /dev/sda1:/boot \\\n"
21809 "   edit /boot/grub/grub.conf\n"
21810 "\n"
21811 msgstr ""
21812
21813 # type: =head2
21814 #. type: =head2
21815 #: ../fish/guestfish.pod:107
21816 msgid "Mount disks automatically"
21817 msgstr ""
21818
21819 # type: textblock
21820 #. type: textblock
21821 #: ../fish/guestfish.pod:109
21822 msgid ""
21823 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
21824 msgstr ""
21825
21826 # type: verbatim
21827 #. type: verbatim
21828 #: ../fish/guestfish.pod:112
21829 #, no-wrap
21830 msgid ""
21831 " guestfish --ro -a disk.img -i cat /etc/group\n"
21832 "\n"
21833 msgstr ""
21834
21835 # type: verbatim
21836 #. type: verbatim
21837 #: ../fish/guestfish.pod:114
21838 #, no-wrap
21839 msgid ""
21840 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
21841 "\n"
21842 msgstr ""
21843
21844 # type: textblock
21845 #. type: textblock
21846 #: ../fish/guestfish.pod:116
21847 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
21848 msgstr ""
21849
21850 # type: verbatim
21851 #. type: verbatim
21852 #: ../fish/guestfish.pod:118
21853 #, no-wrap
21854 msgid ""
21855 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
21856 "\n"
21857 msgstr ""
21858
21859 # type: =head2
21860 #. type: =head2
21861 #: ../fish/guestfish.pod:120
21862 msgid "As a script interpreter"
21863 msgstr ""
21864
21865 # type: textblock
21866 #. type: textblock
21867 #: ../fish/guestfish.pod:122
21868 msgid "Create a 100MB disk containing an ext2-formatted partition:"
21869 msgstr ""
21870
21871 # type: verbatim
21872 #. type: verbatim
21873 #: ../fish/guestfish.pod:124
21874 #, no-wrap
21875 msgid ""
21876 " #!/usr/bin/guestfish -f\n"
21877 " sparse test1.img 100M\n"
21878 " run\n"
21879 " part-disk /dev/sda mbr\n"
21880 " mkfs ext2 /dev/sda1\n"
21881 "\n"
21882 msgstr ""
21883
21884 # type: =head2
21885 #. type: =head2
21886 #: ../fish/guestfish.pod:130
21887 msgid "Start with a prepared disk"
21888 msgstr ""
21889
21890 # type: textblock
21891 #. type: textblock
21892 #: ../fish/guestfish.pod:132
21893 msgid ""
21894 "An alternate way to create a 100MB disk called C<test1.img> containing a "
21895 "single ext2-formatted partition:"
21896 msgstr ""
21897
21898 # type: verbatim
21899 #. type: verbatim
21900 #: ../fish/guestfish.pod:135
21901 #, no-wrap
21902 msgid ""
21903 " guestfish -N fs\n"
21904 "\n"
21905 msgstr ""
21906
21907 # type: textblock
21908 #. type: textblock
21909 #: ../fish/guestfish.pod:137
21910 msgid "To list what is available do:"
21911 msgstr ""
21912
21913 # type: verbatim
21914 #. type: verbatim
21915 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:940
21916 #, no-wrap
21917 msgid ""
21918 " guestfish -N help | less\n"
21919 "\n"
21920 msgstr ""
21921
21922 # type: =head2
21923 #. type: =head2
21924 #: ../fish/guestfish.pod:141
21925 msgid "Remote control"
21926 msgstr ""
21927
21928 # type: verbatim
21929 #. type: verbatim
21930 #: ../fish/guestfish.pod:143
21931 #, no-wrap
21932 msgid ""
21933 " eval \"`guestfish --listen`\"\n"
21934 " guestfish --remote add-ro disk.img\n"
21935 " guestfish --remote run\n"
21936 " guestfish --remote lvs\n"
21937 "\n"
21938 msgstr ""
21939
21940 # type: =head1
21941 #. type: =head1
21942 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
21943 #: ../fuse/guestmount.pod:83 ../tools/virt-win-reg.pl:96
21944 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:103
21945 #: ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
21946 msgid "OPTIONS"
21947 msgstr ""
21948
21949 # type: =item
21950 #. type: =item
21951 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:143
21952 #: ../tools/virt-win-reg.pl:104 ../tools/virt-list-filesystems.pl:61
21953 #: ../tools/virt-tar.pl:111 ../tools/virt-make-fs.pl:161
21954 #: ../tools/virt-list-partitions.pl:62
21955 msgid "B<--help>"
21956 msgstr ""
21957
21958 # type: textblock
21959 #. type: textblock
21960 #: ../fish/guestfish.pod:154
21961 msgid "Displays general help on options."
21962 msgstr ""
21963
21964 # type: =item
21965 #. type: =item
21966 #: ../fish/guestfish.pod:156
21967 msgid "B<-h>"
21968 msgstr ""
21969
21970 # type: =item
21971 #. type: =item
21972 #: ../fish/guestfish.pod:158
21973 msgid "B<--cmd-help>"
21974 msgstr ""
21975
21976 # type: textblock
21977 #. type: textblock
21978 #: ../fish/guestfish.pod:160
21979 msgid "Lists all available guestfish commands."
21980 msgstr ""
21981
21982 # type: =item
21983 #. type: =item
21984 #: ../fish/guestfish.pod:162
21985 msgid "B<-h cmd>"
21986 msgstr ""
21987
21988 # type: =item
21989 #. type: =item
21990 #: ../fish/guestfish.pod:164
21991 msgid "B<--cmd-help cmd>"
21992 msgstr ""
21993
21994 # type: textblock
21995 #. type: textblock
21996 #: ../fish/guestfish.pod:166
21997 msgid "Displays detailed help on a single command C<cmd>."
21998 msgstr ""
21999
22000 # type: =item
22001 #. type: =item
22002 #: ../fish/guestfish.pod:168
22003 msgid "B<-a image>"
22004 msgstr ""
22005
22006 # type: =item
22007 #. type: =item
22008 #: ../fish/guestfish.pod:170
22009 msgid "B<--add image>"
22010 msgstr ""
22011
22012 # type: textblock
22013 #. type: textblock
22014 #: ../fish/guestfish.pod:172
22015 msgid "Add a block device or virtual machine image to the shell."
22016 msgstr ""
22017
22018 # type: textblock
22019 #. type: textblock
22020 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:91
22021 msgid ""
22022 "The format of the disk image is auto-detected.  To override this and force a "
22023 "particular format use the I<--format=..> option."
22024 msgstr ""
22025
22026 #. type: textblock
22027 #: ../fish/guestfish.pod:177
22028 msgid ""
22029 "Using this flag is mostly equivalent to using the C<add> command, with "
22030 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
22031 "the I<--format=...> flag was given."
22032 msgstr ""
22033
22034 # type: =item
22035 #. type: =item
22036 #: ../fish/guestfish.pod:181
22037 msgid "B<-c URI>"
22038 msgstr ""
22039
22040 # type: =item
22041 #. type: =item
22042 #: ../fish/guestfish.pod:183
22043 msgid "B<--connect URI>"
22044 msgstr ""
22045
22046 # type: textblock
22047 #. type: textblock
22048 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:96
22049 msgid ""
22050 "When used in conjunction with the I<-d> option, this specifies the libvirt "
22051 "URI to use.  The default is to use the default libvirt connection."
22052 msgstr ""
22053
22054 # type: =item
22055 #. type: =item
22056 #: ../fish/guestfish.pod:189
22057 msgid "B<--csh>"
22058 msgstr ""
22059
22060 # type: textblock
22061 #. type: textblock
22062 #: ../fish/guestfish.pod:191
22063 msgid ""
22064 "If using the I<--listen> option and a csh-like shell, use this option.  See "
22065 "section L</REMOTE CONTROL AND CSH> below."
22066 msgstr ""
22067
22068 # type: =item
22069 #. type: =item
22070 #: ../fish/guestfish.pod:194
22071 msgid "B<-d libvirt-domain>"
22072 msgstr ""
22073
22074 # type: =item
22075 #. type: =item
22076 #: ../fish/guestfish.pod:196
22077 msgid "B<--domain libvirt-domain>"
22078 msgstr ""
22079
22080 # type: textblock
22081 #. type: textblock
22082 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:102
22083 msgid ""
22084 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
22085 "used, then any libvirt domain can be used.  However in write mode, only "
22086 "libvirt domains which are shut down can be named here."
22087 msgstr ""
22088
22089 #. type: textblock
22090 #: ../fish/guestfish.pod:202 ../fuse/guestmount.pod:106
22091 msgid "Domain UUIDs can be used instead of names."
22092 msgstr ""
22093
22094 # type: textblock
22095 #. type: textblock
22096 #: ../fish/guestfish.pod:204
22097 msgid ""
22098 "Using this flag is mostly equivalent to using the C<add-domain> command, "
22099 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
22100 "if the I<--format:...> flag was given."
22101 msgstr ""
22102
22103 # type: =item
22104 #. type: =item
22105 #: ../fish/guestfish.pod:208
22106 msgid "B<-D>"
22107 msgstr ""
22108
22109 # type: =item
22110 #. type: =item
22111 #: ../fish/guestfish.pod:210
22112 msgid "B<--no-dest-paths>"
22113 msgstr ""
22114
22115 # type: textblock
22116 #. type: textblock
22117 #: ../fish/guestfish.pod:212
22118 msgid ""
22119 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
22120 "to hit the tab key to complete paths on the guest filesystem, but this "
22121 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
22122 "allow this feature to be disabled."
22123 msgstr ""
22124
22125 # type: =item
22126 #. type: =item
22127 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:120
22128 msgid "B<--echo-keys>"
22129 msgstr ""
22130
22131 # type: textblock
22132 #. type: textblock
22133 #: ../fish/guestfish.pod:219 ../fuse/guestmount.pod:122
22134 msgid ""
22135 "When prompting for keys and passphrases, guestfish normally turns echoing "
22136 "off so you cannot see what you are typing.  If you are not worried about "
22137 "Tempest attacks and there is no one else in the room you can specify this "
22138 "flag to see what you are typing."
22139 msgstr ""
22140
22141 # type: =item
22142 #. type: =item
22143 #: ../fish/guestfish.pod:224
22144 msgid "B<-f file>"
22145 msgstr ""
22146
22147 # type: =item
22148 #. type: =item
22149 #: ../fish/guestfish.pod:226
22150 msgid "B<--file file>"
22151 msgstr ""
22152
22153 # type: textblock
22154 #. type: textblock
22155 #: ../fish/guestfish.pod:228
22156 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
22157 msgstr ""
22158
22159 # type: verbatim
22160 #. type: verbatim
22161 #: ../fish/guestfish.pod:231
22162 #, no-wrap
22163 msgid ""
22164 " #!/usr/bin/guestfish -f\n"
22165 "\n"
22166 msgstr ""
22167
22168 # type: =item
22169 #. type: =item
22170 #: ../fish/guestfish.pod:233
22171 msgid "B<--format=raw|qcow2|..>"
22172 msgstr ""
22173
22174 # type: =item
22175 #. type: =item
22176 #: ../fish/guestfish.pod:235
22177 msgid "B<--format>"
22178 msgstr ""
22179
22180 # type: textblock
22181 #. type: textblock
22182 #: ../fish/guestfish.pod:237 ../fuse/guestmount.pod:129
22183 msgid ""
22184 "The default for the I<-a> option is to auto-detect the format of the disk "
22185 "image.  Using this forces the disk format for I<-a> options which follow on "
22186 "the command line.  Using I<--format> with no argument switches back to auto-"
22187 "detection for subsequent I<-a> options."
22188 msgstr ""
22189
22190 # type: verbatim
22191 #. type: verbatim
22192 #: ../fish/guestfish.pod:244
22193 #, no-wrap
22194 msgid ""
22195 " guestfish --format=raw -a disk.img\n"
22196 "\n"
22197 msgstr ""
22198
22199 # type: textblock
22200 #. type: textblock
22201 #: ../fish/guestfish.pod:246
22202 msgid "forces raw format (no auto-detection) for C<disk.img>."
22203 msgstr ""
22204
22205 # type: verbatim
22206 #. type: verbatim
22207 #: ../fish/guestfish.pod:248
22208 #, no-wrap
22209 msgid ""
22210 " guestfish --format=raw -a disk.img --format -a another.img\n"
22211 "\n"
22212 msgstr ""
22213
22214 # type: textblock
22215 #. type: textblock
22216 #: ../fish/guestfish.pod:250
22217 msgid ""
22218 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
22219 "detection for C<another.img>."
22220 msgstr ""
22221
22222 # type: textblock
22223 #. type: textblock
22224 #: ../fish/guestfish.pod:253
22225 msgid ""
22226 "If you have untrusted raw-format guest disk images, you should use this "
22227 "option to specify the disk format.  This avoids a possible security problem "
22228 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
22229 msgstr ""
22230
22231 # type: =item
22232 #. type: =item
22233 #: ../fish/guestfish.pod:258
22234 msgid "B<-i>"
22235 msgstr ""
22236
22237 # type: =item
22238 #. type: =item
22239 #: ../fish/guestfish.pod:260
22240 msgid "B<--inspector>"
22241 msgstr ""
22242
22243 # type: textblock
22244 #. type: textblock
22245 #: ../fish/guestfish.pod:262 ../fuse/guestmount.pod:149
22246 msgid ""
22247 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
22248 "system and mount filesystems as they would be mounted on the real virtual "
22249 "machine."
22250 msgstr ""
22251
22252 # type: textblock
22253 #. type: textblock
22254 #: ../fish/guestfish.pod:266
22255 msgid "Typical usage is either:"
22256 msgstr ""
22257
22258 # type: verbatim
22259 #. type: verbatim
22260 #: ../fish/guestfish.pod:268
22261 #, no-wrap
22262 msgid ""
22263 " guestfish -d myguest -i\n"
22264 "\n"
22265 msgstr ""
22266
22267 # type: textblock
22268 #. type: textblock
22269 #: ../fish/guestfish.pod:270
22270 msgid "(for an inactive libvirt domain called I<myguest>), or:"
22271 msgstr ""
22272
22273 # type: verbatim
22274 #. type: verbatim
22275 #: ../fish/guestfish.pod:272
22276 #, no-wrap
22277 msgid ""
22278 " guestfish --ro -d myguest -i\n"
22279 "\n"
22280 msgstr ""
22281
22282 # type: textblock
22283 #. type: textblock
22284 #: ../fish/guestfish.pod:274
22285 msgid "(for active domains, readonly), or specify the block device directly:"
22286 msgstr ""
22287
22288 # type: verbatim
22289 #. type: verbatim
22290 #: ../fish/guestfish.pod:276
22291 #, no-wrap
22292 msgid ""
22293 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
22294 "\n"
22295 msgstr ""
22296
22297 # type: textblock
22298 #. type: textblock
22299 #: ../fish/guestfish.pod:278
22300 msgid ""
22301 "Note that the command line syntax changed slightly over older versions of "
22302 "guestfish.  You can still use the old syntax:"
22303 msgstr ""
22304
22305 # type: verbatim
22306 #. type: verbatim
22307 #: ../fish/guestfish.pod:281
22308 #, no-wrap
22309 msgid ""
22310 " guestfish [--ro] -i disk.img\n"
22311 "\n"
22312 msgstr ""
22313
22314 # type: verbatim
22315 #. type: verbatim
22316 #: ../fish/guestfish.pod:283
22317 #, no-wrap
22318 msgid ""
22319 " guestfish [--ro] -i libvirt-domain\n"
22320 "\n"
22321 msgstr ""
22322
22323 # type: textblock
22324 #. type: textblock
22325 #: ../fish/guestfish.pod:285
22326 msgid ""
22327 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
22328 "then using other commands to mount the filesystems that were found."
22329 msgstr ""
22330
22331 # type: =item
22332 #. type: =item
22333 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:153
22334 msgid "B<--keys-from-stdin>"
22335 msgstr ""
22336
22337 # type: textblock
22338 #. type: textblock
22339 #: ../fish/guestfish.pod:291 ../fuse/guestmount.pod:155
22340 msgid ""
22341 "Read key or passphrase parameters from stdin.  The default is to try to read "
22342 "passphrases from the user by opening C</dev/tty>."
22343 msgstr ""
22344
22345 # type: =item
22346 #. type: =item
22347 #: ../fish/guestfish.pod:294
22348 msgid "B<--listen>"
22349 msgstr ""
22350
22351 # type: textblock
22352 #. type: textblock
22353 #: ../fish/guestfish.pod:296
22354 msgid ""
22355 "Fork into the background and listen for remote commands.  See section L</"
22356 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
22357 msgstr ""
22358
22359 #. type: =item
22360 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:158
22361 msgid "B<--live>"
22362 msgstr ""
22363
22364 #. type: textblock
22365 #: ../fish/guestfish.pod:301 ../fuse/guestmount.pod:160
22366 msgid ""
22367 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
22368 "ATTACHING TO RUNNING DAEMONS>)."
22369 msgstr ""
22370
22371 #. type: =item
22372 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:163
22373 msgid "B<-m dev[:mountpoint[:options]]>"
22374 msgstr ""
22375
22376 #. type: =item
22377 #: ../fish/guestfish.pod:306 ../fuse/guestmount.pod:165
22378 msgid "B<--mount dev[:mountpoint[:options]]>"
22379 msgstr ""
22380
22381 # type: textblock
22382 #. type: textblock
22383 #: ../fish/guestfish.pod:308
22384 msgid "Mount the named partition or logical volume on the given mountpoint."
22385 msgstr ""
22386
22387 # type: textblock
22388 #. type: textblock
22389 #: ../fish/guestfish.pod:310
22390 msgid "If the mountpoint is omitted, it defaults to C</>."
22391 msgstr ""
22392
22393 # type: textblock
22394 #. type: textblock
22395 #: ../fish/guestfish.pod:312
22396 msgid "You have to mount something on C</> before most commands will work."
22397 msgstr ""
22398
22399 # type: textblock
22400 #. type: textblock
22401 #: ../fish/guestfish.pod:314
22402 msgid ""
22403 "If any I<-m> or I<--mount> options are given, the guest is automatically "
22404 "launched."
22405 msgstr ""
22406
22407 # type: textblock
22408 #. type: textblock
22409 #: ../fish/guestfish.pod:317
22410 msgid ""
22411 "If you don't know what filesystems a disk image contains, you can either run "
22412 "guestfish without this option, then list the partitions, filesystems and LVs "
22413 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
22414 "commands), or you can use the L<virt-filesystems(1)> program."
22415 msgstr ""
22416
22417 #. type: textblock
22418 #: ../fish/guestfish.pod:323 ../fuse/guestmount.pod:173
22419 msgid ""
22420 "The third (and rarely used) part of the mount parameter is the list of mount "
22421 "options used to mount the underlying filesystem.  If this is not given, then "
22422 "the mount options are either the empty string or C<ro> (the latter if the "
22423 "I<--ro> flag is used).  By specifying the mount options, you override this "
22424 "default choice.  Probably the only time you would use this is to enable ACLs "
22425 "and/or extended attributes if the filesystem can support them:"
22426 msgstr ""
22427
22428 #. type: verbatim
22429 #: ../fish/guestfish.pod:331 ../fuse/guestmount.pod:181
22430 #, no-wrap
22431 msgid ""
22432 " -m /dev/sda1:/:acl,user_xattr\n"
22433 "\n"
22434 msgstr ""
22435
22436 #. type: textblock
22437 #: ../fish/guestfish.pod:333
22438 msgid "Using this flag is equivalent to using the C<mount-options> command."
22439 msgstr ""
22440
22441 # type: =item
22442 #. type: =item
22443 #: ../fish/guestfish.pod:335
22444 msgid "B<-n>"
22445 msgstr ""
22446
22447 # type: =item
22448 #. type: =item
22449 #: ../fish/guestfish.pod:337
22450 msgid "B<--no-sync>"
22451 msgstr ""
22452
22453 # type: textblock
22454 #. type: textblock
22455 #: ../fish/guestfish.pod:339
22456 msgid ""
22457 "Disable autosync.  This is enabled by default.  See the discussion of "
22458 "autosync in the L<guestfs(3)> manpage."
22459 msgstr ""
22460
22461 # type: =item
22462 #. type: =item
22463 #: ../fish/guestfish.pod:342
22464 msgid "B<-N type>"
22465 msgstr ""
22466
22467 # type: =item
22468 #. type: =item
22469 #: ../fish/guestfish.pod:344
22470 msgid "B<--new type>"
22471 msgstr ""
22472
22473 # type: =item
22474 #. type: =item
22475 #: ../fish/guestfish.pod:346
22476 msgid "B<-N help>"
22477 msgstr ""
22478
22479 # type: textblock
22480 #. type: textblock
22481 #: ../fish/guestfish.pod:348
22482 msgid ""
22483 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
22484 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
22485 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
22486 "IMAGES> below."
22487 msgstr ""
22488
22489 # type: =item
22490 #. type: =item
22491 #: ../fish/guestfish.pod:353
22492 msgid "B<--progress-bars>"
22493 msgstr ""
22494
22495 # type: textblock
22496 #. type: textblock
22497 #: ../fish/guestfish.pod:355
22498 msgid "Enable progress bars, even when guestfish is used non-interactively."
22499 msgstr ""
22500
22501 # type: textblock
22502 #. type: textblock
22503 #: ../fish/guestfish.pod:357
22504 msgid ""
22505 "Progress bars are enabled by default when guestfish is used as an "
22506 "interactive shell."
22507 msgstr ""
22508
22509 # type: =item
22510 #. type: =item
22511 #: ../fish/guestfish.pod:360
22512 msgid "B<--no-progress-bars>"
22513 msgstr ""
22514
22515 # type: textblock
22516 #. type: textblock
22517 #: ../fish/guestfish.pod:362
22518 msgid "Disable progress bars."
22519 msgstr ""
22520
22521 # type: =item
22522 #. type: =item
22523 #: ../fish/guestfish.pod:364
22524 msgid "B<--remote[=pid]>"
22525 msgstr ""
22526
22527 # type: textblock
22528 #. type: textblock
22529 #: ../fish/guestfish.pod:366
22530 msgid ""
22531 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
22532 "CONTROL GUESTFISH OVER A SOCKET> below."
22533 msgstr ""
22534
22535 # type: =item
22536 #. type: =item
22537 #: ../fish/guestfish.pod:369
22538 msgid "B<-r>"
22539 msgstr ""
22540
22541 # type: =item
22542 #. type: =item
22543 #: ../fish/guestfish.pod:371
22544 msgid "B<--ro>"
22545 msgstr ""
22546
22547 # type: textblock
22548 #. type: textblock
22549 #: ../fish/guestfish.pod:373
22550 msgid ""
22551 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22552 "mounts are done read-only."
22553 msgstr ""
22554
22555 # type: textblock
22556 #. type: textblock
22557 #: ../fish/guestfish.pod:376
22558 msgid ""
22559 "The option must always be used if the disk image or virtual machine might be "
22560 "running, and is generally recommended in cases where you don't need write "
22561 "access to the disk."
22562 msgstr ""
22563
22564 # type: textblock
22565 #. type: textblock
22566 #: ../fish/guestfish.pod:380
22567 msgid ""
22568 "Note that prepared disk images created with I<-N> are not affected by this "
22569 "option.  Also commands like C<add> are not affected - you have to specify "
22570 "the C<readonly:true> option explicitly if you need it."
22571 msgstr ""
22572
22573 # type: textblock
22574 #. type: textblock
22575 #: ../fish/guestfish.pod:384
22576 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
22577 msgstr ""
22578
22579 # type: =item
22580 #. type: =item
22581 #: ../fish/guestfish.pod:386 ../fuse/guestmount.pod:237
22582 msgid "B<--selinux>"
22583 msgstr ""
22584
22585 # type: textblock
22586 #. type: textblock
22587 #: ../fish/guestfish.pod:388
22588 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
22589 msgstr ""
22590
22591 # type: =item
22592 #. type: =item
22593 #: ../fish/guestfish.pod:390
22594 msgid "B<-v>"
22595 msgstr ""
22596
22597 # type: =item
22598 #. type: =item
22599 #: ../fish/guestfish.pod:392
22600 msgid "B<--verbose>"
22601 msgstr ""
22602
22603 # type: textblock
22604 #. type: textblock
22605 #: ../fish/guestfish.pod:394
22606 msgid ""
22607 "Enable very verbose messages.  This is particularly useful if you find a bug."
22608 msgstr ""
22609
22610 # type: =item
22611 #. type: =item
22612 #: ../fish/guestfish.pod:397
22613 msgid "B<-V>"
22614 msgstr ""
22615
22616 # type: =item
22617 #. type: =item
22618 #: ../fish/guestfish.pod:399 ../tools/virt-win-reg.pl:112
22619 #: ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:119
22620 #: ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
22621 msgid "B<--version>"
22622 msgstr ""
22623
22624 # type: textblock
22625 #. type: textblock
22626 #: ../fish/guestfish.pod:401
22627 msgid "Display the guestfish / libguestfs version number and exit."
22628 msgstr ""
22629
22630 # type: =item
22631 #. type: =item
22632 #: ../fish/guestfish.pod:403
22633 msgid "B<-w>"
22634 msgstr ""
22635
22636 # type: =item
22637 #. type: =item
22638 #: ../fish/guestfish.pod:405
22639 msgid "B<--rw>"
22640 msgstr ""
22641
22642 #. type: textblock
22643 #: ../fish/guestfish.pod:407 ../fuse/guestmount.pod:251
22644 msgid ""
22645 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22646 "mounts are done read-write."
22647 msgstr ""
22648
22649 #. type: textblock
22650 #: ../fish/guestfish.pod:410
22651 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
22652 msgstr ""
22653
22654 # type: =item
22655 #. type: =item
22656 #: ../fish/guestfish.pod:412
22657 msgid "B<-x>"
22658 msgstr ""
22659
22660 # type: textblock
22661 #. type: textblock
22662 #: ../fish/guestfish.pod:414
22663 msgid "Echo each command before executing it."
22664 msgstr ""
22665
22666 # type: =head1
22667 #. type: =head1
22668 #: ../fish/guestfish.pod:418
22669 msgid "COMMANDS ON COMMAND LINE"
22670 msgstr ""
22671
22672 # type: textblock
22673 #. type: textblock
22674 #: ../fish/guestfish.pod:420
22675 msgid ""
22676 "Any additional (non-option) arguments are treated as commands to execute."
22677 msgstr ""
22678
22679 # type: textblock
22680 #. type: textblock
22681 #: ../fish/guestfish.pod:423
22682 msgid ""
22683 "Commands to execute should be separated by a colon (C<:>), where the colon "
22684 "is a separate parameter.  Thus:"
22685 msgstr ""
22686
22687 # type: verbatim
22688 #. type: verbatim
22689 #: ../fish/guestfish.pod:426
22690 #, no-wrap
22691 msgid ""
22692 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
22693 "\n"
22694 msgstr ""
22695
22696 # type: textblock
22697 #. type: textblock
22698 #: ../fish/guestfish.pod:428
22699 msgid ""
22700 "If there are no additional arguments, then we enter a shell, either an "
22701 "interactive shell with a prompt (if the input is a terminal) or a non-"
22702 "interactive shell."
22703 msgstr ""
22704
22705 # type: textblock
22706 #. type: textblock
22707 #: ../fish/guestfish.pod:432
22708 msgid ""
22709 "In either command line mode or non-interactive shell, the first command that "
22710 "gives an error causes the whole shell to exit.  In interactive mode (with a "
22711 "prompt) if a command fails, you can continue to enter commands."
22712 msgstr ""
22713
22714 # type: =head1
22715 #. type: =head1
22716 #: ../fish/guestfish.pod:437
22717 msgid "USING launch (OR run)"
22718 msgstr ""
22719
22720 # type: textblock
22721 #. type: textblock
22722 #: ../fish/guestfish.pod:439
22723 msgid ""
22724 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
22725 "then launch it, then mount any disks you need, and finally issue actions/"
22726 "commands.  So the general order of the day is:"
22727 msgstr ""
22728
22729 # type: textblock
22730 #. type: textblock
22731 #: ../fish/guestfish.pod:447
22732 msgid "add or -a/--add"
22733 msgstr ""
22734
22735 # type: textblock
22736 #. type: textblock
22737 #: ../fish/guestfish.pod:451
22738 msgid "launch (aka run)"
22739 msgstr ""
22740
22741 # type: textblock
22742 #. type: textblock
22743 #: ../fish/guestfish.pod:455
22744 msgid "mount or -m/--mount"
22745 msgstr ""
22746
22747 # type: textblock
22748 #. type: textblock
22749 #: ../fish/guestfish.pod:459
22750 msgid "any other commands"
22751 msgstr ""
22752
22753 # type: textblock
22754 #. type: textblock
22755 #: ../fish/guestfish.pod:463
22756 msgid ""
22757 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
22758 "guest before mounting or performing any other commands."
22759 msgstr ""
22760
22761 # type: textblock
22762 #. type: textblock
22763 #: ../fish/guestfish.pod:466
22764 msgid ""
22765 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
22766 "I<--new> options were given then C<run> is done automatically, simply "
22767 "because guestfish can't perform the action you asked for without doing this."
22768 msgstr ""
22769
22770 # type: =head1
22771 #. type: =head1
22772 #: ../fish/guestfish.pod:471
22773 msgid "OPENING DISKS FOR READ AND WRITE"
22774 msgstr ""
22775
22776 #. type: textblock
22777 #: ../fish/guestfish.pod:473
22778 msgid ""
22779 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
22780 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
22781 "I<-i> and I<-m> open disk images read-only or for writing."
22782 msgstr ""
22783
22784 #. type: textblock
22785 #: ../fish/guestfish.pod:478
22786 msgid ""
22787 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
22788 "opening disk images supplied on the command line for write.  To open a disk "
22789 "image read-only you have to do I<-a image --ro>."
22790 msgstr ""
22791
22792 # type: textblock
22793 #. type: textblock
22794 #: ../fish/guestfish.pod:482
22795 msgid ""
22796 "This matters: If you accidentally open a live VM disk image writable then "
22797 "you will cause irreversible disk corruption."
22798 msgstr ""
22799
22800 #. type: textblock
22801 #: ../fish/guestfish.pod:485
22802 msgid ""
22803 "By libguestfs 1.12 we intend to change the default the other way.  Disk "
22804 "images will be opened read-only.  You will have to either specify "
22805 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
22806 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
22807 "access for disk images specified by those other command line options."
22808 msgstr ""
22809
22810 #. type: textblock
22811 #: ../fish/guestfish.pod:492
22812 msgid ""
22813 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
22814 "which does nothing (it is already the default).  However it is highly "
22815 "recommended that you use this option to indicate that you need write access, "
22816 "and prepare your scripts for the day when this option will be required for "
22817 "write access."
22818 msgstr ""
22819
22820 # type: textblock
22821 #. type: textblock
22822 #: ../fish/guestfish.pod:498
22823 msgid ""
22824 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
22825 "other libguestfs program apart from guestfish and guestmount."
22826 msgstr ""
22827
22828 # type: =head1
22829 #. type: =head1
22830 #: ../fish/guestfish.pod:501
22831 msgid "QUOTING"
22832 msgstr ""
22833
22834 # type: textblock
22835 #. type: textblock
22836 #: ../fish/guestfish.pod:503
22837 msgid ""
22838 "You can quote ordinary parameters using either single or double quotes.  For "
22839 "example:"
22840 msgstr ""
22841
22842 # type: verbatim
22843 #. type: verbatim
22844 #: ../fish/guestfish.pod:506
22845 #, no-wrap
22846 msgid ""
22847 " add \"file with a space.img\"\n"
22848 "\n"
22849 msgstr ""
22850
22851 # type: verbatim
22852 #. type: verbatim
22853 #: ../fish/guestfish.pod:508
22854 #, no-wrap
22855 msgid ""
22856 " rm '/file name'\n"
22857 "\n"
22858 msgstr ""
22859
22860 # type: verbatim
22861 #. type: verbatim
22862 #: ../fish/guestfish.pod:510
22863 #, no-wrap
22864 msgid ""
22865 " rm '/\"'\n"
22866 "\n"
22867 msgstr ""
22868
22869 # type: textblock
22870 #. type: textblock
22871 #: ../fish/guestfish.pod:512
22872 msgid ""
22873 "A few commands require a list of strings to be passed.  For these, use a "
22874 "whitespace-separated list, enclosed in quotes.  Strings containing "
22875 "whitespace to be passed through must be enclosed in single quotes.  A "
22876 "literal single quote must be escaped with a backslash."
22877 msgstr ""
22878
22879 # type: verbatim
22880 #. type: verbatim
22881 #: ../fish/guestfish.pod:517
22882 #, no-wrap
22883 msgid ""
22884 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
22885 " command \"/bin/echo 'foo      bar'\"\n"
22886 " command \"/bin/echo \\'foo\\'\"\n"
22887 "\n"
22888 msgstr ""
22889
22890 # type: =head1
22891 #. type: =head1
22892 #: ../fish/guestfish.pod:521
22893 msgid "OPTIONAL ARGUMENTS"
22894 msgstr ""
22895
22896 # type: textblock
22897 #. type: textblock
22898 #: ../fish/guestfish.pod:523
22899 msgid ""
22900 "Some commands take optional arguments.  These arguments appear in this "
22901 "documentation as C<[argname:..]>.  You can use them as in these examples:"
22902 msgstr ""
22903
22904 # type: verbatim
22905 #. type: verbatim
22906 #: ../fish/guestfish.pod:527
22907 #, no-wrap
22908 msgid ""
22909 " add-drive-opts filename\n"
22910 "\n"
22911 msgstr ""
22912
22913 # type: verbatim
22914 #. type: verbatim
22915 #: ../fish/guestfish.pod:529
22916 #, no-wrap
22917 msgid ""
22918 " add-drive-opts filename readonly:true\n"
22919 "\n"
22920 msgstr ""
22921
22922 # type: verbatim
22923 #. type: verbatim
22924 #: ../fish/guestfish.pod:531
22925 #, no-wrap
22926 msgid ""
22927 " add-drive-opts filename format:qcow2 readonly:false\n"
22928 "\n"
22929 msgstr ""
22930
22931 # type: textblock
22932 #. type: textblock
22933 #: ../fish/guestfish.pod:533
22934 msgid ""
22935 "Each optional argument can appear at most once.  All optional arguments must "
22936 "appear after the required ones."
22937 msgstr ""
22938
22939 # type: =head1
22940 #. type: =head1
22941 #: ../fish/guestfish.pod:536
22942 msgid "NUMBERS"
22943 msgstr ""
22944
22945 # type: textblock
22946 #. type: textblock
22947 #: ../fish/guestfish.pod:538
22948 msgid ""
22949 "This section applies to all commands which can take integers as parameters."
22950 msgstr ""
22951
22952 # type: =head2
22953 #. type: =head2
22954 #: ../fish/guestfish.pod:541
22955 msgid "SIZE SUFFIX"
22956 msgstr ""
22957
22958 # type: textblock
22959 #. type: textblock
22960 #: ../fish/guestfish.pod:543
22961 msgid ""
22962 "When the command takes a parameter measured in bytes, you can use one of the "
22963 "following suffixes to specify kilobytes, megabytes and larger sizes:"
22964 msgstr ""
22965
22966 # type: =item
22967 #. type: =item
22968 #: ../fish/guestfish.pod:549
22969 msgid "B<k> or B<K> or B<KiB>"
22970 msgstr ""
22971
22972 # type: textblock
22973 #. type: textblock
22974 #: ../fish/guestfish.pod:551
22975 msgid "The size in kilobytes (multiplied by 1024)."
22976 msgstr ""
22977
22978 # type: =item
22979 #. type: =item
22980 #: ../fish/guestfish.pod:553
22981 msgid "B<KB>"
22982 msgstr ""
22983
22984 # type: textblock
22985 #. type: textblock
22986 #: ../fish/guestfish.pod:555
22987 msgid "The size in SI 1000 byte units."
22988 msgstr ""
22989
22990 # type: =item
22991 #. type: =item
22992 #: ../fish/guestfish.pod:557
22993 msgid "B<M> or B<MiB>"
22994 msgstr ""
22995
22996 # type: textblock
22997 #. type: textblock
22998 #: ../fish/guestfish.pod:559
22999 msgid "The size in megabytes (multiplied by 1048576)."
23000 msgstr ""
23001
23002 # type: =item
23003 #. type: =item
23004 #: ../fish/guestfish.pod:561
23005 msgid "B<MB>"
23006 msgstr ""
23007
23008 # type: textblock
23009 #. type: textblock
23010 #: ../fish/guestfish.pod:563
23011 msgid "The size in SI 1000000 byte units."
23012 msgstr ""
23013
23014 # type: =item
23015 #. type: =item
23016 #: ../fish/guestfish.pod:565
23017 msgid "B<G> or B<GiB>"
23018 msgstr ""
23019
23020 # type: textblock
23021 #. type: textblock
23022 #: ../fish/guestfish.pod:567
23023 msgid "The size in gigabytes (multiplied by 2**30)."
23024 msgstr ""
23025
23026 # type: =item
23027 #. type: =item
23028 #: ../fish/guestfish.pod:569
23029 msgid "B<GB>"
23030 msgstr ""
23031
23032 # type: textblock
23033 #. type: textblock
23034 #: ../fish/guestfish.pod:571
23035 msgid "The size in SI 10**9 byte units."
23036 msgstr ""
23037
23038 # type: =item
23039 #. type: =item
23040 #: ../fish/guestfish.pod:573
23041 msgid "B<T> or B<TiB>"
23042 msgstr ""
23043
23044 # type: textblock
23045 #. type: textblock
23046 #: ../fish/guestfish.pod:575
23047 msgid "The size in terabytes (multiplied by 2**40)."
23048 msgstr ""
23049
23050 # type: =item
23051 #. type: =item
23052 #: ../fish/guestfish.pod:577
23053 msgid "B<TB>"
23054 msgstr ""
23055
23056 # type: textblock
23057 #. type: textblock
23058 #: ../fish/guestfish.pod:579
23059 msgid "The size in SI 10**12 byte units."
23060 msgstr ""
23061
23062 # type: =item
23063 #. type: =item
23064 #: ../fish/guestfish.pod:581
23065 msgid "B<P> or B<PiB>"
23066 msgstr ""
23067
23068 # type: textblock
23069 #. type: textblock
23070 #: ../fish/guestfish.pod:583
23071 msgid "The size in petabytes (multiplied by 2**50)."
23072 msgstr ""
23073
23074 # type: =item
23075 #. type: =item
23076 #: ../fish/guestfish.pod:585
23077 msgid "B<PB>"
23078 msgstr ""
23079
23080 # type: textblock
23081 #. type: textblock
23082 #: ../fish/guestfish.pod:587
23083 msgid "The size in SI 10**15 byte units."
23084 msgstr ""
23085
23086 # type: =item
23087 #. type: =item
23088 #: ../fish/guestfish.pod:589
23089 msgid "B<E> or B<EiB>"
23090 msgstr ""
23091
23092 # type: textblock
23093 #. type: textblock
23094 #: ../fish/guestfish.pod:591
23095 msgid "The size in exabytes (multiplied by 2**60)."
23096 msgstr ""
23097
23098 # type: =item
23099 #. type: =item
23100 #: ../fish/guestfish.pod:593
23101 msgid "B<EB>"
23102 msgstr ""
23103
23104 # type: textblock
23105 #. type: textblock
23106 #: ../fish/guestfish.pod:595
23107 msgid "The size in SI 10**18 byte units."
23108 msgstr ""
23109
23110 # type: =item
23111 #. type: =item
23112 #: ../fish/guestfish.pod:597
23113 msgid "B<Z> or B<ZiB>"
23114 msgstr ""
23115
23116 # type: textblock
23117 #. type: textblock
23118 #: ../fish/guestfish.pod:599
23119 msgid "The size in zettabytes (multiplied by 2**70)."
23120 msgstr ""
23121
23122 # type: =item
23123 #. type: =item
23124 #: ../fish/guestfish.pod:601
23125 msgid "B<ZB>"
23126 msgstr ""
23127
23128 # type: textblock
23129 #. type: textblock
23130 #: ../fish/guestfish.pod:603
23131 msgid "The size in SI 10**21 byte units."
23132 msgstr ""
23133
23134 # type: =item
23135 #. type: =item
23136 #: ../fish/guestfish.pod:605
23137 msgid "B<Y> or B<YiB>"
23138 msgstr ""
23139
23140 # type: textblock
23141 #. type: textblock
23142 #: ../fish/guestfish.pod:607
23143 msgid "The size in yottabytes (multiplied by 2**80)."
23144 msgstr ""
23145
23146 # type: =item
23147 #. type: =item
23148 #: ../fish/guestfish.pod:609
23149 msgid "B<YB>"
23150 msgstr ""
23151
23152 # type: textblock
23153 #. type: textblock
23154 #: ../fish/guestfish.pod:611
23155 msgid "The size in SI 10**24 byte units."
23156 msgstr ""
23157
23158 # type: verbatim
23159 #. type: verbatim
23160 #: ../fish/guestfish.pod:617
23161 #, no-wrap
23162 msgid ""
23163 " truncate-size /file 1G\n"
23164 "\n"
23165 msgstr ""
23166
23167 # type: textblock
23168 #. type: textblock
23169 #: ../fish/guestfish.pod:619
23170 msgid "would truncate the file to 1 gigabyte."
23171 msgstr ""
23172
23173 # type: textblock
23174 #. type: textblock
23175 #: ../fish/guestfish.pod:621
23176 msgid ""
23177 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
23178 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
23179 "suffix will probably not do what you expect."
23180 msgstr ""
23181
23182 # type: =head2
23183 #. type: =head2
23184 #: ../fish/guestfish.pod:625
23185 msgid "OCTAL AND HEXADECIMAL NUMBERS"
23186 msgstr ""
23187
23188 # type: textblock
23189 #. type: textblock
23190 #: ../fish/guestfish.pod:627
23191 msgid ""
23192 "For specifying the radix (base) use the C convention: C<0> to prefix an "
23193 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
23194 msgstr ""
23195
23196 # type: verbatim
23197 #. type: verbatim
23198 #: ../fish/guestfish.pod:630
23199 #, no-wrap
23200 msgid ""
23201 " 1234      decimal number 1234\n"
23202 " 02322     octal number, equivalent to decimal 1234\n"
23203 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
23204 "\n"
23205 msgstr ""
23206
23207 # type: textblock
23208 #. type: textblock
23209 #: ../fish/guestfish.pod:634
23210 msgid ""
23211 "When using the C<chmod> command, you almost always want to specify an octal "
23212 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
23213 "L<chmod(1)> program):"
23214 msgstr ""
23215
23216 # type: verbatim
23217 #. type: verbatim
23218 #: ../fish/guestfish.pod:638
23219 #, no-wrap
23220 msgid ""
23221 " chmod 0777 /public  # OK\n"
23222 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
23223 "\n"
23224 msgstr ""
23225
23226 # type: textblock
23227 #. type: textblock
23228 #: ../fish/guestfish.pod:641
23229 msgid ""
23230 "Commands that return numbers usually print them in decimal, but some "
23231 "commands print numbers in other radices (eg. C<umask> prints the mode in "
23232 "octal, preceeded by C<0>)."
23233 msgstr ""
23234
23235 # type: =head1
23236 #. type: =head1
23237 #: ../fish/guestfish.pod:645
23238 msgid "WILDCARDS AND GLOBBING"
23239 msgstr ""
23240
23241 # type: textblock
23242 #. type: textblock
23243 #: ../fish/guestfish.pod:647
23244 msgid ""
23245 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
23246 "(globbing) by default.  So for example the following will not do what you "
23247 "expect:"
23248 msgstr ""
23249
23250 # type: verbatim
23251 #. type: verbatim
23252 #: ../fish/guestfish.pod:651
23253 #, no-wrap
23254 msgid ""
23255 " rm-rf /home/*\n"
23256 "\n"
23257 msgstr ""
23258
23259 # type: textblock
23260 #. type: textblock
23261 #: ../fish/guestfish.pod:653
23262 msgid ""
23263 "Assuming you don't have a directory called literally C</home/*> then the "
23264 "above command will return an error."
23265 msgstr ""
23266
23267 # type: textblock
23268 #. type: textblock
23269 #: ../fish/guestfish.pod:656
23270 msgid "To perform wildcard expansion, use the C<glob> command."
23271 msgstr ""
23272
23273 # type: verbatim
23274 #. type: verbatim
23275 #: ../fish/guestfish.pod:658
23276 #, no-wrap
23277 msgid ""
23278 " glob rm-rf /home/*\n"
23279 "\n"
23280 msgstr ""
23281
23282 # type: textblock
23283 #. type: textblock
23284 #: ../fish/guestfish.pod:660
23285 msgid ""
23286 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
23287 "many times), equivalent to:"
23288 msgstr ""
23289
23290 # type: verbatim
23291 #. type: verbatim
23292 #: ../fish/guestfish.pod:663
23293 #, no-wrap
23294 msgid ""
23295 " rm-rf /home/jim\n"
23296 " rm-rf /home/joe\n"
23297 " rm-rf /home/mary\n"
23298 "\n"
23299 msgstr ""
23300
23301 # type: textblock
23302 #. type: textblock
23303 #: ../fish/guestfish.pod:667
23304 msgid "C<glob> only works on simple guest paths and not on device names."
23305 msgstr ""
23306
23307 # type: textblock
23308 #. type: textblock
23309 #: ../fish/guestfish.pod:669
23310 msgid ""
23311 "If you have several parameters, each containing a wildcard, then glob will "
23312 "perform a Cartesian product."
23313 msgstr ""
23314
23315 # type: =head1
23316 #. type: =head1
23317 #: ../fish/guestfish.pod:672
23318 msgid "COMMENTS"
23319 msgstr ""
23320
23321 # type: textblock
23322 #. type: textblock
23323 #: ../fish/guestfish.pod:674
23324 msgid ""
23325 "Any line which starts with a I<#> character is treated as a comment and "
23326 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
23327 "a command.  For example:"
23328 msgstr ""
23329
23330 # type: verbatim
23331 #. type: verbatim
23332 #: ../fish/guestfish.pod:678
23333 #, no-wrap
23334 msgid ""
23335 " # this is a comment\n"
23336 "         # this is a comment\n"
23337 " foo # NOT a comment\n"
23338 "\n"
23339 msgstr ""
23340
23341 # type: textblock
23342 #. type: textblock
23343 #: ../fish/guestfish.pod:682
23344 msgid "Blank lines are also ignored."
23345 msgstr ""
23346
23347 # type: =head1
23348 #. type: =head1
23349 #: ../fish/guestfish.pod:684
23350 msgid "RUNNING COMMANDS LOCALLY"
23351 msgstr ""
23352
23353 # type: textblock
23354 #. type: textblock
23355 #: ../fish/guestfish.pod:686
23356 msgid ""
23357 "Any line which starts with a I<!> character is treated as a command sent to "
23358 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
23359 msgstr ""
23360
23361 # type: verbatim
23362 #. type: verbatim
23363 #: ../fish/guestfish.pod:690
23364 #, no-wrap
23365 msgid ""
23366 " !mkdir local\n"
23367 " tgz-out /remote local/remote-data.tar.gz\n"
23368 "\n"
23369 msgstr ""
23370
23371 # type: textblock
23372 #. type: textblock
23373 #: ../fish/guestfish.pod:693
23374 msgid ""
23375 "will create a directory C<local> on the host, and then export the contents "
23376 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
23377 "(See C<tgz-out>)."
23378 msgstr ""
23379
23380 # type: textblock
23381 #. type: textblock
23382 #: ../fish/guestfish.pod:697
23383 msgid ""
23384 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
23385 "effect, due to the way that subprocesses work in Unix."
23386 msgstr ""
23387
23388 #. type: =head2
23389 #: ../fish/guestfish.pod:700
23390 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
23391 msgstr ""
23392
23393 #. type: textblock
23394 #: ../fish/guestfish.pod:702
23395 msgid ""
23396 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
23397 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
23398 "and executed as guestfish commands."
23399 msgstr ""
23400
23401 #. type: textblock
23402 #: ../fish/guestfish.pod:706
23403 msgid ""
23404 "Thus you can use shell script to construct arbitrary guestfish commands "
23405 "which are then parsed by guestfish."
23406 msgstr ""
23407
23408 #. type: textblock
23409 #: ../fish/guestfish.pod:709
23410 msgid ""
23411 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
23412 "through C</foo.100>) using guestfish commands alone.  However this is simple "
23413 "if we use a shell script to create the guestfish commands for us:"
23414 msgstr ""
23415
23416 #. type: verbatim
23417 #: ../fish/guestfish.pod:714
23418 #, no-wrap
23419 msgid ""
23420 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
23421 "\n"
23422 msgstr ""
23423
23424 #. type: textblock
23425 #: ../fish/guestfish.pod:716
23426 msgid "or with names like C</foo.001>:"
23427 msgstr ""
23428
23429 #. type: verbatim
23430 #: ../fish/guestfish.pod:718
23431 #, no-wrap
23432 msgid ""
23433 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
23434 "\n"
23435 msgstr ""
23436
23437 #. type: textblock
23438 #: ../fish/guestfish.pod:720
23439 msgid ""
23440 "When using guestfish interactively it can be helpful to just run the shell "
23441 "script first (ie. remove the initial C<E<lt>> character so it is just an "
23442 "ordinary I<!> local command), see what guestfish commands it would run, and "
23443 "when you are happy with those prepend the C<E<lt>> character to run the "
23444 "guestfish commands for real."
23445 msgstr ""
23446
23447 # type: =head1
23448 #. type: =head1
23449 #: ../fish/guestfish.pod:726
23450 msgid "PIPES"
23451 msgstr ""
23452
23453 # type: textblock
23454 #. type: textblock
23455 #: ../fish/guestfish.pod:728
23456 msgid ""
23457 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
23458 "command (a guestfish command) to the second command (any host command).  For "
23459 "example:"
23460 msgstr ""
23461
23462 # type: verbatim
23463 #. type: verbatim
23464 #: ../fish/guestfish.pod:732
23465 #, no-wrap
23466 msgid ""
23467 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
23468 "\n"
23469 msgstr ""
23470
23471 # type: textblock
23472 #. type: textblock
23473 #: ../fish/guestfish.pod:734
23474 msgid ""
23475 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
23476 "program).  The above command would list all accounts in the guest filesystem "
23477 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
23478 msgstr ""
23479
23480 # type: verbatim
23481 #. type: verbatim
23482 #: ../fish/guestfish.pod:739
23483 #, no-wrap
23484 msgid ""
23485 " hexdump /bin/ls | head\n"
23486 " list-devices | tail -1\n"
23487 " tgz-out / - | tar ztf -\n"
23488 "\n"
23489 msgstr ""
23490
23491 # type: textblock
23492 #. type: textblock
23493 #: ../fish/guestfish.pod:743
23494 msgid ""
23495 "The space before the pipe symbol is required, any space after the pipe "
23496 "symbol is optional.  Everything after the pipe symbol is just passed "
23497 "straight to the host shell, so it can contain redirections, globs and "
23498 "anything else that makes sense on the host side."
23499 msgstr ""
23500
23501 # type: textblock
23502 #. type: textblock
23503 #: ../fish/guestfish.pod:748
23504 msgid ""
23505 "To use a literal argument which begins with a pipe symbol, you have to quote "
23506 "it, eg:"
23507 msgstr ""
23508
23509 # type: verbatim
23510 #. type: verbatim
23511 #: ../fish/guestfish.pod:751
23512 #, no-wrap
23513 msgid ""
23514 " echo \"|\"\n"
23515 "\n"
23516 msgstr ""
23517
23518 # type: =head1
23519 #. type: =head1
23520 #: ../fish/guestfish.pod:753
23521 msgid "HOME DIRECTORIES"
23522 msgstr ""
23523
23524 # type: textblock
23525 #. type: textblock
23526 #: ../fish/guestfish.pod:755
23527 msgid ""
23528 "If a parameter starts with the character C<~> then the tilde may be expanded "
23529 "as a home directory path (either C<~> for the current user's home directory, "
23530 "or C<~user> for another user)."
23531 msgstr ""
23532
23533 # type: textblock
23534 #. type: textblock
23535 #: ../fish/guestfish.pod:759
23536 msgid ""
23537 "Note that home directory expansion happens for users known I<on the host>, "
23538 "not in the guest filesystem."
23539 msgstr ""
23540
23541 # type: textblock
23542 #. type: textblock
23543 #: ../fish/guestfish.pod:762
23544 msgid ""
23545 "To use a literal argument which begins with a tilde, you have to quote it, "
23546 "eg:"
23547 msgstr ""
23548
23549 # type: verbatim
23550 #. type: verbatim
23551 #: ../fish/guestfish.pod:765
23552 #, no-wrap
23553 msgid ""
23554 " echo \"~\"\n"
23555 "\n"
23556 msgstr ""
23557
23558 # type: textblock
23559 #. type: textblock
23560 #: ../fish/guestfish.pod:769
23561 msgid ""
23562 "Libguestfs has some support for Linux guests encrypted according to the "
23563 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
23564 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
23565 "LUKS is supported."
23566 msgstr ""
23567
23568 # type: textblock
23569 #. type: textblock
23570 #: ../fish/guestfish.pod:774
23571 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
23572 msgstr ""
23573
23574 # type: verbatim
23575 #. type: verbatim
23576 #: ../fish/guestfish.pod:776
23577 #, no-wrap
23578 msgid ""
23579 " ><fs> vfs-type /dev/sda2\n"
23580 " crypto_LUKS\n"
23581 "\n"
23582 msgstr ""
23583
23584 # type: textblock
23585 #. type: textblock
23586 #: ../fish/guestfish.pod:779
23587 msgid ""
23588 "Then open those devices using L</luks-open>.  This creates a device-mapper "
23589 "device called C</dev/mapper/luksdev>."
23590 msgstr ""
23591
23592 # type: verbatim
23593 #. type: verbatim
23594 #: ../fish/guestfish.pod:782
23595 #, no-wrap
23596 msgid ""
23597 " ><fs> luks-open /dev/sda2 luksdev\n"
23598 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
23599 "\n"
23600 msgstr ""
23601
23602 # type: textblock
23603 #. type: textblock
23604 #: ../fish/guestfish.pod:785
23605 msgid ""
23606 "Finally you have to tell LVM to scan for volume groups on the newly created "
23607 "mapper device:"
23608 msgstr ""
23609
23610 # type: verbatim
23611 #. type: verbatim
23612 #: ../fish/guestfish.pod:788
23613 #, no-wrap
23614 msgid ""
23615 " vgscan\n"
23616 " vg-activate-all true\n"
23617 "\n"
23618 msgstr ""
23619
23620 # type: textblock
23621 #. type: textblock
23622 #: ../fish/guestfish.pod:791
23623 msgid "The logical volume(s) can now be mounted in the usual way."
23624 msgstr ""
23625
23626 # type: textblock
23627 #. type: textblock
23628 #: ../fish/guestfish.pod:793
23629 msgid ""
23630 "Before closing a LUKS device you must unmount any logical volumes on it and "
23631 "deactivate the volume groups by calling C<vg-activate false VG> on each "
23632 "one.  Then you can close the mapper device:"
23633 msgstr ""
23634
23635 # type: verbatim
23636 #. type: verbatim
23637 #: ../fish/guestfish.pod:797
23638 #, no-wrap
23639 msgid ""
23640 " vg-activate false /dev/VG\n"
23641 " luks-close /dev/mapper/luksdev\n"
23642 "\n"
23643 msgstr ""
23644
23645 # type: =head1
23646 #. type: =head1
23647 #: ../fish/guestfish.pod:800
23648 msgid "WINDOWS PATHS"
23649 msgstr ""
23650
23651 #. type: textblock
23652 #: ../fish/guestfish.pod:802
23653 msgid ""
23654 "If a path is prefixed with C<win:> then you can use Windows-style drive "
23655 "letters and paths (with some limitations).  The following commands are "
23656 "equivalent:"
23657 msgstr ""
23658
23659 # type: verbatim
23660 #. type: verbatim
23661 #: ../fish/guestfish.pod:806
23662 #, no-wrap
23663 msgid ""
23664 " file /WINDOWS/system32/config/system.LOG\n"
23665 "\n"
23666 msgstr ""
23667
23668 # type: verbatim
23669 #. type: verbatim
23670 #: ../fish/guestfish.pod:808
23671 #, no-wrap
23672 msgid ""
23673 " file win:\\windows\\system32\\config\\system.log\n"
23674 "\n"
23675 msgstr ""
23676
23677 #. type: verbatim
23678 #: ../fish/guestfish.pod:810
23679 #, no-wrap
23680 msgid ""
23681 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
23682 "\n"
23683 msgstr ""
23684
23685 #. type: textblock
23686 #: ../fish/guestfish.pod:812
23687 msgid ""
23688 "The parameter is rewritten \"behind the scenes\" by looking up the position "
23689 "where the drive is mounted, prepending that to the path, changing all "
23690 "backslash characters to forward slash, then resolving the result using L</"
23691 "case-sensitive-path>.  For example if the E: drive was mounted on C</e> then "
23692 "the parameter might be rewritten like this:"
23693 msgstr ""
23694
23695 #. type: verbatim
23696 #: ../fish/guestfish.pod:818
23697 #, no-wrap
23698 msgid ""
23699 " win:e:\\foo\\bar => /e/FOO/bar\n"
23700 "\n"
23701 msgstr ""
23702
23703 #. type: textblock
23704 #: ../fish/guestfish.pod:820
23705 msgid "This only works in argument positions that expect a path."
23706 msgstr ""
23707
23708 # type: =head1
23709 #. type: =head1
23710 #: ../fish/guestfish.pod:822
23711 msgid "UPLOADING AND DOWNLOADING FILES"
23712 msgstr ""
23713
23714 # type: textblock
23715 #. type: textblock
23716 #: ../fish/guestfish.pod:824
23717 msgid ""
23718 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
23719 "others which upload from or download to a local file, you can use the "
23720 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
23721 msgstr ""
23722
23723 # type: verbatim
23724 #. type: verbatim
23725 #: ../fish/guestfish.pod:828
23726 #, no-wrap
23727 msgid ""
23728 " upload - /foo\n"
23729 "\n"
23730 msgstr ""
23731
23732 # type: textblock
23733 #. type: textblock
23734 #: ../fish/guestfish.pod:830
23735 msgid ""
23736 "reads stdin and creates from that a file C</foo> in the disk image, and:"
23737 msgstr ""
23738
23739 # type: verbatim
23740 #. type: verbatim
23741 #: ../fish/guestfish.pod:833
23742 #, no-wrap
23743 msgid ""
23744 " tar-out /etc - | tar tf -\n"
23745 "\n"
23746 msgstr ""
23747
23748 # type: textblock
23749 #. type: textblock
23750 #: ../fish/guestfish.pod:835
23751 msgid ""
23752 "writes the tarball to stdout and then pipes that into the external \"tar\" "
23753 "command (see L</PIPES>)."
23754 msgstr ""
23755
23756 # type: textblock
23757 #. type: textblock
23758 #: ../fish/guestfish.pod:838
23759 msgid ""
23760 "When using C<-> to read from stdin, the input is read up to the end of "
23761 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
23762 "some arbitrary end marker:"
23763 msgstr ""
23764
23765 # type: verbatim
23766 #. type: verbatim
23767 #: ../fish/guestfish.pod:842
23768 #, no-wrap
23769 msgid ""
23770 " upload -<<END /foo\n"
23771 " input line 1\n"
23772 " input line 2\n"
23773 " input line 3\n"
23774 " END\n"
23775 "\n"
23776 msgstr ""
23777
23778 # type: textblock
23779 #. type: textblock
23780 #: ../fish/guestfish.pod:848
23781 msgid ""
23782 "Any string of characters can be used instead of C<END>.  The end marker must "
23783 "appear on a line of its own, without any preceeding or following characters "
23784 "(not even spaces)."
23785 msgstr ""
23786
23787 # type: textblock
23788 #. type: textblock
23789 #: ../fish/guestfish.pod:852
23790 msgid ""
23791 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
23792 "upload local files (so-called \"FileIn\" parameters in the generator)."
23793 msgstr ""
23794
23795 # type: =head1
23796 #. type: =head1
23797 #: ../fish/guestfish.pod:855
23798 msgid "EXIT ON ERROR BEHAVIOUR"
23799 msgstr ""
23800
23801 # type: textblock
23802 #. type: textblock
23803 #: ../fish/guestfish.pod:857
23804 msgid ""
23805 "By default, guestfish will ignore any errors when in interactive mode (ie. "
23806 "taking commands from a human over a tty), and will exit on the first error "
23807 "in non-interactive mode (scripts, commands given on the command line)."
23808 msgstr ""
23809
23810 # type: textblock
23811 #. type: textblock
23812 #: ../fish/guestfish.pod:862
23813 msgid ""
23814 "If you prefix a command with a I<-> character, then that command will not "
23815 "cause guestfish to exit, even if that (one) command returns an error."
23816 msgstr ""
23817
23818 # type: =head1
23819 #. type: =head1
23820 #: ../fish/guestfish.pod:866
23821 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
23822 msgstr ""
23823
23824 # type: textblock
23825 #. type: textblock
23826 #: ../fish/guestfish.pod:868
23827 msgid ""
23828 "Guestfish can be remote-controlled over a socket.  This is useful "
23829 "particularly in shell scripts where you want to make several different "
23830 "changes to a filesystem, but you don't want the overhead of starting up a "
23831 "guestfish process each time."
23832 msgstr ""
23833
23834 # type: textblock
23835 #. type: textblock
23836 #: ../fish/guestfish.pod:873
23837 msgid "Start a guestfish server process using:"
23838 msgstr ""
23839
23840 # type: verbatim
23841 #. type: verbatim
23842 #: ../fish/guestfish.pod:875
23843 #, no-wrap
23844 msgid ""
23845 " eval \"`guestfish --listen`\"\n"
23846 "\n"
23847 msgstr ""
23848
23849 # type: textblock
23850 #. type: textblock
23851 #: ../fish/guestfish.pod:877
23852 msgid "and then send it commands by doing:"
23853 msgstr ""
23854
23855 # type: verbatim
23856 #. type: verbatim
23857 #: ../fish/guestfish.pod:879
23858 #, no-wrap
23859 msgid ""
23860 " guestfish --remote cmd [...]\n"
23861 "\n"
23862 msgstr ""
23863
23864 # type: textblock
23865 #. type: textblock
23866 #: ../fish/guestfish.pod:881
23867 msgid "To cause the server to exit, send it the exit command:"
23868 msgstr ""
23869
23870 # type: verbatim
23871 #. type: verbatim
23872 #: ../fish/guestfish.pod:883
23873 #, no-wrap
23874 msgid ""
23875 " guestfish --remote exit\n"
23876 "\n"
23877 msgstr ""
23878
23879 # type: textblock
23880 #. type: textblock
23881 #: ../fish/guestfish.pod:885
23882 msgid ""
23883 "Note that the server will normally exit if there is an error in a command.  "
23884 "You can change this in the usual way.  See section L</EXIT ON ERROR "
23885 "BEHAVIOUR>."
23886 msgstr ""
23887
23888 # type: =head2
23889 #. type: =head2
23890 #: ../fish/guestfish.pod:889
23891 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
23892 msgstr ""
23893
23894 # type: textblock
23895 #. type: textblock
23896 #: ../fish/guestfish.pod:891
23897 msgid ""
23898 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
23899 "is how the I<--remote> option knows where to send the commands.  You can "
23900 "have several guestfish listener processes running using:"
23901 msgstr ""
23902
23903 # type: verbatim
23904 #. type: verbatim
23905 #: ../fish/guestfish.pod:895
23906 #, no-wrap
23907 msgid ""
23908 " eval \"`guestfish --listen`\"\n"
23909 " pid1=$GUESTFISH_PID\n"
23910 " eval \"`guestfish --listen`\"\n"
23911 " pid2=$GUESTFISH_PID\n"
23912 " ...\n"
23913 " guestfish --remote=$pid1 cmd\n"
23914 " guestfish --remote=$pid2 cmd\n"
23915 "\n"
23916 msgstr ""
23917
23918 # type: =head2
23919 #. type: =head2
23920 #: ../fish/guestfish.pod:903
23921 msgid "REMOTE CONTROL AND CSH"
23922 msgstr ""
23923
23924 # type: textblock
23925 #. type: textblock
23926 #: ../fish/guestfish.pod:905
23927 msgid ""
23928 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
23929 "option:"
23930 msgstr ""
23931
23932 # type: verbatim
23933 #. type: verbatim
23934 #: ../fish/guestfish.pod:908
23935 #, no-wrap
23936 msgid ""
23937 " eval \"`guestfish --listen --csh`\"\n"
23938 "\n"
23939 msgstr ""
23940
23941 # type: =head2
23942 #. type: =head2
23943 #: ../fish/guestfish.pod:910
23944 msgid "REMOTE CONTROL DETAILS"
23945 msgstr ""
23946
23947 # type: textblock
23948 #. type: textblock
23949 #: ../fish/guestfish.pod:912
23950 msgid ""
23951 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
23952 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
23953 "and C<$PID> is the process ID of the server."
23954 msgstr ""
23955
23956 # type: textblock
23957 #. type: textblock
23958 #: ../fish/guestfish.pod:916
23959 msgid "Guestfish client and server versions must match exactly."
23960 msgstr ""
23961
23962 # type: =head1
23963 #. type: =head1
23964 #: ../fish/guestfish.pod:918
23965 msgid "PREPARED DISK IMAGES"
23966 msgstr ""
23967
23968 # type: textblock
23969 #. type: textblock
23970 #: ../fish/guestfish.pod:920
23971 msgid ""
23972 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
23973 "preformatted disk images that guestfish can make for you to save typing.  "
23974 "This is particularly useful for testing purposes.  This option is used "
23975 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
23976 "can be mixed with I<-a>)."
23977 msgstr ""
23978
23979 # type: textblock
23980 #. type: textblock
23981 #: ../fish/guestfish.pod:926
23982 msgid ""
23983 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
23984 "the second and so on.  Existing files in the current directory are "
23985 "I<overwritten>."
23986 msgstr ""
23987
23988 # type: textblock
23989 #. type: textblock
23990 #: ../fish/guestfish.pod:930
23991 msgid ""
23992 "The type briefly describes how the disk should be sized, partitioned, how "
23993 "filesystem(s) should be created, and how content should be added.  "
23994 "Optionally the type can be followed by extra parameters, separated by C<:> "
23995 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
23996 "allocated disk, containing a single partition, with the partition formatted "
23997 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
23998 "disk instead."
23999 msgstr ""
24000
24001 # type: textblock
24002 #. type: textblock
24003 #: ../fish/guestfish.pod:938
24004 msgid "To list the available types and any extra parameters they take, run:"
24005 msgstr ""
24006
24007 # type: textblock
24008 #. type: textblock
24009 #: ../fish/guestfish.pod:942
24010 msgid ""
24011 "Note that the prepared filesystem is not mounted.  You would usually have to "
24012 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
24013 msgstr ""
24014
24015 # type: textblock
24016 #. type: textblock
24017 #: ../fish/guestfish.pod:946
24018 msgid ""
24019 "If any I<-N> or I<--new> options are given, the guest is automatically "
24020 "launched."
24021 msgstr ""
24022
24023 # type: textblock
24024 #. type: textblock
24025 #: ../fish/guestfish.pod:951
24026 msgid "Create a 100MB disk with an ext4-formatted partition:"
24027 msgstr ""
24028
24029 # type: verbatim
24030 #. type: verbatim
24031 #: ../fish/guestfish.pod:953
24032 #, no-wrap
24033 msgid ""
24034 " guestfish -N fs:ext4\n"
24035 "\n"
24036 msgstr ""
24037
24038 # type: textblock
24039 #. type: textblock
24040 #: ../fish/guestfish.pod:955
24041 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
24042 msgstr ""
24043
24044 # type: verbatim
24045 #. type: verbatim
24046 #: ../fish/guestfish.pod:957
24047 #, no-wrap
24048 msgid ""
24049 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
24050 "\n"
24051 msgstr ""
24052
24053 # type: textblock
24054 #. type: textblock
24055 #: ../fish/guestfish.pod:959
24056 msgid "Create a blank 200MB disk:"
24057 msgstr ""
24058
24059 # type: verbatim
24060 #. type: verbatim
24061 #: ../fish/guestfish.pod:961
24062 #, no-wrap
24063 msgid ""
24064 " guestfish -N disk:200M\n"
24065 "\n"
24066 msgstr ""
24067
24068 # type: =head1
24069 #. type: =head1
24070 #: ../fish/guestfish.pod:963
24071 msgid "PROGRESS BARS"
24072 msgstr ""
24073
24074 # type: textblock
24075 #. type: textblock
24076 #: ../fish/guestfish.pod:965
24077 msgid ""
24078 "Some (not all) long-running commands send progress notification messages as "
24079 "they are running.  Guestfish turns these messages into progress bars."
24080 msgstr ""
24081
24082 # type: textblock
24083 #. type: textblock
24084 #: ../fish/guestfish.pod:969
24085 msgid ""
24086 "When a command that supports progress bars takes longer than two seconds to "
24087 "run, and if progress bars are enabled, then you will see one appearing below "
24088 "the command:"
24089 msgstr ""
24090
24091 # type: verbatim
24092 #. type: verbatim
24093 #: ../fish/guestfish.pod:973
24094 #, no-wrap
24095 msgid ""
24096 " ><fs> copy-size /large-file /another-file 2048M\n"
24097 " / 10% [#####-----------------------------------------] 00:30\n"
24098 "\n"
24099 msgstr ""
24100
24101 # type: textblock
24102 #. type: textblock
24103 #: ../fish/guestfish.pod:976
24104 msgid ""
24105 "The spinner on the left hand side moves round once for every progress "
24106 "notification received from the backend.  This is a (reasonably) golden "
24107 "assurance that the command is \"doing something\" even if the progress bar "
24108 "is not moving, because the command is able to send the progress "
24109 "notifications.  When the bar reaches 100% and the command finishes, the "
24110 "spinner disappears."
24111 msgstr ""
24112
24113 # type: textblock
24114 #. type: textblock
24115 #: ../fish/guestfish.pod:983
24116 msgid ""
24117 "Progress bars are enabled by default when guestfish is used interactively.  "
24118 "You can enable them even for non-interactive modes using I<--progress-bars>, "
24119 "and you can disable them completely using I<--no-progress-bars>."
24120 msgstr ""
24121
24122 # type: =head1
24123 #. type: =head1
24124 #: ../fish/guestfish.pod:988
24125 msgid "GUESTFISH COMMANDS"
24126 msgstr ""
24127
24128 # type: textblock
24129 #. type: textblock
24130 #: ../fish/guestfish.pod:990
24131 msgid ""
24132 "The commands in this section are guestfish convenience commands, in other "
24133 "words, they are not part of the L<guestfs(3)> API."
24134 msgstr ""
24135
24136 # type: =head2
24137 #. type: =head2
24138 #: ../fish/guestfish.pod:993
24139 msgid "help"
24140 msgstr ""
24141
24142 # type: verbatim
24143 #. type: verbatim
24144 #: ../fish/guestfish.pod:995
24145 #, no-wrap
24146 msgid ""
24147 " help\n"
24148 " help cmd\n"
24149 "\n"
24150 msgstr ""
24151
24152 # type: textblock
24153 #. type: textblock
24154 #: ../fish/guestfish.pod:998
24155 msgid "Without any parameter, this provides general help."
24156 msgstr ""
24157
24158 # type: textblock
24159 #. type: textblock
24160 #: ../fish/guestfish.pod:1000
24161 msgid "With a C<cmd> parameter, this displays detailed help for that command."
24162 msgstr ""
24163
24164 # type: =head2
24165 #. type: =head2
24166 #: ../fish/guestfish.pod:1002
24167 msgid "quit | exit"
24168 msgstr ""
24169
24170 # type: textblock
24171 #. type: textblock
24172 #: ../fish/guestfish.pod:1004
24173 msgid "This exits guestfish.  You can also use C<^D> key."
24174 msgstr ""
24175
24176 # type: textblock
24177 #. type: textblock
24178 #: ../fish/guestfish.pod:1006
24179 msgid "@FISH_COMMANDS@"
24180 msgstr ""
24181
24182 # type: =head1
24183 #. type: =head1
24184 #: ../fish/guestfish.pod:1008
24185 msgid "COMMANDS"
24186 msgstr ""
24187
24188 # type: =head1
24189 #. type: =head1
24190 #: ../fish/guestfish.pod:1012 ../test-tool/libguestfs-test-tool.pod:77
24191 msgid "EXIT CODE"
24192 msgstr ""
24193
24194 # type: textblock
24195 #. type: textblock
24196 #: ../fish/guestfish.pod:1014
24197 msgid ""
24198 "guestfish returns 0 if the commands completed without error, or 1 if there "
24199 "was an error."
24200 msgstr ""
24201
24202 # type: =item
24203 #. type: =item
24204 #: ../fish/guestfish.pod:1021
24205 msgid "EDITOR"
24206 msgstr ""
24207
24208 # type: textblock
24209 #. type: textblock
24210 #: ../fish/guestfish.pod:1023
24211 msgid ""
24212 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
24213 "C<vi>."
24214 msgstr ""
24215
24216 # type: =item
24217 #. type: =item
24218 #: ../fish/guestfish.pod:1026
24219 msgid "GUESTFISH_PID"
24220 msgstr ""
24221
24222 # type: textblock
24223 #. type: textblock
24224 #: ../fish/guestfish.pod:1028
24225 msgid ""
24226 "Used with the I<--remote> option to specify the remote guestfish process to "
24227 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
24228 msgstr ""
24229
24230 # type: =item
24231 #. type: =item
24232 #: ../fish/guestfish.pod:1032
24233 msgid "HEXEDITOR"
24234 msgstr ""
24235
24236 # type: textblock
24237 #. type: textblock
24238 #: ../fish/guestfish.pod:1034
24239 msgid ""
24240 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
24241 "not specified, the external L<hexedit(1)> program is used."
24242 msgstr ""
24243
24244 # type: =item
24245 #. type: =item
24246 #: ../fish/guestfish.pod:1038
24247 msgid "HOME"
24248 msgstr ""
24249
24250 # type: textblock
24251 #. type: textblock
24252 #: ../fish/guestfish.pod:1040
24253 msgid ""
24254 "If compiled with GNU readline support, various files in the home directory "
24255 "can be used.  See L</FILES>."
24256 msgstr ""
24257
24258 # type: textblock
24259 #. type: textblock
24260 #: ../fish/guestfish.pod:1049
24261 msgid ""
24262 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
24263 "effect as using the B<-v> option."
24264 msgstr ""
24265
24266 # type: textblock
24267 #. type: textblock
24268 #: ../fish/guestfish.pod:1061
24269 msgid ""
24270 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
24271 "the discussion of paths in L<guestfs(3)>."
24272 msgstr ""
24273
24274 # type: textblock
24275 #. type: textblock
24276 #: ../fish/guestfish.pod:1072
24277 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
24278 msgstr ""
24279
24280 # type: =item
24281 #. type: =item
24282 #: ../fish/guestfish.pod:1074
24283 msgid "PAGER"
24284 msgstr ""
24285
24286 # type: textblock
24287 #. type: textblock
24288 #: ../fish/guestfish.pod:1076
24289 msgid ""
24290 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
24291 "C<more>."
24292 msgstr ""
24293
24294 # type: =head1
24295 #. type: =head1
24296 #: ../fish/guestfish.pod:1092 ../fuse/guestmount.pod:264
24297 msgid "FILES"
24298 msgstr ""
24299
24300 #. type: =item
24301 #: ../fish/guestfish.pod:1096 ../fuse/guestmount.pod:268
24302 msgid "$HOME/.libguestfs-tools.rc"
24303 msgstr ""
24304
24305 #. type: =item
24306 #: ../fish/guestfish.pod:1098 ../fuse/guestmount.pod:270
24307 msgid "/etc/libguestfs-tools.conf"
24308 msgstr ""
24309
24310 #. type: textblock
24311 #: ../fish/guestfish.pod:1100 ../fuse/guestmount.pod:272
24312 msgid ""
24313 "This configuration file controls the default read-only or read-write mode "
24314 "(I<--ro> or I<--rw>)."
24315 msgstr ""
24316
24317 #. type: textblock
24318 #: ../fish/guestfish.pod:1103
24319 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
24320 msgstr ""
24321
24322 # type: =item
24323 #. type: =item
24324 #: ../fish/guestfish.pod:1105
24325 msgid "$HOME/.guestfish"
24326 msgstr ""
24327
24328 # type: textblock
24329 #. type: textblock
24330 #: ../fish/guestfish.pod:1107
24331 msgid ""
24332 "If compiled with GNU readline support, then the command history is saved in "
24333 "this file."
24334 msgstr ""
24335
24336 # type: =item
24337 #. type: =item
24338 #: ../fish/guestfish.pod:1110
24339 msgid "$HOME/.inputrc"
24340 msgstr ""
24341
24342 # type: =item
24343 #. type: =item
24344 #: ../fish/guestfish.pod:1112
24345 msgid "/etc/inputrc"
24346 msgstr ""
24347
24348 # type: textblock
24349 #. type: textblock
24350 #: ../fish/guestfish.pod:1114
24351 msgid ""
24352 "If compiled with GNU readline support, then these files can be used to "
24353 "configure readline.  For further information, please see L<readline(3)/"
24354 "INITIALIZATION FILE>."
24355 msgstr ""
24356
24357 # type: textblock
24358 #. type: textblock
24359 #: ../fish/guestfish.pod:1118
24360 msgid "To write rules which only apply to guestfish, use:"
24361 msgstr ""
24362
24363 # type: verbatim
24364 #. type: verbatim
24365 #: ../fish/guestfish.pod:1120
24366 #, no-wrap
24367 msgid ""
24368 " $if guestfish\n"
24369 " ...\n"
24370 " $endif\n"
24371 "\n"
24372 msgstr ""
24373
24374 # type: textblock
24375 #. type: textblock
24376 #: ../fish/guestfish.pod:1124
24377 msgid ""
24378 "Variables that you can set in inputrc that change the behaviour of guestfish "
24379 "in useful ways include:"
24380 msgstr ""
24381
24382 # type: =item
24383 #. type: =item
24384 #: ../fish/guestfish.pod:1129
24385 msgid "completion-ignore-case (default: on)"
24386 msgstr ""
24387
24388 # type: textblock
24389 #. type: textblock
24390 #: ../fish/guestfish.pod:1131
24391 msgid ""
24392 "By default, guestfish will ignore case when tab-completing paths on the "
24393 "disk.  Use:"
24394 msgstr ""
24395
24396 # type: verbatim
24397 #. type: verbatim
24398 #: ../fish/guestfish.pod:1134
24399 #, no-wrap
24400 msgid ""
24401 " set completion-ignore-case off\n"
24402 "\n"
24403 msgstr ""
24404
24405 # type: textblock
24406 #. type: textblock
24407 #: ../fish/guestfish.pod:1136
24408 msgid "to make guestfish case sensitive."
24409 msgstr ""
24410
24411 # type: =item
24412 #. type: =item
24413 #: ../fish/guestfish.pod:1140
24414 msgid "test1.img"
24415 msgstr ""
24416
24417 # type: =item
24418 #. type: =item
24419 #: ../fish/guestfish.pod:1142
24420 msgid "test2.img (etc)"
24421 msgstr ""
24422
24423 #. type: textblock
24424 #: ../fish/guestfish.pod:1144
24425 msgid ""
24426 "When using the I<-N> or I<--new> option, the prepared disk or filesystem "
24427 "will be created in the file C<test1.img> in the current directory.  The "
24428 "second use of I<-N> will use C<test2.img> and so on.  Any existing file with "
24429 "the same name will be overwritten."
24430 msgstr ""
24431
24432 #. type: textblock
24433 #: ../fish/guestfish.pod:1153
24434 msgid ""
24435 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
24436 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
24437 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
24438 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
24439 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
24440 ">, L<hexedit(1)>."
24441 msgstr ""
24442
24443 # type: textblock
24444 #. type: textblock
24445 #: ../fish/guestfish.pod:1183 ../test-tool/libguestfs-test-tool.pod:102
24446 #: ../fuse/guestmount.pod:299 ../tools/virt-win-reg.pl:778
24447 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309
24448 #: ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277
24449 msgid ""
24450 "This program is free software; you can redistribute it and/or modify it "
24451 "under the terms of the GNU General Public License as published by the Free "
24452 "Software Foundation; either version 2 of the License, or (at your option) "
24453 "any later version."
24454 msgstr ""
24455
24456 # type: textblock
24457 #. type: textblock
24458 #: ../fish/guestfish.pod:1188 ../test-tool/libguestfs-test-tool.pod:107
24459 #: ../fuse/guestmount.pod:304 ../tools/virt-win-reg.pl:783
24460 #: ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314
24461 #: ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282
24462 msgid ""
24463 "This program is distributed in the hope that it will be useful, but WITHOUT "
24464 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
24465 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
24466 "more details."
24467 msgstr ""
24468
24469 # type: textblock
24470 #. type: textblock
24471 #: ../fish/guestfish.pod:1193 ../test-tool/libguestfs-test-tool.pod:112
24472 #: ../fuse/guestmount.pod:309 ../tools/virt-win-reg.pl:788
24473 #: ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319
24474 #: ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287
24475 msgid ""
24476 "You should have received a copy of the GNU General Public License along with "
24477 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
24478 "Ave, Cambridge, MA 02139, USA."
24479 msgstr ""
24480
24481 # type: =head2
24482 #. type: =head2
24483 #: ../fish/guestfish-actions.pod:1
24484 msgid "add-cdrom"
24485 msgstr ""
24486
24487 # type: verbatim
24488 #. type: verbatim
24489 #: ../fish/guestfish-actions.pod:3
24490 #, no-wrap
24491 msgid ""
24492 " add-cdrom filename\n"
24493 "\n"
24494 msgstr ""
24495
24496 # type: textblock
24497 #. type: textblock
24498 #: ../fish/guestfish-actions.pod:15
24499 msgid ""
24500 "This call checks for the existence of C<filename>.  This stops you from "
24501 "specifying other types of drive which are supported by qemu such as C<nbd:> "
24502 "and C<http:> URLs.  To specify those, use the general L</config> call "
24503 "instead."
24504 msgstr ""
24505
24506 # type: textblock
24507 #. type: textblock
24508 #: ../fish/guestfish-actions.pod:22
24509 msgid ""
24510 "If you just want to add an ISO file (often you use this as an efficient way "
24511 "to transfer large files into the guest), then you should probably use L</add-"
24512 "drive-ro> instead."
24513 msgstr ""
24514
24515 # type: =head2
24516 #. type: =head2
24517 #: ../fish/guestfish-actions.pod:35
24518 msgid "add-domain"
24519 msgstr ""
24520
24521 # type: =head2
24522 #. type: =head2
24523 #: ../fish/guestfish-actions.pod:37
24524 msgid "domain"
24525 msgstr ""
24526
24527 #. type: verbatim
24528 #: ../fish/guestfish-actions.pod:39
24529 #, no-wrap
24530 msgid ""
24531 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..] [allowuuid:..]\n"
24532 "\n"
24533 msgstr ""
24534
24535 # type: textblock
24536 #. type: textblock
24537 #: ../fish/guestfish-actions.pod:41
24538 msgid ""
24539 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
24540 "It works by connecting to libvirt, requesting the domain and domain XML from "
24541 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
24542 msgstr ""
24543
24544 # type: textblock
24545 #. type: textblock
24546 #: ../fish/guestfish-actions.pod:76
24547 msgid ""
24548 "The other optional parameters are passed directly through to L</add-drive-"
24549 "opts>."
24550 msgstr ""
24551
24552 # type: textblock
24553 #. type: textblock
24554 #: ../fish/guestfish-actions.pod:79 ../fish/guestfish-actions.pod:143
24555 #: ../fish/guestfish-actions.pod:3064
24556 msgid ""
24557 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
24558 msgstr ""
24559
24560 # type: =head2
24561 #. type: =head2
24562 #: ../fish/guestfish-actions.pod:81
24563 msgid "add-drive"
24564 msgstr ""
24565
24566 # type: verbatim
24567 #. type: verbatim
24568 #: ../fish/guestfish-actions.pod:83
24569 #, no-wrap
24570 msgid ""
24571 " add-drive filename\n"
24572 "\n"
24573 msgstr ""
24574
24575 # type: textblock
24576 #. type: textblock
24577 #: ../fish/guestfish-actions.pod:85
24578 msgid ""
24579 "This function is the equivalent of calling L</add-drive-opts> with no "
24580 "optional parameters, so the disk is added writable, with the format being "
24581 "detected automatically."
24582 msgstr ""
24583
24584 # type: textblock
24585 #. type: textblock
24586 #: ../fish/guestfish-actions.pod:89
24587 msgid ""
24588 "Automatic detection of the format opens you up to a potential security hole "
24589 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
24590 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
24591 "you should think about replacing calls to this function with calls to L</add-"
24592 "drive-opts>, and specifying the format."
24593 msgstr ""
24594
24595 # type: =head2
24596 #. type: =head2
24597 #: ../fish/guestfish-actions.pod:96
24598 msgid "add-drive-opts"
24599 msgstr ""
24600
24601 # type: =head2
24602 #. type: =head2
24603 #: ../fish/guestfish-actions.pod:98
24604 msgid "add"
24605 msgstr ""
24606
24607 # type: verbatim
24608 #. type: verbatim
24609 #: ../fish/guestfish-actions.pod:100
24610 #, no-wrap
24611 msgid ""
24612 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
24613 "\n"
24614 msgstr ""
24615
24616 # type: textblock
24617 #. type: textblock
24618 #: ../fish/guestfish-actions.pod:127
24619 msgid ""
24620 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
24621 "add-drive-ro>) then the format is automatically detected.  Possible formats "
24622 "include C<raw> and C<qcow2>."
24623 msgstr ""
24624
24625 # type: textblock
24626 #. type: textblock
24627 #: ../fish/guestfish-actions.pod:138
24628 msgid ""
24629 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
24630 "add-drive-with-if> call (q.v.)"
24631 msgstr ""
24632
24633 # type: =head2
24634 #. type: =head2
24635 #: ../fish/guestfish-actions.pod:145
24636 msgid "add-drive-ro"
24637 msgstr ""
24638
24639 # type: =head2
24640 #. type: =head2
24641 #: ../fish/guestfish-actions.pod:147
24642 msgid "add-ro"
24643 msgstr ""
24644
24645 # type: verbatim
24646 #. type: verbatim
24647 #: ../fish/guestfish-actions.pod:149
24648 #, no-wrap
24649 msgid ""
24650 " add-drive-ro filename\n"
24651 "\n"
24652 msgstr ""
24653
24654 # type: textblock
24655 #. type: textblock
24656 #: ../fish/guestfish-actions.pod:151
24657 msgid ""
24658 "This function is the equivalent of calling L</add-drive-opts> with the "
24659 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
24660 "is added read-only, with the format being detected automatically."
24661 msgstr ""
24662
24663 # type: =head2
24664 #. type: =head2
24665 #: ../fish/guestfish-actions.pod:156
24666 msgid "add-drive-ro-with-if"
24667 msgstr ""
24668
24669 # type: verbatim
24670 #. type: verbatim
24671 #: ../fish/guestfish-actions.pod:158
24672 #, no-wrap
24673 msgid ""
24674 " add-drive-ro-with-if filename iface\n"
24675 "\n"
24676 msgstr ""
24677
24678 # type: textblock
24679 #. type: textblock
24680 #: ../fish/guestfish-actions.pod:160
24681 msgid ""
24682 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
24683 "interface emulation to use at run time."
24684 msgstr ""
24685
24686 # type: =head2
24687 #. type: =head2
24688 #: ../fish/guestfish-actions.pod:170
24689 msgid "add-drive-with-if"
24690 msgstr ""
24691
24692 # type: verbatim
24693 #. type: verbatim
24694 #: ../fish/guestfish-actions.pod:172
24695 #, no-wrap
24696 msgid ""
24697 " add-drive-with-if filename iface\n"
24698 "\n"
24699 msgstr ""
24700
24701 # type: textblock
24702 #. type: textblock
24703 #: ../fish/guestfish-actions.pod:174
24704 msgid ""
24705 "This is the same as L</add-drive> but it allows you to specify the QEMU "
24706 "interface emulation to use at run time."
24707 msgstr ""
24708
24709 # type: =head2
24710 #. type: =head2
24711 #: ../fish/guestfish-actions.pod:184
24712 msgid "aug-clear"
24713 msgstr ""
24714
24715 # type: verbatim
24716 #. type: verbatim
24717 #: ../fish/guestfish-actions.pod:186
24718 #, no-wrap
24719 msgid ""
24720 " aug-clear augpath\n"
24721 "\n"
24722 msgstr ""
24723
24724 # type: =head2
24725 #. type: =head2
24726 #: ../fish/guestfish-actions.pod:191
24727 msgid "aug-close"
24728 msgstr ""
24729
24730 # type: verbatim
24731 #. type: verbatim
24732 #: ../fish/guestfish-actions.pod:193
24733 #, no-wrap
24734 msgid ""
24735 " aug-close\n"
24736 "\n"
24737 msgstr ""
24738
24739 # type: textblock
24740 #. type: textblock
24741 #: ../fish/guestfish-actions.pod:195
24742 msgid ""
24743 "Close the current Augeas handle and free up any resources used by it.  After "
24744 "calling this, you have to call L</aug-init> again before you can use any "
24745 "other Augeas functions."
24746 msgstr ""
24747
24748 # type: =head2
24749 #. type: =head2
24750 #: ../fish/guestfish-actions.pod:200
24751 msgid "aug-defnode"
24752 msgstr ""
24753
24754 # type: verbatim
24755 #. type: verbatim
24756 #: ../fish/guestfish-actions.pod:202
24757 #, no-wrap
24758 msgid ""
24759 " aug-defnode name expr val\n"
24760 "\n"
24761 msgstr ""
24762
24763 # type: textblock
24764 #. type: textblock
24765 #: ../fish/guestfish-actions.pod:207
24766 msgid ""
24767 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
24768 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
24769 "containing that single node."
24770 msgstr ""
24771
24772 # type: =head2
24773 #. type: =head2
24774 #: ../fish/guestfish-actions.pod:215
24775 msgid "aug-defvar"
24776 msgstr ""
24777
24778 # type: verbatim
24779 #. type: verbatim
24780 #: ../fish/guestfish-actions.pod:217
24781 #, no-wrap
24782 msgid ""
24783 " aug-defvar name expr\n"
24784 "\n"
24785 msgstr ""
24786
24787 # type: =head2
24788 #. type: =head2
24789 #: ../fish/guestfish-actions.pod:226
24790 msgid "aug-get"
24791 msgstr ""
24792
24793 # type: verbatim
24794 #. type: verbatim
24795 #: ../fish/guestfish-actions.pod:228
24796 #, no-wrap
24797 msgid ""
24798 " aug-get augpath\n"
24799 "\n"
24800 msgstr ""
24801
24802 # type: =head2
24803 #. type: =head2
24804 #: ../fish/guestfish-actions.pod:233
24805 msgid "aug-init"
24806 msgstr ""
24807
24808 # type: verbatim
24809 #. type: verbatim
24810 #: ../fish/guestfish-actions.pod:235
24811 #, no-wrap
24812 msgid ""
24813 " aug-init root flags\n"
24814 "\n"
24815 msgstr ""
24816
24817 # type: textblock
24818 #. type: textblock
24819 #: ../fish/guestfish-actions.pod:241
24820 msgid "You must call this before using any other L</aug-*> commands."
24821 msgstr ""
24822
24823 # type: textblock
24824 #. type: textblock
24825 #: ../fish/guestfish-actions.pod:276
24826 msgid "Do not load the tree in L</aug-init>."
24827 msgstr ""
24828
24829 # type: textblock
24830 #. type: textblock
24831 #: ../fish/guestfish-actions.pod:280
24832 msgid "To close the handle, you can call L</aug-close>."
24833 msgstr ""
24834
24835 # type: =head2
24836 #. type: =head2
24837 #: ../fish/guestfish-actions.pod:284
24838 msgid "aug-insert"
24839 msgstr ""
24840
24841 # type: verbatim
24842 #. type: verbatim
24843 #: ../fish/guestfish-actions.pod:286
24844 #, no-wrap
24845 msgid ""
24846 " aug-insert augpath label true|false\n"
24847 "\n"
24848 msgstr ""
24849
24850 # type: =head2
24851 #. type: =head2
24852 #: ../fish/guestfish-actions.pod:296
24853 msgid "aug-load"
24854 msgstr ""
24855
24856 # type: verbatim
24857 #. type: verbatim
24858 #: ../fish/guestfish-actions.pod:298
24859 #, no-wrap
24860 msgid ""
24861 " aug-load\n"
24862 "\n"
24863 msgstr ""
24864
24865 # type: =head2
24866 #. type: =head2
24867 #: ../fish/guestfish-actions.pod:305
24868 msgid "aug-ls"
24869 msgstr ""
24870
24871 # type: verbatim
24872 #. type: verbatim
24873 #: ../fish/guestfish-actions.pod:307
24874 #, no-wrap
24875 msgid ""
24876 " aug-ls augpath\n"
24877 "\n"
24878 msgstr ""
24879
24880 # type: textblock
24881 #. type: textblock
24882 #: ../fish/guestfish-actions.pod:309
24883 msgid ""
24884 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
24885 "resulting nodes into alphabetical order."
24886 msgstr ""
24887
24888 # type: =head2
24889 #. type: =head2
24890 #: ../fish/guestfish-actions.pod:312
24891 msgid "aug-match"
24892 msgstr ""
24893
24894 # type: verbatim
24895 #. type: verbatim
24896 #: ../fish/guestfish-actions.pod:314
24897 #, no-wrap
24898 msgid ""
24899 " aug-match augpath\n"
24900 "\n"
24901 msgstr ""
24902
24903 # type: =head2
24904 #. type: =head2
24905 #: ../fish/guestfish-actions.pod:320
24906 msgid "aug-mv"
24907 msgstr ""
24908
24909 # type: verbatim
24910 #. type: verbatim
24911 #: ../fish/guestfish-actions.pod:322
24912 #, no-wrap
24913 msgid ""
24914 " aug-mv src dest\n"
24915 "\n"
24916 msgstr ""
24917
24918 # type: =head2
24919 #. type: =head2
24920 #: ../fish/guestfish-actions.pod:327
24921 msgid "aug-rm"
24922 msgstr ""
24923
24924 # type: verbatim
24925 #. type: verbatim
24926 #: ../fish/guestfish-actions.pod:329
24927 #, no-wrap
24928 msgid ""
24929 " aug-rm augpath\n"
24930 "\n"
24931 msgstr ""
24932
24933 # type: =head2
24934 #. type: =head2
24935 #: ../fish/guestfish-actions.pod:335
24936 msgid "aug-save"
24937 msgstr ""
24938
24939 # type: verbatim
24940 #. type: verbatim
24941 #: ../fish/guestfish-actions.pod:337
24942 #, no-wrap
24943 msgid ""
24944 " aug-save\n"
24945 "\n"
24946 msgstr ""
24947
24948 # type: textblock
24949 #. type: textblock
24950 #: ../fish/guestfish-actions.pod:341
24951 msgid ""
24952 "The flags which were passed to L</aug-init> affect exactly how files are "
24953 "saved."
24954 msgstr ""
24955
24956 # type: =head2
24957 #. type: =head2
24958 #: ../fish/guestfish-actions.pod:344
24959 msgid "aug-set"
24960 msgstr ""
24961
24962 # type: verbatim
24963 #. type: verbatim
24964 #: ../fish/guestfish-actions.pod:346
24965 #, no-wrap
24966 msgid ""
24967 " aug-set augpath val\n"
24968 "\n"
24969 msgstr ""
24970
24971 # type: textblock
24972 #. type: textblock
24973 #: ../fish/guestfish-actions.pod:350
24974 msgid ""
24975 "In the Augeas API, it is possible to clear a node by setting the value to "
24976 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
24977 "this call.  Instead you must use the L</aug-clear> call."
24978 msgstr ""
24979
24980 # type: =head2
24981 #. type: =head2
24982 #: ../fish/guestfish-actions.pod:355
24983 msgid "available"
24984 msgstr ""
24985
24986 # type: verbatim
24987 #. type: verbatim
24988 #: ../fish/guestfish-actions.pod:357
24989 #, no-wrap
24990 msgid ""
24991 " available 'groups ...'\n"
24992 "\n"
24993 msgstr ""
24994
24995 # type: textblock
24996 #. type: textblock
24997 #: ../fish/guestfish-actions.pod:363
24998 msgid ""
24999 "The libguestfs groups, and the functions that those groups correspond to, "
25000 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
25001 "runtime by calling L</available-all-groups>."
25002 msgstr ""
25003
25004 # type: textblock
25005 #. type: textblock
25006 #: ../fish/guestfish-actions.pod:387
25007 msgid "You must call L</launch> before calling this function."
25008 msgstr ""
25009
25010 # type: textblock
25011 #. type: textblock
25012 #: ../fish/guestfish-actions.pod:409
25013 msgid ""
25014 "This call was added in version C<1.0.80>.  In previous versions of "
25015 "libguestfs all you could do would be to speculatively execute a command to "
25016 "find out if the daemon implemented it.  See also L</version>."
25017 msgstr ""
25018
25019 # type: =head2
25020 #. type: =head2
25021 #: ../fish/guestfish-actions.pod:416
25022 msgid "available-all-groups"
25023 msgstr ""
25024
25025 # type: verbatim
25026 #. type: verbatim
25027 #: ../fish/guestfish-actions.pod:418
25028 #, no-wrap
25029 msgid ""
25030 " available-all-groups\n"
25031 "\n"
25032 msgstr ""
25033
25034 # type: textblock
25035 #. type: textblock
25036 #: ../fish/guestfish-actions.pod:420
25037 msgid ""
25038 "This command returns a list of all optional groups that this daemon knows "
25039 "about.  Note this returns both supported and unsupported groups.  To find "
25040 "out which ones the daemon can actually support you have to call L</"
25041 "available> on each member of the returned list."
25042 msgstr ""
25043
25044 # type: textblock
25045 #. type: textblock
25046 #: ../fish/guestfish-actions.pod:426
25047 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
25048 msgstr ""
25049
25050 # type: =head2
25051 #. type: =head2
25052 #: ../fish/guestfish-actions.pod:428
25053 msgid "base64-in"
25054 msgstr ""
25055
25056 # type: verbatim
25057 #. type: verbatim
25058 #: ../fish/guestfish-actions.pod:430
25059 #, no-wrap
25060 msgid ""
25061 " base64-in (base64file|-) filename\n"
25062 "\n"
25063 msgstr ""
25064
25065 # type: textblock
25066 #. type: textblock
25067 #: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444
25068 #: ../fish/guestfish-actions.pod:668 ../fish/guestfish-actions.pod:837
25069 #: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:1230
25070 #: ../fish/guestfish-actions.pod:4497 ../fish/guestfish-actions.pod:4509
25071 #: ../fish/guestfish-actions.pod:4520 ../fish/guestfish-actions.pod:4531
25072 #: ../fish/guestfish-actions.pod:4583 ../fish/guestfish-actions.pod:4592
25073 #: ../fish/guestfish-actions.pod:4646 ../fish/guestfish-actions.pod:4669
25074 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
25075 msgstr ""
25076
25077 # type: =head2
25078 #. type: =head2
25079 #: ../fish/guestfish-actions.pod:437
25080 msgid "base64-out"
25081 msgstr ""
25082
25083 # type: verbatim
25084 #. type: verbatim
25085 #: ../fish/guestfish-actions.pod:439
25086 #, no-wrap
25087 msgid ""
25088 " base64-out filename (base64file|-)\n"
25089 "\n"
25090 msgstr ""
25091
25092 # type: =head2
25093 #. type: =head2
25094 #: ../fish/guestfish-actions.pod:446
25095 msgid "blockdev-flushbufs"
25096 msgstr ""
25097
25098 # type: verbatim
25099 #. type: verbatim
25100 #: ../fish/guestfish-actions.pod:448
25101 #, no-wrap
25102 msgid ""
25103 " blockdev-flushbufs device\n"
25104 "\n"
25105 msgstr ""
25106
25107 # type: =head2
25108 #. type: =head2
25109 #: ../fish/guestfish-actions.pod:455
25110 msgid "blockdev-getbsz"
25111 msgstr ""
25112
25113 # type: verbatim
25114 #. type: verbatim
25115 #: ../fish/guestfish-actions.pod:457
25116 #, no-wrap
25117 msgid ""
25118 " blockdev-getbsz device\n"
25119 "\n"
25120 msgstr ""
25121
25122 # type: =head2
25123 #. type: =head2
25124 #: ../fish/guestfish-actions.pod:466
25125 msgid "blockdev-getro"
25126 msgstr ""
25127
25128 # type: verbatim
25129 #. type: verbatim
25130 #: ../fish/guestfish-actions.pod:468
25131 #, no-wrap
25132 msgid ""
25133 " blockdev-getro device\n"
25134 "\n"
25135 msgstr ""
25136
25137 # type: =head2
25138 #. type: =head2
25139 #: ../fish/guestfish-actions.pod:475
25140 msgid "blockdev-getsize64"
25141 msgstr ""
25142
25143 # type: verbatim
25144 #. type: verbatim
25145 #: ../fish/guestfish-actions.pod:477
25146 #, no-wrap
25147 msgid ""
25148 " blockdev-getsize64 device\n"
25149 "\n"
25150 msgstr ""
25151
25152 # type: textblock
25153 #. type: textblock
25154 #: ../fish/guestfish-actions.pod:481
25155 msgid "See also L</blockdev-getsz>."
25156 msgstr ""
25157
25158 # type: =head2
25159 #. type: =head2
25160 #: ../fish/guestfish-actions.pod:485
25161 msgid "blockdev-getss"
25162 msgstr ""
25163
25164 # type: verbatim
25165 #. type: verbatim
25166 #: ../fish/guestfish-actions.pod:487
25167 #, no-wrap
25168 msgid ""
25169 " blockdev-getss device\n"
25170 "\n"
25171 msgstr ""
25172
25173 # type: textblock
25174 #. type: textblock
25175 #: ../fish/guestfish-actions.pod:492
25176 msgid ""
25177 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
25178 msgstr ""
25179
25180 # type: =head2
25181 #. type: =head2
25182 #: ../fish/guestfish-actions.pod:497
25183 msgid "blockdev-getsz"
25184 msgstr ""
25185
25186 # type: verbatim
25187 #. type: verbatim
25188 #: ../fish/guestfish-actions.pod:499
25189 #, no-wrap
25190 msgid ""
25191 " blockdev-getsz device\n"
25192 "\n"
25193 msgstr ""
25194
25195 # type: textblock
25196 #. type: textblock
25197 #: ../fish/guestfish-actions.pod:504
25198 msgid ""
25199 "See also L</blockdev-getss> for the real sector size of the device, and L</"
25200 "blockdev-getsize64> for the more useful I<size in bytes>."
25201 msgstr ""
25202
25203 # type: =head2
25204 #. type: =head2
25205 #: ../fish/guestfish-actions.pod:510
25206 msgid "blockdev-rereadpt"
25207 msgstr ""
25208
25209 # type: verbatim
25210 #. type: verbatim
25211 #: ../fish/guestfish-actions.pod:512
25212 #, no-wrap
25213 msgid ""
25214 " blockdev-rereadpt device\n"
25215 "\n"
25216 msgstr ""
25217
25218 # type: =head2
25219 #. type: =head2
25220 #: ../fish/guestfish-actions.pod:518
25221 msgid "blockdev-setbsz"
25222 msgstr ""
25223
25224 # type: verbatim
25225 #. type: verbatim
25226 #: ../fish/guestfish-actions.pod:520
25227 #, no-wrap
25228 msgid ""
25229 " blockdev-setbsz device blocksize\n"
25230 "\n"
25231 msgstr ""
25232
25233 # type: =head2
25234 #. type: =head2
25235 #: ../fish/guestfish-actions.pod:529
25236 msgid "blockdev-setro"
25237 msgstr ""
25238
25239 # type: verbatim
25240 #. type: verbatim
25241 #: ../fish/guestfish-actions.pod:531
25242 #, no-wrap
25243 msgid ""
25244 " blockdev-setro device\n"
25245 "\n"
25246 msgstr ""
25247
25248 # type: =head2
25249 #. type: =head2
25250 #: ../fish/guestfish-actions.pod:537
25251 msgid "blockdev-setrw"
25252 msgstr ""
25253
25254 # type: verbatim
25255 #. type: verbatim
25256 #: ../fish/guestfish-actions.pod:539
25257 #, no-wrap
25258 msgid ""
25259 " blockdev-setrw device\n"
25260 "\n"
25261 msgstr ""
25262
25263 # type: =head2
25264 #. type: =head2
25265 #: ../fish/guestfish-actions.pod:545
25266 msgid "case-sensitive-path"
25267 msgstr ""
25268
25269 # type: verbatim
25270 #. type: verbatim
25271 #: ../fish/guestfish-actions.pod:547
25272 #, no-wrap
25273 msgid ""
25274 " case-sensitive-path path\n"
25275 "\n"
25276 msgstr ""
25277
25278 # type: textblock
25279 #. type: textblock
25280 #: ../fish/guestfish-actions.pod:571
25281 msgid ""
25282 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
25283 "WINDOWS/system32\"> (the exact return value would depend on details of how "
25284 "the directories were originally created under Windows)."
25285 msgstr ""
25286
25287 # type: textblock
25288 #. type: textblock
25289 #: ../fish/guestfish-actions.pod:579
25290 msgid "See also L</realpath>."
25291 msgstr ""
25292
25293 # type: =head2
25294 #. type: =head2
25295 #: ../fish/guestfish-actions.pod:581
25296 msgid "cat"
25297 msgstr ""
25298
25299 # type: verbatim
25300 #. type: verbatim
25301 #: ../fish/guestfish-actions.pod:583
25302 #, no-wrap
25303 msgid ""
25304 " cat path\n"
25305 "\n"
25306 msgstr ""
25307
25308 # type: textblock
25309 #. type: textblock
25310 #: ../fish/guestfish-actions.pod:587
25311 msgid ""
25312 "Note that this function cannot correctly handle binary files (specifically, "
25313 "files containing C<\\0> character which is treated as end of string).  For "
25314 "those you need to use the L</read-file> or L</download> functions which have "
25315 "a more complex interface."
25316 msgstr ""
25317
25318 # type: =head2
25319 #. type: =head2
25320 #: ../fish/guestfish-actions.pod:595
25321 msgid "checksum"
25322 msgstr ""
25323
25324 # type: verbatim
25325 #. type: verbatim
25326 #: ../fish/guestfish-actions.pod:597
25327 #, no-wrap
25328 msgid ""
25329 " checksum csumtype path\n"
25330 "\n"
25331 msgstr ""
25332
25333 # type: textblock
25334 #. type: textblock
25335 #: ../fish/guestfish-actions.pod:640
25336 msgid "To get the checksum for a device, use L</checksum-device>."
25337 msgstr ""
25338
25339 # type: textblock
25340 #. type: textblock
25341 #: ../fish/guestfish-actions.pod:642
25342 msgid "To get the checksums for many files, use L</checksums-out>."
25343 msgstr ""
25344
25345 # type: =head2
25346 #. type: =head2
25347 #: ../fish/guestfish-actions.pod:644
25348 msgid "checksum-device"
25349 msgstr ""
25350
25351 # type: verbatim
25352 #. type: verbatim
25353 #: ../fish/guestfish-actions.pod:646
25354 #, no-wrap
25355 msgid ""
25356 " checksum-device csumtype device\n"
25357 "\n"
25358 msgstr ""
25359
25360 # type: textblock
25361 #. type: textblock
25362 #: ../fish/guestfish-actions.pod:648
25363 msgid ""
25364 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
25365 "device named C<device>.  For the types of checksums supported see the L</"
25366 "checksum> command."
25367 msgstr ""
25368
25369 # type: =head2
25370 #. type: =head2
25371 #: ../fish/guestfish-actions.pod:652
25372 msgid "checksums-out"
25373 msgstr ""
25374
25375 # type: verbatim
25376 #. type: verbatim
25377 #: ../fish/guestfish-actions.pod:654
25378 #, no-wrap
25379 msgid ""
25380 " checksums-out csumtype directory (sumsfile|-)\n"
25381 "\n"
25382 msgstr ""
25383
25384 # type: =head2
25385 #. type: =head2
25386 #: ../fish/guestfish-actions.pod:670
25387 msgid "chmod"
25388 msgstr ""
25389
25390 # type: verbatim
25391 #. type: verbatim
25392 #: ../fish/guestfish-actions.pod:672
25393 #, no-wrap
25394 msgid ""
25395 " chmod mode path\n"
25396 "\n"
25397 msgstr ""
25398
25399 # type: =head2
25400 #. type: =head2
25401 #: ../fish/guestfish-actions.pod:683
25402 msgid "chown"
25403 msgstr ""
25404
25405 # type: verbatim
25406 #. type: verbatim
25407 #: ../fish/guestfish-actions.pod:685
25408 #, no-wrap
25409 msgid ""
25410 " chown owner group path\n"
25411 "\n"
25412 msgstr ""
25413
25414 # type: =head2
25415 #. type: =head2
25416 #: ../fish/guestfish-actions.pod:693
25417 msgid "command"
25418 msgstr ""
25419
25420 # type: verbatim
25421 #. type: verbatim
25422 #: ../fish/guestfish-actions.pod:695
25423 #, no-wrap
25424 msgid ""
25425 " command 'arguments ...'\n"
25426 "\n"
25427 msgstr ""
25428
25429 # type: textblock
25430 #. type: textblock
25431 #: ../fish/guestfish-actions.pod:702
25432 msgid ""
25433 "The single parameter is an argv-style list of arguments.  The first element "
25434 "is the name of the program to run.  Subsequent elements are parameters.  The "
25435 "list must be non-empty (ie. must contain a program name).  Note that the "
25436 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
25437 msgstr ""
25438
25439 # type: =head2
25440 #. type: =head2
25441 #: ../fish/guestfish-actions.pod:730
25442 msgid "command-lines"
25443 msgstr ""
25444
25445 # type: verbatim
25446 #. type: verbatim
25447 #: ../fish/guestfish-actions.pod:732
25448 #, no-wrap
25449 msgid ""
25450 " command-lines 'arguments ...'\n"
25451 "\n"
25452 msgstr ""
25453
25454 # type: textblock
25455 #. type: textblock
25456 #: ../fish/guestfish-actions.pod:734
25457 msgid ""
25458 "This is the same as L</command>, but splits the result into a list of lines."
25459 msgstr ""
25460
25461 # type: textblock
25462 #. type: textblock
25463 #: ../fish/guestfish-actions.pod:737
25464 msgid "See also: L</sh-lines>"
25465 msgstr ""
25466
25467 # type: =head2
25468 #. type: =head2
25469 #: ../fish/guestfish-actions.pod:742
25470 msgid "config"
25471 msgstr ""
25472
25473 # type: verbatim
25474 #. type: verbatim
25475 #: ../fish/guestfish-actions.pod:744
25476 #, no-wrap
25477 msgid ""
25478 " config qemuparam qemuvalue\n"
25479 "\n"
25480 msgstr ""
25481
25482 # type: =head2
25483 #. type: =head2
25484 #: ../fish/guestfish-actions.pod:755
25485 msgid "copy-size"
25486 msgstr ""
25487
25488 # type: verbatim
25489 #. type: verbatim
25490 #: ../fish/guestfish-actions.pod:757
25491 #, no-wrap
25492 msgid ""
25493 " copy-size src dest size\n"
25494 "\n"
25495 msgstr ""
25496
25497 # type: =head2
25498 #. type: =head2
25499 #: ../fish/guestfish-actions.pod:765
25500 msgid "cp"
25501 msgstr ""
25502
25503 # type: verbatim
25504 #. type: verbatim
25505 #: ../fish/guestfish-actions.pod:767
25506 #, no-wrap
25507 msgid ""
25508 " cp src dest\n"
25509 "\n"
25510 msgstr ""
25511
25512 # type: =head2
25513 #. type: =head2
25514 #: ../fish/guestfish-actions.pod:772
25515 msgid "cp-a"
25516 msgstr ""
25517
25518 # type: verbatim
25519 #. type: verbatim
25520 #: ../fish/guestfish-actions.pod:774
25521 #, no-wrap
25522 msgid ""
25523 " cp-a src dest\n"
25524 "\n"
25525 msgstr ""
25526
25527 # type: =head2
25528 #. type: =head2
25529 #: ../fish/guestfish-actions.pod:779
25530 msgid "dd"
25531 msgstr ""
25532
25533 # type: verbatim
25534 #. type: verbatim
25535 #: ../fish/guestfish-actions.pod:781
25536 #, no-wrap
25537 msgid ""
25538 " dd src dest\n"
25539 "\n"
25540 msgstr ""
25541
25542 # type: textblock
25543 #. type: textblock
25544 #: ../fish/guestfish-actions.pod:788
25545 msgid ""
25546 "If the destination is a device, it must be as large or larger than the "
25547 "source file or device, otherwise the copy will fail.  This command cannot do "
25548 "partial copies (see L</copy-size>)."
25549 msgstr ""
25550
25551 # type: =head2
25552 #. type: =head2
25553 #: ../fish/guestfish-actions.pod:792
25554 msgid "df"
25555 msgstr ""
25556
25557 # type: verbatim
25558 #. type: verbatim
25559 #: ../fish/guestfish-actions.pod:794
25560 #, no-wrap
25561 msgid ""
25562 " df\n"
25563 "\n"
25564 msgstr ""
25565
25566 # type: textblock
25567 #. type: textblock
25568 #: ../fish/guestfish-actions.pod:798 ../fish/guestfish-actions.pod:809
25569 msgid ""
25570 "This command is mostly useful for interactive sessions.  It is I<not> "
25571 "intended that you try to parse the output string.  Use L</statvfs> from "
25572 "programs."
25573 msgstr ""
25574
25575 # type: =head2
25576 #. type: =head2
25577 #: ../fish/guestfish-actions.pod:802
25578 msgid "df-h"
25579 msgstr ""
25580
25581 # type: verbatim
25582 #. type: verbatim
25583 #: ../fish/guestfish-actions.pod:804
25584 #, no-wrap
25585 msgid ""
25586 " df-h\n"
25587 "\n"
25588 msgstr ""
25589
25590 # type: =head2
25591 #. type: =head2
25592 #: ../fish/guestfish-actions.pod:813
25593 msgid "dmesg"
25594 msgstr ""
25595
25596 # type: verbatim
25597 #. type: verbatim
25598 #: ../fish/guestfish-actions.pod:815
25599 #, no-wrap
25600 msgid ""
25601 " dmesg\n"
25602 "\n"
25603 msgstr ""
25604
25605 # type: textblock
25606 #. type: textblock
25607 #: ../fish/guestfish-actions.pod:821
25608 msgid ""
25609 "Another way to get the same information is to enable verbose messages with "
25610 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
25611 "before running the program."
25612 msgstr ""
25613
25614 # type: =head2
25615 #. type: =head2
25616 #: ../fish/guestfish-actions.pod:826
25617 msgid "download"
25618 msgstr ""
25619
25620 # type: verbatim
25621 #. type: verbatim
25622 #: ../fish/guestfish-actions.pod:828
25623 #, no-wrap
25624 msgid ""
25625 " download remotefilename (filename|-)\n"
25626 "\n"
25627 msgstr ""
25628
25629 # type: textblock
25630 #. type: textblock
25631 #: ../fish/guestfish-actions.pod:835
25632 msgid "See also L</upload>, L</cat>."
25633 msgstr ""
25634
25635 # type: =head2
25636 #. type: =head2
25637 #: ../fish/guestfish-actions.pod:839
25638 msgid "download-offset"
25639 msgstr ""
25640
25641 # type: verbatim
25642 #. type: verbatim
25643 #: ../fish/guestfish-actions.pod:841
25644 #, no-wrap
25645 msgid ""
25646 " download-offset remotefilename (filename|-) offset size\n"
25647 "\n"
25648 msgstr ""
25649
25650 # type: textblock
25651 #. type: textblock
25652 #: ../fish/guestfish-actions.pod:849
25653 msgid ""
25654 "Note that there is no limit on the amount of data that can be downloaded "
25655 "with this call, unlike with L</pread>, and this call always reads the full "
25656 "amount unless an error occurs."
25657 msgstr ""
25658
25659 # type: textblock
25660 #. type: textblock
25661 #: ../fish/guestfish-actions.pod:854
25662 msgid "See also L</download>, L</pread>."
25663 msgstr ""
25664
25665 # type: =head2
25666 #. type: =head2
25667 #: ../fish/guestfish-actions.pod:858
25668 msgid "drop-caches"
25669 msgstr ""
25670
25671 # type: verbatim
25672 #. type: verbatim
25673 #: ../fish/guestfish-actions.pod:860
25674 #, no-wrap
25675 msgid ""
25676 " drop-caches whattodrop\n"
25677 "\n"
25678 msgstr ""
25679
25680 # type: =head2
25681 #. type: =head2
25682 #: ../fish/guestfish-actions.pod:872
25683 msgid "du"
25684 msgstr ""
25685
25686 # type: verbatim
25687 #. type: verbatim
25688 #: ../fish/guestfish-actions.pod:874
25689 #, no-wrap
25690 msgid ""
25691 " du path\n"
25692 "\n"
25693 msgstr ""
25694
25695 # type: =head2
25696 #. type: =head2
25697 #: ../fish/guestfish-actions.pod:886
25698 msgid "e2fsck-f"
25699 msgstr ""
25700
25701 # type: verbatim
25702 #. type: verbatim
25703 #: ../fish/guestfish-actions.pod:888
25704 #, no-wrap
25705 msgid ""
25706 " e2fsck-f device\n"
25707 "\n"
25708 msgstr ""
25709
25710 # type: textblock
25711 #. type: textblock
25712 #: ../fish/guestfish-actions.pod:894
25713 msgid ""
25714 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
25715 "should use L</fsck>."
25716 msgstr ""
25717
25718 # type: =head2
25719 #. type: =head2
25720 #: ../fish/guestfish-actions.pod:897
25721 msgid "echo-daemon"
25722 msgstr ""
25723
25724 # type: verbatim
25725 #. type: verbatim
25726 #: ../fish/guestfish-actions.pod:899
25727 #, no-wrap
25728 msgid ""
25729 " echo-daemon 'words ...'\n"
25730 "\n"
25731 msgstr ""
25732
25733 # type: textblock
25734 #. type: textblock
25735 #: ../fish/guestfish-actions.pod:906
25736 msgid "See also L</ping-daemon>."
25737 msgstr ""
25738
25739 # type: =head2
25740 #. type: =head2
25741 #: ../fish/guestfish-actions.pod:908
25742 msgid "egrep"
25743 msgstr ""
25744
25745 # type: verbatim
25746 #. type: verbatim
25747 #: ../fish/guestfish-actions.pod:910
25748 #, no-wrap
25749 msgid ""
25750 " egrep regex path\n"
25751 "\n"
25752 msgstr ""
25753
25754 # type: =head2
25755 #. type: =head2
25756 #: ../fish/guestfish-actions.pod:918
25757 msgid "egrepi"
25758 msgstr ""
25759
25760 # type: verbatim
25761 #. type: verbatim
25762 #: ../fish/guestfish-actions.pod:920
25763 #, no-wrap
25764 msgid ""
25765 " egrepi regex path\n"
25766 "\n"
25767 msgstr ""
25768
25769 # type: =head2
25770 #. type: =head2
25771 #: ../fish/guestfish-actions.pod:928
25772 msgid "equal"
25773 msgstr ""
25774
25775 # type: verbatim
25776 #. type: verbatim
25777 #: ../fish/guestfish-actions.pod:930
25778 #, no-wrap
25779 msgid ""
25780 " equal file1 file2\n"
25781 "\n"
25782 msgstr ""
25783
25784 # type: =head2
25785 #. type: =head2
25786 #: ../fish/guestfish-actions.pod:937
25787 msgid "exists"
25788 msgstr ""
25789
25790 # type: verbatim
25791 #. type: verbatim
25792 #: ../fish/guestfish-actions.pod:939
25793 #, no-wrap
25794 msgid ""
25795 " exists path\n"
25796 "\n"
25797 msgstr ""
25798
25799 # type: textblock
25800 #. type: textblock
25801 #: ../fish/guestfish-actions.pod:944
25802 msgid "See also L</is-file>, L</is-dir>, L</stat>."
25803 msgstr ""
25804
25805 # type: =head2
25806 #. type: =head2
25807 #: ../fish/guestfish-actions.pod:946
25808 msgid "fallocate"
25809 msgstr ""
25810
25811 # type: verbatim
25812 #. type: verbatim
25813 #: ../fish/guestfish-actions.pod:948
25814 #, no-wrap
25815 msgid ""
25816 " fallocate path len\n"
25817 "\n"
25818 msgstr ""
25819
25820 # type: =head2
25821 #. type: =head2
25822 #: ../fish/guestfish-actions.pod:965
25823 msgid "fallocate64"
25824 msgstr ""
25825
25826 # type: verbatim
25827 #. type: verbatim
25828 #: ../fish/guestfish-actions.pod:967
25829 #, no-wrap
25830 msgid ""
25831 " fallocate64 path len\n"
25832 "\n"
25833 msgstr ""
25834
25835 # type: textblock
25836 #. type: textblock
25837 #: ../fish/guestfish-actions.pod:973
25838 msgid ""
25839 "Note that this call allocates disk blocks for the file.  To create a sparse "
25840 "file use L</truncate-size> instead."
25841 msgstr ""
25842
25843 # type: textblock
25844 #. type: textblock
25845 #: ../fish/guestfish-actions.pod:976
25846 msgid ""
25847 "The deprecated call L</fallocate> does the same, but owing to an oversight "
25848 "it only allowed 30 bit lengths to be specified, effectively limiting the "
25849 "maximum size of files created through that call to 1GB."
25850 msgstr ""
25851
25852 # type: =head2
25853 #. type: =head2
25854 #: ../fish/guestfish-actions.pod:985
25855 msgid "fgrep"
25856 msgstr ""
25857
25858 # type: verbatim
25859 #. type: verbatim
25860 #: ../fish/guestfish-actions.pod:987
25861 #, no-wrap
25862 msgid ""
25863 " fgrep pattern path\n"
25864 "\n"
25865 msgstr ""
25866
25867 # type: =head2
25868 #. type: =head2
25869 #: ../fish/guestfish-actions.pod:995
25870 msgid "fgrepi"
25871 msgstr ""
25872
25873 # type: verbatim
25874 #. type: verbatim
25875 #: ../fish/guestfish-actions.pod:997
25876 #, no-wrap
25877 msgid ""
25878 " fgrepi pattern path\n"
25879 "\n"
25880 msgstr ""
25881
25882 # type: =head2
25883 #. type: =head2
25884 #: ../fish/guestfish-actions.pod:1005
25885 msgid "file"
25886 msgstr ""
25887
25888 # type: verbatim
25889 #. type: verbatim
25890 #: ../fish/guestfish-actions.pod:1007
25891 #, no-wrap
25892 msgid ""
25893 " file path\n"
25894 "\n"
25895 msgstr ""
25896
25897 #. type: textblock
25898 #: ../fish/guestfish-actions.pod:1023
25899 msgid ""
25900 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
25901 "(etc), L</is-zero>."
25902 msgstr ""
25903
25904 # type: =head2
25905 #. type: =head2
25906 #: ../fish/guestfish-actions.pod:1026
25907 msgid "file-architecture"
25908 msgstr ""
25909
25910 # type: verbatim
25911 #. type: verbatim
25912 #: ../fish/guestfish-actions.pod:1028
25913 #, no-wrap
25914 msgid ""
25915 " file-architecture filename\n"
25916 "\n"
25917 msgstr ""
25918
25919 # type: =head2
25920 #. type: =head2
25921 #: ../fish/guestfish-actions.pod:1131
25922 msgid "filesize"
25923 msgstr ""
25924
25925 # type: verbatim
25926 #. type: verbatim
25927 #: ../fish/guestfish-actions.pod:1133
25928 #, no-wrap
25929 msgid ""
25930 " filesize file\n"
25931 "\n"
25932 msgstr ""
25933
25934 # type: textblock
25935 #. type: textblock
25936 #: ../fish/guestfish-actions.pod:1137
25937 msgid ""
25938 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
25939 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
25940 msgstr ""
25941
25942 # type: =head2
25943 #. type: =head2
25944 #: ../fish/guestfish-actions.pod:1141
25945 msgid "fill"
25946 msgstr ""
25947
25948 # type: verbatim
25949 #. type: verbatim
25950 #: ../fish/guestfish-actions.pod:1143
25951 #, no-wrap
25952 msgid ""
25953 " fill c len path\n"
25954 "\n"
25955 msgstr ""
25956
25957 # type: textblock
25958 #. type: textblock
25959 #: ../fish/guestfish-actions.pod:1149
25960 msgid ""
25961 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
25962 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
25963 "L</fill-pattern>."
25964 msgstr ""
25965
25966 # type: =head2
25967 #. type: =head2
25968 #: ../fish/guestfish-actions.pod:1154
25969 msgid "fill-pattern"
25970 msgstr ""
25971
25972 # type: verbatim
25973 #. type: verbatim
25974 #: ../fish/guestfish-actions.pod:1156
25975 #, no-wrap
25976 msgid ""
25977 " fill-pattern pattern len path\n"
25978 "\n"
25979 msgstr ""
25980
25981 # type: textblock
25982 #. type: textblock
25983 #: ../fish/guestfish-actions.pod:1158
25984 msgid ""
25985 "This function is like L</fill> except that it creates a new file of length "
25986 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
25987 "is truncated if necessary to ensure the length of the file is exactly C<len> "
25988 "bytes."
25989 msgstr ""
25990
25991 # type: =head2
25992 #. type: =head2
25993 #: ../fish/guestfish-actions.pod:1163
25994 msgid "find"
25995 msgstr ""
25996
25997 # type: verbatim
25998 #. type: verbatim
25999 #: ../fish/guestfish-actions.pod:1165
26000 #, no-wrap
26001 msgid ""
26002 " find directory\n"
26003 "\n"
26004 msgstr ""
26005
26006 # type: textblock
26007 #. type: textblock
26008 #: ../fish/guestfish-actions.pod:1179
26009 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
26010 msgstr ""
26011
26012 # type: textblock
26013 #. type: textblock
26014 #: ../fish/guestfish-actions.pod:1192
26015 msgid "See also L</find0>."
26016 msgstr ""
26017
26018 # type: =head2
26019 #. type: =head2
26020 #: ../fish/guestfish-actions.pod:1197
26021 msgid "find0"
26022 msgstr ""
26023
26024 # type: verbatim
26025 #. type: verbatim
26026 #: ../fish/guestfish-actions.pod:1199
26027 #, no-wrap
26028 msgid ""
26029 " find0 directory (files|-)\n"
26030 "\n"
26031 msgstr ""
26032
26033 # type: textblock
26034 #. type: textblock
26035 #: ../fish/guestfish-actions.pod:1205
26036 msgid ""
26037 "This command works the same way as L</find> with the following exceptions:"
26038 msgstr ""
26039
26040 # type: =head2
26041 #. type: =head2
26042 #: ../fish/guestfish-actions.pod:1232
26043 msgid "findfs-label"
26044 msgstr ""
26045
26046 # type: verbatim
26047 #. type: verbatim
26048 #: ../fish/guestfish-actions.pod:1234
26049 #, no-wrap
26050 msgid ""
26051 " findfs-label label\n"
26052 "\n"
26053 msgstr ""
26054
26055 # type: textblock
26056 #. type: textblock
26057 #: ../fish/guestfish-actions.pod:1240
26058 msgid "To find the label of a filesystem, use L</vfs-label>."
26059 msgstr ""
26060
26061 # type: =head2
26062 #. type: =head2
26063 #: ../fish/guestfish-actions.pod:1242
26064 msgid "findfs-uuid"
26065 msgstr ""
26066
26067 # type: verbatim
26068 #. type: verbatim
26069 #: ../fish/guestfish-actions.pod:1244
26070 #, no-wrap
26071 msgid ""
26072 " findfs-uuid uuid\n"
26073 "\n"
26074 msgstr ""
26075
26076 # type: textblock
26077 #. type: textblock
26078 #: ../fish/guestfish-actions.pod:1250
26079 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
26080 msgstr ""
26081
26082 # type: =head2
26083 #. type: =head2
26084 #: ../fish/guestfish-actions.pod:1252
26085 msgid "fsck"
26086 msgstr ""
26087
26088 # type: verbatim
26089 #. type: verbatim
26090 #: ../fish/guestfish-actions.pod:1254
26091 #, no-wrap
26092 msgid ""
26093 " fsck fstype device\n"
26094 "\n"
26095 msgstr ""
26096
26097 # type: =head2
26098 #. type: =head2
26099 #: ../fish/guestfish-actions.pod:1284
26100 msgid "get-append"
26101 msgstr ""
26102
26103 # type: verbatim
26104 #. type: verbatim
26105 #: ../fish/guestfish-actions.pod:1286
26106 #, no-wrap
26107 msgid ""
26108 " get-append\n"
26109 "\n"
26110 msgstr ""
26111
26112 #. type: =head2
26113 #: ../fish/guestfish-actions.pod:1293
26114 msgid "get-attach-method"
26115 msgstr ""
26116
26117 #. type: verbatim
26118 #: ../fish/guestfish-actions.pod:1295
26119 #, no-wrap
26120 msgid ""
26121 " get-attach-method\n"
26122 "\n"
26123 msgstr ""
26124
26125 #. type: textblock
26126 #: ../fish/guestfish-actions.pod:1297
26127 msgid "Return the current attach method.  See L</set-attach-method>."
26128 msgstr ""
26129
26130 # type: =head2
26131 #. type: =head2
26132 #: ../fish/guestfish-actions.pod:1299
26133 msgid "get-autosync"
26134 msgstr ""
26135
26136 # type: verbatim
26137 #. type: verbatim
26138 #: ../fish/guestfish-actions.pod:1301
26139 #, no-wrap
26140 msgid ""
26141 " get-autosync\n"
26142 "\n"
26143 msgstr ""
26144
26145 # type: =head2
26146 #. type: =head2
26147 #: ../fish/guestfish-actions.pod:1305
26148 msgid "get-direct"
26149 msgstr ""
26150
26151 # type: verbatim
26152 #. type: verbatim
26153 #: ../fish/guestfish-actions.pod:1307
26154 #, no-wrap
26155 msgid ""
26156 " get-direct\n"
26157 "\n"
26158 msgstr ""
26159
26160 # type: =head2
26161 #. type: =head2
26162 #: ../fish/guestfish-actions.pod:1311
26163 msgid "get-e2label"
26164 msgstr ""
26165
26166 # type: verbatim
26167 #. type: verbatim
26168 #: ../fish/guestfish-actions.pod:1313
26169 #, no-wrap
26170 msgid ""
26171 " get-e2label device\n"
26172 "\n"
26173 msgstr ""
26174
26175 # type: =head2
26176 #. type: =head2
26177 #: ../fish/guestfish-actions.pod:1325
26178 msgid "get-e2uuid"
26179 msgstr ""
26180
26181 # type: verbatim
26182 #. type: verbatim
26183 #: ../fish/guestfish-actions.pod:1327
26184 #, no-wrap
26185 msgid ""
26186 " get-e2uuid device\n"
26187 "\n"
26188 msgstr ""
26189
26190 # type: =head2
26191 #. type: =head2
26192 #: ../fish/guestfish-actions.pod:1339
26193 msgid "get-memsize"
26194 msgstr ""
26195
26196 # type: verbatim
26197 #. type: verbatim
26198 #: ../fish/guestfish-actions.pod:1341
26199 #, no-wrap
26200 msgid ""
26201 " get-memsize\n"
26202 "\n"
26203 msgstr ""
26204
26205 # type: textblock
26206 #. type: textblock
26207 #: ../fish/guestfish-actions.pod:1346
26208 msgid ""
26209 "If L</set-memsize> was not called on this handle, and if "
26210 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
26211 "value for memsize."
26212 msgstr ""
26213
26214 # type: =head2
26215 #. type: =head2
26216 #: ../fish/guestfish-actions.pod:1353
26217 msgid "get-network"
26218 msgstr ""
26219
26220 # type: verbatim
26221 #. type: verbatim
26222 #: ../fish/guestfish-actions.pod:1355
26223 #, no-wrap
26224 msgid ""
26225 " get-network\n"
26226 "\n"
26227 msgstr ""
26228
26229 # type: =head2
26230 #. type: =head2
26231 #: ../fish/guestfish-actions.pod:1359
26232 msgid "get-path"
26233 msgstr ""
26234
26235 # type: verbatim
26236 #. type: verbatim
26237 #: ../fish/guestfish-actions.pod:1361
26238 #, no-wrap
26239 msgid ""
26240 " get-path\n"
26241 "\n"
26242 msgstr ""
26243
26244 # type: =head2
26245 #. type: =head2
26246 #: ../fish/guestfish-actions.pod:1368
26247 msgid "get-pid"
26248 msgstr ""
26249
26250 # type: =head2
26251 #. type: =head2
26252 #: ../fish/guestfish-actions.pod:1370
26253 msgid "pid"
26254 msgstr ""
26255
26256 # type: verbatim
26257 #. type: verbatim
26258 #: ../fish/guestfish-actions.pod:1372
26259 #, no-wrap
26260 msgid ""
26261 " get-pid\n"
26262 "\n"
26263 msgstr ""
26264
26265 # type: =head2
26266 #. type: =head2
26267 #: ../fish/guestfish-actions.pod:1379
26268 msgid "get-qemu"
26269 msgstr ""
26270
26271 # type: verbatim
26272 #. type: verbatim
26273 #: ../fish/guestfish-actions.pod:1381
26274 #, no-wrap
26275 msgid ""
26276 " get-qemu\n"
26277 "\n"
26278 msgstr ""
26279
26280 # type: =head2
26281 #. type: =head2
26282 #: ../fish/guestfish-actions.pod:1388
26283 msgid "get-recovery-proc"
26284 msgstr ""
26285
26286 # type: verbatim
26287 #. type: verbatim
26288 #: ../fish/guestfish-actions.pod:1390
26289 #, no-wrap
26290 msgid ""
26291 " get-recovery-proc\n"
26292 "\n"
26293 msgstr ""
26294
26295 # type: =head2
26296 #. type: =head2
26297 #: ../fish/guestfish-actions.pod:1394
26298 msgid "get-selinux"
26299 msgstr ""
26300
26301 # type: verbatim
26302 #. type: verbatim
26303 #: ../fish/guestfish-actions.pod:1396
26304 #, no-wrap
26305 msgid ""
26306 " get-selinux\n"
26307 "\n"
26308 msgstr ""
26309
26310 # type: textblock
26311 #. type: textblock
26312 #: ../fish/guestfish-actions.pod:1398
26313 msgid ""
26314 "This returns the current setting of the selinux flag which is passed to the "
26315 "appliance at boot time.  See L</set-selinux>."
26316 msgstr ""
26317
26318 # type: =head2
26319 #. type: =head2
26320 #: ../fish/guestfish-actions.pod:1404
26321 msgid "get-state"
26322 msgstr ""
26323
26324 # type: verbatim
26325 #. type: verbatim
26326 #: ../fish/guestfish-actions.pod:1406
26327 #, no-wrap
26328 msgid ""
26329 " get-state\n"
26330 "\n"
26331 msgstr ""
26332
26333 # type: =head2
26334 #. type: =head2
26335 #: ../fish/guestfish-actions.pod:1413
26336 msgid "get-trace"
26337 msgstr ""
26338
26339 # type: verbatim
26340 #. type: verbatim
26341 #: ../fish/guestfish-actions.pod:1415
26342 #, no-wrap
26343 msgid ""
26344 " get-trace\n"
26345 "\n"
26346 msgstr ""
26347
26348 # type: =head2
26349 #. type: =head2
26350 #: ../fish/guestfish-actions.pod:1419
26351 msgid "get-umask"
26352 msgstr ""
26353
26354 # type: verbatim
26355 #. type: verbatim
26356 #: ../fish/guestfish-actions.pod:1421
26357 #, no-wrap
26358 msgid ""
26359 " get-umask\n"
26360 "\n"
26361 msgstr ""
26362
26363 # type: textblock
26364 #. type: textblock
26365 #: ../fish/guestfish-actions.pod:1423
26366 msgid ""
26367 "Return the current umask.  By default the umask is C<022> unless it has been "
26368 "set by calling L</umask>."
26369 msgstr ""
26370
26371 # type: =head2
26372 #. type: =head2
26373 #: ../fish/guestfish-actions.pod:1426
26374 msgid "get-verbose"
26375 msgstr ""
26376
26377 # type: verbatim
26378 #. type: verbatim
26379 #: ../fish/guestfish-actions.pod:1428
26380 #, no-wrap
26381 msgid ""
26382 " get-verbose\n"
26383 "\n"
26384 msgstr ""
26385
26386 # type: =head2
26387 #. type: =head2
26388 #: ../fish/guestfish-actions.pod:1432
26389 msgid "getcon"
26390 msgstr ""
26391
26392 # type: verbatim
26393 #. type: verbatim
26394 #: ../fish/guestfish-actions.pod:1434
26395 #, no-wrap
26396 msgid ""
26397 " getcon\n"
26398 "\n"
26399 msgstr ""
26400
26401 # type: textblock
26402 #. type: textblock
26403 #: ../fish/guestfish-actions.pod:1438
26404 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
26405 msgstr ""
26406
26407 # type: =head2
26408 #. type: =head2
26409 #: ../fish/guestfish-actions.pod:1441
26410 msgid "getxattr"
26411 msgstr ""
26412
26413 # type: verbatim
26414 #. type: verbatim
26415 #: ../fish/guestfish-actions.pod:1443
26416 #, no-wrap
26417 msgid ""
26418 " getxattr path name\n"
26419 "\n"
26420 msgstr ""
26421
26422 # type: textblock
26423 #. type: textblock
26424 #: ../fish/guestfish-actions.pod:1445
26425 msgid ""
26426 "Get a single extended attribute from file C<path> named C<name>.  This call "
26427 "follows symlinks.  If you want to lookup an extended attribute for the "
26428 "symlink itself, use L</lgetxattr>."
26429 msgstr ""
26430
26431 # type: textblock
26432 #. type: textblock
26433 #: ../fish/guestfish-actions.pod:1449 ../fish/guestfish-actions.pod:2470
26434 msgid ""
26435 "Normally it is better to get all extended attributes from a file in one go "
26436 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
26437 "buggy and do not provide a way to list out attributes.  For these "
26438 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
26439 "attributes you want in advance and call this function."
26440 msgstr ""
26441
26442 # type: textblock
26443 #. type: textblock
26444 #: ../fish/guestfish-actions.pod:1459
26445 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
26446 msgstr ""
26447
26448 # type: =head2
26449 #. type: =head2
26450 #: ../fish/guestfish-actions.pod:1461
26451 msgid "getxattrs"
26452 msgstr ""
26453
26454 # type: verbatim
26455 #. type: verbatim
26456 #: ../fish/guestfish-actions.pod:1463
26457 #, no-wrap
26458 msgid ""
26459 " getxattrs path\n"
26460 "\n"
26461 msgstr ""
26462
26463 # type: textblock
26464 #. type: textblock
26465 #: ../fish/guestfish-actions.pod:1471
26466 msgid "See also: L</lgetxattrs>, L<attr(5)>."
26467 msgstr ""
26468
26469 # type: =head2
26470 #. type: =head2
26471 #: ../fish/guestfish-actions.pod:1473
26472 msgid "glob-expand"
26473 msgstr ""
26474
26475 # type: verbatim
26476 #. type: verbatim
26477 #: ../fish/guestfish-actions.pod:1475
26478 #, no-wrap
26479 msgid ""
26480 " glob-expand pattern\n"
26481 "\n"
26482 msgstr ""
26483
26484 # type: =head2
26485 #. type: =head2
26486 #: ../fish/guestfish-actions.pod:1488
26487 msgid "grep"
26488 msgstr ""
26489
26490 # type: verbatim
26491 #. type: verbatim
26492 #: ../fish/guestfish-actions.pod:1490
26493 #, no-wrap
26494 msgid ""
26495 " grep regex path\n"
26496 "\n"
26497 msgstr ""
26498
26499 # type: =head2
26500 #. type: =head2
26501 #: ../fish/guestfish-actions.pod:1498
26502 msgid "grepi"
26503 msgstr ""
26504
26505 # type: verbatim
26506 #. type: verbatim
26507 #: ../fish/guestfish-actions.pod:1500
26508 #, no-wrap
26509 msgid ""
26510 " grepi regex path\n"
26511 "\n"
26512 msgstr ""
26513
26514 # type: =head2
26515 #. type: =head2
26516 #: ../fish/guestfish-actions.pod:1508
26517 msgid "grub-install"
26518 msgstr ""
26519
26520 # type: verbatim
26521 #. type: verbatim
26522 #: ../fish/guestfish-actions.pod:1510
26523 #, no-wrap
26524 msgid ""
26525 " grub-install root device\n"
26526 "\n"
26527 msgstr ""
26528
26529 # type: =head2
26530 #. type: =head2
26531 #: ../fish/guestfish-actions.pod:1526
26532 msgid "head"
26533 msgstr ""
26534
26535 # type: verbatim
26536 #. type: verbatim
26537 #: ../fish/guestfish-actions.pod:1528
26538 #, no-wrap
26539 msgid ""
26540 " head path\n"
26541 "\n"
26542 msgstr ""
26543
26544 # type: =head2
26545 #. type: =head2
26546 #: ../fish/guestfish-actions.pod:1536
26547 msgid "head-n"
26548 msgstr ""
26549
26550 # type: verbatim
26551 #. type: verbatim
26552 #: ../fish/guestfish-actions.pod:1538
26553 #, no-wrap
26554 msgid ""
26555 " head-n nrlines path\n"
26556 "\n"
26557 msgstr ""
26558
26559 # type: =head2
26560 #. type: =head2
26561 #: ../fish/guestfish-actions.pod:1551
26562 msgid "hexdump"
26563 msgstr ""
26564
26565 # type: verbatim
26566 #. type: verbatim
26567 #: ../fish/guestfish-actions.pod:1553
26568 #, no-wrap
26569 msgid ""
26570 " hexdump path\n"
26571 "\n"
26572 msgstr ""
26573
26574 # type: =head2
26575 #. type: =head2
26576 #: ../fish/guestfish-actions.pod:1561
26577 msgid "initrd-cat"
26578 msgstr ""
26579
26580 # type: verbatim
26581 #. type: verbatim
26582 #: ../fish/guestfish-actions.pod:1563
26583 #, no-wrap
26584 msgid ""
26585 " initrd-cat initrdpath filename\n"
26586 "\n"
26587 msgstr ""
26588
26589 # type: textblock
26590 #. type: textblock
26591 #: ../fish/guestfish-actions.pod:1575
26592 msgid "See also L</initrd-list>."
26593 msgstr ""
26594
26595 # type: =head2
26596 #. type: =head2
26597 #: ../fish/guestfish-actions.pod:1580
26598 msgid "initrd-list"
26599 msgstr ""
26600
26601 # type: verbatim
26602 #. type: verbatim
26603 #: ../fish/guestfish-actions.pod:1582
26604 #, no-wrap
26605 msgid ""
26606 " initrd-list path\n"
26607 "\n"
26608 msgstr ""
26609
26610 # type: =head2
26611 #. type: =head2
26612 #: ../fish/guestfish-actions.pod:1594
26613 msgid "inotify-add-watch"
26614 msgstr ""
26615
26616 # type: verbatim
26617 #. type: verbatim
26618 #: ../fish/guestfish-actions.pod:1596
26619 #, no-wrap
26620 msgid ""
26621 " inotify-add-watch path mask\n"
26622 "\n"
26623 msgstr ""
26624
26625 # type: =head2
26626 #. type: =head2
26627 #: ../fish/guestfish-actions.pod:1608
26628 msgid "inotify-close"
26629 msgstr ""
26630
26631 # type: verbatim
26632 #. type: verbatim
26633 #: ../fish/guestfish-actions.pod:1610
26634 #, no-wrap
26635 msgid ""
26636 " inotify-close\n"
26637 "\n"
26638 msgstr ""
26639
26640 # type: =head2
26641 #. type: =head2
26642 #: ../fish/guestfish-actions.pod:1616
26643 msgid "inotify-files"
26644 msgstr ""
26645
26646 # type: verbatim
26647 #. type: verbatim
26648 #: ../fish/guestfish-actions.pod:1618
26649 #, no-wrap
26650 msgid ""
26651 " inotify-files\n"
26652 "\n"
26653 msgstr ""
26654
26655 # type: textblock
26656 #. type: textblock
26657 #: ../fish/guestfish-actions.pod:1620
26658 msgid ""
26659 "This function is a helpful wrapper around L</inotify-read> which just "
26660 "returns a list of pathnames of objects that were touched.  The returned "
26661 "pathnames are sorted and deduplicated."
26662 msgstr ""
26663
26664 # type: =head2
26665 #. type: =head2
26666 #: ../fish/guestfish-actions.pod:1624
26667 msgid "inotify-init"
26668 msgstr ""
26669
26670 # type: verbatim
26671 #. type: verbatim
26672 #: ../fish/guestfish-actions.pod:1626
26673 #, no-wrap
26674 msgid ""
26675 " inotify-init maxevents\n"
26676 "\n"
26677 msgstr ""
26678
26679 # type: textblock
26680 #. type: textblock
26681 #: ../fish/guestfish-actions.pod:1632
26682 msgid ""
26683 "C<maxevents> is the maximum number of events which will be queued up between "
26684 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
26685 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
26686 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
26687 "but records the fact that it threw them away by setting a flag "
26688 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
26689 msgstr ""
26690
26691 # type: textblock
26692 #. type: textblock
26693 #: ../fish/guestfish-actions.pod:1642
26694 msgid ""
26695 "Before any events are generated, you have to add some watches to the "
26696 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
26697 "L</inotify-watch-all>."
26698 msgstr ""
26699
26700 # type: textblock
26701 #. type: textblock
26702 #: ../fish/guestfish-actions.pod:1648
26703 msgid ""
26704 "Queued up events should be read periodically by calling L</inotify-read> (or "
26705 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
26706 "If you don't read the events out often enough then you risk the internal "
26707 "queue overflowing."
26708 msgstr ""
26709
26710 # type: textblock
26711 #. type: textblock
26712 #: ../fish/guestfish-actions.pod:1655
26713 msgid ""
26714 "The handle should be closed after use by calling L</inotify-close>.  This "
26715 "also removes any watches automatically."
26716 msgstr ""
26717
26718 # type: =head2
26719 #. type: =head2
26720 #: ../fish/guestfish-actions.pod:1664
26721 msgid "inotify-read"
26722 msgstr ""
26723
26724 # type: verbatim
26725 #. type: verbatim
26726 #: ../fish/guestfish-actions.pod:1666
26727 #, no-wrap
26728 msgid ""
26729 " inotify-read\n"
26730 "\n"
26731 msgstr ""
26732
26733 # type: =head2
26734 #. type: =head2
26735 #: ../fish/guestfish-actions.pod:1679
26736 msgid "inotify-rm-watch"
26737 msgstr ""
26738
26739 # type: verbatim
26740 #. type: verbatim
26741 #: ../fish/guestfish-actions.pod:1681
26742 #, no-wrap
26743 msgid ""
26744 " inotify-rm-watch wd\n"
26745 "\n"
26746 msgstr ""
26747
26748 # type: textblock
26749 #. type: textblock
26750 #: ../fish/guestfish-actions.pod:1683
26751 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
26752 msgstr ""
26753
26754 # type: =head2
26755 #. type: =head2
26756 #: ../fish/guestfish-actions.pod:1686
26757 msgid "inspect-get-arch"
26758 msgstr ""
26759
26760 # type: verbatim
26761 #. type: verbatim
26762 #: ../fish/guestfish-actions.pod:1688
26763 #, no-wrap
26764 msgid ""
26765 " inspect-get-arch root\n"
26766 "\n"
26767 msgstr ""
26768
26769 # type: textblock
26770 #. type: textblock
26771 #: ../fish/guestfish-actions.pod:1690 ../fish/guestfish-actions.pod:1706
26772 #: ../fish/guestfish-actions.pod:1792 ../fish/guestfish-actions.pod:1828
26773 #: ../fish/guestfish-actions.pod:1846 ../fish/guestfish-actions.pod:1880
26774 #: ../fish/guestfish-actions.pod:1895 ../fish/guestfish-actions.pod:1916
26775 #: ../fish/guestfish-actions.pod:1931 ../fish/guestfish-actions.pod:1964
26776 #: ../fish/guestfish-actions.pod:1986 ../fish/guestfish-actions.pod:2010
26777 #: ../fish/guestfish-actions.pod:2027 ../fish/guestfish-actions.pod:2070
26778 #: ../fish/guestfish-actions.pod:2105 ../fish/guestfish-actions.pod:2121
26779 #: ../fish/guestfish-actions.pod:2137 ../fish/guestfish-actions.pod:2150
26780 #: ../fish/guestfish-actions.pod:2163 ../fish/guestfish-actions.pod:2178
26781 msgid ""
26782 "This function should only be called with a root device string as returned by "
26783 "L</inspect-os>."
26784 msgstr ""
26785
26786 # type: textblock
26787 #. type: textblock
26788 #: ../fish/guestfish-actions.pod:1693
26789 msgid ""
26790 "This returns the architecture of the inspected operating system.  The "
26791 "possible return values are listed under L</file-architecture>."
26792 msgstr ""
26793
26794 # type: =head2
26795 #. type: =head2
26796 #: ../fish/guestfish-actions.pod:1702
26797 msgid "inspect-get-distro"
26798 msgstr ""
26799
26800 # type: verbatim
26801 #. type: verbatim
26802 #: ../fish/guestfish-actions.pod:1704
26803 #, no-wrap
26804 msgid ""
26805 " inspect-get-distro root\n"
26806 "\n"
26807 msgstr ""
26808
26809 #. type: =head2
26810 #: ../fish/guestfish-actions.pod:1788
26811 msgid "inspect-get-drive-mappings"
26812 msgstr ""
26813
26814 #. type: verbatim
26815 #: ../fish/guestfish-actions.pod:1790
26816 #, no-wrap
26817 msgid ""
26818 " inspect-get-drive-mappings root\n"
26819 "\n"
26820 msgstr ""
26821
26822 #. type: textblock
26823 #: ../fish/guestfish-actions.pod:1820
26824 msgid ""
26825 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26826 "get-mountpoints>, L</inspect-get-filesystems>."
26827 msgstr ""
26828
26829 # type: =head2
26830 #. type: =head2
26831 #: ../fish/guestfish-actions.pod:1824
26832 msgid "inspect-get-filesystems"
26833 msgstr ""
26834
26835 # type: verbatim
26836 #. type: verbatim
26837 #: ../fish/guestfish-actions.pod:1826
26838 #, no-wrap
26839 msgid ""
26840 " inspect-get-filesystems root\n"
26841 "\n"
26842 msgstr ""
26843
26844 # type: textblock
26845 #. type: textblock
26846 #: ../fish/guestfish-actions.pod:1839
26847 msgid ""
26848 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26849 "get-mountpoints>."
26850 msgstr ""
26851
26852 #. type: =head2
26853 #: ../fish/guestfish-actions.pod:1842
26854 msgid "inspect-get-format"
26855 msgstr ""
26856
26857 #. type: verbatim
26858 #: ../fish/guestfish-actions.pod:1844
26859 #, no-wrap
26860 msgid ""
26861 " inspect-get-format root\n"
26862 "\n"
26863 msgstr ""
26864
26865 # type: =head2
26866 #. type: =head2
26867 #: ../fish/guestfish-actions.pod:1876
26868 msgid "inspect-get-hostname"
26869 msgstr ""
26870
26871 # type: verbatim
26872 #. type: verbatim
26873 #: ../fish/guestfish-actions.pod:1878
26874 #, no-wrap
26875 msgid ""
26876 " inspect-get-hostname root\n"
26877 "\n"
26878 msgstr ""
26879
26880 # type: =head2
26881 #. type: =head2
26882 #: ../fish/guestfish-actions.pod:1891
26883 msgid "inspect-get-major-version"
26884 msgstr ""
26885
26886 # type: verbatim
26887 #. type: verbatim
26888 #: ../fish/guestfish-actions.pod:1893
26889 #, no-wrap
26890 msgid ""
26891 " inspect-get-major-version root\n"
26892 "\n"
26893 msgstr ""
26894
26895 # type: =head2
26896 #. type: =head2
26897 #: ../fish/guestfish-actions.pod:1912
26898 msgid "inspect-get-minor-version"
26899 msgstr ""
26900
26901 # type: verbatim
26902 #. type: verbatim
26903 #: ../fish/guestfish-actions.pod:1914
26904 #, no-wrap
26905 msgid ""
26906 " inspect-get-minor-version root\n"
26907 "\n"
26908 msgstr ""
26909
26910 # type: textblock
26911 #. type: textblock
26912 #: ../fish/guestfish-actions.pod:1924
26913 msgid ""
26914 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26915 "get-major-version>."
26916 msgstr ""
26917
26918 # type: =head2
26919 #. type: =head2
26920 #: ../fish/guestfish-actions.pod:1927
26921 msgid "inspect-get-mountpoints"
26922 msgstr ""
26923
26924 # type: verbatim
26925 #. type: verbatim
26926 #: ../fish/guestfish-actions.pod:1929
26927 #, no-wrap
26928 msgid ""
26929 " inspect-get-mountpoints root\n"
26930 "\n"
26931 msgstr ""
26932
26933 #. type: textblock
26934 #: ../fish/guestfish-actions.pod:1951
26935 msgid ""
26936 "For operating systems like Windows which still use drive letters, this call "
26937 "will only return an entry for the first drive \"mounted on\" C</>.  For "
26938 "information about the mapping of drive letters to partitions, see L</inspect-"
26939 "get-drive-mappings>."
26940 msgstr ""
26941
26942 # type: textblock
26943 #. type: textblock
26944 #: ../fish/guestfish-actions.pod:1957
26945 msgid ""
26946 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26947 "get-filesystems>."
26948 msgstr ""
26949
26950 # type: =head2
26951 #. type: =head2
26952 #: ../fish/guestfish-actions.pod:1960
26953 msgid "inspect-get-package-format"
26954 msgstr ""
26955
26956 # type: verbatim
26957 #. type: verbatim
26958 #: ../fish/guestfish-actions.pod:1962
26959 #, no-wrap
26960 msgid ""
26961 " inspect-get-package-format root\n"
26962 "\n"
26963 msgstr ""
26964
26965 # type: textblock
26966 #. type: textblock
26967 #: ../fish/guestfish-actions.pod:1967
26968 msgid ""
26969 "This function and L</inspect-get-package-management> return the package "
26970 "format and package management tool used by the inspected operating system.  "
26971 "For example for Fedora these functions would return C<rpm> (package format) "
26972 "and C<yum> (package management)."
26973 msgstr ""
26974
26975 # type: =head2
26976 #. type: =head2
26977 #: ../fish/guestfish-actions.pod:1982
26978 msgid "inspect-get-package-management"
26979 msgstr ""
26980
26981 # type: verbatim
26982 #. type: verbatim
26983 #: ../fish/guestfish-actions.pod:1984
26984 #, no-wrap
26985 msgid ""
26986 " inspect-get-package-management root\n"
26987 "\n"
26988 msgstr ""
26989
26990 # type: textblock
26991 #. type: textblock
26992 #: ../fish/guestfish-actions.pod:1989
26993 msgid ""
26994 "L</inspect-get-package-format> and this function return the package format "
26995 "and package management tool used by the inspected operating system.  For "
26996 "example for Fedora these functions would return C<rpm> (package format) and "
26997 "C<yum> (package management)."
26998 msgstr ""
26999
27000 # type: =head2
27001 #. type: =head2
27002 #: ../fish/guestfish-actions.pod:2006
27003 msgid "inspect-get-product-name"
27004 msgstr ""
27005
27006 # type: verbatim
27007 #. type: verbatim
27008 #: ../fish/guestfish-actions.pod:2008
27009 #, no-wrap
27010 msgid ""
27011 " inspect-get-product-name root\n"
27012 "\n"
27013 msgstr ""
27014
27015 #. type: =head2
27016 #: ../fish/guestfish-actions.pod:2023
27017 msgid "inspect-get-product-variant"
27018 msgstr ""
27019
27020 #. type: verbatim
27021 #: ../fish/guestfish-actions.pod:2025
27022 #, no-wrap
27023 msgid ""
27024 " inspect-get-product-variant root\n"
27025 "\n"
27026 msgstr ""
27027
27028 #. type: textblock
27029 #: ../fish/guestfish-actions.pod:2049
27030 msgid ""
27031 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
27032 "get-product-name>, L</inspect-get-major-version>."
27033 msgstr ""
27034
27035 # type: =head2
27036 #. type: =head2
27037 #: ../fish/guestfish-actions.pod:2053
27038 msgid "inspect-get-roots"
27039 msgstr ""
27040
27041 # type: verbatim
27042 #. type: verbatim
27043 #: ../fish/guestfish-actions.pod:2055
27044 #, no-wrap
27045 msgid ""
27046 " inspect-get-roots\n"
27047 "\n"
27048 msgstr ""
27049
27050 # type: textblock
27051 #. type: textblock
27052 #: ../fish/guestfish-actions.pod:2057
27053 msgid ""
27054 "This function is a convenient way to get the list of root devices, as "
27055 "returned from a previous call to L</inspect-os>, but without redoing the "
27056 "whole inspection process."
27057 msgstr ""
27058
27059 # type: textblock
27060 #. type: textblock
27061 #: ../fish/guestfish-actions.pod:2061
27062 msgid ""
27063 "This returns an empty list if either no root devices were found or the "
27064 "caller has not called L</inspect-os>."
27065 msgstr ""
27066
27067 # type: =head2
27068 #. type: =head2
27069 #: ../fish/guestfish-actions.pod:2066
27070 msgid "inspect-get-type"
27071 msgstr ""
27072
27073 # type: verbatim
27074 #. type: verbatim
27075 #: ../fish/guestfish-actions.pod:2068
27076 #, no-wrap
27077 msgid ""
27078 " inspect-get-type root\n"
27079 "\n"
27080 msgstr ""
27081
27082 #. type: =head2
27083 #: ../fish/guestfish-actions.pod:2101
27084 msgid "inspect-get-windows-current-control-set"
27085 msgstr ""
27086
27087 #. type: verbatim
27088 #: ../fish/guestfish-actions.pod:2103
27089 #, no-wrap
27090 msgid ""
27091 " inspect-get-windows-current-control-set root\n"
27092 "\n"
27093 msgstr ""
27094
27095 # type: =head2
27096 #. type: =head2
27097 #: ../fish/guestfish-actions.pod:2117
27098 msgid "inspect-get-windows-systemroot"
27099 msgstr ""
27100
27101 # type: verbatim
27102 #. type: verbatim
27103 #: ../fish/guestfish-actions.pod:2119
27104 #, no-wrap
27105 msgid ""
27106 " inspect-get-windows-systemroot root\n"
27107 "\n"
27108 msgstr ""
27109
27110 #. type: =head2
27111 #: ../fish/guestfish-actions.pod:2133
27112 msgid "inspect-is-live"
27113 msgstr ""
27114
27115 #. type: verbatim
27116 #: ../fish/guestfish-actions.pod:2135
27117 #, no-wrap
27118 msgid ""
27119 " inspect-is-live root\n"
27120 "\n"
27121 msgstr ""
27122
27123 #. type: textblock
27124 #: ../fish/guestfish-actions.pod:2140
27125 msgid ""
27126 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27127 "then this returns true if a live image was detected on the disk."
27128 msgstr ""
27129
27130 #. type: =head2
27131 #: ../fish/guestfish-actions.pod:2146
27132 msgid "inspect-is-multipart"
27133 msgstr ""
27134
27135 #. type: verbatim
27136 #: ../fish/guestfish-actions.pod:2148
27137 #, no-wrap
27138 msgid ""
27139 " inspect-is-multipart root\n"
27140 "\n"
27141 msgstr ""
27142
27143 #. type: textblock
27144 #: ../fish/guestfish-actions.pod:2153
27145 msgid ""
27146 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27147 "then this returns true if the disk is part of a set."
27148 msgstr ""
27149
27150 #. type: =head2
27151 #: ../fish/guestfish-actions.pod:2159
27152 msgid "inspect-is-netinst"
27153 msgstr ""
27154
27155 #. type: verbatim
27156 #: ../fish/guestfish-actions.pod:2161
27157 #, no-wrap
27158 msgid ""
27159 " inspect-is-netinst root\n"
27160 "\n"
27161 msgstr ""
27162
27163 #. type: textblock
27164 #: ../fish/guestfish-actions.pod:2166
27165 msgid ""
27166 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27167 "then this returns true if the disk is a network installer, ie. not a self-"
27168 "contained install CD but one which is likely to require network access to "
27169 "complete the install."
27170 msgstr ""
27171
27172 # type: =head2
27173 #. type: =head2
27174 #: ../fish/guestfish-actions.pod:2174
27175 msgid "inspect-list-applications"
27176 msgstr ""
27177
27178 # type: verbatim
27179 #. type: verbatim
27180 #: ../fish/guestfish-actions.pod:2176
27181 #, no-wrap
27182 msgid ""
27183 " inspect-list-applications root\n"
27184 "\n"
27185 msgstr ""
27186
27187 # type: textblock
27188 #. type: textblock
27189 #: ../fish/guestfish-actions.pod:2183
27190 msgid ""
27191 "I<Note:> This call works differently from other parts of the inspection "
27192 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
27193 "then mount up the disks, before calling this.  Listing applications is a "
27194 "significantly more difficult operation which requires access to the full "
27195 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
27196 "are just returning data cached in the libguestfs handle, this call actually "
27197 "reads parts of the mounted filesystems during the call."
27198 msgstr ""
27199
27200 # type: =head2
27201 #. type: =head2
27202 #: ../fish/guestfish-actions.pod:2273
27203 msgid "inspect-os"
27204 msgstr ""
27205
27206 # type: verbatim
27207 #. type: verbatim
27208 #: ../fish/guestfish-actions.pod:2275
27209 #, no-wrap
27210 msgid ""
27211 " inspect-os\n"
27212 "\n"
27213 msgstr ""
27214
27215 # type: textblock
27216 #. type: textblock
27217 #: ../fish/guestfish-actions.pod:2290
27218 msgid ""
27219 "You can pass the root string(s) returned to other L</inspect-get-*> "
27220 "functions in order to query further information about each operating system, "
27221 "such as the name and version."
27222 msgstr ""
27223
27224 # type: textblock
27225 #. type: textblock
27226 #: ../fish/guestfish-actions.pod:2295
27227 msgid ""
27228 "This function uses other libguestfs features such as L</mount-ro> and L</"
27229 "umount-all> in order to mount and unmount filesystems and look at the "
27230 "contents.  This should be called with no disks currently mounted.  The "
27231 "function may also use Augeas, so any existing Augeas handle will be closed."
27232 msgstr ""
27233
27234 # type: textblock
27235 #. type: textblock
27236 #: ../fish/guestfish-actions.pod:2307 ../fish/guestfish-actions.pod:2498
27237 #: ../fish/guestfish-actions.pod:2544
27238 msgid "See also L</list-filesystems>."
27239 msgstr ""
27240
27241 # type: =head2
27242 #. type: =head2
27243 #: ../fish/guestfish-actions.pod:2309
27244 msgid "is-blockdev"
27245 msgstr ""
27246
27247 # type: verbatim
27248 #. type: verbatim
27249 #: ../fish/guestfish-actions.pod:2311
27250 #, no-wrap
27251 msgid ""
27252 " is-blockdev path\n"
27253 "\n"
27254 msgstr ""
27255
27256 # type: textblock
27257 #. type: textblock
27258 #: ../fish/guestfish-actions.pod:2316 ../fish/guestfish-actions.pod:2334
27259 #: ../fish/guestfish-actions.pod:2353 ../fish/guestfish-actions.pod:2362
27260 #: ../fish/guestfish-actions.pod:2372 ../fish/guestfish-actions.pod:2406
27261 #: ../fish/guestfish-actions.pod:2415
27262 msgid "See also L</stat>."
27263 msgstr ""
27264
27265 # type: =head2
27266 #. type: =head2
27267 #: ../fish/guestfish-actions.pod:2318
27268 msgid "is-busy"
27269 msgstr ""
27270
27271 # type: verbatim
27272 #. type: verbatim
27273 #: ../fish/guestfish-actions.pod:2320
27274 #, no-wrap
27275 msgid ""
27276 " is-busy\n"
27277 "\n"
27278 msgstr ""
27279
27280 # type: =head2
27281 #. type: =head2
27282 #: ../fish/guestfish-actions.pod:2327
27283 msgid "is-chardev"
27284 msgstr ""
27285
27286 # type: verbatim
27287 #. type: verbatim
27288 #: ../fish/guestfish-actions.pod:2329
27289 #, no-wrap
27290 msgid ""
27291 " is-chardev path\n"
27292 "\n"
27293 msgstr ""
27294
27295 # type: =head2
27296 #. type: =head2
27297 #: ../fish/guestfish-actions.pod:2336
27298 msgid "is-config"
27299 msgstr ""
27300
27301 # type: verbatim
27302 #. type: verbatim
27303 #: ../fish/guestfish-actions.pod:2338
27304 #, no-wrap
27305 msgid ""
27306 " is-config\n"
27307 "\n"
27308 msgstr ""
27309
27310 # type: =head2
27311 #. type: =head2
27312 #: ../fish/guestfish-actions.pod:2345
27313 msgid "is-dir"
27314 msgstr ""
27315
27316 # type: verbatim
27317 #. type: verbatim
27318 #: ../fish/guestfish-actions.pod:2347
27319 #, no-wrap
27320 msgid ""
27321 " is-dir path\n"
27322 "\n"
27323 msgstr ""
27324
27325 # type: =head2
27326 #. type: =head2
27327 #: ../fish/guestfish-actions.pod:2355
27328 msgid "is-fifo"
27329 msgstr ""
27330
27331 # type: verbatim
27332 #. type: verbatim
27333 #: ../fish/guestfish-actions.pod:2357
27334 #, no-wrap
27335 msgid ""
27336 " is-fifo path\n"
27337 "\n"
27338 msgstr ""
27339
27340 # type: =head2
27341 #. type: =head2
27342 #: ../fish/guestfish-actions.pod:2364
27343 msgid "is-file"
27344 msgstr ""
27345
27346 # type: verbatim
27347 #. type: verbatim
27348 #: ../fish/guestfish-actions.pod:2366
27349 #, no-wrap
27350 msgid ""
27351 " is-file path\n"
27352 "\n"
27353 msgstr ""
27354
27355 # type: =head2
27356 #. type: =head2
27357 #: ../fish/guestfish-actions.pod:2374
27358 msgid "is-launching"
27359 msgstr ""
27360
27361 # type: verbatim
27362 #. type: verbatim
27363 #: ../fish/guestfish-actions.pod:2376
27364 #, no-wrap
27365 msgid ""
27366 " is-launching\n"
27367 "\n"
27368 msgstr ""
27369
27370 # type: =head2
27371 #. type: =head2
27372 #: ../fish/guestfish-actions.pod:2383
27373 msgid "is-lv"
27374 msgstr ""
27375
27376 # type: verbatim
27377 #. type: verbatim
27378 #: ../fish/guestfish-actions.pod:2385
27379 #, no-wrap
27380 msgid ""
27381 " is-lv device\n"
27382 "\n"
27383 msgstr ""
27384
27385 # type: =head2
27386 #. type: =head2
27387 #: ../fish/guestfish-actions.pod:2390
27388 msgid "is-ready"
27389 msgstr ""
27390
27391 # type: verbatim
27392 #. type: verbatim
27393 #: ../fish/guestfish-actions.pod:2392
27394 #, no-wrap
27395 msgid ""
27396 " is-ready\n"
27397 "\n"
27398 msgstr ""
27399
27400 # type: =head2
27401 #. type: =head2
27402 #: ../fish/guestfish-actions.pod:2399
27403 msgid "is-socket"
27404 msgstr ""
27405
27406 # type: verbatim
27407 #. type: verbatim
27408 #: ../fish/guestfish-actions.pod:2401
27409 #, no-wrap
27410 msgid ""
27411 " is-socket path\n"
27412 "\n"
27413 msgstr ""
27414
27415 # type: =head2
27416 #. type: =head2
27417 #: ../fish/guestfish-actions.pod:2408
27418 msgid "is-symlink"
27419 msgstr ""
27420
27421 # type: verbatim
27422 #. type: verbatim
27423 #: ../fish/guestfish-actions.pod:2410
27424 #, no-wrap
27425 msgid ""
27426 " is-symlink path\n"
27427 "\n"
27428 msgstr ""
27429
27430 #. type: =head2
27431 #: ../fish/guestfish-actions.pod:2417
27432 msgid "is-zero"
27433 msgstr ""
27434
27435 #. type: verbatim
27436 #: ../fish/guestfish-actions.pod:2419
27437 #, no-wrap
27438 msgid ""
27439 " is-zero path\n"
27440 "\n"
27441 msgstr ""
27442
27443 #. type: =head2
27444 #: ../fish/guestfish-actions.pod:2424
27445 msgid "is-zero-device"
27446 msgstr ""
27447
27448 #. type: verbatim
27449 #: ../fish/guestfish-actions.pod:2426
27450 #, no-wrap
27451 msgid ""
27452 " is-zero-device device\n"
27453 "\n"
27454 msgstr ""
27455
27456 # type: =head2
27457 #. type: =head2
27458 #: ../fish/guestfish-actions.pod:2432
27459 msgid "kill-subprocess"
27460 msgstr ""
27461
27462 # type: verbatim
27463 #. type: verbatim
27464 #: ../fish/guestfish-actions.pod:2434
27465 #, no-wrap
27466 msgid ""
27467 " kill-subprocess\n"
27468 "\n"
27469 msgstr ""
27470
27471 # type: =head2
27472 #. type: =head2
27473 #: ../fish/guestfish-actions.pod:2438
27474 msgid "launch"
27475 msgstr ""
27476
27477 # type: =head2
27478 #. type: =head2
27479 #: ../fish/guestfish-actions.pod:2440
27480 msgid "run"
27481 msgstr ""
27482
27483 # type: verbatim
27484 #. type: verbatim
27485 #: ../fish/guestfish-actions.pod:2442
27486 #, no-wrap
27487 msgid ""
27488 " launch\n"
27489 "\n"
27490 msgstr ""
27491
27492 # type: =head2
27493 #. type: =head2
27494 #: ../fish/guestfish-actions.pod:2450
27495 msgid "lchown"
27496 msgstr ""
27497
27498 # type: verbatim
27499 #. type: verbatim
27500 #: ../fish/guestfish-actions.pod:2452
27501 #, no-wrap
27502 msgid ""
27503 " lchown owner group path\n"
27504 "\n"
27505 msgstr ""
27506
27507 # type: textblock
27508 #. type: textblock
27509 #: ../fish/guestfish-actions.pod:2454
27510 msgid ""
27511 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
27512 "chown> but if C<path> is a symlink then the link itself is changed, not the "
27513 "target."
27514 msgstr ""
27515
27516 # type: =head2
27517 #. type: =head2
27518 #: ../fish/guestfish-actions.pod:2462
27519 msgid "lgetxattr"
27520 msgstr ""
27521
27522 # type: verbatim
27523 #. type: verbatim
27524 #: ../fish/guestfish-actions.pod:2464
27525 #, no-wrap
27526 msgid ""
27527 " lgetxattr path name\n"
27528 "\n"
27529 msgstr ""
27530
27531 # type: textblock
27532 #. type: textblock
27533 #: ../fish/guestfish-actions.pod:2480
27534 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
27535 msgstr ""
27536
27537 # type: =head2
27538 #. type: =head2
27539 #: ../fish/guestfish-actions.pod:2482
27540 msgid "lgetxattrs"
27541 msgstr ""
27542
27543 # type: verbatim
27544 #. type: verbatim
27545 #: ../fish/guestfish-actions.pod:2484
27546 #, no-wrap
27547 msgid ""
27548 " lgetxattrs path\n"
27549 "\n"
27550 msgstr ""
27551
27552 # type: textblock
27553 #. type: textblock
27554 #: ../fish/guestfish-actions.pod:2486
27555 msgid ""
27556 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
27557 "it returns the extended attributes of the link itself."
27558 msgstr ""
27559
27560 # type: =head2
27561 #. type: =head2
27562 #: ../fish/guestfish-actions.pod:2490
27563 msgid "list-devices"
27564 msgstr ""
27565
27566 # type: verbatim
27567 #. type: verbatim
27568 #: ../fish/guestfish-actions.pod:2492
27569 #, no-wrap
27570 msgid ""
27571 " list-devices\n"
27572 "\n"
27573 msgstr ""
27574
27575 # type: =head2
27576 #. type: =head2
27577 #: ../fish/guestfish-actions.pod:2500
27578 msgid "list-filesystems"
27579 msgstr ""
27580
27581 # type: verbatim
27582 #. type: verbatim
27583 #: ../fish/guestfish-actions.pod:2502
27584 #, no-wrap
27585 msgid ""
27586 " list-filesystems\n"
27587 "\n"
27588 msgstr ""
27589
27590 # type: textblock
27591 #. type: textblock
27592 #: ../fish/guestfish-actions.pod:2521
27593 msgid ""
27594 "This command runs other libguestfs commands, which might include L</mount> "
27595 "and L</umount>, and therefore you should use this soon after launch and only "
27596 "when nothing is mounted."
27597 msgstr ""
27598
27599 # type: textblock
27600 #. type: textblock
27601 #: ../fish/guestfish-actions.pod:2525
27602 msgid ""
27603 "Not all of the filesystems returned will be mountable.  In particular, swap "
27604 "partitions are returned in the list.  Also this command does not check that "
27605 "each filesystem found is valid and mountable, and some filesystems might be "
27606 "mountable but require special options.  Filesystems may not all belong to a "
27607 "single logical operating system (use L</inspect-os> to look for OSes)."
27608 msgstr ""
27609
27610 # type: =head2
27611 #. type: =head2
27612 #: ../fish/guestfish-actions.pod:2533
27613 msgid "list-partitions"
27614 msgstr ""
27615
27616 # type: verbatim
27617 #. type: verbatim
27618 #: ../fish/guestfish-actions.pod:2535
27619 #, no-wrap
27620 msgid ""
27621 " list-partitions\n"
27622 "\n"
27623 msgstr ""
27624
27625 # type: textblock
27626 #. type: textblock
27627 #: ../fish/guestfish-actions.pod:2541
27628 msgid ""
27629 "This does not return logical volumes.  For that you will need to call L</"
27630 "lvs>."
27631 msgstr ""
27632
27633 # type: =head2
27634 #. type: =head2
27635 #: ../fish/guestfish-actions.pod:2546
27636 msgid "ll"
27637 msgstr ""
27638
27639 # type: verbatim
27640 #. type: verbatim
27641 #: ../fish/guestfish-actions.pod:2548
27642 #, no-wrap
27643 msgid ""
27644 " ll directory\n"
27645 "\n"
27646 msgstr ""
27647
27648 # type: =head2
27649 #. type: =head2
27650 #: ../fish/guestfish-actions.pod:2556
27651 msgid "ln"
27652 msgstr ""
27653
27654 # type: verbatim
27655 #. type: verbatim
27656 #: ../fish/guestfish-actions.pod:2558
27657 #, no-wrap
27658 msgid ""
27659 " ln target linkname\n"
27660 "\n"
27661 msgstr ""
27662
27663 # type: =head2
27664 #. type: =head2
27665 #: ../fish/guestfish-actions.pod:2562
27666 msgid "ln-f"
27667 msgstr ""
27668
27669 # type: verbatim
27670 #. type: verbatim
27671 #: ../fish/guestfish-actions.pod:2564
27672 #, no-wrap
27673 msgid ""
27674 " ln-f target linkname\n"
27675 "\n"
27676 msgstr ""
27677
27678 # type: =head2
27679 #. type: =head2
27680 #: ../fish/guestfish-actions.pod:2569
27681 msgid "ln-s"
27682 msgstr ""
27683
27684 # type: verbatim
27685 #. type: verbatim
27686 #: ../fish/guestfish-actions.pod:2571
27687 #, no-wrap
27688 msgid ""
27689 " ln-s target linkname\n"
27690 "\n"
27691 msgstr ""
27692
27693 # type: =head2
27694 #. type: =head2
27695 #: ../fish/guestfish-actions.pod:2575
27696 msgid "ln-sf"
27697 msgstr ""
27698
27699 # type: verbatim
27700 #. type: verbatim
27701 #: ../fish/guestfish-actions.pod:2577
27702 #, no-wrap
27703 msgid ""
27704 " ln-sf target linkname\n"
27705 "\n"
27706 msgstr ""
27707
27708 # type: =head2
27709 #. type: =head2
27710 #: ../fish/guestfish-actions.pod:2582
27711 msgid "lremovexattr"
27712 msgstr ""
27713
27714 # type: verbatim
27715 #. type: verbatim
27716 #: ../fish/guestfish-actions.pod:2584
27717 #, no-wrap
27718 msgid ""
27719 " lremovexattr xattr path\n"
27720 "\n"
27721 msgstr ""
27722
27723 # type: textblock
27724 #. type: textblock
27725 #: ../fish/guestfish-actions.pod:2586
27726 msgid ""
27727 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
27728 "it removes an extended attribute of the link itself."
27729 msgstr ""
27730
27731 # type: =head2
27732 #. type: =head2
27733 #: ../fish/guestfish-actions.pod:2590
27734 msgid "ls"
27735 msgstr ""
27736
27737 # type: verbatim
27738 #. type: verbatim
27739 #: ../fish/guestfish-actions.pod:2592
27740 #, no-wrap
27741 msgid ""
27742 " ls directory\n"
27743 "\n"
27744 msgstr ""
27745
27746 # type: textblock
27747 #. type: textblock
27748 #: ../fish/guestfish-actions.pod:2598
27749 msgid ""
27750 "This command is mostly useful for interactive sessions.  Programs should "
27751 "probably use L</readdir> instead."
27752 msgstr ""
27753
27754 # type: =head2
27755 #. type: =head2
27756 #: ../fish/guestfish-actions.pod:2601
27757 msgid "lsetxattr"
27758 msgstr ""
27759
27760 # type: verbatim
27761 #. type: verbatim
27762 #: ../fish/guestfish-actions.pod:2603
27763 #, no-wrap
27764 msgid ""
27765 " lsetxattr xattr val vallen path\n"
27766 "\n"
27767 msgstr ""
27768
27769 # type: textblock
27770 #. type: textblock
27771 #: ../fish/guestfish-actions.pod:2605
27772 msgid ""
27773 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
27774 "sets an extended attribute of the link itself."
27775 msgstr ""
27776
27777 # type: =head2
27778 #. type: =head2
27779 #: ../fish/guestfish-actions.pod:2609
27780 msgid "lstat"
27781 msgstr ""
27782
27783 # type: verbatim
27784 #. type: verbatim
27785 #: ../fish/guestfish-actions.pod:2611
27786 #, no-wrap
27787 msgid ""
27788 " lstat path\n"
27789 "\n"
27790 msgstr ""
27791
27792 # type: textblock
27793 #. type: textblock
27794 #: ../fish/guestfish-actions.pod:2615
27795 msgid ""
27796 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
27797 "the link is stat-ed, not the file it refers to."
27798 msgstr ""
27799
27800 # type: =head2
27801 #. type: =head2
27802 #: ../fish/guestfish-actions.pod:2621
27803 msgid "lstatlist"
27804 msgstr ""
27805
27806 # type: verbatim
27807 #. type: verbatim
27808 #: ../fish/guestfish-actions.pod:2623
27809 #, no-wrap
27810 msgid ""
27811 " lstatlist path 'names ...'\n"
27812 "\n"
27813 msgstr ""
27814
27815 # type: textblock
27816 #. type: textblock
27817 #: ../fish/guestfish-actions.pod:2625
27818 msgid ""
27819 "This call allows you to perform the L</lstat> operation on multiple files, "
27820 "where all files are in the directory C<path>.  C<names> is the list of files "
27821 "from this directory."
27822 msgstr ""
27823
27824 # type: textblock
27825 #. type: textblock
27826 #: ../fish/guestfish-actions.pod:2634
27827 msgid ""
27828 "This call is intended for programs that want to efficiently list a directory "
27829 "contents without making many round-trips.  See also L</lxattrlist> for a "
27830 "similarly efficient call for getting extended attributes.  Very long "
27831 "directory listings might cause the protocol message size to be exceeded, "
27832 "causing this call to fail.  The caller must split up such requests into "
27833 "smaller groups of names."
27834 msgstr ""
27835
27836 # type: =head2
27837 #. type: =head2
27838 #: ../fish/guestfish-actions.pod:2642
27839 msgid "luks-add-key"
27840 msgstr ""
27841
27842 # type: verbatim
27843 #. type: verbatim
27844 #: ../fish/guestfish-actions.pod:2644
27845 #, no-wrap
27846 msgid ""
27847 " luks-add-key device keyslot\n"
27848 "\n"
27849 msgstr ""
27850
27851 # type: textblock
27852 #. type: textblock
27853 #: ../fish/guestfish-actions.pod:2651
27854 msgid ""
27855 "Note that if C<keyslot> already contains a key, then this command will "
27856 "fail.  You have to use L</luks-kill-slot> first to remove that key."
27857 msgstr ""
27858
27859 # type: textblock
27860 #. type: textblock
27861 #: ../fish/guestfish-actions.pod:2655 ../fish/guestfish-actions.pod:2677
27862 #: ../fish/guestfish-actions.pod:2690 ../fish/guestfish-actions.pod:2704
27863 #: ../fish/guestfish-actions.pod:2727 ../fish/guestfish-actions.pod:2737
27864 msgid ""
27865 "This command has one or more key or passphrase parameters.  Guestfish will "
27866 "prompt for these separately."
27867 msgstr ""
27868
27869 # type: =head2
27870 #. type: =head2
27871 #: ../fish/guestfish-actions.pod:2658
27872 msgid "luks-close"
27873 msgstr ""
27874
27875 # type: verbatim
27876 #. type: verbatim
27877 #: ../fish/guestfish-actions.pod:2660
27878 #, no-wrap
27879 msgid ""
27880 " luks-close device\n"
27881 "\n"
27882 msgstr ""
27883
27884 # type: textblock
27885 #. type: textblock
27886 #: ../fish/guestfish-actions.pod:2662
27887 msgid ""
27888 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
27889 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
27890 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
27891 "block device."
27892 msgstr ""
27893
27894 # type: =head2
27895 #. type: =head2
27896 #: ../fish/guestfish-actions.pod:2668
27897 msgid "luks-format"
27898 msgstr ""
27899
27900 # type: verbatim
27901 #. type: verbatim
27902 #: ../fish/guestfish-actions.pod:2670
27903 #, no-wrap
27904 msgid ""
27905 " luks-format device keyslot\n"
27906 "\n"
27907 msgstr ""
27908
27909 # type: =head2
27910 #. type: =head2
27911 #: ../fish/guestfish-actions.pod:2683
27912 msgid "luks-format-cipher"
27913 msgstr ""
27914
27915 # type: verbatim
27916 #. type: verbatim
27917 #: ../fish/guestfish-actions.pod:2685
27918 #, no-wrap
27919 msgid ""
27920 " luks-format-cipher device keyslot cipher\n"
27921 "\n"
27922 msgstr ""
27923
27924 # type: textblock
27925 #. type: textblock
27926 #: ../fish/guestfish-actions.pod:2687
27927 msgid ""
27928 "This command is the same as L</luks-format> but it also allows you to set "
27929 "the C<cipher> used."
27930 msgstr ""
27931
27932 # type: =head2
27933 #. type: =head2
27934 #: ../fish/guestfish-actions.pod:2696
27935 msgid "luks-kill-slot"
27936 msgstr ""
27937
27938 # type: verbatim
27939 #. type: verbatim
27940 #: ../fish/guestfish-actions.pod:2698
27941 #, no-wrap
27942 msgid ""
27943 " luks-kill-slot device keyslot\n"
27944 "\n"
27945 msgstr ""
27946
27947 # type: =head2
27948 #. type: =head2
27949 #: ../fish/guestfish-actions.pod:2707
27950 msgid "luks-open"
27951 msgstr ""
27952
27953 # type: verbatim
27954 #. type: verbatim
27955 #: ../fish/guestfish-actions.pod:2709
27956 #, no-wrap
27957 msgid ""
27958 " luks-open device mapname\n"
27959 "\n"
27960 msgstr ""
27961
27962 # type: textblock
27963 #. type: textblock
27964 #: ../fish/guestfish-actions.pod:2723
27965 msgid ""
27966 "If this block device contains LVM volume groups, then calling L</vgscan> "
27967 "followed by L</vg-activate-all> will make them visible."
27968 msgstr ""
27969
27970 # type: =head2
27971 #. type: =head2
27972 #: ../fish/guestfish-actions.pod:2730
27973 msgid "luks-open-ro"
27974 msgstr ""
27975
27976 # type: verbatim
27977 #. type: verbatim
27978 #: ../fish/guestfish-actions.pod:2732
27979 #, no-wrap
27980 msgid ""
27981 " luks-open-ro device mapname\n"
27982 "\n"
27983 msgstr ""
27984
27985 # type: textblock
27986 #. type: textblock
27987 #: ../fish/guestfish-actions.pod:2734
27988 msgid ""
27989 "This is the same as L</luks-open> except that a read-only mapping is created."
27990 msgstr ""
27991
27992 # type: =head2
27993 #. type: =head2
27994 #: ../fish/guestfish-actions.pod:2740
27995 msgid "lvcreate"
27996 msgstr ""
27997
27998 # type: verbatim
27999 #. type: verbatim
28000 #: ../fish/guestfish-actions.pod:2742
28001 #, no-wrap
28002 msgid ""
28003 " lvcreate logvol volgroup mbytes\n"
28004 "\n"
28005 msgstr ""
28006
28007 # type: =head2
28008 #. type: =head2
28009 #: ../fish/guestfish-actions.pod:2747
28010 msgid "lvm-canonical-lv-name"
28011 msgstr ""
28012
28013 # type: verbatim
28014 #. type: verbatim
28015 #: ../fish/guestfish-actions.pod:2749
28016 #, no-wrap
28017 msgid ""
28018 " lvm-canonical-lv-name lvname\n"
28019 "\n"
28020 msgstr ""
28021
28022 # type: textblock
28023 #. type: textblock
28024 #: ../fish/guestfish-actions.pod:2758
28025 msgid "See also L</is-lv>."
28026 msgstr ""
28027
28028 # type: =head2
28029 #. type: =head2
28030 #: ../fish/guestfish-actions.pod:2760
28031 msgid "lvm-clear-filter"
28032 msgstr ""
28033
28034 # type: verbatim
28035 #. type: verbatim
28036 #: ../fish/guestfish-actions.pod:2762
28037 #, no-wrap
28038 msgid ""
28039 " lvm-clear-filter\n"
28040 "\n"
28041 msgstr ""
28042
28043 # type: textblock
28044 #. type: textblock
28045 #: ../fish/guestfish-actions.pod:2764
28046 msgid ""
28047 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
28048 "block device."
28049 msgstr ""
28050
28051 # type: =head2
28052 #. type: =head2
28053 #: ../fish/guestfish-actions.pod:2770
28054 msgid "lvm-remove-all"
28055 msgstr ""
28056
28057 # type: verbatim
28058 #. type: verbatim
28059 #: ../fish/guestfish-actions.pod:2772
28060 #, no-wrap
28061 msgid ""
28062 " lvm-remove-all\n"
28063 "\n"
28064 msgstr ""
28065
28066 # type: =head2
28067 #. type: =head2
28068 #: ../fish/guestfish-actions.pod:2780
28069 msgid "lvm-set-filter"
28070 msgstr ""
28071
28072 # type: verbatim
28073 #. type: verbatim
28074 #: ../fish/guestfish-actions.pod:2782
28075 #, no-wrap
28076 msgid ""
28077 " lvm-set-filter 'devices ...'\n"
28078 "\n"
28079 msgstr ""
28080
28081 # type: =head2
28082 #. type: =head2
28083 #: ../fish/guestfish-actions.pod:2807
28084 msgid "lvremove"
28085 msgstr ""
28086
28087 # type: verbatim
28088 #. type: verbatim
28089 #: ../fish/guestfish-actions.pod:2809
28090 #, no-wrap
28091 msgid ""
28092 " lvremove device\n"
28093 "\n"
28094 msgstr ""
28095
28096 # type: =head2
28097 #. type: =head2
28098 #: ../fish/guestfish-actions.pod:2817
28099 msgid "lvrename"
28100 msgstr ""
28101
28102 # type: verbatim
28103 #. type: verbatim
28104 #: ../fish/guestfish-actions.pod:2819
28105 #, no-wrap
28106 msgid ""
28107 " lvrename logvol newlogvol\n"
28108 "\n"
28109 msgstr ""
28110
28111 # type: =head2
28112 #. type: =head2
28113 #: ../fish/guestfish-actions.pod:2823
28114 msgid "lvresize"
28115 msgstr ""
28116
28117 # type: verbatim
28118 #. type: verbatim
28119 #: ../fish/guestfish-actions.pod:2825
28120 #, no-wrap
28121 msgid ""
28122 " lvresize device mbytes\n"
28123 "\n"
28124 msgstr ""
28125
28126 # type: =head2
28127 #. type: =head2
28128 #: ../fish/guestfish-actions.pod:2831
28129 msgid "lvresize-free"
28130 msgstr ""
28131
28132 # type: verbatim
28133 #. type: verbatim
28134 #: ../fish/guestfish-actions.pod:2833
28135 #, no-wrap
28136 msgid ""
28137 " lvresize-free lv percent\n"
28138 "\n"
28139 msgstr ""
28140
28141 # type: =head2
28142 #. type: =head2
28143 #: ../fish/guestfish-actions.pod:2841
28144 msgid "lvs"
28145 msgstr ""
28146
28147 # type: verbatim
28148 #. type: verbatim
28149 #: ../fish/guestfish-actions.pod:2843
28150 #, no-wrap
28151 msgid ""
28152 " lvs\n"
28153 "\n"
28154 msgstr ""
28155
28156 # type: textblock
28157 #. type: textblock
28158 #: ../fish/guestfish-actions.pod:2851
28159 msgid "See also L</lvs-full>, L</list-filesystems>."
28160 msgstr ""
28161
28162 # type: =head2
28163 #. type: =head2
28164 #: ../fish/guestfish-actions.pod:2853
28165 msgid "lvs-full"
28166 msgstr ""
28167
28168 # type: verbatim
28169 #. type: verbatim
28170 #: ../fish/guestfish-actions.pod:2855
28171 #, no-wrap
28172 msgid ""
28173 " lvs-full\n"
28174 "\n"
28175 msgstr ""
28176
28177 # type: =head2
28178 #. type: =head2
28179 #: ../fish/guestfish-actions.pod:2860
28180 msgid "lvuuid"
28181 msgstr ""
28182
28183 # type: verbatim
28184 #. type: verbatim
28185 #: ../fish/guestfish-actions.pod:2862
28186 #, no-wrap
28187 msgid ""
28188 " lvuuid device\n"
28189 "\n"
28190 msgstr ""
28191
28192 # type: =head2
28193 #. type: =head2
28194 #: ../fish/guestfish-actions.pod:2866
28195 msgid "lxattrlist"
28196 msgstr ""
28197
28198 # type: verbatim
28199 #. type: verbatim
28200 #: ../fish/guestfish-actions.pod:2868
28201 #, no-wrap
28202 msgid ""
28203 " lxattrlist path 'names ...'\n"
28204 "\n"
28205 msgstr ""
28206
28207 # type: textblock
28208 #. type: textblock
28209 #: ../fish/guestfish-actions.pod:2884
28210 msgid ""
28211 "This call is intended for programs that want to efficiently list a directory "
28212 "contents without making many round-trips.  See also L</lstatlist> for a "
28213 "similarly efficient call for getting standard stats.  Very long directory "
28214 "listings might cause the protocol message size to be exceeded, causing this "
28215 "call to fail.  The caller must split up such requests into smaller groups of "
28216 "names."
28217 msgstr ""
28218
28219 # type: =head2
28220 #. type: =head2
28221 #: ../fish/guestfish-actions.pod:2892
28222 msgid "mkdir"
28223 msgstr ""
28224
28225 # type: verbatim
28226 #. type: verbatim
28227 #: ../fish/guestfish-actions.pod:2894
28228 #, no-wrap
28229 msgid ""
28230 " mkdir path\n"
28231 "\n"
28232 msgstr ""
28233
28234 # type: =head2
28235 #. type: =head2
28236 #: ../fish/guestfish-actions.pod:2898
28237 msgid "mkdir-mode"
28238 msgstr ""
28239
28240 # type: verbatim
28241 #. type: verbatim
28242 #: ../fish/guestfish-actions.pod:2900
28243 #, no-wrap
28244 msgid ""
28245 " mkdir-mode path mode\n"
28246 "\n"
28247 msgstr ""
28248
28249 # type: textblock
28250 #. type: textblock
28251 #: ../fish/guestfish-actions.pod:2909
28252 msgid "See also L</mkdir>, L</umask>"
28253 msgstr ""
28254
28255 # type: =head2
28256 #. type: =head2
28257 #: ../fish/guestfish-actions.pod:2911
28258 msgid "mkdir-p"
28259 msgstr ""
28260
28261 # type: verbatim
28262 #. type: verbatim
28263 #: ../fish/guestfish-actions.pod:2913
28264 #, no-wrap
28265 msgid ""
28266 " mkdir-p path\n"
28267 "\n"
28268 msgstr ""
28269
28270 # type: =head2
28271 #. type: =head2
28272 #: ../fish/guestfish-actions.pod:2918
28273 msgid "mkdtemp"
28274 msgstr ""
28275
28276 # type: verbatim
28277 #. type: verbatim
28278 #: ../fish/guestfish-actions.pod:2920
28279 #, no-wrap
28280 msgid ""
28281 " mkdtemp template\n"
28282 "\n"
28283 msgstr ""
28284
28285 # type: =head2
28286 #. type: =head2
28287 #: ../fish/guestfish-actions.pod:2941
28288 msgid "mke2fs-J"
28289 msgstr ""
28290
28291 # type: verbatim
28292 #. type: verbatim
28293 #: ../fish/guestfish-actions.pod:2943
28294 #, no-wrap
28295 msgid ""
28296 " mke2fs-J fstype blocksize device journal\n"
28297 "\n"
28298 msgstr ""
28299
28300 # type: textblock
28301 #. type: textblock
28302 #: ../fish/guestfish-actions.pod:2951
28303 msgid "See also L</mke2journal>."
28304 msgstr ""
28305
28306 # type: =head2
28307 #. type: =head2
28308 #: ../fish/guestfish-actions.pod:2953
28309 msgid "mke2fs-JL"
28310 msgstr ""
28311
28312 # type: verbatim
28313 #. type: verbatim
28314 #: ../fish/guestfish-actions.pod:2955
28315 #, no-wrap
28316 msgid ""
28317 " mke2fs-JL fstype blocksize device label\n"
28318 "\n"
28319 msgstr ""
28320
28321 # type: textblock
28322 #. type: textblock
28323 #: ../fish/guestfish-actions.pod:2960
28324 msgid "See also L</mke2journal-L>."
28325 msgstr ""
28326
28327 # type: =head2
28328 #. type: =head2
28329 #: ../fish/guestfish-actions.pod:2962
28330 msgid "mke2fs-JU"
28331 msgstr ""
28332
28333 # type: verbatim
28334 #. type: verbatim
28335 #: ../fish/guestfish-actions.pod:2964
28336 #, no-wrap
28337 msgid ""
28338 " mke2fs-JU fstype blocksize device uuid\n"
28339 "\n"
28340 msgstr ""
28341
28342 # type: textblock
28343 #. type: textblock
28344 #: ../fish/guestfish-actions.pod:2969
28345 msgid "See also L</mke2journal-U>."
28346 msgstr ""
28347
28348 # type: =head2
28349 #. type: =head2
28350 #: ../fish/guestfish-actions.pod:2971
28351 msgid "mke2journal"
28352 msgstr ""
28353
28354 # type: verbatim
28355 #. type: verbatim
28356 #: ../fish/guestfish-actions.pod:2973
28357 #, no-wrap
28358 msgid ""
28359 " mke2journal blocksize device\n"
28360 "\n"
28361 msgstr ""
28362
28363 # type: =head2
28364 #. type: =head2
28365 #: ../fish/guestfish-actions.pod:2980
28366 msgid "mke2journal-L"
28367 msgstr ""
28368
28369 # type: verbatim
28370 #. type: verbatim
28371 #: ../fish/guestfish-actions.pod:2982
28372 #, no-wrap
28373 msgid ""
28374 " mke2journal-L blocksize label device\n"
28375 "\n"
28376 msgstr ""
28377
28378 # type: =head2
28379 #. type: =head2
28380 #: ../fish/guestfish-actions.pod:2986
28381 msgid "mke2journal-U"
28382 msgstr ""
28383
28384 # type: verbatim
28385 #. type: verbatim
28386 #: ../fish/guestfish-actions.pod:2988
28387 #, no-wrap
28388 msgid ""
28389 " mke2journal-U blocksize uuid device\n"
28390 "\n"
28391 msgstr ""
28392
28393 # type: =head2
28394 #. type: =head2
28395 #: ../fish/guestfish-actions.pod:2992
28396 msgid "mkfifo"
28397 msgstr ""
28398
28399 # type: verbatim
28400 #. type: verbatim
28401 #: ../fish/guestfish-actions.pod:2994
28402 #, no-wrap
28403 msgid ""
28404 " mkfifo mode path\n"
28405 "\n"
28406 msgstr ""
28407
28408 # type: textblock
28409 #. type: textblock
28410 #: ../fish/guestfish-actions.pod:2996
28411 msgid ""
28412 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
28413 "is just a convenient wrapper around L</mknod>."
28414 msgstr ""
28415
28416 # type: =head2
28417 #. type: =head2
28418 #: ../fish/guestfish-actions.pod:3002
28419 msgid "mkfs"
28420 msgstr ""
28421
28422 # type: verbatim
28423 #. type: verbatim
28424 #: ../fish/guestfish-actions.pod:3004
28425 #, no-wrap
28426 msgid ""
28427 " mkfs fstype device\n"
28428 "\n"
28429 msgstr ""
28430
28431 # type: =head2
28432 #. type: =head2
28433 #: ../fish/guestfish-actions.pod:3010
28434 msgid "mkfs-b"
28435 msgstr ""
28436
28437 # type: verbatim
28438 #. type: verbatim
28439 #: ../fish/guestfish-actions.pod:3012
28440 #, no-wrap
28441 msgid ""
28442 " mkfs-b fstype blocksize device\n"
28443 "\n"
28444 msgstr ""
28445
28446 # type: textblock
28447 #. type: textblock
28448 #: ../fish/guestfish-actions.pod:3014
28449 msgid ""
28450 "This call is similar to L</mkfs>, but it allows you to control the block "
28451 "size of the resulting filesystem.  Supported block sizes depend on the "
28452 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
28453 msgstr ""
28454
28455 # type: =head2
28456 #. type: =head2
28457 #: ../fish/guestfish-actions.pod:3029
28458 msgid "mkfs-opts"
28459 msgstr ""
28460
28461 #. type: verbatim
28462 #: ../fish/guestfish-actions.pod:3031
28463 #, no-wrap
28464 msgid ""
28465 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
28466 "\n"
28467 msgstr ""
28468
28469 # type: =head2
28470 #. type: =head2
28471 #: ../fish/guestfish-actions.pod:3066
28472 msgid "mkmountpoint"
28473 msgstr ""
28474
28475 # type: verbatim
28476 #. type: verbatim
28477 #: ../fish/guestfish-actions.pod:3068
28478 #, no-wrap
28479 msgid ""
28480 " mkmountpoint exemptpath\n"
28481 "\n"
28482 msgstr ""
28483
28484 # type: textblock
28485 #. type: textblock
28486 #: ../fish/guestfish-actions.pod:3070
28487 msgid ""
28488 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
28489 "to create extra mountpoints before mounting the first filesystem."
28490 msgstr ""
28491
28492 # type: textblock
28493 #. type: textblock
28494 #: ../fish/guestfish-actions.pod:3094
28495 msgid ""
28496 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
28497 "unexpected errors if you try to mix these calls.  It is safest to manually "
28498 "unmount filesystems and remove mountpoints after use."
28499 msgstr ""
28500
28501 # type: textblock
28502 #. type: textblock
28503 #: ../fish/guestfish-actions.pod:3098
28504 msgid ""
28505 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
28506 "for this to work for manual mountpoints, you must ensure that the innermost "
28507 "mountpoints have the longest pathnames, as in the example code above."
28508 msgstr ""
28509
28510 #. type: textblock
28511 #: ../fish/guestfish-actions.pod:3105
28512 msgid ""
28513 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
28514 "L</umount-all> to be called when the handle is closed which can also trigger "
28515 "these issues."
28516 msgstr ""
28517
28518 # type: =head2
28519 #. type: =head2
28520 #: ../fish/guestfish-actions.pod:3109
28521 msgid "mknod"
28522 msgstr ""
28523
28524 # type: verbatim
28525 #. type: verbatim
28526 #: ../fish/guestfish-actions.pod:3111
28527 #, no-wrap
28528 msgid ""
28529 " mknod mode devmajor devminor path\n"
28530 "\n"
28531 msgstr ""
28532
28533 # type: textblock
28534 #. type: textblock
28535 #: ../fish/guestfish-actions.pod:3121
28536 msgid ""
28537 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
28538 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
28539 "regular file).  These constants are available in the standard Linux header "
28540 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
28541 "wrappers around this command which bitwise OR in the appropriate constant "
28542 "for you."
28543 msgstr ""
28544
28545 # type: =head2
28546 #. type: =head2
28547 #: ../fish/guestfish-actions.pod:3131
28548 msgid "mknod-b"
28549 msgstr ""
28550
28551 # type: verbatim
28552 #. type: verbatim
28553 #: ../fish/guestfish-actions.pod:3133
28554 #, no-wrap
28555 msgid ""
28556 " mknod-b mode devmajor devminor path\n"
28557 "\n"
28558 msgstr ""
28559
28560 # type: textblock
28561 #. type: textblock
28562 #: ../fish/guestfish-actions.pod:3135
28563 msgid ""
28564 "This call creates a block device node called C<path> with mode C<mode> and "
28565 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28566 "wrapper around L</mknod>."
28567 msgstr ""
28568
28569 # type: =head2
28570 #. type: =head2
28571 #: ../fish/guestfish-actions.pod:3141
28572 msgid "mknod-c"
28573 msgstr ""
28574
28575 # type: verbatim
28576 #. type: verbatim
28577 #: ../fish/guestfish-actions.pod:3143
28578 #, no-wrap
28579 msgid ""
28580 " mknod-c mode devmajor devminor path\n"
28581 "\n"
28582 msgstr ""
28583
28584 # type: textblock
28585 #. type: textblock
28586 #: ../fish/guestfish-actions.pod:3145
28587 msgid ""
28588 "This call creates a char device node called C<path> with mode C<mode> and "
28589 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28590 "wrapper around L</mknod>."
28591 msgstr ""
28592
28593 # type: =head2
28594 #. type: =head2
28595 #: ../fish/guestfish-actions.pod:3151
28596 msgid "mkswap"
28597 msgstr ""
28598
28599 # type: verbatim
28600 #. type: verbatim
28601 #: ../fish/guestfish-actions.pod:3153
28602 #, no-wrap
28603 msgid ""
28604 " mkswap device\n"
28605 "\n"
28606 msgstr ""
28607
28608 # type: =head2
28609 #. type: =head2
28610 #: ../fish/guestfish-actions.pod:3157
28611 msgid "mkswap-L"
28612 msgstr ""
28613
28614 # type: verbatim
28615 #. type: verbatim
28616 #: ../fish/guestfish-actions.pod:3159
28617 #, no-wrap
28618 msgid ""
28619 " mkswap-L label device\n"
28620 "\n"
28621 msgstr ""
28622
28623 # type: =head2
28624 #. type: =head2
28625 #: ../fish/guestfish-actions.pod:3167
28626 msgid "mkswap-U"
28627 msgstr ""
28628
28629 # type: verbatim
28630 #. type: verbatim
28631 #: ../fish/guestfish-actions.pod:3169
28632 #, no-wrap
28633 msgid ""
28634 " mkswap-U uuid device\n"
28635 "\n"
28636 msgstr ""
28637
28638 # type: =head2
28639 #. type: =head2
28640 #: ../fish/guestfish-actions.pod:3173
28641 msgid "mkswap-file"
28642 msgstr ""
28643
28644 # type: verbatim
28645 #. type: verbatim
28646 #: ../fish/guestfish-actions.pod:3175
28647 #, no-wrap
28648 msgid ""
28649 " mkswap-file path\n"
28650 "\n"
28651 msgstr ""
28652
28653 # type: textblock
28654 #. type: textblock
28655 #: ../fish/guestfish-actions.pod:3179
28656 msgid ""
28657 "This command just writes a swap file signature to an existing file.  To "
28658 "create the file itself, use something like L</fallocate>."
28659 msgstr ""
28660
28661 # type: =head2
28662 #. type: =head2
28663 #: ../fish/guestfish-actions.pod:3182
28664 msgid "modprobe"
28665 msgstr ""
28666
28667 # type: verbatim
28668 #. type: verbatim
28669 #: ../fish/guestfish-actions.pod:3184
28670 #, no-wrap
28671 msgid ""
28672 " modprobe modulename\n"
28673 "\n"
28674 msgstr ""
28675
28676 # type: =head2
28677 #. type: =head2
28678 #: ../fish/guestfish-actions.pod:3191
28679 msgid "mount"
28680 msgstr ""
28681
28682 # type: verbatim
28683 #. type: verbatim
28684 #: ../fish/guestfish-actions.pod:3193
28685 #, no-wrap
28686 msgid ""
28687 " mount device mountpoint\n"
28688 "\n"
28689 msgstr ""
28690
28691 # type: textblock
28692 #. type: textblock
28693 #: ../fish/guestfish-actions.pod:3209
28694 msgid ""
28695 "B<Important note:> When you use this call, the filesystem options C<sync> "
28696 "and C<noatime> are set implicitly.  This was originally done because we "
28697 "thought it would improve reliability, but it turns out that I<-o sync> has a "
28698 "very large negative performance impact and negligible effect on "
28699 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
28700 "code that needs performance, and instead use L</mount-options> (use an empty "
28701 "string for the first parameter if you don't want any options)."
28702 msgstr ""
28703
28704 # type: =head2
28705 #. type: =head2
28706 #: ../fish/guestfish-actions.pod:3226
28707 msgid "mount-loop"
28708 msgstr ""
28709
28710 # type: verbatim
28711 #. type: verbatim
28712 #: ../fish/guestfish-actions.pod:3228
28713 #, no-wrap
28714 msgid ""
28715 " mount-loop file mountpoint\n"
28716 "\n"
28717 msgstr ""
28718
28719 # type: =head2
28720 #. type: =head2
28721 #: ../fish/guestfish-actions.pod:3234
28722 msgid "mount-options"
28723 msgstr ""
28724
28725 # type: verbatim
28726 #. type: verbatim
28727 #: ../fish/guestfish-actions.pod:3236
28728 #, no-wrap
28729 msgid ""
28730 " mount-options options device mountpoint\n"
28731 "\n"
28732 msgstr ""
28733
28734 # type: textblock
28735 #. type: textblock
28736 #: ../fish/guestfish-actions.pod:3238
28737 msgid ""
28738 "This is the same as the L</mount> command, but it allows you to set the "
28739 "mount options as for the L<mount(8)> I<-o> flag."
28740 msgstr ""
28741
28742 # type: =head2
28743 #. type: =head2
28744 #: ../fish/guestfish-actions.pod:3246
28745 msgid "mount-ro"
28746 msgstr ""
28747
28748 # type: verbatim
28749 #. type: verbatim
28750 #: ../fish/guestfish-actions.pod:3248
28751 #, no-wrap
28752 msgid ""
28753 " mount-ro device mountpoint\n"
28754 "\n"
28755 msgstr ""
28756
28757 # type: textblock
28758 #. type: textblock
28759 #: ../fish/guestfish-actions.pod:3250
28760 msgid ""
28761 "This is the same as the L</mount> command, but it mounts the filesystem with "
28762 "the read-only (I<-o ro>) flag."
28763 msgstr ""
28764
28765 # type: =head2
28766 #. type: =head2
28767 #: ../fish/guestfish-actions.pod:3253
28768 msgid "mount-vfs"
28769 msgstr ""
28770
28771 # type: verbatim
28772 #. type: verbatim
28773 #: ../fish/guestfish-actions.pod:3255
28774 #, no-wrap
28775 msgid ""
28776 " mount-vfs options vfstype device mountpoint\n"
28777 "\n"
28778 msgstr ""
28779
28780 # type: textblock
28781 #. type: textblock
28782 #: ../fish/guestfish-actions.pod:3257
28783 msgid ""
28784 "This is the same as the L</mount> command, but it allows you to set both the "
28785 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
28786 msgstr ""
28787
28788 # type: =head2
28789 #. type: =head2
28790 #: ../fish/guestfish-actions.pod:3261
28791 msgid "mountpoints"
28792 msgstr ""
28793
28794 # type: verbatim
28795 #. type: verbatim
28796 #: ../fish/guestfish-actions.pod:3263
28797 #, no-wrap
28798 msgid ""
28799 " mountpoints\n"
28800 "\n"
28801 msgstr ""
28802
28803 # type: textblock
28804 #. type: textblock
28805 #: ../fish/guestfish-actions.pod:3265
28806 msgid ""
28807 "This call is similar to L</mounts>.  That call returns a list of devices.  "
28808 "This one returns a hash table (map) of device name to directory where the "
28809 "device is mounted."
28810 msgstr ""
28811
28812 # type: =head2
28813 #. type: =head2
28814 #: ../fish/guestfish-actions.pod:3269
28815 msgid "mounts"
28816 msgstr ""
28817
28818 # type: verbatim
28819 #. type: verbatim
28820 #: ../fish/guestfish-actions.pod:3271
28821 #, no-wrap
28822 msgid ""
28823 " mounts\n"
28824 "\n"
28825 msgstr ""
28826
28827 # type: textblock
28828 #. type: textblock
28829 #: ../fish/guestfish-actions.pod:3278
28830 msgid "See also: L</mountpoints>"
28831 msgstr ""
28832
28833 # type: =head2
28834 #. type: =head2
28835 #: ../fish/guestfish-actions.pod:3280
28836 msgid "mv"
28837 msgstr ""
28838
28839 # type: verbatim
28840 #. type: verbatim
28841 #: ../fish/guestfish-actions.pod:3282
28842 #, no-wrap
28843 msgid ""
28844 " mv src dest\n"
28845 "\n"
28846 msgstr ""
28847
28848 # type: =head2
28849 #. type: =head2
28850 #: ../fish/guestfish-actions.pod:3287
28851 msgid "ntfs-3g-probe"
28852 msgstr ""
28853
28854 # type: verbatim
28855 #. type: verbatim
28856 #: ../fish/guestfish-actions.pod:3289
28857 #, no-wrap
28858 msgid ""
28859 " ntfs-3g-probe true|false device\n"
28860 "\n"
28861 msgstr ""
28862
28863 # type: =head2
28864 #. type: =head2
28865 #: ../fish/guestfish-actions.pod:3303
28866 msgid "ntfsresize"
28867 msgstr ""
28868
28869 # type: verbatim
28870 #. type: verbatim
28871 #: ../fish/guestfish-actions.pod:3305
28872 #, no-wrap
28873 msgid ""
28874 " ntfsresize device\n"
28875 "\n"
28876 msgstr ""
28877
28878 # type: =head2
28879 #. type: =head2
28880 #: ../fish/guestfish-actions.pod:3311
28881 msgid "ntfsresize-size"
28882 msgstr ""
28883
28884 # type: verbatim
28885 #. type: verbatim
28886 #: ../fish/guestfish-actions.pod:3313
28887 #, no-wrap
28888 msgid ""
28889 " ntfsresize-size device size\n"
28890 "\n"
28891 msgstr ""
28892
28893 # type: textblock
28894 #. type: textblock
28895 #: ../fish/guestfish-actions.pod:3315
28896 msgid ""
28897 "This command is the same as L</ntfsresize> except that it allows you to "
28898 "specify the new size (in bytes) explicitly."
28899 msgstr ""
28900
28901 # type: =head2
28902 #. type: =head2
28903 #: ../fish/guestfish-actions.pod:3318
28904 msgid "part-add"
28905 msgstr ""
28906
28907 # type: verbatim
28908 #. type: verbatim
28909 #: ../fish/guestfish-actions.pod:3320
28910 #, no-wrap
28911 msgid ""
28912 " part-add device prlogex startsect endsect\n"
28913 "\n"
28914 msgstr ""
28915
28916 # type: textblock
28917 #. type: textblock
28918 #: ../fish/guestfish-actions.pod:3322
28919 msgid ""
28920 "This command adds a partition to C<device>.  If there is no partition table "
28921 "on the device, call L</part-init> first."
28922 msgstr ""
28923
28924 # type: textblock
28925 #. type: textblock
28926 #: ../fish/guestfish-actions.pod:3334
28927 msgid ""
28928 "Creating a partition which covers the whole disk is not so easy.  Use L</"
28929 "part-disk> to do that."
28930 msgstr ""
28931
28932 # type: =head2
28933 #. type: =head2
28934 #: ../fish/guestfish-actions.pod:3337
28935 msgid "part-del"
28936 msgstr ""
28937
28938 # type: verbatim
28939 #. type: verbatim
28940 #: ../fish/guestfish-actions.pod:3339
28941 #, no-wrap
28942 msgid ""
28943 " part-del device partnum\n"
28944 "\n"
28945 msgstr ""
28946
28947 # type: =head2
28948 #. type: =head2
28949 #: ../fish/guestfish-actions.pod:3347
28950 msgid "part-disk"
28951 msgstr ""
28952
28953 # type: verbatim
28954 #. type: verbatim
28955 #: ../fish/guestfish-actions.pod:3349
28956 #, no-wrap
28957 msgid ""
28958 " part-disk device parttype\n"
28959 "\n"
28960 msgstr ""
28961
28962 # type: textblock
28963 #. type: textblock
28964 #: ../fish/guestfish-actions.pod:3351
28965 msgid ""
28966 "This command is simply a combination of L</part-init> followed by L</part-"
28967 "add> to create a single primary partition covering the whole disk."
28968 msgstr ""
28969
28970 # type: textblock
28971 #. type: textblock
28972 #: ../fish/guestfish-actions.pod:3355
28973 msgid ""
28974 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
28975 "possible values are described in L</part-init>."
28976 msgstr ""
28977
28978 # type: =head2
28979 #. type: =head2
28980 #: ../fish/guestfish-actions.pod:3361
28981 msgid "part-get-bootable"
28982 msgstr ""
28983
28984 # type: verbatim
28985 #. type: verbatim
28986 #: ../fish/guestfish-actions.pod:3363
28987 #, no-wrap
28988 msgid ""
28989 " part-get-bootable device partnum\n"
28990 "\n"
28991 msgstr ""
28992
28993 # type: textblock
28994 #. type: textblock
28995 #: ../fish/guestfish-actions.pod:3368
28996 msgid "See also L</part-set-bootable>."
28997 msgstr ""
28998
28999 # type: =head2
29000 #. type: =head2
29001 #: ../fish/guestfish-actions.pod:3370
29002 msgid "part-get-mbr-id"
29003 msgstr ""
29004
29005 # type: verbatim
29006 #. type: verbatim
29007 #: ../fish/guestfish-actions.pod:3372
29008 #, no-wrap
29009 msgid ""
29010 " part-get-mbr-id device partnum\n"
29011 "\n"
29012 msgstr ""
29013
29014 # type: textblock
29015 #. type: textblock
29016 #: ../fish/guestfish-actions.pod:3377 ../fish/guestfish-actions.pod:3515
29017 msgid ""
29018 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
29019 "undefined results for other partition table types (see L</part-get-"
29020 "parttype>)."
29021 msgstr ""
29022
29023 # type: =head2
29024 #. type: =head2
29025 #: ../fish/guestfish-actions.pod:3381
29026 msgid "part-get-parttype"
29027 msgstr ""
29028
29029 # type: verbatim
29030 #. type: verbatim
29031 #: ../fish/guestfish-actions.pod:3383
29032 #, no-wrap
29033 msgid ""
29034 " part-get-parttype device\n"
29035 "\n"
29036 msgstr ""
29037
29038 # type: textblock
29039 #. type: textblock
29040 #: ../fish/guestfish-actions.pod:3388
29041 msgid ""
29042 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
29043 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
29044 "possible, although unusual.  See L</part-init> for a full list."
29045 msgstr ""
29046
29047 # type: =head2
29048 #. type: =head2
29049 #: ../fish/guestfish-actions.pod:3393
29050 msgid "part-init"
29051 msgstr ""
29052
29053 # type: verbatim
29054 #. type: verbatim
29055 #: ../fish/guestfish-actions.pod:3395
29056 #, no-wrap
29057 msgid ""
29058 " part-init device parttype\n"
29059 "\n"
29060 msgstr ""
29061
29062 # type: textblock
29063 #. type: textblock
29064 #: ../fish/guestfish-actions.pod:3401
29065 msgid ""
29066 "Initially there are no partitions.  Following this, you should call L</part-"
29067 "add> for each partition required."
29068 msgstr ""
29069
29070 # type: =head2
29071 #. type: =head2
29072 #: ../fish/guestfish-actions.pod:3464
29073 msgid "part-list"
29074 msgstr ""
29075
29076 # type: verbatim
29077 #. type: verbatim
29078 #: ../fish/guestfish-actions.pod:3466
29079 #, no-wrap
29080 msgid ""
29081 " part-list device\n"
29082 "\n"
29083 msgstr ""
29084
29085 # type: textblock
29086 #. type: textblock
29087 #: ../fish/guestfish-actions.pod:3481
29088 msgid ""
29089 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
29090 "the device's sector size, see L</blockdev-getss>."
29091 msgstr ""
29092
29093 # type: =head2
29094 #. type: =head2
29095 #: ../fish/guestfish-actions.pod:3494
29096 msgid "part-set-bootable"
29097 msgstr ""
29098
29099 # type: verbatim
29100 #. type: verbatim
29101 #: ../fish/guestfish-actions.pod:3496
29102 #, no-wrap
29103 msgid ""
29104 " part-set-bootable device partnum true|false\n"
29105 "\n"
29106 msgstr ""
29107
29108 # type: =head2
29109 #. type: =head2
29110 #: ../fish/guestfish-actions.pod:3505
29111 msgid "part-set-mbr-id"
29112 msgstr ""
29113
29114 # type: verbatim
29115 #. type: verbatim
29116 #: ../fish/guestfish-actions.pod:3507
29117 #, no-wrap
29118 msgid ""
29119 " part-set-mbr-id device partnum idbyte\n"
29120 "\n"
29121 msgstr ""
29122
29123 # type: =head2
29124 #. type: =head2
29125 #: ../fish/guestfish-actions.pod:3519
29126 msgid "part-set-name"
29127 msgstr ""
29128
29129 # type: verbatim
29130 #. type: verbatim
29131 #: ../fish/guestfish-actions.pod:3521
29132 #, no-wrap
29133 msgid ""
29134 " part-set-name device partnum name\n"
29135 "\n"
29136 msgstr ""
29137
29138 # type: =head2
29139 #. type: =head2
29140 #: ../fish/guestfish-actions.pod:3529
29141 msgid "part-to-dev"
29142 msgstr ""
29143
29144 # type: verbatim
29145 #. type: verbatim
29146 #: ../fish/guestfish-actions.pod:3531
29147 #, no-wrap
29148 msgid ""
29149 " part-to-dev partition\n"
29150 "\n"
29151 msgstr ""
29152
29153 # type: textblock
29154 #. type: textblock
29155 #: ../fish/guestfish-actions.pod:3537
29156 msgid ""
29157 "The named partition must exist, for example as a string returned from L</"
29158 "list-partitions>."
29159 msgstr ""
29160
29161 # type: =head2
29162 #. type: =head2
29163 #: ../fish/guestfish-actions.pod:3540
29164 msgid "ping-daemon"
29165 msgstr ""
29166
29167 # type: verbatim
29168 #. type: verbatim
29169 #: ../fish/guestfish-actions.pod:3542
29170 #, no-wrap
29171 msgid ""
29172 " ping-daemon\n"
29173 "\n"
29174 msgstr ""
29175
29176 # type: =head2
29177 #. type: =head2
29178 #: ../fish/guestfish-actions.pod:3549
29179 msgid "pread"
29180 msgstr ""
29181
29182 # type: verbatim
29183 #. type: verbatim
29184 #: ../fish/guestfish-actions.pod:3551
29185 #, no-wrap
29186 msgid ""
29187 " pread path count offset\n"
29188 "\n"
29189 msgstr ""
29190
29191 # type: textblock
29192 #. type: textblock
29193 #: ../fish/guestfish-actions.pod:3559
29194 msgid "See also L</pwrite>, L</pread-device>."
29195 msgstr ""
29196
29197 # type: =head2
29198 #. type: =head2
29199 #: ../fish/guestfish-actions.pod:3564
29200 msgid "pread-device"
29201 msgstr ""
29202
29203 # type: verbatim
29204 #. type: verbatim
29205 #: ../fish/guestfish-actions.pod:3566
29206 #, no-wrap
29207 msgid ""
29208 " pread-device device count offset\n"
29209 "\n"
29210 msgstr ""
29211
29212 # type: textblock
29213 #. type: textblock
29214 #: ../fish/guestfish-actions.pod:3574
29215 msgid "See also L</pread>."
29216 msgstr ""
29217
29218 # type: =head2
29219 #. type: =head2
29220 #: ../fish/guestfish-actions.pod:3579
29221 msgid "pvcreate"
29222 msgstr ""
29223
29224 # type: verbatim
29225 #. type: verbatim
29226 #: ../fish/guestfish-actions.pod:3581
29227 #, no-wrap
29228 msgid ""
29229 " pvcreate device\n"
29230 "\n"
29231 msgstr ""
29232
29233 # type: =head2
29234 #. type: =head2
29235 #: ../fish/guestfish-actions.pod:3587
29236 msgid "pvremove"
29237 msgstr ""
29238
29239 # type: verbatim
29240 #. type: verbatim
29241 #: ../fish/guestfish-actions.pod:3589
29242 #, no-wrap
29243 msgid ""
29244 " pvremove device\n"
29245 "\n"
29246 msgstr ""
29247
29248 # type: =head2
29249 #. type: =head2
29250 #: ../fish/guestfish-actions.pod:3598
29251 msgid "pvresize"
29252 msgstr ""
29253
29254 # type: verbatim
29255 #. type: verbatim
29256 #: ../fish/guestfish-actions.pod:3600
29257 #, no-wrap
29258 msgid ""
29259 " pvresize device\n"
29260 "\n"
29261 msgstr ""
29262
29263 # type: =head2
29264 #. type: =head2
29265 #: ../fish/guestfish-actions.pod:3605
29266 msgid "pvresize-size"
29267 msgstr ""
29268
29269 # type: verbatim
29270 #. type: verbatim
29271 #: ../fish/guestfish-actions.pod:3607
29272 #, no-wrap
29273 msgid ""
29274 " pvresize-size device size\n"
29275 "\n"
29276 msgstr ""
29277
29278 # type: textblock
29279 #. type: textblock
29280 #: ../fish/guestfish-actions.pod:3609
29281 msgid ""
29282 "This command is the same as L</pvresize> except that it allows you to "
29283 "specify the new size (in bytes) explicitly."
29284 msgstr ""
29285
29286 # type: =head2
29287 #. type: =head2
29288 #: ../fish/guestfish-actions.pod:3612
29289 msgid "pvs"
29290 msgstr ""
29291
29292 # type: verbatim
29293 #. type: verbatim
29294 #: ../fish/guestfish-actions.pod:3614
29295 #, no-wrap
29296 msgid ""
29297 " pvs\n"
29298 "\n"
29299 msgstr ""
29300
29301 # type: textblock
29302 #. type: textblock
29303 #: ../fish/guestfish-actions.pod:3622
29304 msgid "See also L</pvs-full>."
29305 msgstr ""
29306
29307 # type: =head2
29308 #. type: =head2
29309 #: ../fish/guestfish-actions.pod:3624
29310 msgid "pvs-full"
29311 msgstr ""
29312
29313 # type: verbatim
29314 #. type: verbatim
29315 #: ../fish/guestfish-actions.pod:3626
29316 #, no-wrap
29317 msgid ""
29318 " pvs-full\n"
29319 "\n"
29320 msgstr ""
29321
29322 # type: =head2
29323 #. type: =head2
29324 #: ../fish/guestfish-actions.pod:3631
29325 msgid "pvuuid"
29326 msgstr ""
29327
29328 # type: verbatim
29329 #. type: verbatim
29330 #: ../fish/guestfish-actions.pod:3633
29331 #, no-wrap
29332 msgid ""
29333 " pvuuid device\n"
29334 "\n"
29335 msgstr ""
29336
29337 # type: =head2
29338 #. type: =head2
29339 #: ../fish/guestfish-actions.pod:3637
29340 msgid "pwrite"
29341 msgstr ""
29342
29343 # type: verbatim
29344 #. type: verbatim
29345 #: ../fish/guestfish-actions.pod:3639
29346 #, no-wrap
29347 msgid ""
29348 " pwrite path content offset\n"
29349 "\n"
29350 msgstr ""
29351
29352 # type: textblock
29353 #. type: textblock
29354 #: ../fish/guestfish-actions.pod:3650
29355 msgid "See also L</pread>, L</pwrite-device>."
29356 msgstr ""
29357
29358 # type: =head2
29359 #. type: =head2
29360 #: ../fish/guestfish-actions.pod:3655
29361 msgid "pwrite-device"
29362 msgstr ""
29363
29364 # type: verbatim
29365 #. type: verbatim
29366 #: ../fish/guestfish-actions.pod:3657
29367 #, no-wrap
29368 msgid ""
29369 " pwrite-device device content offset\n"
29370 "\n"
29371 msgstr ""
29372
29373 # type: textblock
29374 #. type: textblock
29375 #: ../fish/guestfish-actions.pod:3667
29376 msgid "See also L</pwrite>."
29377 msgstr ""
29378
29379 # type: =head2
29380 #. type: =head2
29381 #: ../fish/guestfish-actions.pod:3672
29382 msgid "read-file"
29383 msgstr ""
29384
29385 # type: verbatim
29386 #. type: verbatim
29387 #: ../fish/guestfish-actions.pod:3674
29388 #, no-wrap
29389 msgid ""
29390 " read-file path\n"
29391 "\n"
29392 msgstr ""
29393
29394 # type: textblock
29395 #. type: textblock
29396 #: ../fish/guestfish-actions.pod:3679
29397 msgid ""
29398 "Unlike L</cat>, this function can correctly handle files that contain "
29399 "embedded ASCII NUL characters.  However unlike L</download>, this function "
29400 "is limited in the total size of file that can be handled."
29401 msgstr ""
29402
29403 # type: =head2
29404 #. type: =head2
29405 #: ../fish/guestfish-actions.pod:3687
29406 msgid "read-lines"
29407 msgstr ""
29408
29409 # type: verbatim
29410 #. type: verbatim
29411 #: ../fish/guestfish-actions.pod:3689
29412 #, no-wrap
29413 msgid ""
29414 " read-lines path\n"
29415 "\n"
29416 msgstr ""
29417
29418 # type: textblock
29419 #. type: textblock
29420 #: ../fish/guestfish-actions.pod:3696
29421 msgid ""
29422 "Note that this function cannot correctly handle binary files (specifically, "
29423 "files containing C<\\0> character which is treated as end of line).  For "
29424 "those you need to use the L</read-file> function which has a more complex "
29425 "interface."
29426 msgstr ""
29427
29428 # type: =head2
29429 #. type: =head2
29430 #: ../fish/guestfish-actions.pod:3701
29431 msgid "readdir"
29432 msgstr ""
29433
29434 # type: verbatim
29435 #. type: verbatim
29436 #: ../fish/guestfish-actions.pod:3703
29437 #, no-wrap
29438 msgid ""
29439 " readdir dir\n"
29440 "\n"
29441 msgstr ""
29442
29443 # type: textblock
29444 #. type: textblock
29445 #: ../fish/guestfish-actions.pod:3755
29446 msgid ""
29447 "This function is primarily intended for use by programs.  To get a simple "
29448 "list of names, use L</ls>.  To get a printable directory for human "
29449 "consumption, use L</ll>."
29450 msgstr ""
29451
29452 # type: =head2
29453 #. type: =head2
29454 #: ../fish/guestfish-actions.pod:3759
29455 msgid "readlink"
29456 msgstr ""
29457
29458 # type: verbatim
29459 #. type: verbatim
29460 #: ../fish/guestfish-actions.pod:3761
29461 #, no-wrap
29462 msgid ""
29463 " readlink path\n"
29464 "\n"
29465 msgstr ""
29466
29467 # type: =head2
29468 #. type: =head2
29469 #: ../fish/guestfish-actions.pod:3765
29470 msgid "readlinklist"
29471 msgstr ""
29472
29473 # type: verbatim
29474 #. type: verbatim
29475 #: ../fish/guestfish-actions.pod:3767
29476 #, no-wrap
29477 msgid ""
29478 " readlinklist path 'names ...'\n"
29479 "\n"
29480 msgstr ""
29481
29482 # type: =head2
29483 #. type: =head2
29484 #: ../fish/guestfish-actions.pod:3791
29485 msgid "realpath"
29486 msgstr ""
29487
29488 # type: verbatim
29489 #. type: verbatim
29490 #: ../fish/guestfish-actions.pod:3793
29491 #, no-wrap
29492 msgid ""
29493 " realpath path\n"
29494 "\n"
29495 msgstr ""
29496
29497 # type: =head2
29498 #. type: =head2
29499 #: ../fish/guestfish-actions.pod:3798
29500 msgid "removexattr"
29501 msgstr ""
29502
29503 # type: verbatim
29504 #. type: verbatim
29505 #: ../fish/guestfish-actions.pod:3800
29506 #, no-wrap
29507 msgid ""
29508 " removexattr xattr path\n"
29509 "\n"
29510 msgstr ""
29511
29512 # type: textblock
29513 #. type: textblock
29514 #: ../fish/guestfish-actions.pod:3805
29515 msgid "See also: L</lremovexattr>, L<attr(5)>."
29516 msgstr ""
29517
29518 # type: =head2
29519 #. type: =head2
29520 #: ../fish/guestfish-actions.pod:3807
29521 msgid "resize2fs"
29522 msgstr ""
29523
29524 # type: verbatim
29525 #. type: verbatim
29526 #: ../fish/guestfish-actions.pod:3809
29527 #, no-wrap
29528 msgid ""
29529 " resize2fs device\n"
29530 "\n"
29531 msgstr ""
29532
29533 # type: textblock
29534 #. type: textblock
29535 #: ../fish/guestfish-actions.pod:3814
29536 msgid ""
29537 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
29538 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
29539 "gives an error about this and sometimes not.  In any case, it is always safe "
29540 "to call L</e2fsck-f> before calling this function."
29541 msgstr ""
29542
29543 #. type: =head2
29544 #: ../fish/guestfish-actions.pod:3820
29545 msgid "resize2fs-M"
29546 msgstr ""
29547
29548 #. type: verbatim
29549 #: ../fish/guestfish-actions.pod:3822
29550 #, no-wrap
29551 msgid ""
29552 " resize2fs-M device\n"
29553 "\n"
29554 msgstr ""
29555
29556 #. type: textblock
29557 #: ../fish/guestfish-actions.pod:3824
29558 msgid ""
29559 "This command is the same as L</resize2fs>, but the filesystem is resized to "
29560 "its minimum size.  This works like the I<-M> option to the C<resize2fs> "
29561 "command."
29562 msgstr ""
29563
29564 #. type: textblock
29565 #: ../fish/guestfish-actions.pod:3828
29566 msgid ""
29567 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
29568 "and read the C<Block size> and C<Block count> values.  These two numbers, "
29569 "multiplied together, give the resulting size of the minimal filesystem in "
29570 "bytes."
29571 msgstr ""
29572
29573 # type: =head2
29574 #. type: =head2
29575 #: ../fish/guestfish-actions.pod:3833
29576 msgid "resize2fs-size"
29577 msgstr ""
29578
29579 # type: verbatim
29580 #. type: verbatim
29581 #: ../fish/guestfish-actions.pod:3835
29582 #, no-wrap
29583 msgid ""
29584 " resize2fs-size device size\n"
29585 "\n"
29586 msgstr ""
29587
29588 # type: textblock
29589 #. type: textblock
29590 #: ../fish/guestfish-actions.pod:3837
29591 msgid ""
29592 "This command is the same as L</resize2fs> except that it allows you to "
29593 "specify the new size (in bytes) explicitly."
29594 msgstr ""
29595
29596 # type: =head2
29597 #. type: =head2
29598 #: ../fish/guestfish-actions.pod:3840
29599 msgid "rm"
29600 msgstr ""
29601
29602 # type: verbatim
29603 #. type: verbatim
29604 #: ../fish/guestfish-actions.pod:3842
29605 #, no-wrap
29606 msgid ""
29607 " rm path\n"
29608 "\n"
29609 msgstr ""
29610
29611 # type: =head2
29612 #. type: =head2
29613 #: ../fish/guestfish-actions.pod:3846
29614 msgid "rm-rf"
29615 msgstr ""
29616
29617 # type: verbatim
29618 #. type: verbatim
29619 #: ../fish/guestfish-actions.pod:3848
29620 #, no-wrap
29621 msgid ""
29622 " rm-rf path\n"
29623 "\n"
29624 msgstr ""
29625
29626 # type: =head2
29627 #. type: =head2
29628 #: ../fish/guestfish-actions.pod:3854
29629 msgid "rmdir"
29630 msgstr ""
29631
29632 # type: verbatim
29633 #. type: verbatim
29634 #: ../fish/guestfish-actions.pod:3856
29635 #, no-wrap
29636 msgid ""
29637 " rmdir path\n"
29638 "\n"
29639 msgstr ""
29640
29641 # type: =head2
29642 #. type: =head2
29643 #: ../fish/guestfish-actions.pod:3860
29644 msgid "rmmountpoint"
29645 msgstr ""
29646
29647 # type: verbatim
29648 #. type: verbatim
29649 #: ../fish/guestfish-actions.pod:3862
29650 #, no-wrap
29651 msgid ""
29652 " rmmountpoint exemptpath\n"
29653 "\n"
29654 msgstr ""
29655
29656 # type: textblock
29657 #. type: textblock
29658 #: ../fish/guestfish-actions.pod:3864
29659 msgid ""
29660 "This calls removes a mountpoint that was previously created with L</"
29661 "mkmountpoint>.  See L</mkmountpoint> for full details."
29662 msgstr ""
29663
29664 # type: =head2
29665 #. type: =head2
29666 #: ../fish/guestfish-actions.pod:3868
29667 msgid "scrub-device"
29668 msgstr ""
29669
29670 # type: verbatim
29671 #. type: verbatim
29672 #: ../fish/guestfish-actions.pod:3870
29673 #, no-wrap
29674 msgid ""
29675 " scrub-device device\n"
29676 "\n"
29677 msgstr ""
29678
29679 # type: =head2
29680 #. type: =head2
29681 #: ../fish/guestfish-actions.pod:3881
29682 msgid "scrub-file"
29683 msgstr ""
29684
29685 # type: verbatim
29686 #. type: verbatim
29687 #: ../fish/guestfish-actions.pod:3883
29688 #, no-wrap
29689 msgid ""
29690 " scrub-file file\n"
29691 "\n"
29692 msgstr ""
29693
29694 # type: =head2
29695 #. type: =head2
29696 #: ../fish/guestfish-actions.pod:3893
29697 msgid "scrub-freespace"
29698 msgstr ""
29699
29700 # type: verbatim
29701 #. type: verbatim
29702 #: ../fish/guestfish-actions.pod:3895
29703 #, no-wrap
29704 msgid ""
29705 " scrub-freespace dir\n"
29706 "\n"
29707 msgstr ""
29708
29709 # type: textblock
29710 #. type: textblock
29711 #: ../fish/guestfish-actions.pod:3897
29712 msgid ""
29713 "This command creates the directory C<dir> and then fills it with files until "
29714 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
29715 "deletes them.  The intention is to scrub any free space on the partition "
29716 "containing C<dir>."
29717 msgstr ""
29718
29719 # type: =head2
29720 #. type: =head2
29721 #: ../fish/guestfish-actions.pod:3906
29722 msgid "set-append"
29723 msgstr ""
29724
29725 # type: =head2
29726 #. type: =head2
29727 #: ../fish/guestfish-actions.pod:3908
29728 msgid "append"
29729 msgstr ""
29730
29731 # type: verbatim
29732 #. type: verbatim
29733 #: ../fish/guestfish-actions.pod:3910
29734 #, no-wrap
29735 msgid ""
29736 " set-append append\n"
29737 "\n"
29738 msgstr ""
29739
29740 #. type: =head2
29741 #: ../fish/guestfish-actions.pod:3921
29742 msgid "set-attach-method"
29743 msgstr ""
29744
29745 #. type: =head2
29746 #: ../fish/guestfish-actions.pod:3923
29747 msgid "attach-method"
29748 msgstr ""
29749
29750 #. type: verbatim
29751 #: ../fish/guestfish-actions.pod:3925
29752 #, no-wrap
29753 msgid ""
29754 " set-attach-method attachmethod\n"
29755 "\n"
29756 msgstr ""
29757
29758 # type: =head2
29759 #. type: =head2
29760 #: ../fish/guestfish-actions.pod:3947
29761 msgid "set-autosync"
29762 msgstr ""
29763
29764 # type: =head2
29765 #. type: =head2
29766 #: ../fish/guestfish-actions.pod:3949
29767 msgid "autosync"
29768 msgstr ""
29769
29770 # type: verbatim
29771 #. type: verbatim
29772 #: ../fish/guestfish-actions.pod:3951
29773 #, no-wrap
29774 msgid ""
29775 " set-autosync true|false\n"
29776 "\n"
29777 msgstr ""
29778
29779 # type: =head2
29780 #. type: =head2
29781 #: ../fish/guestfish-actions.pod:3961
29782 msgid "set-direct"
29783 msgstr ""
29784
29785 # type: =head2
29786 #. type: =head2
29787 #: ../fish/guestfish-actions.pod:3963
29788 msgid "direct"
29789 msgstr ""
29790
29791 # type: verbatim
29792 #. type: verbatim
29793 #: ../fish/guestfish-actions.pod:3965
29794 #, no-wrap
29795 msgid ""
29796 " set-direct true|false\n"
29797 "\n"
29798 msgstr ""
29799
29800 # type: textblock
29801 #. type: textblock
29802 #: ../fish/guestfish-actions.pod:3971
29803 msgid ""
29804 "One consequence of this is that log messages aren't caught by the library "
29805 "and handled by L</set-log-message-callback>, but go straight to stdout."
29806 msgstr ""
29807
29808 # type: =head2
29809 #. type: =head2
29810 #: ../fish/guestfish-actions.pod:3980
29811 msgid "set-e2label"
29812 msgstr ""
29813
29814 # type: verbatim
29815 #. type: verbatim
29816 #: ../fish/guestfish-actions.pod:3982
29817 #, no-wrap
29818 msgid ""
29819 " set-e2label device label\n"
29820 "\n"
29821 msgstr ""
29822
29823 # type: textblock
29824 #. type: textblock
29825 #: ../fish/guestfish-actions.pod:3988
29826 msgid ""
29827 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
29828 "label on a filesystem."
29829 msgstr ""
29830
29831 # type: =head2
29832 #. type: =head2
29833 #: ../fish/guestfish-actions.pod:3991
29834 msgid "set-e2uuid"
29835 msgstr ""
29836
29837 # type: verbatim
29838 #. type: verbatim
29839 #: ../fish/guestfish-actions.pod:3993
29840 #, no-wrap
29841 msgid ""
29842 " set-e2uuid device uuid\n"
29843 "\n"
29844 msgstr ""
29845
29846 # type: textblock
29847 #. type: textblock
29848 #: ../fish/guestfish-actions.pod:4000
29849 msgid ""
29850 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
29851 "UUID of a filesystem."
29852 msgstr ""
29853
29854 # type: =head2
29855 #. type: =head2
29856 #: ../fish/guestfish-actions.pod:4003
29857 msgid "set-memsize"
29858 msgstr ""
29859
29860 # type: =head2
29861 #. type: =head2
29862 #: ../fish/guestfish-actions.pod:4005
29863 msgid "memsize"
29864 msgstr ""
29865
29866 # type: verbatim
29867 #. type: verbatim
29868 #: ../fish/guestfish-actions.pod:4007
29869 #, no-wrap
29870 msgid ""
29871 " set-memsize memsize\n"
29872 "\n"
29873 msgstr ""
29874
29875 # type: textblock
29876 #. type: textblock
29877 #: ../fish/guestfish-actions.pod:4009
29878 msgid ""
29879 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
29880 "This only has any effect if called before L</launch>."
29881 msgstr ""
29882
29883 # type: =head2
29884 #. type: =head2
29885 #: ../fish/guestfish-actions.pod:4020
29886 msgid "set-network"
29887 msgstr ""
29888
29889 # type: =head2
29890 #. type: =head2
29891 #: ../fish/guestfish-actions.pod:4022
29892 msgid "network"
29893 msgstr ""
29894
29895 # type: verbatim
29896 #. type: verbatim
29897 #: ../fish/guestfish-actions.pod:4024
29898 #, no-wrap
29899 msgid ""
29900 " set-network true|false\n"
29901 "\n"
29902 msgstr ""
29903
29904 # type: textblock
29905 #. type: textblock
29906 #: ../fish/guestfish-actions.pod:4032
29907 msgid ""
29908 "You must call this before calling L</launch>, otherwise it has no effect."
29909 msgstr ""
29910
29911 # type: =head2
29912 #. type: =head2
29913 #: ../fish/guestfish-actions.pod:4035
29914 msgid "set-path"
29915 msgstr ""
29916
29917 # type: =head2
29918 #. type: =head2
29919 #: ../fish/guestfish-actions.pod:4037
29920 msgid "path"
29921 msgstr ""
29922
29923 # type: verbatim
29924 #. type: verbatim
29925 #: ../fish/guestfish-actions.pod:4039
29926 #, no-wrap
29927 msgid ""
29928 " set-path searchpath\n"
29929 "\n"
29930 msgstr ""
29931
29932 # type: =head2
29933 #. type: =head2
29934 #: ../fish/guestfish-actions.pod:4048
29935 msgid "set-qemu"
29936 msgstr ""
29937
29938 # type: =head2
29939 #. type: =head2
29940 #: ../fish/guestfish-actions.pod:4050
29941 msgid "qemu"
29942 msgstr ""
29943
29944 # type: verbatim
29945 #. type: verbatim
29946 #: ../fish/guestfish-actions.pod:4052
29947 #, no-wrap
29948 msgid ""
29949 " set-qemu qemu\n"
29950 "\n"
29951 msgstr ""
29952
29953 # type: =head2
29954 #. type: =head2
29955 #: ../fish/guestfish-actions.pod:4072
29956 msgid "set-recovery-proc"
29957 msgstr ""
29958
29959 # type: =head2
29960 #. type: =head2
29961 #: ../fish/guestfish-actions.pod:4074
29962 msgid "recovery-proc"
29963 msgstr ""
29964
29965 # type: verbatim
29966 #. type: verbatim
29967 #: ../fish/guestfish-actions.pod:4076
29968 #, no-wrap
29969 msgid ""
29970 " set-recovery-proc true|false\n"
29971 "\n"
29972 msgstr ""
29973
29974 # type: textblock
29975 #. type: textblock
29976 #: ../fish/guestfish-actions.pod:4078
29977 msgid ""
29978 "If this is called with the parameter C<false> then L</launch> does not "
29979 "create a recovery process.  The purpose of the recovery process is to stop "
29980 "runaway qemu processes in the case where the main program aborts abruptly."
29981 msgstr ""
29982
29983 # type: textblock
29984 #. type: textblock
29985 #: ../fish/guestfish-actions.pod:4083
29986 msgid ""
29987 "This only has any effect if called before L</launch>, and the default is "
29988 "true."
29989 msgstr ""
29990
29991 # type: =head2
29992 #. type: =head2
29993 #: ../fish/guestfish-actions.pod:4092
29994 msgid "set-selinux"
29995 msgstr ""
29996
29997 # type: =head2
29998 #. type: =head2
29999 #: ../fish/guestfish-actions.pod:4094
30000 msgid "selinux"
30001 msgstr ""
30002
30003 # type: verbatim
30004 #. type: verbatim
30005 #: ../fish/guestfish-actions.pod:4096
30006 #, no-wrap
30007 msgid ""
30008 " set-selinux true|false\n"
30009 "\n"
30010 msgstr ""
30011
30012 # type: =head2
30013 #. type: =head2
30014 #: ../fish/guestfish-actions.pod:4107
30015 msgid "set-trace"
30016 msgstr ""
30017
30018 # type: =head2
30019 #. type: =head2
30020 #: ../fish/guestfish-actions.pod:4109
30021 msgid "trace"
30022 msgstr ""
30023
30024 # type: verbatim
30025 #. type: verbatim
30026 #: ../fish/guestfish-actions.pod:4111
30027 #, no-wrap
30028 msgid ""
30029 " set-trace true|false\n"
30030 "\n"
30031 msgstr ""
30032
30033 #. type: textblock
30034 #: ../fish/guestfish-actions.pod:4123
30035 msgid ""
30036 "Trace messages are normally sent to C<stderr>, unless you register a "
30037 "callback to send them somewhere else (see L</set-event-callback>)."
30038 msgstr ""
30039
30040 # type: =head2
30041 #. type: =head2
30042 #: ../fish/guestfish-actions.pod:4127
30043 msgid "set-verbose"
30044 msgstr ""
30045
30046 # type: =head2
30047 #. type: =head2
30048 #: ../fish/guestfish-actions.pod:4129
30049 msgid "verbose"
30050 msgstr ""
30051
30052 # type: verbatim
30053 #. type: verbatim
30054 #: ../fish/guestfish-actions.pod:4131
30055 #, no-wrap
30056 msgid ""
30057 " set-verbose true|false\n"
30058 "\n"
30059 msgstr ""
30060
30061 #. type: textblock
30062 #: ../fish/guestfish-actions.pod:4138
30063 msgid ""
30064 "Verbose messages are normally sent to C<stderr>, unless you register a "
30065 "callback to send them somewhere else (see L</set-event-callback>)."
30066 msgstr ""
30067
30068 # type: =head2
30069 #. type: =head2
30070 #: ../fish/guestfish-actions.pod:4142
30071 msgid "setcon"
30072 msgstr ""
30073
30074 # type: verbatim
30075 #. type: verbatim
30076 #: ../fish/guestfish-actions.pod:4144
30077 #, no-wrap
30078 msgid ""
30079 " setcon context\n"
30080 "\n"
30081 msgstr ""
30082
30083 # type: =head2
30084 #. type: =head2
30085 #: ../fish/guestfish-actions.pod:4151
30086 msgid "setxattr"
30087 msgstr ""
30088
30089 # type: verbatim
30090 #. type: verbatim
30091 #: ../fish/guestfish-actions.pod:4153
30092 #, no-wrap
30093 msgid ""
30094 " setxattr xattr val vallen path\n"
30095 "\n"
30096 msgstr ""
30097
30098 # type: textblock
30099 #. type: textblock
30100 #: ../fish/guestfish-actions.pod:4159
30101 msgid "See also: L</lsetxattr>, L<attr(5)>."
30102 msgstr ""
30103
30104 # type: =head2
30105 #. type: =head2
30106 #: ../fish/guestfish-actions.pod:4161
30107 msgid "sfdisk"
30108 msgstr ""
30109
30110 # type: verbatim
30111 #. type: verbatim
30112 #: ../fish/guestfish-actions.pod:4163
30113 #, no-wrap
30114 msgid ""
30115 " sfdisk device cyls heads sectors 'lines ...'\n"
30116 "\n"
30117 msgstr ""
30118
30119 # type: textblock
30120 #. type: textblock
30121 #: ../fish/guestfish-actions.pod:4185
30122 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
30123 msgstr ""
30124
30125 # type: =head2
30126 #. type: =head2
30127 #: ../fish/guestfish-actions.pod:4198
30128 msgid "sfdiskM"
30129 msgstr ""
30130
30131 # type: verbatim
30132 #. type: verbatim
30133 #: ../fish/guestfish-actions.pod:4200
30134 #, no-wrap
30135 msgid ""
30136 " sfdiskM device 'lines ...'\n"
30137 "\n"
30138 msgstr ""
30139
30140 # type: textblock
30141 #. type: textblock
30142 #: ../fish/guestfish-actions.pod:4202
30143 msgid ""
30144 "This is a simplified interface to the L</sfdisk> command, where partition "
30145 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
30146 "you don't need to specify the cyls, heads and sectors parameters which were "
30147 "rarely if ever used anyway."
30148 msgstr ""
30149
30150 # type: textblock
30151 #. type: textblock
30152 #: ../fish/guestfish-actions.pod:4208
30153 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
30154 msgstr ""
30155
30156 # type: =head2
30157 #. type: =head2
30158 #: ../fish/guestfish-actions.pod:4221
30159 msgid "sfdisk-N"
30160 msgstr ""
30161
30162 # type: verbatim
30163 #. type: verbatim
30164 #: ../fish/guestfish-actions.pod:4223
30165 #, no-wrap
30166 msgid ""
30167 " sfdisk-N device partnum cyls heads sectors line\n"
30168 "\n"
30169 msgstr ""
30170
30171 # type: textblock
30172 #. type: textblock
30173 #: ../fish/guestfish-actions.pod:4228
30174 msgid ""
30175 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
30176 "cyls/heads/sectors parameters."
30177 msgstr ""
30178
30179 # type: textblock
30180 #. type: textblock
30181 #: ../fish/guestfish-actions.pod:4231
30182 msgid "See also: L</part-add>"
30183 msgstr ""
30184
30185 # type: =head2
30186 #. type: =head2
30187 #: ../fish/guestfish-actions.pod:4243
30188 msgid "sfdisk-disk-geometry"
30189 msgstr ""
30190
30191 # type: verbatim
30192 #. type: verbatim
30193 #: ../fish/guestfish-actions.pod:4245
30194 #, no-wrap
30195 msgid ""
30196 " sfdisk-disk-geometry device\n"
30197 "\n"
30198 msgstr ""
30199
30200 # type: textblock
30201 #. type: textblock
30202 #: ../fish/guestfish-actions.pod:4247
30203 msgid ""
30204 "This displays the disk geometry of C<device> read from the partition table.  "
30205 "Especially in the case where the underlying block device has been resized, "
30206 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
30207 "kernel-geometry>)."
30208 msgstr ""
30209
30210 # type: =head2
30211 #. type: =head2
30212 #: ../fish/guestfish-actions.pod:4255
30213 msgid "sfdisk-kernel-geometry"
30214 msgstr ""
30215
30216 # type: verbatim
30217 #. type: verbatim
30218 #: ../fish/guestfish-actions.pod:4257
30219 #, no-wrap
30220 msgid ""
30221 " sfdisk-kernel-geometry device\n"
30222 "\n"
30223 msgstr ""
30224
30225 # type: =head2
30226 #. type: =head2
30227 #: ../fish/guestfish-actions.pod:4264
30228 msgid "sfdisk-l"
30229 msgstr ""
30230
30231 # type: verbatim
30232 #. type: verbatim
30233 #: ../fish/guestfish-actions.pod:4266
30234 #, no-wrap
30235 msgid ""
30236 " sfdisk-l device\n"
30237 "\n"
30238 msgstr ""
30239
30240 # type: textblock
30241 #. type: textblock
30242 #: ../fish/guestfish-actions.pod:4272
30243 msgid "See also: L</part-list>"
30244 msgstr ""
30245
30246 # type: =head2
30247 #. type: =head2
30248 #: ../fish/guestfish-actions.pod:4281
30249 msgid "sh"
30250 msgstr ""
30251
30252 # type: verbatim
30253 #. type: verbatim
30254 #: ../fish/guestfish-actions.pod:4283
30255 #, no-wrap
30256 msgid ""
30257 " sh command\n"
30258 "\n"
30259 msgstr ""
30260
30261 # type: textblock
30262 #. type: textblock
30263 #: ../fish/guestfish-actions.pod:4288
30264 msgid "This is like L</command>, but passes the command to:"
30265 msgstr ""
30266
30267 # type: textblock
30268 #. type: textblock
30269 #: ../fish/guestfish-actions.pod:4296
30270 msgid "All the provisos about L</command> apply to this call."
30271 msgstr ""
30272
30273 # type: =head2
30274 #. type: =head2
30275 #: ../fish/guestfish-actions.pod:4298
30276 msgid "sh-lines"
30277 msgstr ""
30278
30279 # type: verbatim
30280 #. type: verbatim
30281 #: ../fish/guestfish-actions.pod:4300
30282 #, no-wrap
30283 msgid ""
30284 " sh-lines command\n"
30285 "\n"
30286 msgstr ""
30287
30288 # type: textblock
30289 #. type: textblock
30290 #: ../fish/guestfish-actions.pod:4302
30291 msgid "This is the same as L</sh>, but splits the result into a list of lines."
30292 msgstr ""
30293
30294 # type: textblock
30295 #. type: textblock
30296 #: ../fish/guestfish-actions.pod:4305
30297 msgid "See also: L</command-lines>"
30298 msgstr ""
30299
30300 # type: =head2
30301 #. type: =head2
30302 #: ../fish/guestfish-actions.pod:4307
30303 msgid "sleep"
30304 msgstr ""
30305
30306 # type: verbatim
30307 #. type: verbatim
30308 #: ../fish/guestfish-actions.pod:4309
30309 #, no-wrap
30310 msgid ""
30311 " sleep secs\n"
30312 "\n"
30313 msgstr ""
30314
30315 # type: =head2
30316 #. type: =head2
30317 #: ../fish/guestfish-actions.pod:4313
30318 msgid "stat"
30319 msgstr ""
30320
30321 # type: verbatim
30322 #. type: verbatim
30323 #: ../fish/guestfish-actions.pod:4315
30324 #, no-wrap
30325 msgid ""
30326 " stat path\n"
30327 "\n"
30328 msgstr ""
30329
30330 # type: =head2
30331 #. type: =head2
30332 #: ../fish/guestfish-actions.pod:4321
30333 msgid "statvfs"
30334 msgstr ""
30335
30336 # type: verbatim
30337 #. type: verbatim
30338 #: ../fish/guestfish-actions.pod:4323
30339 #, no-wrap
30340 msgid ""
30341 " statvfs path\n"
30342 "\n"
30343 msgstr ""
30344
30345 # type: =head2
30346 #. type: =head2
30347 #: ../fish/guestfish-actions.pod:4331
30348 msgid "strings"
30349 msgstr ""
30350
30351 # type: verbatim
30352 #. type: verbatim
30353 #: ../fish/guestfish-actions.pod:4333
30354 #, no-wrap
30355 msgid ""
30356 " strings path\n"
30357 "\n"
30358 msgstr ""
30359
30360 # type: =head2
30361 #. type: =head2
30362 #: ../fish/guestfish-actions.pod:4341
30363 msgid "strings-e"
30364 msgstr ""
30365
30366 # type: verbatim
30367 #. type: verbatim
30368 #: ../fish/guestfish-actions.pod:4343
30369 #, no-wrap
30370 msgid ""
30371 " strings-e encoding path\n"
30372 "\n"
30373 msgstr ""
30374
30375 # type: textblock
30376 #. type: textblock
30377 #: ../fish/guestfish-actions.pod:4345
30378 msgid ""
30379 "This is like the L</strings> command, but allows you to specify the encoding "
30380 "of strings that are looked for in the source file C<path>."
30381 msgstr ""
30382
30383 # type: textblock
30384 #. type: textblock
30385 #: ../fish/guestfish-actions.pod:4355
30386 msgid ""
30387 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
30388 "ISO-8859-X (this is what L</strings> uses)."
30389 msgstr ""
30390
30391 # type: =head2
30392 #. type: =head2
30393 #: ../fish/guestfish-actions.pod:4387
30394 msgid "swapoff-device"
30395 msgstr ""
30396
30397 # type: verbatim
30398 #. type: verbatim
30399 #: ../fish/guestfish-actions.pod:4389
30400 #, no-wrap
30401 msgid ""
30402 " swapoff-device device\n"
30403 "\n"
30404 msgstr ""
30405
30406 # type: textblock
30407 #. type: textblock
30408 #: ../fish/guestfish-actions.pod:4391
30409 msgid ""
30410 "This command disables the libguestfs appliance swap device or partition "
30411 "named C<device>.  See L</swapon-device>."
30412 msgstr ""
30413
30414 # type: =head2
30415 #. type: =head2
30416 #: ../fish/guestfish-actions.pod:4395
30417 msgid "swapoff-file"
30418 msgstr ""
30419
30420 # type: verbatim
30421 #. type: verbatim
30422 #: ../fish/guestfish-actions.pod:4397
30423 #, no-wrap
30424 msgid ""
30425 " swapoff-file file\n"
30426 "\n"
30427 msgstr ""
30428
30429 # type: =head2
30430 #. type: =head2
30431 #: ../fish/guestfish-actions.pod:4401
30432 msgid "swapoff-label"
30433 msgstr ""
30434
30435 # type: verbatim
30436 #. type: verbatim
30437 #: ../fish/guestfish-actions.pod:4403
30438 #, no-wrap
30439 msgid ""
30440 " swapoff-label label\n"
30441 "\n"
30442 msgstr ""
30443
30444 # type: =head2
30445 #. type: =head2
30446 #: ../fish/guestfish-actions.pod:4408
30447 msgid "swapoff-uuid"
30448 msgstr ""
30449
30450 # type: verbatim
30451 #. type: verbatim
30452 #: ../fish/guestfish-actions.pod:4410
30453 #, no-wrap
30454 msgid ""
30455 " swapoff-uuid uuid\n"
30456 "\n"
30457 msgstr ""
30458
30459 # type: =head2
30460 #. type: =head2
30461 #: ../fish/guestfish-actions.pod:4415
30462 msgid "swapon-device"
30463 msgstr ""
30464
30465 # type: verbatim
30466 #. type: verbatim
30467 #: ../fish/guestfish-actions.pod:4417
30468 #, no-wrap
30469 msgid ""
30470 " swapon-device device\n"
30471 "\n"
30472 msgstr ""
30473
30474 # type: textblock
30475 #. type: textblock
30476 #: ../fish/guestfish-actions.pod:4419
30477 msgid ""
30478 "This command enables the libguestfs appliance to use the swap device or "
30479 "partition named C<device>.  The increased memory is made available for all "
30480 "commands, for example those run using L</command> or L</sh>."
30481 msgstr ""
30482
30483 # type: =head2
30484 #. type: =head2
30485 #: ../fish/guestfish-actions.pod:4431
30486 msgid "swapon-file"
30487 msgstr ""
30488
30489 # type: verbatim
30490 #. type: verbatim
30491 #: ../fish/guestfish-actions.pod:4433
30492 #, no-wrap
30493 msgid ""
30494 " swapon-file file\n"
30495 "\n"
30496 msgstr ""
30497
30498 # type: textblock
30499 #. type: textblock
30500 #: ../fish/guestfish-actions.pod:4435
30501 msgid ""
30502 "This command enables swap to a file.  See L</swapon-device> for other notes."
30503 msgstr ""
30504
30505 # type: =head2
30506 #. type: =head2
30507 #: ../fish/guestfish-actions.pod:4438
30508 msgid "swapon-label"
30509 msgstr ""
30510
30511 # type: verbatim
30512 #. type: verbatim
30513 #: ../fish/guestfish-actions.pod:4440
30514 #, no-wrap
30515 msgid ""
30516 " swapon-label label\n"
30517 "\n"
30518 msgstr ""
30519
30520 # type: textblock
30521 #. type: textblock
30522 #: ../fish/guestfish-actions.pod:4442
30523 msgid ""
30524 "This command enables swap to a labeled swap partition.  See L</swapon-"
30525 "device> for other notes."
30526 msgstr ""
30527
30528 # type: =head2
30529 #. type: =head2
30530 #: ../fish/guestfish-actions.pod:4445
30531 msgid "swapon-uuid"
30532 msgstr ""
30533
30534 # type: verbatim
30535 #. type: verbatim
30536 #: ../fish/guestfish-actions.pod:4447
30537 #, no-wrap
30538 msgid ""
30539 " swapon-uuid uuid\n"
30540 "\n"
30541 msgstr ""
30542
30543 # type: textblock
30544 #. type: textblock
30545 #: ../fish/guestfish-actions.pod:4449
30546 msgid ""
30547 "This command enables swap to a swap partition with the given UUID.  See L</"
30548 "swapon-device> for other notes."
30549 msgstr ""
30550
30551 # type: =head2
30552 #. type: =head2
30553 #: ../fish/guestfish-actions.pod:4452
30554 msgid "sync"
30555 msgstr ""
30556
30557 # type: verbatim
30558 #. type: verbatim
30559 #: ../fish/guestfish-actions.pod:4454
30560 #, no-wrap
30561 msgid ""
30562 " sync\n"
30563 "\n"
30564 msgstr ""
30565
30566 # type: =head2
30567 #. type: =head2
30568 #: ../fish/guestfish-actions.pod:4462
30569 msgid "tail"
30570 msgstr ""
30571
30572 # type: verbatim
30573 #. type: verbatim
30574 #: ../fish/guestfish-actions.pod:4464
30575 #, no-wrap
30576 msgid ""
30577 " tail path\n"
30578 "\n"
30579 msgstr ""
30580
30581 # type: =head2
30582 #. type: =head2
30583 #: ../fish/guestfish-actions.pod:4472
30584 msgid "tail-n"
30585 msgstr ""
30586
30587 # type: verbatim
30588 #. type: verbatim
30589 #: ../fish/guestfish-actions.pod:4474
30590 #, no-wrap
30591 msgid ""
30592 " tail-n nrlines path\n"
30593 "\n"
30594 msgstr ""
30595
30596 # type: =head2
30597 #. type: =head2
30598 #: ../fish/guestfish-actions.pod:4487
30599 msgid "tar-in"
30600 msgstr ""
30601
30602 # type: verbatim
30603 #. type: verbatim
30604 #: ../fish/guestfish-actions.pod:4489
30605 #, no-wrap
30606 msgid ""
30607 " tar-in (tarfile|-) directory\n"
30608 "\n"
30609 msgstr ""
30610
30611 # type: textblock
30612 #. type: textblock
30613 #: ../fish/guestfish-actions.pod:4494
30614 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
30615 msgstr ""
30616
30617 # type: =head2
30618 #. type: =head2
30619 #: ../fish/guestfish-actions.pod:4499
30620 msgid "tar-out"
30621 msgstr ""
30622
30623 # type: verbatim
30624 #. type: verbatim
30625 #: ../fish/guestfish-actions.pod:4501
30626 #, no-wrap
30627 msgid ""
30628 " tar-out directory (tarfile|-)\n"
30629 "\n"
30630 msgstr ""
30631
30632 # type: textblock
30633 #. type: textblock
30634 #: ../fish/guestfish-actions.pod:4506
30635 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
30636 msgstr ""
30637
30638 # type: =head2
30639 #. type: =head2
30640 #: ../fish/guestfish-actions.pod:4511
30641 msgid "tgz-in"
30642 msgstr ""
30643
30644 # type: verbatim
30645 #. type: verbatim
30646 #: ../fish/guestfish-actions.pod:4513
30647 #, no-wrap
30648 msgid ""
30649 " tgz-in (tarball|-) directory\n"
30650 "\n"
30651 msgstr ""
30652
30653 # type: textblock
30654 #. type: textblock
30655 #: ../fish/guestfish-actions.pod:4518
30656 msgid "To upload an uncompressed tarball, use L</tar-in>."
30657 msgstr ""
30658
30659 # type: =head2
30660 #. type: =head2
30661 #: ../fish/guestfish-actions.pod:4522
30662 msgid "tgz-out"
30663 msgstr ""
30664
30665 # type: verbatim
30666 #. type: verbatim
30667 #: ../fish/guestfish-actions.pod:4524
30668 #, no-wrap
30669 msgid ""
30670 " tgz-out directory (tarball|-)\n"
30671 "\n"
30672 msgstr ""
30673
30674 # type: textblock
30675 #. type: textblock
30676 #: ../fish/guestfish-actions.pod:4529
30677 msgid "To download an uncompressed tarball, use L</tar-out>."
30678 msgstr ""
30679
30680 # type: =head2
30681 #. type: =head2
30682 #: ../fish/guestfish-actions.pod:4533
30683 msgid "touch"
30684 msgstr ""
30685
30686 # type: verbatim
30687 #. type: verbatim
30688 #: ../fish/guestfish-actions.pod:4535
30689 #, no-wrap
30690 msgid ""
30691 " touch path\n"
30692 "\n"
30693 msgstr ""
30694
30695 # type: =head2
30696 #. type: =head2
30697 #: ../fish/guestfish-actions.pod:4544
30698 msgid "truncate"
30699 msgstr ""
30700
30701 # type: verbatim
30702 #. type: verbatim
30703 #: ../fish/guestfish-actions.pod:4546
30704 #, no-wrap
30705 msgid ""
30706 " truncate path\n"
30707 "\n"
30708 msgstr ""
30709
30710 # type: =head2
30711 #. type: =head2
30712 #: ../fish/guestfish-actions.pod:4551
30713 msgid "truncate-size"
30714 msgstr ""
30715
30716 # type: verbatim
30717 #. type: verbatim
30718 #: ../fish/guestfish-actions.pod:4553
30719 #, no-wrap
30720 msgid ""
30721 " truncate-size path size\n"
30722 "\n"
30723 msgstr ""
30724
30725 # type: textblock
30726 #. type: textblock
30727 #: ../fish/guestfish-actions.pod:4558
30728 msgid ""
30729 "If the current file size is less than C<size> then the file is extended to "
30730 "the required size with zero bytes.  This creates a sparse file (ie. disk "
30731 "blocks are not allocated for the file until you write to it).  To create a "
30732 "non-sparse file of zeroes, use L</fallocate64> instead."
30733 msgstr ""
30734
30735 # type: =head2
30736 #. type: =head2
30737 #: ../fish/guestfish-actions.pod:4564
30738 msgid "tune2fs-l"
30739 msgstr ""
30740
30741 # type: verbatim
30742 #. type: verbatim
30743 #: ../fish/guestfish-actions.pod:4566
30744 #, no-wrap
30745 msgid ""
30746 " tune2fs-l device\n"
30747 "\n"
30748 msgstr ""
30749
30750 # type: =head2
30751 #. type: =head2
30752 #: ../fish/guestfish-actions.pod:4576
30753 msgid "txz-in"
30754 msgstr ""
30755
30756 # type: verbatim
30757 #. type: verbatim
30758 #: ../fish/guestfish-actions.pod:4578
30759 #, no-wrap
30760 msgid ""
30761 " txz-in (tarball|-) directory\n"
30762 "\n"
30763 msgstr ""
30764
30765 # type: =head2
30766 #. type: =head2
30767 #: ../fish/guestfish-actions.pod:4585
30768 msgid "txz-out"
30769 msgstr ""
30770
30771 # type: verbatim
30772 #. type: verbatim
30773 #: ../fish/guestfish-actions.pod:4587
30774 #, no-wrap
30775 msgid ""
30776 " txz-out directory (tarball|-)\n"
30777 "\n"
30778 msgstr ""
30779
30780 # type: =head2
30781 #. type: =head2
30782 #: ../fish/guestfish-actions.pod:4594
30783 msgid "umask"
30784 msgstr ""
30785
30786 # type: verbatim
30787 #. type: verbatim
30788 #: ../fish/guestfish-actions.pod:4596
30789 #, no-wrap
30790 msgid ""
30791 " umask mask\n"
30792 "\n"
30793 msgstr ""
30794
30795 # type: textblock
30796 #. type: textblock
30797 #: ../fish/guestfish-actions.pod:4610
30798 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
30799 msgstr ""
30800
30801 # type: =head2
30802 #. type: =head2
30803 #: ../fish/guestfish-actions.pod:4615
30804 msgid "umount"
30805 msgstr ""
30806
30807 # type: =head2
30808 #. type: =head2
30809 #: ../fish/guestfish-actions.pod:4617
30810 msgid "unmount"
30811 msgstr ""
30812
30813 # type: verbatim
30814 #. type: verbatim
30815 #: ../fish/guestfish-actions.pod:4619
30816 #, no-wrap
30817 msgid ""
30818 " umount pathordevice\n"
30819 "\n"
30820 msgstr ""
30821
30822 # type: =head2
30823 #. type: =head2
30824 #: ../fish/guestfish-actions.pod:4625
30825 msgid "umount-all"
30826 msgstr ""
30827
30828 # type: =head2
30829 #. type: =head2
30830 #: ../fish/guestfish-actions.pod:4627
30831 msgid "unmount-all"
30832 msgstr ""
30833
30834 # type: verbatim
30835 #. type: verbatim
30836 #: ../fish/guestfish-actions.pod:4629
30837 #, no-wrap
30838 msgid ""
30839 " umount-all\n"
30840 "\n"
30841 msgstr ""
30842
30843 # type: =head2
30844 #. type: =head2
30845 #: ../fish/guestfish-actions.pod:4635
30846 msgid "upload"
30847 msgstr ""
30848
30849 # type: verbatim
30850 #. type: verbatim
30851 #: ../fish/guestfish-actions.pod:4637
30852 #, no-wrap
30853 msgid ""
30854 " upload (filename|-) remotefilename\n"
30855 "\n"
30856 msgstr ""
30857
30858 # type: textblock
30859 #. type: textblock
30860 #: ../fish/guestfish-actions.pod:4644
30861 msgid "See also L</download>."
30862 msgstr ""
30863
30864 # type: =head2
30865 #. type: =head2
30866 #: ../fish/guestfish-actions.pod:4648
30867 msgid "upload-offset"
30868 msgstr ""
30869
30870 # type: verbatim
30871 #. type: verbatim
30872 #: ../fish/guestfish-actions.pod:4650
30873 #, no-wrap
30874 msgid ""
30875 " upload-offset (filename|-) remotefilename offset\n"
30876 "\n"
30877 msgstr ""
30878
30879 # type: textblock
30880 #. type: textblock
30881 #: ../fish/guestfish-actions.pod:4662
30882 msgid ""
30883 "Note that there is no limit on the amount of data that can be uploaded with "
30884 "this call, unlike with L</pwrite>, and this call always writes the full "
30885 "amount unless an error occurs."
30886 msgstr ""
30887
30888 # type: textblock
30889 #. type: textblock
30890 #: ../fish/guestfish-actions.pod:4667
30891 msgid "See also L</upload>, L</pwrite>."
30892 msgstr ""
30893
30894 # type: =head2
30895 #. type: =head2
30896 #: ../fish/guestfish-actions.pod:4671
30897 msgid "utimens"
30898 msgstr ""
30899
30900 # type: verbatim
30901 #. type: verbatim
30902 #: ../fish/guestfish-actions.pod:4673
30903 #, no-wrap
30904 msgid ""
30905 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
30906 "\n"
30907 msgstr ""
30908
30909 # type: =head2
30910 #. type: =head2
30911 #: ../fish/guestfish-actions.pod:4692
30912 msgid "version"
30913 msgstr ""
30914
30915 # type: verbatim
30916 #. type: verbatim
30917 #: ../fish/guestfish-actions.pod:4694
30918 #, no-wrap
30919 msgid ""
30920 " version\n"
30921 "\n"
30922 msgstr ""
30923
30924 # type: textblock
30925 #. type: textblock
30926 #: ../fish/guestfish-actions.pod:4721
30927 msgid ""
30928 "I<Note:> Don't use this call to test for availability of features.  In "
30929 "enterprise distributions we backport features from later versions into "
30930 "earlier versions, making this an unreliable way to test for features.  Use "
30931 "L</available> instead."
30932 msgstr ""
30933
30934 # type: =head2
30935 #. type: =head2
30936 #: ../fish/guestfish-actions.pod:4727
30937 msgid "vfs-label"
30938 msgstr ""
30939
30940 # type: verbatim
30941 #. type: verbatim
30942 #: ../fish/guestfish-actions.pod:4729
30943 #, no-wrap
30944 msgid ""
30945 " vfs-label device\n"
30946 "\n"
30947 msgstr ""
30948
30949 # type: textblock
30950 #. type: textblock
30951 #: ../fish/guestfish-actions.pod:4736
30952 msgid "To find a filesystem from the label, use L</findfs-label>."
30953 msgstr ""
30954
30955 # type: =head2
30956 #. type: =head2
30957 #: ../fish/guestfish-actions.pod:4738
30958 msgid "vfs-type"
30959 msgstr ""
30960
30961 # type: verbatim
30962 #. type: verbatim
30963 #: ../fish/guestfish-actions.pod:4740
30964 #, no-wrap
30965 msgid ""
30966 " vfs-type device\n"
30967 "\n"
30968 msgstr ""
30969
30970 # type: =head2
30971 #. type: =head2
30972 #: ../fish/guestfish-actions.pod:4750
30973 msgid "vfs-uuid"
30974 msgstr ""
30975
30976 # type: verbatim
30977 #. type: verbatim
30978 #: ../fish/guestfish-actions.pod:4752
30979 #, no-wrap
30980 msgid ""
30981 " vfs-uuid device\n"
30982 "\n"
30983 msgstr ""
30984
30985 # type: textblock
30986 #. type: textblock
30987 #: ../fish/guestfish-actions.pod:4759
30988 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
30989 msgstr ""
30990
30991 # type: =head2
30992 #. type: =head2
30993 #: ../fish/guestfish-actions.pod:4761
30994 msgid "vg-activate"
30995 msgstr ""
30996
30997 # type: verbatim
30998 #. type: verbatim
30999 #: ../fish/guestfish-actions.pod:4763
31000 #, no-wrap
31001 msgid ""
31002 " vg-activate true|false 'volgroups ...'\n"
31003 "\n"
31004 msgstr ""
31005
31006 # type: =head2
31007 #. type: =head2
31008 #: ../fish/guestfish-actions.pod:4776
31009 msgid "vg-activate-all"
31010 msgstr ""
31011
31012 # type: verbatim
31013 #. type: verbatim
31014 #: ../fish/guestfish-actions.pod:4778
31015 #, no-wrap
31016 msgid ""
31017 " vg-activate-all true|false\n"
31018 "\n"
31019 msgstr ""
31020
31021 # type: =head2
31022 #. type: =head2
31023 #: ../fish/guestfish-actions.pod:4788
31024 msgid "vgcreate"
31025 msgstr ""
31026
31027 # type: verbatim
31028 #. type: verbatim
31029 #: ../fish/guestfish-actions.pod:4790
31030 #, no-wrap
31031 msgid ""
31032 " vgcreate volgroup 'physvols ...'\n"
31033 "\n"
31034 msgstr ""
31035
31036 # type: =head2
31037 #. type: =head2
31038 #: ../fish/guestfish-actions.pod:4795
31039 msgid "vglvuuids"
31040 msgstr ""
31041
31042 # type: verbatim
31043 #. type: verbatim
31044 #: ../fish/guestfish-actions.pod:4797
31045 #, no-wrap
31046 msgid ""
31047 " vglvuuids vgname\n"
31048 "\n"
31049 msgstr ""
31050
31051 # type: textblock
31052 #. type: textblock
31053 #: ../fish/guestfish-actions.pod:4802
31054 msgid ""
31055 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
31056 "logical volumes and volume groups."
31057 msgstr ""
31058
31059 # type: textblock
31060 #. type: textblock
31061 #: ../fish/guestfish-actions.pod:4805
31062 msgid "See also L</vgpvuuids>."
31063 msgstr ""
31064
31065 # type: =head2
31066 #. type: =head2
31067 #: ../fish/guestfish-actions.pod:4807
31068 msgid "vgpvuuids"
31069 msgstr ""
31070
31071 # type: verbatim
31072 #. type: verbatim
31073 #: ../fish/guestfish-actions.pod:4809
31074 #, no-wrap
31075 msgid ""
31076 " vgpvuuids vgname\n"
31077 "\n"
31078 msgstr ""
31079
31080 # type: textblock
31081 #. type: textblock
31082 #: ../fish/guestfish-actions.pod:4814
31083 msgid ""
31084 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
31085 "physical volumes and volume groups."
31086 msgstr ""
31087
31088 # type: textblock
31089 #. type: textblock
31090 #: ../fish/guestfish-actions.pod:4817
31091 msgid "See also L</vglvuuids>."
31092 msgstr ""
31093
31094 # type: =head2
31095 #. type: =head2
31096 #: ../fish/guestfish-actions.pod:4819
31097 msgid "vgremove"
31098 msgstr ""
31099
31100 # type: verbatim
31101 #. type: verbatim
31102 #: ../fish/guestfish-actions.pod:4821
31103 #, no-wrap
31104 msgid ""
31105 " vgremove vgname\n"
31106 "\n"
31107 msgstr ""
31108
31109 # type: =head2
31110 #. type: =head2
31111 #: ../fish/guestfish-actions.pod:4828
31112 msgid "vgrename"
31113 msgstr ""
31114
31115 # type: verbatim
31116 #. type: verbatim
31117 #: ../fish/guestfish-actions.pod:4830
31118 #, no-wrap
31119 msgid ""
31120 " vgrename volgroup newvolgroup\n"
31121 "\n"
31122 msgstr ""
31123
31124 # type: =head2
31125 #. type: =head2
31126 #: ../fish/guestfish-actions.pod:4834
31127 msgid "vgs"
31128 msgstr ""
31129
31130 # type: verbatim
31131 #. type: verbatim
31132 #: ../fish/guestfish-actions.pod:4836
31133 #, no-wrap
31134 msgid ""
31135 " vgs\n"
31136 "\n"
31137 msgstr ""
31138
31139 # type: textblock
31140 #. type: textblock
31141 #: ../fish/guestfish-actions.pod:4844
31142 msgid "See also L</vgs-full>."
31143 msgstr ""
31144
31145 # type: =head2
31146 #. type: =head2
31147 #: ../fish/guestfish-actions.pod:4846
31148 msgid "vgs-full"
31149 msgstr ""
31150
31151 # type: verbatim
31152 #. type: verbatim
31153 #: ../fish/guestfish-actions.pod:4848
31154 #, no-wrap
31155 msgid ""
31156 " vgs-full\n"
31157 "\n"
31158 msgstr ""
31159
31160 # type: =head2
31161 #. type: =head2
31162 #: ../fish/guestfish-actions.pod:4853
31163 msgid "vgscan"
31164 msgstr ""
31165
31166 # type: verbatim
31167 #. type: verbatim
31168 #: ../fish/guestfish-actions.pod:4855
31169 #, no-wrap
31170 msgid ""
31171 " vgscan\n"
31172 "\n"
31173 msgstr ""
31174
31175 # type: =head2
31176 #. type: =head2
31177 #: ../fish/guestfish-actions.pod:4860
31178 msgid "vguuid"
31179 msgstr ""
31180
31181 # type: verbatim
31182 #. type: verbatim
31183 #: ../fish/guestfish-actions.pod:4862
31184 #, no-wrap
31185 msgid ""
31186 " vguuid vgname\n"
31187 "\n"
31188 msgstr ""
31189
31190 # type: =head2
31191 #. type: =head2
31192 #: ../fish/guestfish-actions.pod:4866
31193 msgid "wc-c"
31194 msgstr ""
31195
31196 # type: verbatim
31197 #. type: verbatim
31198 #: ../fish/guestfish-actions.pod:4868
31199 #, no-wrap
31200 msgid ""
31201 " wc-c path\n"
31202 "\n"
31203 msgstr ""
31204
31205 # type: =head2
31206 #. type: =head2
31207 #: ../fish/guestfish-actions.pod:4873
31208 msgid "wc-l"
31209 msgstr ""
31210
31211 # type: verbatim
31212 #. type: verbatim
31213 #: ../fish/guestfish-actions.pod:4875
31214 #, no-wrap
31215 msgid ""
31216 " wc-l path\n"
31217 "\n"
31218 msgstr ""
31219
31220 # type: =head2
31221 #. type: =head2
31222 #: ../fish/guestfish-actions.pod:4880
31223 msgid "wc-w"
31224 msgstr ""
31225
31226 # type: verbatim
31227 #. type: verbatim
31228 #: ../fish/guestfish-actions.pod:4882
31229 #, no-wrap
31230 msgid ""
31231 " wc-w path\n"
31232 "\n"
31233 msgstr ""
31234
31235 # type: =head2
31236 #. type: =head2
31237 #: ../fish/guestfish-actions.pod:4887
31238 msgid "write"
31239 msgstr ""
31240
31241 # type: verbatim
31242 #. type: verbatim
31243 #: ../fish/guestfish-actions.pod:4889
31244 #, no-wrap
31245 msgid ""
31246 " write path content\n"
31247 "\n"
31248 msgstr ""
31249
31250 # type: =head2
31251 #. type: =head2
31252 #: ../fish/guestfish-actions.pod:4897
31253 msgid "write-file"
31254 msgstr ""
31255
31256 # type: verbatim
31257 #. type: verbatim
31258 #: ../fish/guestfish-actions.pod:4899
31259 #, no-wrap
31260 msgid ""
31261 " write-file path content size\n"
31262 "\n"
31263 msgstr ""
31264
31265 # type: =head2
31266 #. type: =head2
31267 #: ../fish/guestfish-actions.pod:4922
31268 msgid "zegrep"
31269 msgstr ""
31270
31271 # type: verbatim
31272 #. type: verbatim
31273 #: ../fish/guestfish-actions.pod:4924
31274 #, no-wrap
31275 msgid ""
31276 " zegrep regex path\n"
31277 "\n"
31278 msgstr ""
31279
31280 # type: =head2
31281 #. type: =head2
31282 #: ../fish/guestfish-actions.pod:4932
31283 msgid "zegrepi"
31284 msgstr ""
31285
31286 # type: verbatim
31287 #. type: verbatim
31288 #: ../fish/guestfish-actions.pod:4934
31289 #, no-wrap
31290 msgid ""
31291 " zegrepi regex path\n"
31292 "\n"
31293 msgstr ""
31294
31295 # type: =head2
31296 #. type: =head2
31297 #: ../fish/guestfish-actions.pod:4942
31298 msgid "zero"
31299 msgstr ""
31300
31301 # type: verbatim
31302 #. type: verbatim
31303 #: ../fish/guestfish-actions.pod:4944
31304 #, no-wrap
31305 msgid ""
31306 " zero device\n"
31307 "\n"
31308 msgstr ""
31309
31310 #. type: textblock
31311 #: ../fish/guestfish-actions.pod:4952
31312 msgid "See also: L</zero-device>, L</scrub-device>, L</is-zero-device>"
31313 msgstr ""
31314
31315 # type: =head2
31316 #. type: =head2
31317 #: ../fish/guestfish-actions.pod:4955
31318 msgid "zero-device"
31319 msgstr ""
31320
31321 # type: verbatim
31322 #. type: verbatim
31323 #: ../fish/guestfish-actions.pod:4957
31324 #, no-wrap
31325 msgid ""
31326 " zero-device device\n"
31327 "\n"
31328 msgstr ""
31329
31330 # type: textblock
31331 #. type: textblock
31332 #: ../fish/guestfish-actions.pod:4959
31333 msgid ""
31334 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
31335 "which just zeroes the first few blocks of a device."
31336 msgstr ""
31337
31338 # type: =head2
31339 #. type: =head2
31340 #: ../fish/guestfish-actions.pod:4966
31341 msgid "zerofree"
31342 msgstr ""
31343
31344 # type: verbatim
31345 #. type: verbatim
31346 #: ../fish/guestfish-actions.pod:4968
31347 #, no-wrap
31348 msgid ""
31349 " zerofree device\n"
31350 "\n"
31351 msgstr ""
31352
31353 # type: =head2
31354 #. type: =head2
31355 #: ../fish/guestfish-actions.pod:4981
31356 msgid "zfgrep"
31357 msgstr ""
31358
31359 # type: verbatim
31360 #. type: verbatim
31361 #: ../fish/guestfish-actions.pod:4983
31362 #, no-wrap
31363 msgid ""
31364 " zfgrep pattern path\n"
31365 "\n"
31366 msgstr ""
31367
31368 # type: =head2
31369 #. type: =head2
31370 #: ../fish/guestfish-actions.pod:4991
31371 msgid "zfgrepi"
31372 msgstr ""
31373
31374 # type: verbatim
31375 #. type: verbatim
31376 #: ../fish/guestfish-actions.pod:4993
31377 #, no-wrap
31378 msgid ""
31379 " zfgrepi pattern path\n"
31380 "\n"
31381 msgstr ""
31382
31383 # type: =head2
31384 #. type: =head2
31385 #: ../fish/guestfish-actions.pod:5001
31386 msgid "zfile"
31387 msgstr ""
31388
31389 # type: verbatim
31390 #. type: verbatim
31391 #: ../fish/guestfish-actions.pod:5003
31392 #, no-wrap
31393 msgid ""
31394 " zfile meth path\n"
31395 "\n"
31396 msgstr ""
31397
31398 # type: textblock
31399 #. type: textblock
31400 #: ../fish/guestfish-actions.pod:5010
31401 msgid ""
31402 "Since 1.0.63, use L</file> instead which can now process compressed files."
31403 msgstr ""
31404
31405 # type: =head2
31406 #. type: =head2
31407 #: ../fish/guestfish-actions.pod:5020
31408 msgid "zgrep"
31409 msgstr ""
31410
31411 # type: verbatim
31412 #. type: verbatim
31413 #: ../fish/guestfish-actions.pod:5022
31414 #, no-wrap
31415 msgid ""
31416 " zgrep regex path\n"
31417 "\n"
31418 msgstr ""
31419
31420 # type: =head2
31421 #. type: =head2
31422 #: ../fish/guestfish-actions.pod:5030
31423 msgid "zgrepi"
31424 msgstr ""
31425
31426 # type: verbatim
31427 #. type: verbatim
31428 #: ../fish/guestfish-actions.pod:5032
31429 #, no-wrap
31430 msgid ""
31431 " zgrepi regex path\n"
31432 "\n"
31433 msgstr ""
31434
31435 # type: =head2
31436 #. type: =head2
31437 #: ../fish/guestfish-commands.pod:1
31438 msgid "alloc"
31439 msgstr ""
31440
31441 # type: =head2
31442 #. type: =head2
31443 #: ../fish/guestfish-commands.pod:3
31444 msgid "allocate"
31445 msgstr ""
31446
31447 # type: verbatim
31448 #. type: verbatim
31449 #: ../fish/guestfish-commands.pod:5
31450 #, no-wrap
31451 msgid ""
31452 " alloc filename size\n"
31453 "\n"
31454 msgstr ""
31455
31456 # type: textblock
31457 #. type: textblock
31458 #: ../fish/guestfish-commands.pod:7
31459 msgid ""
31460 "This creates an empty (zeroed) file of the given size, and then adds so it "
31461 "can be further examined."
31462 msgstr ""
31463
31464 # type: textblock
31465 #. type: textblock
31466 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
31467 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
31468 msgstr ""
31469
31470 # type: textblock
31471 #. type: textblock
31472 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
31473 msgid "Size can be specified using standard suffixes, eg. C<1M>."
31474 msgstr ""
31475
31476 # type: textblock
31477 #. type: textblock
31478 #: ../fish/guestfish-commands.pod:14
31479 msgid ""
31480 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
31481 "image, see L</PREPARED DISK IMAGES>."
31482 msgstr ""
31483
31484 # type: =head2
31485 #. type: =head2
31486 #: ../fish/guestfish-commands.pod:17
31487 msgid "copy-in"
31488 msgstr ""
31489
31490 # type: verbatim
31491 #. type: verbatim
31492 #: ../fish/guestfish-commands.pod:19
31493 #, no-wrap
31494 msgid ""
31495 " copy-in local [local ...] /remotedir\n"
31496 "\n"
31497 msgstr ""
31498
31499 # type: textblock
31500 #. type: textblock
31501 #: ../fish/guestfish-commands.pod:21
31502 msgid ""
31503 "C<copy-in> copies local files or directories recursively into the disk "
31504 "image, placing them in the directory called C</remotedir> (which must "
31505 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
31506 "other commands as necessary."
31507 msgstr ""
31508
31509 # type: textblock
31510 #. type: textblock
31511 #: ../fish/guestfish-commands.pod:26
31512 msgid ""
31513 "Multiple local files and directories can be specified, but the last "
31514 "parameter must always be a remote directory.  Wildcards cannot be used."
31515 msgstr ""
31516
31517 # type: =head2
31518 #. type: =head2
31519 #: ../fish/guestfish-commands.pod:30
31520 msgid "copy-out"
31521 msgstr ""
31522
31523 # type: verbatim
31524 #. type: verbatim
31525 #: ../fish/guestfish-commands.pod:32
31526 #, no-wrap
31527 msgid ""
31528 " copy-out remote [remote ...] localdir\n"
31529 "\n"
31530 msgstr ""
31531
31532 # type: textblock
31533 #. type: textblock
31534 #: ../fish/guestfish-commands.pod:34
31535 msgid ""
31536 "C<copy-out> copies remote files or directories recursively out of the disk "
31537 "image, placing them on the host disk in a local directory called C<localdir> "
31538 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
31539 "download>, L</tar-out> and other commands as necessary."
31540 msgstr ""
31541
31542 # type: textblock
31543 #. type: textblock
31544 #: ../fish/guestfish-commands.pod:40
31545 msgid ""
31546 "Multiple remote files and directories can be specified, but the last "
31547 "parameter must always be a local directory.  To download to the current "
31548 "directory, use C<.> as in:"
31549 msgstr ""
31550
31551 # type: verbatim
31552 #. type: verbatim
31553 #: ../fish/guestfish-commands.pod:44
31554 #, no-wrap
31555 msgid ""
31556 " copy-out /home .\n"
31557 "\n"
31558 msgstr ""
31559
31560 # type: textblock
31561 #. type: textblock
31562 #: ../fish/guestfish-commands.pod:46
31563 msgid ""
31564 "Wildcards cannot be used in the ordinary command, but you can use them with "
31565 "the help of L</glob> like this:"
31566 msgstr ""
31567
31568 # type: verbatim
31569 #. type: verbatim
31570 #: ../fish/guestfish-commands.pod:49
31571 #, no-wrap
31572 msgid ""
31573 " glob copy-out /home/* .\n"
31574 "\n"
31575 msgstr ""
31576
31577 # type: =head2
31578 #. type: =head2
31579 #: ../fish/guestfish-commands.pod:51
31580 msgid "echo"
31581 msgstr ""
31582
31583 # type: verbatim
31584 #. type: verbatim
31585 #: ../fish/guestfish-commands.pod:53
31586 #, no-wrap
31587 msgid ""
31588 " echo [params ...]\n"
31589 "\n"
31590 msgstr ""
31591
31592 # type: textblock
31593 #. type: textblock
31594 #: ../fish/guestfish-commands.pod:55
31595 msgid "This echos the parameters to the terminal."
31596 msgstr ""
31597
31598 # type: =head2
31599 #. type: =head2
31600 #: ../fish/guestfish-commands.pod:57
31601 msgid "edit"
31602 msgstr ""
31603
31604 # type: =head2
31605 #. type: =head2
31606 #: ../fish/guestfish-commands.pod:59
31607 msgid "vi"
31608 msgstr ""
31609
31610 # type: =head2
31611 #. type: =head2
31612 #: ../fish/guestfish-commands.pod:61
31613 msgid "emacs"
31614 msgstr ""
31615
31616 # type: verbatim
31617 #. type: verbatim
31618 #: ../fish/guestfish-commands.pod:63
31619 #, no-wrap
31620 msgid ""
31621 " edit filename\n"
31622 "\n"
31623 msgstr ""
31624
31625 # type: textblock
31626 #. type: textblock
31627 #: ../fish/guestfish-commands.pod:65
31628 msgid ""
31629 "This is used to edit a file.  It downloads the file, edits it locally using "
31630 "your editor, then uploads the result."
31631 msgstr ""
31632
31633 # type: textblock
31634 #. type: textblock
31635 #: ../fish/guestfish-commands.pod:68
31636 msgid ""
31637 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
31638 "or C<emacs> you will get those corresponding editors."
31639 msgstr ""
31640
31641 # type: =head2
31642 #. type: =head2
31643 #: ../fish/guestfish-commands.pod:72
31644 msgid "glob"
31645 msgstr ""
31646
31647 # type: verbatim
31648 #. type: verbatim
31649 #: ../fish/guestfish-commands.pod:74
31650 #, no-wrap
31651 msgid ""
31652 " glob command args...\n"
31653 "\n"
31654 msgstr ""
31655
31656 # type: textblock
31657 #. type: textblock
31658 #: ../fish/guestfish-commands.pod:76
31659 msgid ""
31660 "Expand wildcards in any paths in the args list, and run C<command> "
31661 "repeatedly on each matching path."
31662 msgstr ""
31663
31664 # type: textblock
31665 #. type: textblock
31666 #: ../fish/guestfish-commands.pod:79
31667 msgid "See L</WILDCARDS AND GLOBBING>."
31668 msgstr ""
31669
31670 # type: =head2
31671 #. type: =head2
31672 #: ../fish/guestfish-commands.pod:81
31673 msgid "hexedit"
31674 msgstr ""
31675
31676 # type: verbatim
31677 #. type: verbatim
31678 #: ../fish/guestfish-commands.pod:83
31679 #, no-wrap
31680 msgid ""
31681 " hexedit <filename|device>\n"
31682 " hexedit <filename|device> <max>\n"
31683 " hexedit <filename|device> <start> <max>\n"
31684 "\n"
31685 msgstr ""
31686
31687 # type: textblock
31688 #. type: textblock
31689 #: ../fish/guestfish-commands.pod:87
31690 msgid ""
31691 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
31692 "device."
31693 msgstr ""
31694
31695 # type: textblock
31696 #. type: textblock
31697 #: ../fish/guestfish-commands.pod:90
31698 msgid ""
31699 "This command works by downloading potentially the whole file or device, "
31700 "editing it locally, then uploading it.  If the file or device is large, you "
31701 "have to specify which part you wish to edit by using C<max> and/or C<start> "
31702 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
31703 "usual modifiers allowed such as C<1M> (1 megabyte)."
31704 msgstr ""
31705
31706 # type: textblock
31707 #. type: textblock
31708 #: ../fish/guestfish-commands.pod:97
31709 msgid "For example to edit the first few sectors of a disk you might do:"
31710 msgstr ""
31711
31712 # type: verbatim
31713 #. type: verbatim
31714 #: ../fish/guestfish-commands.pod:100
31715 #, no-wrap
31716 msgid ""
31717 " hexedit /dev/sda 1M\n"
31718 "\n"
31719 msgstr ""
31720
31721 # type: textblock
31722 #. type: textblock
31723 #: ../fish/guestfish-commands.pod:102
31724 msgid ""
31725 "which would allow you to edit anywhere within the first megabyte of the disk."
31726 msgstr ""
31727
31728 # type: textblock
31729 #. type: textblock
31730 #: ../fish/guestfish-commands.pod:105
31731 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
31732 msgstr ""
31733
31734 # type: verbatim
31735 #. type: verbatim
31736 #: ../fish/guestfish-commands.pod:107
31737 #, no-wrap
31738 msgid ""
31739 " hexedit /dev/sda1 0x400 0x400\n"
31740 "\n"
31741 msgstr ""
31742
31743 # type: textblock
31744 #. type: textblock
31745 #: ../fish/guestfish-commands.pod:109
31746 msgid "(assuming the superblock is in the standard location)."
31747 msgstr ""
31748
31749 # type: textblock
31750 #. type: textblock
31751 #: ../fish/guestfish-commands.pod:111
31752 msgid ""
31753 "This command requires the external L<hexedit(1)> program.  You can specify "
31754 "another program to use by setting the C<HEXEDITOR> environment variable."
31755 msgstr ""
31756
31757 # type: textblock
31758 #. type: textblock
31759 #: ../fish/guestfish-commands.pod:115
31760 msgid "See also L</hexdump>."
31761 msgstr ""
31762
31763 # type: =head2
31764 #. type: =head2
31765 #: ../fish/guestfish-commands.pod:117
31766 msgid "lcd"
31767 msgstr ""
31768
31769 # type: verbatim
31770 #. type: verbatim
31771 #: ../fish/guestfish-commands.pod:119
31772 #, no-wrap
31773 msgid ""
31774 " lcd directory\n"
31775 "\n"
31776 msgstr ""
31777
31778 # type: textblock
31779 #. type: textblock
31780 #: ../fish/guestfish-commands.pod:121
31781 msgid ""
31782 "Change the local directory, ie. the current directory of guestfish itself."
31783 msgstr ""
31784
31785 # type: textblock
31786 #. type: textblock
31787 #: ../fish/guestfish-commands.pod:124
31788 msgid "Note that C<!cd> won't do what you might expect."
31789 msgstr ""
31790
31791 # type: =head2
31792 #. type: =head2
31793 #: ../fish/guestfish-commands.pod:126
31794 msgid "man"
31795 msgstr ""
31796
31797 # type: =head2
31798 #. type: =head2
31799 #: ../fish/guestfish-commands.pod:128
31800 msgid "manual"
31801 msgstr ""
31802
31803 # type: verbatim
31804 #. type: verbatim
31805 #: ../fish/guestfish-commands.pod:130
31806 #, no-wrap
31807 msgid ""
31808 "  man\n"
31809 "\n"
31810 msgstr ""
31811
31812 # type: textblock
31813 #. type: textblock
31814 #: ../fish/guestfish-commands.pod:132
31815 msgid "Opens the manual page for guestfish."
31816 msgstr ""
31817
31818 # type: =head2
31819 #. type: =head2
31820 #: ../fish/guestfish-commands.pod:134
31821 msgid "more"
31822 msgstr ""
31823
31824 # type: =head2
31825 #. type: =head2
31826 #: ../fish/guestfish-commands.pod:136
31827 msgid "less"
31828 msgstr ""
31829
31830 # type: verbatim
31831 #. type: verbatim
31832 #: ../fish/guestfish-commands.pod:138
31833 #, no-wrap
31834 msgid ""
31835 " more filename\n"
31836 "\n"
31837 msgstr ""
31838
31839 # type: verbatim
31840 #. type: verbatim
31841 #: ../fish/guestfish-commands.pod:140
31842 #, no-wrap
31843 msgid ""
31844 " less filename\n"
31845 "\n"
31846 msgstr ""
31847
31848 # type: textblock
31849 #. type: textblock
31850 #: ../fish/guestfish-commands.pod:142
31851 msgid "This is used to view a file."
31852 msgstr ""
31853
31854 # type: textblock
31855 #. type: textblock
31856 #: ../fish/guestfish-commands.pod:144
31857 msgid ""
31858 "The default viewer is C<$PAGER>.  However if you use the alternate command "
31859 "C<less> you will get the C<less> command specifically."
31860 msgstr ""
31861
31862 # type: =head2
31863 #. type: =head2
31864 #: ../fish/guestfish-commands.pod:147
31865 msgid "reopen"
31866 msgstr ""
31867
31868 # type: verbatim
31869 #. type: verbatim
31870 #: ../fish/guestfish-commands.pod:149
31871 #, no-wrap
31872 msgid ""
31873 "  reopen\n"
31874 "\n"
31875 msgstr ""
31876
31877 # type: textblock
31878 #. type: textblock
31879 #: ../fish/guestfish-commands.pod:151
31880 msgid ""
31881 "Close and reopen the libguestfs handle.  It is not necessary to use this "
31882 "normally, because the handle is closed properly when guestfish exits.  "
31883 "However this is occasionally useful for testing."
31884 msgstr ""
31885
31886 # type: =head2
31887 #. type: =head2
31888 #: ../fish/guestfish-commands.pod:155
31889 msgid "sparse"
31890 msgstr ""
31891
31892 # type: verbatim
31893 #. type: verbatim
31894 #: ../fish/guestfish-commands.pod:157
31895 #, no-wrap
31896 msgid ""
31897 " sparse filename size\n"
31898 "\n"
31899 msgstr ""
31900
31901 # type: textblock
31902 #. type: textblock
31903 #: ../fish/guestfish-commands.pod:159
31904 msgid ""
31905 "This creates an empty sparse file of the given size, and then adds so it can "
31906 "be further examined."
31907 msgstr ""
31908
31909 # type: textblock
31910 #. type: textblock
31911 #: ../fish/guestfish-commands.pod:162
31912 msgid ""
31913 "In all respects it works the same as the L</alloc> command, except that the "
31914 "image file is allocated sparsely, which means that disk blocks are not "
31915 "assigned to the file until they are needed.  Sparse disk files only use "
31916 "space when written to, but they are slower and there is a danger you could "
31917 "run out of real disk space during a write operation."
31918 msgstr ""
31919
31920 # type: =head2
31921 #. type: =head2
31922 #: ../fish/guestfish-commands.pod:172
31923 msgid "supported"
31924 msgstr ""
31925
31926 # type: verbatim
31927 #. type: verbatim
31928 #: ../fish/guestfish-commands.pod:174
31929 #, no-wrap
31930 msgid ""
31931 " supported\n"
31932 "\n"
31933 msgstr ""
31934
31935 # type: textblock
31936 #. type: textblock
31937 #: ../fish/guestfish-commands.pod:176
31938 msgid ""
31939 "This command returns a list of the optional groups known to the daemon, and "
31940 "indicates which ones are supported by this build of the libguestfs appliance."
31941 msgstr ""
31942
31943 # type: textblock
31944 #. type: textblock
31945 #: ../fish/guestfish-commands.pod:180
31946 msgid "See also L<guestfs(3)/AVAILABILITY>."
31947 msgstr ""
31948
31949 # type: =head2
31950 #. type: =head2
31951 #: ../fish/guestfish-commands.pod:182
31952 msgid "time"
31953 msgstr ""
31954
31955 # type: verbatim
31956 #. type: verbatim
31957 #: ../fish/guestfish-commands.pod:184
31958 #, no-wrap
31959 msgid ""
31960 " time command args...\n"
31961 "\n"
31962 msgstr ""
31963
31964 # type: textblock
31965 #. type: textblock
31966 #: ../fish/guestfish-commands.pod:186
31967 msgid ""
31968 "Run the command as usual, but print the elapsed time afterwards.  This can "
31969 "be useful for benchmarking operations."
31970 msgstr ""
31971
31972 # type: textblock
31973 #. type: textblock
31974 #: ../test-tool/libguestfs-test-tool.pod:5
31975 msgid "libguestfs-test-tool - End user tests for libguestfs"
31976 msgstr ""
31977
31978 # type: verbatim
31979 #. type: verbatim
31980 #: ../test-tool/libguestfs-test-tool.pod:9
31981 #, no-wrap
31982 msgid ""
31983 " libguestfs-test-tool [--options]\n"
31984 "\n"
31985 msgstr ""
31986
31987 # type: textblock
31988 #. type: textblock
31989 #: ../test-tool/libguestfs-test-tool.pod:13
31990 msgid ""
31991 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
31992 "and developers, to allow them to check basic libguestfs functionality is "
31993 "working.  This is needed because libguestfs occasionally breaks for reasons "
31994 "beyond our control: usually because of changes in the underlying qemu or "
31995 "kernel packages, or the host environment."
31996 msgstr ""
31997
31998 # type: textblock
31999 #. type: textblock
32000 #: ../test-tool/libguestfs-test-tool.pod:20
32001 msgid "If you suspect a problem in libguestfs, then just run:"
32002 msgstr ""
32003
32004 # type: verbatim
32005 #. type: verbatim
32006 #: ../test-tool/libguestfs-test-tool.pod:22
32007 #, no-wrap
32008 msgid ""
32009 " libguestfs-test-tool\n"
32010 "\n"
32011 msgstr ""
32012
32013 # type: textblock
32014 #. type: textblock
32015 #: ../test-tool/libguestfs-test-tool.pod:24
32016 msgid "It will print lots of diagnostic messages."
32017 msgstr ""
32018
32019 # type: textblock
32020 #. type: textblock
32021 #: ../test-tool/libguestfs-test-tool.pod:26
32022 msgid "If it runs to completion successfully, you will see this near the end:"
32023 msgstr ""
32024
32025 # type: verbatim
32026 #. type: verbatim
32027 #: ../test-tool/libguestfs-test-tool.pod:28
32028 #, no-wrap
32029 msgid ""
32030 " ===== TEST FINISHED OK =====\n"
32031 "\n"
32032 msgstr ""
32033
32034 # type: textblock
32035 #. type: textblock
32036 #: ../test-tool/libguestfs-test-tool.pod:30
32037 msgid "and the test tool will exit with code 0."
32038 msgstr ""
32039
32040 # type: textblock
32041 #. type: textblock
32042 #: ../test-tool/libguestfs-test-tool.pod:32
32043 msgid ""
32044 "If it fails (and/or exits with non-zero error code), please paste the "
32045 "B<complete, unedited> output of the test tool into a bug report.  More "
32046 "information about reporting bugs can be found on the L<http://libguestfs.org/"
32047 "> website."
32048 msgstr ""
32049
32050 # type: =item
32051 #. type: =item
32052 #: ../test-tool/libguestfs-test-tool.pod:41
32053 msgid "I<--help>"
32054 msgstr ""
32055
32056 # type: textblock
32057 #. type: textblock
32058 #: ../test-tool/libguestfs-test-tool.pod:43
32059 msgid "Display short usage information and exit."
32060 msgstr ""
32061
32062 # type: =item
32063 #. type: =item
32064 #: ../test-tool/libguestfs-test-tool.pod:45
32065 msgid "I<--qemu qemu_binary>"
32066 msgstr ""
32067
32068 # type: textblock
32069 #. type: textblock
32070 #: ../test-tool/libguestfs-test-tool.pod:47
32071 msgid ""
32072 "If you have downloaded another qemu binary, point this option at the full "
32073 "path of the binary to try it."
32074 msgstr ""
32075
32076 # type: =item
32077 #. type: =item
32078 #: ../test-tool/libguestfs-test-tool.pod:50
32079 msgid "I<--qemudir qemu_source_dir>"
32080 msgstr ""
32081
32082 # type: textblock
32083 #. type: textblock
32084 #: ../test-tool/libguestfs-test-tool.pod:52
32085 msgid ""
32086 "If you have compiled qemu from source, point this option at the source "
32087 "directory to try it."
32088 msgstr ""
32089
32090 # type: =item
32091 #. type: =item
32092 #: ../test-tool/libguestfs-test-tool.pod:55
32093 msgid "I<--timeout N>"
32094 msgstr ""
32095
32096 # type: textblock
32097 #. type: textblock
32098 #: ../test-tool/libguestfs-test-tool.pod:57
32099 msgid ""
32100 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
32101 "does not usually need to be adjusted unless your machine is very slow."
32102 msgstr ""
32103
32104 # type: =head1
32105 #. type: =head1
32106 #: ../test-tool/libguestfs-test-tool.pod:63
32107 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
32108 msgstr ""
32109
32110 # type: textblock
32111 #. type: textblock
32112 #: ../test-tool/libguestfs-test-tool.pod:65
32113 msgid ""
32114 "If you have compiled another version of qemu from source and would like to "
32115 "try that, then you can use the I<--qemudir> option to point to the qemu "
32116 "source directory."
32117 msgstr ""
32118
32119 # type: textblock
32120 #. type: textblock
32121 #: ../test-tool/libguestfs-test-tool.pod:69
32122 msgid ""
32123 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
32124 "option to point to the binary."
32125 msgstr ""
32126
32127 # type: textblock
32128 #. type: textblock
32129 #: ../test-tool/libguestfs-test-tool.pod:72
32130 msgid ""
32131 "When using an alternate qemu with libguestfs, usually you would need to "
32132 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
32133 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
32134 "use either of the I<--qemudir> or I<--qemu> options."
32135 msgstr ""
32136
32137 # type: textblock
32138 #. type: textblock
32139 #: ../test-tool/libguestfs-test-tool.pod:79
32140 msgid ""
32141 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
32142 "I<1> if there was an error."
32143 msgstr ""
32144
32145 # type: textblock
32146 #. type: textblock
32147 #: ../test-tool/libguestfs-test-tool.pod:84
32148 msgid ""
32149 "For the full list of environment variables which may affect libguestfs, "
32150 "please see the L<guestfs(3)> manual page."
32151 msgstr ""
32152
32153 # type: textblock
32154 #. type: textblock
32155 #: ../test-tool/libguestfs-test-tool.pod:89
32156 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
32157 msgstr ""
32158
32159 # type: textblock
32160 #. type: textblock
32161 #: ../fuse/guestmount.pod:5
32162 msgid ""
32163 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
32164 msgstr ""
32165
32166 # type: verbatim
32167 #. type: verbatim
32168 #: ../fuse/guestmount.pod:9
32169 #, no-wrap
32170 msgid ""
32171 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
32172 "\n"
32173 msgstr ""
32174
32175 # type: verbatim
32176 #. type: verbatim
32177 #: ../fuse/guestmount.pod:11
32178 #, no-wrap
32179 msgid ""
32180 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
32181 "\n"
32182 msgstr ""
32183
32184 # type: verbatim
32185 #. type: verbatim
32186 #: ../fuse/guestmount.pod:13
32187 #, no-wrap
32188 msgid ""
32189 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
32190 "\n"
32191 msgstr ""
32192
32193 # type: textblock
32194 #. type: textblock
32195 #: ../fuse/guestmount.pod:17
32196 msgid ""
32197 "You must I<not> use C<guestmount> in read-write mode on live virtual "
32198 "machines.  If you do this, you risk disk corruption in the VM."
32199 msgstr ""
32200
32201 # type: textblock
32202 #. type: textblock
32203 #: ../fuse/guestmount.pod:22
32204 msgid ""
32205 "The guestmount program can be used to mount virtual machine filesystems and "
32206 "other disk images on the host.  It uses libguestfs for access to the guest "
32207 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
32208 "a mountable device."
32209 msgstr ""
32210
32211 # type: textblock
32212 #. type: textblock
32213 #: ../fuse/guestmount.pod:27
32214 msgid ""
32215 "Along with other options, you have to give at least one device (I<-a> "
32216 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
32217 "option) or use the I<-i> inspection option.  How this works is better "
32218 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
32219 "below."
32220 msgstr ""
32221
32222 # type: textblock
32223 #. type: textblock
32224 #: ../fuse/guestmount.pod:33
32225 msgid ""
32226 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
32227 "by you, and the filesystem will not be visible to any other users unless you "
32228 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
32229 "the filesystem, use the C<fusermount -u> command."
32230 msgstr ""
32231
32232 # type: textblock
32233 #. type: textblock
32234 #: ../fuse/guestmount.pod:41
32235 msgid ""
32236 "For a typical Windows guest which has its main filesystem on the first "
32237 "partition:"
32238 msgstr ""
32239
32240 # type: verbatim
32241 #. type: verbatim
32242 #: ../fuse/guestmount.pod:44
32243 #, no-wrap
32244 msgid ""
32245 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
32246 "\n"
32247 msgstr ""
32248
32249 # type: textblock
32250 #. type: textblock
32251 #: ../fuse/guestmount.pod:46
32252 msgid ""
32253 "For a typical Linux guest which has a /boot filesystem on the first "
32254 "partition, and the root filesystem on a logical volume:"
32255 msgstr ""
32256
32257 # type: verbatim
32258 #. type: verbatim
32259 #: ../fuse/guestmount.pod:49
32260 #, no-wrap
32261 msgid ""
32262 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
32263 "\n"
32264 msgstr ""
32265
32266 # type: textblock
32267 #. type: textblock
32268 #: ../fuse/guestmount.pod:51
32269 msgid "To get libguestfs to detect guest mountpoints for you:"
32270 msgstr ""
32271
32272 # type: verbatim
32273 #. type: verbatim
32274 #: ../fuse/guestmount.pod:53
32275 #, no-wrap
32276 msgid ""
32277 " guestmount -a guest.img -i --ro /mnt\n"
32278 "\n"
32279 msgstr ""
32280
32281 # type: textblock
32282 #. type: textblock
32283 #: ../fuse/guestmount.pod:55
32284 msgid "For a libvirt guest called \"Guest\" you could do:"
32285 msgstr ""
32286
32287 # type: verbatim
32288 #. type: verbatim
32289 #: ../fuse/guestmount.pod:57
32290 #, no-wrap
32291 msgid ""
32292 " guestmount -d Guest -i --ro /mnt\n"
32293 "\n"
32294 msgstr ""
32295
32296 # type: textblock
32297 #. type: textblock
32298 #: ../fuse/guestmount.pod:59
32299 msgid ""
32300 "If you don't know what filesystems are contained in a guest or disk image, "
32301 "use L<virt-filesystems(1)> first:"
32302 msgstr ""
32303
32304 # type: verbatim
32305 #. type: verbatim
32306 #: ../fuse/guestmount.pod:62
32307 #, no-wrap
32308 msgid ""
32309 " virt-filesystems MyGuest\n"
32310 "\n"
32311 msgstr ""
32312
32313 # type: textblock
32314 #. type: textblock
32315 #: ../fuse/guestmount.pod:64
32316 msgid ""
32317 "If you want to trace the libguestfs calls but without excessive debugging "
32318 "information, we recommend:"
32319 msgstr ""
32320
32321 # type: verbatim
32322 #. type: verbatim
32323 #: ../fuse/guestmount.pod:67
32324 #, no-wrap
32325 msgid ""
32326 " guestmount [...] --trace /mnt\n"
32327 "\n"
32328 msgstr ""
32329
32330 # type: textblock
32331 #. type: textblock
32332 #: ../fuse/guestmount.pod:69
32333 msgid "If you want to debug the program, we recommend:"
32334 msgstr ""
32335
32336 # type: verbatim
32337 #. type: verbatim
32338 #: ../fuse/guestmount.pod:71
32339 #, no-wrap
32340 msgid ""
32341 " guestmount [...] --trace --verbose /mnt\n"
32342 "\n"
32343 msgstr ""
32344
32345 #. type: =head1
32346 #: ../fuse/guestmount.pod:73
32347 msgid "NOTES"
32348 msgstr ""
32349
32350 #. type: =head2
32351 #: ../fuse/guestmount.pod:75
32352 msgid "Other users cannot see the filesystem by default"
32353 msgstr ""
32354
32355 #. type: textblock
32356 #: ../fuse/guestmount.pod:77
32357 msgid ""
32358 "If you mount a filesystem as one user (eg. root), then other users will not "
32359 "be able to see it by default.  The fix is to add the FUSE C<allow_other> "
32360 "option when mounting:"
32361 msgstr ""
32362
32363 #. type: verbatim
32364 #: ../fuse/guestmount.pod:81
32365 #, no-wrap
32366 msgid ""
32367 " sudo guestmount [...] -o allow_other /mnt\n"
32368 "\n"
32369 msgstr ""
32370
32371 # type: =item
32372 #. type: =item
32373 #: ../fuse/guestmount.pod:87
32374 msgid "B<-a image> | B<--add image>"
32375 msgstr ""
32376
32377 # type: textblock
32378 #. type: textblock
32379 #: ../fuse/guestmount.pod:89
32380 msgid "Add a block device or virtual machine image."
32381 msgstr ""
32382
32383 # type: =item
32384 #. type: =item
32385 #: ../fuse/guestmount.pod:94
32386 msgid "B<-c URI> | B<--connect URI>"
32387 msgstr ""
32388
32389 # type: =item
32390 #. type: =item
32391 #: ../fuse/guestmount.pod:100
32392 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
32393 msgstr ""
32394
32395 # type: =item
32396 #. type: =item
32397 #: ../fuse/guestmount.pod:108
32398 msgid "B<--dir-cache-timeout N>"
32399 msgstr ""
32400
32401 # type: textblock
32402 #. type: textblock
32403 #: ../fuse/guestmount.pod:110
32404 msgid ""
32405 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
32406 "seconds.  The readdir cache [actually, there are several semi-independent "
32407 "caches] is populated after a readdir(2) call with the stat and extended "
32408 "attributes of the files in the directory, in anticipation that they will be "
32409 "requested soon after."
32410 msgstr ""
32411
32412 # type: textblock
32413 #. type: textblock
32414 #: ../fuse/guestmount.pod:116
32415 msgid ""
32416 "There is also a different attribute cache implemented by FUSE (see the FUSE "
32417 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
32418 "requests, only cache existing ones."
32419 msgstr ""
32420
32421 # type: =item
32422 #. type: =item
32423 #: ../fuse/guestmount.pod:127
32424 msgid "B<--format=raw|qcow2|..> | B<--format>"
32425 msgstr ""
32426
32427 # type: textblock
32428 #. type: textblock
32429 #: ../fuse/guestmount.pod:134
32430 msgid ""
32431 "If you have untrusted raw-format guest disk images, you should use this "
32432 "option to specify the disk format.  This avoids a possible security problem "
32433 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
32434 "guestfs_add_drive_opts>."
32435 msgstr ""
32436
32437 # type: =item
32438 #. type: =item
32439 #: ../fuse/guestmount.pod:139
32440 msgid "B<--fuse-help>"
32441 msgstr ""
32442
32443 # type: textblock
32444 #. type: textblock
32445 #: ../fuse/guestmount.pod:141
32446 msgid "Display help on special FUSE options (see I<-o> below)."
32447 msgstr ""
32448
32449 # type: textblock
32450 #. type: textblock
32451 #: ../fuse/guestmount.pod:145
32452 msgid "Display brief help and exit."
32453 msgstr ""
32454
32455 # type: =item
32456 #. type: =item
32457 #: ../fuse/guestmount.pod:147
32458 msgid "B<-i> | B<--inspector>"
32459 msgstr ""
32460
32461 # type: textblock
32462 #. type: textblock
32463 #: ../fuse/guestmount.pod:167
32464 msgid ""
32465 "Mount the named partition or logical volume on the given mountpoint B<in the "
32466 "guest> (this has nothing to do with mountpoints in the host)."
32467 msgstr ""
32468
32469 # type: textblock
32470 #. type: textblock
32471 #: ../fuse/guestmount.pod:170
32472 msgid ""
32473 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
32474 "something on C</>."
32475 msgstr ""
32476
32477 # type: =item
32478 #. type: =item
32479 #: ../fuse/guestmount.pod:183
32480 msgid "B<-n> | B<--no-sync>"
32481 msgstr ""
32482
32483 # type: textblock
32484 #. type: textblock
32485 #: ../fuse/guestmount.pod:185
32486 msgid ""
32487 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
32488 "unmounted.  If you specify this option, then we don't attempt to sync the "
32489 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
32490 msgstr ""
32491
32492 # type: =item
32493 #. type: =item
32494 #: ../fuse/guestmount.pod:190
32495 msgid "B<-o option> | B<--option option>"
32496 msgstr ""
32497
32498 # type: textblock
32499 #. type: textblock
32500 #: ../fuse/guestmount.pod:192
32501 msgid "Pass extra options to FUSE."
32502 msgstr ""
32503
32504 # type: textblock
32505 #. type: textblock
32506 #: ../fuse/guestmount.pod:194
32507 msgid ""
32508 "To get a list of all the extra options supported by FUSE, use the command "
32509 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
32510 "of them are a good idea."
32511 msgstr ""
32512
32513 # type: verbatim
32514 #. type: verbatim
32515 #: ../fuse/guestmount.pod:198
32516 #, no-wrap
32517 msgid ""
32518 " guestmount --fuse-help\n"
32519 "\n"
32520 msgstr ""
32521
32522 # type: textblock
32523 #. type: textblock
32524 #: ../fuse/guestmount.pod:200
32525 msgid "Some potentially useful FUSE options:"
32526 msgstr ""
32527
32528 # type: =item
32529 #. type: =item
32530 #: ../fuse/guestmount.pod:204
32531 msgid "B<-o allow_other>"
32532 msgstr ""
32533
32534 # type: textblock
32535 #. type: textblock
32536 #: ../fuse/guestmount.pod:206
32537 msgid "Allow other users to see the filesystem."
32538 msgstr ""
32539
32540 # type: =item
32541 #. type: =item
32542 #: ../fuse/guestmount.pod:208
32543 msgid "B<-o attr_timeout=N>"
32544 msgstr ""
32545
32546 # type: textblock
32547 #. type: textblock
32548 #: ../fuse/guestmount.pod:210
32549 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
32550 msgstr ""
32551
32552 # type: =item
32553 #. type: =item
32554 #: ../fuse/guestmount.pod:212
32555 msgid "B<-o kernel_cache>"
32556 msgstr ""
32557
32558 # type: textblock
32559 #. type: textblock
32560 #: ../fuse/guestmount.pod:214
32561 msgid ""
32562 "Allow the kernel to cache files (reduces the number of reads that have to go "
32563 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
32564 "afford the extra memory usage."
32565 msgstr ""
32566
32567 # type: =item
32568 #. type: =item
32569 #: ../fuse/guestmount.pod:218
32570 msgid "B<-o uid=N> B<-o gid=N>"
32571 msgstr ""
32572
32573 # type: textblock
32574 #. type: textblock
32575 #: ../fuse/guestmount.pod:220
32576 msgid ""
32577 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
32578 "the chosen values."
32579 msgstr ""
32580
32581 # type: =item
32582 #. type: =item
32583 #: ../fuse/guestmount.pod:225
32584 msgid "B<-r> | B<--ro>"
32585 msgstr ""
32586
32587 # type: textblock
32588 #. type: textblock
32589 #: ../fuse/guestmount.pod:227
32590 msgid ""
32591 "Add devices and mount everything read-only.  Also disallow writes and make "
32592 "the disk appear read-only to FUSE."
32593 msgstr ""
32594
32595 # type: textblock
32596 #. type: textblock
32597 #: ../fuse/guestmount.pod:230
32598 msgid ""
32599 "This is highly recommended if you are not going to edit the guest disk.  If "
32600 "the guest is running and this option is I<not> supplied, then there is a "
32601 "strong risk of disk corruption in the guest.  We try to prevent this from "
32602 "happening, but it is not always possible."
32603 msgstr ""
32604
32605 # type: textblock
32606 #. type: textblock
32607 #: ../fuse/guestmount.pod:235
32608 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32609 msgstr ""
32610
32611 # type: textblock
32612 #. type: textblock
32613 #: ../fuse/guestmount.pod:239
32614 msgid "Enable SELinux support for the guest."
32615 msgstr ""
32616
32617 # type: =item
32618 #. type: =item
32619 #: ../fuse/guestmount.pod:241
32620 msgid "B<-v> | B<--verbose>"
32621 msgstr ""
32622
32623 # type: textblock
32624 #. type: textblock
32625 #: ../fuse/guestmount.pod:243
32626 msgid "Enable verbose messages from underlying libguestfs."
32627 msgstr ""
32628
32629 # type: =item
32630 #. type: =item
32631 #: ../fuse/guestmount.pod:245
32632 msgid "B<-V> | B<--version>"
32633 msgstr ""
32634
32635 # type: textblock
32636 #. type: textblock
32637 #: ../fuse/guestmount.pod:247
32638 msgid "Display the program version and exit."
32639 msgstr ""
32640
32641 # type: =item
32642 #. type: =item
32643 #: ../fuse/guestmount.pod:249
32644 msgid "B<-w> | B<--rw>"
32645 msgstr ""
32646
32647 #. type: textblock
32648 #: ../fuse/guestmount.pod:254 ../fuse/guestmount.pod:275
32649 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32650 msgstr ""
32651
32652 # type: =item
32653 #. type: =item
32654 #: ../fuse/guestmount.pod:256
32655 msgid "B<-x> | B<--trace>"
32656 msgstr ""
32657
32658 # type: textblock
32659 #. type: textblock
32660 #: ../fuse/guestmount.pod:258
32661 msgid "Trace libguestfs calls and entry into each FUSE function."
32662 msgstr ""
32663
32664 # type: textblock
32665 #. type: textblock
32666 #: ../fuse/guestmount.pod:260
32667 msgid "This also stops the daemon from forking into the background."
32668 msgstr ""
32669
32670 # type: textblock
32671 #. type: textblock
32672 #: ../fuse/guestmount.pod:281
32673 msgid ""
32674 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
32675 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
32676 "net/>."
32677 msgstr ""
32678
32679 # type: textblock
32680 #. type: textblock
32681 #: ../fuse/guestmount.pod:296
32682 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
32683 msgstr ""
32684
32685 # type: textblock
32686 #. type: textblock
32687 #: ../tools/virt-win-reg.pl:37
32688 msgid ""
32689 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
32690 msgstr ""
32691
32692 # type: verbatim
32693 #. type: verbatim
32694 #: ../tools/virt-win-reg.pl:41
32695 #, no-wrap
32696 msgid ""
32697 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
32698 "\n"
32699 msgstr ""
32700
32701 # type: verbatim
32702 #. type: verbatim
32703 #: ../tools/virt-win-reg.pl:43
32704 #, no-wrap
32705 msgid ""
32706 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
32707 "\n"
32708 msgstr ""
32709
32710 # type: verbatim
32711 #. type: verbatim
32712 #: ../tools/virt-win-reg.pl:45
32713 #, no-wrap
32714 msgid ""
32715 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
32716 "\n"
32717 msgstr ""
32718
32719 # type: verbatim
32720 #. type: verbatim
32721 #: ../tools/virt-win-reg.pl:47
32722 #, no-wrap
32723 msgid ""
32724 " virt-win-reg --merge domname [input.reg ...]\n"
32725 "\n"
32726 msgstr ""
32727
32728 # type: verbatim
32729 #. type: verbatim
32730 #: ../tools/virt-win-reg.pl:49
32731 #, no-wrap
32732 msgid ""
32733 " virt-win-reg [--options] disk.img ... # instead of domname\n"
32734 "\n"
32735 msgstr ""
32736
32737 #. type: textblock
32738 #: ../tools/virt-win-reg.pl:53
32739 msgid ""
32740 "You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
32741 "virtual machines.  If you do this, you I<will> get irreversible disk "
32742 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
32743 "but doesn't catch all cases."
32744 msgstr ""
32745
32746 #. type: textblock
32747 #: ../tools/virt-win-reg.pl:58
32748 msgid ""
32749 "Modifying the Windows Registry is an inherently risky operation.  The format "
32750 "is deliberately obscure and undocumented, and Registry changes can leave the "
32751 "system unbootable.  Therefore when using the I<--merge> option, make sure "
32752 "you have a reliable backup first."
32753 msgstr ""
32754
32755 # type: textblock
32756 #. type: textblock
32757 #: ../tools/virt-win-reg.pl:65
32758 msgid ""
32759 "This program can export and merge Windows Registry entries from a Windows "
32760 "guest."
32761 msgstr ""
32762
32763 # type: textblock
32764 #. type: textblock
32765 #: ../tools/virt-win-reg.pl:68
32766 msgid ""
32767 "The first parameter is the libvirt guest name or the raw disk image of a "
32768 "Windows guest."
32769 msgstr ""
32770
32771 #. type: textblock
32772 #: ../tools/virt-win-reg.pl:71
32773 msgid ""
32774 "If I<--merge> is I<not> specified, then the chosen registry key is displayed/"
32775 "exported (recursively).  For example:"
32776 msgstr ""
32777
32778 # type: verbatim
32779 #. type: verbatim
32780 #: ../tools/virt-win-reg.pl:74
32781 #, no-wrap
32782 msgid ""
32783 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
32784 "\n"
32785 msgstr ""
32786
32787 # type: textblock
32788 #. type: textblock
32789 #: ../tools/virt-win-reg.pl:76
32790 msgid ""
32791 "You can also display single values from within registry keys, for example:"
32792 msgstr ""
32793
32794 # type: verbatim
32795 #. type: verbatim
32796 #: ../tools/virt-win-reg.pl:79
32797 #, no-wrap
32798 msgid ""
32799 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
32800 " $ virt-win-reg Windows7 $cvkey ProductName\n"
32801 " Windows 7 Enterprise\n"
32802 "\n"
32803 msgstr ""
32804
32805 #. type: textblock
32806 #: ../tools/virt-win-reg.pl:83
32807 msgid ""
32808 "With I<--merge>, you can merge a textual regedit file into the Windows "
32809 "Registry:"
32810 msgstr ""
32811
32812 # type: verbatim
32813 #. type: verbatim
32814 #: ../tools/virt-win-reg.pl:86
32815 #, no-wrap
32816 msgid ""
32817 " $ virt-win-reg --merge Windows7 changes.reg\n"
32818 "\n"
32819 msgstr ""
32820
32821 # type: =head2
32822 #. type: =head1
32823 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
32824 msgid "NOTE"
32825 msgstr ""
32826
32827 # type: textblock
32828 #. type: textblock
32829 #: ../tools/virt-win-reg.pl:90
32830 msgid ""
32831 "This program is only meant for simple access to the registry.  If you want "
32832 "to do complicated things with the registry, we suggest you download the "
32833 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
32834 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
32835 "L<hivexregedit(1)>."
32836 msgstr ""
32837
32838 # type: textblock
32839 #. type: textblock
32840 #: ../tools/virt-win-reg.pl:106 ../tools/virt-list-filesystems.pl:63
32841 #: ../tools/virt-tar.pl:113 ../tools/virt-make-fs.pl:163
32842 #: ../tools/virt-list-partitions.pl:64
32843 msgid "Display brief help."
32844 msgstr ""
32845
32846 # type: textblock
32847 #. type: textblock
32848 #: ../tools/virt-win-reg.pl:114 ../tools/virt-list-filesystems.pl:71
32849 #: ../tools/virt-tar.pl:121 ../tools/virt-make-fs.pl:171
32850 #: ../tools/virt-list-partitions.pl:72
32851 msgid "Display version number and exit."
32852 msgstr ""
32853
32854 # type: =item
32855 #. type: =item
32856 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
32857 msgid "B<--debug>"
32858 msgstr ""
32859
32860 # type: textblock
32861 #. type: textblock
32862 #: ../tools/virt-win-reg.pl:122
32863 msgid "Enable debugging messages."
32864 msgstr ""
32865
32866 # type: =item
32867 #. type: =item
32868 #: ../tools/virt-win-reg.pl:128 ../tools/virt-list-filesystems.pl:77
32869 #: ../tools/virt-tar.pl:127 ../tools/virt-list-partitions.pl:78
32870 msgid "B<--connect URI> | B<-c URI>"
32871 msgstr ""
32872
32873 # type: textblock
32874 #. type: textblock
32875 #: ../tools/virt-win-reg.pl:130 ../tools/virt-list-filesystems.pl:79
32876 #: ../tools/virt-tar.pl:129 ../tools/virt-list-partitions.pl:80
32877 msgid ""
32878 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
32879 "to the default libvirt hypervisor."
32880 msgstr ""
32881
32882 # type: textblock
32883 #. type: textblock
32884 #: ../tools/virt-win-reg.pl:133 ../tools/virt-list-filesystems.pl:82
32885 #: ../tools/virt-tar.pl:132 ../tools/virt-list-partitions.pl:83
32886 msgid ""
32887 "If you specify guest block devices directly, then libvirt is not used at all."
32888 msgstr ""
32889
32890 # type: =item
32891 #. type: =item
32892 #: ../tools/virt-win-reg.pl:140 ../tools/virt-list-filesystems.pl:89
32893 #: ../tools/virt-tar.pl:139 ../tools/virt-list-partitions.pl:90
32894 msgid "B<--format> raw"
32895 msgstr ""
32896
32897 # type: textblock
32898 #. type: textblock
32899 #: ../tools/virt-win-reg.pl:142 ../tools/virt-list-filesystems.pl:91
32900 #: ../tools/virt-tar.pl:141 ../tools/virt-list-partitions.pl:92
32901 msgid ""
32902 "Specify the format of disk images given on the command line.  If this is "
32903 "omitted then the format is autodetected from the content of the disk image."
32904 msgstr ""
32905
32906 # type: textblock
32907 #. type: textblock
32908 #: ../tools/virt-win-reg.pl:146 ../tools/virt-list-filesystems.pl:95
32909 #: ../tools/virt-tar.pl:145 ../tools/virt-list-partitions.pl:96
32910 msgid ""
32911 "If disk images are requested from libvirt, then this program asks libvirt "
32912 "for this information.  In this case, the value of the format parameter is "
32913 "ignored."
32914 msgstr ""
32915
32916 # type: textblock
32917 #. type: textblock
32918 #: ../tools/virt-win-reg.pl:150 ../tools/virt-list-filesystems.pl:99
32919 #: ../tools/virt-tar.pl:149 ../tools/virt-list-partitions.pl:100
32920 msgid ""
32921 "If working with untrusted raw-format guest disk images, you should ensure "
32922 "the format is always specified."
32923 msgstr ""
32924
32925 # type: =item
32926 #. type: =item
32927 #: ../tools/virt-win-reg.pl:157
32928 msgid "B<--merge>"
32929 msgstr ""
32930
32931 # type: textblock
32932 #. type: textblock
32933 #: ../tools/virt-win-reg.pl:159
32934 msgid ""
32935 "In merge mode, this merges a textual regedit file into the Windows Registry "
32936 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
32937 "displays or exports Registry entries instead."
32938 msgstr ""
32939
32940 #. type: textblock
32941 #: ../tools/virt-win-reg.pl:163
32942 msgid ""
32943 "Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
32944 "result in disk corruption.  However exporting (without this flag)  is always "
32945 "safe."
32946 msgstr ""
32947
32948 # type: =item
32949 #. type: =item
32950 #: ../tools/virt-win-reg.pl:171
32951 msgid "B<--encoding> UTF-16LE|ASCII"
32952 msgstr ""
32953
32954 # type: textblock
32955 #. type: textblock
32956 #: ../tools/virt-win-reg.pl:173
32957 msgid ""
32958 "When merging (only), you may need to specify the encoding for strings to be "
32959 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
32960 "(3)/ENCODING STRINGS>."
32961 msgstr ""
32962
32963 # type: textblock
32964 #. type: textblock
32965 #: ../tools/virt-win-reg.pl:177
32966 msgid ""
32967 "The default is to use UTF-16LE, which should work with recent versions of "
32968 "Windows."
32969 msgstr ""
32970
32971 #. type: =item
32972 #: ../tools/virt-win-reg.pl:184
32973 msgid "B<--unsafe-printable-strings>"
32974 msgstr ""
32975
32976 #. type: textblock
32977 #: ../tools/virt-win-reg.pl:186
32978 msgid ""
32979 "When exporting (only), assume strings are UTF-16LE and print them as strings "
32980 "instead of hex sequences.  Remove the final zero codepoint from strings if "
32981 "present."
32982 msgstr ""
32983
32984 #. type: textblock
32985 #: ../tools/virt-win-reg.pl:190
32986 msgid ""
32987 "This is unsafe and does not preserve the fidelity of strings in the original "
32988 "Registry for various reasons:"
32989 msgstr ""
32990
32991 #. type: textblock
32992 #: ../tools/virt-win-reg.pl:197
32993 msgid ""
32994 "Assumes the original encoding is UTF-16LE.  ASCII strings and strings in "
32995 "other encodings will be corrupted by this transformation."
32996 msgstr ""
32997
32998 #. type: textblock
32999 #: ../tools/virt-win-reg.pl:202
33000 msgid ""
33001 "Assumes that everything which has type 1 or 2 is really a string and that "
33002 "everything else is not a string, but the type field in real Registries is "
33003 "not reliable."
33004 msgstr ""
33005
33006 #. type: textblock
33007 #: ../tools/virt-win-reg.pl:208
33008 msgid ""
33009 "Loses information about whether a zero codepoint followed the string in the "
33010 "Registry or not."
33011 msgstr ""
33012
33013 #. type: textblock
33014 #: ../tools/virt-win-reg.pl:213
33015 msgid ""
33016 "This all happens because the Registry itself contains no information about "
33017 "how strings are encoded (see L<Win::Hivex::Regedit(3)/ENCODING STRINGS>)."
33018 msgstr ""
33019
33020 #. type: textblock
33021 #: ../tools/virt-win-reg.pl:217
33022 msgid ""
33023 "You should only use this option for quick hacking and debugging of the "
33024 "Registry contents, and I<never> use it if the output is going to be passed "
33025 "into another program or stored in another Registry."
33026 msgstr ""
33027
33028 # type: =head2
33029 #. type: =head1
33030 #: ../tools/virt-win-reg.pl:554
33031 msgid "SUPPORTED SYSTEMS"
33032 msgstr ""
33033
33034 # type: textblock
33035 #. type: textblock
33036 #: ../tools/virt-win-reg.pl:556
33037 msgid ""
33038 "The program currently supports Windows NT-derived guests starting with "
33039 "Windows XP through to at least Windows 7."
33040 msgstr ""
33041
33042 #. type: textblock
33043 #: ../tools/virt-win-reg.pl:559
33044 msgid "The following Registry keys are supported:"
33045 msgstr ""
33046
33047 #. type: =item
33048 #: ../tools/virt-win-reg.pl:563
33049 msgid "C<HKEY_LOCAL_MACHINE\\SAM>"
33050 msgstr ""
33051
33052 #. type: =item
33053 #: ../tools/virt-win-reg.pl:565
33054 msgid "C<HKEY_LOCAL_MACHINE\\SECURITY>"
33055 msgstr ""
33056
33057 #. type: =item
33058 #: ../tools/virt-win-reg.pl:567
33059 msgid "C<HKEY_LOCAL_MACHINE\\SOFTWARE>"
33060 msgstr ""
33061
33062 #. type: =item
33063 #: ../tools/virt-win-reg.pl:569
33064 msgid "C<HKEY_LOCAL_MACHINE\\SYSTEM>"
33065 msgstr ""
33066
33067 #. type: =item
33068 #: ../tools/virt-win-reg.pl:571
33069 msgid "C<HKEY_USERS\\.DEFAULT>"
33070 msgstr ""
33071
33072 #. type: =item
33073 #: ../tools/virt-win-reg.pl:573
33074 msgid "C<HKEY_USERS\\I<SID>>"
33075 msgstr ""
33076
33077 #. type: textblock
33078 #: ../tools/virt-win-reg.pl:575
33079 msgid "where I<SID> is a Windows User SID (eg. C<S-1-5-18>)."
33080 msgstr ""
33081
33082 #. type: =item
33083 #: ../tools/virt-win-reg.pl:577
33084 msgid "C<HKEY_USERS\\I<username>>"
33085 msgstr ""
33086
33087 #. type: textblock
33088 #: ../tools/virt-win-reg.pl:579
33089 msgid ""
33090 "where I<username> is a local user name (this is a libguestfs extension)."
33091 msgstr ""
33092
33093 # type: textblock
33094 #. type: textblock
33095 #: ../tools/virt-win-reg.pl:583
33096 msgid ""
33097 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
33098 "C<HKEY_USERS>."
33099 msgstr ""
33100
33101 #. type: textblock
33102 #: ../tools/virt-win-reg.pl:586
33103 msgid ""
33104 "The literal keys C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are not "
33105 "supported (there is no \"current user\")."
33106 msgstr ""
33107
33108 # type: =head2
33109 #. type: =head1
33110 #: ../tools/virt-win-reg.pl:589
33111 msgid "ENCODING"
33112 msgstr ""
33113
33114 # type: textblock
33115 #. type: textblock
33116 #: ../tools/virt-win-reg.pl:591
33117 msgid ""
33118 "C<virt-win-reg> expects that regedit files have already been reencoded in "
33119 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
33120 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
33121 "Windows-style line endings, you may need to reencode the whole file before "
33122 "or after processing."
33123 msgstr ""
33124
33125 #. type: textblock
33126 #: ../tools/virt-win-reg.pl:597
33127 msgid ""
33128 "To reencode a file from Windows format to Linux (before processing it with "
33129 "the I<--merge> option), you would do something like this:"
33130 msgstr ""
33131
33132 # type: verbatim
33133 #. type: verbatim
33134 #: ../tools/virt-win-reg.pl:600
33135 #, no-wrap
33136 msgid ""
33137 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
33138 "\n"
33139 msgstr ""
33140
33141 # type: textblock
33142 #. type: textblock
33143 #: ../tools/virt-win-reg.pl:602
33144 msgid ""
33145 "To go in the opposite direction, after exporting and before sending the file "
33146 "to a Windows user, do something like this:"
33147 msgstr ""
33148
33149 # type: verbatim
33150 #. type: verbatim
33151 #: ../tools/virt-win-reg.pl:605
33152 #, no-wrap
33153 msgid ""
33154 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
33155 "\n"
33156 msgstr ""
33157
33158 # type: textblock
33159 #. type: textblock
33160 #: ../tools/virt-win-reg.pl:607
33161 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
33162 msgstr ""
33163
33164 # type: textblock
33165 #. type: textblock
33166 #: ../tools/virt-win-reg.pl:609
33167 msgid ""
33168 "If you are unsure about the current encoding, use the L<file(1)> command.  "
33169 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
33170 "style (CRLF) line endings, like this:"
33171 msgstr ""
33172
33173 # type: verbatim
33174 #. type: verbatim
33175 #: ../tools/virt-win-reg.pl:613
33176 #, no-wrap
33177 msgid ""
33178 " $ file software.reg\n"
33179 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
33180 " with CRLF line terminators\n"
33181 "\n"
33182 msgstr ""
33183
33184 #. type: textblock
33185 #: ../tools/virt-win-reg.pl:617
33186 msgid "This file would need conversion before you could I<--merge> it."
33187 msgstr ""
33188
33189 # type: =head2
33190 #. type: =head1
33191 #: ../tools/virt-win-reg.pl:619
33192 msgid "CurrentControlSet etc."
33193 msgstr ""
33194
33195 # type: textblock
33196 #. type: textblock
33197 #: ../tools/virt-win-reg.pl:621
33198 msgid ""
33199 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
33200 "Registry at the level of the hive file, and therefore you cannot modify "
33201 "these."
33202 msgstr ""
33203
33204 # type: textblock
33205 #. type: textblock
33206 #: ../tools/virt-win-reg.pl:625
33207 msgid ""
33208 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
33209 "circumstances it might refer to another control set.  The way to find out is "
33210 "to look at the C<HKLM\\SYSTEM\\Select> key:"
33211 msgstr ""
33212
33213 # type: verbatim
33214 #. type: verbatim
33215 #: ../tools/virt-win-reg.pl:629
33216 #, no-wrap
33217 msgid ""
33218 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
33219 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
33220 " \"Current\"=dword:00000001\n"
33221 " \"Default\"=dword:00000001\n"
33222 " \"Failed\"=dword:00000000\n"
33223 " \"LastKnownGood\"=dword:00000002\n"
33224 "\n"
33225 msgstr ""
33226
33227 # type: textblock
33228 #. type: textblock
33229 #: ../tools/virt-win-reg.pl:636
33230 msgid "\"Current\" is the one which Windows will choose when it boots."
33231 msgstr ""
33232
33233 # type: textblock
33234 #. type: textblock
33235 #: ../tools/virt-win-reg.pl:638
33236 msgid ""
33237 "Similarly, other C<Current...> keys in the path may need to be replaced."
33238 msgstr ""
33239
33240 # type: =head1
33241 #. type: =head1
33242 #: ../tools/virt-win-reg.pl:641
33243 msgid "WINDOWS TIPS"
33244 msgstr ""
33245
33246 # type: textblock
33247 #. type: textblock
33248 #: ../tools/virt-win-reg.pl:643
33249 msgid ""
33250 "Note that some of these tips modify the guest disk image.  The guest I<must> "
33251 "be shut off, else you will get disk corruption."
33252 msgstr ""
33253
33254 # type: =head2
33255 #. type: =head2
33256 #: ../tools/virt-win-reg.pl:646
33257 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
33258 msgstr ""
33259
33260 # type: textblock
33261 #. type: textblock
33262 #: ../tools/virt-win-reg.pl:648
33263 msgid ""
33264 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
33265 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
33266 "is uploaded into C<C:\\>:"
33267 msgstr ""
33268
33269 # type: verbatim
33270 #. type: verbatim
33271 #: ../tools/virt-win-reg.pl:652
33272 #, no-wrap
33273 msgid ""
33274 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
33275 "\n"
33276 msgstr ""
33277
33278 # type: textblock
33279 #. type: textblock
33280 #: ../tools/virt-win-reg.pl:654
33281 msgid "Prepare a regedit file containing the registry change:"
33282 msgstr ""
33283
33284 # type: verbatim
33285 #. type: verbatim
33286 #: ../tools/virt-win-reg.pl:656
33287 #, no-wrap
33288 msgid ""
33289 " cat > test.reg <<'EOF'\n"
33290 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
33291 " \"Test\"=\"c:\\\\test.bat\"\n"
33292 " EOF\n"
33293 "\n"
33294 msgstr ""
33295
33296 # type: textblock
33297 #. type: textblock
33298 #: ../tools/virt-win-reg.pl:661
33299 msgid ""
33300 "In this example we use the key C<RunOnce> which means that the script will "
33301 "run precisely once when the first user logs in.  If you want it to run every "
33302 "time a user logs in, replace C<RunOnce> with C<Run>."
33303 msgstr ""
33304
33305 # type: textblock
33306 #. type: textblock
33307 #: ../tools/virt-win-reg.pl:665
33308 msgid "Now update the registry:"
33309 msgstr ""
33310
33311 # type: verbatim
33312 #. type: verbatim
33313 #: ../tools/virt-win-reg.pl:667
33314 #, no-wrap
33315 msgid ""
33316 " virt-win-reg --merge WindowsGuest test.reg\n"
33317 "\n"
33318 msgstr ""
33319
33320 # type: =head2
33321 #. type: =head2
33322 #: ../tools/virt-win-reg.pl:669
33323 msgid "INSTALLING A SERVICE"
33324 msgstr ""
33325
33326 # type: textblock
33327 #. type: textblock
33328 #: ../tools/virt-win-reg.pl:671
33329 msgid ""
33330 "This section assumes you are familiar with Windows services, and you either "
33331 "have a program which handles the Windows Service Control Protocol directly "
33332 "or you want to run any program using a service wrapper like SrvAny or the "
33333 "free RHSrvAny."
33334 msgstr ""
33335
33336 # type: textblock
33337 #. type: textblock
33338 #: ../tools/virt-win-reg.pl:676
33339 msgid ""
33340 "First upload the program and optionally the service wrapper.  In this case "
33341 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
33342 msgstr ""
33343
33344 # type: verbatim
33345 #. type: verbatim
33346 #: ../tools/virt-win-reg.pl:680
33347 #, no-wrap
33348 msgid ""
33349 " guestfish -i -d WindowsGuest <<EOF\n"
33350 "   upload rhsrvany.exe /rhsrvany.exe\n"
33351 "   upload test.exe /test.exe\n"
33352 " EOF\n"
33353 "\n"
33354 msgstr ""
33355
33356 # type: textblock
33357 #. type: textblock
33358 #: ../tools/virt-win-reg.pl:685
33359 msgid ""
33360 "Prepare a regedit file containing the registry changes.  In this example, "
33361 "the first registry change is needed for the service itself or the service "
33362 "wrapper (if used).  The second registry change is only needed because I am "
33363 "using the RHSrvAny service wrapper."
33364 msgstr ""
33365
33366 # type: verbatim
33367 #. type: verbatim
33368 #: ../tools/virt-win-reg.pl:690
33369 #, no-wrap
33370 msgid ""
33371 " cat > service.reg <<'EOF'\n"
33372 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
33373 " \"Type\"=dword:00000010\n"
33374 " \"Start\"=dword:00000002\n"
33375 " \"ErrorControl\"=dword:00000001\n"
33376 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
33377 " \"DisplayName\"=\"RHSrvAny\"\n"
33378 " \"ObjectName\"=\"NetworkService\"\n"
33379 " \n"
33380 msgstr ""
33381
33382 # type: verbatim
33383 #. type: verbatim
33384 #: ../tools/virt-win-reg.pl:699
33385 #, no-wrap
33386 msgid ""
33387 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
33388 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
33389 " \"PWD\"=\"c:\\\\Temp\"\n"
33390 " EOF\n"
33391 "\n"
33392 msgstr ""
33393
33394 # type: textblock
33395 #. type: textblock
33396 #: ../tools/virt-win-reg.pl:710
33397 msgid ""
33398 "For use of C<ControlSet001> see the section above in this manual page.  You "
33399 "may need to adjust this according to the control set that is in use by the "
33400 "guest."
33401 msgstr ""
33402
33403 # type: textblock
33404 #. type: textblock
33405 #: ../tools/virt-win-reg.pl:716
33406 msgid ""
33407 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
33408 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
33409 "privileged account."
33410 msgstr ""
33411
33412 # type: textblock
33413 #. type: textblock
33414 #: ../tools/virt-win-reg.pl:722
33415 msgid ""
33416 "For the meaning of the magic numbers, see this Microsoft KB article: "
33417 "L<http://support.microsoft.com/kb/103000>."
33418 msgstr ""
33419
33420 # type: textblock
33421 #. type: textblock
33422 #: ../tools/virt-win-reg.pl:727
33423 msgid "Update the registry:"
33424 msgstr ""
33425
33426 # type: verbatim
33427 #. type: verbatim
33428 #: ../tools/virt-win-reg.pl:729
33429 #, no-wrap
33430 msgid ""
33431 " virt-win-reg --merge WindowsGuest service.reg\n"
33432 "\n"
33433 msgstr ""
33434
33435 # type: =head2
33436 #. type: =head1
33437 #: ../tools/virt-win-reg.pl:731 ../tools/virt-list-filesystems.pl:182
33438 #: ../tools/virt-tar.pl:279 ../tools/virt-make-fs.pl:532
33439 #: ../tools/virt-list-partitions.pl:250
33440 msgid "SHELL QUOTING"
33441 msgstr ""
33442
33443 # type: textblock
33444 #. type: textblock
33445 #: ../tools/virt-win-reg.pl:733
33446 msgid ""
33447 "Be careful when passing parameters containing C<\\> (backslash) in the "
33448 "shell.  Usually you will have to use 'single quotes' or double backslashes "
33449 "(but not both) to protect them from the shell."
33450 msgstr ""
33451
33452 # type: textblock
33453 #. type: textblock
33454 #: ../tools/virt-win-reg.pl:737
33455 msgid "Paths and value names are case-insensitive."
33456 msgstr ""
33457
33458 # type: textblock
33459 #. type: textblock
33460 #: ../tools/virt-win-reg.pl:739 ../tools/virt-list-filesystems.pl:184
33461 #: ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:534
33462 #: ../tools/virt-list-partitions.pl:252
33463 msgid ""
33464 "Libvirt guest names can contain arbitrary characters, some of which have "
33465 "meaning to the shell such as C<#> and space.  You may need to quote or "
33466 "escape these characters on the command line.  See the shell manual page L<sh"
33467 "(1)> for details."
33468 msgstr ""
33469
33470 # type: textblock
33471 #. type: textblock
33472 #: ../tools/virt-win-reg.pl:746
33473 msgid ""
33474 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
33475 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
33476 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33477 msgstr ""
33478
33479 # type: textblock
33480 #. type: textblock
33481 #: ../tools/virt-win-reg.pl:761 ../tools/virt-make-fs.pl:555
33482 msgid ""
33483 "When reporting bugs, please enable debugging and capture the I<complete> "
33484 "output:"
33485 msgstr ""
33486
33487 # type: verbatim
33488 #. type: verbatim
33489 #: ../tools/virt-win-reg.pl:764
33490 #, no-wrap
33491 msgid ""
33492 " export LIBGUESTFS_DEBUG=1\n"
33493 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
33494 "\n"
33495 msgstr ""
33496
33497 # type: textblock
33498 #. type: textblock
33499 #: ../tools/virt-win-reg.pl:767
33500 msgid ""
33501 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
33502 "redhat.com/>"
33503 msgstr ""
33504
33505 # type: =head1
33506 #. type: =head1
33507 #: ../tools/virt-win-reg.pl:770 ../tools/virt-list-filesystems.pl:202
33508 #: ../tools/virt-tar.pl:301 ../tools/virt-make-fs.pl:564
33509 #: ../tools/virt-list-partitions.pl:269
33510 msgid "AUTHOR"
33511 msgstr ""
33512
33513 # type: textblock
33514 #. type: textblock
33515 #: ../tools/virt-win-reg.pl:772 ../tools/virt-list-filesystems.pl:204
33516 #: ../tools/virt-tar.pl:303 ../tools/virt-make-fs.pl:566
33517 #: ../tools/virt-list-partitions.pl:271
33518 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
33519 msgstr ""
33520
33521 # type: textblock
33522 #. type: textblock
33523 #: ../tools/virt-win-reg.pl:776 ../tools/virt-make-fs.pl:570
33524 msgid "Copyright (C) 2010 Red Hat Inc."
33525 msgstr ""
33526
33527 # type: textblock
33528 #. type: textblock
33529 #: ../tools/virt-list-filesystems.pl:32
33530 msgid ""
33531 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
33532 msgstr ""
33533
33534 # type: verbatim
33535 #. type: verbatim
33536 #: ../tools/virt-list-filesystems.pl:36
33537 #, no-wrap
33538 msgid ""
33539 " virt-list-filesystems [--options] domname\n"
33540 "\n"
33541 msgstr ""
33542
33543 # type: verbatim
33544 #. type: verbatim
33545 #: ../tools/virt-list-filesystems.pl:38
33546 #, no-wrap
33547 msgid ""
33548 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
33549 "\n"
33550 msgstr ""
33551
33552 # type: textblock
33553 #. type: textblock
33554 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
33555 msgid ""
33556 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
33557 "replacement."
33558 msgstr ""
33559
33560 # type: textblock
33561 #. type: textblock
33562 #: ../tools/virt-list-filesystems.pl:45
33563 msgid ""
33564 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
33565 "are contained in a virtual machine or disk image."
33566 msgstr ""
33567
33568 # type: textblock
33569 #. type: textblock
33570 #: ../tools/virt-list-filesystems.pl:49
33571 msgid ""
33572 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
33573 "functionality.  For more complex cases you should look at the L<guestfish(1)"
33574 "> tool."
33575 msgstr ""
33576
33577 # type: =item
33578 #. type: =item
33579 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
33580 msgid "B<-l> | B<--long>"
33581 msgstr ""
33582
33583 # type: textblock
33584 #. type: textblock
33585 #: ../tools/virt-list-filesystems.pl:108
33586 msgid ""
33587 "With this option, C<virt-list-filesystems> displays the type of each "
33588 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
33589 msgstr ""
33590
33591 # type: =item
33592 #. type: =item
33593 #: ../tools/virt-list-filesystems.pl:115
33594 msgid "B<-a> | B<--all>"
33595 msgstr ""
33596
33597 # type: textblock
33598 #. type: textblock
33599 #: ../tools/virt-list-filesystems.pl:117
33600 msgid ""
33601 "Normally we only show mountable filesystems.  If this option is given then "
33602 "swap devices are shown too."
33603 msgstr ""
33604
33605 # type: textblock
33606 #. type: textblock
33607 #: ../tools/virt-list-filesystems.pl:191
33608 msgid ""
33609 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
33610 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
33611 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33612 msgstr ""
33613
33614 # type: textblock
33615 #. type: textblock
33616 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
33617 msgid "Copyright (C) 2009 Red Hat Inc."
33618 msgstr ""
33619
33620 # type: textblock
33621 #. type: textblock
33622 #: ../tools/virt-tar.pl:33
33623 msgid "virt-tar - Extract or upload files to a virtual machine"
33624 msgstr ""
33625
33626 # type: verbatim
33627 #. type: verbatim
33628 #: ../tools/virt-tar.pl:37
33629 #, no-wrap
33630 msgid ""
33631 " virt-tar [--options] -x domname directory tarball\n"
33632 "\n"
33633 msgstr ""
33634
33635 # type: verbatim
33636 #. type: verbatim
33637 #: ../tools/virt-tar.pl:39
33638 #, no-wrap
33639 msgid ""
33640 " virt-tar [--options] -u domname tarball directory\n"
33641 "\n"
33642 msgstr ""
33643
33644 # type: verbatim
33645 #. type: verbatim
33646 #: ../tools/virt-tar.pl:41
33647 #, no-wrap
33648 msgid ""
33649 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
33650 "\n"
33651 msgstr ""
33652
33653 # type: verbatim
33654 #. type: verbatim
33655 #: ../tools/virt-tar.pl:43
33656 #, no-wrap
33657 msgid ""
33658 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
33659 "\n"
33660 msgstr ""
33661
33662 #. type: textblock
33663 #: ../tools/virt-tar.pl:47
33664 msgid ""
33665 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
33666 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
33667 msgstr ""
33668
33669 # type: textblock
33670 #. type: textblock
33671 #: ../tools/virt-tar.pl:52
33672 msgid "Download C</home> from the VM into a local tarball:"
33673 msgstr ""
33674
33675 # type: verbatim
33676 #. type: verbatim
33677 #: ../tools/virt-tar.pl:54
33678 #, no-wrap
33679 msgid ""
33680 " virt-tar -x domname /home home.tar\n"
33681 "\n"
33682 msgstr ""
33683
33684 # type: verbatim
33685 #. type: verbatim
33686 #: ../tools/virt-tar.pl:56
33687 #, no-wrap
33688 msgid ""
33689 " virt-tar -zx domname /home home.tar.gz\n"
33690 "\n"
33691 msgstr ""
33692
33693 # type: textblock
33694 #. type: textblock
33695 #: ../tools/virt-tar.pl:58
33696 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
33697 msgstr ""
33698
33699 # type: verbatim
33700 #. type: verbatim
33701 #: ../tools/virt-tar.pl:60
33702 #, no-wrap
33703 msgid ""
33704 " virt-tar -u domname uploadstuff.tar /tmp\n"
33705 "\n"
33706 msgstr ""
33707
33708 # type: verbatim
33709 #. type: verbatim
33710 #: ../tools/virt-tar.pl:62
33711 #, no-wrap
33712 msgid ""
33713 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
33714 "\n"
33715 msgstr ""
33716
33717 #. type: textblock
33718 #: ../tools/virt-tar.pl:66
33719 msgid ""
33720 "You must I<not> use C<virt-tar> with the I<-u> option (upload) on live "
33721 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
33722 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
33723 msgstr ""
33724
33725 #. type: textblock
33726 #: ../tools/virt-tar.pl:71
33727 msgid ""
33728 "You can use I<-x> (extract) on live virtual machines, but you might get "
33729 "inconsistent results or errors if there is filesystem activity inside the "
33730 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
33731 "work, but the only way to guarantee consistent results is if the virtual "
33732 "machine is shut down."
33733 msgstr ""
33734
33735 # type: textblock
33736 #. type: textblock
33737 #: ../tools/virt-tar.pl:79
33738 msgid ""
33739 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
33740 "parts of a guest filesystem.  There are many possibilities: making backups, "
33741 "uploading data files, snooping on guest activity, fixing or customizing "
33742 "guests, etc."
33743 msgstr ""
33744
33745 # type: textblock
33746 #. type: textblock
33747 #: ../tools/virt-tar.pl:84
33748 msgid ""
33749 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
33750 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
33751 "should look at the L<guestfish(1)> tool."
33752 msgstr ""
33753
33754 #. type: textblock
33755 #: ../tools/virt-tar.pl:88
33756 msgid ""
33757 "There are two modes of operation: I<-x> (eXtract) downloads a directory and "
33758 "its contents (recursively) from the virtual machine into a local tarball.  "
33759 "I<-u> uploads from a local tarball, unpacking it into a directory inside the "
33760 "virtual machine.  You cannot use these two options together."
33761 msgstr ""
33762
33763 #. type: textblock
33764 #: ../tools/virt-tar.pl:94
33765 msgid ""
33766 "In addition, you may need to use the I<-z> (gZip) option to enable "
33767 "compression.  When uploading, you have to specify I<-z> if the upload file "
33768 "is compressed because virt-tar won't detect this on its own."
33769 msgstr ""
33770
33771 # type: textblock
33772 #. type: textblock
33773 #: ../tools/virt-tar.pl:98
33774 msgid ""
33775 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
33776 "example it cannot do PKZip files or bzip2 compression.  If you want that "
33777 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
33778 "the L<libguestfs(3)> API)."
33779 msgstr ""
33780
33781 # type: =item
33782 #. type: =item
33783 #: ../tools/virt-tar.pl:156
33784 msgid "B<-x> | B<--extract> | B<--download>"
33785 msgstr ""
33786
33787 # type: =item
33788 #. type: =item
33789 #: ../tools/virt-tar.pl:158
33790 msgid "B<-u> | B<--upload>"
33791 msgstr ""
33792
33793 #. type: textblock
33794 #: ../tools/virt-tar.pl:160
33795 msgid ""
33796 "Use I<-x> to extract (download) a directory from a virtual machine to a "
33797 "local tarball."
33798 msgstr ""
33799
33800 #. type: textblock
33801 #: ../tools/virt-tar.pl:163
33802 msgid ""
33803 "Use I<-u> to upload and unpack from a local tarball into a virtual machine.  "
33804 "Please read the L</WARNING> section above before using this option."
33805 msgstr ""
33806
33807 # type: textblock
33808 #. type: textblock
33809 #: ../tools/virt-tar.pl:167
33810 msgid "You must specify exactly one of these options."
33811 msgstr ""
33812
33813 # type: =item
33814 #. type: =item
33815 #: ../tools/virt-tar.pl:173
33816 msgid "B<-z> | B<--gzip>"
33817 msgstr ""
33818
33819 # type: textblock
33820 #. type: textblock
33821 #: ../tools/virt-tar.pl:175
33822 msgid "Specify that the input or output tarball is gzip-compressed."
33823 msgstr ""
33824
33825 #. type: textblock
33826 #: ../tools/virt-tar.pl:288
33827 msgid ""
33828 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
33829 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
33830 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
33831 "org/>."
33832 msgstr ""
33833
33834 # type: textblock
33835 #. type: textblock
33836 #: ../tools/virt-make-fs.pl:37
33837 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
33838 msgstr ""
33839
33840 # type: verbatim
33841 #. type: verbatim
33842 #: ../tools/virt-make-fs.pl:41
33843 #, no-wrap
33844 msgid ""
33845 " virt-make-fs [--options] input.tar output.img\n"
33846 "\n"
33847 msgstr ""
33848
33849 # type: verbatim
33850 #. type: verbatim
33851 #: ../tools/virt-make-fs.pl:43
33852 #, no-wrap
33853 msgid ""
33854 " virt-make-fs [--options] input.tar.gz output.img\n"
33855 "\n"
33856 msgstr ""
33857
33858 # type: verbatim
33859 #. type: verbatim
33860 #: ../tools/virt-make-fs.pl:45
33861 #, no-wrap
33862 msgid ""
33863 " virt-make-fs [--options] directory output.img\n"
33864 "\n"
33865 msgstr ""
33866
33867 # type: textblock
33868 #. type: textblock
33869 #: ../tools/virt-make-fs.pl:49
33870 msgid ""
33871 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
33872 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
33873 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
33874 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
33875 "you want to attach these filesystems to existing virtual machines (eg. to "
33876 "import large amounts of read-only data to a VM)."
33877 msgstr ""
33878
33879 # type: textblock
33880 #. type: textblock
33881 #: ../tools/virt-make-fs.pl:57
33882 msgid "Basic usage is:"
33883 msgstr ""
33884
33885 # type: verbatim
33886 #. type: verbatim
33887 #: ../tools/virt-make-fs.pl:59
33888 #, no-wrap
33889 msgid ""
33890 " virt-make-fs input output\n"
33891 "\n"
33892 msgstr ""
33893
33894 # type: textblock
33895 #. type: textblock
33896 #: ../tools/virt-make-fs.pl:61
33897 msgid ""
33898 "where C<input> is either a directory containing files that you want to add, "
33899 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
33900 "C<output> is a disk image.  The input type is detected automatically.  The "
33901 "output disk image defaults to a raw ext2 image unless you specify extra "
33902 "flags (see L</OPTIONS> below)."
33903 msgstr ""
33904
33905 # type: =head2
33906 #. type: =head2
33907 #: ../tools/virt-make-fs.pl:67
33908 msgid "EXTRA SPACE"
33909 msgstr ""
33910
33911 #. type: textblock
33912 #: ../tools/virt-make-fs.pl:69
33913 msgid ""
33914 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
33915 "the files that it contains, but might have extra space.  Depending on how "
33916 "you are going to use the output, you might think this extra space is wasted "
33917 "and want to minimize it, or you might want to leave space so that more files "
33918 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
33919 "but you can use the I<--size> flag to leave space in the filesystem if you "
33920 "want it."
33921 msgstr ""
33922
33923 #. type: textblock
33924 #: ../tools/virt-make-fs.pl:77
33925 msgid ""
33926 "An alternative way to leave extra space but not make the output image any "
33927 "bigger is to use an alternative disk image format (instead of the default "
33928 "\"raw\" format).  Using I<--format=qcow2> will use the native QEmu/KVM qcow2 "
33929 "image format (check your hypervisor supports this before using it).  This "
33930 "allows you to choose a large I<--size> but the extra space won't actually be "
33931 "allocated in the image until you try to store something in it."
33932 msgstr ""
33933
33934 #. type: textblock
33935 #: ../tools/virt-make-fs.pl:85
33936 msgid ""
33937 "Don't forget that you can also use local commands including L<resize2fs(8)> "
33938 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
33939 "to build another image from scratch."
33940 msgstr ""
33941
33942 # type: =head3
33943 #. type: =head3
33944 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
33945 #: ../tools/virt-make-fs.pl:142
33946 msgid "EXAMPLE"
33947 msgstr ""
33948
33949 # type: verbatim
33950 #. type: verbatim
33951 #: ../tools/virt-make-fs.pl:91
33952 #, no-wrap
33953 msgid ""
33954 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
33955 "\n"
33956 msgstr ""
33957
33958 # type: =head2
33959 #. type: =head2
33960 #: ../tools/virt-make-fs.pl:93
33961 msgid "FILESYSTEM TYPE"
33962 msgstr ""
33963
33964 # type: textblock
33965 #. type: textblock
33966 #: ../tools/virt-make-fs.pl:95
33967 msgid ""
33968 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
33969 "libguestfs supports can be used (but I<not> read-only formats like "
33970 "ISO9660).  Here are some of the more common choices:"
33971 msgstr ""
33972
33973 # type: =item
33974 #. type: =item
33975 #: ../tools/virt-make-fs.pl:101
33976 msgid "I<ext3>"
33977 msgstr ""
33978
33979 # type: textblock
33980 #. type: textblock
33981 #: ../tools/virt-make-fs.pl:103
33982 msgid ""
33983 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
33984 "you are not going to use the filesystem in a way that requires the journal, "
33985 "then this is just wasted overhead."
33986 msgstr ""
33987
33988 # type: =item
33989 #. type: =item
33990 #: ../tools/virt-make-fs.pl:107
33991 msgid "I<ntfs> or I<vfat>"
33992 msgstr ""
33993
33994 # type: textblock
33995 #. type: textblock
33996 #: ../tools/virt-make-fs.pl:109
33997 msgid "Useful if exporting data to a Windows guest."
33998 msgstr ""
33999
34000 # type: textblock
34001 #. type: textblock
34002 #: ../tools/virt-make-fs.pl:111
34003 msgid ""
34004 "I<Note for vfat>: The tar archive or local directory must only contain files "
34005 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
34006 "program running within libguestfs is unable to change the ownership of non-"
34007 "root files, since vfat itself does not support this."
34008 msgstr ""
34009
34010 # type: =item
34011 #. type: =item
34012 #: ../tools/virt-make-fs.pl:116
34013 msgid "I<minix>"
34014 msgstr ""
34015
34016 # type: textblock
34017 #. type: textblock
34018 #: ../tools/virt-make-fs.pl:118
34019 msgid ""
34020 "Lower overhead than C<ext2>, but certain limitations on filename length and "
34021 "total filesystem size."
34022 msgstr ""
34023
34024 # type: verbatim
34025 #. type: verbatim
34026 #: ../tools/virt-make-fs.pl:125
34027 #, no-wrap
34028 msgid ""
34029 " virt-make-fs --type=minix input minixfs.img\n"
34030 "\n"
34031 msgstr ""
34032
34033 # type: =head2
34034 #. type: =head2
34035 #: ../tools/virt-make-fs.pl:127
34036 msgid "TO PARTITION OR NOT TO PARTITION"
34037 msgstr ""
34038
34039 # type: textblock
34040 #. type: textblock
34041 #: ../tools/virt-make-fs.pl:129
34042 msgid "Optionally virt-make-fs can add a partition table to the output disk."
34043 msgstr ""
34044
34045 # type: textblock
34046 #. type: textblock
34047 #: ../tools/virt-make-fs.pl:131
34048 msgid ""
34049 "Adding a partition can make the disk image more compatible with certain "
34050 "virtualized operating systems which don't expect to see a filesystem "
34051 "directly located on a block device (Linux doesn't care and will happily "
34052 "handle both types)."
34053 msgstr ""
34054
34055 # type: textblock
34056 #. type: textblock
34057 #: ../tools/virt-make-fs.pl:136
34058 msgid ""
34059 "On the other hand, if you have a partition table then the output image is no "
34060 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
34061 "directly on a partitioned disk image.  (However libguestfs tools such as "
34062 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
34063 msgstr ""
34064
34065 # type: textblock
34066 #. type: textblock
34067 #: ../tools/virt-make-fs.pl:144
34068 msgid "Add an MBR partition:"
34069 msgstr ""
34070
34071 # type: verbatim
34072 #. type: verbatim
34073 #: ../tools/virt-make-fs.pl:146
34074 #, no-wrap
34075 msgid ""
34076 " virt-make-fs --partition -- input disk.img\n"
34077 "\n"
34078 msgstr ""
34079
34080 # type: textblock
34081 #. type: textblock
34082 #: ../tools/virt-make-fs.pl:148
34083 msgid ""
34084 "If the output disk image could be terabyte-sized or larger, it's better to "
34085 "use an EFI/GPT-compatible partition table:"
34086 msgstr ""
34087
34088 # type: verbatim
34089 #. type: verbatim
34090 #: ../tools/virt-make-fs.pl:151
34091 #, no-wrap
34092 msgid ""
34093 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
34094 "\n"
34095 msgstr ""
34096
34097 # type: textblock
34098 #. type: textblock
34099 #: ../tools/virt-make-fs.pl:179
34100 msgid "Enable debugging information."
34101 msgstr ""
34102
34103 # type: =item
34104 #. type: =item
34105 #: ../tools/virt-make-fs.pl:185
34106 msgid "B<--size=E<lt>NE<gt>>"
34107 msgstr ""
34108
34109 # type: =item
34110 #. type: =item
34111 #: ../tools/virt-make-fs.pl:187
34112 msgid "B<--size=+E<lt>NE<gt>>"
34113 msgstr ""
34114
34115 # type: =item
34116 #. type: =item
34117 #: ../tools/virt-make-fs.pl:189
34118 msgid "B<-s E<lt>NE<gt>>"
34119 msgstr ""
34120
34121 # type: =item
34122 #. type: =item
34123 #: ../tools/virt-make-fs.pl:191
34124 msgid "B<-s +E<lt>NE<gt>>"
34125 msgstr ""
34126
34127 #. type: textblock
34128 #: ../tools/virt-make-fs.pl:193
34129 msgid ""
34130 "Use the I<--size> (or I<-s>) option to choose the size of the output image."
34131 msgstr ""
34132
34133 # type: textblock
34134 #. type: textblock
34135 #: ../tools/virt-make-fs.pl:196
34136 msgid ""
34137 "If this option is I<not> given, then the output image will be just large "
34138 "enough to contain all the files, with not much wasted space."
34139 msgstr ""
34140
34141 # type: textblock
34142 #. type: textblock
34143 #: ../tools/virt-make-fs.pl:199
34144 msgid ""
34145 "To choose a fixed size output disk, specify an absolute number followed by b/"
34146 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34147 "Petabytes or Exabytes.  This must be large enough to contain all the input "
34148 "files, else you will get an error."
34149 msgstr ""
34150
34151 #. type: textblock
34152 #: ../tools/virt-make-fs.pl:204
34153 msgid ""
34154 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
34155 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34156 "Petabytes or Exabytes.  For example: I<--size=+200M> means enough space for "
34157 "the input files, and (approximately) an extra 200 MB free space."
34158 msgstr ""
34159
34160 # type: textblock
34161 #. type: textblock
34162 #: ../tools/virt-make-fs.pl:210
34163 msgid ""
34164 "Note that virt-make-fs estimates free space, and therefore will not produce "
34165 "filesystems containing precisely the free space requested.  (It is much more "
34166 "expensive and time-consuming to produce a filesystem which has precisely the "
34167 "desired free space)."
34168 msgstr ""
34169
34170 # type: =item
34171 #. type: =item
34172 #: ../tools/virt-make-fs.pl:219
34173 msgid "B<--format=E<lt>fmtE<gt>>"
34174 msgstr ""
34175
34176 # type: =item
34177 #. type: =item
34178 #: ../tools/virt-make-fs.pl:221
34179 msgid "B<-F E<lt>fmtE<gt>>"
34180 msgstr ""
34181
34182 # type: textblock
34183 #. type: textblock
34184 #: ../tools/virt-make-fs.pl:223
34185 msgid "Choose the output disk image format."
34186 msgstr ""
34187
34188 # type: textblock
34189 #. type: textblock
34190 #: ../tools/virt-make-fs.pl:225
34191 msgid "The default is C<raw> (raw disk image)."
34192 msgstr ""
34193
34194 # type: textblock
34195 #. type: textblock
34196 #: ../tools/virt-make-fs.pl:227
34197 msgid ""
34198 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
34199 "that would really make sense here is C<qcow2>."
34200 msgstr ""
34201
34202 # type: =item
34203 #. type: =item
34204 #: ../tools/virt-make-fs.pl:234
34205 msgid "B<--type=E<lt>fsE<gt>>"
34206 msgstr ""
34207
34208 # type: =item
34209 #. type: =item
34210 #: ../tools/virt-make-fs.pl:236
34211 msgid "B<-t E<lt>fsE<gt>>"
34212 msgstr ""
34213
34214 # type: textblock
34215 #. type: textblock
34216 #: ../tools/virt-make-fs.pl:238
34217 msgid "Choose the output filesystem type."
34218 msgstr ""
34219
34220 # type: textblock
34221 #. type: textblock
34222 #: ../tools/virt-make-fs.pl:240
34223 msgid "The default is C<ext2>."
34224 msgstr ""
34225
34226 # type: textblock
34227 #. type: textblock
34228 #: ../tools/virt-make-fs.pl:242
34229 msgid ""
34230 "Any filesystem which is supported read-write by libguestfs can be used here."
34231 msgstr ""
34232
34233 # type: =item
34234 #. type: =item
34235 #: ../tools/virt-make-fs.pl:249
34236 msgid "B<--partition>"
34237 msgstr ""
34238
34239 # type: =item
34240 #. type: =item
34241 #: ../tools/virt-make-fs.pl:251
34242 msgid "B<--partition=E<lt>parttypeE<gt>>"
34243 msgstr ""
34244
34245 # type: textblock
34246 #. type: textblock
34247 #: ../tools/virt-make-fs.pl:253
34248 msgid ""
34249 "If specified, this flag adds an MBR partition table to the output disk image."
34250 msgstr ""
34251
34252 #. type: textblock
34253 #: ../tools/virt-make-fs.pl:256
34254 msgid ""
34255 "You can change the partition table type, eg. I<--partition=gpt> for large "
34256 "disks."
34257 msgstr ""
34258
34259 #. type: textblock
34260 #: ../tools/virt-make-fs.pl:259
34261 msgid ""
34262 "Note that if you just use a lonesome I<--partition>, the Perl option parser "
34263 "might consider the next parameter to be the partition type.  For example:"
34264 msgstr ""
34265
34266 # type: verbatim
34267 #. type: verbatim
34268 #: ../tools/virt-make-fs.pl:263
34269 #, no-wrap
34270 msgid ""
34271 " virt-make-fs --partition input.tar ...\n"
34272 "\n"
34273 msgstr ""
34274
34275 #. type: textblock
34276 #: ../tools/virt-make-fs.pl:265
34277 msgid ""
34278 "would cause virt-make-fs to think you wanted to use a partition type of "
34279 "C<input.tar> which is completely wrong.  To avoid this, use I<--> (a double "
34280 "dash) between options and the input file argument:"
34281 msgstr ""
34282
34283 # type: verbatim
34284 #. type: verbatim
34285 #: ../tools/virt-make-fs.pl:269
34286 #, no-wrap
34287 msgid ""
34288 " virt-make-fs --partition -- input.tar ...\n"
34289 "\n"
34290 msgstr ""
34291
34292 #. type: textblock
34293 #: ../tools/virt-make-fs.pl:541
34294 msgid ""
34295 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
34296 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
34297 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
34298 msgstr ""
34299
34300 # type: verbatim
34301 #. type: verbatim
34302 #: ../tools/virt-make-fs.pl:558
34303 #, no-wrap
34304 msgid ""
34305 " export LIBGUESTFS_DEBUG=1\n"
34306 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
34307 "\n"
34308 msgstr ""
34309
34310 # type: textblock
34311 #. type: textblock
34312 #: ../tools/virt-make-fs.pl:561
34313 msgid ""
34314 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
34315 "redhat.com/>"
34316 msgstr ""
34317
34318 # type: textblock
34319 #. type: textblock
34320 #: ../tools/virt-list-partitions.pl:32
34321 msgid ""
34322 "virt-list-partitions - List partitions in a virtual machine or disk image"
34323 msgstr ""
34324
34325 # type: verbatim
34326 #. type: verbatim
34327 #: ../tools/virt-list-partitions.pl:36
34328 #, no-wrap
34329 msgid ""
34330 " virt-list-partitions [--options] domname\n"
34331 "\n"
34332 msgstr ""
34333
34334 # type: verbatim
34335 #. type: verbatim
34336 #: ../tools/virt-list-partitions.pl:38
34337 #, no-wrap
34338 msgid ""
34339 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
34340 "\n"
34341 msgstr ""
34342
34343 # type: textblock
34344 #. type: textblock
34345 #: ../tools/virt-list-partitions.pl:45
34346 msgid ""
34347 "C<virt-list-partitions> is a command line tool to list the partitions that "
34348 "are contained in a virtual machine or disk image.  It is mainly useful as a "
34349 "first step to using L<virt-resize(1)>."
34350 msgstr ""
34351
34352 # type: textblock
34353 #. type: textblock
34354 #: ../tools/virt-list-partitions.pl:50
34355 msgid ""
34356 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
34357 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34358 "> tool."
34359 msgstr ""
34360
34361 # type: =item
34362 #. type: =item
34363 #: ../tools/virt-list-partitions.pl:107
34364 msgid "B<-h> | B<--human-readable>"
34365 msgstr ""
34366
34367 # type: textblock
34368 #. type: textblock
34369 #: ../tools/virt-list-partitions.pl:109
34370 msgid "Show sizes in human-readable form (eg. \"1G\")."
34371 msgstr ""
34372
34373 # type: textblock
34374 #. type: textblock
34375 #: ../tools/virt-list-partitions.pl:117
34376 msgid ""
34377 "With this option, C<virt-list-partitions> displays the type and size of each "
34378 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
34379 msgstr ""
34380
34381 # type: =item
34382 #. type: =item
34383 #: ../tools/virt-list-partitions.pl:124
34384 msgid "B<-t> | B<--total>"
34385 msgstr ""
34386
34387 # type: textblock
34388 #. type: textblock
34389 #: ../tools/virt-list-partitions.pl:126
34390 msgid ""
34391 "Display the total size of each block device (as a separate row or rows)."
34392 msgstr ""
34393
34394 # type: textblock
34395 #. type: textblock
34396 #: ../tools/virt-list-partitions.pl:259
34397 msgid ""
34398 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
34399 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
34400 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34401 msgstr ""
34402
34403 # type: textblock
34404 #. type: textblock
34405 #: ../tools/virt-list-partitions.pl:275
34406 msgid "Copyright (C) 2009-2010 Red Hat Inc."
34407 msgstr ""