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-04-22 22:23+0200\n"
  11 "PO-Revision-Date: 2010-09-02 14:46+0100\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 # type: =head1
  20 #. type: =head1
  21 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3
  22 #: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3
  23 #: ../tools/virt-edit.pl:32 ../tools/virt-win-reg.pl:35
  24 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-tar.pl:31
  25 #: ../tools/virt-make-fs.pl:35 ../tools/virt-list-partitions.pl:30
  26 msgid "NAME"
  27 msgstr "名前"
  28
  29 # type: textblock
  30 #. type: textblock
  31 #: ../src/guestfs.pod:5
  32 msgid "guestfs - Library for accessing and modifying virtual machine images"
  33 msgstr ""
  34
  35 # type: =head1
  36 #. type: =head1
  37 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7
  38 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7
  39 #: ../tools/virt-edit.pl:36 ../tools/virt-win-reg.pl:39
  40 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-tar.pl:35
  41 #: ../tools/virt-make-fs.pl:39 ../tools/virt-list-partitions.pl:34
  42 msgid "SYNOPSIS"
  43 msgstr ""
  44
  45 # type: verbatim
  46 #. type: verbatim
  47 #: ../src/guestfs.pod:9
  48 #, no-wrap
  49 msgid ""
  50 " #include <guestfs.h>\n"
  51 " \n"
  52 msgstr ""
  53
  54 # type: verbatim
  55 #. type: verbatim
  56 #: ../src/guestfs.pod:11
  57 #, no-wrap
  58 msgid ""
  59 " guestfs_h *g = guestfs_create ();\n"
  60 " guestfs_add_drive (g, \"guest.img\");\n"
  61 " guestfs_launch (g);\n"
  62 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
  63 " guestfs_touch (g, \"/hello\");\n"
  64 " guestfs_umount (g, \"/\");\n"
  65 " guestfs_close (g);\n"
  66 "\n"
  67 msgstr ""
  68
  69 # type: verbatim
  70 #. type: verbatim
  71 #: ../src/guestfs.pod:19
  72 #, no-wrap
  73 msgid ""
  74 " cc prog.c -o prog -lguestfs\n"
  75 "or:\n"
  76 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
  77 "\n"
  78 msgstr ""
  79
  80 # type: =head1
  81 #. type: =head1
  82 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
  83 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
  84 #: ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63
  85 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-tar.pl:77
  86 #: ../tools/virt-make-fs.pl:47 ../tools/virt-list-partitions.pl:40
  87 msgid "DESCRIPTION"
  88 msgstr ""
  89
  90 # type: textblock
  91 #. type: textblock
  92 #: ../src/guestfs.pod:25
  93 msgid ""
  94 "Libguestfs is a library for accessing and modifying guest disk images.  "
  95 "Amongst the things this is good for: making batch configuration changes to "
  96 "guests, getting disk used/free statistics (see also: virt-df), migrating "
  97 "between virtualization systems (see also: virt-p2v), performing partial "
  98 "backups, performing partial guest clones, cloning guests and changing "
  99 "registry/UUID/hostname info, and much else besides."
 100 msgstr ""
 101
 102 # type: textblock
 103 #. type: textblock
 104 #: ../src/guestfs.pod:33
 105 msgid ""
 106 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
 107 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
 108 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
 109 "qcow2, vmdk."
 110 msgstr ""
 111
 112 # type: textblock
 113 #. type: textblock
 114 #: ../src/guestfs.pod:38
 115 msgid ""
 116 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
 117 "what filesystem is in each LV, etc.).  It can also run commands in the "
 118 "context of the guest.  Also you can access filesystems over FUSE."
 119 msgstr ""
 120
 121 # type: textblock
 122 #. type: textblock
 123 #: ../src/guestfs.pod:43
 124 msgid ""
 125 "Libguestfs is a library that can be linked with C and C++ management "
 126 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
 127 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
 128 "line."
 129 msgstr ""
 130
 131 # type: textblock
 132 #. type: textblock
 133 #: ../src/guestfs.pod:48
 134 msgid ""
 135 "You don't need to be root to use libguestfs, although obviously you do need "
 136 "enough permissions to access the disk images."
 137 msgstr ""
 138
 139 # type: textblock
 140 #. type: textblock
 141 #: ../src/guestfs.pod:51
 142 msgid ""
 143 "Libguestfs is a large API because it can do many things.  For a gentle "
 144 "introduction, please read the L</API OVERVIEW> section next."
 145 msgstr ""
 146
 147 # type: textblock
 148 #. type: textblock
 149 #: ../src/guestfs.pod:54
 150 msgid ""
 151 "There are also some example programs in the L<guestfs-examples(3)> manual "
 152 "page."
 153 msgstr ""
 154
 155 # type: =head1
 156 #. type: =head1
 157 #: ../src/guestfs.pod:57
 158 msgid "API OVERVIEW"
 159 msgstr ""
 160
 161 # type: textblock
 162 #. type: textblock
 163 #: ../src/guestfs.pod:59
 164 msgid ""
 165 "This section provides a gentler overview of the libguestfs API.  We also try "
 166 "to group API calls together, where that may not be obvious from reading "
 167 "about the individual calls in the main section of this manual."
 168 msgstr ""
 169
 170 # type: =head2
 171 #. type: =head2
 172 #: ../src/guestfs.pod:64
 173 msgid "HANDLES"
 174 msgstr ""
 175
 176 # type: textblock
 177 #. type: textblock
 178 #: ../src/guestfs.pod:66
 179 msgid ""
 180 "Before you can use libguestfs calls, you have to create a handle.  Then you "
 181 "must add at least one disk image to the handle, followed by launching the "
 182 "handle, then performing whatever operations you want, and finally closing "
 183 "the handle.  By convention we use the single letter C<g> for the name of the "
 184 "handle variable, although of course you can use any name you want."
 185 msgstr ""
 186
 187 # type: textblock
 188 #. type: textblock
 189 #: ../src/guestfs.pod:73
 190 msgid "The general structure of all libguestfs-using programs looks like this:"
 191 msgstr ""
 192
 193 # type: verbatim
 194 #. type: verbatim
 195 #: ../src/guestfs.pod:76
 196 #, no-wrap
 197 msgid ""
 198 " guestfs_h *g = guestfs_create ();\n"
 199 " \n"
 200 msgstr ""
 201
 202 # type: verbatim
 203 #. type: verbatim
 204 #: ../src/guestfs.pod:78
 205 #, no-wrap
 206 msgid ""
 207 " /* Call guestfs_add_drive additional times if there are\n"
 208 "  * multiple disk images.\n"
 209 "  */\n"
 210 " guestfs_add_drive (g, \"guest.img\");\n"
 211 " \n"
 212 msgstr ""
 213
 214 # type: verbatim
 215 #. type: verbatim
 216 #: ../src/guestfs.pod:83
 217 #, no-wrap
 218 msgid ""
 219 " /* Most manipulation calls won't work until you've launched\n"
 220 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
 221 "  * and _before_ other commands.\n"
 222 "  */\n"
 223 " guestfs_launch (g);\n"
 224 " \n"
 225 msgstr ""
 226
 227 # type: verbatim
 228 #. type: verbatim
 229 #: ../src/guestfs.pod:89
 230 #, no-wrap
 231 msgid ""
 232 " /* Now you can examine what partitions, LVs etc are available.\n"
 233 "  */\n"
 234 " char **partitions = guestfs_list_partitions (g);\n"
 235 " char **logvols = guestfs_lvs (g);\n"
 236 " \n"
 237 msgstr ""
 238
 239 # type: verbatim
 240 #. type: verbatim
 241 #: ../src/guestfs.pod:94
 242 #, no-wrap
 243 msgid ""
 244 " /* To access a filesystem in the image, you must mount it.\n"
 245 "  */\n"
 246 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
 247 " \n"
 248 msgstr ""
 249
 250 #. type: verbatim
 251 #: ../src/guestfs.pod:98
 252 #, no-wrap
 253 msgid ""
 254 " /* Now you can perform filesystem actions on the guest\n"
 255 "  * disk image.\n"
 256 "  */\n"
 257 " guestfs_touch (g, \"/hello\");\n"
 258 " \n"
 259 msgstr ""
 260
 261 # type: verbatim
 262 #. type: verbatim
 263 #: ../src/guestfs.pod:103
 264 #, no-wrap
 265 msgid ""
 266 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
 267 "  * it is done automatically when you close the handle.  See\n"
 268 "  * discussion of autosync in this page.\n"
 269 "  */\n"
 270 " guestfs_sync (g);\n"
 271 " \n"
 272 msgstr ""
 273
 274 # type: verbatim
 275 #. type: verbatim
 276 #: ../src/guestfs.pod:109
 277 #, no-wrap
 278 msgid ""
 279 " /* Close the handle 'g'. */\n"
 280 " guestfs_close (g);\n"
 281 "\n"
 282 msgstr ""
 283
 284 # type: textblock
 285 #. type: textblock
 286 #: ../src/guestfs.pod:112
 287 msgid ""
 288 "The code above doesn't include any error checking.  In real code you should "
 289 "check return values carefully for errors.  In general all functions that "
 290 "return integers return C<-1> on error, and all functions that return "
 291 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
 292 "how to handle errors, and consult the documentation for each function call "
 293 "below to see precisely how they return error indications.  See L<guestfs-"
 294 "examples(3)> for fully worked examples."
 295 msgstr ""
 296
 297 # type: =head2
 298 #. type: =head2
 299 #: ../src/guestfs.pod:121
 300 msgid "DISK IMAGES"
 301 msgstr ""
 302
 303 # type: textblock
 304 #. type: textblock
 305 #: ../src/guestfs.pod:123
 306 msgid ""
 307 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
 308 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
 309 "actual block device, or simply an empty file of zeroes that you have created "
 310 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
 311 "of these."
 312 msgstr ""
 313
 314 # type: textblock
 315 #. type: textblock
 316 #: ../src/guestfs.pod:129
 317 msgid ""
 318 "The call you should use in modern code for adding drives is L</"
 319 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
 320 "specifying that the format is raw, do:"
 321 msgstr ""
 322
 323 # type: verbatim
 324 #. type: verbatim
 325 #: ../src/guestfs.pod:133
 326 #, no-wrap
 327 msgid ""
 328 " guestfs_add_drive_opts (g, filename,\n"
 329 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 330 "                         -1);\n"
 331 "\n"
 332 msgstr ""
 333
 334 # type: textblock
 335 #. type: textblock
 336 #: ../src/guestfs.pod:137
 337 msgid "You can add a disk read-only using:"
 338 msgstr ""
 339
 340 # type: verbatim
 341 #. type: verbatim
 342 #: ../src/guestfs.pod:139
 343 #, no-wrap
 344 msgid ""
 345 " guestfs_add_drive_opts (g, filename,\n"
 346 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 347 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
 348 "                         -1);\n"
 349 "\n"
 350 msgstr ""
 351
 352 # type: textblock
 353 #. type: textblock
 354 #: ../src/guestfs.pod:144
 355 msgid ""
 356 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
 357 "libguestfs won't modify the file."
 358 msgstr ""
 359
 360 # type: textblock
 361 #. type: textblock
 362 #: ../src/guestfs.pod:147
 363 msgid ""
 364 "Be extremely cautious if the disk image is in use, eg. if it is being used "
 365 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
 366 "corruption, but adding it read-only is safe."
 367 msgstr ""
 368
 369 # type: textblock
 370 #. type: textblock
 371 #: ../src/guestfs.pod:151
 372 msgid ""
 373 "You must add at least one disk image, and you may add multiple disk images.  "
 374 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
 375 "first one you added), C</dev/sdb> (for the second one you added), etc."
 376 msgstr ""
 377
 378 # type: textblock
 379 #. type: textblock
 380 #: ../src/guestfs.pod:156
 381 msgid ""
 382 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
 383 "can call L</guestfs_list_devices> to get a list of the device names, in the "
 384 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
 385 msgstr ""
 386
 387 # type: =head2
 388 #. type: =head2
 389 #: ../src/guestfs.pod:161
 390 msgid "MOUNTING"
 391 msgstr ""
 392
 393 #. type: textblock
 394 #: ../src/guestfs.pod:163
 395 msgid ""
 396 "Before you can read or write files, create directories and so on in a disk "
 397 "image that contains filesystems, you have to mount those filesystems using "
 398 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
 399 "a disk image contains (for example) one partition with a filesystem on that "
 400 "partition, then you can mount it directly:"
 401 msgstr ""
 402
 403 #. type: verbatim
 404 #: ../src/guestfs.pod:170
 405 #, no-wrap
 406 msgid ""
 407 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
 408 "\n"
 409 msgstr ""
 410
 411 #. type: textblock
 412 #: ../src/guestfs.pod:172
 413 msgid ""
 414 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
 415 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
 416 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
 417 "that these are libguestfs virtual devices, and are nothing to do with host "
 418 "devices."
 419 msgstr ""
 420
 421 #. type: textblock
 422 #: ../src/guestfs.pod:178
 423 msgid ""
 424 "If you are given a disk image and you don't know what it contains then you "
 425 "have to find out.  Libguestfs can do that too: use L</"
 426 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
 427 "LVs, and either try mounting each to see what is mountable, or else examine "
 428 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
 429 "filesystems, use L</guestfs_list_filesystems>."
 430 msgstr ""
 431
 432 #. type: textblock
 433 #: ../src/guestfs.pod:186
 434 msgid ""
 435 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
 436 "L</INSPECTION> below).  But you might find it easier to look at higher level "
 437 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
 438 msgstr ""
 439
 440 #. type: textblock
 441 #: ../src/guestfs.pod:191
 442 msgid ""
 443 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
 444 "several other variations of the C<guestfs_mount_*> call."
 445 msgstr ""
 446
 447 # type: =head2
 448 #. type: =head2
 449 #: ../src/guestfs.pod:194
 450 msgid "FILESYSTEM ACCESS AND MODIFICATION"
 451 msgstr ""
 452
 453 # type: textblock
 454 #. type: textblock
 455 #: ../src/guestfs.pod:196
 456 msgid ""
 457 "The majority of the libguestfs API consists of fairly low-level calls for "
 458 "accessing and modifying the files, directories, symlinks etc on mounted "
 459 "filesystems.  There are over a hundred such calls which you can find listed "
 460 "in detail below in this man page, and we don't even pretend to cover them "
 461 "all in this overview."
 462 msgstr ""
 463
 464 # type: textblock
 465 #. type: textblock
 466 #: ../src/guestfs.pod:202
 467 msgid ""
 468 "Specify filenames as full paths, starting with C<\"/\"> and including the "
 469 "mount point."
 470 msgstr ""
 471
 472 # type: textblock
 473 #. type: textblock
 474 #: ../src/guestfs.pod:205
 475 msgid ""
 476 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
 477 "the file called C<\"etc/passwd\"> then you could do:"
 478 msgstr ""
 479
 480 # type: verbatim
 481 #. type: verbatim
 482 #: ../src/guestfs.pod:208
 483 #, no-wrap
 484 msgid ""
 485 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
 486 "\n"
 487 msgstr ""
 488
 489 # type: textblock
 490 #. type: textblock
 491 #: ../src/guestfs.pod:210
 492 msgid ""
 493 "This would return C<data> as a newly allocated buffer containing the full "
 494 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
 495 "or C<NULL> if there was an error."
 496 msgstr ""
 497
 498 # type: textblock
 499 #. type: textblock
 500 #: ../src/guestfs.pod:214
 501 msgid ""
 502 "As another example, to create a top-level directory on that filesystem "
 503 "called C<\"var\"> you would do:"
 504 msgstr ""
 505
 506 # type: verbatim
 507 #. type: verbatim
 508 #: ../src/guestfs.pod:217
 509 #, no-wrap
 510 msgid ""
 511 " guestfs_mkdir (g, \"/var\");\n"
 512 "\n"
 513 msgstr ""
 514
 515 # type: textblock
 516 #. type: textblock
 517 #: ../src/guestfs.pod:219
 518 msgid "To create a symlink you could do:"
 519 msgstr ""
 520
 521 # type: verbatim
 522 #. type: verbatim
 523 #: ../src/guestfs.pod:221
 524 #, no-wrap
 525 msgid ""
 526 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
 527 "               \"/etc/rc3.d/S30portmap\");\n"
 528 "\n"
 529 msgstr ""
 530
 531 # type: textblock
 532 #. type: textblock
 533 #: ../src/guestfs.pod:224
 534 msgid ""
 535 "Libguestfs will reject attempts to use relative paths and there is no "
 536 "concept of a current working directory."
 537 msgstr ""
 538
 539 # type: textblock
 540 #. type: textblock
 541 #: ../src/guestfs.pod:227
 542 msgid ""
 543 "Libguestfs can return errors in many situations: for example if the "
 544 "filesystem isn't writable, or if a file or directory that you requested "
 545 "doesn't exist.  If you are using the C API (documented here)  you have to "
 546 "check for those error conditions after each call.  (Other language bindings "
 547 "turn these errors into exceptions)."
 548 msgstr ""
 549
 550 # type: textblock
 551 #. type: textblock
 552 #: ../src/guestfs.pod:233
 553 msgid ""
 554 "File writes are affected by the per-handle umask, set by calling L</"
 555 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
 556 msgstr ""
 557
 558 # type: =head2
 559 #. type: =head2
 560 #: ../src/guestfs.pod:236
 561 msgid "PARTITIONING"
 562 msgstr ""
 563
 564 # type: textblock
 565 #. type: textblock
 566 #: ../src/guestfs.pod:238
 567 msgid ""
 568 "Libguestfs contains API calls to read, create and modify partition tables on "
 569 "disk images."
 570 msgstr ""
 571
 572 # type: textblock
 573 #. type: textblock
 574 #: ../src/guestfs.pod:241
 575 msgid ""
 576 "In the common case where you want to create a single partition covering the "
 577 "whole disk, you should use the L</guestfs_part_disk> call:"
 578 msgstr ""
 579
 580 # type: verbatim
 581 #. type: verbatim
 582 #: ../src/guestfs.pod:245
 583 #, no-wrap
 584 msgid ""
 585 " const char *parttype = \"mbr\";\n"
 586 " if (disk_is_larger_than_2TB)\n"
 587 "   parttype = \"gpt\";\n"
 588 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
 589 "\n"
 590 msgstr ""
 591
 592 # type: textblock
 593 #. type: textblock
 594 #: ../src/guestfs.pod:250
 595 msgid ""
 596 "Obviously this effectively wipes anything that was on that disk image before."
 597 msgstr ""
 598
 599 # type: =head2
 600 #. type: =head2
 601 #: ../src/guestfs.pod:253
 602 msgid "LVM2"
 603 msgstr ""
 604
 605 # type: textblock
 606 #. type: textblock
 607 #: ../src/guestfs.pod:255
 608 msgid ""
 609 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
 610 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
 611 "you familiarize yourself with the concepts of physical volumes, volume "
 612 "groups and logical volumes."
 613 msgstr ""
 614
 615 # type: textblock
 616 #. type: textblock
 617 #: ../src/guestfs.pod:260
 618 msgid ""
 619 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
 620 "tldp.org/HOWTO/LVM-HOWTO/>."
 621 msgstr ""
 622
 623 # type: =head2
 624 #. type: =head2
 625 #: ../src/guestfs.pod:263
 626 msgid "DOWNLOADING"
 627 msgstr ""
 628
 629 #. type: textblock
 630 #: ../src/guestfs.pod:265
 631 msgid ""
 632 "Use L</guestfs_cat> to download small, text only files.  This call is "
 633 "limited to files which are less than 2 MB and which cannot contain any ASCII "
 634 "NUL (C<\\0>) characters.  However the API is very simple to use."
 635 msgstr ""
 636
 637 # type: textblock
 638 #. type: textblock
 639 #: ../src/guestfs.pod:269
 640 msgid ""
 641 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
 642 "bit data, since it returns a (pointer, size) pair.  However it is still "
 643 "limited to \"small\" files, less than 2 MB."
 644 msgstr ""
 645
 646 # type: textblock
 647 #. type: textblock
 648 #: ../src/guestfs.pod:273
 649 msgid ""
 650 "L</guestfs_download> can be used to download any file, with no limits on "
 651 "content or size (even files larger than 4 GB)."
 652 msgstr ""
 653
 654 # type: textblock
 655 #. type: textblock
 656 #: ../src/guestfs.pod:276
 657 msgid ""
 658 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
 659 msgstr ""
 660
 661 # type: =head2
 662 #. type: =head2
 663 #: ../src/guestfs.pod:279
 664 msgid "UPLOADING"
 665 msgstr ""
 666
 667 # type: textblock
 668 #. type: textblock
 669 #: ../src/guestfs.pod:281
 670 msgid ""
 671 "It's often the case that you want to write a file or files to the disk image."
 672 msgstr ""
 673
 674 # type: textblock
 675 #. type: textblock
 676 #: ../src/guestfs.pod:284
 677 msgid ""
 678 "To write a small file with fixed content, use L</guestfs_write>.  To create "
 679 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
 680 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
 681 "of other functions for creating test files, for example L</guestfs_fill> and "
 682 "L</guestfs_fill_pattern>."
 683 msgstr ""
 684
 685 # type: textblock
 686 #. type: textblock
 687 #: ../src/guestfs.pod:290
 688 msgid ""
 689 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
 690 "file content or size (even files larger than 4 GB)."
 691 msgstr ""
 692
 693 # type: textblock
 694 #. type: textblock
 695 #: ../src/guestfs.pod:293
 696 msgid ""
 697 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
 698 msgstr ""
 699
 700 # type: textblock
 701 #. type: textblock
 702 #: ../src/guestfs.pod:295
 703 msgid ""
 704 "However the fastest way to upload I<large numbers of arbitrary files> is to "
 705 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
 706 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
 707 "in a predictable way (eg. adding it last after all other drives) then you "
 708 "can get the device name from L</guestfs_list_devices> and mount it directly "
 709 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
 710 "portable between kernel versions, and they don't support labels or UUIDs.  "
 711 "If you want to pre-build an image or you need to mount it using a label or "
 712 "UUID, use an ISO image instead."
 713 msgstr ""
 714
 715 # type: =head2
 716 #. type: =head2
 717 #: ../src/guestfs.pod:306
 718 msgid "COPYING"
 719 msgstr ""
 720
 721 # type: textblock
 722 #. type: textblock
 723 #: ../src/guestfs.pod:308
 724 msgid ""
 725 "There are various different commands for copying between files and devices "
 726 "and in and out of the guest filesystem.  These are summarised in the table "
 727 "below."
 728 msgstr ""
 729
 730 # type: =item
 731 #. type: =item
 732 #: ../src/guestfs.pod:314
 733 msgid "B<file> to B<file>"
 734 msgstr ""
 735
 736 # type: textblock
 737 #. type: textblock
 738 #: ../src/guestfs.pod:316
 739 msgid ""
 740 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
 741 "directories recursively."
 742 msgstr ""
 743
 744 # type: =item
 745 #. type: =item
 746 #: ../src/guestfs.pod:319
 747 msgid "B<file or device> to B<file or device>"
 748 msgstr ""
 749
 750 # type: textblock
 751 #. type: textblock
 752 #: ../src/guestfs.pod:321
 753 msgid ""
 754 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
 755 "devices in the guest."
 756 msgstr ""
 757
 758 # type: textblock
 759 #. type: textblock
 760 #: ../src/guestfs.pod:324
 761 msgid "Example: duplicate the contents of an LV:"
 762 msgstr ""
 763
 764 # type: verbatim
 765 #. type: verbatim
 766 #: ../src/guestfs.pod:326
 767 #, no-wrap
 768 msgid ""
 769 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
 770 "\n"
 771 msgstr ""
 772
 773 # type: textblock
 774 #. type: textblock
 775 #: ../src/guestfs.pod:328
 776 msgid ""
 777 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
 778 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
 779 "guestfs_copy_size>."
 780 msgstr ""
 781
 782 # type: =item
 783 #. type: =item
 784 #: ../src/guestfs.pod:332
 785 msgid "B<file on the host> to B<file or device>"
 786 msgstr ""
 787
 788 # type: textblock
 789 #. type: textblock
 790 #: ../src/guestfs.pod:334
 791 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
 792 msgstr ""
 793
 794 # type: =item
 795 #. type: =item
 796 #: ../src/guestfs.pod:336
 797 msgid "B<file or device> to B<file on the host>"
 798 msgstr ""
 799
 800 # type: textblock
 801 #. type: textblock
 802 #: ../src/guestfs.pod:338
 803 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
 804 msgstr ""
 805
 806 # type: =head2
 807 #. type: =head2
 808 #: ../src/guestfs.pod:342
 809 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
 810 msgstr ""
 811
 812 # type: textblock
 813 #. type: textblock
 814 #: ../src/guestfs.pod:344
 815 msgid ""
 816 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
 817 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
 818 "appears you can only upload and download to files.  However many Un*x-like "
 819 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
 820 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
 821 "and arbitrary file descriptor N."
 822 msgstr ""
 823
 824 # type: textblock
 825 #. type: textblock
 826 #: ../src/guestfs.pod:352
 827 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
 828 msgstr ""
 829
 830 #. type: verbatim
 831 #: ../src/guestfs.pod:355
 832 #, no-wrap
 833 msgid ""
 834 " guestfs_download (g, filename, \"/dev/stdout\");\n"
 835 "\n"
 836 msgstr ""
 837
 838 # type: textblock
 839 #. type: textblock
 840 #: ../src/guestfs.pod:357
 841 msgid "and you can write tar output to a pipe C<fd> by doing:"
 842 msgstr ""
 843
 844 #. type: verbatim
 845 #: ../src/guestfs.pod:359
 846 #, no-wrap
 847 msgid ""
 848 " char devfd[64];\n"
 849 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
 850 " guestfs_tar_out (g, \"/\", devfd);\n"
 851 "\n"
 852 msgstr ""
 853
 854 # type: =head2
 855 #. type: =head2
 856 #: ../src/guestfs.pod:363
 857 msgid "LISTING FILES"
 858 msgstr ""
 859
 860 # type: textblock
 861 #. type: textblock
 862 #: ../src/guestfs.pod:365
 863 msgid ""
 864 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
 865 "L<guestfish(1)>-equivalent command C<ll>)."
 866 msgstr ""
 867
 868 # type: textblock
 869 #. type: textblock
 870 #: ../src/guestfs.pod:368
 871 msgid ""
 872 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
 873 "programs, as a flat list of strings."
 874 msgstr ""
 875
 876 # type: textblock
 877 #. type: textblock
 878 #: ../src/guestfs.pod:371
 879 msgid ""
 880 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
 881 "directory, plus additional information about each one.  It is more "
 882 "equivalent to using the L<readdir(3)> call on a local filesystem."
 883 msgstr ""
 884
 885 # type: textblock
 886 #. type: textblock
 887 #: ../src/guestfs.pod:375
 888 msgid ""
 889 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
 890 msgstr ""
 891
 892 # type: =head2
 893 #. type: =head2
 894 #: ../src/guestfs.pod:378
 895 msgid "RUNNING COMMANDS"
 896 msgstr ""
 897
 898 # type: textblock
 899 #. type: textblock
 900 #: ../src/guestfs.pod:380
 901 msgid ""
 902 "Although libguestfs is primarily an API for manipulating files inside guest "
 903 "images, we also provide some limited facilities for running commands inside "
 904 "guests."
 905 msgstr ""
 906
 907 # type: textblock
 908 #. type: textblock
 909 #: ../src/guestfs.pod:384
 910 msgid "There are many limitations to this:"
 911 msgstr ""
 912
 913 # type: =item
 914 #. type: =item
 915 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
 916 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
 917 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1087
 918 #: ../src/guestfs.pod:1091 ../src/guestfs.pod:1095 ../src/guestfs.pod:1100
 919 #: ../src/guestfs.pod:1108 ../src/guestfs.pod:1127 ../src/guestfs.pod:1135
 920 #: ../src/guestfs.pod:1157 ../src/guestfs.pod:1161 ../src/guestfs.pod:1165
 921 #: ../src/guestfs.pod:1169 ../src/guestfs.pod:1173 ../src/guestfs.pod:1177
 922 #: ../src/guestfs.pod:1659 ../src/guestfs.pod:1664 ../src/guestfs.pod:1668
 923 #: ../src/guestfs.pod:1769 ../src/guestfs.pod:1774 ../src/guestfs.pod:1778
 924 #: ../src/guestfs.pod:1788 ../src/guestfs.pod:2022 ../src/guestfs.pod:2027
 925 #: ../src/guestfs.pod:2033 ../src/guestfs.pod:2041 ../src/guestfs.pod:2395
 926 #: ../src/guestfs.pod:2401 ../src/guestfs.pod:2406 ../src/guestfs.pod:2412
 927 #: ../src/guestfs.pod:2877 ../src/guestfs.pod:2881 ../src/guestfs.pod:2885
 928 #: ../src/guestfs.pod:2889 ../src/guestfs-actions.pod:15
 929 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:577
 930 #: ../src/guestfs-actions.pod:585 ../src/guestfs-actions.pod:592
 931 #: ../src/guestfs-actions.pod:599 ../src/guestfs-actions.pod:1600
 932 #: ../src/guestfs-actions.pod:1604 ../src/guestfs-actions.pod:1608
 933 #: ../src/guestfs-actions.pod:1612 ../src/guestfs-actions.pod:1620
 934 #: ../src/guestfs-actions.pod:1624 ../src/guestfs-actions.pod:1628
 935 #: ../src/guestfs-actions.pod:1638 ../src/guestfs-actions.pod:1642
 936 #: ../src/guestfs-actions.pod:1646 ../src/guestfs-actions.pod:1784
 937 #: ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1793
 938 #: ../src/guestfs-actions.pod:1798 ../src/guestfs-actions.pod:1859
 939 #: ../src/guestfs-actions.pod:1863 ../src/guestfs-actions.pod:1868
 940 #: ../fish/guestfish.pod:443 ../fish/guestfish.pod:447
 941 #: ../fish/guestfish.pod:451 ../fish/guestfish.pod:455
 942 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
 943 #: ../fish/guestfish-actions.pod:380 ../fish/guestfish-actions.pod:388
 944 #: ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:402
 945 #: ../fish/guestfish-actions.pod:1072 ../fish/guestfish-actions.pod:1076
 946 #: ../fish/guestfish-actions.pod:1080 ../fish/guestfish-actions.pod:1084
 947 #: ../fish/guestfish-actions.pod:1092 ../fish/guestfish-actions.pod:1096
 948 #: ../fish/guestfish-actions.pod:1100 ../fish/guestfish-actions.pod:1110
 949 #: ../fish/guestfish-actions.pod:1114 ../fish/guestfish-actions.pod:1118
 950 #: ../fish/guestfish-actions.pod:1208 ../fish/guestfish-actions.pod:1212
 951 #: ../fish/guestfish-actions.pod:1217 ../fish/guestfish-actions.pod:1222
 952 #: ../fish/guestfish-actions.pod:1264 ../fish/guestfish-actions.pod:1268
 953 #: ../fish/guestfish-actions.pod:1273 ../tools/virt-edit.pl:351
 954 #: ../tools/virt-edit.pl:356 ../tools/virt-edit.pl:361
 955 #: ../tools/virt-edit.pl:372 ../tools/virt-edit.pl:376
 956 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
 957 #: ../tools/virt-win-reg.pl:548
 958 msgid "*"
 959 msgstr ""
 960
 961 # type: textblock
 962 #. type: textblock
 963 #: ../src/guestfs.pod:390
 964 msgid ""
 965 "The kernel version that the command runs under will be different from what "
 966 "it expects."
 967 msgstr ""
 968
 969 # type: textblock
 970 #. type: textblock
 971 #: ../src/guestfs.pod:395
 972 msgid ""
 973 "If the command needs to communicate with daemons, then most likely they "
 974 "won't be running."
 975 msgstr ""
 976
 977 # type: textblock
 978 #. type: textblock
 979 #: ../src/guestfs.pod:400
 980 msgid "The command will be running in limited memory."
 981 msgstr ""
 982
 983 # type: textblock
 984 #. type: textblock
 985 #: ../src/guestfs.pod:404
 986 msgid ""
 987 "The network may not be available unless you enable it (see L</"
 988 "guestfs_set_network>)."
 989 msgstr ""
 990
 991 # type: textblock
 992 #. type: textblock
 993 #: ../src/guestfs.pod:409
 994 msgid "Only supports Linux guests (not Windows, BSD, etc)."
 995 msgstr ""
 996
 997 # type: textblock
 998 #. type: textblock
 999 #: ../src/guestfs.pod:413
1000 msgid ""
1001 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1002 msgstr ""
1003
1004 # type: textblock
1005 #. type: textblock
1006 #: ../src/guestfs.pod:418
1007 msgid ""
1008 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1009 "See L</SELINUX> in this manpage."
1010 msgstr ""
1011
1012 # type: textblock
1013 #. type: textblock
1014 #: ../src/guestfs.pod:423
1015 msgid ""
1016 "I<Security:> It is not safe to run commands from untrusted, possibly "
1017 "malicious guests.  These commands may attempt to exploit your program by "
1018 "sending unexpected output.  They could also try to exploit the Linux kernel "
1019 "or qemu provided by the libguestfs appliance.  They could use the network "
1020 "provided by the libguestfs appliance to bypass ordinary network partitions "
1021 "and firewalls.  They could use the elevated privileges or different SELinux "
1022 "context of your program to their advantage."
1023 msgstr ""
1024
1025 # type: textblock
1026 #. type: textblock
1027 #: ../src/guestfs.pod:432
1028 msgid ""
1029 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1030 "(a script which runs when the guest next boots normally), and to have this "
1031 "script run the commands you want in the normal context of the running guest, "
1032 "network security and so on.  For information about other security issues, "
1033 "see L</SECURITY>."
1034 msgstr ""
1035
1036 # type: textblock
1037 #. type: textblock
1038 #: ../src/guestfs.pod:440
1039 msgid ""
1040 "The two main API calls to run commands are L</guestfs_command> and L</"
1041 "guestfs_sh> (there are also variations)."
1042 msgstr ""
1043
1044 # type: textblock
1045 #. type: textblock
1046 #: ../src/guestfs.pod:443
1047 msgid ""
1048 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1049 "shell globs, redirections, etc will work."
1050 msgstr ""
1051
1052 # type: =head2
1053 #. type: =head2
1054 #: ../src/guestfs.pod:446
1055 msgid "CONFIGURATION FILES"
1056 msgstr ""
1057
1058 # type: textblock
1059 #. type: textblock
1060 #: ../src/guestfs.pod:448
1061 msgid ""
1062 "To read and write configuration files in Linux guest filesystems, we "
1063 "strongly recommend using Augeas.  For example, Augeas understands how to "
1064 "read and write, say, a Linux shadow password file or X.org configuration "
1065 "file, and so avoids you having to write that code."
1066 msgstr ""
1067
1068 # type: textblock
1069 #. type: textblock
1070 #: ../src/guestfs.pod:453
1071 msgid ""
1072 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1073 "document Augeas itself here because there is excellent documentation on the "
1074 "L<http://augeas.net/> website."
1075 msgstr ""
1076
1077 # type: textblock
1078 #. type: textblock
1079 #: ../src/guestfs.pod:457
1080 msgid ""
1081 "If you don't want to use Augeas (you fool!) then try calling L</"
1082 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1083 "over."
1084 msgstr ""
1085
1086 # type: =head2
1087 #. type: =head2
1088 #: ../src/guestfs.pod:461
1089 msgid "SELINUX"
1090 msgstr ""
1091
1092 # type: textblock
1093 #. type: textblock
1094 #: ../src/guestfs.pod:463
1095 msgid ""
1096 "We support SELinux guests.  To ensure that labeling happens correctly in "
1097 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1098 msgstr ""
1099
1100 # type: =item
1101 #. type: =item
1102 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1280 ../src/guestfs.pod:1411
1103 #: ../src/guestfs.pod:2440
1104 msgid "1."
1105 msgstr ""
1106
1107 # type: textblock
1108 #. type: textblock
1109 #: ../src/guestfs.pod:471
1110 msgid "Before launching, do:"
1111 msgstr ""
1112
1113 # type: verbatim
1114 #. type: verbatim
1115 #: ../src/guestfs.pod:473
1116 #, no-wrap
1117 msgid ""
1118 " guestfs_set_selinux (g, 1);\n"
1119 "\n"
1120 msgstr ""
1121
1122 # type: =item
1123 #. type: =item
1124 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1284 ../src/guestfs.pod:1415
1125 #: ../src/guestfs.pod:2465
1126 msgid "2."
1127 msgstr ""
1128
1129 # type: textblock
1130 #. type: textblock
1131 #: ../src/guestfs.pod:477
1132 msgid ""
1133 "After mounting the guest's filesystem(s), load the policy.  This is best "
1134 "done by running the L<load_policy(8)> command in the guest itself:"
1135 msgstr ""
1136
1137 # type: verbatim
1138 #. type: verbatim
1139 #: ../src/guestfs.pod:481
1140 #, no-wrap
1141 msgid ""
1142 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1143 "\n"
1144 msgstr ""
1145
1146 # type: textblock
1147 #. type: textblock
1148 #: ../src/guestfs.pod:483
1149 msgid ""
1150 "(Older versions of C<load_policy> require you to specify the name of the "
1151 "policy file)."
1152 msgstr ""
1153
1154 # type: =item
1155 #. type: =item
1156 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1421
1157 msgid "3."
1158 msgstr ""
1159
1160 # type: textblock
1161 #. type: textblock
1162 #: ../src/guestfs.pod:488
1163 msgid ""
1164 "Optionally, set the security context for the API.  The correct security "
1165 "context to use can only be known by inspecting the guest.  As an example:"
1166 msgstr ""
1167
1168 # type: verbatim
1169 #. type: verbatim
1170 #: ../src/guestfs.pod:492
1171 #, no-wrap
1172 msgid ""
1173 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1174 "\n"
1175 msgstr ""
1176
1177 # type: textblock
1178 #. type: textblock
1179 #: ../src/guestfs.pod:496
1180 msgid "This will work for running commands and editing existing files."
1181 msgstr ""
1182
1183 # type: textblock
1184 #. type: textblock
1185 #: ../src/guestfs.pod:498
1186 msgid ""
1187 "When new files are created, you may need to label them explicitly, for "
1188 "example by running the external command C<restorecon pathname>."
1189 msgstr ""
1190
1191 # type: =head2
1192 #. type: =head2
1193 #: ../src/guestfs.pod:502
1194 msgid "UMASK"
1195 msgstr ""
1196
1197 # type: textblock
1198 #. type: textblock
1199 #: ../src/guestfs.pod:504
1200 msgid ""
1201 "Certain calls are affected by the current file mode creation mask (the "
1202 "\"umask\").  In particular ones which create files or directories, such as "
1203 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1204 "either the default mode that the file is created with or modifies the mode "
1205 "that you supply."
1206 msgstr ""
1207
1208 # type: textblock
1209 #. type: textblock
1210 #: ../src/guestfs.pod:510
1211 msgid ""
1212 "The default umask is C<022>, so files are created with modes such as C<0644> "
1213 "and directories with C<0755>."
1214 msgstr ""
1215
1216 # type: textblock
1217 #. type: textblock
1218 #: ../src/guestfs.pod:513
1219 msgid ""
1220 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1221 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1222 "guestfs_chmod> after creating each file or directory."
1223 msgstr ""
1224
1225 # type: textblock
1226 #. type: textblock
1227 #: ../src/guestfs.pod:517
1228 msgid "For more information about umask, see L<umask(2)>."
1229 msgstr ""
1230
1231 # type: =head1
1232 #. type: =head1
1233 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:765
1234 msgid "ENCRYPTED DISKS"
1235 msgstr ""
1236
1237 # type: textblock
1238 #. type: textblock
1239 #: ../src/guestfs.pod:521
1240 msgid ""
1241 "Libguestfs allows you to access Linux guests which have been encrypted using "
1242 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1243 "standard.  This includes nearly all whole disk encryption systems used by "
1244 "modern Linux guests."
1245 msgstr ""
1246
1247 # type: textblock
1248 #. type: textblock
1249 #: ../src/guestfs.pod:527
1250 msgid ""
1251 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1252 "returns the string C<crypto_LUKS>)."
1253 msgstr ""
1254
1255 # type: textblock
1256 #. type: textblock
1257 #: ../src/guestfs.pod:530
1258 msgid ""
1259 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1260 "will require the passphrase!"
1261 msgstr ""
1262
1263 # type: textblock
1264 #. type: textblock
1265 #: ../src/guestfs.pod:533
1266 msgid ""
1267 "Opening a LUKS device creates a new device mapper device called C</dev/"
1268 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1269 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1270 "from and encrypted to the underlying block device respectively."
1271 msgstr ""
1272
1273 # type: textblock
1274 #. type: textblock
1275 #: ../src/guestfs.pod:539
1276 msgid ""
1277 "LVM volume groups on the device can be made visible by calling L</"
1278 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1279 "(s) can now be mounted in the usual way."
1280 msgstr ""
1281
1282 # type: textblock
1283 #. type: textblock
1284 #: ../src/guestfs.pod:543
1285 msgid ""
1286 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1287 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1288 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1289 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1290 "underlying encrypted block device)."
1291 msgstr ""
1292
1293 # type: =head2
1294 #. type: =head2
1295 #: ../src/guestfs.pod:550
1296 msgid "INSPECTION"
1297 msgstr ""
1298
1299 #. type: textblock
1300 #: ../src/guestfs.pod:552
1301 msgid ""
1302 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1303 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1304 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1305 "version 1.5.3 the most frequently used part of this library has been "
1306 "rewritten in C and moved into the core code)."
1307 msgstr ""
1308
1309 # type: textblock
1310 #. type: textblock
1311 #: ../src/guestfs.pod:559
1312 msgid ""
1313 "Add all disks belonging to the unknown virtual machine and call L</"
1314 "guestfs_launch> in the usual way."
1315 msgstr ""
1316
1317 # type: textblock
1318 #. type: textblock
1319 #: ../src/guestfs.pod:562
1320 msgid ""
1321 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1322 "and certain heuristics, and returns a list of operating systems that were "
1323 "found.  An empty list means none were found.  A single element is the root "
1324 "filesystem of the operating system.  For dual- or multi-boot guests, "
1325 "multiple roots can be returned, each one corresponding to a separate "
1326 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1327 "world of virtualization, but since this scenario can happen, we have built "
1328 "libguestfs to deal with it.)"
1329 msgstr ""
1330
1331 # type: textblock
1332 #. type: textblock
1333 #: ../src/guestfs.pod:571
1334 msgid ""
1335 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1336 "to get additional details about that operating system.  For example, call L</"
1337 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1338 "Windows and Linux-based operating systems respectively."
1339 msgstr ""
1340
1341 # type: textblock
1342 #. type: textblock
1343 #: ../src/guestfs.pod:577
1344 msgid ""
1345 "Un*x-like and Linux-based operating systems usually consist of several "
1346 "filesystems which are mounted at boot time (for example, a separate boot "
1347 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1348 "filesystems correspond to mount points.  Call "
1349 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1350 "hash table like this example:"
1351 msgstr ""
1352
1353 # type: verbatim
1354 #. type: verbatim
1355 #: ../src/guestfs.pod:584
1356 #, no-wrap
1357 msgid ""
1358 " /boot => /dev/sda1\n"
1359 " /     => /dev/vg_guest/lv_root\n"
1360 " /usr  => /dev/vg_guest/lv_usr\n"
1361 "\n"
1362 msgstr ""
1363
1364 # type: textblock
1365 #. type: textblock
1366 #: ../src/guestfs.pod:588
1367 msgid ""
1368 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1369 "filesystems as suggested."
1370 msgstr ""
1371
1372 # type: textblock
1373 #. type: textblock
1374 #: ../src/guestfs.pod:591
1375 msgid ""
1376 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1377 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1378 msgstr ""
1379
1380 # type: textblock
1381 #. type: textblock
1382 #: ../src/guestfs.pod:595
1383 msgid ""
1384 "Inspection currently only works for some common operating systems.  "
1385 "Contributors are welcome to send patches for other operating systems that we "
1386 "currently cannot detect."
1387 msgstr ""
1388
1389 # type: textblock
1390 #. type: textblock
1391 #: ../src/guestfs.pod:599
1392 msgid ""
1393 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1394 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1395 "encrypted devices."
1396 msgstr ""
1397
1398 # type: textblock
1399 #. type: textblock
1400 #: ../src/guestfs.pod:603
1401 msgid ""
1402 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1403 "inspection and caches the results in the guest handle.  Subsequent calls to "
1404 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1405 "read the disks.  If you change the content of the guest disks, you can redo "
1406 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1407 "guestfs_inspect_list_applications> works a little differently from the other "
1408 "calls and does read the disks.  See documentation for that function for "
1409 "details)."
1410 msgstr ""
1411
1412 #. type: =head3
1413 #: ../src/guestfs.pod:612
1414 msgid "INSPECTING INSTALL DISKS"
1415 msgstr ""
1416
1417 #. type: textblock
1418 #: ../src/guestfs.pod:614
1419 msgid ""
1420 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1421 "CDs and more."
1422 msgstr ""
1423
1424 #. type: textblock
1425 #: ../src/guestfs.pod:617
1426 msgid ""
1427 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1428 "system, which currently can be C<installed> (a regular operating system) or "
1429 "C<installer> (some sort of install disk)."
1430 msgstr ""
1431
1432 #. type: textblock
1433 #: ../src/guestfs.pod:621
1434 msgid ""
1435 "Further information is available about the operating system that can be "
1436 "installed using the regular inspection APIs like L</"
1437 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
1438 msgstr ""
1439
1440 #. type: textblock
1441 #: ../src/guestfs.pod:626
1442 msgid ""
1443 "Some additional information specific to installer disks is also available "
1444 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
1445 "guestfs_inspect_is_multipart> calls."
1446 msgstr ""
1447
1448 # type: =head2
1449 #. type: =head2
1450 #: ../src/guestfs.pod:631
1451 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1452 msgstr ""
1453
1454 # type: textblock
1455 #. type: textblock
1456 #: ../src/guestfs.pod:633
1457 msgid ""
1458 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1459 "ntfs-3g.org/> driver."
1460 msgstr ""
1461
1462 # type: =head3
1463 #. type: =head3
1464 #: ../src/guestfs.pod:636
1465 msgid "DRIVE LETTERS AND PATHS"
1466 msgstr ""
1467
1468 # type: textblock
1469 #. type: textblock
1470 #: ../src/guestfs.pod:638
1471 msgid ""
1472 "DOS and Windows still use drive letters, and the filesystems are always "
1473 "treated as case insensitive by Windows itself, and therefore you might find "
1474 "a Windows configuration file referring to a path like C<c:\\windows"
1475 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1476 "might be referred to as C</WINDOWS/System32>."
1477 msgstr ""
1478
1479 #. type: textblock
1480 #: ../src/guestfs.pod:644
1481 msgid ""
1482 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
1483 "L</guestfs_inspect_get_drive_mappings>)"
1484 msgstr ""
1485
1486 #. type: textblock
1487 #: ../src/guestfs.pod:647
1488 msgid ""
1489 "Dealing with separator characters (backslash vs forward slash) is outside "
1490 "the scope of libguestfs, but usually a simple character replacement will "
1491 "work."
1492 msgstr ""
1493
1494 #. type: textblock
1495 #: ../src/guestfs.pod:651
1496 msgid ""
1497 "To resolve the case insensitivity of paths, call L</"
1498 "guestfs_case_sensitive_path>."
1499 msgstr ""
1500
1501 # type: =head3
1502 #. type: =head3
1503 #: ../src/guestfs.pod:654
1504 msgid "ACCESSING THE WINDOWS REGISTRY"
1505 msgstr ""
1506
1507 # type: textblock
1508 #. type: textblock
1509 #: ../src/guestfs.pod:656
1510 msgid ""
1511 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1512 "files, through the library C<hivex> which is part of the libguestfs project "
1513 "although ships as a separate tarball.  You have to locate and download the "
1514 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1515 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1516 "reg(1)> for more help on this issue."
1517 msgstr ""
1518
1519 # type: =head3
1520 #. type: =head3
1521 #: ../src/guestfs.pod:664
1522 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1523 msgstr ""
1524
1525 # type: textblock
1526 #. type: textblock
1527 #: ../src/guestfs.pod:666
1528 msgid ""
1529 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1530 "provide something which looks like a Linux symlink.  The way it tries to do "
1531 "the rewriting is described here:"
1532 msgstr ""
1533
1534 # type: textblock
1535 #. type: textblock
1536 #: ../src/guestfs.pod:670
1537 msgid ""
1538 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1539 "symbolic-links/>"
1540 msgstr ""
1541
1542 # type: textblock
1543 #. type: textblock
1544 #: ../src/guestfs.pod:672
1545 msgid ""
1546 "The essential problem is that ntfs-3g simply does not have enough "
1547 "information to do a correct job.  NTFS links can contain drive letters and "
1548 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1549 "It is almost certainly the case that libguestfs callers should ignore what "
1550 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1551 msgstr ""
1552
1553 # type: textblock
1554 #. type: textblock
1555 #: ../src/guestfs.pod:679
1556 msgid ""
1557 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1558 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1559 "attribute, and read the raw reparse data from that (you can find the format "
1560 "documented in various places around the web)."
1561 msgstr ""
1562
1563 # type: =head3
1564 #. type: =head3
1565 #: ../src/guestfs.pod:684
1566 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1567 msgstr ""
1568
1569 # type: textblock
1570 #. type: textblock
1571 #: ../src/guestfs.pod:686
1572 msgid ""
1573 "There are other useful extended attributes that can be read from ntfs-3g "
1574 "filesystems (using L</guestfs_getxattr>).  See:"
1575 msgstr ""
1576
1577 # type: textblock
1578 #. type: textblock
1579 #: ../src/guestfs.pod:689
1580 msgid ""
1581 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1582 msgstr ""
1583
1584 # type: =head2
1585 #. type: =head2
1586 #: ../src/guestfs.pod:691
1587 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1588 msgstr ""
1589
1590 # type: textblock
1591 #. type: textblock
1592 #: ../src/guestfs.pod:693
1593 msgid ""
1594 "Although we don't want to discourage you from using the C API, we will "
1595 "mention here that the same API is also available in other languages."
1596 msgstr ""
1597
1598 #. type: textblock
1599 #: ../src/guestfs.pod:696
1600 msgid ""
1601 "The API is broadly identical in all supported languages.  This means that "
1602 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1603 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1604 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1605 "each language."
1606 msgstr ""
1607
1608 # type: textblock
1609 #. type: textblock
1610 #: ../src/guestfs.pod:702
1611 msgid ""
1612 "Error messages are automatically transformed into exceptions if the language "
1613 "supports it."
1614 msgstr ""
1615
1616 # type: textblock
1617 #. type: textblock
1618 #: ../src/guestfs.pod:705
1619 msgid ""
1620 "We don't try to \"object orientify\" parts of the API in OO languages, "
1621 "although contributors are welcome to write higher level APIs above what we "
1622 "provide in their favourite languages if they wish."
1623 msgstr ""
1624
1625 # type: =item
1626 #. type: =item
1627 #: ../src/guestfs.pod:711
1628 msgid "B<C++>"
1629 msgstr ""
1630
1631 # type: textblock
1632 #. type: textblock
1633 #: ../src/guestfs.pod:713
1634 msgid ""
1635 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1636 "identical to the C API.  C++ classes and exceptions are not used."
1637 msgstr ""
1638
1639 # type: =item
1640 #. type: =item
1641 #: ../src/guestfs.pod:717
1642 msgid "B<C#>"
1643 msgstr ""
1644
1645 # type: textblock
1646 #. type: textblock
1647 #: ../src/guestfs.pod:719
1648 msgid ""
1649 "The C# bindings are highly experimental.  Please read the warnings at the "
1650 "top of C<csharp/Libguestfs.cs>."
1651 msgstr ""
1652
1653 # type: =item
1654 #. type: =item
1655 #: ../src/guestfs.pod:722
1656 msgid "B<Haskell>"
1657 msgstr ""
1658
1659 # type: textblock
1660 #. type: textblock
1661 #: ../src/guestfs.pod:724
1662 msgid ""
1663 "This is the only language binding that is working but incomplete.  Only "
1664 "calls which return simple integers have been bound in Haskell, and we are "
1665 "looking for help to complete this binding."
1666 msgstr ""
1667
1668 # type: =item
1669 #. type: =item
1670 #: ../src/guestfs.pod:728
1671 msgid "B<Java>"
1672 msgstr ""
1673
1674 # type: textblock
1675 #. type: textblock
1676 #: ../src/guestfs.pod:730
1677 msgid ""
1678 "Full documentation is contained in the Javadoc which is distributed with "
1679 "libguestfs."
1680 msgstr ""
1681
1682 # type: =item
1683 #. type: =item
1684 #: ../src/guestfs.pod:733
1685 msgid "B<OCaml>"
1686 msgstr ""
1687
1688 #. type: textblock
1689 #: ../src/guestfs.pod:735
1690 msgid "See L<guestfs-ocaml(3)>."
1691 msgstr ""
1692
1693 # type: =item
1694 #. type: =item
1695 #: ../src/guestfs.pod:737
1696 msgid "B<Perl>"
1697 msgstr ""
1698
1699 #. type: textblock
1700 #: ../src/guestfs.pod:739
1701 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1702 msgstr ""
1703
1704 # type: =item
1705 #. type: =item
1706 #: ../src/guestfs.pod:741
1707 msgid "B<PHP>"
1708 msgstr ""
1709
1710 # type: textblock
1711 #. type: textblock
1712 #: ../src/guestfs.pod:743
1713 msgid ""
1714 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1715 "the php-libguestfs package for your distribution."
1716 msgstr ""
1717
1718 # type: textblock
1719 #. type: textblock
1720 #: ../src/guestfs.pod:746
1721 msgid "The PHP binding only works correctly on 64 bit machines."
1722 msgstr ""
1723
1724 # type: =item
1725 #. type: =item
1726 #: ../src/guestfs.pod:748
1727 msgid "B<Python>"
1728 msgstr ""
1729
1730 #. type: textblock
1731 #: ../src/guestfs.pod:750
1732 msgid "See L<guestfs-python(3)>."
1733 msgstr ""
1734
1735 # type: =item
1736 #. type: =item
1737 #: ../src/guestfs.pod:752
1738 msgid "B<Ruby>"
1739 msgstr ""
1740
1741 #. type: textblock
1742 #: ../src/guestfs.pod:754
1743 msgid "See L<guestfs-ruby(3)>."
1744 msgstr ""
1745
1746 # type: =item
1747 #. type: =item
1748 #: ../src/guestfs.pod:756
1749 msgid "B<shell scripts>"
1750 msgstr ""
1751
1752 #. type: textblock
1753 #: ../src/guestfs.pod:758
1754 msgid "See L<guestfish(1)>."
1755 msgstr ""
1756
1757 # type: =head2
1758 #. type: =head2
1759 #: ../src/guestfs.pod:762
1760 msgid "LIBGUESTFS GOTCHAS"
1761 msgstr ""
1762
1763 # type: textblock
1764 #. type: textblock
1765 #: ../src/guestfs.pod:764
1766 msgid ""
1767 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1768 "system [...] that works in the way it is documented but is counterintuitive "
1769 "and almost invites mistakes.\""
1770 msgstr ""
1771
1772 # type: textblock
1773 #. type: textblock
1774 #: ../src/guestfs.pod:768
1775 msgid ""
1776 "Since we developed libguestfs and the associated tools, there are several "
1777 "things we would have designed differently, but are now stuck with for "
1778 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1779 "release, you can expect these to change.  Beware of them."
1780 msgstr ""
1781
1782 # type: =item
1783 #. type: =item
1784 #: ../src/guestfs.pod:776
1785 msgid "Autosync / forgetting to sync."
1786 msgstr ""
1787
1788 # type: textblock
1789 #. type: textblock
1790 #: ../src/guestfs.pod:778
1791 msgid ""
1792 "When modifying a filesystem from C or another language, you B<must> unmount "
1793 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1794 "libguestfs handle.  You can also call:"
1795 msgstr ""
1796
1797 # type: verbatim
1798 #. type: verbatim
1799 #: ../src/guestfs.pod:782
1800 #, no-wrap
1801 msgid ""
1802 " guestfs_set_autosync (g, 1);\n"
1803 "\n"
1804 msgstr ""
1805
1806 # type: textblock
1807 #. type: textblock
1808 #: ../src/guestfs.pod:784
1809 msgid ""
1810 "to have the unmount/sync done automatically for you when the handle 'g' is "
1811 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1812 msgstr ""
1813
1814 # type: textblock
1815 #. type: textblock
1816 #: ../src/guestfs.pod:788
1817 msgid ""
1818 "If you forget to do this, then it is entirely possible that your changes "
1819 "won't be written out, or will be partially written, or (very rarely) that "
1820 "you'll get disk corruption."
1821 msgstr ""
1822
1823 # type: textblock
1824 #. type: textblock
1825 #: ../src/guestfs.pod:792
1826 msgid ""
1827 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1828 "guestfish scripts that forget to sync will work just fine, which can make "
1829 "this very puzzling if you are trying to debug a problem."
1830 msgstr ""
1831
1832 # type: textblock
1833 #. type: textblock
1834 #: ../src/guestfs.pod:796
1835 msgid ""
1836 "Update: Autosync is enabled by default for all API users starting from "
1837 "libguestfs 1.5.24."
1838 msgstr ""
1839
1840 # type: =item
1841 #. type: =item
1842 #: ../src/guestfs.pod:799
1843 msgid "Mount option C<-o sync> should not be the default."
1844 msgstr ""
1845
1846 # type: textblock
1847 #. type: textblock
1848 #: ../src/guestfs.pod:801
1849 msgid ""
1850 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1851 "However C<-o sync> does not add any reliability benefit, but does have a "
1852 "very large performance impact."
1853 msgstr ""
1854
1855 # type: textblock
1856 #. type: textblock
1857 #: ../src/guestfs.pod:805
1858 msgid ""
1859 "The work around is to use L</guestfs_mount_options> and set the mount "
1860 "options that you actually want to use."
1861 msgstr ""
1862
1863 # type: =item
1864 #. type: =item
1865 #: ../src/guestfs.pod:808
1866 msgid "Read-only should be the default."
1867 msgstr ""
1868
1869 # type: textblock
1870 #. type: textblock
1871 #: ../src/guestfs.pod:810
1872 msgid ""
1873 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1874 "specify I<--rw> if you want to make changes to the image."
1875 msgstr ""
1876
1877 # type: textblock
1878 #. type: textblock
1879 #: ../src/guestfs.pod:813
1880 msgid "This would reduce the potential to corrupt live VM images."
1881 msgstr ""
1882
1883 # type: textblock
1884 #. type: textblock
1885 #: ../src/guestfs.pod:815
1886 msgid ""
1887 "Note that many filesystems change the disk when you just mount and unmount, "
1888 "even if you didn't perform any writes.  You need to use L</"
1889 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1890 msgstr ""
1891
1892 # type: =item
1893 #. type: =item
1894 #: ../src/guestfs.pod:819
1895 msgid "guestfish command line is hard to use."
1896 msgstr ""
1897
1898 # type: textblock
1899 #. type: textblock
1900 #: ../src/guestfs.pod:821
1901 msgid ""
1902 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1903 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1904 "exist, so it fails.  In earlier versions of guestfish the error message was "
1905 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1906 "we should have used C<guestfish -c command> to run commands."
1907 msgstr ""
1908
1909 # type: =item
1910 #. type: =item
1911 #: ../src/guestfs.pod:828
1912 msgid "guestfish megabyte modifiers don't work right on all commands"
1913 msgstr ""
1914
1915 # type: textblock
1916 #. type: textblock
1917 #: ../src/guestfs.pod:830
1918 msgid ""
1919 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1920 "other modifiers).  What guestfish actually does is to multiply the number "
1921 "part by the modifier part and pass the result to the C API.  However this "
1922 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1923 "expecting some other unit (eg. megabytes)."
1924 msgstr ""
1925
1926 # type: textblock
1927 #. type: textblock
1928 #: ../src/guestfs.pod:837
1929 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1930 msgstr ""
1931
1932 # type: verbatim
1933 #. type: verbatim
1934 #: ../src/guestfs.pod:839
1935 #, no-wrap
1936 msgid ""
1937 " lvcreate LV VG 100M\n"
1938 "\n"
1939 msgstr ""
1940
1941 # type: textblock
1942 #. type: textblock
1943 #: ../src/guestfs.pod:841
1944 msgid ""
1945 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1946 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1947 "megabytes * megabytes) logical volume.  The error message you get from this "
1948 "is also a little obscure."
1949 msgstr ""
1950
1951 # type: textblock
1952 #. type: textblock
1953 #: ../src/guestfs.pod:846
1954 msgid ""
1955 "This could be fixed in the generator by specially marking parameters and "
1956 "return values which take bytes or other units."
1957 msgstr ""
1958
1959 # type: =item
1960 #. type: =item
1961 #: ../src/guestfs.pod:849
1962 msgid "Ambiguity between devices and paths"
1963 msgstr ""
1964
1965 # type: textblock
1966 #. type: textblock
1967 #: ../src/guestfs.pod:851
1968 msgid ""
1969 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1970 "sdb2>) and a similar pathname.  A file might just happen to be called "
1971 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1972 msgstr ""
1973
1974 # type: textblock
1975 #. type: textblock
1976 #: ../src/guestfs.pod:856
1977 msgid ""
1978 "In the current API we usually resolve this ambiguity by having two separate "
1979 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1980 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1981 "detecting if the path supplied begins with C</dev/>."
1982 msgstr ""
1983
1984 # type: textblock
1985 #. type: textblock
1986 #: ../src/guestfs.pod:862
1987 msgid ""
1988 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1989 "make paths/devices into structured names.  One way to do this would be to "
1990 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1991 "aspect of grub.  Another way would be to use a structured type, equivalent "
1992 "to this OCaml type:"
1993 msgstr ""
1994
1995 # type: verbatim
1996 #. type: verbatim
1997 #: ../src/guestfs.pod:868
1998 #, no-wrap
1999 msgid ""
2000 " type path = Path of string | Device of int | Partition of int * int\n"
2001 "\n"
2002 msgstr ""
2003
2004 # type: textblock
2005 #. type: textblock
2006 #: ../src/guestfs.pod:870
2007 msgid "which would allow you to pass arguments like:"
2008 msgstr ""
2009
2010 # type: verbatim
2011 #. type: verbatim
2012 #: ../src/guestfs.pod:872
2013 #, no-wrap
2014 msgid ""
2015 " Path \"/foo/bar\"\n"
2016 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
2017 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
2018 " Path \"/dev/sdb2\"    (* not a device *)\n"
2019 "\n"
2020 msgstr ""
2021
2022 # type: textblock
2023 #. type: textblock
2024 #: ../src/guestfs.pod:877
2025 msgid ""
2026 "As you can see there are still problems to resolve even with this "
2027 "representation.  Also consider how it might work in guestfish."
2028 msgstr ""
2029
2030 # type: =head2
2031 #. type: =head2
2032 #: ../src/guestfs.pod:882
2033 msgid "PROTOCOL LIMITS"
2034 msgstr ""
2035
2036 # type: textblock
2037 #. type: textblock
2038 #: ../src/guestfs.pod:884
2039 msgid ""
2040 "Internally libguestfs uses a message-based protocol to pass API calls and "
2041 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
2042 "plenty more detail about this).  The maximum message size used by the "
2043 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
2044 "aware of this limit.  The API calls which may be affected are individually "
2045 "documented, with a link back to this section of the documentation."
2046 msgstr ""
2047
2048 # type: textblock
2049 #. type: textblock
2050 #: ../src/guestfs.pod:892
2051 msgid ""
2052 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
2053 "a simple string.  Because this string is at some point internally encoded as "
2054 "a message, the maximum size that it can return is slightly under 4 MB.  If "
2055 "the requested file is larger than this then you will get an error."
2056 msgstr ""
2057
2058 # type: textblock
2059 #. type: textblock
2060 #: ../src/guestfs.pod:898
2061 msgid ""
2062 "In order to transfer large files into and out of the guest filesystem, you "
2063 "need to use particular calls that support this.  The sections L</UPLOADING> "
2064 "and L</DOWNLOADING> document how to do this."
2065 msgstr ""
2066
2067 # type: textblock
2068 #. type: textblock
2069 #: ../src/guestfs.pod:902
2070 msgid ""
2071 "You might also consider mounting the disk image using our FUSE filesystem "
2072 "support (L<guestmount(1)>)."
2073 msgstr ""
2074
2075 # type: =head2
2076 #. type: =head2
2077 #: ../src/guestfs.pod:905
2078 msgid "KEYS AND PASSPHRASES"
2079 msgstr ""
2080
2081 # type: textblock
2082 #. type: textblock
2083 #: ../src/guestfs.pod:907
2084 msgid ""
2085 "Certain libguestfs calls take a parameter that contains sensitive key "
2086 "material, passed in as a C string."
2087 msgstr ""
2088
2089 # type: textblock
2090 #. type: textblock
2091 #: ../src/guestfs.pod:910
2092 msgid ""
2093 "In the future we would hope to change the libguestfs implementation so that "
2094 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2095 "swap.  However this is I<not> done at the moment, because of the complexity "
2096 "of such an implementation."
2097 msgstr ""
2098
2099 # type: textblock
2100 #. type: textblock
2101 #: ../src/guestfs.pod:915
2102 msgid ""
2103 "Therefore you should be aware that any key parameter you pass to libguestfs "
2104 "might end up being written out to the swap partition.  If this is a concern, "
2105 "scrub the swap partition or don't use libguestfs on encrypted devices."
2106 msgstr ""
2107
2108 # type: =head1
2109 #. type: =head2
2110 #: ../src/guestfs.pod:920
2111 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2112 msgstr ""
2113
2114 # type: textblock
2115 #. type: textblock
2116 #: ../src/guestfs.pod:922
2117 msgid ""
2118 "All high-level libguestfs actions are synchronous.  If you want to use "
2119 "libguestfs asynchronously then you must create a thread."
2120 msgstr ""
2121
2122 # type: textblock
2123 #. type: textblock
2124 #: ../src/guestfs.pod:925
2125 msgid ""
2126 "Only use the handle from a single thread.  Either use the handle exclusively "
2127 "from one thread, or provide your own mutex so that two threads cannot issue "
2128 "calls on the same handle at the same time."
2129 msgstr ""
2130
2131 # type: textblock
2132 #. type: textblock
2133 #: ../src/guestfs.pod:929
2134 msgid ""
2135 "See the graphical program guestfs-browser for one possible architecture for "
2136 "multithreaded programs using libvirt and libguestfs."
2137 msgstr ""
2138
2139 # type: =head1
2140 #. type: =head2
2141 #: ../src/guestfs.pod:932
2142 msgid "PATH"
2143 msgstr ""
2144
2145 #. type: textblock
2146 #: ../src/guestfs.pod:934
2147 msgid ""
2148 "Libguestfs needs a supermin appliance, which it finds by looking along an "
2149 "internal path."
2150 msgstr ""
2151
2152 # type: textblock
2153 #. type: textblock
2154 #: ../src/guestfs.pod:937
2155 msgid ""
2156 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2157 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2158 msgstr ""
2159
2160 # type: textblock
2161 #. type: textblock
2162 #: ../src/guestfs.pod:940
2163 msgid ""
2164 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2165 "to change the directories that libguestfs will search in.  The value is a "
2166 "colon-separated list of paths.  The current directory is I<not> searched "
2167 "unless the path contains an empty element or C<.>.  For example "
2168 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2169 "then C</usr/lib/guestfs>."
2170 msgstr ""
2171
2172 # type: =head1
2173 #. type: =head2
2174 #: ../src/guestfs.pod:947
2175 msgid "QEMU WRAPPERS"
2176 msgstr ""
2177
2178 # type: textblock
2179 #. type: textblock
2180 #: ../src/guestfs.pod:949
2181 msgid ""
2182 "If you want to compile your own qemu, run qemu from a non-standard location, "
2183 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2184 "around qemu."
2185 msgstr ""
2186
2187 # type: textblock
2188 #. type: textblock
2189 #: ../src/guestfs.pod:953
2190 msgid ""
2191 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2192 "last command in the shell script (so that qemu replaces the shell and "
2193 "becomes the direct child of the libguestfs-using program).  If you don't do "
2194 "this, then the qemu process won't be cleaned up correctly."
2195 msgstr ""
2196
2197 # type: textblock
2198 #. type: textblock
2199 #: ../src/guestfs.pod:958
2200 msgid ""
2201 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2202 "source:"
2203 msgstr ""
2204
2205 # type: verbatim
2206 #. type: verbatim
2207 #: ../src/guestfs.pod:961
2208 #, no-wrap
2209 msgid ""
2210 " #!/bin/sh -\n"
2211 " qemudir=/home/rjones/d/qemu\n"
2212 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2213 "\n"
2214 msgstr ""
2215
2216 # type: textblock
2217 #. type: textblock
2218 #: ../src/guestfs.pod:965
2219 msgid ""
2220 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2221 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2222 "example:"
2223 msgstr ""
2224
2225 # type: verbatim
2226 #. type: verbatim
2227 #: ../src/guestfs.pod:969
2228 #, no-wrap
2229 msgid ""
2230 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2231 "\n"
2232 msgstr ""
2233
2234 # type: textblock
2235 #. type: textblock
2236 #: ../src/guestfs.pod:971
2237 msgid ""
2238 "Note that libguestfs also calls qemu with the -help and -version options in "
2239 "order to determine features."
2240 msgstr ""
2241
2242 #. type: =head2
2243 #: ../src/guestfs.pod:974
2244 msgid "ATTACHING TO RUNNING DAEMONS"
2245 msgstr ""
2246
2247 #. type: textblock
2248 #: ../src/guestfs.pod:976
2249 msgid ""
2250 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
2251 "babies.  Use with caution."
2252 msgstr ""
2253
2254 #. type: textblock
2255 #: ../src/guestfs.pod:979
2256 msgid ""
2257 "I<Note (2):> This section explains how to attach to a running daemon from a "
2258 "low level perspective.  For most users, simply using virt tools such as "
2259 "L<guestfish(1)> with the I<--live> option will \"just work\"."
2260 msgstr ""
2261
2262 #. type: =head3
2263 #: ../src/guestfs.pod:983
2264 msgid "Using guestfs_set_attach_method"
2265 msgstr ""
2266
2267 #. type: textblock
2268 #: ../src/guestfs.pod:985
2269 msgid ""
2270 "By calling L</guestfs_set_attach_method> you can change how the library "
2271 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
2272 "ARCHITECTURE> for some background)."
2273 msgstr ""
2274
2275 #. type: textblock
2276 #: ../src/guestfs.pod:989
2277 msgid ""
2278 "The normal attach method is C<appliance>, where a small appliance is created "
2279 "containing the daemon, and then the library connects to this."
2280 msgstr ""
2281
2282 #. type: textblock
2283 #: ../src/guestfs.pod:992
2284 msgid ""
2285 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
2286 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
2287 "daemon over the Unix domain socket."
2288 msgstr ""
2289
2290 #. type: textblock
2291 #: ../src/guestfs.pod:996
2292 msgid ""
2293 "The normal use for this is to connect to a running virtual machine that "
2294 "contains a C<guestfsd> daemon, and send commands so you can read and write "
2295 "files inside the live virtual machine."
2296 msgstr ""
2297
2298 #. type: =head3
2299 #: ../src/guestfs.pod:1000
2300 msgid "Using guestfs_add_domain with live flag"
2301 msgstr ""
2302
2303 #. type: textblock
2304 #: ../src/guestfs.pod:1002
2305 msgid ""
2306 "L</guestfs_add_domain> provides some help for getting the correct attach "
2307 "method.  If you pass the C<live> option to this function, then (if the "
2308 "virtual machine is running) it will examine the libvirt XML looking for a "
2309 "virtio-serial channel to connect to:"
2310 msgstr ""
2311
2312 #. type: verbatim
2313 #: ../src/guestfs.pod:1008
2314 #, no-wrap
2315 msgid ""
2316 " <domain>\n"
2317 "   ...\n"
2318 "   <devices>\n"
2319 "     ...\n"
2320 "     <channel type='unix'>\n"
2321 "       <source mode='bind' path='/path/to/socket'/>\n"
2322 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
2323 "     </channel>\n"
2324 "     ...\n"
2325 "   </devices>\n"
2326 " </domain>\n"
2327 "\n"
2328 msgstr ""
2329
2330 #. type: textblock
2331 #: ../src/guestfs.pod:1020
2332 msgid ""
2333 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2334 "method to C<unix:/path/to/socket>."
2335 msgstr ""
2336
2337 #. type: textblock
2338 #: ../src/guestfs.pod:1023
2339 msgid ""
2340 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2341 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2342 "to attach to and modify live virtual machines."
2343 msgstr ""
2344
2345 #. type: textblock
2346 #: ../src/guestfs.pod:1027
2347 msgid ""
2348 "The virtual machine needs to have been set up beforehand so that it has the "
2349 "virtio-serial channel and so that guestfsd is running inside it."
2350 msgstr ""
2351
2352 # type: =head2
2353 #. type: =head2
2354 #: ../src/guestfs.pod:1031
2355 msgid "ABI GUARANTEE"
2356 msgstr ""
2357
2358 # type: textblock
2359 #. type: textblock
2360 #: ../src/guestfs.pod:1033
2361 msgid ""
2362 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2363 "actions as outlined in this section.  Although we will deprecate some "
2364 "actions, for example if they get replaced by newer calls, we will keep the "
2365 "old actions forever.  This allows you the developer to program in confidence "
2366 "against the libguestfs API."
2367 msgstr ""
2368
2369 # type: =head1
2370 #. type: =head2
2371 #: ../src/guestfs.pod:1039
2372 msgid "BLOCK DEVICE NAMING"
2373 msgstr ""
2374
2375 # type: textblock
2376 #. type: textblock
2377 #: ../src/guestfs.pod:1041
2378 msgid ""
2379 "In the kernel there is now quite a profusion of schemata for naming block "
2380 "devices (in this context, by I<block device> I mean a physical or virtual "
2381 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2382 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2383 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2384 "for the old IDE driver (particularly for SATA devices) those devices also "
2385 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2386 "paravirtualized drivers.  This has created several different naming systems, "
2387 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2388 msgstr ""
2389
2390 # type: textblock
2391 #. type: textblock
2392 #: ../src/guestfs.pod:1053
2393 msgid ""
2394 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2395 "Linux kernel to access block devices.  We can run a variety of appliances "
2396 "based on a variety of Linux kernels."
2397 msgstr ""
2398
2399 # type: textblock
2400 #. type: textblock
2401 #: ../src/guestfs.pod:1057
2402 msgid ""
2403 "This causes a problem for libguestfs because many API calls use device or "
2404 "partition names.  Working scripts and the recipe (example) scripts that we "
2405 "make available over the internet could fail if the naming scheme changes."
2406 msgstr ""
2407
2408 # type: textblock
2409 #. type: textblock
2410 #: ../src/guestfs.pod:1062
2411 msgid ""
2412 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2413 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2414 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2415 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2416 msgstr ""
2417
2418 # type: textblock
2419 #. type: textblock
2420 #: ../src/guestfs.pod:1068
2421 msgid ""
2422 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2423 "L</guestfs_list_partitions> and similar calls return the true names of the "
2424 "devices and partitions as known to the appliance."
2425 msgstr ""
2426
2427 # type: =head2
2428 #. type: =head3
2429 #: ../src/guestfs.pod:1073
2430 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2431 msgstr ""
2432
2433 # type: textblock
2434 #. type: textblock
2435 #: ../src/guestfs.pod:1075
2436 msgid ""
2437 "Usually this translation is transparent.  However in some (very rare)  cases "
2438 "you may need to know the exact algorithm.  Such cases include where you use "
2439 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2440 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2441 msgstr ""
2442
2443 # type: textblock
2444 #. type: textblock
2445 #: ../src/guestfs.pod:1081
2446 msgid ""
2447 "The algorithm is applied only to I<parameters> which are known to be either "
2448 "device or partition names.  Return values from functions such as L</"
2449 "guestfs_list_devices> are never changed."
2450 msgstr ""
2451
2452 # type: textblock
2453 #. type: textblock
2454 #: ../src/guestfs.pod:1089
2455 msgid "Is the string a parameter which is a device or partition name?"
2456 msgstr ""
2457
2458 # type: textblock
2459 #. type: textblock
2460 #: ../src/guestfs.pod:1093
2461 msgid "Does the string begin with C</dev/sd>?"
2462 msgstr ""
2463
2464 # type: textblock
2465 #. type: textblock
2466 #: ../src/guestfs.pod:1097
2467 msgid ""
2468 "Does the named device exist? If so, we use that device.  However if I<not> "
2469 "then we continue with this algorithm."
2470 msgstr ""
2471
2472 # type: textblock
2473 #. type: textblock
2474 #: ../src/guestfs.pod:1102
2475 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2476 msgstr ""
2477
2478 # type: textblock
2479 #. type: textblock
2480 #: ../src/guestfs.pod:1104
2481 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2482 msgstr ""
2483
2484 # type: textblock
2485 #. type: textblock
2486 #: ../src/guestfs.pod:1106
2487 msgid "If that named device exists, use it.  If not, continue."
2488 msgstr ""
2489
2490 # type: textblock
2491 #. type: textblock
2492 #: ../src/guestfs.pod:1110
2493 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2494 msgstr ""
2495
2496 # type: textblock
2497 #. type: textblock
2498 #: ../src/guestfs.pod:1112
2499 msgid "If that named device exists, use it.  If not, return an error."
2500 msgstr ""
2501
2502 # type: =head3
2503 #. type: =head3
2504 #: ../src/guestfs.pod:1116
2505 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2506 msgstr ""
2507
2508 # type: textblock
2509 #. type: textblock
2510 #: ../src/guestfs.pod:1118
2511 msgid ""
2512 "Although the standard naming scheme and automatic translation is useful for "
2513 "simple programs and guestfish scripts, for larger programs it is best not to "
2514 "rely on this mechanism."
2515 msgstr ""
2516
2517 # type: textblock
2518 #. type: textblock
2519 #: ../src/guestfs.pod:1122
2520 msgid ""
2521 "Where possible for maximum future portability programs using libguestfs "
2522 "should use these future-proof techniques:"
2523 msgstr ""
2524
2525 # type: textblock
2526 #. type: textblock
2527 #: ../src/guestfs.pod:1129
2528 msgid ""
2529 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2530 "device names, and then use those names directly."
2531 msgstr ""
2532
2533 # type: textblock
2534 #. type: textblock
2535 #: ../src/guestfs.pod:1132
2536 msgid ""
2537 "Since those device names exist by definition, they will never be translated."
2538 msgstr ""
2539
2540 # type: textblock
2541 #. type: textblock
2542 #: ../src/guestfs.pod:1137
2543 msgid ""
2544 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2545 "filesystem labels."
2546 msgstr ""
2547
2548 # type: =head1
2549 #. type: =head1
2550 #: ../src/guestfs.pod:1142
2551 msgid "SECURITY"
2552 msgstr ""
2553
2554 # type: textblock
2555 #. type: textblock
2556 #: ../src/guestfs.pod:1144
2557 msgid ""
2558 "This section discusses security implications of using libguestfs, "
2559 "particularly with untrusted or malicious guests or disk images."
2560 msgstr ""
2561
2562 # type: =head2
2563 #. type: =head2
2564 #: ../src/guestfs.pod:1147
2565 msgid "GENERAL SECURITY CONSIDERATIONS"
2566 msgstr ""
2567
2568 # type: textblock
2569 #. type: textblock
2570 #: ../src/guestfs.pod:1149
2571 msgid ""
2572 "Be careful with any files or data that you download from a guest (by "
2573 "\"download\" we mean not just the L</guestfs_download> command but any "
2574 "command that reads files, filenames, directories or anything else from a "
2575 "disk image).  An attacker could manipulate the data to fool your program "
2576 "into doing the wrong thing.  Consider cases such as:"
2577 msgstr ""
2578
2579 # type: textblock
2580 #. type: textblock
2581 #: ../src/guestfs.pod:1159
2582 msgid "the data (file etc) not being present"
2583 msgstr ""
2584
2585 # type: textblock
2586 #. type: textblock
2587 #: ../src/guestfs.pod:1163
2588 msgid "being present but empty"
2589 msgstr ""
2590
2591 # type: textblock
2592 #. type: textblock
2593 #: ../src/guestfs.pod:1167
2594 msgid "being much larger than normal"
2595 msgstr ""
2596
2597 # type: textblock
2598 #. type: textblock
2599 #: ../src/guestfs.pod:1171
2600 msgid "containing arbitrary 8 bit data"
2601 msgstr ""
2602
2603 # type: textblock
2604 #. type: textblock
2605 #: ../src/guestfs.pod:1175
2606 msgid "being in an unexpected character encoding"
2607 msgstr ""
2608
2609 # type: textblock
2610 #. type: textblock
2611 #: ../src/guestfs.pod:1179
2612 msgid "containing homoglyphs."
2613 msgstr ""
2614
2615 # type: =head2
2616 #. type: =head2
2617 #: ../src/guestfs.pod:1183
2618 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2619 msgstr ""
2620
2621 # type: textblock
2622 #. type: textblock
2623 #: ../src/guestfs.pod:1185
2624 msgid ""
2625 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2626 "(VFS) module can sometimes be escalated into exploits by deliberately "
2627 "creating a malicious, malformed filesystem.  These exploits are very severe "
2628 "for two reasons.  Firstly there are very many filesystem drivers in the "
2629 "kernel, and many of them are infrequently used and not much developer "
2630 "attention has been paid to the code.  Linux userspace helps potential "
2631 "crackers by detecting the filesystem type and automatically choosing the "
2632 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2633 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2634 "exploit (worse in some ways), giving immediate and total access to the "
2635 "system right down to the hardware level."
2636 msgstr ""
2637
2638 # type: textblock
2639 #. type: textblock
2640 #: ../src/guestfs.pod:1198
2641 msgid ""
2642 "That explains why you should never mount a filesystem from an untrusted "
2643 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2644 "inside a qemu virtual machine, usually running as a non-root user.  The "
2645 "attacker would need to write a filesystem which first exploited the kernel, "
2646 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2647 "the libguestfs protocol, and finally to be as serious as the host kernel "
2648 "exploit it would need to escalate its privileges to root.  This multi-step "
2649 "escalation, performed by a static piece of data, is thought to be extremely "
2650 "hard to do, although we never say 'never' about security issues."
2651 msgstr ""
2652
2653 # type: textblock
2654 #. type: textblock
2655 #: ../src/guestfs.pod:1209
2656 msgid ""
2657 "In any case callers can reduce the attack surface by forcing the filesystem "
2658 "type when mounting (use L</guestfs_mount_vfs>)."
2659 msgstr ""
2660
2661 # type: =head2
2662 #. type: =head2
2663 #: ../src/guestfs.pod:1212
2664 msgid "PROTOCOL SECURITY"
2665 msgstr ""
2666
2667 # type: textblock
2668 #. type: textblock
2669 #: ../src/guestfs.pod:1214
2670 msgid ""
2671 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2672 "defined upper message size.  However a program that uses libguestfs must "
2673 "also take care - for example you can write a program that downloads a binary "
2674 "from a disk image and executes it locally, and no amount of protocol "
2675 "security will save you from the consequences."
2676 msgstr ""
2677
2678 # type: =head2
2679 #. type: =head2
2680 #: ../src/guestfs.pod:1220
2681 msgid "INSPECTION SECURITY"
2682 msgstr ""
2683
2684 # type: textblock
2685 #. type: textblock
2686 #: ../src/guestfs.pod:1222
2687 msgid ""
2688 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2689 "directly from the guest, and these could contain any 8 bit data.  Callers "
2690 "should be careful to escape these before printing them to a structured file "
2691 "(for example, use HTML escaping if creating a web page)."
2692 msgstr ""
2693
2694 # type: textblock
2695 #. type: textblock
2696 #: ../src/guestfs.pod:1228
2697 msgid ""
2698 "Guest configuration may be altered in unusual ways by the administrator of "
2699 "the virtual machine, and may not reflect reality (particularly for untrusted "
2700 "or actively malicious guests).  For example we parse the hostname from "
2701 "configuration files like C</etc/sysconfig/network> that we find in the "
2702 "guest, but the guest administrator can easily manipulate these files to "
2703 "provide the wrong hostname."
2704 msgstr ""
2705
2706 # type: textblock
2707 #. type: textblock
2708 #: ../src/guestfs.pod:1236
2709 msgid ""
2710 "The inspection API parses guest configuration using two external libraries: "
2711 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2712 "designed to be robust in the face of malicious data, although denial of "
2713 "service attacks are still possible, for example with oversized configuration "
2714 "files."
2715 msgstr ""
2716
2717 # type: =head2
2718 #. type: =head2
2719 #: ../src/guestfs.pod:1242
2720 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2721 msgstr ""
2722
2723 # type: textblock
2724 #. type: textblock
2725 #: ../src/guestfs.pod:1244
2726 msgid ""
2727 "Be very cautious about running commands from the guest.  By running a "
2728 "command in the guest, you are giving CPU time to a binary that you do not "
2729 "control, under the same user account as the library, albeit wrapped in qemu "
2730 "virtualization.  More information and alternatives can be found in the "
2731 "section L</RUNNING COMMANDS>."
2732 msgstr ""
2733
2734 # type: =head2
2735 #. type: =head2
2736 #: ../src/guestfs.pod:1250
2737 msgid "CVE-2010-3851"
2738 msgstr ""
2739
2740 # type: textblock
2741 #. type: textblock
2742 #: ../src/guestfs.pod:1252
2743 msgid "https://bugzilla.redhat.com/642934"
2744 msgstr ""
2745
2746 # type: textblock
2747 #. type: textblock
2748 #: ../src/guestfs.pod:1254
2749 msgid ""
2750 "This security bug concerns the automatic disk format detection that qemu "
2751 "does on disk images."
2752 msgstr ""
2753
2754 # type: textblock
2755 #. type: textblock
2756 #: ../src/guestfs.pod:1257
2757 msgid ""
2758 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2759 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2760 "for one of the known headers, and if none is found then assuming the disk "
2761 "image must be raw."
2762 msgstr ""
2763
2764 # type: textblock
2765 #. type: textblock
2766 #: ../src/guestfs.pod:1262
2767 msgid ""
2768 "This allows a guest which has been given a raw disk image to write some "
2769 "other header.  At next boot (or when the disk image is accessed by "
2770 "libguestfs) qemu would do autodetection and think the disk image format was, "
2771 "say, qcow2 based on the header written by the guest."
2772 msgstr ""
2773
2774 # type: textblock
2775 #. type: textblock
2776 #: ../src/guestfs.pod:1267
2777 msgid ""
2778 "This in itself would not be a problem, but qcow2 offers many features, one "
2779 "of which is to allow a disk image to refer to another image (called the "
2780 "\"backing disk\").  It does this by placing the path to the backing disk "
2781 "into the qcow2 header.  This path is not validated and could point to any "
2782 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2783 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2784 "control of the attacker."
2785 msgstr ""
2786
2787 # type: textblock
2788 #. type: textblock
2789 #: ../src/guestfs.pod:1275
2790 msgid ""
2791 "In libguestfs this is rather hard to exploit except under two circumstances:"
2792 msgstr ""
2793
2794 # type: textblock
2795 #. type: textblock
2796 #: ../src/guestfs.pod:1282
2797 msgid "You have enabled the network or have opened the disk in write mode."
2798 msgstr ""
2799
2800 # type: textblock
2801 #. type: textblock
2802 #: ../src/guestfs.pod:1286
2803 msgid ""
2804 "You are also running untrusted code from the guest (see L</RUNNING "
2805 "COMMANDS>)."
2806 msgstr ""
2807
2808 # type: textblock
2809 #. type: textblock
2810 #: ../src/guestfs.pod:1291
2811 msgid ""
2812 "The way to avoid this is to specify the expected disk format when adding "
2813 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2814 "should always do this if the disk is raw format, and it's a good idea for "
2815 "other cases too."
2816 msgstr ""
2817
2818 # type: textblock
2819 #. type: textblock
2820 #: ../src/guestfs.pod:1296
2821 msgid ""
2822 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2823 "format is fetched from libvirt and passed through."
2824 msgstr ""
2825
2826 # type: textblock
2827 #. type: textblock
2828 #: ../src/guestfs.pod:1299
2829 msgid ""
2830 "For libguestfs tools, use the I<--format> command line parameter as "
2831 "appropriate."
2832 msgstr ""
2833
2834 # type: =head1
2835 #. type: =head1
2836 #: ../src/guestfs.pod:1302
2837 msgid "CONNECTION MANAGEMENT"
2838 msgstr ""
2839
2840 # type: =head2
2841 #. type: =head2
2842 #: ../src/guestfs.pod:1304
2843 msgid "guestfs_h *"
2844 msgstr ""
2845
2846 # type: textblock
2847 #. type: textblock
2848 #: ../src/guestfs.pod:1306
2849 msgid ""
2850 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2851 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2852 "handle and release all resources used."
2853 msgstr ""
2854
2855 # type: textblock
2856 #. type: textblock
2857 #: ../src/guestfs.pod:1310
2858 msgid ""
2859 "For information on using multiple handles and threads, see the section L</"
2860 "MULTIPLE HANDLES AND MULTIPLE THREADS> below."
2861 msgstr ""
2862
2863 # type: =head2
2864 #. type: =head2
2865 #: ../src/guestfs.pod:1313
2866 msgid "guestfs_create"
2867 msgstr ""
2868
2869 # type: verbatim
2870 #. type: verbatim
2871 #: ../src/guestfs.pod:1315
2872 #, no-wrap
2873 msgid ""
2874 " guestfs_h *guestfs_create (void);\n"
2875 "\n"
2876 msgstr ""
2877
2878 # type: textblock
2879 #. type: textblock
2880 #: ../src/guestfs.pod:1317
2881 msgid "Create a connection handle."
2882 msgstr ""
2883
2884 # type: textblock
2885 #. type: textblock
2886 #: ../src/guestfs.pod:1319
2887 msgid ""
2888 "You have to call L</guestfs_add_drive_opts> (or one of the equivalent calls) "
2889 "on the handle at least once."
2890 msgstr ""
2891
2892 # type: textblock
2893 #. type: textblock
2894 #: ../src/guestfs.pod:1322
2895 msgid ""
2896 "This function returns a non-NULL pointer to a handle on success or NULL on "
2897 "error."
2898 msgstr ""
2899
2900 # type: textblock
2901 #. type: textblock
2902 #: ../src/guestfs.pod:1325
2903 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2904 msgstr ""
2905
2906 # type: textblock
2907 #. type: textblock
2908 #: ../src/guestfs.pod:1327
2909 msgid ""
2910 "You may also want to configure error handling for the handle.  See L</ERROR "
2911 "HANDLING> section below."
2912 msgstr ""
2913
2914 # type: =head2
2915 #. type: =head2
2916 #: ../src/guestfs.pod:1330
2917 msgid "guestfs_close"
2918 msgstr ""
2919
2920 # type: verbatim
2921 #. type: verbatim
2922 #: ../src/guestfs.pod:1332
2923 #, no-wrap
2924 msgid ""
2925 " void guestfs_close (guestfs_h *g);\n"
2926 "\n"
2927 msgstr ""
2928
2929 # type: textblock
2930 #. type: textblock
2931 #: ../src/guestfs.pod:1334
2932 msgid "This closes the connection handle and frees up all resources used."
2933 msgstr ""
2934
2935 # type: =head1
2936 #. type: =head1
2937 #: ../src/guestfs.pod:1336
2938 msgid "ERROR HANDLING"
2939 msgstr ""
2940
2941 # type: textblock
2942 #. type: textblock
2943 #: ../src/guestfs.pod:1338
2944 msgid ""
2945 "API functions can return errors.  For example, almost all functions that "
2946 "return C<int> will return C<-1> to indicate an error."
2947 msgstr ""
2948
2949 # type: textblock
2950 #. type: textblock
2951 #: ../src/guestfs.pod:1341
2952 msgid ""
2953 "Additional information is available for errors: an error message string and "
2954 "optionally an error number (errno) if the thing that failed was a system "
2955 "call."
2956 msgstr ""
2957
2958 # type: textblock
2959 #. type: textblock
2960 #: ../src/guestfs.pod:1345
2961 msgid ""
2962 "You can get at the additional information about the last error on the handle "
2963 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2964 "up an error handler with L</guestfs_set_error_handler>."
2965 msgstr ""
2966
2967 # type: textblock
2968 #. type: textblock
2969 #: ../src/guestfs.pod:1350
2970 msgid ""
2971 "When the handle is created, a default error handler is installed which "
2972 "prints the error message string to C<stderr>.  For small short-running "
2973 "command line programs it is sufficient to do:"
2974 msgstr ""
2975
2976 # type: verbatim
2977 #. type: verbatim
2978 #: ../src/guestfs.pod:1354
2979 #, no-wrap
2980 msgid ""
2981 " if (guestfs_launch (g) == -1)\n"
2982 "   exit (EXIT_FAILURE);\n"
2983 "\n"
2984 msgstr ""
2985
2986 # type: textblock
2987 #. type: textblock
2988 #: ../src/guestfs.pod:1357
2989 msgid ""
2990 "since the default error handler will ensure that an error message has been "
2991 "printed to C<stderr> before the program exits."
2992 msgstr ""
2993
2994 # type: textblock
2995 #. type: textblock
2996 #: ../src/guestfs.pod:1360
2997 msgid ""
2998 "For other programs the caller will almost certainly want to install an "
2999 "alternate error handler or do error handling in-line like this:"
3000 msgstr ""
3001
3002 # type: verbatim
3003 #. type: verbatim
3004 #: ../src/guestfs.pod:1363
3005 #, no-wrap
3006 msgid ""
3007 " g = guestfs_create ();\n"
3008 " \n"
3009 msgstr ""
3010
3011 # type: verbatim
3012 #. type: verbatim
3013 #: ../src/guestfs.pod:1365
3014 #, no-wrap
3015 msgid ""
3016 " /* This disables the default behaviour of printing errors\n"
3017 "    on stderr. */\n"
3018 " guestfs_set_error_handler (g, NULL, NULL);\n"
3019 " \n"
3020 msgstr ""
3021
3022 # type: verbatim
3023 #. type: verbatim
3024 #: ../src/guestfs.pod:1369
3025 #, no-wrap
3026 msgid ""
3027 " if (guestfs_launch (g) == -1) {\n"
3028 "   /* Examine the error message and print it etc. */\n"
3029 "   char *msg = guestfs_last_error (g);\n"
3030 "   int errnum = guestfs_last_errno (g);\n"
3031 "   fprintf (stderr, \"%s\\n\", msg);\n"
3032 "   /* ... */\n"
3033 "  }\n"
3034 "\n"
3035 msgstr ""
3036
3037 # type: textblock
3038 #. type: textblock
3039 #: ../src/guestfs.pod:1377
3040 msgid ""
3041 "Out of memory errors are handled differently.  The default action is to call "
3042 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
3043 "guestfs_set_out_of_memory_handler>."
3044 msgstr ""
3045
3046 # type: textblock
3047 #. type: textblock
3048 #: ../src/guestfs.pod:1381
3049 msgid ""
3050 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
3051 "because there is no handle if this happens there is no way to get additional "
3052 "error information.  However L</guestfs_create> is supposed to be a "
3053 "lightweight operation which can only fail because of insufficient memory (it "
3054 "returns NULL in this case)."
3055 msgstr ""
3056
3057 # type: =head2
3058 #. type: =head2
3059 #: ../src/guestfs.pod:1387
3060 msgid "guestfs_last_error"
3061 msgstr ""
3062
3063 # type: verbatim
3064 #. type: verbatim
3065 #: ../src/guestfs.pod:1389
3066 #, no-wrap
3067 msgid ""
3068 " const char *guestfs_last_error (guestfs_h *g);\n"
3069 "\n"
3070 msgstr ""
3071
3072 # type: textblock
3073 #. type: textblock
3074 #: ../src/guestfs.pod:1391
3075 msgid ""
3076 "This returns the last error message that happened on C<g>.  If there has not "
3077 "been an error since the handle was created, then this returns C<NULL>."
3078 msgstr ""
3079
3080 # type: textblock
3081 #. type: textblock
3082 #: ../src/guestfs.pod:1395
3083 msgid ""
3084 "The lifetime of the returned string is until the next error occurs, or L</"
3085 "guestfs_close> is called."
3086 msgstr ""
3087
3088 # type: =head2
3089 #. type: =head2
3090 #: ../src/guestfs.pod:1398
3091 msgid "guestfs_last_errno"
3092 msgstr ""
3093
3094 # type: verbatim
3095 #. type: verbatim
3096 #: ../src/guestfs.pod:1400
3097 #, no-wrap
3098 msgid ""
3099 " int guestfs_last_errno (guestfs_h *g);\n"
3100 "\n"
3101 msgstr ""
3102
3103 # type: textblock
3104 #. type: textblock
3105 #: ../src/guestfs.pod:1402
3106 msgid "This returns the last error number (errno) that happened on C<g>."
3107 msgstr ""
3108
3109 # type: textblock
3110 #. type: textblock
3111 #: ../src/guestfs.pod:1404
3112 msgid "If successful, an errno integer not equal to zero is returned."
3113 msgstr ""
3114
3115 # type: textblock
3116 #. type: textblock
3117 #: ../src/guestfs.pod:1406
3118 msgid ""
3119 "If no error, this returns 0.  This call can return 0 in three situations:"
3120 msgstr ""
3121
3122 # type: textblock
3123 #. type: textblock
3124 #: ../src/guestfs.pod:1413
3125 msgid "There has not been any error on the handle."
3126 msgstr ""
3127
3128 # type: textblock
3129 #. type: textblock
3130 #: ../src/guestfs.pod:1417
3131 msgid ""
3132 "There has been an error but the errno was meaningless.  This corresponds to "
3133 "the case where the error did not come from a failed system call, but for "
3134 "some other reason."
3135 msgstr ""
3136
3137 # type: textblock
3138 #. type: textblock
3139 #: ../src/guestfs.pod:1423
3140 msgid ""
3141 "There was an error from a failed system call, but for some reason the errno "
3142 "was not captured and returned.  This usually indicates a bug in libguestfs."
3143 msgstr ""
3144
3145 # type: textblock
3146 #. type: textblock
3147 #: ../src/guestfs.pod:1429
3148 msgid ""
3149 "Libguestfs tries to convert the errno from inside the applicance into a "
3150 "corresponding errno for the caller (not entirely trivial: the appliance "
3151 "might be running a completely different operating system from the library "
3152 "and error numbers are not standardized across Un*xen).  If this could not be "
3153 "done, then the error is translated to C<EINVAL>.  In practice this should "
3154 "only happen in very rare circumstances."
3155 msgstr ""
3156
3157 # type: =head2
3158 #. type: =head2
3159 #: ../src/guestfs.pod:1437
3160 msgid "guestfs_set_error_handler"
3161 msgstr ""
3162
3163 # type: verbatim
3164 #. type: verbatim
3165 #: ../src/guestfs.pod:1439
3166 #, no-wrap
3167 msgid ""
3168 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3169 "                                           void *opaque,\n"
3170 "                                           const char *msg);\n"
3171 " void guestfs_set_error_handler (guestfs_h *g,\n"
3172 "                                 guestfs_error_handler_cb cb,\n"
3173 "                                 void *opaque);\n"
3174 "\n"
3175 msgstr ""
3176
3177 # type: textblock
3178 #. type: textblock
3179 #: ../src/guestfs.pod:1446
3180 msgid ""
3181 "The callback C<cb> will be called if there is an error.  The parameters "
3182 "passed to the callback are an opaque data pointer and the error message "
3183 "string."
3184 msgstr ""
3185
3186 # type: textblock
3187 #. type: textblock
3188 #: ../src/guestfs.pod:1450
3189 msgid ""
3190 "C<errno> is not passed to the callback.  To get that the callback must call "
3191 "L</guestfs_last_errno>."
3192 msgstr ""
3193
3194 # type: textblock
3195 #. type: textblock
3196 #: ../src/guestfs.pod:1453
3197 msgid ""
3198 "Note that the message string C<msg> is freed as soon as the callback "
3199 "function returns, so if you want to stash it somewhere you must make your "
3200 "own copy."
3201 msgstr ""
3202
3203 # type: textblock
3204 #. type: textblock
3205 #: ../src/guestfs.pod:1457
3206 msgid "The default handler prints messages on C<stderr>."
3207 msgstr ""
3208
3209 # type: textblock
3210 #. type: textblock
3211 #: ../src/guestfs.pod:1459
3212 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3213 msgstr ""
3214
3215 # type: =head2
3216 #. type: =head2
3217 #: ../src/guestfs.pod:1461
3218 msgid "guestfs_get_error_handler"
3219 msgstr ""
3220
3221 # type: verbatim
3222 #. type: verbatim
3223 #: ../src/guestfs.pod:1463
3224 #, no-wrap
3225 msgid ""
3226 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3227 "                                                     void **opaque_rtn);\n"
3228 "\n"
3229 msgstr ""
3230
3231 # type: textblock
3232 #. type: textblock
3233 #: ../src/guestfs.pod:1466
3234 msgid "Returns the current error handler callback."
3235 msgstr ""
3236
3237 # type: =head2
3238 #. type: =head2
3239 #: ../src/guestfs.pod:1468
3240 msgid "guestfs_set_out_of_memory_handler"
3241 msgstr ""
3242
3243 # type: verbatim
3244 #. type: verbatim
3245 #: ../src/guestfs.pod:1470
3246 #, no-wrap
3247 msgid ""
3248 " typedef void (*guestfs_abort_cb) (void);\n"
3249 " int guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3250 "                                        guestfs_abort_cb);\n"
3251 "\n"
3252 msgstr ""
3253
3254 # type: textblock
3255 #. type: textblock
3256 #: ../src/guestfs.pod:1474
3257 msgid ""
3258 "The callback C<cb> will be called if there is an out of memory situation.  "
3259 "I<Note this callback must not return>."
3260 msgstr ""
3261
3262 # type: textblock
3263 #. type: textblock
3264 #: ../src/guestfs.pod:1477
3265 msgid "The default is to call L<abort(3)>."
3266 msgstr ""
3267
3268 # type: textblock
3269 #. type: textblock
3270 #: ../src/guestfs.pod:1479
3271 msgid ""
3272 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3273 msgstr ""
3274
3275 # type: =head2
3276 #. type: =head2
3277 #: ../src/guestfs.pod:1482
3278 msgid "guestfs_get_out_of_memory_handler"
3279 msgstr ""
3280
3281 # type: verbatim
3282 #. type: verbatim
3283 #: ../src/guestfs.pod:1484
3284 #, no-wrap
3285 msgid ""
3286 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3287 "\n"
3288 msgstr ""
3289
3290 # type: textblock
3291 #. type: textblock
3292 #: ../src/guestfs.pod:1486
3293 msgid "This returns the current out of memory handler."
3294 msgstr ""
3295
3296 # type: =head1
3297 #. type: =head1
3298 #: ../src/guestfs.pod:1488
3299 msgid "API CALLS"
3300 msgstr ""
3301
3302 # type: textblock
3303 #. type: textblock
3304 #: ../src/guestfs.pod:1490 ../fish/guestfish.pod:1008
3305 msgid "@ACTIONS@"
3306 msgstr ""
3307
3308 # type: =head1
3309 #. type: =head1
3310 #: ../src/guestfs.pod:1492
3311 msgid "STRUCTURES"
3312 msgstr ""
3313
3314 # type: textblock
3315 #. type: textblock
3316 #: ../src/guestfs.pod:1494
3317 msgid "@STRUCTS@"
3318 msgstr ""
3319
3320 # type: =head1
3321 #. type: =head1
3322 #: ../src/guestfs.pod:1496
3323 msgid "AVAILABILITY"
3324 msgstr ""
3325
3326 # type: =head2
3327 #. type: =head2
3328 #: ../src/guestfs.pod:1498
3329 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3330 msgstr ""
3331
3332 # type: textblock
3333 #. type: textblock
3334 #: ../src/guestfs.pod:1500
3335 msgid ""
3336 "Using L</guestfs_available> you can test availability of the following "
3337 "groups of functions.  This test queries the appliance to see if the "
3338 "appliance you are currently using supports the functionality."
3339 msgstr ""
3340
3341 # type: textblock
3342 #. type: textblock
3343 #: ../src/guestfs.pod:1505
3344 msgid "@AVAILABILITY@"
3345 msgstr ""
3346
3347 # type: =head2
3348 #. type: =head2
3349 #: ../src/guestfs.pod:1507
3350 msgid "GUESTFISH supported COMMAND"
3351 msgstr ""
3352
3353 # type: textblock
3354 #. type: textblock
3355 #: ../src/guestfs.pod:1509
3356 msgid ""
3357 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3358 "prints out the available groups and whether they are supported by this build "
3359 "of libguestfs.  Note however that you have to do C<run> first."
3360 msgstr ""
3361
3362 # type: =head2
3363 #. type: =head2
3364 #: ../src/guestfs.pod:1514
3365 msgid "SINGLE CALLS AT COMPILE TIME"
3366 msgstr ""
3367
3368 # type: textblock
3369 #. type: textblock
3370 #: ../src/guestfs.pod:1516
3371 msgid ""
3372 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3373 "function, such as:"
3374 msgstr ""
3375
3376 # type: verbatim
3377 #. type: verbatim
3378 #: ../src/guestfs.pod:1519
3379 #, no-wrap
3380 msgid ""
3381 " #define LIBGUESTFS_HAVE_DD 1\n"
3382 "\n"
3383 msgstr ""
3384
3385 # type: textblock
3386 #. type: textblock
3387 #: ../src/guestfs.pod:1521
3388 msgid "if L</guestfs_dd> is available."
3389 msgstr ""
3390
3391 # type: textblock
3392 #. type: textblock
3393 #: ../src/guestfs.pod:1523
3394 msgid ""
3395 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3396 "function is available at compile time, we recommended using build tools such "
3397 "as autoconf or cmake.  For example in autotools you could use:"
3398 msgstr ""
3399
3400 # type: verbatim
3401 #. type: verbatim
3402 #: ../src/guestfs.pod:1528
3403 #, no-wrap
3404 msgid ""
3405 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3406 " AC_CHECK_FUNCS([guestfs_dd])\n"
3407 "\n"
3408 msgstr ""
3409
3410 # type: textblock
3411 #. type: textblock
3412 #: ../src/guestfs.pod:1531
3413 msgid ""
3414 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3415 "in your program."
3416 msgstr ""
3417
3418 # type: =head2
3419 #. type: =head2
3420 #: ../src/guestfs.pod:1534
3421 msgid "SINGLE CALLS AT RUN TIME"
3422 msgstr ""
3423
3424 # type: textblock
3425 #. type: textblock
3426 #: ../src/guestfs.pod:1536
3427 msgid ""
3428 "Testing at compile time doesn't guarantee that a function really exists in "
3429 "the library.  The reason is that you might be dynamically linked against a "
3430 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3431 "This situation unfortunately results in a segmentation fault, which is a "
3432 "shortcoming of the C dynamic linking system itself."
3433 msgstr ""
3434
3435 # type: textblock
3436 #. type: textblock
3437 #: ../src/guestfs.pod:1543
3438 msgid ""
3439 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3440 "in this example program (note that you still need the compile time check as "
3441 "well):"
3442 msgstr ""
3443
3444 # type: verbatim
3445 #. type: verbatim
3446 #: ../src/guestfs.pod:1547
3447 #, no-wrap
3448 msgid ""
3449 " #include <stdio.h>\n"
3450 " #include <stdlib.h>\n"
3451 " #include <unistd.h>\n"
3452 " #include <dlfcn.h>\n"
3453 " #include <guestfs.h>\n"
3454 " \n"
3455 msgstr ""
3456
3457 # type: verbatim
3458 #. type: verbatim
3459 #: ../src/guestfs.pod:1553
3460 #, no-wrap
3461 msgid ""
3462 " main ()\n"
3463 " {\n"
3464 " #ifdef LIBGUESTFS_HAVE_DD\n"
3465 "   void *dl;\n"
3466 "   int has_function;\n"
3467 " \n"
3468 msgstr ""
3469
3470 # type: verbatim
3471 #. type: verbatim
3472 #: ../src/guestfs.pod:1559
3473 #, no-wrap
3474 msgid ""
3475 "   /* Test if the function guestfs_dd is really available. */\n"
3476 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3477 "   if (!dl) {\n"
3478 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3479 "     exit (EXIT_FAILURE);\n"
3480 "   }\n"
3481 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3482 "   dlclose (dl);\n"
3483 " \n"
3484 msgstr ""
3485
3486 # type: verbatim
3487 #. type: verbatim
3488 #: ../src/guestfs.pod:1568
3489 #, no-wrap
3490 msgid ""
3491 "   if (!has_function)\n"
3492 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3493 "   else {\n"
3494 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3495 "     /* Now it's safe to call\n"
3496 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3497 "     */\n"
3498 "   }\n"
3499 " #else\n"
3500 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3501 " #endif\n"
3502 "  }\n"
3503 "\n"
3504 msgstr ""
3505
3506 # type: textblock
3507 #. type: textblock
3508 #: ../src/guestfs.pod:1581
3509 msgid ""
3510 "You may think the above is an awful lot of hassle, and it is.  There are "
3511 "other ways outside of the C linking system to ensure that this kind of "
3512 "incompatibility never arises, such as using package versioning:"
3513 msgstr ""
3514
3515 # type: verbatim
3516 #. type: verbatim
3517 #: ../src/guestfs.pod:1586
3518 #, no-wrap
3519 msgid ""
3520 " Requires: libguestfs >= 1.0.80\n"
3521 "\n"
3522 msgstr ""
3523
3524 # type: =head1
3525 #. type: =head1
3526 #: ../src/guestfs.pod:1588
3527 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3528 msgstr ""
3529
3530 # type: textblock
3531 #. type: textblock
3532 #: ../src/guestfs.pod:1590
3533 msgid ""
3534 "A recent feature of the API is the introduction of calls which take optional "
3535 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3536 "takes variable arguments (ie. C<...>), as in this example:"
3537 msgstr ""
3538
3539 # type: verbatim
3540 #. type: verbatim
3541 #: ../src/guestfs.pod:1595
3542 #, no-wrap
3543 msgid ""
3544 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3545 "\n"
3546 msgstr ""
3547
3548 # type: textblock
3549 #. type: textblock
3550 #: ../src/guestfs.pod:1597
3551 msgid ""
3552 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3553 "call with no optional arguments specified:"
3554 msgstr ""
3555
3556 # type: verbatim
3557 #. type: verbatim
3558 #: ../src/guestfs.pod:1600
3559 #, no-wrap
3560 msgid ""
3561 " guestfs_add_drive_opts (g, filename, -1);\n"
3562 "\n"
3563 msgstr ""
3564
3565 # type: textblock
3566 #. type: textblock
3567 #: ../src/guestfs.pod:1602
3568 msgid "With a single optional argument:"
3569 msgstr ""
3570
3571 # type: verbatim
3572 #. type: verbatim
3573 #: ../src/guestfs.pod:1604
3574 #, no-wrap
3575 msgid ""
3576 " guestfs_add_drive_opts (g, filename,\n"
3577 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3578 "                         -1);\n"
3579 "\n"
3580 msgstr ""
3581
3582 # type: textblock
3583 #. type: textblock
3584 #: ../src/guestfs.pod:1608
3585 msgid "With two:"
3586 msgstr ""
3587
3588 # type: verbatim
3589 #. type: verbatim
3590 #: ../src/guestfs.pod:1610
3591 #, no-wrap
3592 msgid ""
3593 " guestfs_add_drive_opts (g, filename,\n"
3594 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3595 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3596 "                         -1);\n"
3597 "\n"
3598 msgstr ""
3599
3600 # type: textblock
3601 #. type: textblock
3602 #: ../src/guestfs.pod:1615
3603 msgid ""
3604 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3605 "happen!"
3606 msgstr ""
3607
3608 # type: =head2
3609 #. type: =head2
3610 #: ../src/guestfs.pod:1618
3611 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3612 msgstr ""
3613
3614 # type: textblock
3615 #. type: textblock
3616 #: ../src/guestfs.pod:1620
3617 msgid ""
3618 "The second variant has the same name with the suffix C<_va>, which works the "
3619 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3620 "example function, this is declared:"
3621 msgstr ""
3622
3623 # type: verbatim
3624 #. type: verbatim
3625 #: ../src/guestfs.pod:1624
3626 #, no-wrap
3627 msgid ""
3628 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3629 "                                va_list args);\n"
3630 "\n"
3631 msgstr ""
3632
3633 # type: =head2
3634 #. type: =head2
3635 #: ../src/guestfs.pod:1627
3636 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3637 msgstr ""
3638
3639 # type: textblock
3640 #. type: textblock
3641 #: ../src/guestfs.pod:1629
3642 msgid ""
3643 "The third variant is useful where you need to construct these calls.  You "
3644 "pass in a structure where you fill in the optional fields.  The structure "
3645 "has a bitmask as the first element which you must set to indicate which "
3646 "fields you have filled in.  For our example function the structure and call "
3647 "are declared:"
3648 msgstr ""
3649
3650 # type: verbatim
3651 #. type: verbatim
3652 #: ../src/guestfs.pod:1635
3653 #, no-wrap
3654 msgid ""
3655 " struct guestfs_add_drive_opts_argv {\n"
3656 "   uint64_t bitmask;\n"
3657 "   int readonly;\n"
3658 "   const char *format;\n"
3659 "   /* ... */\n"
3660 " };\n"
3661 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3662 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3663 "\n"
3664 msgstr ""
3665
3666 # type: textblock
3667 #. type: textblock
3668 #: ../src/guestfs.pod:1644
3669 msgid "You could call it like this:"
3670 msgstr ""
3671
3672 # type: verbatim
3673 #. type: verbatim
3674 #: ../src/guestfs.pod:1646
3675 #, no-wrap
3676 msgid ""
3677 " struct guestfs_add_drive_opts_argv optargs = {\n"
3678 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3679 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3680 "   .readonly = 1,\n"
3681 "   .format = \"qcow2\"\n"
3682 " };\n"
3683 " \n"
3684 msgstr ""
3685
3686 # type: verbatim
3687 #. type: verbatim
3688 #: ../src/guestfs.pod:1653
3689 #, no-wrap
3690 msgid ""
3691 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3692 "\n"
3693 msgstr ""
3694
3695 # type: textblock
3696 #. type: textblock
3697 #: ../src/guestfs.pod:1655 ../src/guestfs-actions.pod:11
3698 #: ../src/guestfs-actions.pod:1855 ../fish/guestfish-actions.pod:9
3699 #: ../fish/guestfish-actions.pod:1260 ../tools/virt-win-reg.pl:532
3700 msgid "Notes:"
3701 msgstr ""
3702
3703 # type: textblock
3704 #. type: textblock
3705 #: ../src/guestfs.pod:1661
3706 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3707 msgstr ""
3708
3709 # type: textblock
3710 #. type: textblock
3711 #: ../src/guestfs.pod:1666
3712 msgid "You do not need to fill in all fields of the structure."
3713 msgstr ""
3714
3715 # type: textblock
3716 #. type: textblock
3717 #: ../src/guestfs.pod:1670
3718 msgid ""
3719 "There must be a one-to-one correspondence between fields of the structure "
3720 "that are filled in, and bits set in the bitmask."
3721 msgstr ""
3722
3723 # type: =head2
3724 #. type: =head2
3725 #: ../src/guestfs.pod:1675
3726 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3727 msgstr ""
3728
3729 # type: textblock
3730 #. type: textblock
3731 #: ../src/guestfs.pod:1677
3732 msgid ""
3733 "In other languages, optional arguments are expressed in the way that is "
3734 "natural for that language.  We refer you to the language-specific "
3735 "documentation for more details on that."
3736 msgstr ""
3737
3738 # type: textblock
3739 #. type: textblock
3740 #: ../src/guestfs.pod:1681
3741 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3742 msgstr ""
3743
3744 # type: =head2
3745 #. type: =head2
3746 #: ../src/guestfs.pod:1683
3747 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3748 msgstr ""
3749
3750 #. type: textblock
3751 #: ../src/guestfs.pod:1685
3752 msgid ""
3753 "B<Note:> This section documents the generic event mechanism introduced in "
3754 "libguestfs 1.10, which you should use in new code if possible.  The old "
3755 "functions C<guestfs_set_log_message_callback>, "
3756 "C<guestfs_set_subprocess_quit_callback>, "
3757 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
3758 "C<guestfs_set_progress_callback> are no longer documented in this manual "
3759 "page."
3760 msgstr ""
3761
3762 #. type: textblock
3763 #: ../src/guestfs.pod:1693
3764 msgid ""
3765 "Handles generate events when certain things happen, such as log messages "
3766 "being generated, progress messages during long-running operations, or the "
3767 "handle being closed.  The API calls described below let you register a "
3768 "callback to be called when events happen.  You can register multiple "
3769 "callbacks (for the same, different or overlapping sets of events), and "
3770 "individually remove callbacks.  If callbacks are not removed, then they "
3771 "remain in force until the handle is closed."
3772 msgstr ""
3773
3774 #. type: textblock
3775 #: ../src/guestfs.pod:1701
3776 msgid ""
3777 "In the current implementation, events are only generated synchronously: that "
3778 "means that events (and hence callbacks) can only happen while you are in the "
3779 "middle of making another libguestfs call.  The callback is called in the "
3780 "same thread."
3781 msgstr ""
3782
3783 #. type: textblock
3784 #: ../src/guestfs.pod:1706
3785 msgid ""
3786 "Events may contain a payload, usually nothing (void), an array of 64 bit "
3787 "unsigned integers, or a message buffer.  Payloads are discussed later on."
3788 msgstr ""
3789
3790 #. type: =head3
3791 #: ../src/guestfs.pod:1710
3792 msgid "CLASSES OF EVENTS"
3793 msgstr ""
3794
3795 #. type: =item
3796 #: ../src/guestfs.pod:1714
3797 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
3798 msgstr ""
3799
3800 #. type: textblock
3801 #: ../src/guestfs.pod:1717
3802 msgid ""
3803 "The callback function will be called while the handle is being closed "
3804 "(synchronously from L</guestfs_close>)."
3805 msgstr ""
3806
3807 # type: textblock
3808 #. type: textblock
3809 #: ../src/guestfs.pod:1720
3810 msgid ""
3811 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3812 "handles that are open when the program exits.  This means that this callback "
3813 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3814 "problems in higher-level languages (eg. if your HLL interpreter has already "
3815 "been cleaned up by the time this is called, and if your callback then jumps "
3816 "into some HLL function)."
3817 msgstr ""
3818
3819 #. type: textblock
3820 #: ../src/guestfs.pod:1727
3821 msgid ""
3822 "If no callback is registered: the handle is closed without any callback "
3823 "being invoked."
3824 msgstr ""
3825
3826 #. type: =item
3827 #: ../src/guestfs.pod:1730
3828 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
3829 msgstr ""
3830
3831 #. type: textblock
3832 #: ../src/guestfs.pod:1733
3833 msgid ""
3834 "The callback function will be called when the child process quits, either "
3835 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3836 "corresponds to a transition from any state to the CONFIG state)."
3837 msgstr ""
3838
3839 #. type: textblock
3840 #: ../src/guestfs.pod:1737 ../src/guestfs.pod:1746
3841 msgid "If no callback is registered: the event is ignored."
3842 msgstr ""
3843
3844 #. type: =item
3845 #: ../src/guestfs.pod:1739
3846 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
3847 msgstr ""
3848
3849 #. type: textblock
3850 #: ../src/guestfs.pod:1742
3851 msgid ""
3852 "The callback function will be called when the child process becomes ready "
3853 "first time after it has been launched.  (This corresponds to a transition "
3854 "from LAUNCHING to the READY state)."
3855 msgstr ""
3856
3857 #. type: =item
3858 #: ../src/guestfs.pod:1748
3859 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
3860 msgstr ""
3861
3862 # type: textblock
3863 #. type: textblock
3864 #: ../src/guestfs.pod:1751
3865 msgid ""
3866 "Some long-running operations can generate progress messages.  If this "
3867 "callback is registered, then it will be called each time a progress message "
3868 "is generated (usually two seconds after the operation started, and three "
3869 "times per second thereafter until it completes, although the frequency may "
3870 "change in future versions)."
3871 msgstr ""
3872
3873 #. type: textblock
3874 #: ../src/guestfs.pod:1757
3875 msgid ""
3876 "The callback receives in the payload four unsigned 64 bit numbers which are "
3877 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
3878 msgstr ""
3879
3880 #. type: textblock
3881 #: ../src/guestfs.pod:1760
3882 msgid ""
3883 "The units of C<total> are not defined, although for some operations C<total> "
3884 "may relate in some way to the amount of data to be transferred (eg. in bytes "
3885 "or megabytes), and C<position> may be the portion which has been transferred."
3886 msgstr ""
3887
3888 # type: textblock
3889 #. type: textblock
3890 #: ../src/guestfs.pod:1765
3891 msgid "The only defined and stable parts of the API are:"
3892 msgstr ""
3893
3894 # type: textblock
3895 #. type: textblock
3896 #: ../src/guestfs.pod:1771
3897 msgid ""
3898 "The callback can display to the user some type of progress bar or indicator "
3899 "which shows the ratio of C<position>:C<total>."
3900 msgstr ""
3901
3902 # type: textblock
3903 #. type: textblock
3904 #: ../src/guestfs.pod:1776
3905 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3906 msgstr ""
3907
3908 #. type: textblock
3909 #: ../src/guestfs.pod:1780
3910 msgid ""
3911 "If any progress notification is sent during a call, then a final progress "
3912 "notification is always sent when C<position> = C<total> (I<unless> the call "
3913 "fails with an error)."
3914 msgstr ""
3915
3916 # type: textblock
3917 #. type: textblock
3918 #: ../src/guestfs.pod:1784
3919 msgid ""
3920 "This is to simplify caller code, so callers can easily set the progress "
3921 "indicator to \"100%\" at the end of the operation, without requiring special "
3922 "code to detect this case."
3923 msgstr ""
3924
3925 #. type: textblock
3926 #: ../src/guestfs.pod:1790
3927 msgid ""
3928 "For some calls we are unable to estimate the progress of the call, but we "
3929 "can still generate progress messages to indicate activity.  This is known as "
3930 "\"pulse mode\", and is directly supported by certain progress bar "
3931 "implementations (eg. GtkProgressBar)."
3932 msgstr ""
3933
3934 #. type: textblock
3935 #: ../src/guestfs.pod:1795
3936 msgid ""
3937 "For these calls, zero or more progress messages are generated with "
3938 "C<position = 0> and C<total = 1>, followed by a final message with "
3939 "C<position = total = 1>."
3940 msgstr ""
3941
3942 #. type: textblock
3943 #: ../src/guestfs.pod:1799
3944 msgid ""
3945 "As noted above, if the call fails with an error then the final message may "
3946 "not be generated."
3947 msgstr ""
3948
3949 #. type: textblock
3950 #: ../src/guestfs.pod:1804
3951 msgid ""
3952 "The callback also receives the procedure number (C<proc_nr>) and serial "
3953 "number (C<serial>) of the call.  These are only useful for debugging "
3954 "protocol issues, and the callback can normally ignore them.  The callback "
3955 "may want to print these numbers in error messages or debugging messages."
3956 msgstr ""
3957
3958 #. type: textblock
3959 #: ../src/guestfs.pod:1810
3960 msgid "If no callback is registered: progress messages are discarded."
3961 msgstr ""
3962
3963 #. type: =item
3964 #: ../src/guestfs.pod:1812
3965 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
3966 msgstr ""
3967
3968 #. type: textblock
3969 #: ../src/guestfs.pod:1815
3970 msgid ""
3971 "The callback function is called whenever a log message is generated by qemu, "
3972 "the appliance kernel, guestfsd (daemon), or utility programs."
3973 msgstr ""
3974
3975 #. type: textblock
3976 #: ../src/guestfs.pod:1818
3977 msgid ""
3978 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
3979 "guestfs_launch>) then additional debug messages are generated."
3980 msgstr ""
3981
3982 #. type: textblock
3983 #: ../src/guestfs.pod:1821 ../src/guestfs.pod:1835
3984 msgid ""
3985 "If no callback is registered: the messages are discarded unless the verbose "
3986 "flag is set in which case they are sent to stderr.  You can override the "
3987 "printing of verbose messages to stderr by setting up a callback."
3988 msgstr ""
3989
3990 #. type: =item
3991 #: ../src/guestfs.pod:1826
3992 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
3993 msgstr ""
3994
3995 #. type: textblock
3996 #: ../src/guestfs.pod:1829
3997 msgid ""
3998 "The callback function is called whenever a log message is generated by the "
3999 "library part of libguestfs."
4000 msgstr ""
4001
4002 #. type: textblock
4003 #: ../src/guestfs.pod:1832
4004 msgid ""
4005 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
4006 "messages are generated."
4007 msgstr ""
4008
4009 #. type: =item
4010 #: ../src/guestfs.pod:1840
4011 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
4012 msgstr ""
4013
4014 #. type: textblock
4015 #: ../src/guestfs.pod:1843
4016 msgid ""
4017 "The callback function is called whenever a trace message is generated.  This "
4018 "only applies if the trace flag (L</guestfs_set_trace>) is set."
4019 msgstr ""
4020
4021 #. type: textblock
4022 #: ../src/guestfs.pod:1846
4023 msgid ""
4024 "If no callback is registered: the messages are sent to stderr.  You can "
4025 "override the printing of trace messages to stderr by setting up a callback."
4026 msgstr ""
4027
4028 #. type: =head3
4029 #: ../src/guestfs.pod:1852
4030 msgid "guestfs_set_event_callback"
4031 msgstr ""
4032
4033 #. type: verbatim
4034 #: ../src/guestfs.pod:1854
4035 #, no-wrap
4036 msgid ""
4037 " int guestfs_set_event_callback (guestfs_h *g,\n"
4038 "                                 guestfs_event_callback cb,\n"
4039 "                                 uint64_t event_bitmask,\n"
4040 "                                 int flags,\n"
4041 "                                 void *opaque);\n"
4042 "\n"
4043 msgstr ""
4044
4045 #. type: textblock
4046 #: ../src/guestfs.pod:1860
4047 msgid ""
4048 "This function registers a callback (C<cb>) for all event classes in the "
4049 "C<event_bitmask>."
4050 msgstr ""
4051
4052 #. type: textblock
4053 #: ../src/guestfs.pod:1863
4054 msgid ""
4055 "For example, to register for all log message events, you could call this "
4056 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
4057 "To register a single callback for all possible classes of events, use "
4058 "C<GUESTFS_EVENT_ALL>."
4059 msgstr ""
4060
4061 #. type: textblock
4062 #: ../src/guestfs.pod:1869
4063 msgid "C<flags> should always be passed as 0."
4064 msgstr ""
4065
4066 #. type: textblock
4067 #: ../src/guestfs.pod:1871
4068 msgid ""
4069 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
4070 "it for any purpose."
4071 msgstr ""
4072
4073 #. type: textblock
4074 #: ../src/guestfs.pod:1874
4075 msgid ""
4076 "The return value is the event handle (an integer) which you can use to "
4077 "delete the callback (see below)."
4078 msgstr ""
4079
4080 #. type: textblock
4081 #: ../src/guestfs.pod:1877
4082 msgid ""
4083 "If there is an error, this function returns C<-1>, and sets the error in the "
4084 "handle in the usual way (see L</guestfs_last_error> etc.)"
4085 msgstr ""
4086
4087 #. type: textblock
4088 #: ../src/guestfs.pod:1880
4089 msgid ""
4090 "Callbacks remain in effect until they are deleted, or until the handle is "
4091 "closed."
4092 msgstr ""
4093
4094 #. type: textblock
4095 #: ../src/guestfs.pod:1883
4096 msgid ""
4097 "In the case where multiple callbacks are registered for a particular event "
4098 "class, all of the callbacks are called.  The order in which multiple "
4099 "callbacks are called is not defined."
4100 msgstr ""
4101
4102 #. type: =head3
4103 #: ../src/guestfs.pod:1887
4104 msgid "guestfs_delete_event_callback"
4105 msgstr ""
4106
4107 #. type: verbatim
4108 #: ../src/guestfs.pod:1889
4109 #, no-wrap
4110 msgid ""
4111 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
4112 "\n"
4113 msgstr ""
4114
4115 #. type: textblock
4116 #: ../src/guestfs.pod:1891
4117 msgid ""
4118 "Delete a callback that was previously registered.  C<event_handle> should be "
4119 "the integer that was returned by a previous call to "
4120 "C<guestfs_set_event_callback> on the same handle."
4121 msgstr ""
4122
4123 #. type: =head3
4124 #: ../src/guestfs.pod:1895
4125 msgid "guestfs_event_callback"
4126 msgstr ""
4127
4128 #. type: verbatim
4129 #: ../src/guestfs.pod:1897
4130 #, no-wrap
4131 msgid ""
4132 " typedef void (*guestfs_event_callback) (\n"
4133 "                  guestfs_h *g,\n"
4134 "                  void *opaque,\n"
4135 "                  uint64_t event,\n"
4136 "                  int event_handle,\n"
4137 "                  int flags,\n"
4138 "                  const char *buf, size_t buf_len,\n"
4139 "                  const uint64_t *array, size_t array_len);\n"
4140 "\n"
4141 msgstr ""
4142
4143 #. type: textblock
4144 #: ../src/guestfs.pod:1906
4145 msgid ""
4146 "This is the type of the event callback function that you have to provide."
4147 msgstr ""
4148
4149 #. type: textblock
4150 #: ../src/guestfs.pod:1909
4151 msgid ""
4152 "The basic parameters are: the handle (C<g>), the opaque user pointer "
4153 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
4154 "handle, and C<flags> which in the current API you should ignore."
4155 msgstr ""
4156
4157 #. type: textblock
4158 #: ../src/guestfs.pod:1913
4159 msgid ""
4160 "The remaining parameters contain the event payload (if any).  Each event may "
4161 "contain a payload, which usually relates to the event class, but for future "
4162 "proofing your code should be written to handle any payload for any event "
4163 "class."
4164 msgstr ""
4165
4166 #. type: textblock
4167 #: ../src/guestfs.pod:1918
4168 msgid ""
4169 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
4170 "there is no message buffer).  Note that this message buffer can contain "
4171 "arbitrary 8 bit data, including NUL bytes."
4172 msgstr ""
4173
4174 #. type: textblock
4175 #: ../src/guestfs.pod:1922
4176 msgid ""
4177 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
4178 "moment this is only used for progress messages."
4179 msgstr ""
4180
4181 #. type: =head3
4182 #: ../src/guestfs.pod:1925
4183 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
4184 msgstr ""
4185
4186 #. type: textblock
4187 #: ../src/guestfs.pod:1927
4188 msgid ""
4189 "One motivation for the generic event API was to allow GUI programs to "
4190 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
4191 "unconditionally to C<stderr>."
4192 msgstr ""
4193
4194 #. type: textblock
4195 #: ../src/guestfs.pod:1931
4196 msgid ""
4197 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
4198 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
4199 "messages are not events; you must capture error messages separately)."
4200 msgstr ""
4201
4202 #. type: textblock
4203 #: ../src/guestfs.pod:1936
4204 msgid ""
4205 "Programs have to set up a callback to capture the classes of events of "
4206 "interest:"
4207 msgstr ""
4208
4209 #. type: verbatim
4210 #: ../src/guestfs.pod:1939
4211 #, no-wrap
4212 msgid ""
4213 " int eh =\n"
4214 "   guestfs_set_event_callback\n"
4215 "     (g, message_callback,\n"
4216 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
4217 "      GUESTFS_EVENT_TRACE,\n"
4218 "      0, NULL) == -1)\n"
4219 " if (eh == -1) {\n"
4220 "   // handle error in the usual way\n"
4221 " }\n"
4222 "\n"
4223 msgstr ""
4224
4225 #. type: textblock
4226 #: ../src/guestfs.pod:1949
4227 msgid ""
4228 "The callback can then direct messages to the appropriate place.  In this "
4229 "example, messages are directed to syslog:"
4230 msgstr ""
4231
4232 #. type: verbatim
4233 #: ../src/guestfs.pod:1952
4234 #, no-wrap
4235 msgid ""
4236 " static void\n"
4237 " message_callback (\n"
4238 "         guestfs_h *g,\n"
4239 "         void *opaque,\n"
4240 "         uint64_t event,\n"
4241 "         int event_handle,\n"
4242 "         int flags,\n"
4243 "         const char *buf, size_t buf_len,\n"
4244 "         const uint64_t *array, size_t array_len)\n"
4245 " {\n"
4246 "   const int priority = LOG_USER|LOG_INFO;\n"
4247 "   if (buf_len > 0)\n"
4248 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
4249 " }\n"
4250 "\n"
4251 msgstr ""
4252
4253 # type: =head1
4254 #. type: =head1
4255 #: ../src/guestfs.pod:1967
4256 msgid "PRIVATE DATA AREA"
4257 msgstr ""
4258
4259 #. type: textblock
4260 #: ../src/guestfs.pod:1969
4261 msgid ""
4262 "You can attach named pieces of private data to the libguestfs handle, fetch "
4263 "them by name, and walk over them, for the lifetime of the handle.  This is "
4264 "called the private data area and is only available from the C API."
4265 msgstr ""
4266
4267 # type: textblock
4268 #. type: textblock
4269 #: ../src/guestfs.pod:1974
4270 msgid "To attach a named piece of data, use the following call:"
4271 msgstr ""
4272
4273 # type: verbatim
4274 #. type: verbatim
4275 #: ../src/guestfs.pod:1976
4276 #, no-wrap
4277 msgid ""
4278 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
4279 "\n"
4280 msgstr ""
4281
4282 # type: textblock
4283 #. type: textblock
4284 #: ../src/guestfs.pod:1978
4285 msgid ""
4286 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
4287 "pointer (which can be C<NULL>).  Any previous item with the same name is "
4288 "overwritten."
4289 msgstr ""
4290
4291 # type: textblock
4292 #. type: textblock
4293 #: ../src/guestfs.pod:1982
4294 msgid ""
4295 "You can use any C<key> you want, but names beginning with an underscore "
4296 "character are reserved for internal libguestfs purposes (for implementing "
4297 "language bindings).  It is recommended to prefix the name with some unique "
4298 "string to avoid collisions with other users."
4299 msgstr ""
4300
4301 # type: textblock
4302 #. type: textblock
4303 #: ../src/guestfs.pod:1987
4304 msgid "To retrieve the pointer, use:"
4305 msgstr ""
4306
4307 # type: verbatim
4308 #. type: verbatim
4309 #: ../src/guestfs.pod:1989
4310 #, no-wrap
4311 msgid ""
4312 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
4313 "\n"
4314 msgstr ""
4315
4316 # type: textblock
4317 #. type: textblock
4318 #: ../src/guestfs.pod:1991
4319 msgid ""
4320 "This function returns C<NULL> if either no data is found associated with "
4321 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
4322 "C<NULL>."
4323 msgstr ""
4324
4325 #. type: textblock
4326 #: ../src/guestfs.pod:1995
4327 msgid ""
4328 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
4329 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
4330 "all.  In particular, libguestfs does I<not> try to free the data when the "
4331 "handle is closed.  If the data must be freed, then the caller must either "
4332 "free it before calling L</guestfs_close> or must set up a close callback to "
4333 "do it (see L</GUESTFS_EVENT_CLOSE>)."
4334 msgstr ""
4335
4336 #. type: textblock
4337 #: ../src/guestfs.pod:2002
4338 msgid "To walk over all entries, use these two functions:"
4339 msgstr ""
4340
4341 #. type: verbatim
4342 #: ../src/guestfs.pod:2004
4343 #, no-wrap
4344 msgid ""
4345 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
4346 "\n"
4347 msgstr ""
4348
4349 #. type: verbatim
4350 #: ../src/guestfs.pod:2006
4351 #, no-wrap
4352 msgid ""
4353 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
4354 "\n"
4355 msgstr ""
4356
4357 #. type: textblock
4358 #: ../src/guestfs.pod:2008
4359 msgid ""
4360 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
4361 "not have any particular meaning -- keys are not returned in any defined "
4362 "order).  A pointer to the key is returned in C<*key_rtn> and the "
4363 "corresponding data pointer is returned from the function.  C<NULL> is "
4364 "returned if there are no keys stored in the handle."
4365 msgstr ""
4366
4367 #. type: textblock
4368 #: ../src/guestfs.pod:2014
4369 msgid ""
4370 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
4371 "value of this function is also C<NULL> is there are no further entries to "
4372 "return."
4373 msgstr ""
4374
4375 #. type: textblock
4376 #: ../src/guestfs.pod:2018
4377 msgid "Notes about walking over entries:"
4378 msgstr ""
4379
4380 #. type: textblock
4381 #: ../src/guestfs.pod:2024
4382 msgid ""
4383 "You must not call C<guestfs_set_private> while walking over the entries."
4384 msgstr ""
4385
4386 #. type: textblock
4387 #: ../src/guestfs.pod:2029
4388 msgid ""
4389 "The handle maintains an internal iterator which is reset when you call "
4390 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
4391 "call C<guestfs_set_private>."
4392 msgstr ""
4393
4394 #. type: textblock
4395 #: ../src/guestfs.pod:2035
4396 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
4397 msgstr ""
4398
4399 #. type: verbatim
4400 #: ../src/guestfs.pod:2037
4401 #, no-wrap
4402 msgid ""
4403 " guestfs_set_private (g, key, NULL);\n"
4404 "\n"
4405 msgstr ""
4406
4407 #. type: textblock
4408 #: ../src/guestfs.pod:2039
4409 msgid "then that C<key> is not returned when walking."
4410 msgstr ""
4411
4412 #. type: textblock
4413 #: ../src/guestfs.pod:2043
4414 msgid ""
4415 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
4416 "C<guestfs_next_private> or C<guestfs_set_private>."
4417 msgstr ""
4418
4419 #. type: textblock
4420 #: ../src/guestfs.pod:2049
4421 msgid ""
4422 "The following example code shows how to print all keys and data pointers "
4423 "that are associated with the handle C<g>:"
4424 msgstr ""
4425
4426 #. type: verbatim
4427 #: ../src/guestfs.pod:2052
4428 #, no-wrap
4429 msgid ""
4430 " const char *key;\n"
4431 " void *data = guestfs_first_private (g, &key);\n"
4432 " while (data != NULL)\n"
4433 "   {\n"
4434 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
4435 "     data = guestfs_next_private (g, &key);\n"
4436 "   }\n"
4437 "\n"
4438 msgstr ""
4439
4440 #. type: textblock
4441 #: ../src/guestfs.pod:2060
4442 msgid ""
4443 "More commonly you are only interested in keys that begin with an application-"
4444 "specific prefix C<foo_>.  Modify the loop like so:"
4445 msgstr ""
4446
4447 #. type: verbatim
4448 #: ../src/guestfs.pod:2063
4449 #, no-wrap
4450 msgid ""
4451 " const char *key;\n"
4452 " void *data = guestfs_first_private (g, &key);\n"
4453 " while (data != NULL)\n"
4454 "   {\n"
4455 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4456 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
4457 "     data = guestfs_next_private (g, &key);\n"
4458 "   }\n"
4459 "\n"
4460 msgstr ""
4461
4462 #. type: textblock
4463 #: ../src/guestfs.pod:2072
4464 msgid ""
4465 "If you need to modify keys while walking, then you have to jump back to the "
4466 "beginning of the loop.  For example, to delete all keys prefixed with "
4467 "C<foo_>:"
4468 msgstr ""
4469
4470 #. type: verbatim
4471 #: ../src/guestfs.pod:2076
4472 #, no-wrap
4473 msgid ""
4474 "  const char *key;\n"
4475 "  void *data;\n"
4476 " again:\n"
4477 "  data = guestfs_first_private (g, &key);\n"
4478 "  while (data != NULL)\n"
4479 "    {\n"
4480 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4481 "        {\n"
4482 "          guestfs_set_private (g, key, NULL);\n"
4483 "          /* note that 'key' pointer is now invalid, and so is\n"
4484 "             the internal iterator */\n"
4485 "          goto again;\n"
4486 "        }\n"
4487 "      data = guestfs_next_private (g, &key);\n"
4488 "    }\n"
4489 "\n"
4490 msgstr ""
4491
4492 #. type: textblock
4493 #: ../src/guestfs.pod:2092
4494 msgid ""
4495 "Note that the above loop is guaranteed to terminate because the keys are "
4496 "being deleted, but other manipulations of keys within the loop might not "
4497 "terminate unless you also maintain an indication of which keys have been "
4498 "visited."
4499 msgstr ""
4500
4501 # type: =end
4502 #. type: =end
4503 #: ../src/guestfs.pod:2097 ../src/guestfs.pod:2102
4504 msgid "html"
4505 msgstr ""
4506
4507 # type: textblock
4508 #. type: textblock
4509 #: ../src/guestfs.pod:2099
4510 msgid ""
4511 "<!-- old anchor for the next section --> <a name="
4512 "\"state_machine_and_low_level_event_api\"/>"
4513 msgstr ""
4514
4515 # type: =head1
4516 #. type: =head1
4517 #: ../src/guestfs.pod:2104
4518 msgid "ARCHITECTURE"
4519 msgstr ""
4520
4521 # type: textblock
4522 #. type: textblock
4523 #: ../src/guestfs.pod:2106
4524 msgid ""
4525 "Internally, libguestfs is implemented by running an appliance (a special "
4526 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4527 "process of the main program."
4528 msgstr ""
4529
4530 # type: verbatim
4531 #. type: verbatim
4532 #: ../src/guestfs.pod:2110
4533 #, no-wrap
4534 msgid ""
4535 "  ___________________\n"
4536 " /                   \\\n"
4537 " | main program      |\n"
4538 " |                   |\n"
4539 " |                   |           child process / appliance\n"
4540 " |                   |           __________________________\n"
4541 " |                   |          / qemu                     \\\n"
4542 " +-------------------+   RPC    |      +-----------------+ |\n"
4543 " | libguestfs     <--------------------> guestfsd        | |\n"
4544 " |                   |          |      +-----------------+ |\n"
4545 " \\___________________/          |      | Linux kernel    | |\n"
4546 "                                |      +--^--------------+ |\n"
4547 "                                \\_________|________________/\n"
4548 "                                          |\n"
4549 "                                   _______v______\n"
4550 "                                  /              \\\n"
4551 "                                  | Device or    |\n"
4552 "                                  | disk image   |\n"
4553 "                                  \\______________/\n"
4554 "\n"
4555 msgstr ""
4556
4557 # type: textblock
4558 #. type: textblock
4559 #: ../src/guestfs.pod:2130
4560 msgid ""
4561 "The library, linked to the main program, creates the child process and hence "
4562 "the appliance in the L</guestfs_launch> function."
4563 msgstr ""
4564
4565 # type: textblock
4566 #. type: textblock
4567 #: ../src/guestfs.pod:2133
4568 msgid ""
4569 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4570 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4571 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4572 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4573 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4574 "attached to the qemu process which translates device access by the "
4575 "appliance's Linux kernel into accesses to the image."
4576 msgstr ""
4577
4578 # type: textblock
4579 #. type: textblock
4580 #: ../src/guestfs.pod:2142
4581 msgid ""
4582 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4583 "Although the disk image you are attached to might also be used by some "
4584 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4585 "care if both libguestfs's qemu process and your virtual machine are trying "
4586 "to update the disk image at the same time, since these usually results in "
4587 "massive disk corruption)."
4588 msgstr ""
4589
4590 # type: =head1
4591 #. type: =head1
4592 #: ../src/guestfs.pod:2149
4593 msgid "STATE MACHINE"
4594 msgstr ""
4595
4596 # type: textblock
4597 #. type: textblock
4598 #: ../src/guestfs.pod:2151
4599 msgid "libguestfs uses a state machine to model the child process:"
4600 msgstr ""
4601
4602 # type: verbatim
4603 #. type: verbatim
4604 #: ../src/guestfs.pod:2153
4605 #, no-wrap
4606 msgid ""
4607 "                         |\n"
4608 "                    guestfs_create\n"
4609 "                         |\n"
4610 "                         |\n"
4611 "                     ____V_____\n"
4612 "                    /          \\\n"
4613 "                    |  CONFIG  |\n"
4614 "                    \\__________/\n"
4615 "                     ^ ^   ^  \\\n"
4616 "                    /  |    \\  \\ guestfs_launch\n"
4617 "                   /   |    _\\__V______\n"
4618 "                  /    |   /           \\\n"
4619 "                 /     |   | LAUNCHING |\n"
4620 "                /      |   \\___________/\n"
4621 "               /       |       /\n"
4622 "              /        |  guestfs_launch\n"
4623 "             /         |     /\n"
4624 "    ______  /        __|____V\n"
4625 "   /      \\ ------> /        \\\n"
4626 "   | BUSY |         | READY  |\n"
4627 "   \\______/ <------ \\________/\n"
4628 "\n"
4629 msgstr ""
4630
4631 # type: textblock
4632 #. type: textblock
4633 #: ../src/guestfs.pod:2175
4634 msgid ""
4635 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4636 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4637 "(3) alternating between READY and BUSY as commands are issued to, and "
4638 "carried out by, the child process."
4639 msgstr ""
4640
4641 # type: textblock
4642 #. type: textblock
4643 #: ../src/guestfs.pod:2180
4644 msgid ""
4645 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4646 "asynchronously at any time (eg. due to some internal error), and that causes "
4647 "the state to transition back to CONFIG."
4648 msgstr ""
4649
4650 # type: textblock
4651 #. type: textblock
4652 #: ../src/guestfs.pod:2184
4653 msgid ""
4654 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4655 "issued when in the CONFIG state."
4656 msgstr ""
4657
4658 # type: textblock
4659 #. type: textblock
4660 #: ../src/guestfs.pod:2187
4661 msgid ""
4662 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4663 "L</guestfs_launch> blocks until the child process is READY to accept "
4664 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4665 "moves the state from CONFIG to LAUNCHING while it is running."
4666 msgstr ""
4667
4668 # type: textblock
4669 #. type: textblock
4670 #: ../src/guestfs.pod:2193
4671 msgid ""
4672 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4673 "state.  These API calls block waiting for the command to be carried out (ie. "
4674 "the state to transition to BUSY and then back to READY).  There are no non-"
4675 "blocking versions, and no way to issue more than one command per handle at "
4676 "the same time."
4677 msgstr ""
4678
4679 # type: textblock
4680 #. type: textblock
4681 #: ../src/guestfs.pod:2199
4682 msgid ""
4683 "Finally, the child process sends asynchronous messages back to the main "
4684 "program, such as kernel log messages.  You can register a callback to "
4685 "receive these messages."
4686 msgstr ""
4687
4688 # type: =head1
4689 #. type: =head1
4690 #: ../src/guestfs.pod:2203
4691 msgid "INTERNALS"
4692 msgstr ""
4693
4694 # type: =head2
4695 #. type: =head2
4696 #: ../src/guestfs.pod:2205
4697 msgid "COMMUNICATION PROTOCOL"
4698 msgstr ""
4699
4700 # type: textblock
4701 #. type: textblock
4702 #: ../src/guestfs.pod:2207
4703 msgid ""
4704 "Don't rely on using this protocol directly.  This section documents how it "
4705 "currently works, but it may change at any time."
4706 msgstr ""
4707
4708 # type: textblock
4709 #. type: textblock
4710 #: ../src/guestfs.pod:2210
4711 msgid ""
4712 "The protocol used to talk between the library and the daemon running inside "
4713 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4714 "1014, RFC 1832, RFC 4506)."
4715 msgstr ""
4716
4717 # type: textblock
4718 #. type: textblock
4719 #: ../src/guestfs.pod:2214
4720 msgid ""
4721 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4722 "this file is automatically generated)."
4723 msgstr ""
4724
4725 # type: textblock
4726 #. type: textblock
4727 #: ../src/guestfs.pod:2217
4728 msgid ""
4729 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4730 "and C<FileOut> parameters, which are handled with very simple request/reply "
4731 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4732 "parameters, which use the same request and reply messages, but they may also "
4733 "be followed by files sent using a chunked encoding."
4734 msgstr ""
4735
4736 # type: =head3
4737 #. type: =head3
4738 #: ../src/guestfs.pod:2224
4739 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4740 msgstr ""
4741
4742 # type: textblock
4743 #. type: textblock
4744 #: ../src/guestfs.pod:2226
4745 msgid "For ordinary functions, the request message is:"
4746 msgstr ""
4747
4748 # type: verbatim
4749 #. type: verbatim
4750 #: ../src/guestfs.pod:2228
4751 #, no-wrap
4752 msgid ""
4753 " total length (header + arguments,\n"
4754 "      but not including the length word itself)\n"
4755 " struct guestfs_message_header (encoded as XDR)\n"
4756 " struct guestfs_<foo>_args (encoded as XDR)\n"
4757 "\n"
4758 msgstr ""
4759
4760 # type: textblock
4761 #. type: textblock
4762 #: ../src/guestfs.pod:2233
4763 msgid ""
4764 "The total length field allows the daemon to allocate a fixed size buffer "
4765 "into which it slurps the rest of the message.  As a result, the total length "
4766 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4767 "effective size of any request is limited to somewhere under this size."
4768 msgstr ""
4769
4770 # type: textblock
4771 #. type: textblock
4772 #: ../src/guestfs.pod:2239
4773 msgid ""
4774 "Note also that many functions don't take any arguments, in which case the "
4775 "C<guestfs_I<foo>_args> is completely omitted."
4776 msgstr ""
4777
4778 # type: textblock
4779 #. type: textblock
4780 #: ../src/guestfs.pod:2242
4781 msgid ""
4782 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4783 "receiver knows what type of args structure to expect, or none at all."
4784 msgstr ""
4785
4786 # type: textblock
4787 #. type: textblock
4788 #: ../src/guestfs.pod:2246
4789 msgid ""
4790 "For functions that take optional arguments, the optional arguments are "
4791 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4792 "arguments.  A bitmask in the header indicates which optional arguments are "
4793 "meaningful.  The bitmask is also checked to see if it contains bits set "
4794 "which the daemon does not know about (eg. if more optional arguments were "
4795 "added in a later version of the library), and this causes the call to be "
4796 "rejected."
4797 msgstr ""
4798
4799 # type: textblock
4800 #. type: textblock
4801 #: ../src/guestfs.pod:2254
4802 msgid "The reply message for ordinary functions is:"
4803 msgstr ""
4804
4805 # type: verbatim
4806 #. type: verbatim
4807 #: ../src/guestfs.pod:2256
4808 #, no-wrap
4809 msgid ""
4810 " total length (header + ret,\n"
4811 "      but not including the length word itself)\n"
4812 " struct guestfs_message_header (encoded as XDR)\n"
4813 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4814 "\n"
4815 msgstr ""
4816
4817 # type: textblock
4818 #. type: textblock
4819 #: ../src/guestfs.pod:2261
4820 msgid ""
4821 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4822 "functions that return no formal return values."
4823 msgstr ""
4824
4825 # type: textblock
4826 #. type: textblock
4827 #: ../src/guestfs.pod:2264
4828 msgid ""
4829 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4830 msgstr ""
4831
4832 # type: textblock
4833 #. type: textblock
4834 #: ../src/guestfs.pod:2267
4835 msgid ""
4836 "In the case of an error, a flag is set in the header, and the reply message "
4837 "is slightly changed:"
4838 msgstr ""
4839
4840 # type: verbatim
4841 #. type: verbatim
4842 #: ../src/guestfs.pod:2270
4843 #, no-wrap
4844 msgid ""
4845 " total length (header + error,\n"
4846 "      but not including the length word itself)\n"
4847 " struct guestfs_message_header (encoded as XDR)\n"
4848 " struct guestfs_message_error (encoded as XDR)\n"
4849 "\n"
4850 msgstr ""
4851
4852 # type: textblock
4853 #. type: textblock
4854 #: ../src/guestfs.pod:2275
4855 msgid ""
4856 "The C<guestfs_message_error> structure contains the error message as a "
4857 "string."
4858 msgstr ""
4859
4860 # type: =head3
4861 #. type: =head3
4862 #: ../src/guestfs.pod:2278
4863 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4864 msgstr ""
4865
4866 # type: textblock
4867 #. type: textblock
4868 #: ../src/guestfs.pod:2280
4869 msgid ""
4870 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4871 "The normal request message is sent (see above).  However this is followed by "
4872 "a sequence of file chunks."
4873 msgstr ""
4874
4875 # type: verbatim
4876 #. type: verbatim
4877 #: ../src/guestfs.pod:2284
4878 #, no-wrap
4879 msgid ""
4880 " total length (header + arguments,\n"
4881 "      but not including the length word itself,\n"
4882 "      and not including the chunks)\n"
4883 " struct guestfs_message_header (encoded as XDR)\n"
4884 " struct guestfs_<foo>_args (encoded as XDR)\n"
4885 " sequence of chunks for FileIn param #0\n"
4886 " sequence of chunks for FileIn param #1 etc.\n"
4887 "\n"
4888 msgstr ""
4889
4890 # type: textblock
4891 #. type: textblock
4892 #: ../src/guestfs.pod:2292
4893 msgid "The \"sequence of chunks\" is:"
4894 msgstr ""
4895
4896 # type: verbatim
4897 #. type: verbatim
4898 #: ../src/guestfs.pod:2294
4899 #, no-wrap
4900 msgid ""
4901 " length of chunk (not including length word itself)\n"
4902 " struct guestfs_chunk (encoded as XDR)\n"
4903 " length of chunk\n"
4904 " struct guestfs_chunk (encoded as XDR)\n"
4905 "   ...\n"
4906 " length of chunk\n"
4907 " struct guestfs_chunk (with data.data_len == 0)\n"
4908 "\n"
4909 msgstr ""
4910
4911 # type: textblock
4912 #. type: textblock
4913 #: ../src/guestfs.pod:2302
4914 msgid ""
4915 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4916 "is set in the final chunk to indicate either successful completion or early "
4917 "cancellation."
4918 msgstr ""
4919
4920 # type: textblock
4921 #. type: textblock
4922 #: ../src/guestfs.pod:2306
4923 msgid ""
4924 "At time of writing there are no functions that have more than one FileIn "
4925 "parameter.  However this is (theoretically) supported, by sending the "
4926 "sequence of chunks for each FileIn parameter one after another (from left to "
4927 "right)."
4928 msgstr ""
4929
4930 # type: textblock
4931 #. type: textblock
4932 #: ../src/guestfs.pod:2311
4933 msgid ""
4934 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4935 "transfer.  The library does this by sending a chunk with a special flag set "
4936 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4937 "RPC, does I<not> send any reply, and goes back to reading the next request."
4938 msgstr ""
4939
4940 # type: textblock
4941 #. type: textblock
4942 #: ../src/guestfs.pod:2317
4943 msgid ""
4944 "The daemon may also cancel.  It does this by writing a special word "
4945 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4946 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4947 "cancel chunk).  The special word is chosen so that even if cancellation "
4948 "happens right at the end of the transfer (after the library has finished "
4949 "writing and has started listening for the reply), the \"spurious\" cancel "
4950 "flag will not be confused with the reply message."
4951 msgstr ""
4952
4953 # type: textblock
4954 #. type: textblock
4955 #: ../src/guestfs.pod:2326
4956 msgid ""
4957 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4958 "limit), and also files where the size is not known in advance (eg. from "
4959 "pipes or sockets).  However the chunks are rather small "
4960 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4961 "to keep much in memory."
4962 msgstr ""
4963
4964 # type: =head3
4965 #. type: =head3
4966 #: ../src/guestfs.pod:2332
4967 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4968 msgstr ""
4969
4970 # type: textblock
4971 #. type: textblock
4972 #: ../src/guestfs.pod:2334
4973 msgid ""
4974 "The protocol for FileOut parameters is exactly the same as for FileIn "
4975 "parameters, but with the roles of daemon and library reversed."
4976 msgstr ""
4977
4978 # type: verbatim
4979 #. type: verbatim
4980 #: ../src/guestfs.pod:2337
4981 #, no-wrap
4982 msgid ""
4983 " total length (header + ret,\n"
4984 "      but not including the length word itself,\n"
4985 "      and not including the chunks)\n"
4986 " struct guestfs_message_header (encoded as XDR)\n"
4987 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4988 " sequence of chunks for FileOut param #0\n"
4989 " sequence of chunks for FileOut param #1 etc.\n"
4990 "\n"
4991 msgstr ""
4992
4993 # type: =head3
4994 #. type: =head3
4995 #: ../src/guestfs.pod:2345
4996 msgid "INITIAL MESSAGE"
4997 msgstr ""
4998
4999 # type: textblock
5000 #. type: textblock
5001 #: ../src/guestfs.pod:2347
5002 msgid ""
5003 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
5004 "which indicates that the guest and daemon is alive.  This is what L</"
5005 "guestfs_launch> waits for."
5006 msgstr ""
5007
5008 # type: =head3
5009 #. type: =head3
5010 #: ../src/guestfs.pod:2351
5011 msgid "PROGRESS NOTIFICATION MESSAGES"
5012 msgstr ""
5013
5014 # type: textblock
5015 #. type: textblock
5016 #: ../src/guestfs.pod:2353
5017 msgid ""
5018 "The daemon may send progress notification messages at any time.  These are "
5019 "distinguished by the normal length word being replaced by "
5020 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
5021 msgstr ""
5022
5023 #. type: textblock
5024 #: ../src/guestfs.pod:2357
5025 msgid ""
5026 "The library turns them into progress callbacks (see L</"
5027 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
5028 "if not."
5029 msgstr ""
5030
5031 # type: textblock
5032 #. type: textblock
5033 #: ../src/guestfs.pod:2361
5034 msgid ""
5035 "The daemon self-limits the frequency of progress messages it sends (see "
5036 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
5037 "messages."
5038 msgstr ""
5039
5040 # type: =head1
5041 #. type: =head1
5042 #: ../src/guestfs.pod:2365
5043 msgid "LIBGUESTFS VERSION NUMBERS"
5044 msgstr ""
5045
5046 # type: textblock
5047 #. type: textblock
5048 #: ../src/guestfs.pod:2367
5049 msgid ""
5050 "Since April 2010, libguestfs has started to make separate development and "
5051 "stable releases, along with corresponding branches in our git repository.  "
5052 "These separate releases can be identified by version number:"
5053 msgstr ""
5054
5055 # type: verbatim
5056 #. type: verbatim
5057 #: ../src/guestfs.pod:2372
5058 #, no-wrap
5059 msgid ""
5060 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
5061 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
5062 "       |\n"
5063 "       v\n"
5064 " 1  .  3  .  5\n"
5065 " ^           ^\n"
5066 " |           |\n"
5067 " |           `-------- sub-version\n"
5068 " |\n"
5069 " `------ always '1' because we don't change the ABI\n"
5070 "\n"
5071 msgstr ""
5072
5073 # type: textblock
5074 #. type: textblock
5075 #: ../src/guestfs.pod:2383
5076 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
5077 msgstr ""
5078
5079 # type: textblock
5080 #. type: textblock
5081 #: ../src/guestfs.pod:2385
5082 msgid ""
5083 "As time passes we cherry pick fixes from the development branch and backport "
5084 "those into the stable branch, the effect being that the stable branch should "
5085 "get more stable and less buggy over time.  So the stable releases are ideal "
5086 "for people who don't need new features but would just like the software to "
5087 "work."
5088 msgstr ""
5089
5090 # type: textblock
5091 #. type: textblock
5092 #: ../src/guestfs.pod:2391
5093 msgid "Our criteria for backporting changes are:"
5094 msgstr ""
5095
5096 # type: textblock
5097 #. type: textblock
5098 #: ../src/guestfs.pod:2397
5099 msgid ""
5100 "Documentation changes which don't affect any code are backported unless the "
5101 "documentation refers to a future feature which is not in stable."
5102 msgstr ""
5103
5104 # type: textblock
5105 #. type: textblock
5106 #: ../src/guestfs.pod:2403
5107 msgid ""
5108 "Bug fixes which are not controversial, fix obvious problems, and have been "
5109 "well tested are backported."
5110 msgstr ""
5111
5112 # type: textblock
5113 #. type: textblock
5114 #: ../src/guestfs.pod:2408
5115 msgid ""
5116 "Simple rearrangements of code which shouldn't affect how it works get "
5117 "backported.  This is so that the code in the two branches doesn't get too "
5118 "far out of step, allowing us to backport future fixes more easily."
5119 msgstr ""
5120
5121 # type: textblock
5122 #. type: textblock
5123 #: ../src/guestfs.pod:2414
5124 msgid ""
5125 "We I<don't> backport new features, new APIs, new tools etc, except in one "
5126 "exceptional case: the new feature is required in order to implement an "
5127 "important bug fix."
5128 msgstr ""
5129
5130 # type: textblock
5131 #. type: textblock
5132 #: ../src/guestfs.pod:2420
5133 msgid ""
5134 "A new stable branch starts when we think the new features in development are "
5135 "substantial and compelling enough over the current stable branch to warrant "
5136 "it.  When that happens we create new stable and development versions 1.N.0 "
5137 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
5138 "stable at this point, but by backporting fixes from development, that branch "
5139 "will stabilize over time."
5140 msgstr ""
5141
5142 #. type: =head1
5143 #: ../src/guestfs.pod:2428
5144 msgid "EXTENDING LIBGUESTFS"
5145 msgstr ""
5146
5147 #. type: =head2
5148 #: ../src/guestfs.pod:2430
5149 msgid "ADDING A NEW API ACTION"
5150 msgstr ""
5151
5152 #. type: textblock
5153 #: ../src/guestfs.pod:2432
5154 msgid ""
5155 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
5156 "documentation) are generated, and this makes it easy to extend the "
5157 "libguestfs API."
5158 msgstr ""
5159
5160 #. type: textblock
5161 #: ../src/guestfs.pod:2436
5162 msgid "To add a new API action there are two changes:"
5163 msgstr ""
5164
5165 #. type: textblock
5166 #: ../src/guestfs.pod:2442
5167 msgid ""
5168 "You need to add a description of the call (name, parameters, return type, "
5169 "tests, documentation) to C<generator/generator_actions.ml>."
5170 msgstr ""
5171
5172 #. type: textblock
5173 #: ../src/guestfs.pod:2445
5174 msgid ""
5175 "There are two sorts of API action, depending on whether the call goes "
5176 "through to the daemon in the appliance, or is serviced entirely by the "
5177 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
5178 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
5179 "an example of the latter, since a trace flag is maintained in the handle and "
5180 "all tracing is done on the library side."
5181 msgstr ""
5182
5183 #. type: textblock
5184 #: ../src/guestfs.pod:2453
5185 msgid ""
5186 "Most new actions are of the first type, and get added to the "
5187 "C<daemon_functions> list.  Each function has a unique procedure number used "
5188 "in the RPC protocol which is assigned to that action when we publish "
5189 "libguestfs and cannot be reused.  Take the latest procedure number and "
5190 "increment it."
5191 msgstr ""
5192
5193 #. type: textblock
5194 #: ../src/guestfs.pod:2459
5195 msgid ""
5196 "For library-only actions of the second type, add to the "
5197 "C<non_daemon_functions> list.  Since these functions are serviced by the "
5198 "library and do not travel over the RPC mechanism to the daemon, these "
5199 "functions do not need a procedure number, and so the procedure number is set "
5200 "to C<-1>."
5201 msgstr ""
5202
5203 #. type: textblock
5204 #: ../src/guestfs.pod:2467
5205 msgid "Implement the action (in C):"
5206 msgstr ""
5207
5208 #. type: textblock
5209 #: ../src/guestfs.pod:2469
5210 msgid ""
5211 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
5212 "C<daemon/> directory."
5213 msgstr ""
5214
5215 #. type: textblock
5216 #: ../src/guestfs.pod:2472
5217 msgid ""
5218 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
5219 "(note: double underscore) in the C<src/> directory."
5220 msgstr ""
5221
5222 #. type: textblock
5223 #: ../src/guestfs.pod:2475
5224 msgid "In either case, use another function as an example of what to do."
5225 msgstr ""
5226
5227 #. type: textblock
5228 #: ../src/guestfs.pod:2479
5229 msgid "After making these changes, use C<make> to compile."
5230 msgstr ""
5231
5232 #. type: textblock
5233 #: ../src/guestfs.pod:2481
5234 msgid ""
5235 "Note that you don't need to implement the RPC, language bindings, manual "
5236 "pages or anything else.  It's all automatically generated from the OCaml "
5237 "description."
5238 msgstr ""
5239
5240 #. type: =head2
5241 #: ../src/guestfs.pod:2485
5242 msgid "ADDING TESTS FOR AN API ACTION"
5243 msgstr ""
5244
5245 #. type: textblock
5246 #: ../src/guestfs.pod:2487
5247 msgid ""
5248 "You can supply zero or as many tests as you want per API call.  The tests "
5249 "can either be added as part of the API description (C<generator/"
5250 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
5251 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
5252 "slower, so if possible use the first method."
5253 msgstr ""
5254
5255 #. type: textblock
5256 #: ../src/guestfs.pod:2493
5257 msgid ""
5258 "The following describes the test environment used when you add an API test "
5259 "in C<generator_actions.ml>."
5260 msgstr ""
5261
5262 #. type: textblock
5263 #: ../src/guestfs.pod:2496
5264 msgid "The test environment has 4 block devices:"
5265 msgstr ""
5266
5267 #. type: =item
5268 #: ../src/guestfs.pod:2500
5269 msgid "C</dev/sda> 500MB"
5270 msgstr ""
5271
5272 #. type: textblock
5273 #: ../src/guestfs.pod:2502
5274 msgid "General block device for testing."
5275 msgstr ""
5276
5277 #. type: =item
5278 #: ../src/guestfs.pod:2504
5279 msgid "C</dev/sdb> 50MB"
5280 msgstr ""
5281
5282 #. type: textblock
5283 #: ../src/guestfs.pod:2506
5284 msgid ""
5285 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
5286 "operations."
5287 msgstr ""
5288
5289 #. type: =item
5290 #: ../src/guestfs.pod:2509
5291 msgid "C</dev/sdc> 10MB"
5292 msgstr ""
5293
5294 #. type: textblock
5295 #: ../src/guestfs.pod:2511
5296 msgid "Used in a few tests where two block devices are needed."
5297 msgstr ""
5298
5299 #. type: =item
5300 #: ../src/guestfs.pod:2513
5301 msgid "C</dev/sdd>"
5302 msgstr ""
5303
5304 #. type: textblock
5305 #: ../src/guestfs.pod:2515
5306 msgid "ISO with fixed content (see C<images/test.iso>)."
5307 msgstr ""
5308
5309 #. type: textblock
5310 #: ../src/guestfs.pod:2519
5311 msgid ""
5312 "To be able to run the tests in a reasonable amount of time, the libguestfs "
5313 "appliance and block devices are reused between tests.  So don't try testing "
5314 "L</guestfs_kill_subprocess> :-x"
5315 msgstr ""
5316
5317 #. type: textblock
5318 #: ../src/guestfs.pod:2523
5319 msgid ""
5320 "Each test starts with an initial scenario, selected using one of the "
5321 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
5322 "initialize the disks mentioned above in a particular way as documented in "
5323 "C<generator_types.ml>.  You should not assume anything about the previous "
5324 "contents of other disks that are not initialized."
5325 msgstr ""
5326
5327 #. type: textblock
5328 #: ../src/guestfs.pod:2529
5329 msgid ""
5330 "You can add a prerequisite clause to any individual test.  This is a run-"
5331 "time check, which, if it fails, causes the test to be skipped.  Useful if "
5332 "testing a command which might not work on all variations of libguestfs "
5333 "builds.  A test that has prerequisite of C<Always> means to run "
5334 "unconditionally."
5335 msgstr ""
5336
5337 #. type: textblock
5338 #: ../src/guestfs.pod:2535
5339 msgid ""
5340 "In addition, packagers can skip individual tests by setting environment "
5341 "variables before running C<make check>."
5342 msgstr ""
5343
5344 #. type: verbatim
5345 #: ../src/guestfs.pod:2538
5346 #, no-wrap
5347 msgid ""
5348 " SKIP_TEST_<CMD>_<NUM>=1\n"
5349 "\n"
5350 msgstr ""
5351
5352 #. type: textblock
5353 #: ../src/guestfs.pod:2540
5354 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
5355 msgstr ""
5356
5357 #. type: textblock
5358 #: ../src/guestfs.pod:2542
5359 msgid "or:"
5360 msgstr ""
5361
5362 #. type: verbatim
5363 #: ../src/guestfs.pod:2544
5364 #, no-wrap
5365 msgid ""
5366 " SKIP_TEST_<CMD>=1\n"
5367 "\n"
5368 msgstr ""
5369
5370 #. type: textblock
5371 #: ../src/guestfs.pod:2546
5372 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
5373 msgstr ""
5374
5375 #. type: textblock
5376 #: ../src/guestfs.pod:2548
5377 msgid "Packagers can run only certain tests by setting for example:"
5378 msgstr ""
5379
5380 #. type: verbatim
5381 #: ../src/guestfs.pod:2550
5382 #, no-wrap
5383 msgid ""
5384 " TEST_ONLY=\"vfs_type zerofree\"\n"
5385 "\n"
5386 msgstr ""
5387
5388 #. type: textblock
5389 #: ../src/guestfs.pod:2552
5390 msgid ""
5391 "See C<capitests/tests.c> for more details of how these environment variables "
5392 "work."
5393 msgstr ""
5394
5395 #. type: =head2
5396 #: ../src/guestfs.pod:2555
5397 msgid "DEBUGGING NEW API ACTIONS"
5398 msgstr ""
5399
5400 #. type: textblock
5401 #: ../src/guestfs.pod:2557
5402 msgid "Test new actions work before submitting them."
5403 msgstr ""
5404
5405 #. type: textblock
5406 #: ../src/guestfs.pod:2559
5407 msgid "You can use guestfish to try out new commands."
5408 msgstr ""
5409
5410 #. type: textblock
5411 #: ../src/guestfs.pod:2561
5412 msgid ""
5413 "Debugging the daemon is a problem because it runs inside a minimal "
5414 "environment.  However you can fprintf messages in the daemon to stderr, and "
5415 "they will show up if you use C<guestfish -v>."
5416 msgstr ""
5417
5418 #. type: =head2
5419 #: ../src/guestfs.pod:2565
5420 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
5421 msgstr ""
5422
5423 #. type: textblock
5424 #: ../src/guestfs.pod:2567
5425 msgid ""
5426 "Our C source code generally adheres to some basic code-formatting "
5427 "conventions.  The existing code base is not totally consistent on this "
5428 "front, but we do prefer that contributed code be formatted similarly.  In "
5429 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
5430 "indentation level, and other than that, follow the K&R style."
5431 msgstr ""
5432
5433 #. type: textblock
5434 #: ../src/guestfs.pod:2573
5435 msgid ""
5436 "If you use Emacs, add the following to one of one of your start-up files (e."
5437 "g., ~/.emacs), to help ensure that you get indentation right:"
5438 msgstr ""
5439
5440 #. type: verbatim
5441 #: ../src/guestfs.pod:2576
5442 #, no-wrap
5443 msgid ""
5444 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
5445 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
5446 " (add-hook 'find-file-hook\n"
5447 "     '(lambda () (if (and buffer-file-name\n"
5448 "                          (string-match \"/libguestfs\\\\>\"\n"
5449 "                              (buffer-file-name))\n"
5450 "                          (not (string-equal mode-name \"Change Log\"))\n"
5451 "                          (not (string-equal mode-name \"Makefile\")))\n"
5452 "                     (setq indent-tabs-mode nil))))\n"
5453 " \n"
5454 msgstr ""
5455
5456 #. type: verbatim
5457 #: ../src/guestfs.pod:2586
5458 #, no-wrap
5459 msgid ""
5460 " ;;; When editing C sources in libguestfs, use this style.\n"
5461 " (defun libguestfs-c-mode ()\n"
5462 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
5463 "   (interactive)\n"
5464 "   (c-set-style \"K&R\")\n"
5465 "   (setq c-indent-level 2)\n"
5466 "   (setq c-basic-offset 2))\n"
5467 " (add-hook 'c-mode-hook\n"
5468 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
5469 "                               (buffer-file-name))\n"
5470 "                           (libguestfs-c-mode))))\n"
5471 "\n"
5472 msgstr ""
5473
5474 #. type: textblock
5475 #: ../src/guestfs.pod:2598
5476 msgid "Enable warnings when compiling (and fix any problems this finds):"
5477 msgstr ""
5478
5479 #. type: verbatim
5480 #: ../src/guestfs.pod:2601
5481 #, no-wrap
5482 msgid ""
5483 " ./configure --enable-gcc-warnings\n"
5484 "\n"
5485 msgstr ""
5486
5487 #. type: textblock
5488 #: ../src/guestfs.pod:2603
5489 msgid "Useful targets are:"
5490 msgstr ""
5491
5492 #. type: verbatim
5493 #: ../src/guestfs.pod:2605
5494 #, no-wrap
5495 msgid ""
5496 " make syntax-check  # checks the syntax of the C code\n"
5497 " make check         # runs the test suite\n"
5498 "\n"
5499 msgstr ""
5500
5501 #. type: =head2
5502 #: ../src/guestfs.pod:2608
5503 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
5504 msgstr ""
5505
5506 #. type: textblock
5507 #: ../src/guestfs.pod:2610
5508 msgid ""
5509 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
5510 "which are used to do shell quoting."
5511 msgstr ""
5512
5513 #. type: =item
5514 #: ../src/guestfs.pod:2615
5515 msgid "%Q"
5516 msgstr ""
5517
5518 #. type: textblock
5519 #: ../src/guestfs.pod:2617
5520 msgid ""
5521 "Simple shell quoted string.  Any spaces or other shell characters are "
5522 "escaped for you."
5523 msgstr ""
5524
5525 #. type: =item
5526 #: ../src/guestfs.pod:2620
5527 msgid "%R"
5528 msgstr ""
5529
5530 #. type: textblock
5531 #: ../src/guestfs.pod:2622
5532 msgid ""
5533 "Same as C<%Q> except the string is treated as a path which is prefixed by "
5534 "the sysroot."
5535 msgstr ""
5536
5537 # type: textblock
5538 #. type: textblock
5539 #: ../src/guestfs.pod:2627 ../fish/guestfish.pod:240 ../fish/guestfish.pod:613
5540 msgid "For example:"
5541 msgstr ""
5542
5543 #. type: verbatim
5544 #: ../src/guestfs.pod:2629
5545 #, no-wrap
5546 msgid ""
5547 " asprintf (&cmd, \"cat %R\", path);\n"
5548 "\n"
5549 msgstr ""
5550
5551 #. type: textblock
5552 #: ../src/guestfs.pod:2631
5553 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5554 msgstr ""
5555
5556 #. type: textblock
5557 #: ../src/guestfs.pod:2633
5558 msgid ""
5559 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5560 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5561 "they are not passed via the shell (instead, straight to exec).  You probably "
5562 "want to use the C<sysroot_path()> function however."
5563 msgstr ""
5564
5565 #. type: =head2
5566 #: ../src/guestfs.pod:2639
5567 msgid "SUBMITTING YOUR NEW API ACTIONS"
5568 msgstr ""
5569
5570 #. type: textblock
5571 #: ../src/guestfs.pod:2641
5572 msgid ""
5573 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5574 "libguestfs> and CC to L<rjones@redhat.com>."
5575 msgstr ""
5576
5577 #. type: =head2
5578 #: ../src/guestfs.pod:2645
5579 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5580 msgstr ""
5581
5582 #. type: textblock
5583 #: ../src/guestfs.pod:2647
5584 msgid "We support i18n (gettext anyhow) in the library."
5585 msgstr ""
5586
5587 #. type: textblock
5588 #: ../src/guestfs.pod:2649
5589 msgid ""
5590 "However many messages come from the daemon, and we don't translate those at "
5591 "the moment.  One reason is that the appliance generally has all locale files "
5592 "removed from it, because they take up a lot of space.  So we'd have to readd "
5593 "some of those, as well as copying our PO files into the appliance."
5594 msgstr ""
5595
5596 #. type: textblock
5597 #: ../src/guestfs.pod:2655
5598 msgid ""
5599 "Debugging messages are never translated, since they are intended for the "
5600 "programmers."
5601 msgstr ""
5602
5603 #. type: =head2
5604 #: ../src/guestfs.pod:2658
5605 msgid "SOURCE CODE SUBDIRECTORIES"
5606 msgstr ""
5607
5608 #. type: =item
5609 #: ../src/guestfs.pod:2662 ../src/guestfs-actions.pod:5814
5610 #: ../fish/guestfish-actions.pod:3908
5611 msgid "C<appliance>"
5612 msgstr ""
5613
5614 #. type: textblock
5615 #: ../src/guestfs.pod:2664
5616 msgid "The libguestfs appliance, build scripts and so on."
5617 msgstr ""
5618
5619 #. type: =item
5620 #: ../src/guestfs.pod:2666
5621 msgid "C<capitests>"
5622 msgstr ""
5623
5624 #. type: textblock
5625 #: ../src/guestfs.pod:2668
5626 msgid "Automated tests of the C API."
5627 msgstr ""
5628
5629 #. type: =item
5630 #: ../src/guestfs.pod:2670
5631 msgid "C<cat>"
5632 msgstr ""
5633
5634 #. type: textblock
5635 #: ../src/guestfs.pod:2672
5636 msgid ""
5637 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5638 "documentation."
5639 msgstr ""
5640
5641 #. type: =item
5642 #: ../src/guestfs.pod:2675
5643 msgid "C<contrib>"
5644 msgstr ""
5645
5646 #. type: textblock
5647 #: ../src/guestfs.pod:2677
5648 msgid "Outside contributions, experimental parts."
5649 msgstr ""
5650
5651 #. type: =item
5652 #: ../src/guestfs.pod:2679
5653 msgid "C<daemon>"
5654 msgstr ""
5655
5656 #. type: textblock
5657 #: ../src/guestfs.pod:2681
5658 msgid ""
5659 "The daemon that runs inside the libguestfs appliance and carries out actions."
5660 msgstr ""
5661
5662 #. type: =item
5663 #: ../src/guestfs.pod:2684
5664 msgid "C<df>"
5665 msgstr ""
5666
5667 #. type: textblock
5668 #: ../src/guestfs.pod:2686
5669 msgid "L<virt-df(1)> command and documentation."
5670 msgstr ""
5671
5672 #. type: =item
5673 #: ../src/guestfs.pod:2688
5674 msgid "C<examples>"
5675 msgstr ""
5676
5677 #. type: textblock
5678 #: ../src/guestfs.pod:2690
5679 msgid "C API example code."
5680 msgstr ""
5681
5682 #. type: =item
5683 #: ../src/guestfs.pod:2692
5684 msgid "C<fish>"
5685 msgstr ""
5686
5687 #. type: textblock
5688 #: ../src/guestfs.pod:2694
5689 msgid ""
5690 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5691 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5692 "L<virt-tar-out(1)>."
5693 msgstr ""
5694
5695 #. type: =item
5696 #: ../src/guestfs.pod:2698
5697 msgid "C<fuse>"
5698 msgstr ""
5699
5700 #. type: textblock
5701 #: ../src/guestfs.pod:2700
5702 msgid ""
5703 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5704 msgstr ""
5705
5706 #. type: =item
5707 #: ../src/guestfs.pod:2702
5708 msgid "C<generator>"
5709 msgstr ""
5710
5711 #. type: textblock
5712 #: ../src/guestfs.pod:2704
5713 msgid ""
5714 "The crucially important generator, used to automatically generate large "
5715 "amounts of boilerplate C code for things like RPC and bindings."
5716 msgstr ""
5717
5718 #. type: =item
5719 #: ../src/guestfs.pod:2707
5720 msgid "C<images>"
5721 msgstr ""
5722
5723 #. type: textblock
5724 #: ../src/guestfs.pod:2709
5725 msgid "Files used by the test suite."
5726 msgstr ""
5727
5728 #. type: textblock
5729 #: ../src/guestfs.pod:2711
5730 msgid "Some \"phony\" guest images which we test against."
5731 msgstr ""
5732
5733 #. type: =item
5734 #: ../src/guestfs.pod:2713
5735 msgid "C<inspector>"
5736 msgstr ""
5737
5738 #. type: textblock
5739 #: ../src/guestfs.pod:2715
5740 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5741 msgstr ""
5742
5743 #. type: =item
5744 #: ../src/guestfs.pod:2717
5745 msgid "C<logo>"
5746 msgstr ""
5747
5748 #. type: textblock
5749 #: ../src/guestfs.pod:2719
5750 msgid "Logo used on the website.  The fish is called Arthur by the way."
5751 msgstr ""
5752
5753 #. type: =item
5754 #: ../src/guestfs.pod:2721
5755 msgid "C<m4>"
5756 msgstr ""
5757
5758 #. type: textblock
5759 #: ../src/guestfs.pod:2723
5760 msgid "M4 macros used by autoconf."
5761 msgstr ""
5762
5763 #. type: =item
5764 #: ../src/guestfs.pod:2725
5765 msgid "C<po>"
5766 msgstr ""
5767
5768 #. type: textblock
5769 #: ../src/guestfs.pod:2727
5770 msgid "Translations of simple gettext strings."
5771 msgstr ""
5772
5773 #. type: =item
5774 #: ../src/guestfs.pod:2729
5775 msgid "C<po-docs>"
5776 msgstr ""
5777
5778 #. type: textblock
5779 #: ../src/guestfs.pod:2731
5780 msgid ""
5781 "The build infrastructure and PO files for translations of manpages and POD "
5782 "files.  Eventually this will be combined with the C<po> directory, but that "
5783 "is rather complicated."
5784 msgstr ""
5785
5786 #. type: =item
5787 #: ../src/guestfs.pod:2735
5788 msgid "C<regressions>"
5789 msgstr ""
5790
5791 #. type: textblock
5792 #: ../src/guestfs.pod:2737
5793 msgid "Regression tests."
5794 msgstr ""
5795
5796 #. type: =item
5797 #: ../src/guestfs.pod:2739
5798 msgid "C<rescue>"
5799 msgstr ""
5800
5801 #. type: textblock
5802 #: ../src/guestfs.pod:2741
5803 msgid "L<virt-rescue(1)> command and documentation."
5804 msgstr ""
5805
5806 #. type: =item
5807 #: ../src/guestfs.pod:2743
5808 msgid "C<src>"
5809 msgstr ""
5810
5811 #. type: textblock
5812 #: ../src/guestfs.pod:2745
5813 msgid "Source code to the C library."
5814 msgstr ""
5815
5816 #. type: =item
5817 #: ../src/guestfs.pod:2747
5818 msgid "C<tools>"
5819 msgstr ""
5820
5821 #. type: textblock
5822 #: ../src/guestfs.pod:2749
5823 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5824 msgstr ""
5825
5826 #. type: =item
5827 #: ../src/guestfs.pod:2751
5828 msgid "C<test-tool>"
5829 msgstr ""
5830
5831 #. type: textblock
5832 #: ../src/guestfs.pod:2753
5833 msgid ""
5834 "Test tool for end users to test if their qemu/kernel combination will work "
5835 "with libguestfs."
5836 msgstr ""
5837
5838 #. type: =item
5839 #: ../src/guestfs.pod:2756
5840 msgid "C<csharp>"
5841 msgstr ""
5842
5843 #. type: =item
5844 #: ../src/guestfs.pod:2758
5845 msgid "C<haskell>"
5846 msgstr ""
5847
5848 #. type: =item
5849 #: ../src/guestfs.pod:2760
5850 msgid "C<java>"
5851 msgstr ""
5852
5853 #. type: =item
5854 #: ../src/guestfs.pod:2762
5855 msgid "C<ocaml>"
5856 msgstr ""
5857
5858 #. type: =item
5859 #: ../src/guestfs.pod:2764
5860 msgid "C<php>"
5861 msgstr ""
5862
5863 #. type: =item
5864 #: ../src/guestfs.pod:2766
5865 msgid "C<perl>"
5866 msgstr ""
5867
5868 #. type: =item
5869 #: ../src/guestfs.pod:2768
5870 msgid "C<python>"
5871 msgstr ""
5872
5873 #. type: =item
5874 #: ../src/guestfs.pod:2770
5875 msgid "C<ruby>"
5876 msgstr ""
5877
5878 #. type: textblock
5879 #: ../src/guestfs.pod:2772
5880 msgid "Language bindings."
5881 msgstr ""
5882
5883 # type: =head1
5884 #. type: =head1
5885 #: ../src/guestfs.pod:2776 ../fish/guestfish.pod:1015
5886 #: ../test-tool/libguestfs-test-tool.pod:82 ../tools/virt-edit.pl:476
5887 msgid "ENVIRONMENT VARIABLES"
5888 msgstr ""
5889
5890 # type: =item
5891 #. type: =item
5892 #: ../src/guestfs.pod:2780 ../fish/guestfish.pod:1041
5893 msgid "LIBGUESTFS_APPEND"
5894 msgstr ""
5895
5896 # type: textblock
5897 #. type: textblock
5898 #: ../src/guestfs.pod:2782 ../fish/guestfish.pod:1043
5899 msgid "Pass additional options to the guest kernel."
5900 msgstr ""
5901
5902 # type: =item
5903 #. type: =item
5904 #: ../src/guestfs.pod:2784 ../fish/guestfish.pod:1045
5905 msgid "LIBGUESTFS_DEBUG"
5906 msgstr ""
5907
5908 # type: textblock
5909 #. type: textblock
5910 #: ../src/guestfs.pod:2786
5911 msgid ""
5912 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
5913 "effect as calling C<guestfs_set_verbose (g, 1)>."
5914 msgstr ""
5915
5916 # type: =item
5917 #. type: =item
5918 #: ../src/guestfs.pod:2789 ../fish/guestfish.pod:1050
5919 msgid "LIBGUESTFS_MEMSIZE"
5920 msgstr ""
5921
5922 # type: textblock
5923 #. type: textblock
5924 #: ../src/guestfs.pod:2791 ../fish/guestfish.pod:1052
5925 msgid ""
5926 "Set the memory allocated to the qemu process, in megabytes.  For example:"
5927 msgstr ""
5928
5929 # type: verbatim
5930 #. type: verbatim
5931 #: ../src/guestfs.pod:2794 ../fish/guestfish.pod:1055
5932 #, no-wrap
5933 msgid ""
5934 " LIBGUESTFS_MEMSIZE=700\n"
5935 "\n"
5936 msgstr ""
5937
5938 # type: =item
5939 #. type: =item
5940 #: ../src/guestfs.pod:2796 ../fish/guestfish.pod:1057
5941 msgid "LIBGUESTFS_PATH"
5942 msgstr ""
5943
5944 #. type: textblock
5945 #: ../src/guestfs.pod:2798
5946 msgid ""
5947 "Set the path that libguestfs uses to search for a supermin appliance.  See "
5948 "the discussion of paths in section L</PATH> above."
5949 msgstr ""
5950
5951 # type: =item
5952 #. type: =item
5953 #: ../src/guestfs.pod:2801 ../fish/guestfish.pod:1062
5954 msgid "LIBGUESTFS_QEMU"
5955 msgstr ""
5956
5957 # type: textblock
5958 #. type: textblock
5959 #: ../src/guestfs.pod:2803 ../fish/guestfish.pod:1064
5960 msgid ""
5961 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
5962 "which was found at compile time by the configure script is used."
5963 msgstr ""
5964
5965 # type: textblock
5966 #. type: textblock
5967 #: ../src/guestfs.pod:2807
5968 msgid "See also L</QEMU WRAPPERS> above."
5969 msgstr ""
5970
5971 # type: =item
5972 #. type: =item
5973 #: ../src/guestfs.pod:2809 ../fish/guestfish.pod:1068
5974 msgid "LIBGUESTFS_TRACE"
5975 msgstr ""
5976
5977 # type: textblock
5978 #. type: textblock
5979 #: ../src/guestfs.pod:2811
5980 msgid ""
5981 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
5982 "effect as calling C<guestfs_set_trace (g, 1)>."
5983 msgstr ""
5984
5985 # type: =item
5986 #. type: =item
5987 #: ../src/guestfs.pod:2814 ../fish/guestfish.pod:1077
5988 msgid "TMPDIR"
5989 msgstr ""
5990
5991 #. type: textblock
5992 #: ../src/guestfs.pod:2816 ../fish/guestfish.pod:1079
5993 msgid ""
5994 "Location of temporary directory, defaults to C</tmp> except for the cached "
5995 "supermin appliance which defaults to C</var/tmp>."
5996 msgstr ""
5997
5998 #. type: textblock
5999 #: ../src/guestfs.pod:2819 ../fish/guestfish.pod:1082
6000 msgid ""
6001 "If libguestfs was compiled to use the supermin appliance then the real "
6002 "appliance is cached in this directory, shared between all handles belonging "
6003 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
6004 "use in case C</var/tmp> is not large enough."
6005 msgstr ""
6006
6007 # type: =head1
6008 #. type: =head1
6009 #: ../src/guestfs.pod:2827 ../fish/guestfish.pod:1149
6010 #: ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:267
6011 #: ../tools/virt-edit.pl:496 ../tools/virt-win-reg.pl:572
6012 #: ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286
6013 #: ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257
6014 msgid "SEE ALSO"
6015 msgstr ""
6016
6017 #. type: textblock
6018 #: ../src/guestfs.pod:2829
6019 msgid ""
6020 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-"
6021 "ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-copy-in"
6022 "(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems"
6023 "(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-"
6024 "partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-"
6025 "tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)"
6026 ">, L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
6027 msgstr ""
6028
6029 # type: textblock
6030 #. type: textblock
6031 #: ../src/guestfs.pod:2856
6032 msgid ""
6033 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
6034 "(8)>, L<disktype(1)>."
6035 msgstr ""
6036
6037 # type: =head1
6038 #. type: =head1
6039 #: ../src/guestfs.pod:2863 ../tools/virt-win-reg.pl:587
6040 #: ../tools/virt-make-fs.pl:553
6041 msgid "BUGS"
6042 msgstr ""
6043
6044 # type: textblock
6045 #. type: textblock
6046 #: ../src/guestfs.pod:2865
6047 msgid "To get a list of bugs against libguestfs use this link:"
6048 msgstr ""
6049
6050 # type: textblock
6051 #. type: textblock
6052 #: ../src/guestfs.pod:2867
6053 msgid ""
6054 "L<https://bugzilla.redhat.com/buglist.cgi?"
6055 "component=libguestfs&product=Virtualization+Tools>"
6056 msgstr ""
6057
6058 # type: textblock
6059 #. type: textblock
6060 #: ../src/guestfs.pod:2869
6061 msgid "To report a new bug against libguestfs use this link:"
6062 msgstr ""
6063
6064 # type: textblock
6065 #. type: textblock
6066 #: ../src/guestfs.pod:2871
6067 msgid ""
6068 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
6069 "component=libguestfs&product=Virtualization+Tools>"
6070 msgstr ""
6071
6072 # type: textblock
6073 #. type: textblock
6074 #: ../src/guestfs.pod:2873
6075 msgid "When reporting a bug, please check:"
6076 msgstr ""
6077
6078 # type: textblock
6079 #. type: textblock
6080 #: ../src/guestfs.pod:2879
6081 msgid "That the bug hasn't been reported already."
6082 msgstr ""
6083
6084 # type: textblock
6085 #. type: textblock
6086 #: ../src/guestfs.pod:2883
6087 msgid "That you are testing a recent version."
6088 msgstr ""
6089
6090 # type: textblock
6091 #. type: textblock
6092 #: ../src/guestfs.pod:2887
6093 msgid "Describe the bug accurately, and give a way to reproduce it."
6094 msgstr ""
6095
6096 # type: textblock
6097 #. type: textblock
6098 #: ../src/guestfs.pod:2891
6099 msgid ""
6100 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
6101 "bug report."
6102 msgstr ""
6103
6104 # type: =head1
6105 #. type: =head1
6106 #: ../src/guestfs.pod:2896 ../fish/guestfish.pod:1172
6107 #: ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:278
6108 msgid "AUTHORS"
6109 msgstr ""
6110
6111 # type: textblock
6112 #. type: textblock
6113 #: ../src/guestfs.pod:2898 ../fish/guestfish.pod:1174
6114 #: ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:280
6115 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
6116 msgstr ""
6117
6118 # type: =head1
6119 #. type: =head1
6120 #: ../src/guestfs.pod:2900 ../fish/guestfish.pod:1176
6121 #: ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:282
6122 #: ../tools/virt-edit.pl:514 ../tools/virt-win-reg.pl:602
6123 #: ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305
6124 #: ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273
6125 msgid "COPYRIGHT"
6126 msgstr ""
6127
6128 #. type: textblock
6129 #: ../src/guestfs.pod:2902 ../fish/guestfish.pod:1178
6130 #: ../test-tool/libguestfs-test-tool.pod:99
6131 msgid "Copyright (C) 2009-2011 Red Hat Inc.  L<http://libguestfs.org/>"
6132 msgstr ""
6133
6134 # type: textblock
6135 #. type: textblock
6136 #: ../src/guestfs.pod:2905
6137 msgid ""
6138 "This library is free software; you can redistribute it and/or modify it "
6139 "under the terms of the GNU Lesser General Public License as published by the "
6140 "Free Software Foundation; either version 2 of the License, or (at your "
6141 "option) any later version."
6142 msgstr ""
6143
6144 # type: textblock
6145 #. type: textblock
6146 #: ../src/guestfs.pod:2910
6147 msgid ""
6148 "This library is distributed in the hope that it will be useful, but WITHOUT "
6149 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
6150 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
6151 "for more details."
6152 msgstr ""
6153
6154 # type: textblock
6155 #. type: textblock
6156 #: ../src/guestfs.pod:2915
6157 msgid ""
6158 "You should have received a copy of the GNU Lesser General Public License "
6159 "along with this library; if not, write to the Free Software Foundation, "
6160 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
6161 msgstr ""
6162
6163 # type: =head2
6164 #. type: =head2
6165 #: ../src/guestfs-actions.pod:1
6166 msgid "guestfs_add_cdrom"
6167 msgstr ""
6168
6169 # type: verbatim
6170 #. type: verbatim
6171 #: ../src/guestfs-actions.pod:3
6172 #, no-wrap
6173 msgid ""
6174 " int\n"
6175 " guestfs_add_cdrom (guestfs_h *g,\n"
6176 "                    const char *filename);\n"
6177 "\n"
6178 msgstr ""
6179
6180 # type: textblock
6181 #. type: textblock
6182 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
6183 msgid "This function adds a virtual CD-ROM disk image to the guest."
6184 msgstr ""
6185
6186 # type: textblock
6187 #. type: textblock
6188 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
6189 msgid "This is equivalent to the qemu parameter C<-cdrom filename>."
6190 msgstr ""
6191
6192 # type: textblock
6193 #. type: textblock
6194 #: ../src/guestfs-actions.pod:17
6195 msgid ""
6196 "This call checks for the existence of C<filename>.  This stops you from "
6197 "specifying other types of drive which are supported by qemu such as C<nbd:> "
6198 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
6199 "instead."
6200 msgstr ""
6201
6202 # type: textblock
6203 #. type: textblock
6204 #: ../src/guestfs-actions.pod:24
6205 msgid ""
6206 "If you just want to add an ISO file (often you use this as an efficient way "
6207 "to transfer large files into the guest), then you should probably use "
6208 "C<guestfs_add_drive_ro> instead."
6209 msgstr ""
6210
6211 # type: textblock
6212 #. type: textblock
6213 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134
6214 #: ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232
6215 #: ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267
6216 #: ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301
6217 #: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:436
6218 #: ../src/guestfs-actions.pod:450 ../src/guestfs-actions.pod:495
6219 #: ../src/guestfs-actions.pod:523 ../src/guestfs-actions.pod:541
6220 #: ../src/guestfs-actions.pod:608 ../src/guestfs-actions.pod:641
6221 #: ../src/guestfs-actions.pod:655 ../src/guestfs-actions.pod:670
6222 #: ../src/guestfs-actions.pod:769 ../src/guestfs-actions.pod:787
6223 #: ../src/guestfs-actions.pod:801 ../src/guestfs-actions.pod:815
6224 #: ../src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:996
6225 #: ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1098
6226 #: ../src/guestfs-actions.pod:1116 ../src/guestfs-actions.pod:1135
6227 #: ../src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1169
6228 #: ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1270
6229 #: ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1337
6230 #: ../src/guestfs-actions.pod:1443 ../src/guestfs-actions.pod:1477
6231 #: ../src/guestfs-actions.pod:1695 ../src/guestfs-actions.pod:1717
6232 #: ../src/guestfs-actions.pod:1804 ../src/guestfs-actions.pod:2266
6233 #: ../src/guestfs-actions.pod:2410 ../src/guestfs-actions.pod:2471
6234 #: ../src/guestfs-actions.pod:2506 ../src/guestfs-actions.pod:3459
6235 #: ../src/guestfs-actions.pod:3474 ../src/guestfs-actions.pod:3499
6236 #: ../src/guestfs-actions.pod:3654 ../src/guestfs-actions.pod:3668
6237 #: ../src/guestfs-actions.pod:3681 ../src/guestfs-actions.pod:3695
6238 #: ../src/guestfs-actions.pod:3710 ../src/guestfs-actions.pod:3746
6239 #: ../src/guestfs-actions.pod:3818 ../src/guestfs-actions.pod:3838
6240 #: ../src/guestfs-actions.pod:3855 ../src/guestfs-actions.pod:3878
6241 #: ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:3933
6242 #: ../src/guestfs-actions.pod:3952 ../src/guestfs-actions.pod:3971
6243 #: ../src/guestfs-actions.pod:4006 ../src/guestfs-actions.pod:4018
6244 #: ../src/guestfs-actions.pod:4054 ../src/guestfs-actions.pod:4070
6245 #: ../src/guestfs-actions.pod:4083 ../src/guestfs-actions.pod:4098
6246 #: ../src/guestfs-actions.pod:4115 ../src/guestfs-actions.pod:4208
6247 #: ../src/guestfs-actions.pod:4228 ../src/guestfs-actions.pod:4241
6248 #: ../src/guestfs-actions.pod:4292 ../src/guestfs-actions.pod:4310
6249 #: ../src/guestfs-actions.pod:4328 ../src/guestfs-actions.pod:4344
6250 #: ../src/guestfs-actions.pod:4358 ../src/guestfs-actions.pod:4372
6251 #: ../src/guestfs-actions.pod:4389 ../src/guestfs-actions.pod:4404
6252 #: ../src/guestfs-actions.pod:4424 ../src/guestfs-actions.pod:4482
6253 #: ../src/guestfs-actions.pod:4555 ../src/guestfs-actions.pod:4586
6254 #: ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:4624
6255 #: ../src/guestfs-actions.pod:4636 ../src/guestfs-actions.pod:4653
6256 #: ../src/guestfs-actions.pod:4666 ../src/guestfs-actions.pod:4681
6257 #: ../src/guestfs-actions.pod:4696 ../src/guestfs-actions.pod:4731
6258 #: ../src/guestfs-actions.pod:4746 ../src/guestfs-actions.pod:4766
6259 #: ../src/guestfs-actions.pod:4780 ../src/guestfs-actions.pod:4797
6260 #: ../src/guestfs-actions.pod:4846 ../src/guestfs-actions.pod:4883
6261 #: ../src/guestfs-actions.pod:4897 ../src/guestfs-actions.pod:4925
6262 #: ../src/guestfs-actions.pod:4942 ../src/guestfs-actions.pod:4960
6263 #: ../src/guestfs-actions.pod:5094 ../src/guestfs-actions.pod:5151
6264 #: ../src/guestfs-actions.pod:5173 ../src/guestfs-actions.pod:5191
6265 #: ../src/guestfs-actions.pod:5223 ../src/guestfs-actions.pod:5289
6266 #: ../src/guestfs-actions.pod:5306 ../src/guestfs-actions.pod:5319
6267 #: ../src/guestfs-actions.pod:5333 ../src/guestfs-actions.pod:5622
6268 #: ../src/guestfs-actions.pod:5641 ../src/guestfs-actions.pod:5660
6269 #: ../src/guestfs-actions.pod:5672 ../src/guestfs-actions.pod:5684
6270 #: ../src/guestfs-actions.pod:5698 ../src/guestfs-actions.pod:5710
6271 #: ../src/guestfs-actions.pod:5724 ../src/guestfs-actions.pod:5740
6272 #: ../src/guestfs-actions.pod:5761 ../src/guestfs-actions.pod:5780
6273 #: ../src/guestfs-actions.pod:5799 ../src/guestfs-actions.pod:5829
6274 #: ../src/guestfs-actions.pod:5845 ../src/guestfs-actions.pod:5868
6275 #: ../src/guestfs-actions.pod:5886 ../src/guestfs-actions.pod:5905
6276 #: ../src/guestfs-actions.pod:5926 ../src/guestfs-actions.pod:5945
6277 #: ../src/guestfs-actions.pod:5962 ../src/guestfs-actions.pod:5990
6278 #: ../src/guestfs-actions.pod:6014 ../src/guestfs-actions.pod:6033
6279 #: ../src/guestfs-actions.pod:6057 ../src/guestfs-actions.pod:6076
6280 #: ../src/guestfs-actions.pod:6091 ../src/guestfs-actions.pod:6110
6281 #: ../src/guestfs-actions.pod:6147 ../src/guestfs-actions.pod:6170
6282 #: ../src/guestfs-actions.pod:6196 ../src/guestfs-actions.pod:6304
6283 #: ../src/guestfs-actions.pod:6425 ../src/guestfs-actions.pod:6437
6284 #: ../src/guestfs-actions.pod:6450 ../src/guestfs-actions.pod:6463
6285 #: ../src/guestfs-actions.pod:6485 ../src/guestfs-actions.pod:6498
6286 #: ../src/guestfs-actions.pod:6511 ../src/guestfs-actions.pod:6524
6287 #: ../src/guestfs-actions.pod:6539 ../src/guestfs-actions.pod:6598
6288 #: ../src/guestfs-actions.pod:6615 ../src/guestfs-actions.pod:6631
6289 #: ../src/guestfs-actions.pod:6647 ../src/guestfs-actions.pod:6664
6290 #: ../src/guestfs-actions.pod:6677 ../src/guestfs-actions.pod:6697
6291 #: ../src/guestfs-actions.pod:6733 ../src/guestfs-actions.pod:6747
6292 #: ../src/guestfs-actions.pod:6788 ../src/guestfs-actions.pod:6801
6293 #: ../src/guestfs-actions.pod:6819 ../src/guestfs-actions.pod:6853
6294 #: ../src/guestfs-actions.pod:6889 ../src/guestfs-actions.pod:7008
6295 #: ../src/guestfs-actions.pod:7026 ../src/guestfs-actions.pod:7040
6296 #: ../src/guestfs-actions.pod:7095 ../src/guestfs-actions.pod:7108
6297 #: ../src/guestfs-actions.pod:7153 ../src/guestfs-actions.pod:7186
6298 #: ../src/guestfs-actions.pod:7240 ../src/guestfs-actions.pod:7266
6299 #: ../src/guestfs-actions.pod:7332 ../src/guestfs-actions.pod:7351
6300 #: ../src/guestfs-actions.pod:7380
6301 msgid "This function returns 0 on success or -1 on error."
6302 msgstr ""
6303
6304 # type: textblock
6305 #. type: textblock
6306 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248
6307 #: ../src/guestfs-actions.pod:269 ../fish/guestfish-actions.pod:28
6308 #: ../fish/guestfish-actions.pod:158 ../fish/guestfish-actions.pod:172
6309 msgid ""
6310 "This function is deprecated.  In new code, use the C<add_drive_opts> call "
6311 "instead."
6312 msgstr ""
6313
6314 # type: textblock
6315 #. type: textblock
6316 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251
6317 #: ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1448
6318 #: ../src/guestfs-actions.pod:1944 ../src/guestfs-actions.pod:1965
6319 #: ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:7274
6320 #: ../src/guestfs-actions.pod:7443 ../fish/guestfish-actions.pod:31
6321 #: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175
6322 #: ../fish/guestfish-actions.pod:956 ../fish/guestfish-actions.pod:1319
6323 #: ../fish/guestfish-actions.pod:1333 ../fish/guestfish-actions.pod:3008
6324 #: ../fish/guestfish-actions.pod:4866 ../fish/guestfish-actions.pod:4963
6325 msgid ""
6326 "Deprecated functions will not be removed from the API, but the fact that "
6327 "they are deprecated indicates that there are problems with correct use of "
6328 "these functions."
6329 msgstr ""
6330
6331 # type: textblock
6332 #. type: textblock
6333 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136
6334 #: ../src/guestfs-actions.pod:1100 ../src/guestfs-actions.pod:1916
6335 #: ../src/guestfs-actions.pod:2014 ../src/guestfs-actions.pod:2117
6336 #: ../src/guestfs-actions.pod:3461 ../src/guestfs-actions.pod:3481
6337 #: ../src/guestfs-actions.pod:4733 ../src/guestfs-actions.pod:5847
6338 #: ../src/guestfs-actions.pod:5964 ../src/guestfs-actions.pod:6078
6339 #: ../src/guestfs-actions.pod:6541 ../src/guestfs-actions.pod:6666
6340 #: ../src/guestfs-actions.pod:7188
6341 msgid "(Added in 0.3)"
6342 msgstr ""
6343
6344 # type: =head2
6345 #. type: =head2
6346 #: ../src/guestfs-actions.pod:41
6347 msgid "guestfs_add_domain"
6348 msgstr ""
6349
6350 # type: verbatim
6351 #. type: verbatim
6352 #: ../src/guestfs-actions.pod:43
6353 #, no-wrap
6354 msgid ""
6355 " int\n"
6356 " guestfs_add_domain (guestfs_h *g,\n"
6357 "                     const char *dom,\n"
6358 "                     ...);\n"
6359 "\n"
6360 msgstr ""
6361
6362 # type: textblock
6363 #. type: textblock
6364 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145
6365 #: ../src/guestfs-actions.pod:4443
6366 msgid ""
6367 "You may supply a list of optional arguments to this call.  Use zero or more "
6368 "of the following pairs of parameters, and terminate the list with C<-1> on "
6369 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
6370 msgstr ""
6371
6372 #. type: verbatim
6373 #: ../src/guestfs-actions.pod:53
6374 #, no-wrap
6375 msgid ""
6376 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
6377 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
6378 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
6379 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
6380 "\n"
6381 msgstr ""
6382
6383 # type: textblock
6384 #. type: textblock
6385 #: ../src/guestfs-actions.pod:58
6386 msgid ""
6387 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
6388 "It works by connecting to libvirt, requesting the domain and domain XML from "
6389 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
6390 "one."
6391 msgstr ""
6392
6393 # type: textblock
6394 #. type: textblock
6395 #: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46
6396 msgid ""
6397 "The number of disks added is returned.  This operation is atomic: if an "
6398 "error is returned, then no disks are added."
6399 msgstr ""
6400
6401 # type: textblock
6402 #. type: textblock
6403 #: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49
6404 msgid ""
6405 "This function does some minimal checks to make sure the libvirt domain is "
6406 "not running (unless C<readonly> is true).  In a future version we will try "
6407 "to acquire the libvirt lock on each disk."
6408 msgstr ""
6409
6410 # type: textblock
6411 #. type: textblock
6412 #: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53
6413 msgid ""
6414 "Disks must be accessible locally.  This often means that adding disks from a "
6415 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
6416 "unless those disks are accessible via the same device path locally too."
6417 msgstr ""
6418
6419 #. type: textblock
6420 #: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58
6421 msgid ""
6422 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6423 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
6424 "libvirt URI (or one set through an environment variable, see the libvirt "
6425 "documentation for full details)."
6426 msgstr ""
6427
6428 #. type: textblock
6429 #: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64
6430 msgid ""
6431 "The optional C<live> flag controls whether this call will try to connect to "
6432 "a running virtual machine C<guestfsd> process if it sees a suitable "
6433 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
6434 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
6435 "DAEMONS> for more information."
6436 msgstr ""
6437
6438 # type: textblock
6439 #. type: textblock
6440 #: ../src/guestfs-actions.pod:88
6441 msgid ""
6442 "The other optional parameters are passed directly through to "
6443 "C<guestfs_add_drive_opts>."
6444 msgstr ""
6445
6446 # type: textblock
6447 #. type: textblock
6448 #: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344
6449 #: ../src/guestfs-actions.pod:509 ../src/guestfs-actions.pod:687
6450 #: ../src/guestfs-actions.pod:718 ../src/guestfs-actions.pod:736
6451 #: ../src/guestfs-actions.pod:755 ../src/guestfs-actions.pod:1315
6452 #: ../src/guestfs-actions.pod:1674 ../src/guestfs-actions.pod:1877
6453 #: ../src/guestfs-actions.pod:1986 ../src/guestfs-actions.pod:2026
6454 #: ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:2104
6455 #: ../src/guestfs-actions.pod:2397 ../src/guestfs-actions.pod:2780
6456 #: ../src/guestfs-actions.pod:2801 ../src/guestfs-actions.pod:4869
6457 #: ../src/guestfs-actions.pod:4997 ../src/guestfs-actions.pod:5403
6458 #: ../src/guestfs-actions.pod:5429 ../src/guestfs-actions.pod:6774
6459 #: ../src/guestfs-actions.pod:7199 ../src/guestfs-actions.pod:7212
6460 #: ../src/guestfs-actions.pod:7225
6461 msgid "On error this function returns -1."
6462 msgstr ""
6463
6464 # type: textblock
6465 #. type: textblock
6466 #: ../src/guestfs-actions.pod:93
6467 msgid "(Added in 1.7.4)"
6468 msgstr ""
6469
6470 # type: =head2
6471 #. type: =head2
6472 #: ../src/guestfs-actions.pod:95
6473 msgid "guestfs_add_domain_va"
6474 msgstr ""
6475
6476 # type: verbatim
6477 #. type: verbatim
6478 #: ../src/guestfs-actions.pod:97
6479 #, no-wrap
6480 msgid ""
6481 " int\n"
6482 " guestfs_add_domain_va (guestfs_h *g,\n"
6483 "                        const char *dom,\n"
6484 "                        va_list args);\n"
6485 "\n"
6486 msgstr ""
6487
6488 # type: textblock
6489 #. type: textblock
6490 #: ../src/guestfs-actions.pod:102
6491 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
6492 msgstr ""
6493
6494 # type: textblock
6495 #. type: textblock
6496 #: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115
6497 #: ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219
6498 #: ../src/guestfs-actions.pod:4496 ../src/guestfs-actions.pod:4508
6499 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
6500 msgstr ""
6501
6502 # type: =head2
6503 #. type: =head2
6504 #: ../src/guestfs-actions.pod:106
6505 msgid "guestfs_add_domain_argv"
6506 msgstr ""
6507
6508 # type: verbatim
6509 #. type: verbatim
6510 #: ../src/guestfs-actions.pod:108
6511 #, no-wrap
6512 msgid ""
6513 " int\n"
6514 " guestfs_add_domain_argv (guestfs_h *g,\n"
6515 "                          const char *dom,\n"
6516 "                          const struct guestfs_add_domain_argv *optargs);\n"
6517 "\n"
6518 msgstr ""
6519
6520 # type: textblock
6521 #. type: textblock
6522 #: ../src/guestfs-actions.pod:113
6523 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
6524 msgstr ""
6525
6526 # type: =head2
6527 #. type: =head2
6528 #: ../src/guestfs-actions.pod:117
6529 msgid "guestfs_add_drive"
6530 msgstr ""
6531
6532 # type: verbatim
6533 #. type: verbatim
6534 #: ../src/guestfs-actions.pod:119
6535 #, no-wrap
6536 msgid ""
6537 " int\n"
6538 " guestfs_add_drive (guestfs_h *g,\n"
6539 "                    const char *filename);\n"
6540 "\n"
6541 msgstr ""
6542
6543 # type: textblock
6544 #. type: textblock
6545 #: ../src/guestfs-actions.pod:123
6546 msgid ""
6547 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
6548 "optional parameters, so the disk is added writable, with the format being "
6549 "detected automatically."
6550 msgstr ""
6551
6552 # type: textblock
6553 #. type: textblock
6554 #: ../src/guestfs-actions.pod:127
6555 msgid ""
6556 "Automatic detection of the format opens you up to a potential security hole "
6557 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6558 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6559 "you should think about replacing calls to this function with calls to "
6560 "C<guestfs_add_drive_opts>, and specifying the format."
6561 msgstr ""
6562
6563 # type: =head2
6564 #. type: =head2
6565 #: ../src/guestfs-actions.pod:138
6566 msgid "guestfs_add_drive_opts"
6567 msgstr ""
6568
6569 # type: verbatim
6570 #. type: verbatim
6571 #: ../src/guestfs-actions.pod:140
6572 #, no-wrap
6573 msgid ""
6574 " int\n"
6575 " guestfs_add_drive_opts (guestfs_h *g,\n"
6576 "                         const char *filename,\n"
6577 "                         ...);\n"
6578 "\n"
6579 msgstr ""
6580
6581 # type: verbatim
6582 #. type: verbatim
6583 #: ../src/guestfs-actions.pod:150
6584 #, no-wrap
6585 msgid ""
6586 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6587 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6588 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6589 "\n"
6590 msgstr ""
6591
6592 # type: textblock
6593 #. type: textblock
6594 #: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97
6595 msgid ""
6596 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6597 "The first time you call this function, the disk appears as C</dev/sda>, the "
6598 "second time as C</dev/sdb>, and so on."
6599 msgstr ""
6600
6601 # type: textblock
6602 #. type: textblock
6603 #: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102
6604 msgid ""
6605 "You don't necessarily need to be root when using libguestfs.  However you "
6606 "obviously do need sufficient permissions to access the filename for whatever "
6607 "operations you want to perform (ie. read access if you just want to read the "
6608 "image or write access if you want to modify the image)."
6609 msgstr ""
6610
6611 # type: textblock
6612 #. type: textblock
6613 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108
6614 msgid "This call checks that C<filename> exists."
6615 msgstr ""
6616
6617 # type: textblock
6618 #. type: textblock
6619 #: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4454
6620 #: ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:3019
6621 msgid "The optional arguments are:"
6622 msgstr ""
6623
6624 # type: =item
6625 #. type: =item
6626 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114
6627 msgid "C<readonly>"
6628 msgstr ""
6629
6630 # type: textblock
6631 #. type: textblock
6632 #: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116
6633 msgid ""
6634 "If true then the image is treated as read-only.  Writes are still allowed, "
6635 "but they are stored in a temporary snapshot overlay which is discarded at "
6636 "the end.  The disk that you add is not modified."
6637 msgstr ""
6638
6639 # type: =item
6640 #. type: =item
6641 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120
6642 msgid "C<format>"
6643 msgstr ""
6644
6645 # type: textblock
6646 #. type: textblock
6647 #: ../src/guestfs-actions.pod:179
6648 msgid ""
6649 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6650 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6651 "Possible formats include C<raw> and C<qcow2>."
6652 msgstr ""
6653
6654 # type: textblock
6655 #. type: textblock
6656 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126
6657 msgid ""
6658 "Automatic detection of the format opens you up to a potential security hole "
6659 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6660 "RHBZ#642934.  Specifying the format closes this security hole."
6661 msgstr ""
6662
6663 # type: =item
6664 #. type: =item
6665 #: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131
6666 msgid "C<iface>"
6667 msgstr ""
6668
6669 # type: textblock
6670 #. type: textblock
6671 #: ../src/guestfs-actions.pod:190
6672 msgid ""
6673 "This rarely-used option lets you emulate the behaviour of the deprecated "
6674 "C<guestfs_add_drive_with_if> call (q.v.)"
6675 msgstr ""
6676
6677 # type: textblock
6678 #. type: textblock
6679 #: ../src/guestfs-actions.pod:197
6680 msgid "(Added in 1.5.23)"
6681 msgstr ""
6682
6683 # type: =head2
6684 #. type: =head2
6685 #: ../src/guestfs-actions.pod:199
6686 msgid "guestfs_add_drive_opts_va"
6687 msgstr ""
6688
6689 # type: verbatim
6690 #. type: verbatim
6691 #: ../src/guestfs-actions.pod:201
6692 #, no-wrap
6693 msgid ""
6694 " int\n"
6695 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6696 "                            const char *filename,\n"
6697 "                            va_list args);\n"
6698 "\n"
6699 msgstr ""
6700
6701 # type: textblock
6702 #. type: textblock
6703 #: ../src/guestfs-actions.pod:206
6704 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6705 msgstr ""
6706
6707 # type: =head2
6708 #. type: =head2
6709 #: ../src/guestfs-actions.pod:210
6710 msgid "guestfs_add_drive_opts_argv"
6711 msgstr ""
6712
6713 # type: verbatim
6714 #. type: verbatim
6715 #: ../src/guestfs-actions.pod:212
6716 #, no-wrap
6717 msgid ""
6718 " int\n"
6719 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6720 "                              const char *filename,\n"
6721 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6722 "\n"
6723 msgstr ""
6724
6725 # type: textblock
6726 #. type: textblock
6727 #: ../src/guestfs-actions.pod:217
6728 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6729 msgstr ""
6730
6731 # type: =head2
6732 #. type: =head2
6733 #: ../src/guestfs-actions.pod:221
6734 msgid "guestfs_add_drive_ro"
6735 msgstr ""
6736
6737 # type: verbatim
6738 #. type: verbatim
6739 #: ../src/guestfs-actions.pod:223
6740 #, no-wrap
6741 msgid ""
6742 " int\n"
6743 " guestfs_add_drive_ro (guestfs_h *g,\n"
6744 "                       const char *filename);\n"
6745 "\n"
6746 msgstr ""
6747
6748 # type: textblock
6749 #. type: textblock
6750 #: ../src/guestfs-actions.pod:227
6751 msgid ""
6752 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6753 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6754 "disk is added read-only, with the format being detected automatically."
6755 msgstr ""
6756
6757 # type: textblock
6758 #. type: textblock
6759 #: ../src/guestfs-actions.pod:234
6760 msgid "(Added in 1.0.38)"
6761 msgstr ""
6762
6763 # type: =head2
6764 #. type: =head2
6765 #: ../src/guestfs-actions.pod:236
6766 msgid "guestfs_add_drive_ro_with_if"
6767 msgstr ""
6768
6769 # type: verbatim
6770 #. type: verbatim
6771 #: ../src/guestfs-actions.pod:238
6772 #, no-wrap
6773 msgid ""
6774 " int\n"
6775 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6776 "                               const char *filename,\n"
6777 "                               const char *iface);\n"
6778 "\n"
6779 msgstr ""
6780
6781 # type: textblock
6782 #. type: textblock
6783 #: ../src/guestfs-actions.pod:243
6784 msgid ""
6785 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6786 "QEMU interface emulation to use at run time."
6787 msgstr ""
6788
6789 # type: textblock
6790 #. type: textblock
6791 #: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276
6792 #: ../src/guestfs-actions.pod:2356
6793 msgid "(Added in 1.0.84)"
6794 msgstr ""
6795
6796 # type: =head2
6797 #. type: =head2
6798 #: ../src/guestfs-actions.pod:257
6799 msgid "guestfs_add_drive_with_if"
6800 msgstr ""
6801
6802 # type: verbatim
6803 #. type: verbatim
6804 #: ../src/guestfs-actions.pod:259
6805 #, no-wrap
6806 msgid ""
6807 " int\n"
6808 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6809 "                            const char *filename,\n"
6810 "                            const char *iface);\n"
6811 "\n"
6812 msgstr ""
6813
6814 # type: textblock
6815 #. type: textblock
6816 #: ../src/guestfs-actions.pod:264
6817 msgid ""
6818 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
6819 "QEMU interface emulation to use at run time."
6820 msgstr ""
6821
6822 # type: =head2
6823 #. type: =head2
6824 #: ../src/guestfs-actions.pod:278
6825 msgid "guestfs_aug_clear"
6826 msgstr ""
6827
6828 # type: verbatim
6829 #. type: verbatim
6830 #: ../src/guestfs-actions.pod:280
6831 #, no-wrap
6832 msgid ""
6833 " int\n"
6834 " guestfs_aug_clear (guestfs_h *g,\n"
6835 "                    const char *augpath);\n"
6836 "\n"
6837 msgstr ""
6838
6839 # type: textblock
6840 #. type: textblock
6841 #: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183
6842 msgid ""
6843 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
6844 "L<augtool(1)> C<clear> command."
6845 msgstr ""
6846
6847 # type: textblock
6848 #. type: textblock
6849 #: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2106
6850 msgid "(Added in 1.3.4)"
6851 msgstr ""
6852
6853 # type: =head2
6854 #. type: =head2
6855 #: ../src/guestfs-actions.pod:291
6856 msgid "guestfs_aug_close"
6857 msgstr ""
6858
6859 # type: verbatim
6860 #. type: verbatim
6861 #: ../src/guestfs-actions.pod:293
6862 #, no-wrap
6863 msgid ""
6864 " int\n"
6865 " guestfs_aug_close (guestfs_h *g);\n"
6866 "\n"
6867 msgstr ""
6868
6869 # type: textblock
6870 #. type: textblock
6871 #: ../src/guestfs-actions.pod:296
6872 msgid ""
6873 "Close the current Augeas handle and free up any resources used by it.  After "
6874 "calling this, you have to call C<guestfs_aug_init> again before you can use "
6875 "any other Augeas functions."
6876 msgstr ""
6877
6878 # type: textblock
6879 #. type: textblock
6880 #: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328
6881 #: ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360
6882 #: ../src/guestfs-actions.pod:418 ../src/guestfs-actions.pod:438
6883 #: ../src/guestfs-actions.pod:452 ../src/guestfs-actions.pod:483
6884 #: ../src/guestfs-actions.pod:497 ../src/guestfs-actions.pod:511
6885 #: ../src/guestfs-actions.pod:525 ../src/guestfs-actions.pod:543
6886 #: ../src/guestfs-actions.pod:5480
6887 msgid "(Added in 0.7)"
6888 msgstr ""
6889
6890 # type: =head2
6891 #. type: =head2
6892 #: ../src/guestfs-actions.pod:305
6893 msgid "guestfs_aug_defnode"
6894 msgstr ""
6895
6896 # type: verbatim
6897 #. type: verbatim
6898 #: ../src/guestfs-actions.pod:307
6899 #, no-wrap
6900 msgid ""
6901 " struct guestfs_int_bool *\n"
6902 " guestfs_aug_defnode (guestfs_h *g,\n"
6903 "                      const char *name,\n"
6904 "                      const char *expr,\n"
6905 "                      const char *val);\n"
6906 "\n"
6907 msgstr ""
6908
6909 # type: textblock
6910 #. type: textblock
6911 #: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199
6912 msgid ""
6913 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
6914 msgstr ""
6915
6916 # type: textblock
6917 #. type: textblock
6918 #: ../src/guestfs-actions.pod:316
6919 msgid ""
6920 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
6921 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
6922 "containing that single node."
6923 msgstr ""
6924
6925 # type: textblock
6926 #. type: textblock
6927 #: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206
6928 msgid ""
6929 "On success this returns a pair containing the number of nodes in the "
6930 "nodeset, and a boolean flag if a node was created."
6931 msgstr ""
6932
6933 # type: textblock
6934 #. type: textblock
6935 #: ../src/guestfs-actions.pod:324
6936 msgid ""
6937 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
6938 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
6939 msgstr ""
6940
6941 # type: =head2
6942 #. type: =head2
6943 #: ../src/guestfs-actions.pod:330
6944 msgid "guestfs_aug_defvar"
6945 msgstr ""
6946
6947 # type: verbatim
6948 #. type: verbatim
6949 #: ../src/guestfs-actions.pod:332
6950 #, no-wrap
6951 msgid ""
6952 " int\n"
6953 " guestfs_aug_defvar (guestfs_h *g,\n"
6954 "                     const char *name,\n"
6955 "                     const char *expr);\n"
6956 "\n"
6957 msgstr ""
6958
6959 # type: textblock
6960 #. type: textblock
6961 #: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214
6962 msgid ""
6963 "Defines an Augeas variable C<name> whose value is the result of evaluating "
6964 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
6965 msgstr ""
6966
6967 # type: textblock
6968 #. type: textblock
6969 #: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218
6970 msgid ""
6971 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
6972 "evaluates to something which is not a nodeset."
6973 msgstr ""
6974
6975 # type: =head2
6976 #. type: =head2
6977 #: ../src/guestfs-actions.pod:348
6978 msgid "guestfs_aug_get"
6979 msgstr ""
6980
6981 # type: verbatim
6982 #. type: verbatim
6983 #: ../src/guestfs-actions.pod:350
6984 #, no-wrap
6985 msgid ""
6986 " char *\n"
6987 " guestfs_aug_get (guestfs_h *g,\n"
6988 "                  const char *augpath);\n"
6989 "\n"
6990 msgstr ""
6991
6992 # type: textblock
6993 #. type: textblock
6994 #: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225
6995 msgid ""
6996 "Look up the value associated with C<path>.  If C<path> matches exactly one "
6997 "node, the C<value> is returned."
6998 msgstr ""
6999
7000 # type: textblock
7001 #. type: textblock
7002 #: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:857
7003 #: ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:935
7004 #: ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:1054
7005 #: ../src/guestfs-actions.pod:1184 ../src/guestfs-actions.pod:1201
7006 #: ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1354
7007 #: ../src/guestfs-actions.pod:1545 ../src/guestfs-actions.pod:1657
7008 #: ../src/guestfs-actions.pod:1820 ../src/guestfs-actions.pod:1837
7009 #: ../src/guestfs-actions.pod:1904 ../src/guestfs-actions.pod:1938
7010 #: ../src/guestfs-actions.pod:1959 ../src/guestfs-actions.pod:2129
7011 #: ../src/guestfs-actions.pod:2321 ../src/guestfs-actions.pod:2528
7012 #: ../src/guestfs-actions.pod:2621 ../src/guestfs-actions.pod:2732
7013 #: ../src/guestfs-actions.pod:2752 ../src/guestfs-actions.pod:2872
7014 #: ../src/guestfs-actions.pod:2903 ../src/guestfs-actions.pod:2927
7015 #: ../src/guestfs-actions.pod:2964 ../src/guestfs-actions.pod:3024
7016 #: ../src/guestfs-actions.pod:3047 ../src/guestfs-actions.pod:3068
7017 #: ../src/guestfs-actions.pod:3640 ../src/guestfs-actions.pod:3990
7018 #: ../src/guestfs-actions.pod:4160 ../src/guestfs-actions.pod:4270
7019 #: ../src/guestfs-actions.pod:5015 ../src/guestfs-actions.pod:5208
7020 #: ../src/guestfs-actions.pod:5378 ../src/guestfs-actions.pod:5556
7021 #: ../src/guestfs-actions.pod:5605 ../src/guestfs-actions.pod:6217
7022 #: ../src/guestfs-actions.pod:6233 ../src/guestfs-actions.pod:6250
7023 #: ../src/guestfs-actions.pod:6274 ../src/guestfs-actions.pod:6948
7024 #: ../src/guestfs-actions.pod:6967 ../src/guestfs-actions.pod:6985
7025 #: ../src/guestfs-actions.pod:7165 ../src/guestfs-actions.pod:7437
7026 msgid ""
7027 "This function returns a string, or NULL on error.  I<The caller must free "
7028 "the returned string after use>."
7029 msgstr ""
7030
7031 # type: =head2
7032 #. type: =head2
7033 #: ../src/guestfs-actions.pod:362
7034 msgid "guestfs_aug_init"
7035 msgstr ""
7036
7037 # type: verbatim
7038 #. type: verbatim
7039 #: ../src/guestfs-actions.pod:364
7040 #, no-wrap
7041 msgid ""
7042 " int\n"
7043 " guestfs_aug_init (guestfs_h *g,\n"
7044 "                   const char *root,\n"
7045 "                   int flags);\n"
7046 "\n"
7047 msgstr ""
7048
7049 # type: textblock
7050 #. type: textblock
7051 #: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232
7052 msgid ""
7053 "Create a new Augeas handle for editing configuration files.  If there was "
7054 "any previous Augeas handle associated with this guestfs session, then it is "
7055 "closed."
7056 msgstr ""
7057
7058 # type: textblock
7059 #. type: textblock
7060 #: ../src/guestfs-actions.pod:373
7061 msgid "You must call this before using any other C<guestfs_aug_*> commands."
7062 msgstr ""
7063
7064 # type: textblock
7065 #. type: textblock
7066 #: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239
7067 msgid ""
7068 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
7069 msgstr ""
7070
7071 # type: textblock
7072 #. type: textblock
7073 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242
7074 msgid ""
7075 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
7076 "logical I<or> of the following integers:"
7077 msgstr ""
7078
7079 # type: =item
7080 #. type: =item
7081 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248
7082 msgid "C<AUG_SAVE_BACKUP> = 1"
7083 msgstr ""
7084
7085 # type: textblock
7086 #. type: textblock
7087 #: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250
7088 msgid "Keep the original file with a C<.augsave> extension."
7089 msgstr ""
7090
7091 # type: =item
7092 #. type: =item
7093 #: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252
7094 msgid "C<AUG_SAVE_NEWFILE> = 2"
7095 msgstr ""
7096
7097 # type: textblock
7098 #. type: textblock
7099 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254
7100 msgid ""
7101 "Save changes into a file with extension C<.augnew>, and do not overwrite "
7102 "original.  Overrides C<AUG_SAVE_BACKUP>."
7103 msgstr ""
7104
7105 # type: =item
7106 #. type: =item
7107 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257
7108 msgid "C<AUG_TYPE_CHECK> = 4"
7109 msgstr ""
7110
7111 # type: textblock
7112 #. type: textblock
7113 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259
7114 msgid "Typecheck lenses (can be expensive)."
7115 msgstr ""
7116
7117 # type: =item
7118 #. type: =item
7119 #: ../src/guestfs-actions.pod:398 ../fish/guestfish-actions.pod:261
7120 msgid "C<AUG_NO_STDINC> = 8"
7121 msgstr ""
7122
7123 # type: textblock
7124 #. type: textblock
7125 #: ../src/guestfs-actions.pod:400 ../fish/guestfish-actions.pod:263
7126 msgid "Do not use standard load path for modules."
7127 msgstr ""
7128
7129 # type: =item
7130 #. type: =item
7131 #: ../src/guestfs-actions.pod:402 ../fish/guestfish-actions.pod:265
7132 msgid "C<AUG_SAVE_NOOP> = 16"
7133 msgstr ""
7134
7135 # type: textblock
7136 #. type: textblock
7137 #: ../src/guestfs-actions.pod:404 ../fish/guestfish-actions.pod:267
7138 msgid "Make save a no-op, just record what would have been changed."
7139 msgstr ""
7140
7141 # type: =item
7142 #. type: =item
7143 #: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:269
7144 msgid "C<AUG_NO_LOAD> = 32"
7145 msgstr ""
7146
7147 # type: textblock
7148 #. type: textblock
7149 #: ../src/guestfs-actions.pod:408
7150 msgid "Do not load the tree in C<guestfs_aug_init>."
7151 msgstr ""
7152
7153 # type: textblock
7154 #. type: textblock
7155 #: ../src/guestfs-actions.pod:412
7156 msgid "To close the handle, you can call C<guestfs_aug_close>."
7157 msgstr ""
7158
7159 # type: textblock
7160 #. type: textblock
7161 #: ../src/guestfs-actions.pod:414 ../fish/guestfish-actions.pod:277
7162 msgid "To find out more about Augeas, see L<http://augeas.net/>."
7163 msgstr ""
7164
7165 # type: =head2
7166 #. type: =head2
7167 #: ../src/guestfs-actions.pod:420
7168 msgid "guestfs_aug_insert"
7169 msgstr ""
7170
7171 # type: verbatim
7172 #. type: verbatim
7173 #: ../src/guestfs-actions.pod:422
7174 #, no-wrap
7175 msgid ""
7176 " int\n"
7177 " guestfs_aug_insert (guestfs_h *g,\n"
7178 "                     const char *augpath,\n"
7179 "                     const char *label,\n"
7180 "                     int before);\n"
7181 "\n"
7182 msgstr ""
7183
7184 # type: textblock
7185 #. type: textblock
7186 #: ../src/guestfs-actions.pod:428 ../fish/guestfish-actions.pod:283
7187 msgid ""
7188 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
7189 "or after C<path> (depending on the boolean flag C<before>)."
7190 msgstr ""
7191
7192 # type: textblock
7193 #. type: textblock
7194 #: ../src/guestfs-actions.pod:432 ../fish/guestfish-actions.pod:287
7195 msgid ""
7196 "C<path> must match exactly one existing node in the tree, and C<label> must "
7197 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
7198 msgstr ""
7199
7200 # type: =head2
7201 #. type: =head2
7202 #: ../src/guestfs-actions.pod:440
7203 msgid "guestfs_aug_load"
7204 msgstr ""
7205
7206 # type: verbatim
7207 #. type: verbatim
7208 #: ../src/guestfs-actions.pod:442
7209 #, no-wrap
7210 msgid ""
7211 " int\n"
7212 " guestfs_aug_load (guestfs_h *g);\n"
7213 "\n"
7214 msgstr ""
7215
7216 # type: textblock
7217 #. type: textblock
7218 #: ../src/guestfs-actions.pod:445 ../fish/guestfish-actions.pod:295
7219 msgid "Load files into the tree."
7220 msgstr ""
7221
7222 # type: textblock
7223 #. type: textblock
7224 #: ../src/guestfs-actions.pod:447 ../fish/guestfish-actions.pod:297
7225 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
7226 msgstr ""
7227
7228 # type: =head2
7229 #. type: =head2
7230 #: ../src/guestfs-actions.pod:454
7231 msgid "guestfs_aug_ls"
7232 msgstr ""
7233
7234 # type: verbatim
7235 #. type: verbatim
7236 #: ../src/guestfs-actions.pod:456
7237 #, no-wrap
7238 msgid ""
7239 " char **\n"
7240 " guestfs_aug_ls (guestfs_h *g,\n"
7241 "                 const char *augpath);\n"
7242 "\n"
7243 msgstr ""
7244
7245 # type: textblock
7246 #. type: textblock
7247 #: ../src/guestfs-actions.pod:460
7248 msgid ""
7249 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
7250 "sorting the resulting nodes into alphabetical order."
7251 msgstr ""
7252
7253 # type: textblock
7254 #. type: textblock
7255 #: ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:479
7256 #: ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:1073
7257 #: ../src/guestfs-actions.pod:1369 ../src/guestfs-actions.pod:1388
7258 #: ../src/guestfs-actions.pod:1491 ../src/guestfs-actions.pod:1510
7259 #: ../src/guestfs-actions.pod:1759 ../src/guestfs-actions.pod:2201
7260 #: ../src/guestfs-actions.pod:2217 ../src/guestfs-actions.pod:2236
7261 #: ../src/guestfs-actions.pod:2279 ../src/guestfs-actions.pod:2303
7262 #: ../src/guestfs-actions.pod:2374 ../src/guestfs-actions.pod:2423
7263 #: ../src/guestfs-actions.pod:2690 ../src/guestfs-actions.pod:2981
7264 #: ../src/guestfs-actions.pod:3270 ../src/guestfs-actions.pod:3560
7265 #: ../src/guestfs-actions.pod:3622 ../src/guestfs-actions.pod:3727
7266 #: ../src/guestfs-actions.pod:4132 ../src/guestfs-actions.pod:4830
7267 #: ../src/guestfs-actions.pod:5350 ../src/guestfs-actions.pod:5476
7268 #: ../src/guestfs-actions.pod:5590 ../src/guestfs-actions.pod:6290
7269 #: ../src/guestfs-actions.pod:6351 ../src/guestfs-actions.pod:6406
7270 #: ../src/guestfs-actions.pod:6552 ../src/guestfs-actions.pod:6576
7271 #: ../src/guestfs-actions.pod:7058 ../src/guestfs-actions.pod:7078
7272 #: ../src/guestfs-actions.pod:7125 ../src/guestfs-actions.pod:7290
7273 #: ../src/guestfs-actions.pod:7309 ../src/guestfs-actions.pod:7394
7274 #: ../src/guestfs-actions.pod:7413 ../src/guestfs-actions.pod:7459
7275 #: ../src/guestfs-actions.pod:7478
7276 msgid ""
7277 "This function returns a NULL-terminated array of strings (like L<environ(3)"
7278 ">), or NULL if there was an error.  I<The caller must free the strings and "
7279 "the array after use>."
7280 msgstr ""
7281
7282 # type: textblock
7283 #. type: textblock
7284 #: ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:998
7285 #: ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1426
7286 #: ../src/guestfs-actions.pod:3348 ../src/guestfs-actions.pod:3379
7287 #: ../src/guestfs-actions.pod:3973 ../src/guestfs-actions.pod:4023
7288 #: ../src/guestfs-actions.pod:4210 ../src/guestfs-actions.pod:4243
7289 #: ../src/guestfs-actions.pod:4406 ../src/guestfs-actions.pod:4834
7290 #: ../src/guestfs-actions.pod:5291 ../src/guestfs-actions.pod:5686
7291 #: ../src/guestfs-actions.pod:5700 ../src/guestfs-actions.pod:5712
7292 #: ../src/guestfs-actions.pod:6152 ../src/guestfs-actions.pod:6790
7293 #: ../src/guestfs-actions.pod:6803 ../src/guestfs-actions.pod:7042
7294 #: ../src/guestfs-actions.pod:7278
7295 msgid "(Added in 0.8)"
7296 msgstr ""
7297
7298 # type: =head2
7299 #. type: =head2
7300 #: ../src/guestfs-actions.pod:469
7301 msgid "guestfs_aug_match"
7302 msgstr ""
7303
7304 # type: verbatim
7305 #. type: verbatim
7306 #: ../src/guestfs-actions.pod:471
7307 #, no-wrap
7308 msgid ""
7309 " char **\n"
7310 " guestfs_aug_match (guestfs_h *g,\n"
7311 "                    const char *augpath);\n"
7312 "\n"
7313 msgstr ""
7314
7315 # type: textblock
7316 #. type: textblock
7317 #: ../src/guestfs-actions.pod:475 ../fish/guestfish-actions.pod:311
7318 msgid ""
7319 "Returns a list of paths which match the path expression C<path>.  The "
7320 "returned paths are sufficiently qualified so that they match exactly one "
7321 "node in the current tree."
7322 msgstr ""
7323
7324 # type: =head2
7325 #. type: =head2
7326 #: ../src/guestfs-actions.pod:485
7327 msgid "guestfs_aug_mv"
7328 msgstr ""
7329
7330 # type: verbatim
7331 #. type: verbatim
7332 #: ../src/guestfs-actions.pod:487
7333 #, no-wrap
7334 msgid ""
7335 " int\n"
7336 " guestfs_aug_mv (guestfs_h *g,\n"
7337 "                 const char *src,\n"
7338 "                 const char *dest);\n"
7339 "\n"
7340 msgstr ""
7341
7342 # type: textblock
7343 #. type: textblock
7344 #: ../src/guestfs-actions.pod:492 ../fish/guestfish-actions.pod:319
7345 msgid ""
7346 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
7347 "C<dest> is overwritten if it exists."
7348 msgstr ""
7349
7350 # type: =head2
7351 #. type: =head2
7352 #: ../src/guestfs-actions.pod:499
7353 msgid "guestfs_aug_rm"
7354 msgstr ""
7355
7356 # type: verbatim
7357 #. type: verbatim
7358 #: ../src/guestfs-actions.pod:501
7359 #, no-wrap
7360 msgid ""
7361 " int\n"
7362 " guestfs_aug_rm (guestfs_h *g,\n"
7363 "                 const char *augpath);\n"
7364 "\n"
7365 msgstr ""
7366
7367 # type: textblock
7368 #. type: textblock
7369 #: ../src/guestfs-actions.pod:505 ../fish/guestfish-actions.pod:326
7370 msgid "Remove C<path> and all of its children."
7371 msgstr ""
7372
7373 # type: textblock
7374 #. type: textblock
7375 #: ../src/guestfs-actions.pod:507 ../fish/guestfish-actions.pod:328
7376 msgid "On success this returns the number of entries which were removed."
7377 msgstr ""
7378
7379 # type: =head2
7380 #. type: =head2
7381 #: ../src/guestfs-actions.pod:513
7382 msgid "guestfs_aug_save"
7383 msgstr ""
7384
7385 # type: verbatim
7386 #. type: verbatim
7387 #: ../src/guestfs-actions.pod:515
7388 #, no-wrap
7389 msgid ""
7390 " int\n"
7391 " guestfs_aug_save (guestfs_h *g);\n"
7392 "\n"
7393 msgstr ""
7394
7395 # type: textblock
7396 #. type: textblock
7397 #: ../src/guestfs-actions.pod:518 ../fish/guestfish-actions.pod:334
7398 msgid "This writes all pending changes to disk."
7399 msgstr ""
7400
7401 # type: textblock
7402 #. type: textblock
7403 #: ../src/guestfs-actions.pod:520
7404 msgid ""
7405 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
7406 "are saved."
7407 msgstr ""
7408
7409 # type: =head2
7410 #. type: =head2
7411 #: ../src/guestfs-actions.pod:527
7412 msgid "guestfs_aug_set"
7413 msgstr ""
7414
7415 # type: verbatim
7416 #. type: verbatim
7417 #: ../src/guestfs-actions.pod:529
7418 #, no-wrap
7419 msgid ""
7420 " int\n"
7421 " guestfs_aug_set (guestfs_h *g,\n"
7422 "                  const char *augpath,\n"
7423 "                  const char *val);\n"
7424 "\n"
7425 msgstr ""
7426
7427 # type: textblock
7428 #. type: textblock
7429 #: ../src/guestfs-actions.pod:534 ../fish/guestfish-actions.pod:343
7430 msgid "Set the value associated with C<path> to C<val>."
7431 msgstr ""
7432
7433 # type: textblock
7434 #. type: textblock
7435 #: ../src/guestfs-actions.pod:536
7436 msgid ""
7437 "In the Augeas API, it is possible to clear a node by setting the value to "
7438 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
7439 "this call.  Instead you must use the C<guestfs_aug_clear> call."
7440 msgstr ""
7441
7442 # type: =head2
7443 #. type: =head2
7444 #: ../src/guestfs-actions.pod:545
7445 msgid "guestfs_available"
7446 msgstr ""
7447
7448 # type: verbatim
7449 #. type: verbatim
7450 #: ../src/guestfs-actions.pod:547
7451 #, no-wrap
7452 msgid ""
7453 " int\n"
7454 " guestfs_available (guestfs_h *g,\n"
7455 "                    char *const *groups);\n"
7456 "\n"
7457 msgstr ""
7458
7459 # type: textblock
7460 #. type: textblock
7461 #: ../src/guestfs-actions.pod:551 ../fish/guestfish-actions.pod:354
7462 msgid ""
7463 "This command is used to check the availability of some groups of "
7464 "functionality in the appliance, which not all builds of the libguestfs "
7465 "appliance will be able to provide."
7466 msgstr ""
7467
7468 # type: textblock
7469 #. type: textblock
7470 #: ../src/guestfs-actions.pod:555
7471 msgid ""
7472 "The libguestfs groups, and the functions that those groups correspond to, "
7473 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
7474 "runtime by calling C<guestfs_available_all_groups>."
7475 msgstr ""
7476
7477 # type: textblock
7478 #. type: textblock
7479 #: ../src/guestfs-actions.pod:560 ../fish/guestfish-actions.pod:363
7480 msgid ""
7481 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7482 "\"]> would check for the availability of the Linux inotify functions and "
7483 "Augeas (configuration file editing) functions."
7484 msgstr ""
7485
7486 # type: textblock
7487 #. type: textblock
7488 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368
7489 msgid "The command returns no error if I<all> requested groups are available."
7490 msgstr ""
7491
7492 # type: textblock
7493 #. type: textblock
7494 #: ../src/guestfs-actions.pod:567 ../fish/guestfish-actions.pod:370
7495 msgid ""
7496 "It fails with an error if one or more of the requested groups is unavailable "
7497 "in the appliance."
7498 msgstr ""
7499
7500 # type: textblock
7501 #. type: textblock
7502 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373
7503 msgid ""
7504 "If an unknown group name is included in the list of groups then an error is "
7505 "always returned."
7506 msgstr ""
7507
7508 # type: textblock
7509 #. type: textblock
7510 #: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:376
7511 msgid "I<Notes:>"
7512 msgstr ""
7513
7514 # type: textblock
7515 #. type: textblock
7516 #: ../src/guestfs-actions.pod:579
7517 msgid "You must call C<guestfs_launch> before calling this function."
7518 msgstr ""
7519
7520 # type: textblock
7521 #. type: textblock
7522 #: ../src/guestfs-actions.pod:581 ../fish/guestfish-actions.pod:384
7523 msgid ""
7524 "The reason is because we don't know what groups are supported by the "
7525 "appliance/daemon until it is running and can be queried."
7526 msgstr ""
7527
7528 # type: textblock
7529 #. type: textblock
7530 #: ../src/guestfs-actions.pod:587 ../fish/guestfish-actions.pod:390
7531 msgid ""
7532 "If a group of functions is available, this does not necessarily mean that "
7533 "they will work.  You still have to check for errors when calling individual "
7534 "API functions even if they are available."
7535 msgstr ""
7536
7537 # type: textblock
7538 #. type: textblock
7539 #: ../src/guestfs-actions.pod:594 ../fish/guestfish-actions.pod:397
7540 msgid ""
7541 "It is usually the job of distro packagers to build complete functionality "
7542 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
7543 "with all requirements satisfied, will support everything."
7544 msgstr ""
7545
7546 # type: textblock
7547 #. type: textblock
7548 #: ../src/guestfs-actions.pod:601
7549 msgid ""
7550 "This call was added in version C<1.0.80>.  In previous versions of "
7551 "libguestfs all you could do would be to speculatively execute a command to "
7552 "find out if the daemon implemented it.  See also C<guestfs_version>."
7553 msgstr ""
7554
7555 # type: textblock
7556 #. type: textblock
7557 #: ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:1171
7558 msgid "(Added in 1.0.80)"
7559 msgstr ""
7560
7561 # type: =head2
7562 #. type: =head2
7563 #: ../src/guestfs-actions.pod:612
7564 msgid "guestfs_available_all_groups"
7565 msgstr ""
7566
7567 # type: verbatim
7568 #. type: verbatim
7569 #: ../src/guestfs-actions.pod:614
7570 #, no-wrap
7571 msgid ""
7572 " char **\n"
7573 " guestfs_available_all_groups (guestfs_h *g);\n"
7574 "\n"
7575 msgstr ""
7576
7577 # type: textblock
7578 #. type: textblock
7579 #: ../src/guestfs-actions.pod:617
7580 msgid ""
7581 "This command returns a list of all optional groups that this daemon knows "
7582 "about.  Note this returns both supported and unsupported groups.  To find "
7583 "out which ones the daemon can actually support you have to call "
7584 "C<guestfs_available> on each member of the returned list."
7585 msgstr ""
7586
7587 # type: textblock
7588 #. type: textblock
7589 #: ../src/guestfs-actions.pod:623
7590 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7591 msgstr ""
7592
7593 # type: textblock
7594 #. type: textblock
7595 #: ../src/guestfs-actions.pod:629
7596 msgid "(Added in 1.3.15)"
7597 msgstr ""
7598
7599 # type: =head2
7600 #. type: =head2
7601 #: ../src/guestfs-actions.pod:631
7602 msgid "guestfs_base64_in"
7603 msgstr ""
7604
7605 # type: verbatim
7606 #. type: verbatim
7607 #: ../src/guestfs-actions.pod:633
7608 #, no-wrap
7609 msgid ""
7610 " int\n"
7611 " guestfs_base64_in (guestfs_h *g,\n"
7612 "                    const char *base64file,\n"
7613 "                    const char *filename);\n"
7614 "\n"
7615 msgstr ""
7616
7617 # type: textblock
7618 #. type: textblock
7619 #: ../src/guestfs-actions.pod:638 ../fish/guestfish-actions.pod:427
7620 msgid ""
7621 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7622 msgstr ""
7623
7624 # type: textblock
7625 #. type: textblock
7626 #: ../src/guestfs-actions.pod:643 ../src/guestfs-actions.pod:657
7627 msgid "(Added in 1.3.5)"
7628 msgstr ""
7629
7630 # type: =head2
7631 #. type: =head2
7632 #: ../src/guestfs-actions.pod:645
7633 msgid "guestfs_base64_out"
7634 msgstr ""
7635
7636 # type: verbatim
7637 #. type: verbatim
7638 #: ../src/guestfs-actions.pod:647
7639 #, no-wrap
7640 msgid ""
7641 " int\n"
7642 " guestfs_base64_out (guestfs_h *g,\n"
7643 "                     const char *filename,\n"
7644 "                     const char *base64file);\n"
7645 "\n"
7646 msgstr ""
7647
7648 # type: textblock
7649 #. type: textblock
7650 #: ../src/guestfs-actions.pod:652 ../fish/guestfish-actions.pod:436
7651 msgid ""
7652 "This command downloads the contents of C<filename>, writing it out to local "
7653 "file C<base64file> encoded as base64."
7654 msgstr ""
7655
7656 # type: =head2
7657 #. type: =head2
7658 #: ../src/guestfs-actions.pod:659
7659 msgid "guestfs_blockdev_flushbufs"
7660 msgstr ""
7661
7662 # type: verbatim
7663 #. type: verbatim
7664 #: ../src/guestfs-actions.pod:661
7665 #, no-wrap
7666 msgid ""
7667 " int\n"
7668 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7669 "                             const char *device);\n"
7670 "\n"
7671 msgstr ""
7672
7673 # type: textblock
7674 #. type: textblock
7675 #: ../src/guestfs-actions.pod:665 ../fish/guestfish-actions.pod:445
7676 msgid ""
7677 "This tells the kernel to flush internal buffers associated with C<device>."
7678 msgstr ""
7679
7680 # type: textblock
7681 #. type: textblock
7682 #: ../src/guestfs-actions.pod:668 ../src/guestfs-actions.pod:685
7683 #: ../src/guestfs-actions.pod:700 ../src/guestfs-actions.pod:716
7684 #: ../src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:753
7685 #: ../src/guestfs-actions.pod:767 ../src/guestfs-actions.pod:785
7686 #: ../src/guestfs-actions.pod:799 ../src/guestfs-actions.pod:813
7687 #: ../fish/guestfish-actions.pod:448 ../fish/guestfish-actions.pod:459
7688 #: ../fish/guestfish-actions.pod:468 ../fish/guestfish-actions.pod:478
7689 #: ../fish/guestfish-actions.pod:490 ../fish/guestfish-actions.pod:503
7690 #: ../fish/guestfish-actions.pod:511 ../fish/guestfish-actions.pod:522
7691 #: ../fish/guestfish-actions.pod:530 ../fish/guestfish-actions.pod:538
7692 msgid "This uses the L<blockdev(8)> command."
7693 msgstr ""
7694
7695 # type: textblock
7696 #. type: textblock
7697 #: ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:689
7698 #: ../src/guestfs-actions.pod:704 ../src/guestfs-actions.pod:720
7699 #: ../src/guestfs-actions.pod:738 ../src/guestfs-actions.pod:757
7700 #: ../src/guestfs-actions.pod:771 ../src/guestfs-actions.pod:789
7701 #: ../src/guestfs-actions.pod:803 ../src/guestfs-actions.pod:817
7702 msgid "(Added in 0.9.3)"
7703 msgstr ""
7704
7705 # type: =head2
7706 #. type: =head2
7707 #: ../src/guestfs-actions.pod:674
7708 msgid "guestfs_blockdev_getbsz"
7709 msgstr ""
7710
7711 # type: verbatim
7712 #. type: verbatim
7713 #: ../src/guestfs-actions.pod:676
7714 #, no-wrap
7715 msgid ""
7716 " int\n"
7717 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7718 "                          const char *device);\n"
7719 "\n"
7720 msgstr ""
7721
7722 # type: textblock
7723 #. type: textblock
7724 #: ../src/guestfs-actions.pod:680 ../fish/guestfish-actions.pod:454
7725 msgid "This returns the block size of a device."
7726 msgstr ""
7727
7728 # type: textblock
7729 #. type: textblock
7730 #: ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:782
7731 #: ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:519
7732 msgid ""
7733 "(Note this is different from both I<size in blocks> and I<filesystem block "
7734 "size>)."
7735 msgstr ""
7736
7737 # type: =head2
7738 #. type: =head2
7739 #: ../src/guestfs-actions.pod:691
7740 msgid "guestfs_blockdev_getro"
7741 msgstr ""
7742
7743 # type: verbatim
7744 #. type: verbatim
7745 #: ../src/guestfs-actions.pod:693
7746 #, no-wrap
7747 msgid ""
7748 " int\n"
7749 " guestfs_blockdev_getro (guestfs_h *g,\n"
7750 "                         const char *device);\n"
7751 "\n"
7752 msgstr ""
7753
7754 # type: textblock
7755 #. type: textblock
7756 #: ../src/guestfs-actions.pod:697 ../fish/guestfish-actions.pod:465
7757 msgid ""
7758 "Returns a boolean indicating if the block device is read-only (true if read-"
7759 "only, false if not)."
7760 msgstr ""
7761
7762 # type: textblock
7763 #. type: textblock
7764 #: ../src/guestfs-actions.pod:702 ../src/guestfs-actions.pod:1409
7765 #: ../src/guestfs-actions.pod:1424 ../src/guestfs-actions.pod:1914
7766 #: ../src/guestfs-actions.pod:1925 ../src/guestfs-actions.pod:1997
7767 #: ../src/guestfs-actions.pod:2052 ../src/guestfs-actions.pod:2067
7768 #: ../src/guestfs-actions.pod:2092 ../src/guestfs-actions.pod:2115
7769 #: ../src/guestfs-actions.pod:3088 ../src/guestfs-actions.pod:3105
7770 #: ../src/guestfs-actions.pod:3124 ../src/guestfs-actions.pod:3287
7771 #: ../src/guestfs-actions.pod:3301 ../src/guestfs-actions.pod:3316
7772 #: ../src/guestfs-actions.pod:3330 ../src/guestfs-actions.pod:3346
7773 #: ../src/guestfs-actions.pod:3361 ../src/guestfs-actions.pod:3377
7774 #: ../src/guestfs-actions.pod:3391 ../src/guestfs-actions.pod:3404
7775 #: ../src/guestfs-actions.pod:3418 ../src/guestfs-actions.pod:3433
7776 #: ../src/guestfs-actions.pod:3448 ../src/guestfs-actions.pod:4979
7777 msgid "This function returns a C truth value on success or -1 on error."
7778 msgstr ""
7779
7780 # type: =head2
7781 #. type: =head2
7782 #: ../src/guestfs-actions.pod:706
7783 msgid "guestfs_blockdev_getsize64"
7784 msgstr ""
7785
7786 # type: verbatim
7787 #. type: verbatim
7788 #: ../src/guestfs-actions.pod:708
7789 #, no-wrap
7790 msgid ""
7791 " int64_t\n"
7792 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7793 "                             const char *device);\n"
7794 "\n"
7795 msgstr ""
7796
7797 # type: textblock
7798 #. type: textblock
7799 #: ../src/guestfs-actions.pod:712 ../fish/guestfish-actions.pod:474
7800 msgid "This returns the size of the device in bytes."
7801 msgstr ""
7802
7803 # type: textblock
7804 #. type: textblock
7805 #: ../src/guestfs-actions.pod:714
7806 msgid "See also C<guestfs_blockdev_getsz>."
7807 msgstr ""
7808
7809 # type: =head2
7810 #. type: =head2
7811 #: ../src/guestfs-actions.pod:722
7812 msgid "guestfs_blockdev_getss"
7813 msgstr ""
7814
7815 # type: verbatim
7816 #. type: verbatim
7817 #: ../src/guestfs-actions.pod:724
7818 #, no-wrap
7819 msgid ""
7820 " int\n"
7821 " guestfs_blockdev_getss (guestfs_h *g,\n"
7822 "                         const char *device);\n"
7823 "\n"
7824 msgstr ""
7825
7826 # type: textblock
7827 #. type: textblock
7828 #: ../src/guestfs-actions.pod:728 ../fish/guestfish-actions.pod:484
7829 msgid ""
7830 "This returns the size of sectors on a block device.  Usually 512, but can be "
7831 "larger for modern devices."
7832 msgstr ""
7833
7834 # type: textblock
7835 #. type: textblock
7836 #: ../src/guestfs-actions.pod:731
7837 msgid ""
7838 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
7839 "that)."
7840 msgstr ""
7841
7842 # type: =head2
7843 #. type: =head2
7844 #: ../src/guestfs-actions.pod:740
7845 msgid "guestfs_blockdev_getsz"
7846 msgstr ""
7847
7848 # type: verbatim
7849 #. type: verbatim
7850 #: ../src/guestfs-actions.pod:742
7851 #, no-wrap
7852 msgid ""
7853 " int64_t\n"
7854 " guestfs_blockdev_getsz (guestfs_h *g,\n"
7855 "                         const char *device);\n"
7856 "\n"
7857 msgstr ""
7858
7859 # type: textblock
7860 #. type: textblock
7861 #: ../src/guestfs-actions.pod:746 ../fish/guestfish-actions.pod:496
7862 msgid ""
7863 "This returns the size of the device in units of 512-byte sectors (even if "
7864 "the sectorsize isn't 512 bytes ... weird)."
7865 msgstr ""
7866
7867 # type: textblock
7868 #. type: textblock
7869 #: ../src/guestfs-actions.pod:749
7870 msgid ""
7871 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
7872 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
7873 msgstr ""
7874
7875 # type: =head2
7876 #. type: =head2
7877 #: ../src/guestfs-actions.pod:759
7878 msgid "guestfs_blockdev_rereadpt"
7879 msgstr ""
7880
7881 # type: verbatim
7882 #. type: verbatim
7883 #: ../src/guestfs-actions.pod:761
7884 #, no-wrap
7885 msgid ""
7886 " int\n"
7887 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
7888 "                            const char *device);\n"
7889 "\n"
7890 msgstr ""
7891
7892 # type: textblock
7893 #. type: textblock
7894 #: ../src/guestfs-actions.pod:765 ../fish/guestfish-actions.pod:509
7895 msgid "Reread the partition table on C<device>."
7896 msgstr ""
7897
7898 # type: =head2
7899 #. type: =head2
7900 #: ../src/guestfs-actions.pod:773
7901 msgid "guestfs_blockdev_setbsz"
7902 msgstr ""
7903
7904 # type: verbatim
7905 #. type: verbatim
7906 #: ../src/guestfs-actions.pod:775
7907 #, no-wrap
7908 msgid ""
7909 " int\n"
7910 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
7911 "                          const char *device,\n"
7912 "                          int blocksize);\n"
7913 "\n"
7914 msgstr ""
7915
7916 # type: textblock
7917 #. type: textblock
7918 #: ../src/guestfs-actions.pod:780 ../fish/guestfish-actions.pod:517
7919 msgid "This sets the block size of a device."
7920 msgstr ""
7921
7922 # type: =head2
7923 #. type: =head2
7924 #: ../src/guestfs-actions.pod:791
7925 msgid "guestfs_blockdev_setro"
7926 msgstr ""
7927
7928 # type: verbatim
7929 #. type: verbatim
7930 #: ../src/guestfs-actions.pod:793
7931 #, no-wrap
7932 msgid ""
7933 " int\n"
7934 " guestfs_blockdev_setro (guestfs_h *g,\n"
7935 "                         const char *device);\n"
7936 "\n"
7937 msgstr ""
7938
7939 # type: textblock
7940 #. type: textblock
7941 #: ../src/guestfs-actions.pod:797 ../fish/guestfish-actions.pod:528
7942 msgid "Sets the block device named C<device> to read-only."
7943 msgstr ""
7944
7945 # type: =head2
7946 #. type: =head2
7947 #: ../src/guestfs-actions.pod:805
7948 msgid "guestfs_blockdev_setrw"
7949 msgstr ""
7950
7951 # type: verbatim
7952 #. type: verbatim
7953 #: ../src/guestfs-actions.pod:807
7954 #, no-wrap
7955 msgid ""
7956 " int\n"
7957 " guestfs_blockdev_setrw (guestfs_h *g,\n"
7958 "                         const char *device);\n"
7959 "\n"
7960 msgstr ""
7961
7962 # type: textblock
7963 #. type: textblock
7964 #: ../src/guestfs-actions.pod:811 ../fish/guestfish-actions.pod:536
7965 msgid "Sets the block device named C<device> to read-write."
7966 msgstr ""
7967
7968 # type: =head2
7969 #. type: =head2
7970 #: ../src/guestfs-actions.pod:819
7971 msgid "guestfs_case_sensitive_path"
7972 msgstr ""
7973
7974 # type: verbatim
7975 #. type: verbatim
7976 #: ../src/guestfs-actions.pod:821
7977 #, no-wrap
7978 msgid ""
7979 " char *\n"
7980 " guestfs_case_sensitive_path (guestfs_h *g,\n"
7981 "                              const char *path);\n"
7982 "\n"
7983 msgstr ""
7984
7985 # type: textblock
7986 #. type: textblock
7987 #: ../src/guestfs-actions.pod:825 ../fish/guestfish-actions.pod:544
7988 msgid ""
7989 "This can be used to resolve case insensitive paths on a filesystem which is "
7990 "case sensitive.  The use case is to resolve paths which you have read from "
7991 "Windows configuration files or the Windows Registry, to the true path."
7992 msgstr ""
7993
7994 # type: textblock
7995 #. type: textblock
7996 #: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549
7997 msgid ""
7998 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
7999 "(and probably others), which is that although the underlying filesystem is "
8000 "case-insensitive, the driver exports the filesystem to Linux as case-"
8001 "sensitive."
8002 msgstr ""
8003
8004 # type: textblock
8005 #. type: textblock
8006 #: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554
8007 msgid ""
8008 "One consequence of this is that special directories such as C<c:\\windows> "
8009 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
8010 "precise details of how they were created.  In Windows itself this would not "
8011 "be a problem."
8012 msgstr ""
8013
8014 # type: textblock
8015 #. type: textblock
8016 #: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:560
8017 msgid ""
8018 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
8019 "#posixfilenames1>"
8020 msgstr ""
8021
8022 # type: textblock
8023 #. type: textblock
8024 #: ../src/guestfs-actions.pod:844 ../fish/guestfish-actions.pod:563
8025 msgid ""
8026 "This function resolves the true case of each element in the path and returns "
8027 "the case-sensitive path."
8028 msgstr ""
8029
8030 # type: textblock
8031 #. type: textblock
8032 #: ../src/guestfs-actions.pod:847
8033 msgid ""
8034 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
8035 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
8036 "how the directories were originally created under Windows)."
8037 msgstr ""
8038
8039 # type: textblock
8040 #. type: textblock
8041 #: ../src/guestfs-actions.pod:852 ../fish/guestfish-actions.pod:571
8042 msgid "I<Note>: This function does not handle drive names, backslashes etc."
8043 msgstr ""
8044
8045 # type: textblock
8046 #. type: textblock
8047 #: ../src/guestfs-actions.pod:855
8048 msgid "See also C<guestfs_realpath>."
8049 msgstr ""
8050
8051 # type: textblock
8052 #. type: textblock
8053 #: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:6970
8054 msgid "(Added in 1.0.75)"
8055 msgstr ""
8056
8057 # type: =head2
8058 #. type: =head2
8059 #: ../src/guestfs-actions.pod:862
8060 msgid "guestfs_cat"
8061 msgstr ""
8062
8063 # type: verbatim
8064 #. type: verbatim
8065 #: ../src/guestfs-actions.pod:864
8066 #, no-wrap
8067 msgid ""
8068 " char *\n"
8069 " guestfs_cat (guestfs_h *g,\n"
8070 "              const char *path);\n"
8071 "\n"
8072 msgstr ""
8073
8074 # type: textblock
8075 #. type: textblock
8076 #: ../src/guestfs-actions.pod:868 ../src/guestfs-actions.pod:5466
8077 #: ../fish/guestfish-actions.pod:580 ../fish/guestfish-actions.pod:3667
8078 msgid "Return the contents of the file named C<path>."
8079 msgstr ""
8080
8081 # type: textblock
8082 #. type: textblock
8083 #: ../src/guestfs-actions.pod:870
8084 msgid ""
8085 "Note that this function cannot correctly handle binary files (specifically, "
8086 "files containing C<\\0> character which is treated as end of string).  For "
8087 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
8088 "functions which have a more complex interface."
8089 msgstr ""
8090
8091 # type: textblock
8092 #. type: textblock
8093 #: ../src/guestfs-actions.pod:878 ../src/guestfs-actions.pod:1057
8094 #: ../src/guestfs-actions.pod:1077 ../src/guestfs-actions.pod:1373
8095 #: ../src/guestfs-actions.pod:1392 ../src/guestfs-actions.pod:1495
8096 #: ../src/guestfs-actions.pod:1514 ../src/guestfs-actions.pod:1763
8097 #: ../src/guestfs-actions.pod:2221 ../src/guestfs-actions.pod:2240
8098 #: ../src/guestfs-actions.pod:2283 ../src/guestfs-actions.pod:2307
8099 #: ../src/guestfs-actions.pod:2324 ../src/guestfs-actions.pod:2353
8100 #: ../src/guestfs-actions.pod:5248 ../src/guestfs-actions.pod:5274
8101 #: ../src/guestfs-actions.pod:5405 ../src/guestfs-actions.pod:5431
8102 #: ../src/guestfs-actions.pod:5455 ../src/guestfs-actions.pod:6355
8103 #: ../src/guestfs-actions.pod:6410 ../src/guestfs-actions.pod:6556
8104 #: ../src/guestfs-actions.pod:6580 ../src/guestfs-actions.pod:7242
8105 #: ../src/guestfs-actions.pod:7268 ../src/guestfs-actions.pod:7294
8106 #: ../src/guestfs-actions.pod:7313 ../src/guestfs-actions.pod:7398
8107 #: ../src/guestfs-actions.pod:7417 ../src/guestfs-actions.pod:7463
8108 #: ../src/guestfs-actions.pod:7482 ../fish/guestfish-actions.pod:587
8109 #: ../fish/guestfish-actions.pod:722 ../fish/guestfish-actions.pod:734
8110 #: ../fish/guestfish-actions.pod:910 ../fish/guestfish-actions.pod:920
8111 #: ../fish/guestfish-actions.pod:987 ../fish/guestfish-actions.pod:997
8112 #: ../fish/guestfish-actions.pod:1192 ../fish/guestfish-actions.pod:1493
8113 #: ../fish/guestfish-actions.pod:1503 ../fish/guestfish-actions.pod:1531
8114 #: ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:1556
8115 #: ../fish/guestfish-actions.pod:1575 ../fish/guestfish-actions.pod:3537
8116 #: ../fish/guestfish-actions.pod:3552 ../fish/guestfish-actions.pod:3628
8117 #: ../fish/guestfish-actions.pod:3645 ../fish/guestfish-actions.pod:3660
8118 #: ../fish/guestfish-actions.pod:4286 ../fish/guestfish-actions.pod:4332
8119 #: ../fish/guestfish-actions.pod:4417 ../fish/guestfish-actions.pod:4432
8120 #: ../fish/guestfish-actions.pod:4842 ../fish/guestfish-actions.pod:4860
8121 #: ../fish/guestfish-actions.pod:4877 ../fish/guestfish-actions.pod:4887
8122 #: ../fish/guestfish-actions.pod:4935 ../fish/guestfish-actions.pod:4945
8123 #: ../fish/guestfish-actions.pod:4974 ../fish/guestfish-actions.pod:4984
8124 msgid ""
8125 "Because of the message protocol, there is a transfer limit of somewhere "
8126 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
8127 msgstr ""
8128
8129 # type: textblock
8130 #. type: textblock
8131 #: ../src/guestfs-actions.pod:881 ../src/guestfs-actions.pod:3564
8132 #: ../src/guestfs-actions.pod:3626 ../src/guestfs-actions.pod:3643
8133 #: ../src/guestfs-actions.pod:3731 ../src/guestfs-actions.pod:4136
8134 #: ../src/guestfs-actions.pod:4150 ../src/guestfs-actions.pod:5354
8135 #: ../src/guestfs-actions.pod:5368 ../src/guestfs-actions.pod:7129
8136 #: ../src/guestfs-actions.pod:7143
8137 msgid "(Added in 0.4)"
8138 msgstr ""
8139
8140 # type: =head2
8141 #. type: =head2
8142 #: ../src/guestfs-actions.pod:883
8143 msgid "guestfs_checksum"
8144 msgstr ""
8145
8146 # type: verbatim
8147 #. type: verbatim
8148 #: ../src/guestfs-actions.pod:885
8149 #, no-wrap
8150 msgid ""
8151 " char *\n"
8152 " guestfs_checksum (guestfs_h *g,\n"
8153 "                   const char *csumtype,\n"
8154 "                   const char *path);\n"
8155 "\n"
8156 msgstr ""
8157
8158 # type: textblock
8159 #. type: textblock
8160 #: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:594
8161 msgid ""
8162 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
8163 msgstr ""
8164
8165 # type: textblock
8166 #. type: textblock
8167 #: ../src/guestfs-actions.pod:893 ../fish/guestfish-actions.pod:597
8168 msgid ""
8169 "The type of checksum to compute is given by the C<csumtype> parameter which "
8170 "must have one of the following values:"
8171 msgstr ""
8172
8173 # type: =item
8174 #. type: =item
8175 #: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602
8176 msgid "C<crc>"
8177 msgstr ""
8178
8179 # type: textblock
8180 #. type: textblock
8181 #: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:604
8182 msgid ""
8183 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
8184 "C<cksum> command."
8185 msgstr ""
8186
8187 # type: =item
8188 #. type: =item
8189 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607
8190 msgid "C<md5>"
8191 msgstr ""
8192
8193 # type: textblock
8194 #. type: textblock
8195 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609
8196 msgid "Compute the MD5 hash (using the C<md5sum> program)."
8197 msgstr ""
8198
8199 # type: =item
8200 #. type: =item
8201 #: ../src/guestfs-actions.pod:907 ../fish/guestfish-actions.pod:611
8202 msgid "C<sha1>"
8203 msgstr ""
8204
8205 # type: textblock
8206 #. type: textblock
8207 #: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:613
8208 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
8209 msgstr ""
8210
8211 # type: =item
8212 #. type: =item
8213 #: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:615
8214 msgid "C<sha224>"
8215 msgstr ""
8216
8217 # type: textblock
8218 #. type: textblock
8219 #: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:617
8220 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
8221 msgstr ""
8222
8223 # type: =item
8224 #. type: =item
8225 #: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:619
8226 msgid "C<sha256>"
8227 msgstr ""
8228
8229 # type: textblock
8230 #. type: textblock
8231 #: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:621
8232 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
8233 msgstr ""
8234
8235 # type: =item
8236 #. type: =item
8237 #: ../src/guestfs-actions.pod:919 ../fish/guestfish-actions.pod:623
8238 msgid "C<sha384>"
8239 msgstr ""
8240
8241 # type: textblock
8242 #. type: textblock
8243 #: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:625
8244 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
8245 msgstr ""
8246
8247 # type: =item
8248 #. type: =item
8249 #: ../src/guestfs-actions.pod:923 ../fish/guestfish-actions.pod:627
8250 msgid "C<sha512>"
8251 msgstr ""
8252
8253 # type: textblock
8254 #. type: textblock
8255 #: ../src/guestfs-actions.pod:925 ../fish/guestfish-actions.pod:629
8256 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
8257 msgstr ""
8258
8259 # type: textblock
8260 #. type: textblock
8261 #: ../src/guestfs-actions.pod:929 ../fish/guestfish-actions.pod:633
8262 msgid "The checksum is returned as a printable string."
8263 msgstr ""
8264
8265 # type: textblock
8266 #. type: textblock
8267 #: ../src/guestfs-actions.pod:931
8268 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
8269 msgstr ""
8270
8271 # type: textblock
8272 #. type: textblock
8273 #: ../src/guestfs-actions.pod:933
8274 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
8275 msgstr ""
8276
8277 # type: textblock
8278 #. type: textblock
8279 #: ../src/guestfs-actions.pod:938 ../src/guestfs-actions.pod:1246
8280 #: ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:3303
8281 #: ../src/guestfs-actions.pod:3332 ../src/guestfs-actions.pod:3393
8282 #: ../src/guestfs-actions.pod:3420 ../src/guestfs-actions.pod:6826
8283 msgid "(Added in 1.0.2)"
8284 msgstr ""
8285
8286 # type: =head2
8287 #. type: =head2
8288 #: ../src/guestfs-actions.pod:940
8289 msgid "guestfs_checksum_device"
8290 msgstr ""
8291
8292 # type: verbatim
8293 #. type: verbatim
8294 #: ../src/guestfs-actions.pod:942
8295 #, no-wrap
8296 msgid ""
8297 " char *\n"
8298 " guestfs_checksum_device (guestfs_h *g,\n"
8299 "                          const char *csumtype,\n"
8300 "                          const char *device);\n"
8301 "\n"
8302 msgstr ""
8303
8304 # type: textblock
8305 #. type: textblock
8306 #: ../src/guestfs-actions.pod:947
8307 msgid ""
8308 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
8309 "device named C<device>.  For the types of checksums supported see the "
8310 "C<guestfs_checksum> command."
8311 msgstr ""
8312
8313 # type: textblock
8314 #. type: textblock
8315 #: ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:4885
8316 #: ../src/guestfs-actions.pod:4944 ../src/guestfs-actions.pod:4981
8317 #: ../src/guestfs-actions.pod:4999 ../src/guestfs-actions.pod:5175
8318 #: ../src/guestfs-actions.pod:6735 ../src/guestfs-actions.pod:6749
8319 #: ../src/guestfs-actions.pod:7155
8320 msgid "(Added in 1.3.2)"
8321 msgstr ""
8322
8323 # type: =head2
8324 #. type: =head2
8325 #: ../src/guestfs-actions.pod:956
8326 msgid "guestfs_checksums_out"
8327 msgstr ""
8328
8329 # type: verbatim
8330 #. type: verbatim
8331 #: ../src/guestfs-actions.pod:958
8332 #, no-wrap
8333 msgid ""
8334 " int\n"
8335 " guestfs_checksums_out (guestfs_h *g,\n"
8336 "                        const char *csumtype,\n"
8337 "                        const char *directory,\n"
8338 "                        const char *sumsfile);\n"
8339 "\n"
8340 msgstr ""
8341
8342 # type: textblock
8343 #. type: textblock
8344 #: ../src/guestfs-actions.pod:964 ../fish/guestfish-actions.pod:651
8345 msgid ""
8346 "This command computes the checksums of all regular files in C<directory> and "
8347 "then emits a list of those checksums to the local output file C<sumsfile>."
8348 msgstr ""
8349
8350 # type: textblock
8351 #. type: textblock
8352 #: ../src/guestfs-actions.pod:968 ../fish/guestfish-actions.pod:655
8353 msgid ""
8354 "This can be used for verifying the integrity of a virtual machine.  However "
8355 "to be properly secure you should pay attention to the output of the checksum "
8356 "command (it uses the ones from GNU coreutils).  In particular when the "
8357 "filename is not printable, coreutils uses a special backslash syntax.  For "
8358 "more information, see the GNU coreutils info file."
8359 msgstr ""
8360
8361 # type: textblock
8362 #. type: textblock
8363 #: ../src/guestfs-actions.pod:978
8364 msgid "(Added in 1.3.7)"
8365 msgstr ""
8366
8367 # type: =head2
8368 #. type: =head2
8369 #: ../src/guestfs-actions.pod:980
8370 msgid "guestfs_chmod"
8371 msgstr ""
8372
8373 # type: verbatim
8374 #. type: verbatim
8375 #: ../src/guestfs-actions.pod:982
8376 #, no-wrap
8377 msgid ""
8378 " int\n"
8379 " guestfs_chmod (guestfs_h *g,\n"
8380 "                int mode,\n"
8381 "                const char *path);\n"
8382 "\n"
8383 msgstr ""
8384
8385 # type: textblock
8386 #. type: textblock
8387 #: ../src/guestfs-actions.pod:987 ../fish/guestfish-actions.pod:669
8388 msgid ""
8389 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
8390 "supported."
8391 msgstr ""
8392
8393 # type: textblock
8394 #. type: textblock
8395 #: ../src/guestfs-actions.pod:990 ../fish/guestfish-actions.pod:672
8396 msgid ""
8397 "I<Note>: When using this command from guestfish, C<mode> by default would be "
8398 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
8399 "C<700>."
8400 msgstr ""
8401
8402 # type: textblock
8403 #. type: textblock
8404 #: ../src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:4387
8405 #: ../src/guestfs-actions.pod:4584 ../src/guestfs-actions.pod:4603
8406 #: ../src/guestfs-actions.pod:4622 ../fish/guestfish-actions.pod:676
8407 #: ../fish/guestfish-actions.pod:2983 ../fish/guestfish-actions.pod:3112
8408 #: ../fish/guestfish-actions.pod:3122 ../fish/guestfish-actions.pod:3132
8409 msgid "The mode actually set is affected by the umask."
8410 msgstr ""
8411
8412 # type: =head2
8413 #. type: =head2
8414 #: ../src/guestfs-actions.pod:1000
8415 msgid "guestfs_chown"
8416 msgstr ""
8417
8418 # type: verbatim
8419 #. type: verbatim
8420 #: ../src/guestfs-actions.pod:1002
8421 #, no-wrap
8422 msgid ""
8423 " int\n"
8424 " guestfs_chown (guestfs_h *g,\n"
8425 "                int owner,\n"
8426 "                int group,\n"
8427 "                const char *path);\n"
8428 "\n"
8429 msgstr ""
8430
8431 # type: textblock
8432 #. type: textblock
8433 #: ../src/guestfs-actions.pod:1008 ../fish/guestfish-actions.pod:682
8434 msgid "Change the file owner to C<owner> and group to C<group>."
8435 msgstr ""
8436
8437 # type: textblock
8438 #. type: textblock
8439 #: ../src/guestfs-actions.pod:1010 ../src/guestfs-actions.pod:3495
8440 #: ../fish/guestfish-actions.pod:684 ../fish/guestfish-actions.pod:2441
8441 msgid ""
8442 "Only numeric uid and gid are supported.  If you want to use names, you will "
8443 "need to locate and parse the password file yourself (Augeas support makes "
8444 "this relatively easy)."
8445 msgstr ""
8446
8447 # type: =head2
8448 #. type: =head2
8449 #: ../src/guestfs-actions.pod:1018
8450 msgid "guestfs_command"
8451 msgstr ""
8452
8453 # type: verbatim
8454 #. type: verbatim
8455 #: ../src/guestfs-actions.pod:1020
8456 #, no-wrap
8457 msgid ""
8458 " char *\n"
8459 " guestfs_command (guestfs_h *g,\n"
8460 "                  char *const *arguments);\n"
8461 "\n"
8462 msgstr ""
8463
8464 # type: textblock
8465 #. type: textblock
8466 #: ../src/guestfs-actions.pod:1024 ../fish/guestfish-actions.pod:692
8467 msgid ""
8468 "This call runs a command from the guest filesystem.  The filesystem must be "
8469 "mounted, and must contain a compatible operating system (ie. something "
8470 "Linux, with the same or compatible processor architecture)."
8471 msgstr ""
8472
8473 # type: textblock
8474 #. type: textblock
8475 #: ../src/guestfs-actions.pod:1029
8476 msgid ""
8477 "The single parameter is an argv-style list of arguments.  The first element "
8478 "is the name of the program to run.  Subsequent elements are parameters.  The "
8479 "list must be non-empty (ie. must contain a program name).  Note that the "
8480 "command runs directly, and is I<not> invoked via the shell (see "
8481 "C<guestfs_sh>)."
8482 msgstr ""
8483
8484 # type: textblock
8485 #. type: textblock
8486 #: ../src/guestfs-actions.pod:1036 ../fish/guestfish-actions.pod:704
8487 msgid "The return value is anything printed to I<stdout> by the command."
8488 msgstr ""
8489
8490 # type: textblock
8491 #. type: textblock
8492 #: ../src/guestfs-actions.pod:1039 ../fish/guestfish-actions.pod:707
8493 msgid ""
8494 "If the command returns a non-zero exit status, then this function returns an "
8495 "error message.  The error message string is the content of I<stderr> from "
8496 "the command."
8497 msgstr ""
8498
8499 # type: textblock
8500 #. type: textblock
8501 #: ../src/guestfs-actions.pod:1043 ../fish/guestfish-actions.pod:711
8502 msgid ""
8503 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
8504 "bin>.  If you require a program from another location, you should provide "
8505 "the full path in the first parameter."
8506 msgstr ""
8507
8508 # type: textblock
8509 #. type: textblock
8510 #: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716
8511 msgid ""
8512 "Shared libraries and data files required by the program must be available on "
8513 "filesystems which are mounted in the correct places.  It is the caller's "
8514 "responsibility to ensure all filesystems that are needed are mounted at the "
8515 "right locations."
8516 msgstr ""
8517
8518 # type: textblock
8519 #. type: textblock
8520 #: ../src/guestfs-actions.pod:1060 ../src/guestfs-actions.pod:1080
8521 #: ../src/guestfs-actions.pod:1548
8522 msgid "(Added in 0.9.1)"
8523 msgstr ""
8524
8525 # type: =head2
8526 #. type: =head2
8527 #: ../src/guestfs-actions.pod:1062
8528 msgid "guestfs_command_lines"
8529 msgstr ""
8530
8531 # type: verbatim
8532 #. type: verbatim
8533 #: ../src/guestfs-actions.pod:1064
8534 #, no-wrap
8535 msgid ""
8536 " char **\n"
8537 " guestfs_command_lines (guestfs_h *g,\n"
8538 "                        char *const *arguments);\n"
8539 "\n"
8540 msgstr ""
8541
8542 # type: textblock
8543 #. type: textblock
8544 #: ../src/guestfs-actions.pod:1068
8545 msgid ""
8546 "This is the same as C<guestfs_command>, but splits the result into a list of "
8547 "lines."
8548 msgstr ""
8549
8550 # type: textblock
8551 #. type: textblock
8552 #: ../src/guestfs-actions.pod:1071
8553 msgid "See also: C<guestfs_sh_lines>"
8554 msgstr ""
8555
8556 # type: =head2
8557 #. type: =head2
8558 #: ../src/guestfs-actions.pod:1082
8559 msgid "guestfs_config"
8560 msgstr ""
8561
8562 # type: verbatim
8563 #. type: verbatim
8564 #: ../src/guestfs-actions.pod:1084
8565 #, no-wrap
8566 msgid ""
8567 " int\n"
8568 " guestfs_config (guestfs_h *g,\n"
8569 "                 const char *qemuparam,\n"
8570 "                 const char *qemuvalue);\n"
8571 "\n"
8572 msgstr ""
8573
8574 # type: textblock
8575 #. type: textblock
8576 #: ../src/guestfs-actions.pod:1089 ../fish/guestfish-actions.pod:741
8577 msgid ""
8578 "This can be used to add arbitrary qemu command line parameters of the form "
8579 "C<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8580 "setting some parameters which would interfere with parameters that we use."
8581 msgstr ""
8582
8583 # type: textblock
8584 #. type: textblock
8585 #: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746
8586 msgid "The first character of C<param> string must be a C<-> (dash)."
8587 msgstr ""
8588
8589 # type: textblock
8590 #. type: textblock
8591 #: ../src/guestfs-actions.pod:1096 ../fish/guestfish-actions.pod:748
8592 msgid "C<value> can be NULL."
8593 msgstr ""
8594
8595 # type: =head2
8596 #. type: =head2
8597 #: ../src/guestfs-actions.pod:1102
8598 msgid "guestfs_copy_size"
8599 msgstr ""
8600
8601 # type: verbatim
8602 #. type: verbatim
8603 #: ../src/guestfs-actions.pod:1104
8604 #, no-wrap
8605 msgid ""
8606 " int\n"
8607 " guestfs_copy_size (guestfs_h *g,\n"
8608 "                    const char *src,\n"
8609 "                    const char *dest,\n"
8610 "                    int64_t size);\n"
8611 "\n"
8612 msgstr ""
8613
8614 # type: textblock
8615 #. type: textblock
8616 #: ../src/guestfs-actions.pod:1110 ../fish/guestfish-actions.pod:754
8617 msgid ""
8618 "This command copies exactly C<size> bytes from one source device or file "
8619 "C<src> to another destination device or file C<dest>."
8620 msgstr ""
8621
8622 # type: textblock
8623 #. type: textblock
8624 #: ../src/guestfs-actions.pod:1113 ../fish/guestfish-actions.pod:757
8625 msgid ""
8626 "Note this will fail if the source is too short or if the destination is not "
8627 "large enough."
8628 msgstr ""
8629
8630 #. type: textblock
8631 #: ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:1241
8632 #: ../src/guestfs-actions.pod:1272 ../src/guestfs-actions.pod:1317
8633 #: ../src/guestfs-actions.pod:1697 ../src/guestfs-actions.pod:1719
8634 #: ../src/guestfs-actions.pod:3476 ../src/guestfs-actions.pod:6821
8635 #: ../src/guestfs-actions.pod:6855 ../src/guestfs-actions.pod:7334
8636 #: ../src/guestfs-actions.pod:7353
8637 msgid ""
8638 "This long-running command can generate progress notification messages so "
8639 "that the caller can display a progress bar or indicator.  To receive these "
8640 "messages, the caller must register a progress event callback.  See L<guestfs"
8641 "(3)/GUESTFS_EVENT_PROGRESS>."
8642 msgstr ""
8643
8644 # type: textblock
8645 #. type: textblock
8646 #: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:4163
8647 #: ../src/guestfs-actions.pod:5381 ../src/guestfs-actions.pod:7062
8648 #: ../src/guestfs-actions.pod:7082 ../src/guestfs-actions.pod:7168
8649 msgid "(Added in 1.0.87)"
8650 msgstr ""
8651
8652 # type: =head2
8653 #. type: =head2
8654 #: ../src/guestfs-actions.pod:1125
8655 msgid "guestfs_cp"
8656 msgstr ""
8657
8658 # type: verbatim
8659 #. type: verbatim
8660 #: ../src/guestfs-actions.pod:1127
8661 #, no-wrap
8662 msgid ""
8663 " int\n"
8664 " guestfs_cp (guestfs_h *g,\n"
8665 "             const char *src,\n"
8666 "             const char *dest);\n"
8667 "\n"
8668 msgstr ""
8669
8670 # type: textblock
8671 #. type: textblock
8672 #: ../src/guestfs-actions.pod:1132 ../fish/guestfish-actions.pod:764
8673 msgid ""
8674 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8675 "destination filename or destination directory."
8676 msgstr ""
8677
8678 # type: textblock
8679 #. type: textblock
8680 #: ../src/guestfs-actions.pod:1137 ../src/guestfs-actions.pod:1151
8681 #: ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1297
8682 #: ../src/guestfs-actions.pod:1411 ../src/guestfs-actions.pod:4848
8683 #: ../src/guestfs-actions.pod:5225
8684 msgid "(Added in 1.0.18)"
8685 msgstr ""
8686
8687 # type: =head2
8688 #. type: =head2
8689 #: ../src/guestfs-actions.pod:1139
8690 msgid "guestfs_cp_a"
8691 msgstr ""
8692
8693 # type: verbatim
8694 #. type: verbatim
8695 #: ../src/guestfs-actions.pod:1141
8696 #, no-wrap
8697 msgid ""
8698 " int\n"
8699 " guestfs_cp_a (guestfs_h *g,\n"
8700 "               const char *src,\n"
8701 "               const char *dest);\n"
8702 "\n"
8703 msgstr ""
8704
8705 # type: textblock
8706 #. type: textblock
8707 #: ../src/guestfs-actions.pod:1146 ../fish/guestfish-actions.pod:771
8708 msgid ""
8709 "This copies a file or directory from C<src> to C<dest> recursively using the "
8710 "C<cp -a> command."
8711 msgstr ""
8712
8713 # type: =head2
8714 #. type: =head2
8715 #: ../src/guestfs-actions.pod:1153
8716 msgid "guestfs_dd"
8717 msgstr ""
8718
8719 # type: verbatim
8720 #. type: verbatim
8721 #: ../src/guestfs-actions.pod:1155
8722 #, no-wrap
8723 msgid ""
8724 " int\n"
8725 " guestfs_dd (guestfs_h *g,\n"
8726 "             const char *src,\n"
8727 "             const char *dest);\n"
8728 "\n"
8729 msgstr ""
8730
8731 # type: textblock
8732 #. type: textblock
8733 #: ../src/guestfs-actions.pod:1160 ../fish/guestfish-actions.pod:778
8734 msgid ""
8735 "This command copies from one source device or file C<src> to another "
8736 "destination device or file C<dest>.  Normally you would use this to copy to "
8737 "or from a device or partition, for example to duplicate a filesystem."
8738 msgstr ""
8739
8740 # type: textblock
8741 #. type: textblock
8742 #: ../src/guestfs-actions.pod:1165
8743 msgid ""
8744 "If the destination is a device, it must be as large or larger than the "
8745 "source file or device, otherwise the copy will fail.  This command cannot do "
8746 "partial copies (see C<guestfs_copy_size>)."
8747 msgstr ""
8748
8749 # type: =head2
8750 #. type: =head2
8751 #: ../src/guestfs-actions.pod:1173
8752 msgid "guestfs_df"
8753 msgstr ""
8754
8755 # type: verbatim
8756 #. type: verbatim
8757 #: ../src/guestfs-actions.pod:1175
8758 #, no-wrap
8759 msgid ""
8760 " char *\n"
8761 " guestfs_df (guestfs_h *g);\n"
8762 "\n"
8763 msgstr ""
8764
8765 # type: textblock
8766 #. type: textblock
8767 #: ../src/guestfs-actions.pod:1178 ../fish/guestfish-actions.pod:791
8768 msgid "This command runs the C<df> command to report disk space used."
8769 msgstr ""
8770
8771 # type: textblock
8772 #. type: textblock
8773 #: ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1197
8774 msgid ""
8775 "This command is mostly useful for interactive sessions.  It is I<not> "
8776 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8777 "from programs."
8778 msgstr ""
8779
8780 # type: textblock
8781 #. type: textblock
8782 #: ../src/guestfs-actions.pod:1187 ../src/guestfs-actions.pod:1204
8783 #: ../src/guestfs-actions.pod:1322 ../src/guestfs-actions.pod:2286
8784 #: ../src/guestfs-actions.pod:2310 ../src/guestfs-actions.pod:2378
8785 #: ../src/guestfs-actions.pod:4273 ../src/guestfs-actions.pod:4748
8786 #: ../src/guestfs-actions.pod:6559 ../src/guestfs-actions.pod:6583
8787 #: ../src/guestfs-actions.pod:7201 ../src/guestfs-actions.pod:7214
8788 #: ../src/guestfs-actions.pod:7227
8789 msgid "(Added in 1.0.54)"
8790 msgstr ""
8791
8792 # type: =head2
8793 #. type: =head2
8794 #: ../src/guestfs-actions.pod:1189
8795 msgid "guestfs_df_h"
8796 msgstr ""
8797
8798 # type: verbatim
8799 #. type: verbatim
8800 #: ../src/guestfs-actions.pod:1191
8801 #, no-wrap
8802 msgid ""
8803 " char *\n"
8804 " guestfs_df_h (guestfs_h *g);\n"
8805 "\n"
8806 msgstr ""
8807
8808 # type: textblock
8809 #. type: textblock
8810 #: ../src/guestfs-actions.pod:1194 ../fish/guestfish-actions.pod:801
8811 msgid ""
8812 "This command runs the C<df -h> command to report disk space used in human-"
8813 "readable format."
8814 msgstr ""
8815
8816 # type: =head2
8817 #. type: =head2
8818 #: ../src/guestfs-actions.pod:1206
8819 msgid "guestfs_dmesg"
8820 msgstr ""
8821
8822 # type: verbatim
8823 #. type: verbatim
8824 #: ../src/guestfs-actions.pod:1208
8825 #, no-wrap
8826 msgid ""
8827 " char *\n"
8828 " guestfs_dmesg (guestfs_h *g);\n"
8829 "\n"
8830 msgstr ""
8831
8832 # type: textblock
8833 #. type: textblock
8834 #: ../src/guestfs-actions.pod:1211 ../fish/guestfish-actions.pod:812
8835 msgid ""
8836 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
8837 "This is sometimes useful for extended debugging of problems."
8838 msgstr ""
8839
8840 # type: textblock
8841 #. type: textblock
8842 #: ../src/guestfs-actions.pod:1215
8843 msgid ""
8844 "Another way to get the same information is to enable verbose messages with "
8845 "C<guestfs_set_verbose> or by setting the environment variable "
8846 "C<LIBGUESTFS_DEBUG=1> before running the program."
8847 msgstr ""
8848
8849 # type: =head2
8850 #. type: =head2
8851 #: ../src/guestfs-actions.pod:1225
8852 msgid "guestfs_download"
8853 msgstr ""
8854
8855 # type: verbatim
8856 #. type: verbatim
8857 #: ../src/guestfs-actions.pod:1227
8858 #, no-wrap
8859 msgid ""
8860 " int\n"
8861 " guestfs_download (guestfs_h *g,\n"
8862 "                   const char *remotefilename,\n"
8863 "                   const char *filename);\n"
8864 "\n"
8865 msgstr ""
8866
8867 # type: textblock
8868 #. type: textblock
8869 #: ../src/guestfs-actions.pod:1232 ../src/guestfs-actions.pod:1257
8870 #: ../fish/guestfish-actions.pod:825 ../fish/guestfish-actions.pod:838
8871 msgid ""
8872 "Download file C<remotefilename> and save it as C<filename> on the local "
8873 "machine."
8874 msgstr ""
8875
8876 # type: textblock
8877 #. type: textblock
8878 #: ../src/guestfs-actions.pod:1235 ../src/guestfs-actions.pod:6815
8879 #: ../fish/guestfish-actions.pod:828 ../fish/guestfish-actions.pod:4590
8880 msgid "C<filename> can also be a named pipe."
8881 msgstr ""
8882
8883 # type: textblock
8884 #. type: textblock
8885 #: ../src/guestfs-actions.pod:1237
8886 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
8887 msgstr ""
8888
8889 # type: =head2
8890 #. type: =head2
8891 #: ../src/guestfs-actions.pod:1248
8892 msgid "guestfs_download_offset"
8893 msgstr ""
8894
8895 # type: verbatim
8896 #. type: verbatim
8897 #: ../src/guestfs-actions.pod:1250
8898 #, no-wrap
8899 msgid ""
8900 " int\n"
8901 " guestfs_download_offset (guestfs_h *g,\n"
8902 "                          const char *remotefilename,\n"
8903 "                          const char *filename,\n"
8904 "                          int64_t offset,\n"
8905 "                          int64_t size);\n"
8906 "\n"
8907 msgstr ""
8908
8909 # type: textblock
8910 #. type: textblock
8911 #: ../src/guestfs-actions.pod:1260 ../fish/guestfish-actions.pod:841
8912 msgid ""
8913 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8914 "region must be within the file or device)."
8915 msgstr ""
8916
8917 # type: textblock
8918 #. type: textblock
8919 #: ../src/guestfs-actions.pod:1263
8920 msgid ""
8921 "Note that there is no limit on the amount of data that can be downloaded "
8922 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
8923 "full amount unless an error occurs."
8924 msgstr ""
8925
8926 # type: textblock
8927 #. type: textblock
8928 #: ../src/guestfs-actions.pod:1268
8929 msgid "See also C<guestfs_download>, C<guestfs_pread>."
8930 msgstr ""
8931
8932 # type: textblock
8933 #. type: textblock
8934 #: ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:6860
8935 msgid "(Added in 1.5.17)"
8936 msgstr ""
8937
8938 # type: =head2
8939 #. type: =head2
8940 #: ../src/guestfs-actions.pod:1279
8941 msgid "guestfs_drop_caches"
8942 msgstr ""
8943
8944 # type: verbatim
8945 #. type: verbatim
8946 #: ../src/guestfs-actions.pod:1281
8947 #, no-wrap
8948 msgid ""
8949 " int\n"
8950 " guestfs_drop_caches (guestfs_h *g,\n"
8951 "                      int whattodrop);\n"
8952 "\n"
8953 msgstr ""
8954
8955 # type: textblock
8956 #. type: textblock
8957 #: ../src/guestfs-actions.pod:1285 ../fish/guestfish-actions.pod:857
8958 msgid ""
8959 "This instructs the guest kernel to drop its page cache, and/or dentries and "
8960 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
8961 "to drop, see L<http://linux-mm.org/Drop_Caches>"
8962 msgstr ""
8963
8964 # type: textblock
8965 #. type: textblock
8966 #: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862
8967 msgid "Setting C<whattodrop> to 3 should drop everything."
8968 msgstr ""
8969
8970 # type: textblock
8971 #. type: textblock
8972 #: ../src/guestfs-actions.pod:1292 ../fish/guestfish-actions.pod:864
8973 msgid ""
8974 "This automatically calls L<sync(2)> before the operation, so that the "
8975 "maximum guest memory is freed."
8976 msgstr ""
8977
8978 # type: =head2
8979 #. type: =head2
8980 #: ../src/guestfs-actions.pod:1299
8981 msgid "guestfs_du"
8982 msgstr ""
8983
8984 # type: verbatim
8985 #. type: verbatim
8986 #: ../src/guestfs-actions.pod:1301
8987 #, no-wrap
8988 msgid ""
8989 " int64_t\n"
8990 " guestfs_du (guestfs_h *g,\n"
8991 "             const char *path);\n"
8992 "\n"
8993 msgstr ""
8994
8995 # type: textblock
8996 #. type: textblock
8997 #: ../src/guestfs-actions.pod:1305 ../fish/guestfish-actions.pod:871
8998 msgid ""
8999 "This command runs the C<du -s> command to estimate file space usage for "
9000 "C<path>."
9001 msgstr ""
9002
9003 # type: textblock
9004 #. type: textblock
9005 #: ../src/guestfs-actions.pod:1308 ../fish/guestfish-actions.pod:874
9006 msgid ""
9007 "C<path> can be a file or a directory.  If C<path> is a directory then the "
9008 "estimate includes the contents of the directory and all subdirectories "
9009 "(recursively)."
9010 msgstr ""
9011
9012 # type: textblock
9013 #. type: textblock
9014 #: ../src/guestfs-actions.pod:1312 ../fish/guestfish-actions.pod:878
9015 msgid ""
9016 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
9017 msgstr ""
9018
9019 # type: =head2
9020 #. type: =head2
9021 #: ../src/guestfs-actions.pod:1324
9022 msgid "guestfs_e2fsck_f"
9023 msgstr ""
9024
9025 # type: verbatim
9026 #. type: verbatim
9027 #: ../src/guestfs-actions.pod:1326
9028 #, no-wrap
9029 msgid ""
9030 " int\n"
9031 " guestfs_e2fsck_f (guestfs_h *g,\n"
9032 "                   const char *device);\n"
9033 "\n"
9034 msgstr ""
9035
9036 # type: textblock
9037 #. type: textblock
9038 #: ../src/guestfs-actions.pod:1330 ../fish/guestfish-actions.pod:885
9039 msgid ""
9040 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
9041 "on C<device>, noninteractively (C<-p>), even if the filesystem appears to be "
9042 "clean (C<-f>)."
9043 msgstr ""
9044
9045 # type: textblock
9046 #. type: textblock
9047 #: ../src/guestfs-actions.pod:1334
9048 msgid ""
9049 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
9050 "Normally you should use C<guestfs_fsck>."
9051 msgstr ""
9052
9053 # type: textblock
9054 #. type: textblock
9055 #: ../src/guestfs-actions.pod:1339
9056 msgid "(Added in 1.0.29)"
9057 msgstr ""
9058
9059 # type: =head2
9060 #. type: =head2
9061 #: ../src/guestfs-actions.pod:1341
9062 msgid "guestfs_echo_daemon"
9063 msgstr ""
9064
9065 # type: verbatim
9066 #. type: verbatim
9067 #: ../src/guestfs-actions.pod:1343
9068 #, no-wrap
9069 msgid ""
9070 " char *\n"
9071 " guestfs_echo_daemon (guestfs_h *g,\n"
9072 "                      char *const *words);\n"
9073 "\n"
9074 msgstr ""
9075
9076 # type: textblock
9077 #. type: textblock
9078 #: ../src/guestfs-actions.pod:1347 ../fish/guestfish-actions.pod:896
9079 msgid ""
9080 "This command concatenates the list of C<words> passed with single spaces "
9081 "between them and returns the resulting string."
9082 msgstr ""
9083
9084 # type: textblock
9085 #. type: textblock
9086 #: ../src/guestfs-actions.pod:1350 ../fish/guestfish-actions.pod:899
9087 msgid "You can use this command to test the connection through to the daemon."
9088 msgstr ""
9089
9090 # type: textblock
9091 #. type: textblock
9092 #: ../src/guestfs-actions.pod:1352
9093 msgid "See also C<guestfs_ping_daemon>."
9094 msgstr ""
9095
9096 # type: textblock
9097 #. type: textblock
9098 #: ../src/guestfs-actions.pod:1357 ../src/guestfs-actions.pod:2094
9099 #: ../src/guestfs-actions.pod:6059
9100 msgid "(Added in 1.0.69)"
9101 msgstr ""
9102
9103 # type: =head2
9104 #. type: =head2
9105 #: ../src/guestfs-actions.pod:1359
9106 msgid "guestfs_egrep"
9107 msgstr ""
9108
9109 # type: verbatim
9110 #. type: verbatim
9111 #: ../src/guestfs-actions.pod:1361
9112 #, no-wrap
9113 msgid ""
9114 " char **\n"
9115 " guestfs_egrep (guestfs_h *g,\n"
9116 "                const char *regex,\n"
9117 "                const char *path);\n"
9118 "\n"
9119 msgstr ""
9120
9121 # type: textblock
9122 #. type: textblock
9123 #: ../src/guestfs-actions.pod:1366 ../fish/guestfish-actions.pod:907
9124 msgid ""
9125 "This calls the external C<egrep> program and returns the matching lines."
9126 msgstr ""
9127
9128 # type: textblock
9129 #. type: textblock
9130 #: ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:1395
9131 #: ../src/guestfs-actions.pod:1452 ../src/guestfs-actions.pod:1498
9132 #: ../src/guestfs-actions.pod:1517 ../src/guestfs-actions.pod:2224
9133 #: ../src/guestfs-actions.pod:2243 ../src/guestfs-actions.pod:2399
9134 #: ../src/guestfs-actions.pod:2412 ../src/guestfs-actions.pod:2427
9135 #: ../src/guestfs-actions.pod:2473 ../src/guestfs-actions.pod:2495
9136 #: ../src/guestfs-actions.pod:2508 ../src/guestfs-actions.pod:3656
9137 #: ../src/guestfs-actions.pod:3670 ../src/guestfs-actions.pod:3683
9138 #: ../src/guestfs-actions.pod:3697 ../src/guestfs-actions.pod:4683
9139 #: ../src/guestfs-actions.pod:5559 ../src/guestfs-actions.pod:5608
9140 #: ../src/guestfs-actions.pod:6427 ../src/guestfs-actions.pod:6439
9141 #: ../src/guestfs-actions.pod:6452 ../src/guestfs-actions.pod:6465
9142 #: ../src/guestfs-actions.pod:6487 ../src/guestfs-actions.pod:6500
9143 #: ../src/guestfs-actions.pod:6513 ../src/guestfs-actions.pod:6526
9144 #: ../src/guestfs-actions.pod:7297 ../src/guestfs-actions.pod:7316
9145 #: ../src/guestfs-actions.pod:7401 ../src/guestfs-actions.pod:7420
9146 #: ../src/guestfs-actions.pod:7466 ../src/guestfs-actions.pod:7485
9147 msgid "(Added in 1.0.66)"
9148 msgstr ""
9149
9150 # type: =head2
9151 #. type: =head2
9152 #: ../src/guestfs-actions.pod:1378
9153 msgid "guestfs_egrepi"
9154 msgstr ""
9155
9156 # type: verbatim
9157 #. type: verbatim
9158 #: ../src/guestfs-actions.pod:1380
9159 #, no-wrap
9160 msgid ""
9161 " char **\n"
9162 " guestfs_egrepi (guestfs_h *g,\n"
9163 "                 const char *regex,\n"
9164 "                 const char *path);\n"
9165 "\n"
9166 msgstr ""
9167
9168 # type: textblock
9169 #. type: textblock
9170 #: ../src/guestfs-actions.pod:1385 ../fish/guestfish-actions.pod:917
9171 msgid ""
9172 "This calls the external C<egrep -i> program and returns the matching lines."
9173 msgstr ""
9174
9175 # type: =head2
9176 #. type: =head2
9177 #: ../src/guestfs-actions.pod:1397
9178 msgid "guestfs_equal"
9179 msgstr ""
9180
9181 # type: verbatim
9182 #. type: verbatim
9183 #: ../src/guestfs-actions.pod:1399
9184 #, no-wrap
9185 msgid ""
9186 " int\n"
9187 " guestfs_equal (guestfs_h *g,\n"
9188 "                const char *file1,\n"
9189 "                const char *file2);\n"
9190 "\n"
9191 msgstr ""
9192
9193 # type: textblock
9194 #. type: textblock
9195 #: ../src/guestfs-actions.pod:1404 ../fish/guestfish-actions.pod:927
9196 msgid ""
9197 "This compares the two files C<file1> and C<file2> and returns true if their "
9198 "content is exactly equal, or false otherwise."
9199 msgstr ""
9200
9201 # type: textblock
9202 #. type: textblock
9203 #: ../src/guestfs-actions.pod:1407 ../fish/guestfish-actions.pod:930
9204 msgid "The external L<cmp(1)> program is used for the comparison."
9205 msgstr ""
9206
9207 # type: =head2
9208 #. type: =head2
9209 #: ../src/guestfs-actions.pod:1413
9210 msgid "guestfs_exists"
9211 msgstr ""
9212
9213 # type: verbatim
9214 #. type: verbatim
9215 #: ../src/guestfs-actions.pod:1415
9216 #, no-wrap
9217 msgid ""
9218 " int\n"
9219 " guestfs_exists (guestfs_h *g,\n"
9220 "                 const char *path);\n"
9221 "\n"
9222 msgstr ""
9223
9224 # type: textblock
9225 #. type: textblock
9226 #: ../src/guestfs-actions.pod:1419 ../fish/guestfish-actions.pod:936
9227 msgid ""
9228 "This returns C<true> if and only if there is a file, directory (or anything) "
9229 "with the given C<path> name."
9230 msgstr ""
9231
9232 # type: textblock
9233 #. type: textblock
9234 #: ../src/guestfs-actions.pod:1422
9235 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
9236 msgstr ""
9237
9238 # type: =head2
9239 #. type: =head2
9240 #: ../src/guestfs-actions.pod:1428
9241 msgid "guestfs_fallocate"
9242 msgstr ""
9243
9244 # type: verbatim
9245 #. type: verbatim
9246 #: ../src/guestfs-actions.pod:1430
9247 #, no-wrap
9248 msgid ""
9249 " int\n"
9250 " guestfs_fallocate (guestfs_h *g,\n"
9251 "                    const char *path,\n"
9252 "                    int len);\n"
9253 "\n"
9254 msgstr ""
9255
9256 # type: textblock
9257 #. type: textblock
9258 #: ../src/guestfs-actions.pod:1435 ../src/guestfs-actions.pod:1461
9259 #: ../fish/guestfish-actions.pod:945 ../fish/guestfish-actions.pod:964
9260 msgid ""
9261 "This command preallocates a file (containing zero bytes) named C<path> of "
9262 "size C<len> bytes.  If the file exists already, it is overwritten."
9263 msgstr ""
9264
9265 # type: textblock
9266 #. type: textblock
9267 #: ../src/guestfs-actions.pod:1439 ../fish/guestfish-actions.pod:949
9268 msgid ""
9269 "Do not confuse this with the guestfish-specific C<alloc> command which "
9270 "allocates a file in the host and attaches it as a device."
9271 msgstr ""
9272
9273 # type: textblock
9274 #. type: textblock
9275 #: ../src/guestfs-actions.pod:1445 ../fish/guestfish-actions.pod:953
9276 msgid ""
9277 "This function is deprecated.  In new code, use the C<fallocate64> call "
9278 "instead."
9279 msgstr ""
9280
9281 # type: =head2
9282 #. type: =head2
9283 #: ../src/guestfs-actions.pod:1454
9284 msgid "guestfs_fallocate64"
9285 msgstr ""
9286
9287 # type: verbatim
9288 #. type: verbatim
9289 #: ../src/guestfs-actions.pod:1456
9290 #, no-wrap
9291 msgid ""
9292 " int\n"
9293 " guestfs_fallocate64 (guestfs_h *g,\n"
9294 "                      const char *path,\n"
9295 "                      int64_t len);\n"
9296 "\n"
9297 msgstr ""
9298
9299 # type: textblock
9300 #. type: textblock
9301 #: ../src/guestfs-actions.pod:1465
9302 msgid ""
9303 "Note that this call allocates disk blocks for the file.  To create a sparse "
9304 "file use C<guestfs_truncate_size> instead."
9305 msgstr ""
9306
9307 # type: textblock
9308 #. type: textblock
9309 #: ../src/guestfs-actions.pod:1468
9310 msgid ""
9311 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
9312 "oversight it only allowed 30 bit lengths to be specified, effectively "
9313 "limiting the maximum size of files created through that call to 1GB."
9314 msgstr ""
9315
9316 # type: textblock
9317 #. type: textblock
9318 #: ../src/guestfs-actions.pod:1473 ../fish/guestfish-actions.pod:976
9319 msgid ""
9320 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
9321 "commands which create a file in the host and attach it as a device."
9322 msgstr ""
9323
9324 # type: textblock
9325 #. type: textblock
9326 #: ../src/guestfs-actions.pod:1479
9327 msgid "(Added in 1.3.17)"
9328 msgstr ""
9329
9330 # type: =head2
9331 #. type: =head2
9332 #: ../src/guestfs-actions.pod:1481
9333 msgid "guestfs_fgrep"
9334 msgstr ""
9335
9336 # type: verbatim
9337 #. type: verbatim
9338 #: ../src/guestfs-actions.pod:1483
9339 #, no-wrap
9340 msgid ""
9341 " char **\n"
9342 " guestfs_fgrep (guestfs_h *g,\n"
9343 "                const char *pattern,\n"
9344 "                const char *path);\n"
9345 "\n"
9346 msgstr ""
9347
9348 # type: textblock
9349 #. type: textblock
9350 #: ../src/guestfs-actions.pod:1488 ../fish/guestfish-actions.pod:984
9351 msgid ""
9352 "This calls the external C<fgrep> program and returns the matching lines."
9353 msgstr ""
9354
9355 # type: =head2
9356 #. type: =head2
9357 #: ../src/guestfs-actions.pod:1500
9358 msgid "guestfs_fgrepi"
9359 msgstr ""
9360
9361 # type: verbatim
9362 #. type: verbatim
9363 #: ../src/guestfs-actions.pod:1502
9364 #, no-wrap
9365 msgid ""
9366 " char **\n"
9367 " guestfs_fgrepi (guestfs_h *g,\n"
9368 "                 const char *pattern,\n"
9369 "                 const char *path);\n"
9370 "\n"
9371 msgstr ""
9372
9373 # type: textblock
9374 #. type: textblock
9375 #: ../src/guestfs-actions.pod:1507 ../fish/guestfish-actions.pod:994
9376 msgid ""
9377 "This calls the external C<fgrep -i> program and returns the matching lines."
9378 msgstr ""
9379
9380 # type: =head2
9381 #. type: =head2
9382 #: ../src/guestfs-actions.pod:1519
9383 msgid "guestfs_file"
9384 msgstr ""
9385
9386 # type: verbatim
9387 #. type: verbatim
9388 #: ../src/guestfs-actions.pod:1521
9389 #, no-wrap
9390 msgid ""
9391 " char *\n"
9392 " guestfs_file (guestfs_h *g,\n"
9393 "               const char *path);\n"
9394 "\n"
9395 msgstr ""
9396
9397 # type: textblock
9398 #. type: textblock
9399 #: ../src/guestfs-actions.pod:1525 ../fish/guestfish-actions.pod:1004
9400 msgid ""
9401 "This call uses the standard L<file(1)> command to determine the type or "
9402 "contents of the file."
9403 msgstr ""
9404
9405 # type: textblock
9406 #. type: textblock
9407 #: ../src/guestfs-actions.pod:1528 ../fish/guestfish-actions.pod:1007
9408 msgid ""
9409 "This call will also transparently look inside various types of compressed "
9410 "file."
9411 msgstr ""
9412
9413 # type: textblock
9414 #. type: textblock
9415 #: ../src/guestfs-actions.pod:1531 ../fish/guestfish-actions.pod:1010
9416 msgid ""
9417 "The exact command which runs is C<file -zb path>.  Note in particular that "
9418 "the filename is not prepended to the output (the C<-b> option)."
9419 msgstr ""
9420
9421 # type: textblock
9422 #. type: textblock
9423 #: ../src/guestfs-actions.pod:1535
9424 msgid ""
9425 "This command can also be used on C</dev/> devices (and partitions, LV "
9426 "names).  You can for example use this to determine if a device contains a "
9427 "filesystem, although it's usually better to use C<guestfs_vfs_type>."
9428 msgstr ""
9429
9430 # type: textblock
9431 #. type: textblock
9432 #: ../src/guestfs-actions.pod:1540 ../fish/guestfish-actions.pod:1019
9433 msgid ""
9434 "If the C<path> does not begin with C</dev/> then this command only works for "
9435 "the content of regular files.  For other file types (directory, symbolic "
9436 "link etc) it will just return the string C<directory> etc."
9437 msgstr ""
9438
9439 # type: =head2
9440 #. type: =head2
9441 #: ../src/guestfs-actions.pod:1550
9442 msgid "guestfs_file_architecture"
9443 msgstr ""
9444
9445 # type: verbatim
9446 #. type: verbatim
9447 #: ../src/guestfs-actions.pod:1552
9448 #, no-wrap
9449 msgid ""
9450 " char *\n"
9451 " guestfs_file_architecture (guestfs_h *g,\n"
9452 "                            const char *filename);\n"
9453 "\n"
9454 msgstr ""
9455
9456 # type: textblock
9457 #. type: textblock
9458 #: ../src/guestfs-actions.pod:1556 ../fish/guestfish-actions.pod:1028
9459 msgid ""
9460 "This detects the architecture of the binary C<filename>, and returns it if "
9461 "known."
9462 msgstr ""
9463
9464 # type: textblock
9465 #. type: textblock
9466 #: ../src/guestfs-actions.pod:1559 ../fish/guestfish-actions.pod:1031
9467 msgid "Currently defined architectures are:"
9468 msgstr ""
9469
9470 # type: =item
9471 #. type: =item
9472 #: ../src/guestfs-actions.pod:1563 ../fish/guestfish-actions.pod:1035
9473 msgid "\"i386\""
9474 msgstr ""
9475
9476 # type: textblock
9477 #. type: textblock
9478 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1037
9479 msgid ""
9480 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9481 "irrespective of the precise processor requirements of the binary."
9482 msgstr ""
9483
9484 # type: =item
9485 #. type: =item
9486 #: ../src/guestfs-actions.pod:1568 ../fish/guestfish-actions.pod:1040
9487 msgid "\"x86_64\""
9488 msgstr ""
9489
9490 # type: textblock
9491 #. type: textblock
9492 #: ../src/guestfs-actions.pod:1570 ../fish/guestfish-actions.pod:1042
9493 msgid "64 bit x86-64."
9494 msgstr ""
9495
9496 # type: =item
9497 #. type: =item
9498 #: ../src/guestfs-actions.pod:1572 ../fish/guestfish-actions.pod:1044
9499 msgid "\"sparc\""
9500 msgstr ""
9501
9502 # type: textblock
9503 #. type: textblock
9504 #: ../src/guestfs-actions.pod:1574 ../fish/guestfish-actions.pod:1046
9505 msgid "32 bit SPARC."
9506 msgstr ""
9507
9508 # type: =item
9509 #. type: =item
9510 #: ../src/guestfs-actions.pod:1576 ../fish/guestfish-actions.pod:1048
9511 msgid "\"sparc64\""
9512 msgstr ""
9513
9514 # type: textblock
9515 #. type: textblock
9516 #: ../src/guestfs-actions.pod:1578 ../fish/guestfish-actions.pod:1050
9517 msgid "64 bit SPARC V9 and above."
9518 msgstr ""
9519
9520 # type: =item
9521 #. type: =item
9522 #: ../src/guestfs-actions.pod:1580 ../fish/guestfish-actions.pod:1052
9523 msgid "\"ia64\""
9524 msgstr ""
9525
9526 # type: textblock
9527 #. type: textblock
9528 #: ../src/guestfs-actions.pod:1582 ../fish/guestfish-actions.pod:1054
9529 msgid "Intel Itanium."
9530 msgstr ""
9531
9532 # type: =item
9533 #. type: =item
9534 #: ../src/guestfs-actions.pod:1584 ../fish/guestfish-actions.pod:1056
9535 msgid "\"ppc\""
9536 msgstr ""
9537
9538 # type: textblock
9539 #. type: textblock
9540 #: ../src/guestfs-actions.pod:1586 ../fish/guestfish-actions.pod:1058
9541 msgid "32 bit Power PC."
9542 msgstr ""
9543
9544 # type: =item
9545 #. type: =item
9546 #: ../src/guestfs-actions.pod:1588 ../fish/guestfish-actions.pod:1060
9547 msgid "\"ppc64\""
9548 msgstr ""
9549
9550 # type: textblock
9551 #. type: textblock
9552 #: ../src/guestfs-actions.pod:1590 ../fish/guestfish-actions.pod:1062
9553 msgid "64 bit Power PC."
9554 msgstr ""
9555
9556 # type: textblock
9557 #. type: textblock
9558 #: ../src/guestfs-actions.pod:1594 ../fish/guestfish-actions.pod:1066
9559 msgid "Libguestfs may return other architecture strings in future."
9560 msgstr ""
9561
9562 # type: textblock
9563 #. type: textblock
9564 #: ../src/guestfs-actions.pod:1596 ../fish/guestfish-actions.pod:1068
9565 msgid "The function works on at least the following types of files:"
9566 msgstr ""
9567
9568 # type: textblock
9569 #. type: textblock
9570 #: ../src/guestfs-actions.pod:1602 ../fish/guestfish-actions.pod:1074
9571 msgid "many types of Un*x and Linux binary"
9572 msgstr ""
9573
9574 # type: textblock
9575 #. type: textblock
9576 #: ../src/guestfs-actions.pod:1606 ../fish/guestfish-actions.pod:1078
9577 msgid "many types of Un*x and Linux shared library"
9578 msgstr ""
9579
9580 # type: textblock
9581 #. type: textblock
9582 #: ../src/guestfs-actions.pod:1610 ../fish/guestfish-actions.pod:1082
9583 msgid "Windows Win32 and Win64 binaries"
9584 msgstr ""
9585
9586 # type: textblock
9587 #. type: textblock
9588 #: ../src/guestfs-actions.pod:1614 ../fish/guestfish-actions.pod:1086
9589 msgid "Windows Win32 and Win64 DLLs"
9590 msgstr ""
9591
9592 # type: textblock
9593 #. type: textblock
9594 #: ../src/guestfs-actions.pod:1616 ../fish/guestfish-actions.pod:1088
9595 msgid "Win32 binaries and DLLs return C<i386>."
9596 msgstr ""
9597
9598 # type: textblock
9599 #. type: textblock
9600 #: ../src/guestfs-actions.pod:1618 ../fish/guestfish-actions.pod:1090
9601 msgid "Win64 binaries and DLLs return C<x86_64>."
9602 msgstr ""
9603
9604 # type: textblock
9605 #. type: textblock
9606 #: ../src/guestfs-actions.pod:1622 ../fish/guestfish-actions.pod:1094
9607 msgid "Linux kernel modules"
9608 msgstr ""
9609
9610 # type: textblock
9611 #. type: textblock
9612 #: ../src/guestfs-actions.pod:1626 ../fish/guestfish-actions.pod:1098
9613 msgid "Linux new-style initrd images"
9614 msgstr ""
9615
9616 # type: textblock
9617 #. type: textblock
9618 #: ../src/guestfs-actions.pod:1630 ../fish/guestfish-actions.pod:1102
9619 msgid "some non-x86 Linux vmlinuz kernels"
9620 msgstr ""
9621
9622 # type: textblock
9623 #. type: textblock
9624 #: ../src/guestfs-actions.pod:1634 ../fish/guestfish-actions.pod:1106
9625 msgid "What it can't do currently:"
9626 msgstr ""
9627
9628 # type: textblock
9629 #. type: textblock
9630 #: ../src/guestfs-actions.pod:1640 ../fish/guestfish-actions.pod:1112
9631 msgid "static libraries (libfoo.a)"
9632 msgstr ""
9633
9634 # type: textblock
9635 #. type: textblock
9636 #: ../src/guestfs-actions.pod:1644 ../fish/guestfish-actions.pod:1116
9637 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9638 msgstr ""
9639
9640 # type: textblock
9641 #. type: textblock
9642 #: ../src/guestfs-actions.pod:1648 ../fish/guestfish-actions.pod:1120
9643 msgid "x86 Linux vmlinuz kernels"
9644 msgstr ""
9645
9646 # type: textblock
9647 #. type: textblock
9648 #: ../src/guestfs-actions.pod:1650 ../fish/guestfish-actions.pod:1122
9649 msgid ""
9650 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9651 "compressed code, and are horribly hard to unpack.  If you want to find the "
9652 "architecture of a kernel, use the architecture of the associated initrd or "
9653 "kernel module(s) instead."
9654 msgstr ""
9655
9656 # type: textblock
9657 #. type: textblock
9658 #: ../src/guestfs-actions.pod:1660 ../src/guestfs-actions.pod:1823
9659 #: ../src/guestfs-actions.pod:1840 ../src/guestfs-actions.pod:2531
9660 #: ../src/guestfs-actions.pod:2624 ../src/guestfs-actions.pod:2694
9661 #: ../src/guestfs-actions.pod:2782 ../src/guestfs-actions.pod:2803
9662 #: ../src/guestfs-actions.pod:2846 ../src/guestfs-actions.pod:2930
9663 #: ../src/guestfs-actions.pod:3027 ../src/guestfs-actions.pod:3274
9664 #: ../src/guestfs-actions.pod:3406
9665 msgid "(Added in 1.5.3)"
9666 msgstr ""
9667
9668 # type: =head2
9669 #. type: =head2
9670 #: ../src/guestfs-actions.pod:1662
9671 msgid "guestfs_filesize"
9672 msgstr ""
9673
9674 # type: verbatim
9675 #. type: verbatim
9676 #: ../src/guestfs-actions.pod:1664
9677 #, no-wrap
9678 msgid ""
9679 " int64_t\n"
9680 " guestfs_filesize (guestfs_h *g,\n"
9681 "                   const char *file);\n"
9682 "\n"
9683 msgstr ""
9684
9685 # type: textblock
9686 #. type: textblock
9687 #: ../src/guestfs-actions.pod:1668 ../fish/guestfish-actions.pod:1133
9688 msgid "This command returns the size of C<file> in bytes."
9689 msgstr ""
9690
9691 # type: textblock
9692 #. type: textblock
9693 #: ../src/guestfs-actions.pod:1670
9694 msgid ""
9695 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9696 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9697 "devices, use C<guestfs_blockdev_getsize64>."
9698 msgstr ""
9699
9700 # type: textblock
9701 #. type: textblock
9702 #: ../src/guestfs-actions.pod:1676
9703 msgid "(Added in 1.0.82)"
9704 msgstr ""
9705
9706 # type: =head2
9707 #. type: =head2
9708 #: ../src/guestfs-actions.pod:1678
9709 msgid "guestfs_fill"
9710 msgstr ""
9711
9712 # type: verbatim
9713 #. type: verbatim
9714 #: ../src/guestfs-actions.pod:1680
9715 #, no-wrap
9716 msgid ""
9717 " int\n"
9718 " guestfs_fill (guestfs_h *g,\n"
9719 "               int c,\n"
9720 "               int len,\n"
9721 "               const char *path);\n"
9722 "\n"
9723 msgstr ""
9724
9725 # type: textblock
9726 #. type: textblock
9727 #: ../src/guestfs-actions.pod:1686 ../fish/guestfish-actions.pod:1143
9728 msgid ""
9729 "This command creates a new file called C<path>.  The initial content of the "
9730 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9731 "[0..255]>."
9732 msgstr ""
9733
9734 # type: textblock
9735 #. type: textblock
9736 #: ../src/guestfs-actions.pod:1690
9737 msgid ""
9738 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9739 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9740 "bytes use C<guestfs_fill_pattern>."
9741 msgstr ""
9742
9743 # type: textblock
9744 #. type: textblock
9745 #: ../src/guestfs-actions.pod:1702
9746 msgid "(Added in 1.0.79)"
9747 msgstr ""
9748
9749 # type: =head2
9750 #. type: =head2
9751 #: ../src/guestfs-actions.pod:1704
9752 msgid "guestfs_fill_pattern"
9753 msgstr ""
9754
9755 # type: verbatim
9756 #. type: verbatim
9757 #: ../src/guestfs-actions.pod:1706
9758 #, no-wrap
9759 msgid ""
9760 " int\n"
9761 " guestfs_fill_pattern (guestfs_h *g,\n"
9762 "                       const char *pattern,\n"
9763 "                       int len,\n"
9764 "                       const char *path);\n"
9765 "\n"
9766 msgstr ""
9767
9768 # type: textblock
9769 #. type: textblock
9770 #: ../src/guestfs-actions.pod:1712
9771 msgid ""
9772 "This function is like C<guestfs_fill> except that it creates a new file of "
9773 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9774 "pattern is truncated if necessary to ensure the length of the file is "
9775 "exactly C<len> bytes."
9776 msgstr ""
9777
9778 # type: textblock
9779 #. type: textblock
9780 #: ../src/guestfs-actions.pod:1724
9781 msgid "(Added in 1.3.12)"
9782 msgstr ""
9783
9784 # type: =head2
9785 #. type: =head2
9786 #: ../src/guestfs-actions.pod:1726
9787 msgid "guestfs_find"
9788 msgstr ""
9789
9790 # type: verbatim
9791 #. type: verbatim
9792 #: ../src/guestfs-actions.pod:1728
9793 #, no-wrap
9794 msgid ""
9795 " char **\n"
9796 " guestfs_find (guestfs_h *g,\n"
9797 "               const char *directory);\n"
9798 "\n"
9799 msgstr ""
9800
9801 # type: textblock
9802 #. type: textblock
9803 #: ../src/guestfs-actions.pod:1732 ../fish/guestfish-actions.pod:1165
9804 msgid ""
9805 "This command lists out all files and directories, recursively, starting at "
9806 "C<directory>.  It is essentially equivalent to running the shell command "
9807 "C<find directory -print> but some post-processing happens on the output, "
9808 "described below."
9809 msgstr ""
9810
9811 # type: textblock
9812 #. type: textblock
9813 #: ../src/guestfs-actions.pod:1737 ../fish/guestfish-actions.pod:1170
9814 msgid ""
9815 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9816 "structure was:"
9817 msgstr ""
9818
9819 # type: verbatim
9820 #. type: verbatim
9821 #: ../src/guestfs-actions.pod:1740 ../fish/guestfish-actions.pod:1173
9822 #, no-wrap
9823 msgid ""
9824 " /tmp/a\n"
9825 " /tmp/b\n"
9826 " /tmp/c/d\n"
9827 "\n"
9828 msgstr ""
9829
9830 # type: textblock
9831 #. type: textblock
9832 #: ../src/guestfs-actions.pod:1744
9833 msgid ""
9834 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
9835 msgstr ""
9836
9837 # type: verbatim
9838 #. type: verbatim
9839 #: ../src/guestfs-actions.pod:1747 ../fish/guestfish-actions.pod:1180
9840 #, no-wrap
9841 msgid ""
9842 " a\n"
9843 " b\n"
9844 " c\n"
9845 " c/d\n"
9846 "\n"
9847 msgstr ""
9848
9849 # type: textblock
9850 #. type: textblock
9851 #: ../src/guestfs-actions.pod:1752 ../fish/guestfish-actions.pod:1185
9852 msgid "If C<directory> is not a directory, then this command returns an error."
9853 msgstr ""
9854
9855 # type: textblock
9856 #. type: textblock
9857 #: ../src/guestfs-actions.pod:1755 ../fish/guestfish-actions.pod:1188
9858 msgid "The returned list is sorted."
9859 msgstr ""
9860
9861 # type: textblock
9862 #. type: textblock
9863 #: ../src/guestfs-actions.pod:1757
9864 msgid "See also C<guestfs_find0>."
9865 msgstr ""
9866
9867 # type: textblock
9868 #. type: textblock
9869 #: ../src/guestfs-actions.pod:1766 ../src/guestfs-actions.pod:4100
9870 #: ../src/guestfs-actions.pod:5643
9871 msgid "(Added in 1.0.27)"
9872 msgstr ""
9873
9874 # type: =head2
9875 #. type: =head2
9876 #: ../src/guestfs-actions.pod:1768
9877 msgid "guestfs_find0"
9878 msgstr ""
9879
9880 # type: verbatim
9881 #. type: verbatim
9882 #: ../src/guestfs-actions.pod:1770
9883 #, no-wrap
9884 msgid ""
9885 " int\n"
9886 " guestfs_find0 (guestfs_h *g,\n"
9887 "                const char *directory,\n"
9888 "                const char *files);\n"
9889 "\n"
9890 msgstr ""
9891
9892 # type: textblock
9893 #. type: textblock
9894 #: ../src/guestfs-actions.pod:1775 ../fish/guestfish-actions.pod:1199
9895 msgid ""
9896 "This command lists out all files and directories, recursively, starting at "
9897 "C<directory>, placing the resulting list in the external file called "
9898 "C<files>."
9899 msgstr ""
9900
9901 # type: textblock
9902 #. type: textblock
9903 #: ../src/guestfs-actions.pod:1779
9904 msgid ""
9905 "This command works the same way as C<guestfs_find> with the following "
9906 "exceptions:"
9907 msgstr ""
9908
9909 # type: textblock
9910 #. type: textblock
9911 #: ../src/guestfs-actions.pod:1786 ../fish/guestfish-actions.pod:1210
9912 msgid "The resulting list is written to an external file."
9913 msgstr ""
9914
9915 # type: textblock
9916 #. type: textblock
9917 #: ../src/guestfs-actions.pod:1790 ../fish/guestfish-actions.pod:1214
9918 msgid ""
9919 "Items (filenames) in the result are separated by C<\\0> characters.  See "
9920 "L<find(1)> option I<-print0>."
9921 msgstr ""
9922
9923 # type: textblock
9924 #. type: textblock
9925 #: ../src/guestfs-actions.pod:1795 ../fish/guestfish-actions.pod:1219
9926 msgid "This command is not limited in the number of names that it can return."
9927 msgstr ""
9928
9929 # type: textblock
9930 #. type: textblock
9931 #: ../src/guestfs-actions.pod:1800 ../fish/guestfish-actions.pod:1224
9932 msgid "The result list is not sorted."
9933 msgstr ""
9934
9935 # type: textblock
9936 #. type: textblock
9937 #: ../src/guestfs-actions.pod:1806
9938 msgid "(Added in 1.0.74)"
9939 msgstr ""
9940
9941 # type: =head2
9942 #. type: =head2
9943 #: ../src/guestfs-actions.pod:1808
9944 msgid "guestfs_findfs_label"
9945 msgstr ""
9946
9947 # type: verbatim
9948 #. type: verbatim
9949 #: ../src/guestfs-actions.pod:1810
9950 #, no-wrap
9951 msgid ""
9952 " char *\n"
9953 " guestfs_findfs_label (guestfs_h *g,\n"
9954 "                       const char *label);\n"
9955 "\n"
9956 msgstr ""
9957
9958 # type: textblock
9959 #. type: textblock
9960 #: ../src/guestfs-actions.pod:1814 ../fish/guestfish-actions.pod:1234
9961 msgid ""
9962 "This command searches the filesystems and returns the one which has the "
9963 "given label.  An error is returned if no such filesystem can be found."
9964 msgstr ""
9965
9966 # type: textblock
9967 #. type: textblock
9968 #: ../src/guestfs-actions.pod:1818
9969 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
9970 msgstr ""
9971
9972 # type: =head2
9973 #. type: =head2
9974 #: ../src/guestfs-actions.pod:1825
9975 msgid "guestfs_findfs_uuid"
9976 msgstr ""
9977
9978 # type: verbatim
9979 #. type: verbatim
9980 #: ../src/guestfs-actions.pod:1827
9981 #, no-wrap
9982 msgid ""
9983 " char *\n"
9984 " guestfs_findfs_uuid (guestfs_h *g,\n"
9985 "                      const char *uuid);\n"
9986 "\n"
9987 msgstr ""
9988
9989 # type: textblock
9990 #. type: textblock
9991 #: ../src/guestfs-actions.pod:1831 ../fish/guestfish-actions.pod:1244
9992 msgid ""
9993 "This command searches the filesystems and returns the one which has the "
9994 "given UUID.  An error is returned if no such filesystem can be found."
9995 msgstr ""
9996
9997 # type: textblock
9998 #. type: textblock
9999 #: ../src/guestfs-actions.pod:1835
10000 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
10001 msgstr ""
10002
10003 # type: =head2
10004 #. type: =head2
10005 #: ../src/guestfs-actions.pod:1842
10006 msgid "guestfs_fsck"
10007 msgstr ""
10008
10009 # type: verbatim
10010 #. type: verbatim
10011 #: ../src/guestfs-actions.pod:1844
10012 #, no-wrap
10013 msgid ""
10014 " int\n"
10015 " guestfs_fsck (guestfs_h *g,\n"
10016 "               const char *fstype,\n"
10017 "               const char *device);\n"
10018 "\n"
10019 msgstr ""
10020
10021 # type: textblock
10022 #. type: textblock
10023 #: ../src/guestfs-actions.pod:1849 ../fish/guestfish-actions.pod:1254
10024 msgid ""
10025 "This runs the filesystem checker (fsck) on C<device> which should have "
10026 "filesystem type C<fstype>."
10027 msgstr ""
10028
10029 # type: textblock
10030 #. type: textblock
10031 #: ../src/guestfs-actions.pod:1852 ../fish/guestfish-actions.pod:1257
10032 msgid ""
10033 "The returned integer is the status.  See L<fsck(8)> for the list of status "
10034 "codes from C<fsck>."
10035 msgstr ""
10036
10037 # type: textblock
10038 #. type: textblock
10039 #: ../src/guestfs-actions.pod:1861 ../fish/guestfish-actions.pod:1266
10040 msgid "Multiple status codes can be summed together."
10041 msgstr ""
10042
10043 # type: textblock
10044 #. type: textblock
10045 #: ../src/guestfs-actions.pod:1865 ../fish/guestfish-actions.pod:1270
10046 msgid ""
10047 "A non-zero return code can mean \"success\", for example if errors have been "
10048 "corrected on the filesystem."
10049 msgstr ""
10050
10051 # type: textblock
10052 #. type: textblock
10053 #: ../src/guestfs-actions.pod:1870 ../fish/guestfish-actions.pod:1275
10054 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
10055 msgstr ""
10056
10057 # type: textblock
10058 #. type: textblock
10059 #: ../src/guestfs-actions.pod:1875 ../fish/guestfish-actions.pod:1280
10060 msgid ""
10061 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
10062 msgstr ""
10063
10064 # type: textblock
10065 #. type: textblock
10066 #: ../src/guestfs-actions.pod:1879 ../src/guestfs-actions.pod:7339
10067 msgid "(Added in 1.0.16)"
10068 msgstr ""
10069
10070 # type: =head2
10071 #. type: =head2
10072 #: ../src/guestfs-actions.pod:1881
10073 msgid "guestfs_get_append"
10074 msgstr ""
10075
10076 # type: verbatim
10077 #. type: verbatim
10078 #: ../src/guestfs-actions.pod:1883
10079 #, no-wrap
10080 msgid ""
10081 " const char *\n"
10082 " guestfs_get_append (guestfs_h *g);\n"
10083 "\n"
10084 msgstr ""
10085
10086 # type: textblock
10087 #. type: textblock
10088 #: ../src/guestfs-actions.pod:1886 ../fish/guestfish-actions.pod:1286
10089 msgid ""
10090 "Return the additional kernel options which are added to the guest kernel "
10091 "command line."
10092 msgstr ""
10093
10094 # type: textblock
10095 #. type: textblock
10096 #: ../src/guestfs-actions.pod:1889 ../fish/guestfish-actions.pod:1289
10097 msgid "If C<NULL> then no options are added."
10098 msgstr ""
10099
10100 # type: textblock
10101 #. type: textblock
10102 #: ../src/guestfs-actions.pod:1891
10103 msgid ""
10104 "This function returns a string which may be NULL.  There is no way to return "
10105 "an error from this function.  The string is owned by the guest handle and "
10106 "must I<not> be freed."
10107 msgstr ""
10108
10109 # type: textblock
10110 #. type: textblock
10111 #: ../src/guestfs-actions.pod:1895 ../src/guestfs-actions.pod:5321
10112 #: ../src/guestfs-actions.pod:5801 ../src/guestfs-actions.pod:6201
10113 #: ../src/guestfs-actions.pod:6220 ../src/guestfs-actions.pod:6236
10114 #: ../src/guestfs-actions.pod:6253 ../src/guestfs-actions.pod:7010
10115 #: ../src/guestfs-actions.pod:7028 ../src/guestfs-actions.pod:7382
10116 msgid "(Added in 1.0.26)"
10117 msgstr ""
10118
10119 #. type: =head2
10120 #: ../src/guestfs-actions.pod:1897
10121 msgid "guestfs_get_attach_method"
10122 msgstr ""
10123
10124 #. type: verbatim
10125 #: ../src/guestfs-actions.pod:1899
10126 #, no-wrap
10127 msgid ""
10128 " char *\n"
10129 " guestfs_get_attach_method (guestfs_h *g);\n"
10130 "\n"
10131 msgstr ""
10132
10133 #. type: textblock
10134 #: ../src/guestfs-actions.pod:1902
10135 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
10136 msgstr ""
10137
10138 # type: =head2
10139 #. type: =head2
10140 #: ../src/guestfs-actions.pod:1907
10141 msgid "guestfs_get_autosync"
10142 msgstr ""
10143
10144 # type: verbatim
10145 #. type: verbatim
10146 #: ../src/guestfs-actions.pod:1909
10147 #, no-wrap
10148 msgid ""
10149 " int\n"
10150 " guestfs_get_autosync (guestfs_h *g);\n"
10151 "\n"
10152 msgstr ""
10153
10154 # type: textblock
10155 #. type: textblock
10156 #: ../src/guestfs-actions.pod:1912 ../fish/guestfish-actions.pod:1301
10157 msgid "Get the autosync flag."
10158 msgstr ""
10159
10160 # type: =head2
10161 #. type: =head2
10162 #: ../src/guestfs-actions.pod:1918
10163 msgid "guestfs_get_direct"
10164 msgstr ""
10165
10166 # type: verbatim
10167 #. type: verbatim
10168 #: ../src/guestfs-actions.pod:1920
10169 #, no-wrap
10170 msgid ""
10171 " int\n"
10172 " guestfs_get_direct (guestfs_h *g);\n"
10173 "\n"
10174 msgstr ""
10175
10176 # type: textblock
10177 #. type: textblock
10178 #: ../src/guestfs-actions.pod:1923 ../fish/guestfish-actions.pod:1307
10179 msgid "Return the direct appliance mode flag."
10180 msgstr ""
10181
10182 # type: textblock
10183 #. type: textblock
10184 #: ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:5870
10185 msgid "(Added in 1.0.72)"
10186 msgstr ""
10187
10188 # type: =head2
10189 #. type: =head2
10190 #: ../src/guestfs-actions.pod:1929
10191 msgid "guestfs_get_e2label"
10192 msgstr ""
10193
10194 # type: verbatim
10195 #. type: verbatim
10196 #: ../src/guestfs-actions.pod:1931
10197 #, no-wrap
10198 msgid ""
10199 " char *\n"
10200 " guestfs_get_e2label (guestfs_h *g,\n"
10201 "                      const char *device);\n"
10202 "\n"
10203 msgstr ""
10204
10205 # type: textblock
10206 #. type: textblock
10207 #: ../src/guestfs-actions.pod:1935 ../fish/guestfish-actions.pod:1313
10208 msgid ""
10209 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
10210 msgstr ""
10211
10212 # type: textblock
10213 #. type: textblock
10214 #: ../src/guestfs-actions.pod:1941 ../fish/guestfish-actions.pod:1316
10215 msgid ""
10216 "This function is deprecated.  In new code, use the C<vfs_label> call instead."
10217 msgstr ""
10218
10219 # type: textblock
10220 #. type: textblock
10221 #: ../src/guestfs-actions.pod:1948 ../src/guestfs-actions.pod:1969
10222 #: ../src/guestfs-actions.pod:5888 ../src/guestfs-actions.pod:5907
10223 msgid "(Added in 1.0.15)"
10224 msgstr ""
10225
10226 # type: =head2
10227 #. type: =head2
10228 #: ../src/guestfs-actions.pod:1950
10229 msgid "guestfs_get_e2uuid"
10230 msgstr ""
10231
10232 # type: verbatim
10233 #. type: verbatim
10234 #: ../src/guestfs-actions.pod:1952
10235 #, no-wrap
10236 msgid ""
10237 " char *\n"
10238 " guestfs_get_e2uuid (guestfs_h *g,\n"
10239 "                     const char *device);\n"
10240 "\n"
10241 msgstr ""
10242
10243 # type: textblock
10244 #. type: textblock
10245 #: ../src/guestfs-actions.pod:1956 ../fish/guestfish-actions.pod:1327
10246 msgid ""
10247 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
10248 msgstr ""
10249
10250 # type: textblock
10251 #. type: textblock
10252 #: ../src/guestfs-actions.pod:1962 ../fish/guestfish-actions.pod:1330
10253 msgid ""
10254 "This function is deprecated.  In new code, use the C<vfs_uuid> call instead."
10255 msgstr ""
10256
10257 # type: =head2
10258 #. type: =head2
10259 #: ../src/guestfs-actions.pod:1971
10260 msgid "guestfs_get_memsize"
10261 msgstr ""
10262
10263 # type: verbatim
10264 #. type: verbatim
10265 #: ../src/guestfs-actions.pod:1973
10266 #, no-wrap
10267 msgid ""
10268 " int\n"
10269 " guestfs_get_memsize (guestfs_h *g);\n"
10270 "\n"
10271 msgstr ""
10272
10273 # type: textblock
10274 #. type: textblock
10275 #: ../src/guestfs-actions.pod:1976 ../fish/guestfish-actions.pod:1341
10276 msgid ""
10277 "This gets the memory size in megabytes allocated to the qemu subprocess."
10278 msgstr ""
10279
10280 # type: textblock
10281 #. type: textblock
10282 #: ../src/guestfs-actions.pod:1979
10283 msgid ""
10284 "If C<guestfs_set_memsize> was not called on this handle, and if "
10285 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
10286 "value for memsize."
10287 msgstr ""
10288
10289 # type: textblock
10290 #. type: textblock
10291 #: ../src/guestfs-actions.pod:1983 ../src/guestfs-actions.pod:2064
10292 #: ../src/guestfs-actions.pod:5923 ../src/guestfs-actions.pod:6030
10293 #: ../fish/guestfish-actions.pod:1348 ../fish/guestfish-actions.pod:1399
10294 #: ../fish/guestfish-actions.pod:3993 ../fish/guestfish-actions.pod:4080
10295 msgid ""
10296 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
10297 msgstr ""
10298
10299 # type: textblock
10300 #. type: textblock
10301 #: ../src/guestfs-actions.pod:1988 ../src/guestfs-actions.pod:4391
10302 #: ../src/guestfs-actions.pod:4588 ../src/guestfs-actions.pod:4607
10303 #: ../src/guestfs-actions.pod:4626 ../src/guestfs-actions.pod:4638
10304 #: ../src/guestfs-actions.pod:4655 ../src/guestfs-actions.pod:4668
10305 #: ../src/guestfs-actions.pod:5546 ../src/guestfs-actions.pod:5928
10306 #: ../src/guestfs-actions.pod:6175 ../src/guestfs-actions.pod:6776
10307 msgid "(Added in 1.0.55)"
10308 msgstr ""
10309
10310 # type: =head2
10311 #. type: =head2
10312 #: ../src/guestfs-actions.pod:1990
10313 msgid "guestfs_get_network"
10314 msgstr ""
10315
10316 # type: verbatim
10317 #. type: verbatim
10318 #: ../src/guestfs-actions.pod:1992
10319 #, no-wrap
10320 msgid ""
10321 " int\n"
10322 " guestfs_get_network (guestfs_h *g);\n"
10323 "\n"
10324 msgstr ""
10325
10326 # type: textblock
10327 #. type: textblock
10328 #: ../src/guestfs-actions.pod:1995 ../fish/guestfish-actions.pod:1355
10329 msgid "This returns the enable network flag."
10330 msgstr ""
10331
10332 # type: textblock
10333 #. type: textblock
10334 #: ../src/guestfs-actions.pod:1999 ../src/guestfs-actions.pod:5947
10335 msgid "(Added in 1.5.4)"
10336 msgstr ""
10337
10338 # type: =head2
10339 #. type: =head2
10340 #: ../src/guestfs-actions.pod:2001
10341 msgid "guestfs_get_path"
10342 msgstr ""
10343
10344 # type: verbatim
10345 #. type: verbatim
10346 #: ../src/guestfs-actions.pod:2003
10347 #, no-wrap
10348 msgid ""
10349 " const char *\n"
10350 " guestfs_get_path (guestfs_h *g);\n"
10351 "\n"
10352 msgstr ""
10353
10354 # type: textblock
10355 #. type: textblock
10356 #: ../src/guestfs-actions.pod:2006 ../fish/guestfish-actions.pod:1361
10357 msgid "Return the current search path."
10358 msgstr ""
10359
10360 # type: textblock
10361 #. type: textblock
10362 #: ../src/guestfs-actions.pod:2008 ../fish/guestfish-actions.pod:1363
10363 msgid ""
10364 "This is always non-NULL.  If it wasn't set already, then this will return "
10365 "the default path."
10366 msgstr ""
10367
10368 # type: textblock
10369 #. type: textblock
10370 #: ../src/guestfs-actions.pod:2011 ../src/guestfs-actions.pod:2040
10371 msgid ""
10372 "This function returns a string, or NULL on error.  The string is owned by "
10373 "the guest handle and must I<not> be freed."
10374 msgstr ""
10375
10376 # type: =head2
10377 #. type: =head2
10378 #: ../src/guestfs-actions.pod:2016
10379 msgid "guestfs_get_pid"
10380 msgstr ""
10381
10382 # type: verbatim
10383 #. type: verbatim
10384 #: ../src/guestfs-actions.pod:2018
10385 #, no-wrap
10386 msgid ""
10387 " int\n"
10388 " guestfs_get_pid (guestfs_h *g);\n"
10389 "\n"
10390 msgstr ""
10391
10392 # type: textblock
10393 #. type: textblock
10394 #: ../src/guestfs-actions.pod:2021 ../fish/guestfish-actions.pod:1372
10395 msgid ""
10396 "Return the process ID of the qemu subprocess.  If there is no qemu "
10397 "subprocess, then this will return an error."
10398 msgstr ""
10399
10400 # type: textblock
10401 #. type: textblock
10402 #: ../src/guestfs-actions.pod:2024 ../fish/guestfish-actions.pod:1375
10403 msgid "This is an internal call used for debugging and testing."
10404 msgstr ""
10405
10406 # type: textblock
10407 #. type: textblock
10408 #: ../src/guestfs-actions.pod:2028
10409 msgid "(Added in 1.0.56)"
10410 msgstr ""
10411
10412 # type: =head2
10413 #. type: =head2
10414 #: ../src/guestfs-actions.pod:2030
10415 msgid "guestfs_get_qemu"
10416 msgstr ""
10417
10418 # type: verbatim
10419 #. type: verbatim
10420 #: ../src/guestfs-actions.pod:2032
10421 #, no-wrap
10422 msgid ""
10423 " const char *\n"
10424 " guestfs_get_qemu (guestfs_h *g);\n"
10425 "\n"
10426 msgstr ""
10427
10428 # type: textblock
10429 #. type: textblock
10430 #: ../src/guestfs-actions.pod:2035 ../fish/guestfish-actions.pod:1381
10431 msgid "Return the current qemu binary."
10432 msgstr ""
10433
10434 # type: textblock
10435 #. type: textblock
10436 #: ../src/guestfs-actions.pod:2037 ../fish/guestfish-actions.pod:1383
10437 msgid ""
10438 "This is always non-NULL.  If it wasn't set already, then this will return "
10439 "the default qemu binary name."
10440 msgstr ""
10441
10442 # type: textblock
10443 #. type: textblock
10444 #: ../src/guestfs-actions.pod:2043 ../src/guestfs-actions.pod:5992
10445 msgid "(Added in 1.0.6)"
10446 msgstr ""
10447
10448 # type: =head2
10449 #. type: =head2
10450 #: ../src/guestfs-actions.pod:2045
10451 msgid "guestfs_get_recovery_proc"
10452 msgstr ""
10453
10454 # type: verbatim
10455 #. type: verbatim
10456 #: ../src/guestfs-actions.pod:2047
10457 #, no-wrap
10458 msgid ""
10459 " int\n"
10460 " guestfs_get_recovery_proc (guestfs_h *g);\n"
10461 "\n"
10462 msgstr ""
10463
10464 # type: textblock
10465 #. type: textblock
10466 #: ../src/guestfs-actions.pod:2050 ../fish/guestfish-actions.pod:1390
10467 msgid "Return the recovery process enabled flag."
10468 msgstr ""
10469
10470 # type: textblock
10471 #. type: textblock
10472 #: ../src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:3501
10473 #: ../src/guestfs-actions.pod:3798 ../src/guestfs-actions.pod:4198
10474 #: ../src/guestfs-actions.pod:4230 ../src/guestfs-actions.pod:5251
10475 #: ../src/guestfs-actions.pod:5594 ../src/guestfs-actions.pod:6016
10476 #: ../src/guestfs-actions.pod:6679 ../src/guestfs-actions.pod:6699
10477 #: ../src/guestfs-actions.pod:6891
10478 msgid "(Added in 1.0.77)"
10479 msgstr ""
10480
10481 # type: =head2
10482 #. type: =head2
10483 #: ../src/guestfs-actions.pod:2056
10484 msgid "guestfs_get_selinux"
10485 msgstr ""
10486
10487 # type: verbatim
10488 #. type: verbatim
10489 #: ../src/guestfs-actions.pod:2058
10490 #, no-wrap
10491 msgid ""
10492 " int\n"
10493 " guestfs_get_selinux (guestfs_h *g);\n"
10494 "\n"
10495 msgstr ""
10496
10497 # type: textblock
10498 #. type: textblock
10499 #: ../src/guestfs-actions.pod:2061
10500 msgid ""
10501 "This returns the current setting of the selinux flag which is passed to the "
10502 "appliance at boot time.  See C<guestfs_set_selinux>."
10503 msgstr ""
10504
10505 # type: textblock
10506 #. type: textblock
10507 #: ../src/guestfs-actions.pod:2069 ../src/guestfs-actions.pod:2132
10508 #: ../src/guestfs-actions.pod:6035 ../src/guestfs-actions.pod:6093
10509 msgid "(Added in 1.0.67)"
10510 msgstr ""
10511
10512 # type: =head2
10513 #. type: =head2
10514 #: ../src/guestfs-actions.pod:2071
10515 msgid "guestfs_get_state"
10516 msgstr ""
10517
10518 # type: verbatim
10519 #. type: verbatim
10520 #: ../src/guestfs-actions.pod:2073
10521 #, no-wrap
10522 msgid ""
10523 " int\n"
10524 " guestfs_get_state (guestfs_h *g);\n"
10525 "\n"
10526 msgstr ""
10527
10528 # type: textblock
10529 #. type: textblock
10530 #: ../src/guestfs-actions.pod:2076 ../fish/guestfish-actions.pod:1406
10531 msgid ""
10532 "This returns the current state as an opaque integer.  This is only useful "
10533 "for printing debug and internal error messages."
10534 msgstr ""
10535
10536 # type: textblock
10537 #. type: textblock
10538 #: ../src/guestfs-actions.pod:2079 ../src/guestfs-actions.pod:3299
10539 #: ../src/guestfs-actions.pod:3328 ../src/guestfs-actions.pod:3389
10540 #: ../src/guestfs-actions.pod:3416 ../fish/guestfish-actions.pod:1409
10541 #: ../fish/guestfish-actions.pod:2323 ../fish/guestfish-actions.pod:2341
10542 #: ../fish/guestfish-actions.pod:2379 ../fish/guestfish-actions.pod:2395
10543 msgid "For more information on states, see L<guestfs(3)>."
10544 msgstr ""
10545
10546 # type: =head2
10547 #. type: =head2
10548 #: ../src/guestfs-actions.pod:2085
10549 msgid "guestfs_get_trace"
10550 msgstr ""
10551
10552 # type: verbatim
10553 #. type: verbatim
10554 #: ../src/guestfs-actions.pod:2087
10555 #, no-wrap
10556 msgid ""
10557 " int\n"
10558 " guestfs_get_trace (guestfs_h *g);\n"
10559 "\n"
10560 msgstr ""
10561
10562 # type: textblock
10563 #. type: textblock
10564 #: ../src/guestfs-actions.pod:2090 ../fish/guestfish-actions.pod:1415
10565 msgid "Return the command trace flag."
10566 msgstr ""
10567
10568 # type: =head2
10569 #. type: =head2
10570 #: ../src/guestfs-actions.pod:2096
10571 msgid "guestfs_get_umask"
10572 msgstr ""
10573
10574 # type: verbatim
10575 #. type: verbatim
10576 #: ../src/guestfs-actions.pod:2098
10577 #, no-wrap
10578 msgid ""
10579 " int\n"
10580 " guestfs_get_umask (guestfs_h *g);\n"
10581 "\n"
10582 msgstr ""
10583
10584 # type: textblock
10585 #. type: textblock
10586 #: ../src/guestfs-actions.pod:2101
10587 msgid ""
10588 "Return the current umask.  By default the umask is C<022> unless it has been "
10589 "set by calling C<guestfs_umask>."
10590 msgstr ""
10591
10592 # type: =head2
10593 #. type: =head2
10594 #: ../src/guestfs-actions.pod:2108
10595 msgid "guestfs_get_verbose"
10596 msgstr ""
10597
10598 # type: verbatim
10599 #. type: verbatim
10600 #: ../src/guestfs-actions.pod:2110
10601 #, no-wrap
10602 msgid ""
10603 " int\n"
10604 " guestfs_get_verbose (guestfs_h *g);\n"
10605 "\n"
10606 msgstr ""
10607
10608 # type: textblock
10609 #. type: textblock
10610 #: ../src/guestfs-actions.pod:2113 ../fish/guestfish-actions.pod:1428
10611 msgid "This returns the verbose messages flag."
10612 msgstr ""
10613
10614 # type: =head2
10615 #. type: =head2
10616 #: ../src/guestfs-actions.pod:2119
10617 msgid "guestfs_getcon"
10618 msgstr ""
10619
10620 # type: verbatim
10621 #. type: verbatim
10622 #: ../src/guestfs-actions.pod:2121
10623 #, no-wrap
10624 msgid ""
10625 " char *\n"
10626 " guestfs_getcon (guestfs_h *g);\n"
10627 "\n"
10628 msgstr ""
10629
10630 # type: textblock
10631 #. type: textblock
10632 #: ../src/guestfs-actions.pod:2124 ../fish/guestfish-actions.pod:1434
10633 msgid "This gets the SELinux security context of the daemon."
10634 msgstr ""
10635
10636 # type: textblock
10637 #. type: textblock
10638 #: ../src/guestfs-actions.pod:2126
10639 msgid ""
10640 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10641 msgstr ""
10642
10643 # type: =head2
10644 #. type: =head2
10645 #: ../src/guestfs-actions.pod:2134
10646 msgid "guestfs_getxattr"
10647 msgstr ""
10648
10649 # type: verbatim
10650 #. type: verbatim
10651 #: ../src/guestfs-actions.pod:2136
10652 #, no-wrap
10653 msgid ""
10654 " char *\n"
10655 " guestfs_getxattr (guestfs_h *g,\n"
10656 "                   const char *path,\n"
10657 "                   const char *name,\n"
10658 "                   size_t *size_r);\n"
10659 "\n"
10660 msgstr ""
10661
10662 # type: textblock
10663 #. type: textblock
10664 #: ../src/guestfs-actions.pod:2142
10665 msgid ""
10666 "Get a single extended attribute from file C<path> named C<name>.  This call "
10667 "follows symlinks.  If you want to lookup an extended attribute for the "
10668 "symlink itself, use C<guestfs_lgetxattr>."
10669 msgstr ""
10670
10671 # type: textblock
10672 #. type: textblock
10673 #: ../src/guestfs-actions.pod:2146 ../src/guestfs-actions.pod:3515
10674 msgid ""
10675 "Normally it is better to get all extended attributes from a file in one go "
10676 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10677 "implementations are buggy and do not provide a way to list out attributes.  "
10678 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10679 "extended attributes you want in advance and call this function."
10680 msgstr ""
10681
10682 # type: textblock
10683 #. type: textblock
10684 #: ../src/guestfs-actions.pod:2153 ../src/guestfs-actions.pod:3522
10685 #: ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:2460
10686 msgid ""
10687 "Extended attribute values are blobs of binary data.  If there is no extended "
10688 "attribute named C<name>, this returns an error."
10689 msgstr ""
10690
10691 # type: textblock
10692 #. type: textblock
10693 #: ../src/guestfs-actions.pod:2156
10694 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10695 msgstr ""
10696
10697 # type: textblock
10698 #. type: textblock
10699 #: ../src/guestfs-actions.pod:2158 ../src/guestfs-actions.pod:2349
10700 #: ../src/guestfs-actions.pod:3527 ../src/guestfs-actions.pod:5244
10701 #: ../src/guestfs-actions.pod:5270 ../src/guestfs-actions.pod:5451
10702 msgid ""
10703 "This function returns a buffer, or NULL on error.  The size of the returned "
10704 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10705 "after use>."
10706 msgstr ""
10707
10708 #. type: textblock
10709 #: ../src/guestfs-actions.pod:2162 ../src/guestfs-actions.pod:3531
10710 msgid "(Added in 1.7.24)"
10711 msgstr ""
10712
10713 # type: =head2
10714 #. type: =head2
10715 #: ../src/guestfs-actions.pod:2164
10716 msgid "guestfs_getxattrs"
10717 msgstr ""
10718
10719 # type: verbatim
10720 #. type: verbatim
10721 #: ../src/guestfs-actions.pod:2166
10722 #, no-wrap
10723 msgid ""
10724 " struct guestfs_xattr_list *\n"
10725 " guestfs_getxattrs (guestfs_h *g,\n"
10726 "                    const char *path);\n"
10727 "\n"
10728 msgstr ""
10729
10730 # type: textblock
10731 #. type: textblock
10732 #: ../src/guestfs-actions.pod:2170 ../fish/guestfish-actions.pod:1463
10733 msgid ""
10734 "This call lists the extended attributes of the file or directory C<path>."
10735 msgstr ""
10736
10737 # type: textblock
10738 #. type: textblock
10739 #: ../src/guestfs-actions.pod:2173 ../fish/guestfish-actions.pod:1466
10740 msgid ""
10741 "At the system call level, this is a combination of the L<listxattr(2)> and "
10742 "L<getxattr(2)> calls."
10743 msgstr ""
10744
10745 # type: textblock
10746 #. type: textblock
10747 #: ../src/guestfs-actions.pod:2176
10748 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10749 msgstr ""
10750
10751 # type: textblock
10752 #. type: textblock
10753 #: ../src/guestfs-actions.pod:2178 ../src/guestfs-actions.pod:3543
10754 #: ../src/guestfs-actions.pod:4194
10755 msgid ""
10756 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10757 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10758 msgstr ""
10759
10760 # type: textblock
10761 #. type: textblock
10762 #: ../src/guestfs-actions.pod:2182 ../src/guestfs-actions.pod:3547
10763 #: ../src/guestfs-actions.pod:3712 ../src/guestfs-actions.pod:3748
10764 #: ../src/guestfs-actions.pod:5624 ../src/guestfs-actions.pod:6112
10765 #: ../src/guestfs-actions.pod:7447
10766 msgid "(Added in 1.0.59)"
10767 msgstr ""
10768
10769 # type: =head2
10770 #. type: =head2
10771 #: ../src/guestfs-actions.pod:2184
10772 msgid "guestfs_glob_expand"
10773 msgstr ""
10774
10775 # type: verbatim
10776 #. type: verbatim
10777 #: ../src/guestfs-actions.pod:2186
10778 #, no-wrap
10779 msgid ""
10780 " char **\n"
10781 " guestfs_glob_expand (guestfs_h *g,\n"
10782 "                      const char *pattern);\n"
10783 "\n"
10784 msgstr ""
10785
10786 # type: textblock
10787 #. type: textblock
10788 #: ../src/guestfs-actions.pod:2190 ../fish/guestfish-actions.pod:1475
10789 msgid ""
10790 "This command searches for all the pathnames matching C<pattern> according to "
10791 "the wildcard expansion rules used by the shell."
10792 msgstr ""
10793
10794 # type: textblock
10795 #. type: textblock
10796 #: ../src/guestfs-actions.pod:2194 ../fish/guestfish-actions.pod:1479
10797 msgid ""
10798 "If no paths match, then this returns an empty list (note: not an error)."
10799 msgstr ""
10800
10801 # type: textblock
10802 #. type: textblock
10803 #: ../src/guestfs-actions.pod:2197 ../fish/guestfish-actions.pod:1482
10804 msgid ""
10805 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10806 "GLOB_BRACE>.  See that manual page for more details."
10807 msgstr ""
10808
10809 # type: textblock
10810 #. type: textblock
10811 #: ../src/guestfs-actions.pod:2205 ../src/guestfs-actions.pod:6277
10812 #: ../src/guestfs-actions.pod:6294
10813 msgid "(Added in 1.0.50)"
10814 msgstr ""
10815
10816 # type: =head2
10817 #. type: =head2
10818 #: ../src/guestfs-actions.pod:2207
10819 msgid "guestfs_grep"
10820 msgstr ""
10821
10822 # type: verbatim
10823 #. type: verbatim
10824 #: ../src/guestfs-actions.pod:2209
10825 #, no-wrap
10826 msgid ""
10827 " char **\n"
10828 " guestfs_grep (guestfs_h *g,\n"
10829 "               const char *regex,\n"
10830 "               const char *path);\n"
10831 "\n"
10832 msgstr ""
10833
10834 # type: textblock
10835 #. type: textblock
10836 #: ../src/guestfs-actions.pod:2214 ../fish/guestfish-actions.pod:1490
10837 msgid "This calls the external C<grep> program and returns the matching lines."
10838 msgstr ""
10839
10840 # type: =head2
10841 #. type: =head2
10842 #: ../src/guestfs-actions.pod:2226
10843 msgid "guestfs_grepi"
10844 msgstr ""
10845
10846 # type: verbatim
10847 #. type: verbatim
10848 #: ../src/guestfs-actions.pod:2228
10849 #, no-wrap
10850 msgid ""
10851 " char **\n"
10852 " guestfs_grepi (guestfs_h *g,\n"
10853 "                const char *regex,\n"
10854 "                const char *path);\n"
10855 "\n"
10856 msgstr ""
10857
10858 # type: textblock
10859 #. type: textblock
10860 #: ../src/guestfs-actions.pod:2233 ../fish/guestfish-actions.pod:1500
10861 msgid ""
10862 "This calls the external C<grep -i> program and returns the matching lines."
10863 msgstr ""
10864
10865 # type: =head2
10866 #. type: =head2
10867 #: ../src/guestfs-actions.pod:2245
10868 msgid "guestfs_grub_install"
10869 msgstr ""
10870
10871 # type: verbatim
10872 #. type: verbatim
10873 #: ../src/guestfs-actions.pod:2247
10874 #, no-wrap
10875 msgid ""
10876 " int\n"
10877 " guestfs_grub_install (guestfs_h *g,\n"
10878 "                       const char *root,\n"
10879 "                       const char *device);\n"
10880 "\n"
10881 msgstr ""
10882
10883 # type: textblock
10884 #. type: textblock
10885 #: ../src/guestfs-actions.pod:2252 ../fish/guestfish-actions.pod:1510
10886 msgid ""
10887 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
10888 "the root directory being C<root>."
10889 msgstr ""
10890
10891 # type: textblock
10892 #. type: textblock
10893 #: ../src/guestfs-actions.pod:2255 ../fish/guestfish-actions.pod:1513
10894 msgid ""
10895 "Note: If grub-install reports the error \"No suitable drive was found in the "
10896 "generated device map.\" it may be that you need to create a C</boot/grub/"
10897 "device.map> file first that contains the mapping between grub device names "
10898 "and Linux device names.  It is usually sufficient to create a file "
10899 "containing:"
10900 msgstr ""
10901
10902 # type: verbatim
10903 #. type: verbatim
10904 #: ../src/guestfs-actions.pod:2262 ../fish/guestfish-actions.pod:1520
10905 #, no-wrap
10906 msgid ""
10907 " (hd0) /dev/vda\n"
10908 "\n"
10909 msgstr ""
10910
10911 # type: textblock
10912 #. type: textblock
10913 #: ../src/guestfs-actions.pod:2264 ../fish/guestfish-actions.pod:1522
10914 msgid "replacing C</dev/vda> with the name of the installation device."
10915 msgstr ""
10916
10917 # type: textblock
10918 #. type: textblock
10919 #: ../src/guestfs-actions.pod:2268
10920 msgid "(Added in 1.0.17)"
10921 msgstr ""
10922
10923 # type: =head2
10924 #. type: =head2
10925 #: ../src/guestfs-actions.pod:2270
10926 msgid "guestfs_head"
10927 msgstr ""
10928
10929 # type: verbatim
10930 #. type: verbatim
10931 #: ../src/guestfs-actions.pod:2272
10932 #, no-wrap
10933 msgid ""
10934 " char **\n"
10935 " guestfs_head (guestfs_h *g,\n"
10936 "               const char *path);\n"
10937 "\n"
10938 msgstr ""
10939
10940 # type: textblock
10941 #. type: textblock
10942 #: ../src/guestfs-actions.pod:2276 ../fish/guestfish-actions.pod:1528
10943 msgid ""
10944 "This command returns up to the first 10 lines of a file as a list of strings."
10945 msgstr ""
10946
10947 # type: =head2
10948 #. type: =head2
10949 #: ../src/guestfs-actions.pod:2288
10950 msgid "guestfs_head_n"
10951 msgstr ""
10952
10953 # type: verbatim
10954 #. type: verbatim
10955 #: ../src/guestfs-actions.pod:2290
10956 #, no-wrap
10957 msgid ""
10958 " char **\n"
10959 " guestfs_head_n (guestfs_h *g,\n"
10960 "                 int nrlines,\n"
10961 "                 const char *path);\n"
10962 "\n"
10963 msgstr ""
10964
10965 # type: textblock
10966 #. type: textblock
10967 #: ../src/guestfs-actions.pod:2295 ../fish/guestfish-actions.pod:1538
10968 msgid ""
10969 "If the parameter C<nrlines> is a positive number, this returns the first "
10970 "C<nrlines> lines of the file C<path>."
10971 msgstr ""
10972
10973 # type: textblock
10974 #. type: textblock
10975 #: ../src/guestfs-actions.pod:2298 ../fish/guestfish-actions.pod:1541
10976 msgid ""
10977 "If the parameter C<nrlines> is a negative number, this returns lines from "
10978 "the file C<path>, excluding the last C<nrlines> lines."
10979 msgstr ""
10980
10981 # type: textblock
10982 #. type: textblock
10983 #: ../src/guestfs-actions.pod:2301 ../src/guestfs-actions.pod:6574
10984 #: ../fish/guestfish-actions.pod:1544 ../fish/guestfish-actions.pod:4430
10985 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
10986 msgstr ""
10987
10988 # type: =head2
10989 #. type: =head2
10990 #: ../src/guestfs-actions.pod:2312
10991 msgid "guestfs_hexdump"
10992 msgstr ""
10993
10994 # type: verbatim
10995 #. type: verbatim
10996 #: ../src/guestfs-actions.pod:2314
10997 #, no-wrap
10998 msgid ""
10999 " char *\n"
11000 " guestfs_hexdump (guestfs_h *g,\n"
11001 "                  const char *path);\n"
11002 "\n"
11003 msgstr ""
11004
11005 # type: textblock
11006 #. type: textblock
11007 #: ../src/guestfs-actions.pod:2318 ../fish/guestfish-actions.pod:1553
11008 msgid ""
11009 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
11010 "readable, canonical hex dump of the file."
11011 msgstr ""
11012
11013 # type: textblock
11014 #. type: textblock
11015 #: ../src/guestfs-actions.pod:2327 ../src/guestfs-actions.pod:6358
11016 #: ../src/guestfs-actions.pod:6413
11017 msgid "(Added in 1.0.22)"
11018 msgstr ""
11019
11020 # type: =head2
11021 #. type: =head2
11022 #: ../src/guestfs-actions.pod:2329
11023 msgid "guestfs_initrd_cat"
11024 msgstr ""
11025
11026 # type: verbatim
11027 #. type: verbatim
11028 #: ../src/guestfs-actions.pod:2331
11029 #, no-wrap
11030 msgid ""
11031 " char *\n"
11032 " guestfs_initrd_cat (guestfs_h *g,\n"
11033 "                     const char *initrdpath,\n"
11034 "                     const char *filename,\n"
11035 "                     size_t *size_r);\n"
11036 "\n"
11037 msgstr ""
11038
11039 # type: textblock
11040 #. type: textblock
11041 #: ../src/guestfs-actions.pod:2337 ../fish/guestfish-actions.pod:1563
11042 msgid ""
11043 "This command unpacks the file C<filename> from the initrd file called "
11044 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
11045 "character."
11046 msgstr ""
11047
11048 # type: textblock
11049 #. type: textblock
11050 #: ../src/guestfs-actions.pod:2341 ../fish/guestfish-actions.pod:1567
11051 msgid ""
11052 "For example, in guestfish you could use the following command to examine the "
11053 "boot script (usually called C</init>)  contained in a Linux initrd or "
11054 "initramfs image:"
11055 msgstr ""
11056
11057 # type: verbatim
11058 #. type: verbatim
11059 #: ../src/guestfs-actions.pod:2345 ../fish/guestfish-actions.pod:1571
11060 #, no-wrap
11061 msgid ""
11062 " initrd-cat /boot/initrd-<version>.img init\n"
11063 "\n"
11064 msgstr ""
11065
11066 # type: textblock
11067 #. type: textblock
11068 #: ../src/guestfs-actions.pod:2347
11069 msgid "See also C<guestfs_initrd_list>."
11070 msgstr ""
11071
11072 # type: =head2
11073 #. type: =head2
11074 #: ../src/guestfs-actions.pod:2358
11075 msgid "guestfs_initrd_list"
11076 msgstr ""
11077
11078 # type: verbatim
11079 #. type: verbatim
11080 #: ../src/guestfs-actions.pod:2360
11081 #, no-wrap
11082 msgid ""
11083 " char **\n"
11084 " guestfs_initrd_list (guestfs_h *g,\n"
11085 "                      const char *path);\n"
11086 "\n"
11087 msgstr ""
11088
11089 # type: textblock
11090 #. type: textblock
11091 #: ../src/guestfs-actions.pod:2364 ../fish/guestfish-actions.pod:1582
11092 msgid "This command lists out files contained in an initrd."
11093 msgstr ""
11094
11095 # type: textblock
11096 #. type: textblock
11097 #: ../src/guestfs-actions.pod:2366 ../fish/guestfish-actions.pod:1584
11098 msgid ""
11099 "The files are listed without any initial C</> character.  The files are "
11100 "listed in the order they appear (not necessarily alphabetical).  Directory "
11101 "names are listed as separate items."
11102 msgstr ""
11103
11104 # type: textblock
11105 #. type: textblock
11106 #: ../src/guestfs-actions.pod:2370 ../fish/guestfish-actions.pod:1588
11107 msgid ""
11108 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
11109 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
11110 "files)."
11111 msgstr ""
11112
11113 # type: =head2
11114 #. type: =head2
11115 #: ../src/guestfs-actions.pod:2380
11116 msgid "guestfs_inotify_add_watch"
11117 msgstr ""
11118
11119 # type: verbatim
11120 #. type: verbatim
11121 #: ../src/guestfs-actions.pod:2382
11122 #, no-wrap
11123 msgid ""
11124 " int64_t\n"
11125 " guestfs_inotify_add_watch (guestfs_h *g,\n"
11126 "                            const char *path,\n"
11127 "                            int mask);\n"
11128 "\n"
11129 msgstr ""
11130
11131 # type: textblock
11132 #. type: textblock
11133 #: ../src/guestfs-actions.pod:2387 ../fish/guestfish-actions.pod:1596
11134 msgid "Watch C<path> for the events listed in C<mask>."
11135 msgstr ""
11136
11137 # type: textblock
11138 #. type: textblock
11139 #: ../src/guestfs-actions.pod:2389 ../fish/guestfish-actions.pod:1598
11140 msgid ""
11141 "Note that if C<path> is a directory then events within that directory are "
11142 "watched, but this does I<not> happen recursively (in subdirectories)."
11143 msgstr ""
11144
11145 # type: textblock
11146 #. type: textblock
11147 #: ../src/guestfs-actions.pod:2393 ../fish/guestfish-actions.pod:1602
11148 msgid ""
11149 "Note for non-C or non-Linux callers: the inotify events are defined by the "
11150 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
11151 msgstr ""
11152
11153 # type: =head2
11154 #. type: =head2
11155 #: ../src/guestfs-actions.pod:2401
11156 msgid "guestfs_inotify_close"
11157 msgstr ""
11158
11159 # type: verbatim
11160 #. type: verbatim
11161 #: ../src/guestfs-actions.pod:2403
11162 #, no-wrap
11163 msgid ""
11164 " int\n"
11165 " guestfs_inotify_close (guestfs_h *g);\n"
11166 "\n"
11167 msgstr ""
11168
11169 # type: textblock
11170 #. type: textblock
11171 #: ../src/guestfs-actions.pod:2406 ../fish/guestfish-actions.pod:1610
11172 msgid ""
11173 "This closes the inotify handle which was previously opened by inotify_init.  "
11174 "It removes all watches, throws away any pending events, and deallocates all "
11175 "resources."
11176 msgstr ""
11177
11178 # type: =head2
11179 #. type: =head2
11180 #: ../src/guestfs-actions.pod:2414
11181 msgid "guestfs_inotify_files"
11182 msgstr ""
11183
11184 # type: verbatim
11185 #. type: verbatim
11186 #: ../src/guestfs-actions.pod:2416
11187 #, no-wrap
11188 msgid ""
11189 " char **\n"
11190 " guestfs_inotify_files (guestfs_h *g);\n"
11191 "\n"
11192 msgstr ""
11193
11194 # type: textblock
11195 #. type: textblock
11196 #: ../src/guestfs-actions.pod:2419
11197 msgid ""
11198 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
11199 "returns a list of pathnames of objects that were touched.  The returned "
11200 "pathnames are sorted and deduplicated."
11201 msgstr ""
11202
11203 # type: =head2
11204 #. type: =head2
11205 #: ../src/guestfs-actions.pod:2429
11206 msgid "guestfs_inotify_init"
11207 msgstr ""
11208
11209 # type: verbatim
11210 #. type: verbatim
11211 #: ../src/guestfs-actions.pod:2431
11212 #, no-wrap
11213 msgid ""
11214 " int\n"
11215 " guestfs_inotify_init (guestfs_h *g,\n"
11216 "                       int maxevents);\n"
11217 "\n"
11218 msgstr ""
11219
11220 # type: textblock
11221 #. type: textblock
11222 #: ../src/guestfs-actions.pod:2435 ../fish/guestfish-actions.pod:1626
11223 msgid ""
11224 "This command creates a new inotify handle.  The inotify subsystem can be "
11225 "used to notify events which happen to objects in the guest filesystem."
11226 msgstr ""
11227
11228 # type: textblock
11229 #. type: textblock
11230 #: ../src/guestfs-actions.pod:2439
11231 msgid ""
11232 "C<maxevents> is the maximum number of events which will be queued up between "
11233 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
11234 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
11235 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
11236 "throws away events, but records the fact that it threw them away by setting "
11237 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
11238 "C<guestfs_inotify_read>)."
11239 msgstr ""
11240
11241 # type: textblock
11242 #. type: textblock
11243 #: ../src/guestfs-actions.pod:2449
11244 msgid ""
11245 "Before any events are generated, you have to add some watches to the "
11246 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
11247 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
11248 msgstr ""
11249
11250 # type: textblock
11251 #. type: textblock
11252 #: ../src/guestfs-actions.pod:2455
11253 msgid ""
11254 "Queued up events should be read periodically by calling "
11255 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
11256 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
11257 "often enough then you risk the internal queue overflowing."
11258 msgstr ""
11259
11260 # type: textblock
11261 #. type: textblock
11262 #: ../src/guestfs-actions.pod:2462
11263 msgid ""
11264 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
11265 "This also removes any watches automatically."
11266 msgstr ""
11267
11268 # type: textblock
11269 #. type: textblock
11270 #: ../src/guestfs-actions.pod:2466 ../fish/guestfish-actions.pod:1657
11271 msgid ""
11272 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
11273 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
11274 "that there is one global inotify handle per libguestfs instance."
11275 msgstr ""
11276
11277 # type: =head2
11278 #. type: =head2
11279 #: ../src/guestfs-actions.pod:2475
11280 msgid "guestfs_inotify_read"
11281 msgstr ""
11282
11283 # type: verbatim
11284 #. type: verbatim
11285 #: ../src/guestfs-actions.pod:2477
11286 #, no-wrap
11287 msgid ""
11288 " struct guestfs_inotify_event_list *\n"
11289 " guestfs_inotify_read (guestfs_h *g);\n"
11290 "\n"
11291 msgstr ""
11292
11293 # type: textblock
11294 #. type: textblock
11295 #: ../src/guestfs-actions.pod:2480 ../fish/guestfish-actions.pod:1666
11296 msgid ""
11297 "Return the complete queue of events that have happened since the previous "
11298 "read call."
11299 msgstr ""
11300
11301 # type: textblock
11302 #. type: textblock
11303 #: ../src/guestfs-actions.pod:2483 ../fish/guestfish-actions.pod:1669
11304 msgid "If no events have happened, this returns an empty list."
11305 msgstr ""
11306
11307 # type: textblock
11308 #. type: textblock
11309 #: ../src/guestfs-actions.pod:2485 ../fish/guestfish-actions.pod:1671
11310 msgid ""
11311 "I<Note>: In order to make sure that all events have been read, you must call "
11312 "this function repeatedly until it returns an empty list.  The reason is that "
11313 "the call will read events up to the maximum appliance-to-host message size "
11314 "and leave remaining events in the queue."
11315 msgstr ""
11316
11317 # type: textblock
11318 #. type: textblock
11319 #: ../src/guestfs-actions.pod:2491
11320 msgid ""
11321 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
11322 "there was an error.  I<The caller must call "
11323 "C<guestfs_free_inotify_event_list> after use>."
11324 msgstr ""
11325
11326 # type: =head2
11327 #. type: =head2
11328 #: ../src/guestfs-actions.pod:2497
11329 msgid "guestfs_inotify_rm_watch"
11330 msgstr ""
11331
11332 # type: verbatim
11333 #. type: verbatim
11334 #: ../src/guestfs-actions.pod:2499
11335 #, no-wrap
11336 msgid ""
11337 " int\n"
11338 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
11339 "                           int wd);\n"
11340 "\n"
11341 msgstr ""
11342
11343 # type: textblock
11344 #. type: textblock
11345 #: ../src/guestfs-actions.pod:2503
11346 msgid ""
11347 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
11348 msgstr ""
11349
11350 # type: =head2
11351 #. type: =head2
11352 #: ../src/guestfs-actions.pod:2510
11353 msgid "guestfs_inspect_get_arch"
11354 msgstr ""
11355
11356 # type: verbatim
11357 #. type: verbatim
11358 #: ../src/guestfs-actions.pod:2512
11359 #, no-wrap
11360 msgid ""
11361 " char *\n"
11362 " guestfs_inspect_get_arch (guestfs_h *g,\n"
11363 "                           const char *root);\n"
11364 "\n"
11365 msgstr ""
11366
11367 # type: textblock
11368 #. type: textblock
11369 #: ../src/guestfs-actions.pod:2516 ../src/guestfs-actions.pod:2539
11370 #: ../src/guestfs-actions.pod:2632 ../src/guestfs-actions.pod:2676
11371 #: ../src/guestfs-actions.pod:2702 ../src/guestfs-actions.pod:2741
11372 #: ../src/guestfs-actions.pod:2763 ../src/guestfs-actions.pod:2790
11373 #: ../src/guestfs-actions.pod:2811 ../src/guestfs-actions.pod:2854
11374 #: ../src/guestfs-actions.pod:2883 ../src/guestfs-actions.pod:2914
11375 #: ../src/guestfs-actions.pod:2938 ../src/guestfs-actions.pod:2993
11376 #: ../src/guestfs-actions.pod:3035 ../src/guestfs-actions.pod:3056
11377 #: ../src/guestfs-actions.pod:3079 ../src/guestfs-actions.pod:3096
11378 #: ../src/guestfs-actions.pod:3113 ../src/guestfs-actions.pod:3132
11379 msgid ""
11380 "This function should only be called with a root device string as returned by "
11381 "C<guestfs_inspect_os>."
11382 msgstr ""
11383
11384 # type: textblock
11385 #. type: textblock
11386 #: ../src/guestfs-actions.pod:2519
11387 msgid ""
11388 "This returns the architecture of the inspected operating system.  The "
11389 "possible return values are listed under C<guestfs_file_architecture>."
11390 msgstr ""
11391
11392 # type: textblock
11393 #. type: textblock
11394 #: ../src/guestfs-actions.pod:2523 ../fish/guestfish-actions.pod:1695
11395 msgid ""
11396 "If the architecture could not be determined, then the string C<unknown> is "
11397 "returned."
11398 msgstr ""
11399
11400 # type: textblock
11401 #. type: textblock
11402 #: ../src/guestfs-actions.pod:2526 ../src/guestfs-actions.pod:2619
11403 #: ../src/guestfs-actions.pod:2730 ../src/guestfs-actions.pod:2750
11404 #: ../src/guestfs-actions.pod:2778 ../src/guestfs-actions.pod:2870
11405 #: ../src/guestfs-actions.pod:2901 ../src/guestfs-actions.pod:2925
11406 #: ../src/guestfs-actions.pod:2979 ../src/guestfs-actions.pod:3022
11407 #: ../src/guestfs-actions.pod:3045 ../src/guestfs-actions.pod:3066
11408 #: ../src/guestfs-actions.pod:3086 ../src/guestfs-actions.pod:3103
11409 #: ../src/guestfs-actions.pod:3122 ../src/guestfs-actions.pod:3225
11410 #: ../src/guestfs-actions.pod:3266 ../fish/guestfish-actions.pod:1698
11411 #: ../fish/guestfish-actions.pod:1784 ../fish/guestfish-actions.pod:1872
11412 #: ../fish/guestfish-actions.pod:1887 ../fish/guestfish-actions.pod:1908
11413 #: ../fish/guestfish-actions.pod:1978 ../fish/guestfish-actions.pod:2002
11414 #: ../fish/guestfish-actions.pod:2019 ../fish/guestfish-actions.pod:2062
11415 #: ../fish/guestfish-actions.pod:2097 ../fish/guestfish-actions.pod:2113
11416 #: ../fish/guestfish-actions.pod:2129 ../fish/guestfish-actions.pod:2142
11417 #: ../fish/guestfish-actions.pod:2155 ../fish/guestfish-actions.pod:2170
11418 #: ../fish/guestfish-actions.pod:2269 ../fish/guestfish-actions.pod:2303
11419 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
11420 msgstr ""
11421
11422 # type: =head2
11423 #. type: =head2
11424 #: ../src/guestfs-actions.pod:2533
11425 msgid "guestfs_inspect_get_distro"
11426 msgstr ""
11427
11428 # type: verbatim
11429 #. type: verbatim
11430 #: ../src/guestfs-actions.pod:2535
11431 #, no-wrap
11432 msgid ""
11433 " char *\n"
11434 " guestfs_inspect_get_distro (guestfs_h *g,\n"
11435 "                             const char *root);\n"
11436 "\n"
11437 msgstr ""
11438
11439 # type: textblock
11440 #. type: textblock
11441 #: ../src/guestfs-actions.pod:2542 ../fish/guestfish-actions.pod:1707
11442 msgid ""
11443 "This returns the distro (distribution) of the inspected operating system."
11444 msgstr ""
11445
11446 # type: textblock
11447 #. type: textblock
11448 #: ../src/guestfs-actions.pod:2545 ../fish/guestfish-actions.pod:1710
11449 msgid "Currently defined distros are:"
11450 msgstr ""
11451
11452 # type: =item
11453 #. type: =item
11454 #: ../src/guestfs-actions.pod:2549 ../fish/guestfish-actions.pod:1714
11455 msgid "\"archlinux\""
11456 msgstr ""
11457
11458 # type: textblock
11459 #. type: textblock
11460 #: ../src/guestfs-actions.pod:2551 ../fish/guestfish-actions.pod:1716
11461 msgid "Arch Linux."
11462 msgstr ""
11463
11464 #. type: =item
11465 #: ../src/guestfs-actions.pod:2553 ../fish/guestfish-actions.pod:1718
11466 msgid "\"centos\""
11467 msgstr ""
11468
11469 #. type: textblock
11470 #: ../src/guestfs-actions.pod:2555 ../fish/guestfish-actions.pod:1720
11471 msgid "CentOS."
11472 msgstr ""
11473
11474 # type: =item
11475 #. type: =item
11476 #: ../src/guestfs-actions.pod:2557 ../fish/guestfish-actions.pod:1722
11477 msgid "\"debian\""
11478 msgstr ""
11479
11480 # type: textblock
11481 #. type: textblock
11482 #: ../src/guestfs-actions.pod:2559 ../fish/guestfish-actions.pod:1724
11483 msgid "Debian."
11484 msgstr ""
11485
11486 # type: =item
11487 #. type: =item
11488 #: ../src/guestfs-actions.pod:2561 ../fish/guestfish-actions.pod:1726
11489 msgid "\"fedora\""
11490 msgstr ""
11491
11492 # type: textblock
11493 #. type: textblock
11494 #: ../src/guestfs-actions.pod:2563 ../fish/guestfish-actions.pod:1728
11495 msgid "Fedora."
11496 msgstr ""
11497
11498 # type: =item
11499 #. type: =item
11500 #: ../src/guestfs-actions.pod:2565 ../fish/guestfish-actions.pod:1730
11501 msgid "\"gentoo\""
11502 msgstr ""
11503
11504 # type: textblock
11505 #. type: textblock
11506 #: ../src/guestfs-actions.pod:2567 ../fish/guestfish-actions.pod:1732
11507 msgid "Gentoo."
11508 msgstr ""
11509
11510 # type: =item
11511 #. type: =item
11512 #: ../src/guestfs-actions.pod:2569 ../fish/guestfish-actions.pod:1734
11513 msgid "\"linuxmint\""
11514 msgstr ""
11515
11516 # type: textblock
11517 #. type: textblock
11518 #: ../src/guestfs-actions.pod:2571 ../fish/guestfish-actions.pod:1736
11519 msgid "Linux Mint."
11520 msgstr ""
11521
11522 # type: =item
11523 #. type: =item
11524 #: ../src/guestfs-actions.pod:2573 ../fish/guestfish-actions.pod:1738
11525 msgid "\"mandriva\""
11526 msgstr ""
11527
11528 # type: textblock
11529 #. type: textblock
11530 #: ../src/guestfs-actions.pod:2575 ../fish/guestfish-actions.pod:1740
11531 msgid "Mandriva."
11532 msgstr ""
11533
11534 # type: =item
11535 #. type: =item
11536 #: ../src/guestfs-actions.pod:2577 ../fish/guestfish-actions.pod:1742
11537 msgid "\"meego\""
11538 msgstr ""
11539
11540 # type: textblock
11541 #. type: textblock
11542 #: ../src/guestfs-actions.pod:2579 ../fish/guestfish-actions.pod:1744
11543 msgid "MeeGo."
11544 msgstr ""
11545
11546 # type: =item
11547 #. type: =item
11548 #: ../src/guestfs-actions.pod:2581 ../fish/guestfish-actions.pod:1746
11549 msgid "\"pardus\""
11550 msgstr ""
11551
11552 # type: textblock
11553 #. type: textblock
11554 #: ../src/guestfs-actions.pod:2583 ../fish/guestfish-actions.pod:1748
11555 msgid "Pardus."
11556 msgstr ""
11557
11558 # type: =item
11559 #. type: =item
11560 #: ../src/guestfs-actions.pod:2585 ../fish/guestfish-actions.pod:1750
11561 msgid "\"redhat-based\""
11562 msgstr ""
11563
11564 # type: textblock
11565 #. type: textblock
11566 #: ../src/guestfs-actions.pod:2587 ../fish/guestfish-actions.pod:1752
11567 msgid "Some Red Hat-derived distro."
11568 msgstr ""
11569
11570 # type: =item
11571 #. type: =item
11572 #: ../src/guestfs-actions.pod:2589 ../fish/guestfish-actions.pod:1754
11573 msgid "\"rhel\""
11574 msgstr ""
11575
11576 #. type: textblock
11577 #: ../src/guestfs-actions.pod:2591 ../fish/guestfish-actions.pod:1756
11578 msgid "Red Hat Enterprise Linux."
11579 msgstr ""
11580
11581 #. type: =item
11582 #: ../src/guestfs-actions.pod:2593 ../fish/guestfish-actions.pod:1758
11583 msgid "\"scientificlinux\""
11584 msgstr ""
11585
11586 #. type: textblock
11587 #: ../src/guestfs-actions.pod:2595 ../fish/guestfish-actions.pod:1760
11588 msgid "Scientific Linux."
11589 msgstr ""
11590
11591 #. type: =item
11592 #: ../src/guestfs-actions.pod:2597 ../fish/guestfish-actions.pod:1762
11593 msgid "\"slackware\""
11594 msgstr ""
11595
11596 #. type: textblock
11597 #: ../src/guestfs-actions.pod:2599 ../fish/guestfish-actions.pod:1764
11598 msgid "Slackware."
11599 msgstr ""
11600
11601 # type: =item
11602 #. type: =item
11603 #: ../src/guestfs-actions.pod:2601 ../fish/guestfish-actions.pod:1766
11604 msgid "\"ubuntu\""
11605 msgstr ""
11606
11607 # type: textblock
11608 #. type: textblock
11609 #: ../src/guestfs-actions.pod:2603 ../fish/guestfish-actions.pod:1768
11610 msgid "Ubuntu."
11611 msgstr ""
11612
11613 # type: =item
11614 #. type: =item
11615 #: ../src/guestfs-actions.pod:2605 ../src/guestfs-actions.pod:2721
11616 #: ../src/guestfs-actions.pod:3013 ../fish/guestfish-actions.pod:1770
11617 #: ../fish/guestfish-actions.pod:1863 ../fish/guestfish-actions.pod:2088
11618 msgid "\"unknown\""
11619 msgstr ""
11620
11621 # type: textblock
11622 #. type: textblock
11623 #: ../src/guestfs-actions.pod:2607 ../fish/guestfish-actions.pod:1772
11624 msgid "The distro could not be determined."
11625 msgstr ""
11626
11627 # type: =item
11628 #. type: =item
11629 #: ../src/guestfs-actions.pod:2609 ../src/guestfs-actions.pod:3005
11630 #: ../fish/guestfish-actions.pod:1774 ../fish/guestfish-actions.pod:2080
11631 msgid "\"windows\""
11632 msgstr ""
11633
11634 # type: textblock
11635 #. type: textblock
11636 #: ../src/guestfs-actions.pod:2611 ../fish/guestfish-actions.pod:1776
11637 msgid ""
11638 "Windows does not have distributions.  This string is returned if the OS type "
11639 "is Windows."
11640 msgstr ""
11641
11642 # type: textblock
11643 #. type: textblock
11644 #: ../src/guestfs-actions.pod:2616 ../src/guestfs-actions.pod:2727
11645 #: ../src/guestfs-actions.pod:3019 ../fish/guestfish-actions.pod:1781
11646 #: ../fish/guestfish-actions.pod:1869 ../fish/guestfish-actions.pod:2094
11647 msgid ""
11648 "Future versions of libguestfs may return other strings here.  The caller "
11649 "should be prepared to handle any string."
11650 msgstr ""
11651
11652 #. type: =head2
11653 #: ../src/guestfs-actions.pod:2626
11654 msgid "guestfs_inspect_get_drive_mappings"
11655 msgstr ""
11656
11657 #. type: verbatim
11658 #: ../src/guestfs-actions.pod:2628
11659 #, no-wrap
11660 msgid ""
11661 " char **\n"
11662 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
11663 "                                     const char *root);\n"
11664 "\n"
11665 msgstr ""
11666
11667 #. type: textblock
11668 #: ../src/guestfs-actions.pod:2635 ../fish/guestfish-actions.pod:1793
11669 msgid ""
11670 "This call is useful for Windows which uses a primitive system of assigning "
11671 "drive letters (like \"C:\") to partitions.  This inspection API examines the "
11672 "Windows Registry to find out how disks/partitions are mapped to drive "
11673 "letters, and returns a hash table as in the example below:"
11674 msgstr ""
11675
11676 #. type: verbatim
11677 #: ../src/guestfs-actions.pod:2641 ../fish/guestfish-actions.pod:1799
11678 #, no-wrap
11679 msgid ""
11680 " C      =>     /dev/vda2\n"
11681 " E      =>     /dev/vdb1\n"
11682 " F      =>     /dev/vdc1\n"
11683 "\n"
11684 msgstr ""
11685
11686 #. type: textblock
11687 #: ../src/guestfs-actions.pod:2645 ../fish/guestfish-actions.pod:1803
11688 msgid ""
11689 "Note that keys are drive letters.  For Windows, the key is case insensitive "
11690 "and just contains the drive letter, without the customary colon separator "
11691 "character."
11692 msgstr ""
11693
11694 #. type: textblock
11695 #: ../src/guestfs-actions.pod:2649 ../fish/guestfish-actions.pod:1807
11696 msgid ""
11697 "In future we may support other operating systems that also used drive "
11698 "letters, but the keys for those might not be case insensitive and might be "
11699 "longer than 1 character.  For example in OS-9, hard drives were named C<h0>, "
11700 "C<h1> etc."
11701 msgstr ""
11702
11703 #. type: textblock
11704 #: ../src/guestfs-actions.pod:2654 ../fish/guestfish-actions.pod:1812
11705 msgid ""
11706 "For Windows guests, currently only hard drive mappings are returned.  "
11707 "Removable disks (eg. DVD-ROMs) are ignored."
11708 msgstr ""
11709
11710 #. type: textblock
11711 #: ../src/guestfs-actions.pod:2657 ../fish/guestfish-actions.pod:1815
11712 msgid ""
11713 "For guests that do not use drive mappings, or if the drive mappings could "
11714 "not be determined, this returns an empty hash table."
11715 msgstr ""
11716
11717 #. type: textblock
11718 #: ../src/guestfs-actions.pod:2660
11719 msgid ""
11720 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11721 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
11722 msgstr ""
11723
11724 # type: textblock
11725 #. type: textblock
11726 #: ../src/guestfs-actions.pod:2664 ../src/guestfs-actions.pod:2840
11727 #: ../src/guestfs-actions.pod:3600 ../src/guestfs-actions.pod:4810
11728 #: ../src/guestfs-actions.pod:6715
11729 msgid ""
11730 "This function returns a NULL-terminated array of strings, or NULL if there "
11731 "was an error.  The array of strings will always have length C<2n+1>, where "
11732 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11733 "caller must free the strings and the array after use>."
11734 msgstr ""
11735
11736 # type: =head2
11737 #. type: =head2
11738 #: ../src/guestfs-actions.pod:2670
11739 msgid "guestfs_inspect_get_filesystems"
11740 msgstr ""
11741
11742 # type: verbatim
11743 #. type: verbatim
11744 #: ../src/guestfs-actions.pod:2672
11745 #, no-wrap
11746 msgid ""
11747 " char **\n"
11748 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11749 "                                  const char *root);\n"
11750 "\n"
11751 msgstr ""
11752
11753 # type: textblock
11754 #. type: textblock
11755 #: ../src/guestfs-actions.pod:2679 ../fish/guestfish-actions.pod:1829
11756 msgid ""
11757 "This returns a list of all the filesystems that we think are associated with "
11758 "this operating system.  This includes the root filesystem, other ordinary "
11759 "filesystems, and non-mounted devices like swap partitions."
11760 msgstr ""
11761
11762 # type: textblock
11763 #. type: textblock
11764 #: ../src/guestfs-actions.pod:2684 ../fish/guestfish-actions.pod:1834
11765 msgid ""
11766 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11767 "to be shared between operating systems."
11768 msgstr ""
11769
11770 # type: textblock
11771 #. type: textblock
11772 #: ../src/guestfs-actions.pod:2687
11773 msgid ""
11774 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11775 "C<guestfs_inspect_get_mountpoints>."
11776 msgstr ""
11777
11778 #. type: =head2
11779 #: ../src/guestfs-actions.pod:2696
11780 msgid "guestfs_inspect_get_format"
11781 msgstr ""
11782
11783 #. type: verbatim
11784 #: ../src/guestfs-actions.pod:2698
11785 #, no-wrap
11786 msgid ""
11787 " char *\n"
11788 " guestfs_inspect_get_format (guestfs_h *g,\n"
11789 "                             const char *root);\n"
11790 "\n"
11791 msgstr ""
11792
11793 #. type: textblock
11794 #: ../src/guestfs-actions.pod:2705 ../fish/guestfish-actions.pod:1847
11795 msgid ""
11796 "This returns the format of the inspected operating system.  You can use it "
11797 "to detect install images, live CDs and similar."
11798 msgstr ""
11799
11800 #. type: textblock
11801 #: ../src/guestfs-actions.pod:2708 ../fish/guestfish-actions.pod:1850
11802 msgid "Currently defined formats are:"
11803 msgstr ""
11804
11805 #. type: =item
11806 #: ../src/guestfs-actions.pod:2712 ../fish/guestfish-actions.pod:1854
11807 msgid "\"installed\""
11808 msgstr ""
11809
11810 #. type: textblock
11811 #: ../src/guestfs-actions.pod:2714 ../fish/guestfish-actions.pod:1856
11812 msgid "This is an installed operating system."
11813 msgstr ""
11814
11815 #. type: =item
11816 #: ../src/guestfs-actions.pod:2716 ../fish/guestfish-actions.pod:1858
11817 msgid "\"installer\""
11818 msgstr ""
11819
11820 #. type: textblock
11821 #: ../src/guestfs-actions.pod:2718 ../fish/guestfish-actions.pod:1860
11822 msgid ""
11823 "The disk image being inspected is not an installed operating system, but a "
11824 "I<bootable> install disk, live CD, or similar."
11825 msgstr ""
11826
11827 #. type: textblock
11828 #: ../src/guestfs-actions.pod:2723 ../fish/guestfish-actions.pod:1865
11829 msgid "The format of this disk image is not known."
11830 msgstr ""
11831
11832 # type: =head2
11833 #. type: =head2
11834 #: ../src/guestfs-actions.pod:2735
11835 msgid "guestfs_inspect_get_hostname"
11836 msgstr ""
11837
11838 # type: verbatim
11839 #. type: verbatim
11840 #: ../src/guestfs-actions.pod:2737
11841 #, no-wrap
11842 msgid ""
11843 " char *\n"
11844 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
11845 "                               const char *root);\n"
11846 "\n"
11847 msgstr ""
11848
11849 # type: textblock
11850 #. type: textblock
11851 #: ../src/guestfs-actions.pod:2744 ../fish/guestfish-actions.pod:1881
11852 msgid ""
11853 "This function returns the hostname of the operating system as found by "
11854 "inspection of the guest's configuration files."
11855 msgstr ""
11856
11857 # type: textblock
11858 #. type: textblock
11859 #: ../src/guestfs-actions.pod:2747 ../fish/guestfish-actions.pod:1884
11860 msgid ""
11861 "If the hostname could not be determined, then the string C<unknown> is "
11862 "returned."
11863 msgstr ""
11864
11865 # type: textblock
11866 #. type: textblock
11867 #: ../src/guestfs-actions.pod:2755
11868 msgid "(Added in 1.7.9)"
11869 msgstr ""
11870
11871 # type: =head2
11872 #. type: =head2
11873 #: ../src/guestfs-actions.pod:2757
11874 msgid "guestfs_inspect_get_major_version"
11875 msgstr ""
11876
11877 # type: verbatim
11878 #. type: verbatim
11879 #: ../src/guestfs-actions.pod:2759
11880 #, no-wrap
11881 msgid ""
11882 " int\n"
11883 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
11884 "                                    const char *root);\n"
11885 "\n"
11886 msgstr ""
11887
11888 # type: textblock
11889 #. type: textblock
11890 #: ../src/guestfs-actions.pod:2766 ../fish/guestfish-actions.pod:1896
11891 msgid ""
11892 "This returns the major version number of the inspected operating system."
11893 msgstr ""
11894
11895 # type: textblock
11896 #. type: textblock
11897 #: ../src/guestfs-actions.pod:2769 ../fish/guestfish-actions.pod:1899
11898 msgid ""
11899 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
11900 "popular public names used by the operating system.  Notably the operating "
11901 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
11902 "1).  You can find out the real versions corresponding to releases of Windows "
11903 "by consulting Wikipedia or MSDN."
11904 msgstr ""
11905
11906 # type: textblock
11907 #. type: textblock
11908 #: ../src/guestfs-actions.pod:2776 ../src/guestfs-actions.pod:2796
11909 #: ../fish/guestfish-actions.pod:1906 ../fish/guestfish-actions.pod:1920
11910 msgid "If the version could not be determined, then C<0> is returned."
11911 msgstr ""
11912
11913 # type: =head2
11914 #. type: =head2
11915 #: ../src/guestfs-actions.pod:2784
11916 msgid "guestfs_inspect_get_minor_version"
11917 msgstr ""
11918
11919 # type: verbatim
11920 #. type: verbatim
11921 #: ../src/guestfs-actions.pod:2786
11922 #, no-wrap
11923 msgid ""
11924 " int\n"
11925 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
11926 "                                    const char *root);\n"
11927 "\n"
11928 msgstr ""
11929
11930 # type: textblock
11931 #. type: textblock
11932 #: ../src/guestfs-actions.pod:2793 ../fish/guestfish-actions.pod:1917
11933 msgid ""
11934 "This returns the minor version number of the inspected operating system."
11935 msgstr ""
11936
11937 # type: textblock
11938 #. type: textblock
11939 #: ../src/guestfs-actions.pod:2798
11940 msgid ""
11941 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11942 "C<guestfs_inspect_get_major_version>."
11943 msgstr ""
11944
11945 # type: =head2
11946 #. type: =head2
11947 #: ../src/guestfs-actions.pod:2805
11948 msgid "guestfs_inspect_get_mountpoints"
11949 msgstr ""
11950
11951 # type: verbatim
11952 #. type: verbatim
11953 #: ../src/guestfs-actions.pod:2807
11954 #, no-wrap
11955 msgid ""
11956 " char **\n"
11957 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
11958 "                                  const char *root);\n"
11959 "\n"
11960 msgstr ""
11961
11962 #. type: textblock
11963 #: ../src/guestfs-actions.pod:2814 ../fish/guestfish-actions.pod:1932
11964 msgid ""
11965 "This returns a hash of where we think the filesystems associated with this "
11966 "operating system should be mounted.  Callers should note that this is at "
11967 "best an educated guess made by reading configuration files such as C</etc/"
11968 "fstab>.  I<In particular note> that this may return filesystems which are "
11969 "non-existent or not mountable and callers should be prepared to handle or "
11970 "ignore failures if they try to mount them."
11971 msgstr ""
11972
11973 # type: textblock
11974 #. type: textblock
11975 #: ../src/guestfs-actions.pod:2823 ../fish/guestfish-actions.pod:1941
11976 msgid ""
11977 "Each element in the returned hashtable has a key which is the path of the "
11978 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
11979 "mounted there (eg. C</dev/sda1>)."
11980 msgstr ""
11981
11982 # type: textblock
11983 #. type: textblock
11984 #: ../src/guestfs-actions.pod:2828 ../fish/guestfish-actions.pod:1946
11985 msgid ""
11986 "Non-mounted devices such as swap devices are I<not> returned in this list."
11987 msgstr ""
11988
11989 #. type: textblock
11990 #: ../src/guestfs-actions.pod:2831
11991 msgid ""
11992 "For operating systems like Windows which still use drive letters, this call "
11993 "will only return an entry for the first drive \"mounted on\" C</>.  For "
11994 "information about the mapping of drive letters to partitions, see "
11995 "C<guestfs_inspect_get_drive_mappings>."
11996 msgstr ""
11997
11998 # type: textblock
11999 #. type: textblock
12000 #: ../src/guestfs-actions.pod:2837
12001 msgid ""
12002 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12003 "C<guestfs_inspect_get_filesystems>."
12004 msgstr ""
12005
12006 # type: =head2
12007 #. type: =head2
12008 #: ../src/guestfs-actions.pod:2848
12009 msgid "guestfs_inspect_get_package_format"
12010 msgstr ""
12011
12012 # type: verbatim
12013 #. type: verbatim
12014 #: ../src/guestfs-actions.pod:2850
12015 #, no-wrap
12016 msgid ""
12017 " char *\n"
12018 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
12019 "                                     const char *root);\n"
12020 "\n"
12021 msgstr ""
12022
12023 # type: textblock
12024 #. type: textblock
12025 #: ../src/guestfs-actions.pod:2857
12026 msgid ""
12027 "This function and C<guestfs_inspect_get_package_management> return the "
12028 "package format and package management tool used by the inspected operating "
12029 "system.  For example for Fedora these functions would return C<rpm> (package "
12030 "format) and C<yum> (package management)."
12031 msgstr ""
12032
12033 # type: textblock
12034 #. type: textblock
12035 #: ../src/guestfs-actions.pod:2863 ../fish/guestfish-actions.pod:1971
12036 msgid ""
12037 "This returns the string C<unknown> if we could not determine the package "
12038 "format I<or> if the operating system does not have a real packaging system "
12039 "(eg. Windows)."
12040 msgstr ""
12041
12042 # type: textblock
12043 #. type: textblock
12044 #: ../src/guestfs-actions.pod:2867 ../fish/guestfish-actions.pod:1975
12045 msgid ""
12046 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
12047 "Future versions of libguestfs may return other strings."
12048 msgstr ""
12049
12050 # type: textblock
12051 #. type: textblock
12052 #: ../src/guestfs-actions.pod:2875 ../src/guestfs-actions.pod:2906
12053 msgid "(Added in 1.7.5)"
12054 msgstr ""
12055
12056 # type: =head2
12057 #. type: =head2
12058 #: ../src/guestfs-actions.pod:2877
12059 msgid "guestfs_inspect_get_package_management"
12060 msgstr ""
12061
12062 # type: verbatim
12063 #. type: verbatim
12064 #: ../src/guestfs-actions.pod:2879
12065 #, no-wrap
12066 msgid ""
12067 " char *\n"
12068 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
12069 "                                         const char *root);\n"
12070 "\n"
12071 msgstr ""
12072
12073 # type: textblock
12074 #. type: textblock
12075 #: ../src/guestfs-actions.pod:2886
12076 msgid ""
12077 "C<guestfs_inspect_get_package_format> and this function return the package "
12078 "format and package management tool used by the inspected operating system.  "
12079 "For example for Fedora these functions would return C<rpm> (package format) "
12080 "and C<yum> (package management)."
12081 msgstr ""
12082
12083 # type: textblock
12084 #. type: textblock
12085 #: ../src/guestfs-actions.pod:2892 ../fish/guestfish-actions.pod:1993
12086 msgid ""
12087 "This returns the string C<unknown> if we could not determine the package "
12088 "management tool I<or> if the operating system does not have a real packaging "
12089 "system (eg. Windows)."
12090 msgstr ""
12091
12092 # type: textblock
12093 #. type: textblock
12094 #: ../src/guestfs-actions.pod:2896 ../fish/guestfish-actions.pod:1997
12095 msgid ""
12096 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
12097 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
12098 "libguestfs may return other strings."
12099 msgstr ""
12100
12101 # type: =head2
12102 #. type: =head2
12103 #: ../src/guestfs-actions.pod:2908
12104 msgid "guestfs_inspect_get_product_name"
12105 msgstr ""
12106
12107 # type: verbatim
12108 #. type: verbatim
12109 #: ../src/guestfs-actions.pod:2910
12110 #, no-wrap
12111 msgid ""
12112 " char *\n"
12113 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
12114 "                                   const char *root);\n"
12115 "\n"
12116 msgstr ""
12117
12118 # type: textblock
12119 #. type: textblock
12120 #: ../src/guestfs-actions.pod:2917 ../fish/guestfish-actions.pod:2011
12121 msgid ""
12122 "This returns the product name of the inspected operating system.  The "
12123 "product name is generally some freeform string which can be displayed to the "
12124 "user, but should not be parsed by programs."
12125 msgstr ""
12126
12127 # type: textblock
12128 #. type: textblock
12129 #: ../src/guestfs-actions.pod:2922 ../fish/guestfish-actions.pod:2016
12130 msgid ""
12131 "If the product name could not be determined, then the string C<unknown> is "
12132 "returned."
12133 msgstr ""
12134
12135 #. type: =head2
12136 #: ../src/guestfs-actions.pod:2932
12137 msgid "guestfs_inspect_get_product_variant"
12138 msgstr ""
12139
12140 #. type: verbatim
12141 #: ../src/guestfs-actions.pod:2934
12142 #, no-wrap
12143 msgid ""
12144 " char *\n"
12145 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
12146 "                                      const char *root);\n"
12147 "\n"
12148 msgstr ""
12149
12150 #. type: textblock
12151 #: ../src/guestfs-actions.pod:2941 ../fish/guestfish-actions.pod:2028
12152 msgid "This returns the product variant of the inspected operating system."
12153 msgstr ""
12154
12155 #. type: textblock
12156 #: ../src/guestfs-actions.pod:2944 ../fish/guestfish-actions.pod:2031
12157 msgid ""
12158 "For Windows guests, this returns the contents of the Registry key C<HKLM"
12159 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
12160 "is usually a string such as C<Client> or C<Server> (other values are "
12161 "possible).  This can be used to distinguish consumer and enterprise versions "
12162 "of Windows that have the same version number (for example, Windows 7 and "
12163 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
12164 "the latter is C<Server>)."
12165 msgstr ""
12166
12167 #. type: textblock
12168 #: ../src/guestfs-actions.pod:2953 ../fish/guestfish-actions.pod:2040
12169 msgid ""
12170 "For enterprise Linux guests, in future we intend this to return the product "
12171 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
12172 "implemented at present."
12173 msgstr ""
12174
12175 #. type: textblock
12176 #: ../src/guestfs-actions.pod:2957 ../fish/guestfish-actions.pod:2044
12177 msgid ""
12178 "If the product variant could not be determined, then the string C<unknown> "
12179 "is returned."
12180 msgstr ""
12181
12182 #. type: textblock
12183 #: ../src/guestfs-actions.pod:2960
12184 msgid ""
12185 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12186 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
12187 msgstr ""
12188
12189 # type: =head2
12190 #. type: =head2
12191 #: ../src/guestfs-actions.pod:2967
12192 msgid "guestfs_inspect_get_roots"
12193 msgstr ""
12194
12195 # type: verbatim
12196 #. type: verbatim
12197 #: ../src/guestfs-actions.pod:2969
12198 #, no-wrap
12199 msgid ""
12200 " char **\n"
12201 " guestfs_inspect_get_roots (guestfs_h *g);\n"
12202 "\n"
12203 msgstr ""
12204
12205 # type: textblock
12206 #. type: textblock
12207 #: ../src/guestfs-actions.pod:2972
12208 msgid ""
12209 "This function is a convenient way to get the list of root devices, as "
12210 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
12211 "the whole inspection process."
12212 msgstr ""
12213
12214 # type: textblock
12215 #. type: textblock
12216 #: ../src/guestfs-actions.pod:2976
12217 msgid ""
12218 "This returns an empty list if either no root devices were found or the "
12219 "caller has not called C<guestfs_inspect_os>."
12220 msgstr ""
12221
12222 # type: textblock
12223 #. type: textblock
12224 #: ../src/guestfs-actions.pod:2985
12225 msgid "(Added in 1.7.3)"
12226 msgstr ""
12227
12228 # type: =head2
12229 #. type: =head2
12230 #: ../src/guestfs-actions.pod:2987
12231 msgid "guestfs_inspect_get_type"
12232 msgstr ""
12233
12234 # type: verbatim
12235 #. type: verbatim
12236 #: ../src/guestfs-actions.pod:2989
12237 #, no-wrap
12238 msgid ""
12239 " char *\n"
12240 " guestfs_inspect_get_type (guestfs_h *g,\n"
12241 "                           const char *root);\n"
12242 "\n"
12243 msgstr ""
12244
12245 # type: textblock
12246 #. type: textblock
12247 #: ../src/guestfs-actions.pod:2996 ../fish/guestfish-actions.pod:2071
12248 msgid ""
12249 "This returns the type of the inspected operating system.  Currently defined "
12250 "types are:"
12251 msgstr ""
12252
12253 # type: =item
12254 #. type: =item
12255 #: ../src/guestfs-actions.pod:3001 ../fish/guestfish-actions.pod:2076
12256 msgid "\"linux\""
12257 msgstr ""
12258
12259 # type: textblock
12260 #. type: textblock
12261 #: ../src/guestfs-actions.pod:3003 ../fish/guestfish-actions.pod:2078
12262 msgid "Any Linux-based operating system."
12263 msgstr ""
12264
12265 # type: textblock
12266 #. type: textblock
12267 #: ../src/guestfs-actions.pod:3007 ../fish/guestfish-actions.pod:2082
12268 msgid "Any Microsoft Windows operating system."
12269 msgstr ""
12270
12271 # type: =item
12272 #. type: =item
12273 #: ../src/guestfs-actions.pod:3009 ../fish/guestfish-actions.pod:2084
12274 msgid "\"freebsd\""
12275 msgstr ""
12276
12277 # type: textblock
12278 #. type: textblock
12279 #: ../src/guestfs-actions.pod:3011 ../fish/guestfish-actions.pod:2086
12280 msgid "FreeBSD."
12281 msgstr ""
12282
12283 # type: textblock
12284 #. type: textblock
12285 #: ../src/guestfs-actions.pod:3015 ../fish/guestfish-actions.pod:2090
12286 msgid "The operating system type could not be determined."
12287 msgstr ""
12288
12289 #. type: =head2
12290 #: ../src/guestfs-actions.pod:3029
12291 msgid "guestfs_inspect_get_windows_current_control_set"
12292 msgstr ""
12293
12294 #. type: verbatim
12295 #: ../src/guestfs-actions.pod:3031
12296 #, no-wrap
12297 msgid ""
12298 " char *\n"
12299 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
12300 "                                                  const char *root);\n"
12301 "\n"
12302 msgstr ""
12303
12304 #. type: textblock
12305 #: ../src/guestfs-actions.pod:3038 ../fish/guestfish-actions.pod:2106
12306 msgid ""
12307 "This returns the Windows CurrentControlSet of the inspected guest.  The "
12308 "CurrentControlSet is a registry key name such as C<ControlSet001>."
12309 msgstr ""
12310
12311 #. type: textblock
12312 #: ../src/guestfs-actions.pod:3041 ../fish/guestfish-actions.pod:2109
12313 msgid ""
12314 "This call assumes that the guest is Windows and that the Registry could be "
12315 "examined by inspection.  If this is not the case then an error is returned."
12316 msgstr ""
12317
12318 # type: =head2
12319 #. type: =head2
12320 #: ../src/guestfs-actions.pod:3050
12321 msgid "guestfs_inspect_get_windows_systemroot"
12322 msgstr ""
12323
12324 # type: verbatim
12325 #. type: verbatim
12326 #: ../src/guestfs-actions.pod:3052
12327 #, no-wrap
12328 msgid ""
12329 " char *\n"
12330 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
12331 "                                         const char *root);\n"
12332 "\n"
12333 msgstr ""
12334
12335 # type: textblock
12336 #. type: textblock
12337 #: ../src/guestfs-actions.pod:3059 ../fish/guestfish-actions.pod:2122
12338 msgid ""
12339 "This returns the Windows systemroot of the inspected guest.  The systemroot "
12340 "is a directory path such as C</WINDOWS>."
12341 msgstr ""
12342
12343 # type: textblock
12344 #. type: textblock
12345 #: ../src/guestfs-actions.pod:3062 ../fish/guestfish-actions.pod:2125
12346 msgid ""
12347 "This call assumes that the guest is Windows and that the systemroot could be "
12348 "determined by inspection.  If this is not the case then an error is returned."
12349 msgstr ""
12350
12351 # type: textblock
12352 #. type: textblock
12353 #: ../src/guestfs-actions.pod:3071
12354 msgid "(Added in 1.5.25)"
12355 msgstr ""
12356
12357 #. type: =head2
12358 #: ../src/guestfs-actions.pod:3073
12359 msgid "guestfs_inspect_is_live"
12360 msgstr ""
12361
12362 #. type: verbatim
12363 #: ../src/guestfs-actions.pod:3075
12364 #, no-wrap
12365 msgid ""
12366 " int\n"
12367 " guestfs_inspect_is_live (guestfs_h *g,\n"
12368 "                          const char *root);\n"
12369 "\n"
12370 msgstr ""
12371
12372 #. type: textblock
12373 #: ../src/guestfs-actions.pod:3082
12374 msgid ""
12375 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12376 "disk), then this returns true if a live image was detected on the disk."
12377 msgstr ""
12378
12379 #. type: =head2
12380 #: ../src/guestfs-actions.pod:3090
12381 msgid "guestfs_inspect_is_multipart"
12382 msgstr ""
12383
12384 #. type: verbatim
12385 #: ../src/guestfs-actions.pod:3092
12386 #, no-wrap
12387 msgid ""
12388 " int\n"
12389 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
12390 "                               const char *root);\n"
12391 "\n"
12392 msgstr ""
12393
12394 #. type: textblock
12395 #: ../src/guestfs-actions.pod:3099
12396 msgid ""
12397 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12398 "disk), then this returns true if the disk is part of a set."
12399 msgstr ""
12400
12401 #. type: =head2
12402 #: ../src/guestfs-actions.pod:3107
12403 msgid "guestfs_inspect_is_netinst"
12404 msgstr ""
12405
12406 #. type: verbatim
12407 #: ../src/guestfs-actions.pod:3109
12408 #, no-wrap
12409 msgid ""
12410 " int\n"
12411 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
12412 "                             const char *root);\n"
12413 "\n"
12414 msgstr ""
12415
12416 #. type: textblock
12417 #: ../src/guestfs-actions.pod:3116
12418 msgid ""
12419 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12420 "disk), then this returns true if the disk is a network installer, ie. not a "
12421 "self-contained install CD but one which is likely to require network access "
12422 "to complete the install."
12423 msgstr ""
12424
12425 # type: =head2
12426 #. type: =head2
12427 #: ../src/guestfs-actions.pod:3126
12428 msgid "guestfs_inspect_list_applications"
12429 msgstr ""
12430
12431 # type: verbatim
12432 #. type: verbatim
12433 #: ../src/guestfs-actions.pod:3128
12434 #, no-wrap
12435 msgid ""
12436 " struct guestfs_application_list *\n"
12437 " guestfs_inspect_list_applications (guestfs_h *g,\n"
12438 "                                    const char *root);\n"
12439 "\n"
12440 msgstr ""
12441
12442 # type: textblock
12443 #. type: textblock
12444 #: ../src/guestfs-actions.pod:3135 ../fish/guestfish-actions.pod:2179
12445 msgid "Return the list of applications installed in the operating system."
12446 msgstr ""
12447
12448 # type: textblock
12449 #. type: textblock
12450 #: ../src/guestfs-actions.pod:3137
12451 msgid ""
12452 "I<Note:> This call works differently from other parts of the inspection "
12453 "API.  You have to call C<guestfs_inspect_os>, then "
12454 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
12455 "this.  Listing applications is a significantly more difficult operation "
12456 "which requires access to the full filesystem.  Also note that unlike the "
12457 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
12458 "the libguestfs handle, this call actually reads parts of the mounted "
12459 "filesystems during the call."
12460 msgstr ""
12461
12462 # type: textblock
12463 #. type: textblock
12464 #: ../src/guestfs-actions.pod:3147 ../fish/guestfish-actions.pod:2191
12465 msgid ""
12466 "This returns an empty list if the inspection code was not able to determine "
12467 "the list of applications."
12468 msgstr ""
12469
12470 # type: textblock
12471 #. type: textblock
12472 #: ../src/guestfs-actions.pod:3150 ../fish/guestfish-actions.pod:2194
12473 msgid "The application structure contains the following fields:"
12474 msgstr ""
12475
12476 # type: =item
12477 #. type: =item
12478 #: ../src/guestfs-actions.pod:3154 ../fish/guestfish-actions.pod:2198
12479 msgid "C<app_name>"
12480 msgstr ""
12481
12482 # type: textblock
12483 #. type: textblock
12484 #: ../src/guestfs-actions.pod:3156 ../fish/guestfish-actions.pod:2200
12485 msgid ""
12486 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
12487 "guests, this is the package name."
12488 msgstr ""
12489
12490 # type: =item
12491 #. type: =item
12492 #: ../src/guestfs-actions.pod:3159 ../fish/guestfish-actions.pod:2203
12493 msgid "C<app_display_name>"
12494 msgstr ""
12495
12496 # type: textblock
12497 #. type: textblock
12498 #: ../src/guestfs-actions.pod:3161 ../fish/guestfish-actions.pod:2205
12499 msgid ""
12500 "The display name of the application, sometimes localized to the install "
12501 "language of the guest operating system."
12502 msgstr ""
12503
12504 # type: textblock
12505 #. type: textblock
12506 #: ../src/guestfs-actions.pod:3164 ../fish/guestfish-actions.pod:2208
12507 msgid ""
12508 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
12509 "to display something can use C<app_name> instead."
12510 msgstr ""
12511
12512 # type: =item
12513 #. type: =item
12514 #: ../src/guestfs-actions.pod:3167 ../fish/guestfish-actions.pod:2211
12515 msgid "C<app_epoch>"
12516 msgstr ""
12517
12518 # type: textblock
12519 #. type: textblock
12520 #: ../src/guestfs-actions.pod:3169 ../fish/guestfish-actions.pod:2213
12521 msgid ""
12522 "For package managers which use epochs, this contains the epoch of the "
12523 "package (an integer).  If unavailable, this is returned as C<0>."
12524 msgstr ""
12525
12526 # type: =item
12527 #. type: =item
12528 #: ../src/guestfs-actions.pod:3172 ../fish/guestfish-actions.pod:2216
12529 msgid "C<app_version>"
12530 msgstr ""
12531
12532 # type: textblock
12533 #. type: textblock
12534 #: ../src/guestfs-actions.pod:3174 ../fish/guestfish-actions.pod:2218
12535 msgid ""
12536 "The version string of the application or package.  If unavailable this is "
12537 "returned as an empty string C<\"\">."
12538 msgstr ""
12539
12540 # type: =item
12541 #. type: =item
12542 #: ../src/guestfs-actions.pod:3177 ../fish/guestfish-actions.pod:2221
12543 msgid "C<app_release>"
12544 msgstr ""
12545
12546 # type: textblock
12547 #. type: textblock
12548 #: ../src/guestfs-actions.pod:3179 ../fish/guestfish-actions.pod:2223
12549 msgid ""
12550 "The release string of the application or package, for package managers that "
12551 "use this.  If unavailable this is returned as an empty string C<\"\">."
12552 msgstr ""
12553
12554 # type: =item
12555 #. type: =item
12556 #: ../src/guestfs-actions.pod:3183 ../fish/guestfish-actions.pod:2227
12557 msgid "C<app_install_path>"
12558 msgstr ""
12559
12560 # type: textblock
12561 #. type: textblock
12562 #: ../src/guestfs-actions.pod:3185 ../fish/guestfish-actions.pod:2229
12563 msgid ""
12564 "The installation path of the application (on operating systems such as "
12565 "Windows which use installation paths).  This path is in the format used by "
12566 "the guest operating system, it is not a libguestfs path."
12567 msgstr ""
12568
12569 # type: textblock
12570 #. type: textblock
12571 #: ../src/guestfs-actions.pod:3190 ../fish/guestfish-actions.pod:2234
12572 msgid "If unavailable this is returned as an empty string C<\"\">."
12573 msgstr ""
12574
12575 # type: =item
12576 #. type: =item
12577 #: ../src/guestfs-actions.pod:3192 ../fish/guestfish-actions.pod:2236
12578 msgid "C<app_trans_path>"
12579 msgstr ""
12580
12581 # type: textblock
12582 #. type: textblock
12583 #: ../src/guestfs-actions.pod:3194 ../fish/guestfish-actions.pod:2238
12584 msgid ""
12585 "The install path translated into a libguestfs path.  If unavailable this is "
12586 "returned as an empty string C<\"\">."
12587 msgstr ""
12588
12589 # type: =item
12590 #. type: =item
12591 #: ../src/guestfs-actions.pod:3197 ../fish/guestfish-actions.pod:2241
12592 msgid "C<app_publisher>"
12593 msgstr ""
12594
12595 # type: textblock
12596 #. type: textblock
12597 #: ../src/guestfs-actions.pod:3199 ../fish/guestfish-actions.pod:2243
12598 msgid ""
12599 "The name of the publisher of the application, for package managers that use "
12600 "this.  If unavailable this is returned as an empty string C<\"\">."
12601 msgstr ""
12602
12603 # type: =item
12604 #. type: =item
12605 #: ../src/guestfs-actions.pod:3203 ../fish/guestfish-actions.pod:2247
12606 msgid "C<app_url>"
12607 msgstr ""
12608
12609 # type: textblock
12610 #. type: textblock
12611 #: ../src/guestfs-actions.pod:3205 ../fish/guestfish-actions.pod:2249
12612 msgid ""
12613 "The URL (eg. upstream URL) of the application.  If unavailable this is "
12614 "returned as an empty string C<\"\">."
12615 msgstr ""
12616
12617 # type: =item
12618 #. type: =item
12619 #: ../src/guestfs-actions.pod:3208 ../fish/guestfish-actions.pod:2252
12620 msgid "C<app_source_package>"
12621 msgstr ""
12622
12623 # type: textblock
12624 #. type: textblock
12625 #: ../src/guestfs-actions.pod:3210 ../fish/guestfish-actions.pod:2254
12626 msgid ""
12627 "For packaging systems which support this, the name of the source package.  "
12628 "If unavailable this is returned as an empty string C<\"\">."
12629 msgstr ""
12630
12631 # type: =item
12632 #. type: =item
12633 #: ../src/guestfs-actions.pod:3213 ../fish/guestfish-actions.pod:2257
12634 msgid "C<app_summary>"
12635 msgstr ""
12636
12637 # type: textblock
12638 #. type: textblock
12639 #: ../src/guestfs-actions.pod:3215 ../fish/guestfish-actions.pod:2259
12640 msgid ""
12641 "A short (usually one line) description of the application or package.  If "
12642 "unavailable this is returned as an empty string C<\"\">."
12643 msgstr ""
12644
12645 # type: =item
12646 #. type: =item
12647 #: ../src/guestfs-actions.pod:3218 ../fish/guestfish-actions.pod:2262
12648 msgid "C<app_description>"
12649 msgstr ""
12650
12651 # type: textblock
12652 #. type: textblock
12653 #: ../src/guestfs-actions.pod:3220 ../fish/guestfish-actions.pod:2264
12654 msgid ""
12655 "A longer description of the application or package.  If unavailable this is "
12656 "returned as an empty string C<\"\">."
12657 msgstr ""
12658
12659 # type: textblock
12660 #. type: textblock
12661 #: ../src/guestfs-actions.pod:3227
12662 msgid ""
12663 "This function returns a C<struct guestfs_application_list *>, or NULL if "
12664 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
12665 "after use>."
12666 msgstr ""
12667
12668 # type: textblock
12669 #. type: textblock
12670 #: ../src/guestfs-actions.pod:3231
12671 msgid "(Added in 1.7.8)"
12672 msgstr ""
12673
12674 # type: =head2
12675 #. type: =head2
12676 #: ../src/guestfs-actions.pod:3233
12677 msgid "guestfs_inspect_os"
12678 msgstr ""
12679
12680 # type: verbatim
12681 #. type: verbatim
12682 #: ../src/guestfs-actions.pod:3235
12683 #, no-wrap
12684 msgid ""
12685 " char **\n"
12686 " guestfs_inspect_os (guestfs_h *g);\n"
12687 "\n"
12688 msgstr ""
12689
12690 # type: textblock
12691 #. type: textblock
12692 #: ../src/guestfs-actions.pod:3238 ../fish/guestfish-actions.pod:2275
12693 msgid ""
12694 "This function uses other libguestfs functions and certain heuristics to "
12695 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
12696 "for operating systems."
12697 msgstr ""
12698
12699 # type: textblock
12700 #. type: textblock
12701 #: ../src/guestfs-actions.pod:3242 ../fish/guestfish-actions.pod:2279
12702 msgid "The list returned is empty if no operating systems were found."
12703 msgstr ""
12704
12705 # type: textblock
12706 #. type: textblock
12707 #: ../src/guestfs-actions.pod:3244 ../fish/guestfish-actions.pod:2281
12708 msgid ""
12709 "If one operating system was found, then this returns a list with a single "
12710 "element, which is the name of the root filesystem of this operating system.  "
12711 "It is also possible for this function to return a list containing more than "
12712 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
12713 "element being the root filesystem of one of the operating systems."
12714 msgstr ""
12715
12716 # type: textblock
12717 #. type: textblock
12718 #: ../src/guestfs-actions.pod:3251
12719 msgid ""
12720 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
12721 "functions in order to query further information about each operating system, "
12722 "such as the name and version."
12723 msgstr ""
12724
12725 # type: textblock
12726 #. type: textblock
12727 #: ../src/guestfs-actions.pod:3256
12728 msgid ""
12729 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
12730 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
12731 "the contents.  This should be called with no disks currently mounted.  The "
12732 "function may also use Augeas, so any existing Augeas handle will be closed."
12733 msgstr ""
12734
12735 # type: textblock
12736 #. type: textblock
12737 #: ../src/guestfs-actions.pod:3262 ../fish/guestfish-actions.pod:2299
12738 msgid ""
12739 "This function cannot decrypt encrypted disks.  The caller must do that first "
12740 "(supplying the necessary keys) if the disk is encrypted."
12741 msgstr ""
12742
12743 # type: textblock
12744 #. type: textblock
12745 #: ../src/guestfs-actions.pod:3268 ../src/guestfs-actions.pod:3558
12746 #: ../src/guestfs-actions.pod:3620
12747 msgid "See also C<guestfs_list_filesystems>."
12748 msgstr ""
12749
12750 # type: =head2
12751 #. type: =head2
12752 #: ../src/guestfs-actions.pod:3276
12753 msgid "guestfs_is_blockdev"
12754 msgstr ""
12755
12756 # type: verbatim
12757 #. type: verbatim
12758 #: ../src/guestfs-actions.pod:3278
12759 #, no-wrap
12760 msgid ""
12761 " int\n"
12762 " guestfs_is_blockdev (guestfs_h *g,\n"
12763 "                      const char *path);\n"
12764 "\n"
12765 msgstr ""
12766
12767 # type: textblock
12768 #. type: textblock
12769 #: ../src/guestfs-actions.pod:3282 ../fish/guestfish-actions.pod:2311
12770 msgid ""
12771 "This returns C<true> if and only if there is a block device with the given "
12772 "C<path> name."
12773 msgstr ""
12774
12775 # type: textblock
12776 #. type: textblock
12777 #: ../src/guestfs-actions.pod:3285 ../src/guestfs-actions.pod:3314
12778 #: ../src/guestfs-actions.pod:3344 ../src/guestfs-actions.pod:3359
12779 #: ../src/guestfs-actions.pod:3375 ../src/guestfs-actions.pod:3431
12780 #: ../src/guestfs-actions.pod:3446
12781 msgid "See also C<guestfs_stat>."
12782 msgstr ""
12783
12784 # type: textblock
12785 #. type: textblock
12786 #: ../src/guestfs-actions.pod:3289 ../src/guestfs-actions.pod:3318
12787 #: ../src/guestfs-actions.pod:3363 ../src/guestfs-actions.pod:3435
12788 #: ../src/guestfs-actions.pod:3450
12789 msgid "(Added in 1.5.10)"
12790 msgstr ""
12791
12792 # type: =head2
12793 #. type: =head2
12794 #: ../src/guestfs-actions.pod:3291
12795 msgid "guestfs_is_busy"
12796 msgstr ""
12797
12798 # type: verbatim
12799 #. type: verbatim
12800 #: ../src/guestfs-actions.pod:3293
12801 #, no-wrap
12802 msgid ""
12803 " int\n"
12804 " guestfs_is_busy (guestfs_h *g);\n"
12805 "\n"
12806 msgstr ""
12807
12808 # type: textblock
12809 #. type: textblock
12810 #: ../src/guestfs-actions.pod:3296 ../fish/guestfish-actions.pod:2320
12811 msgid ""
12812 "This returns true iff this handle is busy processing a command (in the "
12813 "C<BUSY> state)."
12814 msgstr ""
12815
12816 # type: =head2
12817 #. type: =head2
12818 #: ../src/guestfs-actions.pod:3305
12819 msgid "guestfs_is_chardev"
12820 msgstr ""
12821
12822 # type: verbatim
12823 #. type: verbatim
12824 #: ../src/guestfs-actions.pod:3307
12825 #, no-wrap
12826 msgid ""
12827 " int\n"
12828 " guestfs_is_chardev (guestfs_h *g,\n"
12829 "                     const char *path);\n"
12830 "\n"
12831 msgstr ""
12832
12833 # type: textblock
12834 #. type: textblock
12835 #: ../src/guestfs-actions.pod:3311 ../fish/guestfish-actions.pod:2329
12836 msgid ""
12837 "This returns C<true> if and only if there is a character device with the "
12838 "given C<path> name."
12839 msgstr ""
12840
12841 # type: =head2
12842 #. type: =head2
12843 #: ../src/guestfs-actions.pod:3320
12844 msgid "guestfs_is_config"
12845 msgstr ""
12846
12847 # type: verbatim
12848 #. type: verbatim
12849 #: ../src/guestfs-actions.pod:3322
12850 #, no-wrap
12851 msgid ""
12852 " int\n"
12853 " guestfs_is_config (guestfs_h *g);\n"
12854 "\n"
12855 msgstr ""
12856
12857 # type: textblock
12858 #. type: textblock
12859 #: ../src/guestfs-actions.pod:3325 ../fish/guestfish-actions.pod:2338
12860 msgid ""
12861 "This returns true iff this handle is being configured (in the C<CONFIG> "
12862 "state)."
12863 msgstr ""
12864
12865 # type: =head2
12866 #. type: =head2
12867 #: ../src/guestfs-actions.pod:3334
12868 msgid "guestfs_is_dir"
12869 msgstr ""
12870
12871 # type: verbatim
12872 #. type: verbatim
12873 #: ../src/guestfs-actions.pod:3336
12874 #, no-wrap
12875 msgid ""
12876 " int\n"
12877 " guestfs_is_dir (guestfs_h *g,\n"
12878 "                 const char *path);\n"
12879 "\n"
12880 msgstr ""
12881
12882 # type: textblock
12883 #. type: textblock
12884 #: ../src/guestfs-actions.pod:3340 ../fish/guestfish-actions.pod:2347
12885 msgid ""
12886 "This returns C<true> if and only if there is a directory with the given "
12887 "C<path> name.  Note that it returns false for other objects like files."
12888 msgstr ""
12889
12890 # type: =head2
12891 #. type: =head2
12892 #: ../src/guestfs-actions.pod:3350
12893 msgid "guestfs_is_fifo"
12894 msgstr ""
12895
12896 # type: verbatim
12897 #. type: verbatim
12898 #: ../src/guestfs-actions.pod:3352
12899 #, no-wrap
12900 msgid ""
12901 " int\n"
12902 " guestfs_is_fifo (guestfs_h *g,\n"
12903 "                  const char *path);\n"
12904 "\n"
12905 msgstr ""
12906
12907 # type: textblock
12908 #. type: textblock
12909 #: ../src/guestfs-actions.pod:3356 ../fish/guestfish-actions.pod:2357
12910 msgid ""
12911 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
12912 "given C<path> name."
12913 msgstr ""
12914
12915 # type: =head2
12916 #. type: =head2
12917 #: ../src/guestfs-actions.pod:3365
12918 msgid "guestfs_is_file"
12919 msgstr ""
12920
12921 # type: verbatim
12922 #. type: verbatim
12923 #: ../src/guestfs-actions.pod:3367
12924 #, no-wrap
12925 msgid ""
12926 " int\n"
12927 " guestfs_is_file (guestfs_h *g,\n"
12928 "                  const char *path);\n"
12929 "\n"
12930 msgstr ""
12931
12932 # type: textblock
12933 #. type: textblock
12934 #: ../src/guestfs-actions.pod:3371 ../fish/guestfish-actions.pod:2366
12935 msgid ""
12936 "This returns C<true> if and only if there is a regular file with the given "
12937 "C<path> name.  Note that it returns false for other objects like directories."
12938 msgstr ""
12939
12940 # type: =head2
12941 #. type: =head2
12942 #: ../src/guestfs-actions.pod:3381
12943 msgid "guestfs_is_launching"
12944 msgstr ""
12945
12946 # type: verbatim
12947 #. type: verbatim
12948 #: ../src/guestfs-actions.pod:3383
12949 #, no-wrap
12950 msgid ""
12951 " int\n"
12952 " guestfs_is_launching (guestfs_h *g);\n"
12953 "\n"
12954 msgstr ""
12955
12956 # type: textblock
12957 #. type: textblock
12958 #: ../src/guestfs-actions.pod:3386 ../fish/guestfish-actions.pod:2376
12959 msgid ""
12960 "This returns true iff this handle is launching the subprocess (in the "
12961 "C<LAUNCHING> state)."
12962 msgstr ""
12963
12964 # type: =head2
12965 #. type: =head2
12966 #: ../src/guestfs-actions.pod:3395
12967 msgid "guestfs_is_lv"
12968 msgstr ""
12969
12970 # type: verbatim
12971 #. type: verbatim
12972 #: ../src/guestfs-actions.pod:3397
12973 #, no-wrap
12974 msgid ""
12975 " int\n"
12976 " guestfs_is_lv (guestfs_h *g,\n"
12977 "                const char *device);\n"
12978 "\n"
12979 msgstr ""
12980
12981 # type: textblock
12982 #. type: textblock
12983 #: ../src/guestfs-actions.pod:3401 ../fish/guestfish-actions.pod:2385
12984 msgid ""
12985 "This command tests whether C<device> is a logical volume, and returns true "
12986 "iff this is the case."
12987 msgstr ""
12988
12989 # type: =head2
12990 #. type: =head2
12991 #: ../src/guestfs-actions.pod:3408
12992 msgid "guestfs_is_ready"
12993 msgstr ""
12994
12995 # type: verbatim
12996 #. type: verbatim
12997 #: ../src/guestfs-actions.pod:3410
12998 #, no-wrap
12999 msgid ""
13000 " int\n"
13001 " guestfs_is_ready (guestfs_h *g);\n"
13002 "\n"
13003 msgstr ""
13004
13005 # type: textblock
13006 #. type: textblock
13007 #: ../src/guestfs-actions.pod:3413 ../fish/guestfish-actions.pod:2392
13008 msgid ""
13009 "This returns true iff this handle is ready to accept commands (in the "
13010 "C<READY> state)."
13011 msgstr ""
13012
13013 # type: =head2
13014 #. type: =head2
13015 #: ../src/guestfs-actions.pod:3422
13016 msgid "guestfs_is_socket"
13017 msgstr ""
13018
13019 # type: verbatim
13020 #. type: verbatim
13021 #: ../src/guestfs-actions.pod:3424
13022 #, no-wrap
13023 msgid ""
13024 " int\n"
13025 " guestfs_is_socket (guestfs_h *g,\n"
13026 "                    const char *path);\n"
13027 "\n"
13028 msgstr ""
13029
13030 # type: textblock
13031 #. type: textblock
13032 #: ../src/guestfs-actions.pod:3428 ../fish/guestfish-actions.pod:2401
13033 msgid ""
13034 "This returns C<true> if and only if there is a Unix domain socket with the "
13035 "given C<path> name."
13036 msgstr ""
13037
13038 # type: =head2
13039 #. type: =head2
13040 #: ../src/guestfs-actions.pod:3437
13041 msgid "guestfs_is_symlink"
13042 msgstr ""
13043
13044 # type: verbatim
13045 #. type: verbatim
13046 #: ../src/guestfs-actions.pod:3439
13047 #, no-wrap
13048 msgid ""
13049 " int\n"
13050 " guestfs_is_symlink (guestfs_h *g,\n"
13051 "                     const char *path);\n"
13052 "\n"
13053 msgstr ""
13054
13055 # type: textblock
13056 #. type: textblock
13057 #: ../src/guestfs-actions.pod:3443 ../fish/guestfish-actions.pod:2410
13058 msgid ""
13059 "This returns C<true> if and only if there is a symbolic link with the given "
13060 "C<path> name."
13061 msgstr ""
13062
13063 # type: =head2
13064 #. type: =head2
13065 #: ../src/guestfs-actions.pod:3452
13066 msgid "guestfs_kill_subprocess"
13067 msgstr ""
13068
13069 # type: verbatim
13070 #. type: verbatim
13071 #: ../src/guestfs-actions.pod:3454
13072 #, no-wrap
13073 msgid ""
13074 " int\n"
13075 " guestfs_kill_subprocess (guestfs_h *g);\n"
13076 "\n"
13077 msgstr ""
13078
13079 # type: textblock
13080 #. type: textblock
13081 #: ../src/guestfs-actions.pod:3457 ../fish/guestfish-actions.pod:2419
13082 msgid "This kills the qemu subprocess.  You should never need to call this."
13083 msgstr ""
13084
13085 # type: =head2
13086 #. type: =head2
13087 #: ../src/guestfs-actions.pod:3463
13088 msgid "guestfs_launch"
13089 msgstr ""
13090
13091 # type: verbatim
13092 #. type: verbatim
13093 #: ../src/guestfs-actions.pod:3465
13094 #, no-wrap
13095 msgid ""
13096 " int\n"
13097 " guestfs_launch (guestfs_h *g);\n"
13098 "\n"
13099 msgstr ""
13100
13101 # type: textblock
13102 #. type: textblock
13103 #: ../src/guestfs-actions.pod:3468 ../fish/guestfish-actions.pod:2427
13104 msgid ""
13105 "Internally libguestfs is implemented by running a virtual machine using "
13106 "L<qemu(1)>."
13107 msgstr ""
13108
13109 # type: textblock
13110 #. type: textblock
13111 #: ../src/guestfs-actions.pod:3471 ../fish/guestfish-actions.pod:2430
13112 msgid ""
13113 "You should call this after configuring the handle (eg. adding drives) but "
13114 "before performing any actions."
13115 msgstr ""
13116
13117 # type: =head2
13118 #. type: =head2
13119 #: ../src/guestfs-actions.pod:3483
13120 msgid "guestfs_lchown"
13121 msgstr ""
13122
13123 # type: verbatim
13124 #. type: verbatim
13125 #: ../src/guestfs-actions.pod:3485
13126 #, no-wrap
13127 msgid ""
13128 " int\n"
13129 " guestfs_lchown (guestfs_h *g,\n"
13130 "                 int owner,\n"
13131 "                 int group,\n"
13132 "                 const char *path);\n"
13133 "\n"
13134 msgstr ""
13135
13136 # type: textblock
13137 #. type: textblock
13138 #: ../src/guestfs-actions.pod:3491
13139 msgid ""
13140 "Change the file owner to C<owner> and group to C<group>.  This is like "
13141 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
13142 "changed, not the target."
13143 msgstr ""
13144
13145 # type: =head2
13146 #. type: =head2
13147 #: ../src/guestfs-actions.pod:3503
13148 msgid "guestfs_lgetxattr"
13149 msgstr ""
13150
13151 # type: verbatim
13152 #. type: verbatim
13153 #: ../src/guestfs-actions.pod:3505
13154 #, no-wrap
13155 msgid ""
13156 " char *\n"
13157 " guestfs_lgetxattr (guestfs_h *g,\n"
13158 "                    const char *path,\n"
13159 "                    const char *name,\n"
13160 "                    size_t *size_r);\n"
13161 "\n"
13162 msgstr ""
13163
13164 # type: textblock
13165 #. type: textblock
13166 #: ../src/guestfs-actions.pod:3511 ../fish/guestfish-actions.pod:2449
13167 msgid ""
13168 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
13169 "is a symlink, then this call returns an extended attribute from the symlink."
13170 msgstr ""
13171
13172 # type: textblock
13173 #. type: textblock
13174 #: ../src/guestfs-actions.pod:3525
13175 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
13176 msgstr ""
13177
13178 # type: =head2
13179 #. type: =head2
13180 #: ../src/guestfs-actions.pod:3533
13181 msgid "guestfs_lgetxattrs"
13182 msgstr ""
13183
13184 # type: verbatim
13185 #. type: verbatim
13186 #: ../src/guestfs-actions.pod:3535
13187 #, no-wrap
13188 msgid ""
13189 " struct guestfs_xattr_list *\n"
13190 " guestfs_lgetxattrs (guestfs_h *g,\n"
13191 "                     const char *path);\n"
13192 "\n"
13193 msgstr ""
13194
13195 # type: textblock
13196 #. type: textblock
13197 #: ../src/guestfs-actions.pod:3539
13198 msgid ""
13199 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
13200 "then it returns the extended attributes of the link itself."
13201 msgstr ""
13202
13203 # type: =head2
13204 #. type: =head2
13205 #: ../src/guestfs-actions.pod:3549
13206 msgid "guestfs_list_devices"
13207 msgstr ""
13208
13209 # type: verbatim
13210 #. type: verbatim
13211 #: ../src/guestfs-actions.pod:3551
13212 #, no-wrap
13213 msgid ""
13214 " char **\n"
13215 " guestfs_list_devices (guestfs_h *g);\n"
13216 "\n"
13217 msgstr ""
13218
13219 # type: textblock
13220 #. type: textblock
13221 #: ../src/guestfs-actions.pod:3554 ../fish/guestfish-actions.pod:2477
13222 msgid "List all the block devices."
13223 msgstr ""
13224
13225 # type: textblock
13226 #. type: textblock
13227 #: ../src/guestfs-actions.pod:3556 ../fish/guestfish-actions.pod:2479
13228 msgid "The full block device names are returned, eg. C</dev/sda>."
13229 msgstr ""
13230
13231 # type: =head2
13232 #. type: =head2
13233 #: ../src/guestfs-actions.pod:3566
13234 msgid "guestfs_list_filesystems"
13235 msgstr ""
13236
13237 # type: verbatim
13238 #. type: verbatim
13239 #: ../src/guestfs-actions.pod:3568
13240 #, no-wrap
13241 msgid ""
13242 " char **\n"
13243 " guestfs_list_filesystems (guestfs_h *g);\n"
13244 "\n"
13245 msgstr ""
13246
13247 # type: textblock
13248 #. type: textblock
13249 #: ../src/guestfs-actions.pod:3571 ../fish/guestfish-actions.pod:2487
13250 msgid ""
13251 "This inspection command looks for filesystems on partitions, block devices "
13252 "and logical volumes, returning a list of devices containing filesystems and "
13253 "their type."
13254 msgstr ""
13255
13256 # type: textblock
13257 #. type: textblock
13258 #: ../src/guestfs-actions.pod:3575 ../fish/guestfish-actions.pod:2491
13259 msgid ""
13260 "The return value is a hash, where the keys are the devices containing "
13261 "filesystems, and the values are the filesystem types.  For example:"
13262 msgstr ""
13263
13264 # type: verbatim
13265 #. type: verbatim
13266 #: ../src/guestfs-actions.pod:3579 ../fish/guestfish-actions.pod:2495
13267 #, no-wrap
13268 msgid ""
13269 " \"/dev/sda1\" => \"ntfs\"\n"
13270 " \"/dev/sda2\" => \"ext2\"\n"
13271 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
13272 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
13273 "\n"
13274 msgstr ""
13275
13276 # type: textblock
13277 #. type: textblock
13278 #: ../src/guestfs-actions.pod:3584 ../fish/guestfish-actions.pod:2500
13279 msgid ""
13280 "The value can have the special value \"unknown\", meaning the content of the "
13281 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
13282 msgstr ""
13283
13284 # type: textblock
13285 #. type: textblock
13286 #: ../src/guestfs-actions.pod:3588
13287 msgid ""
13288 "This command runs other libguestfs commands, which might include "
13289 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
13290 "soon after launch and only when nothing is mounted."
13291 msgstr ""
13292
13293 # type: textblock
13294 #. type: textblock
13295 #: ../src/guestfs-actions.pod:3592
13296 msgid ""
13297 "Not all of the filesystems returned will be mountable.  In particular, swap "
13298 "partitions are returned in the list.  Also this command does not check that "
13299 "each filesystem found is valid and mountable, and some filesystems might be "
13300 "mountable but require special options.  Filesystems may not all belong to a "
13301 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
13302 msgstr ""
13303
13304 # type: textblock
13305 #. type: textblock
13306 #: ../src/guestfs-actions.pod:3606 ../src/guestfs-actions.pod:5211
13307 msgid "(Added in 1.5.15)"
13308 msgstr ""
13309
13310 # type: =head2
13311 #. type: =head2
13312 #: ../src/guestfs-actions.pod:3608
13313 msgid "guestfs_list_partitions"
13314 msgstr ""
13315
13316 # type: verbatim
13317 #. type: verbatim
13318 #: ../src/guestfs-actions.pod:3610
13319 #, no-wrap
13320 msgid ""
13321 " char **\n"
13322 " guestfs_list_partitions (guestfs_h *g);\n"
13323 "\n"
13324 msgstr ""
13325
13326 # type: textblock
13327 #. type: textblock
13328 #: ../src/guestfs-actions.pod:3613 ../fish/guestfish-actions.pod:2520
13329 msgid "List all the partitions detected on all block devices."
13330 msgstr ""
13331
13332 # type: textblock
13333 #. type: textblock
13334 #: ../src/guestfs-actions.pod:3615 ../fish/guestfish-actions.pod:2522
13335 msgid "The full partition device names are returned, eg. C</dev/sda1>"
13336 msgstr ""
13337
13338 # type: textblock
13339 #. type: textblock
13340 #: ../src/guestfs-actions.pod:3617
13341 msgid ""
13342 "This does not return logical volumes.  For that you will need to call "
13343 "C<guestfs_lvs>."
13344 msgstr ""
13345
13346 # type: =head2
13347 #. type: =head2
13348 #: ../src/guestfs-actions.pod:3628
13349 msgid "guestfs_ll"
13350 msgstr ""
13351
13352 # type: verbatim
13353 #. type: verbatim
13354 #: ../src/guestfs-actions.pod:3630
13355 #, no-wrap
13356 msgid ""
13357 " char *\n"
13358 " guestfs_ll (guestfs_h *g,\n"
13359 "             const char *directory);\n"
13360 "\n"
13361 msgstr ""
13362
13363 # type: textblock
13364 #. type: textblock
13365 #: ../src/guestfs-actions.pod:3634 ../fish/guestfish-actions.pod:2533
13366 msgid ""
13367 "List the files in C<directory> (relative to the root directory, there is no "
13368 "cwd) in the format of 'ls -la'."
13369 msgstr ""
13370
13371 # type: textblock
13372 #. type: textblock
13373 #: ../src/guestfs-actions.pod:3637 ../fish/guestfish-actions.pod:2536
13374 msgid ""
13375 "This command is mostly useful for interactive sessions.  It is I<not> "
13376 "intended that you try to parse the output string."
13377 msgstr ""
13378
13379 # type: =head2
13380 #. type: =head2
13381 #: ../src/guestfs-actions.pod:3645
13382 msgid "guestfs_ln"
13383 msgstr ""
13384
13385 # type: verbatim
13386 #. type: verbatim
13387 #: ../src/guestfs-actions.pod:3647
13388 #, no-wrap
13389 msgid ""
13390 " int\n"
13391 " guestfs_ln (guestfs_h *g,\n"
13392 "             const char *target,\n"
13393 "             const char *linkname);\n"
13394 "\n"
13395 msgstr ""
13396
13397 # type: textblock
13398 #. type: textblock
13399 #: ../src/guestfs-actions.pod:3652 ../fish/guestfish-actions.pod:2543
13400 msgid "This command creates a hard link using the C<ln> command."
13401 msgstr ""
13402
13403 # type: =head2
13404 #. type: =head2
13405 #: ../src/guestfs-actions.pod:3658
13406 msgid "guestfs_ln_f"
13407 msgstr ""
13408
13409 # type: verbatim
13410 #. type: verbatim
13411 #: ../src/guestfs-actions.pod:3660
13412 #, no-wrap
13413 msgid ""
13414 " int\n"
13415 " guestfs_ln_f (guestfs_h *g,\n"
13416 "               const char *target,\n"
13417 "               const char *linkname);\n"
13418 "\n"
13419 msgstr ""
13420
13421 # type: textblock
13422 #. type: textblock
13423 #: ../src/guestfs-actions.pod:3665 ../fish/guestfish-actions.pod:2549
13424 msgid ""
13425 "This command creates a hard link using the C<ln -f> command.  The C<-f> "
13426 "option removes the link (C<linkname>) if it exists already."
13427 msgstr ""
13428
13429 # type: =head2
13430 #. type: =head2
13431 #: ../src/guestfs-actions.pod:3672
13432 msgid "guestfs_ln_s"
13433 msgstr ""
13434
13435 # type: verbatim
13436 #. type: verbatim
13437 #: ../src/guestfs-actions.pod:3674
13438 #, no-wrap
13439 msgid ""
13440 " int\n"
13441 " guestfs_ln_s (guestfs_h *g,\n"
13442 "               const char *target,\n"
13443 "               const char *linkname);\n"
13444 "\n"
13445 msgstr ""
13446
13447 # type: textblock
13448 #. type: textblock
13449 #: ../src/guestfs-actions.pod:3679 ../fish/guestfish-actions.pod:2556
13450 msgid "This command creates a symbolic link using the C<ln -s> command."
13451 msgstr ""
13452
13453 # type: =head2
13454 #. type: =head2
13455 #: ../src/guestfs-actions.pod:3685
13456 msgid "guestfs_ln_sf"
13457 msgstr ""
13458
13459 # type: verbatim
13460 #. type: verbatim
13461 #: ../src/guestfs-actions.pod:3687
13462 #, no-wrap
13463 msgid ""
13464 " int\n"
13465 " guestfs_ln_sf (guestfs_h *g,\n"
13466 "                const char *target,\n"
13467 "                const char *linkname);\n"
13468 "\n"
13469 msgstr ""
13470
13471 # type: textblock
13472 #. type: textblock
13473 #: ../src/guestfs-actions.pod:3692 ../fish/guestfish-actions.pod:2562
13474 msgid ""
13475 "This command creates a symbolic link using the C<ln -sf> command, The C<-f> "
13476 "option removes the link (C<linkname>) if it exists already."
13477 msgstr ""
13478
13479 # type: =head2
13480 #. type: =head2
13481 #: ../src/guestfs-actions.pod:3699
13482 msgid "guestfs_lremovexattr"
13483 msgstr ""
13484
13485 # type: verbatim
13486 #. type: verbatim
13487 #: ../src/guestfs-actions.pod:3701
13488 #, no-wrap
13489 msgid ""
13490 " int\n"
13491 " guestfs_lremovexattr (guestfs_h *g,\n"
13492 "                       const char *xattr,\n"
13493 "                       const char *path);\n"
13494 "\n"
13495 msgstr ""
13496
13497 # type: textblock
13498 #. type: textblock
13499 #: ../src/guestfs-actions.pod:3706
13500 msgid ""
13501 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
13502 "link, then it removes an extended attribute of the link itself."
13503 msgstr ""
13504
13505 # type: =head2
13506 #. type: =head2
13507 #: ../src/guestfs-actions.pod:3714
13508 msgid "guestfs_ls"
13509 msgstr ""
13510
13511 # type: verbatim
13512 #. type: verbatim
13513 #: ../src/guestfs-actions.pod:3716
13514 #, no-wrap
13515 msgid ""
13516 " char **\n"
13517 " guestfs_ls (guestfs_h *g,\n"
13518 "             const char *directory);\n"
13519 "\n"
13520 msgstr ""
13521
13522 # type: textblock
13523 #. type: textblock
13524 #: ../src/guestfs-actions.pod:3720 ../fish/guestfish-actions.pod:2577
13525 msgid ""
13526 "List the files in C<directory> (relative to the root directory, there is no "
13527 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
13528 msgstr ""
13529
13530 # type: textblock
13531 #. type: textblock
13532 #: ../src/guestfs-actions.pod:3724
13533 msgid ""
13534 "This command is mostly useful for interactive sessions.  Programs should "
13535 "probably use C<guestfs_readdir> instead."
13536 msgstr ""
13537
13538 # type: =head2
13539 #. type: =head2
13540 #: ../src/guestfs-actions.pod:3733
13541 msgid "guestfs_lsetxattr"
13542 msgstr ""
13543
13544 # type: verbatim
13545 #. type: verbatim
13546 #: ../src/guestfs-actions.pod:3735
13547 #, no-wrap
13548 msgid ""
13549 " int\n"
13550 " guestfs_lsetxattr (guestfs_h *g,\n"
13551 "                    const char *xattr,\n"
13552 "                    const char *val,\n"
13553 "                    int vallen,\n"
13554 "                    const char *path);\n"
13555 "\n"
13556 msgstr ""
13557
13558 # type: textblock
13559 #. type: textblock
13560 #: ../src/guestfs-actions.pod:3742
13561 msgid ""
13562 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
13563 "then it sets an extended attribute of the link itself."
13564 msgstr ""
13565
13566 # type: =head2
13567 #. type: =head2
13568 #: ../src/guestfs-actions.pod:3750
13569 msgid "guestfs_lstat"
13570 msgstr ""
13571
13572 # type: verbatim
13573 #. type: verbatim
13574 #: ../src/guestfs-actions.pod:3752
13575 #, no-wrap
13576 msgid ""
13577 " struct guestfs_stat *\n"
13578 " guestfs_lstat (guestfs_h *g,\n"
13579 "                const char *path);\n"
13580 "\n"
13581 msgstr ""
13582
13583 # type: textblock
13584 #. type: textblock
13585 #: ../src/guestfs-actions.pod:3756 ../src/guestfs-actions.pod:6314
13586 #: ../fish/guestfish-actions.pod:2596 ../fish/guestfish-actions.pod:4265
13587 msgid "Returns file information for the given C<path>."
13588 msgstr ""
13589
13590 # type: textblock
13591 #. type: textblock
13592 #: ../src/guestfs-actions.pod:3758
13593 msgid ""
13594 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
13595 "link, then the link is stat-ed, not the file it refers to."
13596 msgstr ""
13597
13598 # type: textblock
13599 #. type: textblock
13600 #: ../src/guestfs-actions.pod:3762 ../fish/guestfish-actions.pod:2602
13601 msgid "This is the same as the C<lstat(2)> system call."
13602 msgstr ""
13603
13604 # type: textblock
13605 #. type: textblock
13606 #: ../src/guestfs-actions.pod:3764 ../src/guestfs-actions.pod:6318
13607 msgid ""
13608 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
13609 "error.  I<The caller must call C<guestfs_free_stat> after use>."
13610 msgstr ""
13611
13612 # type: textblock
13613 #. type: textblock
13614 #: ../src/guestfs-actions.pod:3768 ../src/guestfs-actions.pod:6322
13615 #: ../src/guestfs-actions.pod:6340 ../src/guestfs-actions.pod:6721
13616 msgid "(Added in 0.9.2)"
13617 msgstr ""
13618
13619 # type: =head2
13620 #. type: =head2
13621 #: ../src/guestfs-actions.pod:3770
13622 msgid "guestfs_lstatlist"
13623 msgstr ""
13624
13625 # type: verbatim
13626 #. type: verbatim
13627 #: ../src/guestfs-actions.pod:3772
13628 #, no-wrap
13629 msgid ""
13630 " struct guestfs_stat_list *\n"
13631 " guestfs_lstatlist (guestfs_h *g,\n"
13632 "                    const char *path,\n"
13633 "                    char *const *names);\n"
13634 "\n"
13635 msgstr ""
13636
13637 # type: textblock
13638 #. type: textblock
13639 #: ../src/guestfs-actions.pod:3777
13640 msgid ""
13641 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
13642 "files, where all files are in the directory C<path>.  C<names> is the list "
13643 "of files from this directory."
13644 msgstr ""
13645
13646 # type: textblock
13647 #. type: textblock
13648 #: ../src/guestfs-actions.pod:3781 ../fish/guestfish-actions.pod:2612
13649 msgid ""
13650 "On return you get a list of stat structs, with a one-to-one correspondence "
13651 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
13652 "then the C<ino> field of that structure is set to C<-1>."
13653 msgstr ""
13654
13655 # type: textblock
13656 #. type: textblock
13657 #: ../src/guestfs-actions.pod:3786
13658 msgid ""
13659 "This call is intended for programs that want to efficiently list a directory "
13660 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
13661 "for a similarly efficient call for getting extended attributes.  Very long "
13662 "directory listings might cause the protocol message size to be exceeded, "
13663 "causing this call to fail.  The caller must split up such requests into "
13664 "smaller groups of names."
13665 msgstr ""
13666
13667 # type: textblock
13668 #. type: textblock
13669 #: ../src/guestfs-actions.pod:3794
13670 msgid ""
13671 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
13672 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
13673 msgstr ""
13674
13675 # type: =head2
13676 #. type: =head2
13677 #: ../src/guestfs-actions.pod:3800
13678 msgid "guestfs_luks_add_key"
13679 msgstr ""
13680
13681 # type: verbatim
13682 #. type: verbatim
13683 #: ../src/guestfs-actions.pod:3802
13684 #, no-wrap
13685 msgid ""
13686 " int\n"
13687 " guestfs_luks_add_key (guestfs_h *g,\n"
13688 "                       const char *device,\n"
13689 "                       const char *key,\n"
13690 "                       const char *newkey,\n"
13691 "                       int keyslot);\n"
13692 "\n"
13693 msgstr ""
13694
13695 # type: textblock
13696 #. type: textblock
13697 #: ../src/guestfs-actions.pod:3809 ../fish/guestfish-actions.pod:2629
13698 msgid ""
13699 "This command adds a new key on LUKS device C<device>.  C<key> is any "
13700 "existing key, and is used to access the device.  C<newkey> is the new key to "
13701 "add.  C<keyslot> is the key slot that will be replaced."
13702 msgstr ""
13703
13704 # type: textblock
13705 #. type: textblock
13706 #: ../src/guestfs-actions.pod:3814
13707 msgid ""
13708 "Note that if C<keyslot> already contains a key, then this command will "
13709 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
13710 msgstr ""
13711
13712 # type: textblock
13713 #. type: textblock
13714 #: ../src/guestfs-actions.pod:3820 ../src/guestfs-actions.pod:3860
13715 #: ../src/guestfs-actions.pod:3883 ../src/guestfs-actions.pod:3903
13716 #: ../src/guestfs-actions.pod:3935 ../src/guestfs-actions.pod:3954
13717 msgid ""
13718 "This function takes a key or passphrase parameter which could contain "
13719 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
13720 "information."
13721 msgstr ""
13722
13723 # type: textblock
13724 #. type: textblock
13725 #: ../src/guestfs-actions.pod:3824 ../src/guestfs-actions.pod:3864
13726 #: ../src/guestfs-actions.pod:3887 ../src/guestfs-actions.pod:3907
13727 msgid "(Added in 1.5.2)"
13728 msgstr ""
13729
13730 # type: =head2
13731 #. type: =head2
13732 #: ../src/guestfs-actions.pod:3826
13733 msgid "guestfs_luks_close"
13734 msgstr ""
13735
13736 # type: verbatim
13737 #. type: verbatim
13738 #: ../src/guestfs-actions.pod:3828
13739 #, no-wrap
13740 msgid ""
13741 " int\n"
13742 " guestfs_luks_close (guestfs_h *g,\n"
13743 "                     const char *device);\n"
13744 "\n"
13745 msgstr ""
13746
13747 # type: textblock
13748 #. type: textblock
13749 #: ../src/guestfs-actions.pod:3832
13750 msgid ""
13751 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
13752 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
13753 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
13754 "underlying block device."
13755 msgstr ""
13756
13757 # type: textblock
13758 #. type: textblock
13759 #: ../src/guestfs-actions.pod:3840 ../src/guestfs-actions.pod:3939
13760 #: ../src/guestfs-actions.pod:3958 ../src/guestfs-actions.pod:4008
13761 #: ../src/guestfs-actions.pod:4056
13762 msgid "(Added in 1.5.1)"
13763 msgstr ""
13764
13765 # type: =head2
13766 #. type: =head2
13767 #: ../src/guestfs-actions.pod:3842
13768 msgid "guestfs_luks_format"
13769 msgstr ""
13770
13771 # type: verbatim
13772 #. type: verbatim
13773 #: ../src/guestfs-actions.pod:3844
13774 #, no-wrap
13775 msgid ""
13776 " int\n"
13777 " guestfs_luks_format (guestfs_h *g,\n"
13778 "                      const char *device,\n"
13779 "                      const char *key,\n"
13780 "                      int keyslot);\n"
13781 "\n"
13782 msgstr ""
13783
13784 # type: textblock
13785 #. type: textblock
13786 #: ../src/guestfs-actions.pod:3850 ../fish/guestfish-actions.pod:2655
13787 msgid ""
13788 "This command erases existing data on C<device> and formats the device as a "
13789 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
13790 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
13791 msgstr ""
13792
13793 # type: textblock
13794 #. type: textblock
13795 #: ../src/guestfs-actions.pod:3857 ../src/guestfs-actions.pod:3880
13796 #: ../src/guestfs-actions.pod:4020 ../src/guestfs-actions.pod:4962
13797 #: ../src/guestfs-actions.pod:5742 ../src/guestfs-actions.pod:6149
13798 #: ../src/guestfs-actions.pod:6172 ../src/guestfs-actions.pod:6198
13799 #: ../src/guestfs-actions.pod:7358 ../fish/guestfish-actions.pod:2663
13800 #: ../fish/guestfish-actions.pod:2676 ../fish/guestfish-actions.pod:2760
13801 #: ../fish/guestfish-actions.pod:3334 ../fish/guestfish-actions.pod:3854
13802 #: ../fish/guestfish-actions.pod:4164 ../fish/guestfish-actions.pod:4180
13803 #: ../fish/guestfish-actions.pod:4195 ../fish/guestfish-actions.pod:4910
13804 msgid ""
13805 "B<This command is dangerous.  Without careful use you can easily destroy all "
13806 "your data>."
13807 msgstr ""
13808
13809 # type: =head2
13810 #. type: =head2
13811 #: ../src/guestfs-actions.pod:3866
13812 msgid "guestfs_luks_format_cipher"
13813 msgstr ""
13814
13815 # type: verbatim
13816 #. type: verbatim
13817 #: ../src/guestfs-actions.pod:3868
13818 #, no-wrap
13819 msgid ""
13820 " int\n"
13821 " guestfs_luks_format_cipher (guestfs_h *g,\n"
13822 "                             const char *device,\n"
13823 "                             const char *key,\n"
13824 "                             int keyslot,\n"
13825 "                             const char *cipher);\n"
13826 "\n"
13827 msgstr ""
13828
13829 # type: textblock
13830 #. type: textblock
13831 #: ../src/guestfs-actions.pod:3875
13832 msgid ""
13833 "This command is the same as C<guestfs_luks_format> but it also allows you to "
13834 "set the C<cipher> used."
13835 msgstr ""
13836
13837 # type: =head2
13838 #. type: =head2
13839 #: ../src/guestfs-actions.pod:3889
13840 msgid "guestfs_luks_kill_slot"
13841 msgstr ""
13842
13843 # type: verbatim
13844 #. type: verbatim
13845 #: ../src/guestfs-actions.pod:3891
13846 #, no-wrap
13847 msgid ""
13848 " int\n"
13849 " guestfs_luks_kill_slot (guestfs_h *g,\n"
13850 "                         const char *device,\n"
13851 "                         const char *key,\n"
13852 "                         int keyslot);\n"
13853 "\n"
13854 msgstr ""
13855
13856 # type: textblock
13857 #. type: textblock
13858 #: ../src/guestfs-actions.pod:3897 ../fish/guestfish-actions.pod:2683
13859 msgid ""
13860 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
13861 "device C<device>.  C<key> must be one of the I<other> keys."
13862 msgstr ""
13863
13864 # type: =head2
13865 #. type: =head2
13866 #: ../src/guestfs-actions.pod:3909
13867 msgid "guestfs_luks_open"
13868 msgstr ""
13869
13870 # type: verbatim
13871 #. type: verbatim
13872 #: ../src/guestfs-actions.pod:3911
13873 #, no-wrap
13874 msgid ""
13875 " int\n"
13876 " guestfs_luks_open (guestfs_h *g,\n"
13877 "                    const char *device,\n"
13878 "                    const char *key,\n"
13879 "                    const char *mapname);\n"
13880 "\n"
13881 msgstr ""
13882
13883 # type: textblock
13884 #. type: textblock
13885 #: ../src/guestfs-actions.pod:3917 ../fish/guestfish-actions.pod:2694
13886 msgid ""
13887 "This command opens a block device which has been encrypted according to the "
13888 "Linux Unified Key Setup (LUKS) standard."
13889 msgstr ""
13890
13891 # type: textblock
13892 #. type: textblock
13893 #: ../src/guestfs-actions.pod:3920 ../fish/guestfish-actions.pod:2697
13894 msgid "C<device> is the encrypted block device or partition."
13895 msgstr ""
13896
13897 # type: textblock
13898 #. type: textblock
13899 #: ../src/guestfs-actions.pod:3922 ../fish/guestfish-actions.pod:2699
13900 msgid ""
13901 "The caller must supply one of the keys associated with the LUKS block "
13902 "device, in the C<key> parameter."
13903 msgstr ""
13904
13905 # type: textblock
13906 #. type: textblock
13907 #: ../src/guestfs-actions.pod:3925 ../fish/guestfish-actions.pod:2702
13908 msgid ""
13909 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
13910 "writes to this block device are decrypted from and encrypted to the "
13911 "underlying C<device> respectively."
13912 msgstr ""
13913
13914 # type: textblock
13915 #. type: textblock
13916 #: ../src/guestfs-actions.pod:3929
13917 msgid ""
13918 "If this block device contains LVM volume groups, then calling "
13919 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
13920 "visible."
13921 msgstr ""
13922
13923 # type: =head2
13924 #. type: =head2
13925 #: ../src/guestfs-actions.pod:3941
13926 msgid "guestfs_luks_open_ro"
13927 msgstr ""
13928
13929 # type: verbatim
13930 #. type: verbatim
13931 #: ../src/guestfs-actions.pod:3943
13932 #, no-wrap
13933 msgid ""
13934 " int\n"
13935 " guestfs_luks_open_ro (guestfs_h *g,\n"
13936 "                       const char *device,\n"
13937 "                       const char *key,\n"
13938 "                       const char *mapname);\n"
13939 "\n"
13940 msgstr ""
13941
13942 # type: textblock
13943 #. type: textblock
13944 #: ../src/guestfs-actions.pod:3949
13945 msgid ""
13946 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
13947 "created."
13948 msgstr ""
13949
13950 # type: =head2
13951 #. type: =head2
13952 #: ../src/guestfs-actions.pod:3960
13953 msgid "guestfs_lvcreate"
13954 msgstr ""
13955
13956 # type: verbatim
13957 #. type: verbatim
13958 #: ../src/guestfs-actions.pod:3962
13959 #, no-wrap
13960 msgid ""
13961 " int\n"
13962 " guestfs_lvcreate (guestfs_h *g,\n"
13963 "                   const char *logvol,\n"
13964 "                   const char *volgroup,\n"
13965 "                   int mbytes);\n"
13966 "\n"
13967 msgstr ""
13968
13969 # type: textblock
13970 #. type: textblock
13971 #: ../src/guestfs-actions.pod:3968 ../fish/guestfish-actions.pod:2727
13972 msgid ""
13973 "This creates an LVM logical volume called C<logvol> on the volume group "
13974 "C<volgroup>, with C<size> megabytes."
13975 msgstr ""
13976
13977 # type: =head2
13978 #. type: =head2
13979 #: ../src/guestfs-actions.pod:3975
13980 msgid "guestfs_lvm_canonical_lv_name"
13981 msgstr ""
13982
13983 # type: verbatim
13984 #. type: verbatim
13985 #: ../src/guestfs-actions.pod:3977
13986 #, no-wrap
13987 msgid ""
13988 " char *\n"
13989 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
13990 "                                const char *lvname);\n"
13991 "\n"
13992 msgstr ""
13993
13994 # type: textblock
13995 #. type: textblock
13996 #: ../src/guestfs-actions.pod:3981 ../fish/guestfish-actions.pod:2734
13997 msgid ""
13998 "This converts alternative naming schemes for LVs that you might find to the "
13999 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
14000 "LV>."
14001 msgstr ""
14002
14003 # type: textblock
14004 #. type: textblock
14005 #: ../src/guestfs-actions.pod:3985 ../fish/guestfish-actions.pod:2738
14006 msgid ""
14007 "This command returns an error if the C<lvname> parameter does not refer to a "
14008 "logical volume."
14009 msgstr ""
14010
14011 # type: textblock
14012 #. type: textblock
14013 #: ../src/guestfs-actions.pod:3988
14014 msgid "See also C<guestfs_is_lv>."
14015 msgstr ""
14016
14017 # type: textblock
14018 #. type: textblock
14019 #: ../src/guestfs-actions.pod:3993
14020 msgid "(Added in 1.5.24)"
14021 msgstr ""
14022
14023 # type: =head2
14024 #. type: =head2
14025 #: ../src/guestfs-actions.pod:3995
14026 msgid "guestfs_lvm_clear_filter"
14027 msgstr ""
14028
14029 # type: verbatim
14030 #. type: verbatim
14031 #: ../src/guestfs-actions.pod:3997
14032 #, no-wrap
14033 msgid ""
14034 " int\n"
14035 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
14036 "\n"
14037 msgstr ""
14038
14039 # type: textblock
14040 #. type: textblock
14041 #: ../src/guestfs-actions.pod:4000
14042 msgid ""
14043 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
14044 "see every block device."
14045 msgstr ""
14046
14047 # type: textblock
14048 #. type: textblock
14049 #: ../src/guestfs-actions.pod:4003 ../src/guestfs-actions.pod:4045
14050 #: ../fish/guestfish-actions.pod:2750 ../fish/guestfish-actions.pod:2781
14051 msgid ""
14052 "This command also clears the LVM cache and performs a volume group scan."
14053 msgstr ""
14054
14055 # type: =head2
14056 #. type: =head2
14057 #: ../src/guestfs-actions.pod:4010
14058 msgid "guestfs_lvm_remove_all"
14059 msgstr ""
14060
14061 # type: verbatim
14062 #. type: verbatim
14063 #: ../src/guestfs-actions.pod:4012
14064 #, no-wrap
14065 msgid ""
14066 " int\n"
14067 " guestfs_lvm_remove_all (guestfs_h *g);\n"
14068 "\n"
14069 msgstr ""
14070
14071 # type: textblock
14072 #. type: textblock
14073 #: ../src/guestfs-actions.pod:4015 ../fish/guestfish-actions.pod:2757
14074 msgid ""
14075 "This command removes all LVM logical volumes, volume groups and physical "
14076 "volumes."
14077 msgstr ""
14078
14079 # type: =head2
14080 #. type: =head2
14081 #: ../src/guestfs-actions.pod:4025
14082 msgid "guestfs_lvm_set_filter"
14083 msgstr ""
14084
14085 # type: verbatim
14086 #. type: verbatim
14087 #: ../src/guestfs-actions.pod:4027
14088 #, no-wrap
14089 msgid ""
14090 " int\n"
14091 " guestfs_lvm_set_filter (guestfs_h *g,\n"
14092 "                         char *const *devices);\n"
14093 "\n"
14094 msgstr ""
14095
14096 # type: textblock
14097 #. type: textblock
14098 #: ../src/guestfs-actions.pod:4031 ../fish/guestfish-actions.pod:2767
14099 msgid ""
14100 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
14101 "block devices in the list C<devices>, and will ignore all other attached "
14102 "block devices."
14103 msgstr ""
14104
14105 # type: textblock
14106 #. type: textblock
14107 #: ../src/guestfs-actions.pod:4035 ../fish/guestfish-actions.pod:2771
14108 msgid ""
14109 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
14110 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
14111 "there are two types of duplication possible: either cloned PVs/VGs which "
14112 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
14113 "same name.  In normal operation you cannot create this situation, but you "
14114 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
14115 "inside the LVM metadata."
14116 msgstr ""
14117
14118 # type: textblock
14119 #. type: textblock
14120 #: ../src/guestfs-actions.pod:4048 ../fish/guestfish-actions.pod:2784
14121 msgid "You can filter whole block devices or individual partitions."
14122 msgstr ""
14123
14124 # type: textblock
14125 #. type: textblock
14126 #: ../src/guestfs-actions.pod:4050 ../fish/guestfish-actions.pod:2786
14127 msgid ""
14128 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
14129 "filesystem), even if you are not filtering out that VG."
14130 msgstr ""
14131
14132 # type: =head2
14133 #. type: =head2
14134 #: ../src/guestfs-actions.pod:4058
14135 msgid "guestfs_lvremove"
14136 msgstr ""
14137
14138 # type: verbatim
14139 #. type: verbatim
14140 #: ../src/guestfs-actions.pod:4060
14141 #, no-wrap
14142 msgid ""
14143 " int\n"
14144 " guestfs_lvremove (guestfs_h *g,\n"
14145 "                   const char *device);\n"
14146 "\n"
14147 msgstr ""
14148
14149 # type: textblock
14150 #. type: textblock
14151 #: ../src/guestfs-actions.pod:4064 ../fish/guestfish-actions.pod:2794
14152 msgid ""
14153 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
14154 "LV, such as C</dev/VG/LV>."
14155 msgstr ""
14156
14157 # type: textblock
14158 #. type: textblock
14159 #: ../src/guestfs-actions.pod:4067 ../fish/guestfish-actions.pod:2797
14160 msgid ""
14161 "You can also remove all LVs in a volume group by specifying the VG name, C</"
14162 "dev/VG>."
14163 msgstr ""
14164
14165 # type: textblock
14166 #. type: textblock
14167 #: ../src/guestfs-actions.pod:4072 ../src/guestfs-actions.pod:5308
14168 #: ../src/guestfs-actions.pod:7097
14169 msgid "(Added in 1.0.13)"
14170 msgstr ""
14171
14172 # type: =head2
14173 #. type: =head2
14174 #: ../src/guestfs-actions.pod:4074
14175 msgid "guestfs_lvrename"
14176 msgstr ""
14177
14178 # type: verbatim
14179 #. type: verbatim
14180 #: ../src/guestfs-actions.pod:4076
14181 #, no-wrap
14182 msgid ""
14183 " int\n"
14184 " guestfs_lvrename (guestfs_h *g,\n"
14185 "                   const char *logvol,\n"
14186 "                   const char *newlogvol);\n"
14187 "\n"
14188 msgstr ""
14189
14190 # type: textblock
14191 #. type: textblock
14192 #: ../src/guestfs-actions.pod:4081 ../fish/guestfish-actions.pod:2804
14193 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
14194 msgstr ""
14195
14196 # type: textblock
14197 #. type: textblock
14198 #: ../src/guestfs-actions.pod:4085 ../src/guestfs-actions.pod:7110
14199 msgid "(Added in 1.0.83)"
14200 msgstr ""
14201
14202 # type: =head2
14203 #. type: =head2
14204 #: ../src/guestfs-actions.pod:4087
14205 msgid "guestfs_lvresize"
14206 msgstr ""
14207
14208 # type: verbatim
14209 #. type: verbatim
14210 #: ../src/guestfs-actions.pod:4089
14211 #, no-wrap
14212 msgid ""
14213 " int\n"
14214 " guestfs_lvresize (guestfs_h *g,\n"
14215 "                   const char *device,\n"
14216 "                   int mbytes);\n"
14217 "\n"
14218 msgstr ""
14219
14220 # type: textblock
14221 #. type: textblock
14222 #: ../src/guestfs-actions.pod:4094 ../fish/guestfish-actions.pod:2810
14223 msgid ""
14224 "This resizes (expands or shrinks) an existing LVM logical volume to "
14225 "C<mbytes>.  When reducing, data in the reduced part is lost."
14226 msgstr ""
14227
14228 # type: =head2
14229 #. type: =head2
14230 #: ../src/guestfs-actions.pod:4102
14231 msgid "guestfs_lvresize_free"
14232 msgstr ""
14233
14234 # type: verbatim
14235 #. type: verbatim
14236 #: ../src/guestfs-actions.pod:4104
14237 #, no-wrap
14238 msgid ""
14239 " int\n"
14240 " guestfs_lvresize_free (guestfs_h *g,\n"
14241 "                        const char *lv,\n"
14242 "                        int percent);\n"
14243 "\n"
14244 msgstr ""
14245
14246 # type: textblock
14247 #. type: textblock
14248 #: ../src/guestfs-actions.pod:4109 ../fish/guestfish-actions.pod:2818
14249 msgid ""
14250 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
14251 "remaining free space in the volume group.  Commonly you would call this with "
14252 "pc = 100 which expands the logical volume as much as possible, using all "
14253 "remaining free space in the volume group."
14254 msgstr ""
14255
14256 # type: textblock
14257 #. type: textblock
14258 #: ../src/guestfs-actions.pod:4117
14259 msgid "(Added in 1.3.3)"
14260 msgstr ""
14261
14262 # type: =head2
14263 #. type: =head2
14264 #: ../src/guestfs-actions.pod:4119
14265 msgid "guestfs_lvs"
14266 msgstr ""
14267
14268 # type: verbatim
14269 #. type: verbatim
14270 #: ../src/guestfs-actions.pod:4121
14271 #, no-wrap
14272 msgid ""
14273 " char **\n"
14274 " guestfs_lvs (guestfs_h *g);\n"
14275 "\n"
14276 msgstr ""
14277
14278 # type: textblock
14279 #. type: textblock
14280 #: ../src/guestfs-actions.pod:4124 ../fish/guestfish-actions.pod:2828
14281 msgid ""
14282 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14283 "(8)> command."
14284 msgstr ""
14285
14286 # type: textblock
14287 #. type: textblock
14288 #: ../src/guestfs-actions.pod:4127 ../fish/guestfish-actions.pod:2831
14289 msgid ""
14290 "This returns a list of the logical volume device names (eg. C</dev/"
14291 "VolGroup00/LogVol00>)."
14292 msgstr ""
14293
14294 # type: textblock
14295 #. type: textblock
14296 #: ../src/guestfs-actions.pod:4130
14297 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
14298 msgstr ""
14299
14300 # type: =head2
14301 #. type: =head2
14302 #: ../src/guestfs-actions.pod:4138
14303 msgid "guestfs_lvs_full"
14304 msgstr ""
14305
14306 # type: verbatim
14307 #. type: verbatim
14308 #: ../src/guestfs-actions.pod:4140
14309 #, no-wrap
14310 msgid ""
14311 " struct guestfs_lvm_lv_list *\n"
14312 " guestfs_lvs_full (guestfs_h *g);\n"
14313 "\n"
14314 msgstr ""
14315
14316 # type: textblock
14317 #. type: textblock
14318 #: ../src/guestfs-actions.pod:4143 ../fish/guestfish-actions.pod:2840
14319 msgid ""
14320 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14321 "(8)> command.  The \"full\" version includes all fields."
14322 msgstr ""
14323
14324 # type: textblock
14325 #. type: textblock
14326 #: ../src/guestfs-actions.pod:4146
14327 msgid ""
14328 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
14329 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
14330 msgstr ""
14331
14332 # type: =head2
14333 #. type: =head2
14334 #: ../src/guestfs-actions.pod:4152
14335 msgid "guestfs_lvuuid"
14336 msgstr ""
14337
14338 # type: verbatim
14339 #. type: verbatim
14340 #: ../src/guestfs-actions.pod:4154
14341 #, no-wrap
14342 msgid ""
14343 " char *\n"
14344 " guestfs_lvuuid (guestfs_h *g,\n"
14345 "                 const char *device);\n"
14346 "\n"
14347 msgstr ""
14348
14349 # type: textblock
14350 #. type: textblock
14351 #: ../src/guestfs-actions.pod:4158 ../fish/guestfish-actions.pod:2847
14352 msgid "This command returns the UUID of the LVM LV C<device>."
14353 msgstr ""
14354
14355 # type: =head2
14356 #. type: =head2
14357 #: ../src/guestfs-actions.pod:4165
14358 msgid "guestfs_lxattrlist"
14359 msgstr ""
14360
14361 # type: verbatim
14362 #. type: verbatim
14363 #: ../src/guestfs-actions.pod:4167
14364 #, no-wrap
14365 msgid ""
14366 " struct guestfs_xattr_list *\n"
14367 " guestfs_lxattrlist (guestfs_h *g,\n"
14368 "                     const char *path,\n"
14369 "                     char *const *names);\n"
14370 "\n"
14371 msgstr ""
14372
14373 # type: textblock
14374 #. type: textblock
14375 #: ../src/guestfs-actions.pod:4172 ../fish/guestfish-actions.pod:2853
14376 msgid ""
14377 "This call allows you to get the extended attributes of multiple files, where "
14378 "all files are in the directory C<path>.  C<names> is the list of files from "
14379 "this directory."
14380 msgstr ""
14381
14382 # type: textblock
14383 #. type: textblock
14384 #: ../src/guestfs-actions.pod:4176 ../fish/guestfish-actions.pod:2857
14385 msgid ""
14386 "On return you get a flat list of xattr structs which must be interpreted "
14387 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
14388 "C<attrval> in this struct is zero-length to indicate there was an error "
14389 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
14390 "number (the number of following attributes for this file, which could be C<"
14391 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
14392 "for the first named file.  This repeats for the second and subsequent files."
14393 msgstr ""
14394
14395 # type: textblock
14396 #. type: textblock
14397 #: ../src/guestfs-actions.pod:4186
14398 msgid ""
14399 "This call is intended for programs that want to efficiently list a directory "
14400 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
14401 "a similarly efficient call for getting standard stats.  Very long directory "
14402 "listings might cause the protocol message size to be exceeded, causing this "
14403 "call to fail.  The caller must split up such requests into smaller groups of "
14404 "names."
14405 msgstr ""
14406
14407 # type: =head2
14408 #. type: =head2
14409 #: ../src/guestfs-actions.pod:4200
14410 msgid "guestfs_mkdir"
14411 msgstr ""
14412
14413 # type: verbatim
14414 #. type: verbatim
14415 #: ../src/guestfs-actions.pod:4202
14416 #, no-wrap
14417 msgid ""
14418 " int\n"
14419 " guestfs_mkdir (guestfs_h *g,\n"
14420 "                const char *path);\n"
14421 "\n"
14422 msgstr ""
14423
14424 # type: textblock
14425 #. type: textblock
14426 #: ../src/guestfs-actions.pod:4206 ../fish/guestfish-actions.pod:2879
14427 msgid "Create a directory named C<path>."
14428 msgstr ""
14429
14430 # type: =head2
14431 #. type: =head2
14432 #: ../src/guestfs-actions.pod:4212
14433 msgid "guestfs_mkdir_mode"
14434 msgstr ""
14435
14436 # type: verbatim
14437 #. type: verbatim
14438 #: ../src/guestfs-actions.pod:4214
14439 #, no-wrap
14440 msgid ""
14441 " int\n"
14442 " guestfs_mkdir_mode (guestfs_h *g,\n"
14443 "                     const char *path,\n"
14444 "                     int mode);\n"
14445 "\n"
14446 msgstr ""
14447
14448 # type: textblock
14449 #. type: textblock
14450 #: ../src/guestfs-actions.pod:4219 ../fish/guestfish-actions.pod:2885
14451 msgid ""
14452 "This command creates a directory, setting the initial permissions of the "
14453 "directory to C<mode>."
14454 msgstr ""
14455
14456 # type: textblock
14457 #. type: textblock
14458 #: ../src/guestfs-actions.pod:4222 ../fish/guestfish-actions.pod:2888
14459 msgid ""
14460 "For common Linux filesystems, the actual mode which is set will be C<mode & "
14461 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
14462 "other ways."
14463 msgstr ""
14464
14465 # type: textblock
14466 #. type: textblock
14467 #: ../src/guestfs-actions.pod:4226
14468 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
14469 msgstr ""
14470
14471 # type: =head2
14472 #. type: =head2
14473 #: ../src/guestfs-actions.pod:4232
14474 msgid "guestfs_mkdir_p"
14475 msgstr ""
14476
14477 # type: verbatim
14478 #. type: verbatim
14479 #: ../src/guestfs-actions.pod:4234
14480 #, no-wrap
14481 msgid ""
14482 " int\n"
14483 " guestfs_mkdir_p (guestfs_h *g,\n"
14484 "                  const char *path);\n"
14485 "\n"
14486 msgstr ""
14487
14488 # type: textblock
14489 #. type: textblock
14490 #: ../src/guestfs-actions.pod:4238 ../fish/guestfish-actions.pod:2898
14491 msgid ""
14492 "Create a directory named C<path>, creating any parent directories as "
14493 "necessary.  This is like the C<mkdir -p> shell command."
14494 msgstr ""
14495
14496 # type: =head2
14497 #. type: =head2
14498 #: ../src/guestfs-actions.pod:4245
14499 msgid "guestfs_mkdtemp"
14500 msgstr ""
14501
14502 # type: verbatim
14503 #. type: verbatim
14504 #: ../src/guestfs-actions.pod:4247
14505 #, no-wrap
14506 msgid ""
14507 " char *\n"
14508 " guestfs_mkdtemp (guestfs_h *g,\n"
14509 "                  const char *template);\n"
14510 "\n"
14511 msgstr ""
14512
14513 # type: textblock
14514 #. type: textblock
14515 #: ../src/guestfs-actions.pod:4251 ../fish/guestfish-actions.pod:2905
14516 msgid ""
14517 "This command creates a temporary directory.  The C<template> parameter "
14518 "should be a full pathname for the temporary directory name with the final "
14519 "six characters being \"XXXXXX\"."
14520 msgstr ""
14521
14522 # type: textblock
14523 #. type: textblock
14524 #: ../src/guestfs-actions.pod:4256 ../fish/guestfish-actions.pod:2910
14525 msgid ""
14526 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
14527 "being suitable for Windows filesystems."
14528 msgstr ""
14529
14530 # type: textblock
14531 #. type: textblock
14532 #: ../src/guestfs-actions.pod:4259 ../fish/guestfish-actions.pod:2913
14533 msgid "The name of the temporary directory that was created is returned."
14534 msgstr ""
14535
14536 # type: textblock
14537 #. type: textblock
14538 #: ../src/guestfs-actions.pod:4262 ../fish/guestfish-actions.pod:2916
14539 msgid "The temporary directory is created with mode 0700 and is owned by root."
14540 msgstr ""
14541
14542 # type: textblock
14543 #. type: textblock
14544 #: ../src/guestfs-actions.pod:4265 ../fish/guestfish-actions.pod:2919
14545 msgid ""
14546 "The caller is responsible for deleting the temporary directory and its "
14547 "contents after use."
14548 msgstr ""
14549
14550 # type: textblock
14551 #. type: textblock
14552 #: ../src/guestfs-actions.pod:4268 ../fish/guestfish-actions.pod:2922
14553 msgid "See also: L<mkdtemp(3)>"
14554 msgstr ""
14555
14556 # type: =head2
14557 #. type: =head2
14558 #: ../src/guestfs-actions.pod:4275
14559 msgid "guestfs_mke2fs_J"
14560 msgstr ""
14561
14562 # type: verbatim
14563 #. type: verbatim
14564 #: ../src/guestfs-actions.pod:4277
14565 #, no-wrap
14566 msgid ""
14567 " int\n"
14568 " guestfs_mke2fs_J (guestfs_h *g,\n"
14569 "                   const char *fstype,\n"
14570 "                   int blocksize,\n"
14571 "                   const char *device,\n"
14572 "                   const char *journal);\n"
14573 "\n"
14574 msgstr ""
14575
14576 # type: textblock
14577 #. type: textblock
14578 #: ../src/guestfs-actions.pod:4284 ../fish/guestfish-actions.pod:2928
14579 msgid ""
14580 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14581 "C<journal>.  It is equivalent to the command:"
14582 msgstr ""
14583
14584 # type: verbatim
14585 #. type: verbatim
14586 #: ../src/guestfs-actions.pod:4288 ../fish/guestfish-actions.pod:2932
14587 #, no-wrap
14588 msgid ""
14589 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
14590 "\n"
14591 msgstr ""
14592
14593 # type: textblock
14594 #. type: textblock
14595 #: ../src/guestfs-actions.pod:4290
14596 msgid "See also C<guestfs_mke2journal>."
14597 msgstr ""
14598
14599 # type: textblock
14600 #. type: textblock
14601 #: ../src/guestfs-actions.pod:4294 ../src/guestfs-actions.pod:4312
14602 #: ../src/guestfs-actions.pod:4330 ../src/guestfs-actions.pod:4346
14603 #: ../src/guestfs-actions.pod:4360 ../src/guestfs-actions.pod:4374
14604 #: ../src/guestfs-actions.pod:4433 ../src/guestfs-actions.pod:4698
14605 msgid "(Added in 1.0.68)"
14606 msgstr ""
14607
14608 # type: =head2
14609 #. type: =head2
14610 #: ../src/guestfs-actions.pod:4296
14611 msgid "guestfs_mke2fs_JL"
14612 msgstr ""
14613
14614 # type: verbatim
14615 #. type: verbatim
14616 #: ../src/guestfs-actions.pod:4298
14617 #, no-wrap
14618 msgid ""
14619 " int\n"
14620 " guestfs_mke2fs_JL (guestfs_h *g,\n"
14621 "                    const char *fstype,\n"
14622 "                    int blocksize,\n"
14623 "                    const char *device,\n"
14624 "                    const char *label);\n"
14625 "\n"
14626 msgstr ""
14627
14628 # type: textblock
14629 #. type: textblock
14630 #: ../src/guestfs-actions.pod:4305 ../fish/guestfish-actions.pod:2940
14631 msgid ""
14632 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14633 "the journal labeled C<label>."
14634 msgstr ""
14635
14636 # type: textblock
14637 #. type: textblock
14638 #: ../src/guestfs-actions.pod:4308
14639 msgid "See also C<guestfs_mke2journal_L>."
14640 msgstr ""
14641
14642 # type: =head2
14643 #. type: =head2
14644 #: ../src/guestfs-actions.pod:4314
14645 msgid "guestfs_mke2fs_JU"
14646 msgstr ""
14647
14648 # type: verbatim
14649 #. type: verbatim
14650 #: ../src/guestfs-actions.pod:4316
14651 #, no-wrap
14652 msgid ""
14653 " int\n"
14654 " guestfs_mke2fs_JU (guestfs_h *g,\n"
14655 "                    const char *fstype,\n"
14656 "                    int blocksize,\n"
14657 "                    const char *device,\n"
14658 "                    const char *uuid);\n"
14659 "\n"
14660 msgstr ""
14661
14662 # type: textblock
14663 #. type: textblock
14664 #: ../src/guestfs-actions.pod:4323 ../fish/guestfish-actions.pod:2949
14665 msgid ""
14666 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14667 "the journal with UUID C<uuid>."
14668 msgstr ""
14669
14670 # type: textblock
14671 #. type: textblock
14672 #: ../src/guestfs-actions.pod:4326
14673 msgid "See also C<guestfs_mke2journal_U>."
14674 msgstr ""
14675
14676 # type: =head2
14677 #. type: =head2
14678 #: ../src/guestfs-actions.pod:4332
14679 msgid "guestfs_mke2journal"
14680 msgstr ""
14681
14682 # type: verbatim
14683 #. type: verbatim
14684 #: ../src/guestfs-actions.pod:4334
14685 #, no-wrap
14686 msgid ""
14687 " int\n"
14688 " guestfs_mke2journal (guestfs_h *g,\n"
14689 "                      int blocksize,\n"
14690 "                      const char *device);\n"
14691 "\n"
14692 msgstr ""
14693
14694 # type: textblock
14695 #. type: textblock
14696 #: ../src/guestfs-actions.pod:4339 ../fish/guestfish-actions.pod:2958
14697 msgid ""
14698 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
14699 "command:"
14700 msgstr ""
14701
14702 # type: verbatim
14703 #. type: verbatim
14704 #: ../src/guestfs-actions.pod:4342 ../fish/guestfish-actions.pod:2961
14705 #, no-wrap
14706 msgid ""
14707 " mke2fs -O journal_dev -b blocksize device\n"
14708 "\n"
14709 msgstr ""
14710
14711 # type: =head2
14712 #. type: =head2
14713 #: ../src/guestfs-actions.pod:4348
14714 msgid "guestfs_mke2journal_L"
14715 msgstr ""
14716
14717 # type: verbatim
14718 #. type: verbatim
14719 #: ../src/guestfs-actions.pod:4350
14720 #, no-wrap
14721 msgid ""
14722 " int\n"
14723 " guestfs_mke2journal_L (guestfs_h *g,\n"
14724 "                        int blocksize,\n"
14725 "                        const char *label,\n"
14726 "                        const char *device);\n"
14727 "\n"
14728 msgstr ""
14729
14730 # type: textblock
14731 #. type: textblock
14732 #: ../src/guestfs-actions.pod:4356 ../fish/guestfish-actions.pod:2967
14733 msgid "This creates an ext2 external journal on C<device> with label C<label>."
14734 msgstr ""
14735
14736 # type: =head2
14737 #. type: =head2
14738 #: ../src/guestfs-actions.pod:4362
14739 msgid "guestfs_mke2journal_U"
14740 msgstr ""
14741
14742 # type: verbatim
14743 #. type: verbatim
14744 #: ../src/guestfs-actions.pod:4364
14745 #, no-wrap
14746 msgid ""
14747 " int\n"
14748 " guestfs_mke2journal_U (guestfs_h *g,\n"
14749 "                        int blocksize,\n"
14750 "                        const char *uuid,\n"
14751 "                        const char *device);\n"
14752 "\n"
14753 msgstr ""
14754
14755 # type: textblock
14756 #. type: textblock
14757 #: ../src/guestfs-actions.pod:4370 ../fish/guestfish-actions.pod:2973
14758 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
14759 msgstr ""
14760
14761 # type: =head2
14762 #. type: =head2
14763 #: ../src/guestfs-actions.pod:4376
14764 msgid "guestfs_mkfifo"
14765 msgstr ""
14766
14767 # type: verbatim
14768 #. type: verbatim
14769 #: ../src/guestfs-actions.pod:4378
14770 #, no-wrap
14771 msgid ""
14772 " int\n"
14773 " guestfs_mkfifo (guestfs_h *g,\n"
14774 "                 int mode,\n"
14775 "                 const char *path);\n"
14776 "\n"
14777 msgstr ""
14778
14779 # type: textblock
14780 #. type: textblock
14781 #: ../src/guestfs-actions.pod:4383
14782 msgid ""
14783 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
14784 "is just a convenient wrapper around C<guestfs_mknod>."
14785 msgstr ""
14786
14787 # type: =head2
14788 #. type: =head2
14789 #: ../src/guestfs-actions.pod:4393
14790 msgid "guestfs_mkfs"
14791 msgstr ""
14792
14793 # type: verbatim
14794 #. type: verbatim
14795 #: ../src/guestfs-actions.pod:4395
14796 #, no-wrap
14797 msgid ""
14798 " int\n"
14799 " guestfs_mkfs (guestfs_h *g,\n"
14800 "               const char *fstype,\n"
14801 "               const char *device);\n"
14802 "\n"
14803 msgstr ""
14804
14805 # type: textblock
14806 #. type: textblock
14807 #: ../src/guestfs-actions.pod:4400 ../fish/guestfish-actions.pod:2989
14808 msgid ""
14809 "This creates a filesystem on C<device> (usually a partition or LVM logical "
14810 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
14811 msgstr ""
14812
14813 # type: =head2
14814 #. type: =head2
14815 #: ../src/guestfs-actions.pod:4408
14816 msgid "guestfs_mkfs_b"
14817 msgstr ""
14818
14819 # type: verbatim
14820 #. type: verbatim
14821 #: ../src/guestfs-actions.pod:4410
14822 #, no-wrap
14823 msgid ""
14824 " int\n"
14825 " guestfs_mkfs_b (guestfs_h *g,\n"
14826 "                 const char *fstype,\n"
14827 "                 int blocksize,\n"
14828 "                 const char *device);\n"
14829 "\n"
14830 msgstr ""
14831
14832 # type: textblock
14833 #. type: textblock
14834 #: ../src/guestfs-actions.pod:4416
14835 msgid ""
14836 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
14837 "block size of the resulting filesystem.  Supported block sizes depend on the "
14838 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
14839 msgstr ""
14840
14841 # type: textblock
14842 #. type: textblock
14843 #: ../src/guestfs-actions.pod:4421 ../src/guestfs-actions.pod:4464
14844 #: ../fish/guestfish-actions.pod:3002 ../fish/guestfish-actions.pod:3029
14845 msgid ""
14846 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
14847 "cluster size."
14848 msgstr ""
14849
14850 # type: textblock
14851 #. type: textblock
14852 #: ../src/guestfs-actions.pod:4426 ../fish/guestfish-actions.pod:3005
14853 msgid ""
14854 "This function is deprecated.  In new code, use the C<mkfs_opts> call instead."
14855 msgstr ""
14856
14857 # type: =head2
14858 #. type: =head2
14859 #: ../src/guestfs-actions.pod:4435
14860 msgid "guestfs_mkfs_opts"
14861 msgstr ""
14862
14863 # type: verbatim
14864 #. type: verbatim
14865 #: ../src/guestfs-actions.pod:4437
14866 #, no-wrap
14867 msgid ""
14868 " int\n"
14869 " guestfs_mkfs_opts (guestfs_h *g,\n"
14870 "                    const char *fstype,\n"
14871 "                    const char *device,\n"
14872 "                    ...);\n"
14873 "\n"
14874 msgstr ""
14875
14876 #. type: verbatim
14877 #: ../src/guestfs-actions.pod:4448
14878 #, no-wrap
14879 msgid ""
14880 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
14881 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
14882 "\n"
14883 msgstr ""
14884
14885 # type: textblock
14886 #. type: textblock
14887 #: ../src/guestfs-actions.pod:4451 ../fish/guestfish-actions.pod:3016
14888 msgid ""
14889 "This function creates a filesystem on C<device>.  The filesystem type is "
14890 "C<fstype>, for example C<ext3>."
14891 msgstr ""
14892
14893 # type: =item
14894 #. type: =item
14895 #: ../src/guestfs-actions.pod:4458 ../fish/guestfish-actions.pod:3023
14896 msgid "C<blocksize>"
14897 msgstr ""
14898
14899 # type: textblock
14900 #. type: textblock
14901 #: ../src/guestfs-actions.pod:4460 ../fish/guestfish-actions.pod:3025
14902 msgid ""
14903 "The filesystem block size.  Supported block sizes depend on the filesystem "
14904 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
14905 "filesystems."
14906 msgstr ""
14907
14908 #. type: textblock
14909 #: ../src/guestfs-actions.pod:4467 ../fish/guestfish-actions.pod:3032
14910 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
14911 msgstr ""
14912
14913 #. type: =item
14914 #: ../src/guestfs-actions.pod:4469 ../fish/guestfish-actions.pod:3034
14915 msgid "C<features>"
14916 msgstr ""
14917
14918 #. type: textblock
14919 #: ../src/guestfs-actions.pod:4471 ../fish/guestfish-actions.pod:3036
14920 msgid "This passes the C<-O> parameter to the external mkfs program."
14921 msgstr ""
14922
14923 #. type: textblock
14924 #: ../src/guestfs-actions.pod:4473 ../fish/guestfish-actions.pod:3038
14925 msgid ""
14926 "For certain filesystem types, this allows extra filesystem features to be "
14927 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
14928 msgstr ""
14929
14930 #. type: textblock
14931 #: ../src/guestfs-actions.pod:4477 ../fish/guestfish-actions.pod:3042
14932 msgid ""
14933 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
14934 "type."
14935 msgstr ""
14936
14937 #. type: textblock
14938 #: ../src/guestfs-actions.pod:4484
14939 msgid "(Added in 1.7.19)"
14940 msgstr ""
14941
14942 # type: =head2
14943 #. type: =head2
14944 #: ../src/guestfs-actions.pod:4486
14945 msgid "guestfs_mkfs_opts_va"
14946 msgstr ""
14947
14948 # type: verbatim
14949 #. type: verbatim
14950 #: ../src/guestfs-actions.pod:4488
14951 #, no-wrap
14952 msgid ""
14953 " int\n"
14954 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
14955 "                       const char *fstype,\n"
14956 "                       const char *device,\n"
14957 "                       va_list args);\n"
14958 "\n"
14959 msgstr ""
14960
14961 # type: textblock
14962 #. type: textblock
14963 #: ../src/guestfs-actions.pod:4494
14964 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
14965 msgstr ""
14966
14967 # type: =head2
14968 #. type: =head2
14969 #: ../src/guestfs-actions.pod:4498
14970 msgid "guestfs_mkfs_opts_argv"
14971 msgstr ""
14972
14973 # type: verbatim
14974 #. type: verbatim
14975 #: ../src/guestfs-actions.pod:4500
14976 #, no-wrap
14977 msgid ""
14978 " int\n"
14979 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
14980 "                         const char *fstype,\n"
14981 "                         const char *device,\n"
14982 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
14983 "\n"
14984 msgstr ""
14985
14986 # type: textblock
14987 #. type: textblock
14988 #: ../src/guestfs-actions.pod:4506
14989 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
14990 msgstr ""
14991
14992 # type: =head2
14993 #. type: =head2
14994 #: ../src/guestfs-actions.pod:4510
14995 msgid "guestfs_mkmountpoint"
14996 msgstr ""
14997
14998 # type: verbatim
14999 #. type: verbatim
15000 #: ../src/guestfs-actions.pod:4512
15001 #, no-wrap
15002 msgid ""
15003 " int\n"
15004 " guestfs_mkmountpoint (guestfs_h *g,\n"
15005 "                       const char *exemptpath);\n"
15006 "\n"
15007 msgstr ""
15008
15009 # type: textblock
15010 #. type: textblock
15011 #: ../src/guestfs-actions.pod:4516
15012 msgid ""
15013 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
15014 "that can be used to create extra mountpoints before mounting the first "
15015 "filesystem."
15016 msgstr ""
15017
15018 # type: textblock
15019 #. type: textblock
15020 #: ../src/guestfs-actions.pod:4520 ../fish/guestfish-actions.pod:3057
15021 msgid ""
15022 "These calls are I<only> necessary in some very limited circumstances, mainly "
15023 "the case where you want to mount a mix of unrelated and/or read-only "
15024 "filesystems together."
15025 msgstr ""
15026
15027 # type: textblock
15028 #. type: textblock
15029 #: ../src/guestfs-actions.pod:4524 ../fish/guestfish-actions.pod:3061
15030 msgid ""
15031 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
15032 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
15033 "inside that.  You can unpack this as follows in guestfish:"
15034 msgstr ""
15035
15036 # type: verbatim
15037 #. type: verbatim
15038 #: ../src/guestfs-actions.pod:4529 ../fish/guestfish-actions.pod:3066
15039 #, no-wrap
15040 msgid ""
15041 " add-ro Fedora-11-i686-Live.iso\n"
15042 " run\n"
15043 " mkmountpoint /cd\n"
15044 " mkmountpoint /sqsh\n"
15045 " mkmountpoint /ext3fs\n"
15046 " mount /dev/sda /cd\n"
15047 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
15048 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
15049 "\n"
15050 msgstr ""
15051
15052 # type: textblock
15053 #. type: textblock
15054 #: ../src/guestfs-actions.pod:4538 ../fish/guestfish-actions.pod:3075
15055 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
15056 msgstr ""
15057
15058 # type: textblock
15059 #. type: textblock
15060 #: ../src/guestfs-actions.pod:4540
15061 msgid ""
15062 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
15063 "may get unexpected errors if you try to mix these calls.  It is safest to "
15064 "manually unmount filesystems and remove mountpoints after use."
15065 msgstr ""
15066
15067 # type: textblock
15068 #. type: textblock
15069 #: ../src/guestfs-actions.pod:4544
15070 msgid ""
15071 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
15072 "first, so for this to work for manual mountpoints, you must ensure that the "
15073 "innermost mountpoints have the longest pathnames, as in the example code "
15074 "above."
15075 msgstr ""
15076
15077 # type: textblock
15078 #. type: textblock
15079 #: ../src/guestfs-actions.pod:4549 ../fish/guestfish-actions.pod:3086
15080 msgid ""
15081 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
15082 msgstr ""
15083
15084 #. type: textblock
15085 #: ../src/guestfs-actions.pod:4551
15086 msgid ""
15087 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
15088 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
15089 "can also trigger these issues."
15090 msgstr ""
15091
15092 # type: textblock
15093 #. type: textblock
15094 #: ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:4816
15095 #: ../src/guestfs-actions.pod:5726
15096 msgid "(Added in 1.0.62)"
15097 msgstr ""
15098
15099 # type: =head2
15100 #. type: =head2
15101 #: ../src/guestfs-actions.pod:4559
15102 msgid "guestfs_mknod"
15103 msgstr ""
15104
15105 # type: verbatim
15106 #. type: verbatim
15107 #: ../src/guestfs-actions.pod:4561
15108 #, no-wrap
15109 msgid ""
15110 " int\n"
15111 " guestfs_mknod (guestfs_h *g,\n"
15112 "                int mode,\n"
15113 "                int devmajor,\n"
15114 "                int devminor,\n"
15115 "                const char *path);\n"
15116 "\n"
15117 msgstr ""
15118
15119 # type: textblock
15120 #. type: textblock
15121 #: ../src/guestfs-actions.pod:4568 ../fish/guestfish-actions.pod:3096
15122 msgid ""
15123 "This call creates block or character special devices, or named pipes (FIFOs)."
15124 msgstr ""
15125
15126 # type: textblock
15127 #. type: textblock
15128 #: ../src/guestfs-actions.pod:4571 ../fish/guestfish-actions.pod:3099
15129 msgid ""
15130 "The C<mode> parameter should be the mode, using the standard constants.  "
15131 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
15132 "used when creating block and character special devices."
15133 msgstr ""
15134
15135 # type: textblock
15136 #. type: textblock
15137 #: ../src/guestfs-actions.pod:4576
15138 msgid ""
15139 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
15140 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
15141 "regular file).  These constants are available in the standard Linux header "
15142 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
15143 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
15144 "the appropriate constant for you."
15145 msgstr ""
15146
15147 # type: =head2
15148 #. type: =head2
15149 #: ../src/guestfs-actions.pod:4590
15150 msgid "guestfs_mknod_b"
15151 msgstr ""
15152
15153 # type: verbatim
15154 #. type: verbatim
15155 #: ../src/guestfs-actions.pod:4592
15156 #, no-wrap
15157 msgid ""
15158 " int\n"
15159 " guestfs_mknod_b (guestfs_h *g,\n"
15160 "                  int mode,\n"
15161 "                  int devmajor,\n"
15162 "                  int devminor,\n"
15163 "                  const char *path);\n"
15164 "\n"
15165 msgstr ""
15166
15167 # type: textblock
15168 #. type: textblock
15169 #: ../src/guestfs-actions.pod:4599
15170 msgid ""
15171 "This call creates a block device node called C<path> with mode C<mode> and "
15172 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15173 "wrapper around C<guestfs_mknod>."
15174 msgstr ""
15175
15176 # type: =head2
15177 #. type: =head2
15178 #: ../src/guestfs-actions.pod:4609
15179 msgid "guestfs_mknod_c"
15180 msgstr ""
15181
15182 # type: verbatim
15183 #. type: verbatim
15184 #: ../src/guestfs-actions.pod:4611
15185 #, no-wrap
15186 msgid ""
15187 " int\n"
15188 " guestfs_mknod_c (guestfs_h *g,\n"
15189 "                  int mode,\n"
15190 "                  int devmajor,\n"
15191 "                  int devminor,\n"
15192 "                  const char *path);\n"
15193 "\n"
15194 msgstr ""
15195
15196 # type: textblock
15197 #. type: textblock
15198 #: ../src/guestfs-actions.pod:4618
15199 msgid ""
15200 "This call creates a char device node called C<path> with mode C<mode> and "
15201 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15202 "wrapper around C<guestfs_mknod>."
15203 msgstr ""
15204
15205 # type: =head2
15206 #. type: =head2
15207 #: ../src/guestfs-actions.pod:4628
15208 msgid "guestfs_mkswap"
15209 msgstr ""
15210
15211 # type: verbatim
15212 #. type: verbatim
15213 #: ../src/guestfs-actions.pod:4630
15214 #, no-wrap
15215 msgid ""
15216 " int\n"
15217 " guestfs_mkswap (guestfs_h *g,\n"
15218 "                 const char *device);\n"
15219 "\n"
15220 msgstr ""
15221
15222 # type: textblock
15223 #. type: textblock
15224 #: ../src/guestfs-actions.pod:4634 ../fish/guestfish-actions.pod:3138
15225 msgid "Create a swap partition on C<device>."
15226 msgstr ""
15227
15228 # type: =head2
15229 #. type: =head2
15230 #: ../src/guestfs-actions.pod:4640
15231 msgid "guestfs_mkswap_L"
15232 msgstr ""
15233
15234 # type: verbatim
15235 #. type: verbatim
15236 #: ../src/guestfs-actions.pod:4642
15237 #, no-wrap
15238 msgid ""
15239 " int\n"
15240 " guestfs_mkswap_L (guestfs_h *g,\n"
15241 "                   const char *label,\n"
15242 "                   const char *device);\n"
15243 "\n"
15244 msgstr ""
15245
15246 # type: textblock
15247 #. type: textblock
15248 #: ../src/guestfs-actions.pod:4647 ../fish/guestfish-actions.pod:3144
15249 msgid "Create a swap partition on C<device> with label C<label>."
15250 msgstr ""
15251
15252 # type: textblock
15253 #. type: textblock
15254 #: ../src/guestfs-actions.pod:4649 ../fish/guestfish-actions.pod:3146
15255 msgid ""
15256 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
15257 "sda>), just to a partition.  This appears to be a limitation of the kernel "
15258 "or swap tools."
15259 msgstr ""
15260
15261 # type: =head2
15262 #. type: =head2
15263 #: ../src/guestfs-actions.pod:4657
15264 msgid "guestfs_mkswap_U"
15265 msgstr ""
15266
15267 # type: verbatim
15268 #. type: verbatim
15269 #: ../src/guestfs-actions.pod:4659
15270 #, no-wrap
15271 msgid ""
15272 " int\n"
15273 " guestfs_mkswap_U (guestfs_h *g,\n"
15274 "                   const char *uuid,\n"
15275 "                   const char *device);\n"
15276 "\n"
15277 msgstr ""
15278
15279 # type: textblock
15280 #. type: textblock
15281 #: ../src/guestfs-actions.pod:4664 ../fish/guestfish-actions.pod:3154
15282 msgid "Create a swap partition on C<device> with UUID C<uuid>."
15283 msgstr ""
15284
15285 # type: =head2
15286 #. type: =head2
15287 #: ../src/guestfs-actions.pod:4670
15288 msgid "guestfs_mkswap_file"
15289 msgstr ""
15290
15291 # type: verbatim
15292 #. type: verbatim
15293 #: ../src/guestfs-actions.pod:4672
15294 #, no-wrap
15295 msgid ""
15296 " int\n"
15297 " guestfs_mkswap_file (guestfs_h *g,\n"
15298 "                      const char *path);\n"
15299 "\n"
15300 msgstr ""
15301
15302 # type: textblock
15303 #. type: textblock
15304 #: ../src/guestfs-actions.pod:4676 ../fish/guestfish-actions.pod:3160
15305 msgid "Create a swap file."
15306 msgstr ""
15307
15308 # type: textblock
15309 #. type: textblock
15310 #: ../src/guestfs-actions.pod:4678
15311 msgid ""
15312 "This command just writes a swap file signature to an existing file.  To "
15313 "create the file itself, use something like C<guestfs_fallocate>."
15314 msgstr ""
15315
15316 # type: =head2
15317 #. type: =head2
15318 #: ../src/guestfs-actions.pod:4685
15319 msgid "guestfs_modprobe"
15320 msgstr ""
15321
15322 # type: verbatim
15323 #. type: verbatim
15324 #: ../src/guestfs-actions.pod:4687
15325 #, no-wrap
15326 msgid ""
15327 " int\n"
15328 " guestfs_modprobe (guestfs_h *g,\n"
15329 "                   const char *modulename);\n"
15330 "\n"
15331 msgstr ""
15332
15333 # type: textblock
15334 #. type: textblock
15335 #: ../src/guestfs-actions.pod:4691 ../fish/guestfish-actions.pod:3169
15336 msgid "This loads a kernel module in the appliance."
15337 msgstr ""
15338
15339 # type: textblock
15340 #. type: textblock
15341 #: ../src/guestfs-actions.pod:4693 ../fish/guestfish-actions.pod:3171
15342 msgid ""
15343 "The kernel module must have been whitelisted when libguestfs was built (see "
15344 "C<appliance/kmod.whitelist.in> in the source)."
15345 msgstr ""
15346
15347 # type: =head2
15348 #. type: =head2
15349 #: ../src/guestfs-actions.pod:4700
15350 msgid "guestfs_mount"
15351 msgstr ""
15352
15353 # type: verbatim
15354 #. type: verbatim
15355 #: ../src/guestfs-actions.pod:4702
15356 #, no-wrap
15357 msgid ""
15358 " int\n"
15359 " guestfs_mount (guestfs_h *g,\n"
15360 "                const char *device,\n"
15361 "                const char *mountpoint);\n"
15362 "\n"
15363 msgstr ""
15364
15365 # type: textblock
15366 #. type: textblock
15367 #: ../src/guestfs-actions.pod:4707 ../fish/guestfish-actions.pod:3178
15368 msgid ""
15369 "Mount a guest disk at a position in the filesystem.  Block devices are named "
15370 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
15371 "those block devices contain partitions, they will have the usual names (eg. "
15372 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
15373 msgstr ""
15374
15375 # type: textblock
15376 #. type: textblock
15377 #: ../src/guestfs-actions.pod:4713 ../fish/guestfish-actions.pod:3184
15378 msgid ""
15379 "The rules are the same as for L<mount(2)>: A filesystem must first be "
15380 "mounted on C</> before others can be mounted.  Other filesystems can only be "
15381 "mounted on directories which already exist."
15382 msgstr ""
15383
15384 # type: textblock
15385 #. type: textblock
15386 #: ../src/guestfs-actions.pod:4718 ../fish/guestfish-actions.pod:3189
15387 msgid ""
15388 "The mounted filesystem is writable, if we have sufficient permissions on the "
15389 "underlying device."
15390 msgstr ""
15391
15392 # type: textblock
15393 #. type: textblock
15394 #: ../src/guestfs-actions.pod:4721
15395 msgid ""
15396 "B<Important note:> When you use this call, the filesystem options C<sync> "
15397 "and C<noatime> are set implicitly.  This was originally done because we "
15398 "thought it would improve reliability, but it turns out that I<-o sync> has a "
15399 "very large negative performance impact and negligible effect on "
15400 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
15401 "in any code that needs performance, and instead use C<guestfs_mount_options> "
15402 "(use an empty string for the first parameter if you don't want any options)."
15403 msgstr ""
15404
15405 # type: =head2
15406 #. type: =head2
15407 #: ../src/guestfs-actions.pod:4735
15408 msgid "guestfs_mount_loop"
15409 msgstr ""
15410
15411 # type: verbatim
15412 #. type: verbatim
15413 #: ../src/guestfs-actions.pod:4737
15414 #, no-wrap
15415 msgid ""
15416 " int\n"
15417 " guestfs_mount_loop (guestfs_h *g,\n"
15418 "                     const char *file,\n"
15419 "                     const char *mountpoint);\n"
15420 "\n"
15421 msgstr ""
15422
15423 # type: textblock
15424 #. type: textblock
15425 #: ../src/guestfs-actions.pod:4742 ../fish/guestfish-actions.pod:3206
15426 msgid ""
15427 "This command lets you mount C<file> (a filesystem image in a file) on a "
15428 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
15429 "mountpoint>."
15430 msgstr ""
15431
15432 # type: =head2
15433 #. type: =head2
15434 #: ../src/guestfs-actions.pod:4750
15435 msgid "guestfs_mount_options"
15436 msgstr ""
15437
15438 # type: verbatim
15439 #. type: verbatim
15440 #: ../src/guestfs-actions.pod:4752
15441 #, no-wrap
15442 msgid ""
15443 " int\n"
15444 " guestfs_mount_options (guestfs_h *g,\n"
15445 "                        const char *options,\n"
15446 "                        const char *device,\n"
15447 "                        const char *mountpoint);\n"
15448 "\n"
15449 msgstr ""
15450
15451 # type: textblock
15452 #. type: textblock
15453 #: ../src/guestfs-actions.pod:4758
15454 msgid ""
15455 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15456 "the mount options as for the L<mount(8)> I<-o> flag."
15457 msgstr ""
15458
15459 # type: textblock
15460 #. type: textblock
15461 #: ../src/guestfs-actions.pod:4762 ../fish/guestfish-actions.pod:3218
15462 msgid ""
15463 "If the C<options> parameter is an empty string, then no options are passed "
15464 "(all options default to whatever the filesystem uses)."
15465 msgstr ""
15466
15467 # type: textblock
15468 #. type: textblock
15469 #: ../src/guestfs-actions.pod:4768 ../src/guestfs-actions.pod:4782
15470 #: ../src/guestfs-actions.pod:4799
15471 msgid "(Added in 1.0.10)"
15472 msgstr ""
15473
15474 # type: =head2
15475 #. type: =head2
15476 #: ../src/guestfs-actions.pod:4770
15477 msgid "guestfs_mount_ro"
15478 msgstr ""
15479
15480 # type: verbatim
15481 #. type: verbatim
15482 #: ../src/guestfs-actions.pod:4772
15483 #, no-wrap
15484 msgid ""
15485 " int\n"
15486 " guestfs_mount_ro (guestfs_h *g,\n"
15487 "                   const char *device,\n"
15488 "                   const char *mountpoint);\n"
15489 "\n"
15490 msgstr ""
15491
15492 # type: textblock
15493 #. type: textblock
15494 #: ../src/guestfs-actions.pod:4777
15495 msgid ""
15496 "This is the same as the C<guestfs_mount> command, but it mounts the "
15497 "filesystem with the read-only (I<-o ro>) flag."
15498 msgstr ""
15499
15500 # type: =head2
15501 #. type: =head2
15502 #: ../src/guestfs-actions.pod:4784
15503 msgid "guestfs_mount_vfs"
15504 msgstr ""
15505
15506 # type: verbatim
15507 #. type: verbatim
15508 #: ../src/guestfs-actions.pod:4786
15509 #, no-wrap
15510 msgid ""
15511 " int\n"
15512 " guestfs_mount_vfs (guestfs_h *g,\n"
15513 "                    const char *options,\n"
15514 "                    const char *vfstype,\n"
15515 "                    const char *device,\n"
15516 "                    const char *mountpoint);\n"
15517 "\n"
15518 msgstr ""
15519
15520 # type: textblock
15521 #. type: textblock
15522 #: ../src/guestfs-actions.pod:4793
15523 msgid ""
15524 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15525 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
15526 "t> flags."
15527 msgstr ""
15528
15529 # type: =head2
15530 #. type: =head2
15531 #: ../src/guestfs-actions.pod:4801
15532 msgid "guestfs_mountpoints"
15533 msgstr ""
15534
15535 # type: verbatim
15536 #. type: verbatim
15537 #: ../src/guestfs-actions.pod:4803
15538 #, no-wrap
15539 msgid ""
15540 " char **\n"
15541 " guestfs_mountpoints (guestfs_h *g);\n"
15542 "\n"
15543 msgstr ""
15544
15545 # type: textblock
15546 #. type: textblock
15547 #: ../src/guestfs-actions.pod:4806
15548 msgid ""
15549 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
15550 "devices.  This one returns a hash table (map) of device name to directory "
15551 "where the device is mounted."
15552 msgstr ""
15553
15554 # type: =head2
15555 #. type: =head2
15556 #: ../src/guestfs-actions.pod:4818
15557 msgid "guestfs_mounts"
15558 msgstr ""
15559
15560 # type: verbatim
15561 #. type: verbatim
15562 #: ../src/guestfs-actions.pod:4820
15563 #, no-wrap
15564 msgid ""
15565 " char **\n"
15566 " guestfs_mounts (guestfs_h *g);\n"
15567 "\n"
15568 msgstr ""
15569
15570 # type: textblock
15571 #. type: textblock
15572 #: ../src/guestfs-actions.pod:4823 ../fish/guestfish-actions.pod:3249
15573 msgid ""
15574 "This returns the list of currently mounted filesystems.  It returns the list "
15575 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
15576 msgstr ""
15577
15578 # type: textblock
15579 #. type: textblock
15580 #: ../src/guestfs-actions.pod:4826 ../fish/guestfish-actions.pod:3252
15581 msgid "Some internal mounts are not shown."
15582 msgstr ""
15583
15584 # type: textblock
15585 #. type: textblock
15586 #: ../src/guestfs-actions.pod:4828
15587 msgid "See also: C<guestfs_mountpoints>"
15588 msgstr ""
15589
15590 # type: =head2
15591 #. type: =head2
15592 #: ../src/guestfs-actions.pod:4836
15593 msgid "guestfs_mv"
15594 msgstr ""
15595
15596 # type: verbatim
15597 #. type: verbatim
15598 #: ../src/guestfs-actions.pod:4838
15599 #, no-wrap
15600 msgid ""
15601 " int\n"
15602 " guestfs_mv (guestfs_h *g,\n"
15603 "             const char *src,\n"
15604 "             const char *dest);\n"
15605 "\n"
15606 msgstr ""
15607
15608 # type: textblock
15609 #. type: textblock
15610 #: ../src/guestfs-actions.pod:4843 ../fish/guestfish-actions.pod:3260
15611 msgid ""
15612 "This moves a file from C<src> to C<dest> where C<dest> is either a "
15613 "destination filename or destination directory."
15614 msgstr ""
15615
15616 # type: =head2
15617 #. type: =head2
15618 #: ../src/guestfs-actions.pod:4850
15619 msgid "guestfs_ntfs_3g_probe"
15620 msgstr ""
15621
15622 # type: verbatim
15623 #. type: verbatim
15624 #: ../src/guestfs-actions.pod:4852
15625 #, no-wrap
15626 msgid ""
15627 " int\n"
15628 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
15629 "                        int rw,\n"
15630 "                        const char *device);\n"
15631 "\n"
15632 msgstr ""
15633
15634 # type: textblock
15635 #. type: textblock
15636 #: ../src/guestfs-actions.pod:4857 ../fish/guestfish-actions.pod:3267
15637 msgid ""
15638 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
15639 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
15640 "write, and some cannot be mounted at all)."
15641 msgstr ""
15642
15643 # type: textblock
15644 #. type: textblock
15645 #: ../src/guestfs-actions.pod:4861 ../fish/guestfish-actions.pod:3271
15646 msgid ""
15647 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
15648 "can be mounted read-write.  Set it to false if you want to test if the "
15649 "volume can be mounted read-only."
15650 msgstr ""
15651
15652 # type: textblock
15653 #. type: textblock
15654 #: ../src/guestfs-actions.pod:4865 ../fish/guestfish-actions.pod:3275
15655 msgid ""
15656 "The return value is an integer which C<0> if the operation would succeed, or "
15657 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
15658 msgstr ""
15659
15660 # type: textblock
15661 #. type: textblock
15662 #: ../src/guestfs-actions.pod:4871
15663 msgid "(Added in 1.0.43)"
15664 msgstr ""
15665
15666 # type: =head2
15667 #. type: =head2
15668 #: ../src/guestfs-actions.pod:4873
15669 msgid "guestfs_ntfsresize"
15670 msgstr ""
15671
15672 # type: verbatim
15673 #. type: verbatim
15674 #: ../src/guestfs-actions.pod:4875
15675 #, no-wrap
15676 msgid ""
15677 " int\n"
15678 " guestfs_ntfsresize (guestfs_h *g,\n"
15679 "                     const char *device);\n"
15680 "\n"
15681 msgstr ""
15682
15683 # type: textblock
15684 #. type: textblock
15685 #: ../src/guestfs-actions.pod:4879 ../fish/guestfish-actions.pod:3283
15686 msgid ""
15687 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
15688 "size of the underlying device.  See also L<ntfsresize(8)>."
15689 msgstr ""
15690
15691 # type: =head2
15692 #. type: =head2
15693 #: ../src/guestfs-actions.pod:4887
15694 msgid "guestfs_ntfsresize_size"
15695 msgstr ""
15696
15697 # type: verbatim
15698 #. type: verbatim
15699 #: ../src/guestfs-actions.pod:4889
15700 #, no-wrap
15701 msgid ""
15702 " int\n"
15703 " guestfs_ntfsresize_size (guestfs_h *g,\n"
15704 "                          const char *device,\n"
15705 "                          int64_t size);\n"
15706 "\n"
15707 msgstr ""
15708
15709 # type: textblock
15710 #. type: textblock
15711 #: ../src/guestfs-actions.pod:4894
15712 msgid ""
15713 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
15714 "to specify the new size (in bytes) explicitly."
15715 msgstr ""
15716
15717 # type: textblock
15718 #. type: textblock
15719 #: ../src/guestfs-actions.pod:4899 ../src/guestfs-actions.pod:5335
15720 #: ../src/guestfs-actions.pod:5408 ../src/guestfs-actions.pod:5674
15721 #: ../src/guestfs-actions.pod:7245
15722 msgid "(Added in 1.3.14)"
15723 msgstr ""
15724
15725 # type: =head2
15726 #. type: =head2
15727 #: ../src/guestfs-actions.pod:4901
15728 msgid "guestfs_part_add"
15729 msgstr ""
15730
15731 # type: verbatim
15732 #. type: verbatim
15733 #: ../src/guestfs-actions.pod:4903
15734 #, no-wrap
15735 msgid ""
15736 " int\n"
15737 " guestfs_part_add (guestfs_h *g,\n"
15738 "                   const char *device,\n"
15739 "                   const char *prlogex,\n"
15740 "                   int64_t startsect,\n"
15741 "                   int64_t endsect);\n"
15742 "\n"
15743 msgstr ""
15744
15745 # type: textblock
15746 #. type: textblock
15747 #: ../src/guestfs-actions.pod:4910
15748 msgid ""
15749 "This command adds a partition to C<device>.  If there is no partition table "
15750 "on the device, call C<guestfs_part_init> first."
15751 msgstr ""
15752
15753 # type: textblock
15754 #. type: textblock
15755 #: ../src/guestfs-actions.pod:4913 ../fish/guestfish-actions.pod:3301
15756 msgid ""
15757 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
15758 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
15759 "C<logical>) and C<e> (or C<extended>) partition types."
15760 msgstr ""
15761
15762 # type: textblock
15763 #. type: textblock
15764 #: ../src/guestfs-actions.pod:4918 ../fish/guestfish-actions.pod:3306
15765 msgid ""
15766 "C<startsect> and C<endsect> are the start and end of the partition in "
15767 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
15768 "from the end of the disk (C<-1> is the last sector)."
15769 msgstr ""
15770
15771 # type: textblock
15772 #. type: textblock
15773 #: ../src/guestfs-actions.pod:4922
15774 msgid ""
15775 "Creating a partition which covers the whole disk is not so easy.  Use "
15776 "C<guestfs_part_disk> to do that."
15777 msgstr ""
15778
15779 # type: textblock
15780 #. type: textblock
15781 #: ../src/guestfs-actions.pod:4927 ../src/guestfs-actions.pod:4965
15782 #: ../src/guestfs-actions.pod:5018 ../src/guestfs-actions.pod:5096
15783 #: ../src/guestfs-actions.pod:5134 ../src/guestfs-actions.pod:5153
15784 #: ../src/guestfs-actions.pod:5193
15785 msgid "(Added in 1.0.78)"
15786 msgstr ""
15787
15788 # type: =head2
15789 #. type: =head2
15790 #: ../src/guestfs-actions.pod:4929
15791 msgid "guestfs_part_del"
15792 msgstr ""
15793
15794 # type: verbatim
15795 #. type: verbatim
15796 #: ../src/guestfs-actions.pod:4931
15797 #, no-wrap
15798 msgid ""
15799 " int\n"
15800 " guestfs_part_del (guestfs_h *g,\n"
15801 "                   const char *device,\n"
15802 "                   int partnum);\n"
15803 "\n"
15804 msgstr ""
15805
15806 # type: textblock
15807 #. type: textblock
15808 #: ../src/guestfs-actions.pod:4936 ../fish/guestfish-actions.pod:3317
15809 msgid "This command deletes the partition numbered C<partnum> on C<device>."
15810 msgstr ""
15811
15812 # type: textblock
15813 #. type: textblock
15814 #: ../src/guestfs-actions.pod:4938 ../fish/guestfish-actions.pod:3319
15815 msgid ""
15816 "Note that in the case of MBR partitioning, deleting an extended partition "
15817 "also deletes any logical partitions it contains."
15818 msgstr ""
15819
15820 # type: =head2
15821 #. type: =head2
15822 #: ../src/guestfs-actions.pod:4946
15823 msgid "guestfs_part_disk"
15824 msgstr ""
15825
15826 # type: verbatim
15827 #. type: verbatim
15828 #: ../src/guestfs-actions.pod:4948
15829 #, no-wrap
15830 msgid ""
15831 " int\n"
15832 " guestfs_part_disk (guestfs_h *g,\n"
15833 "                    const char *device,\n"
15834 "                    const char *parttype);\n"
15835 "\n"
15836 msgstr ""
15837
15838 # type: textblock
15839 #. type: textblock
15840 #: ../src/guestfs-actions.pod:4953
15841 msgid ""
15842 "This command is simply a combination of C<guestfs_part_init> followed by "
15843 "C<guestfs_part_add> to create a single primary partition covering the whole "
15844 "disk."
15845 msgstr ""
15846
15847 # type: textblock
15848 #. type: textblock
15849 #: ../src/guestfs-actions.pod:4957
15850 msgid ""
15851 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
15852 "possible values are described in C<guestfs_part_init>."
15853 msgstr ""
15854
15855 # type: =head2
15856 #. type: =head2
15857 #: ../src/guestfs-actions.pod:4967
15858 msgid "guestfs_part_get_bootable"
15859 msgstr ""
15860
15861 # type: verbatim
15862 #. type: verbatim
15863 #: ../src/guestfs-actions.pod:4969
15864 #, no-wrap
15865 msgid ""
15866 " int\n"
15867 " guestfs_part_get_bootable (guestfs_h *g,\n"
15868 "                            const char *device,\n"
15869 "                            int partnum);\n"
15870 "\n"
15871 msgstr ""
15872
15873 # type: textblock
15874 #. type: textblock
15875 #: ../src/guestfs-actions.pod:4974 ../fish/guestfish-actions.pod:3341
15876 msgid ""
15877 "This command returns true if the partition C<partnum> on C<device> has the "
15878 "bootable flag set."
15879 msgstr ""
15880
15881 # type: textblock
15882 #. type: textblock
15883 #: ../src/guestfs-actions.pod:4977
15884 msgid "See also C<guestfs_part_set_bootable>."
15885 msgstr ""
15886
15887 # type: =head2
15888 #. type: =head2
15889 #: ../src/guestfs-actions.pod:4983
15890 msgid "guestfs_part_get_mbr_id"
15891 msgstr ""
15892
15893 # type: verbatim
15894 #. type: verbatim
15895 #: ../src/guestfs-actions.pod:4985
15896 #, no-wrap
15897 msgid ""
15898 " int\n"
15899 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
15900 "                          const char *device,\n"
15901 "                          int partnum);\n"
15902 "\n"
15903 msgstr ""
15904
15905 # type: textblock
15906 #. type: textblock
15907 #: ../src/guestfs-actions.pod:4990 ../fish/guestfish-actions.pod:3350
15908 msgid ""
15909 "Returns the MBR type byte (also known as the ID byte) from the numbered "
15910 "partition C<partnum>."
15911 msgstr ""
15912
15913 # type: textblock
15914 #. type: textblock
15915 #: ../src/guestfs-actions.pod:4993 ../src/guestfs-actions.pod:5169
15916 msgid ""
15917 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
15918 "undefined results for other partition table types (see "
15919 "C<guestfs_part_get_parttype>)."
15920 msgstr ""
15921
15922 # type: =head2
15923 #. type: =head2
15924 #: ../src/guestfs-actions.pod:5001
15925 msgid "guestfs_part_get_parttype"
15926 msgstr ""
15927
15928 # type: verbatim
15929 #. type: verbatim
15930 #: ../src/guestfs-actions.pod:5003
15931 #, no-wrap
15932 msgid ""
15933 " char *\n"
15934 " guestfs_part_get_parttype (guestfs_h *g,\n"
15935 "                            const char *device);\n"
15936 "\n"
15937 msgstr ""
15938
15939 # type: textblock
15940 #. type: textblock
15941 #: ../src/guestfs-actions.pod:5007 ../fish/guestfish-actions.pod:3361
15942 msgid ""
15943 "This command examines the partition table on C<device> and returns the "
15944 "partition table type (format) being used."
15945 msgstr ""
15946
15947 # type: textblock
15948 #. type: textblock
15949 #: ../src/guestfs-actions.pod:5010
15950 msgid ""
15951 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
15952 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
15953 "possible, although unusual.  See C<guestfs_part_init> for a full list."
15954 msgstr ""
15955
15956 # type: =head2
15957 #. type: =head2
15958 #: ../src/guestfs-actions.pod:5020
15959 msgid "guestfs_part_init"
15960 msgstr ""
15961
15962 # type: verbatim
15963 #. type: verbatim
15964 #: ../src/guestfs-actions.pod:5022
15965 #, no-wrap
15966 msgid ""
15967 " int\n"
15968 " guestfs_part_init (guestfs_h *g,\n"
15969 "                    const char *device,\n"
15970 "                    const char *parttype);\n"
15971 "\n"
15972 msgstr ""
15973
15974 # type: textblock
15975 #. type: textblock
15976 #: ../src/guestfs-actions.pod:5027 ../fish/guestfish-actions.pod:3373
15977 msgid ""
15978 "This creates an empty partition table on C<device> of one of the partition "
15979 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
15980 "(for large disks)."
15981 msgstr ""
15982
15983 # type: textblock
15984 #. type: textblock
15985 #: ../src/guestfs-actions.pod:5031
15986 msgid ""
15987 "Initially there are no partitions.  Following this, you should call "
15988 "C<guestfs_part_add> for each partition required."
15989 msgstr ""
15990
15991 # type: textblock
15992 #. type: textblock
15993 #: ../src/guestfs-actions.pod:5034 ../fish/guestfish-actions.pod:3380
15994 msgid "Possible values for C<parttype> are:"
15995 msgstr ""
15996
15997 # type: =item
15998 #. type: =item
15999 #: ../src/guestfs-actions.pod:5038 ../fish/guestfish-actions.pod:3384
16000 msgid "B<efi> | B<gpt>"
16001 msgstr ""
16002
16003 # type: textblock
16004 #. type: textblock
16005 #: ../src/guestfs-actions.pod:5040 ../fish/guestfish-actions.pod:3386
16006 msgid "Intel EFI / GPT partition table."
16007 msgstr ""
16008
16009 # type: textblock
16010 #. type: textblock
16011 #: ../src/guestfs-actions.pod:5042 ../fish/guestfish-actions.pod:3388
16012 msgid ""
16013 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
16014 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
16015 "the C<mbr> format."
16016 msgstr ""
16017
16018 # type: =item
16019 #. type: =item
16020 #: ../src/guestfs-actions.pod:5046 ../fish/guestfish-actions.pod:3392
16021 msgid "B<mbr> | B<msdos>"
16022 msgstr ""
16023
16024 # type: textblock
16025 #. type: textblock
16026 #: ../src/guestfs-actions.pod:5048 ../fish/guestfish-actions.pod:3394
16027 msgid ""
16028 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
16029 "Windows.  This partition type will B<only> work for device sizes up to 2 "
16030 "TB.  For large disks we recommend using C<gpt>."
16031 msgstr ""
16032
16033 # type: textblock
16034 #. type: textblock
16035 #: ../src/guestfs-actions.pod:5055 ../fish/guestfish-actions.pod:3401
16036 msgid ""
16037 "Other partition table types that may work but are not supported include:"
16038 msgstr ""
16039
16040 # type: =item
16041 #. type: =item
16042 #: ../src/guestfs-actions.pod:5060 ../fish/guestfish-actions.pod:3406
16043 msgid "B<aix>"
16044 msgstr ""
16045
16046 # type: textblock
16047 #. type: textblock
16048 #: ../src/guestfs-actions.pod:5062 ../fish/guestfish-actions.pod:3408
16049 msgid "AIX disk labels."
16050 msgstr ""
16051
16052 # type: =item
16053 #. type: =item
16054 #: ../src/guestfs-actions.pod:5064 ../fish/guestfish-actions.pod:3410
16055 msgid "B<amiga> | B<rdb>"
16056 msgstr ""
16057
16058 # type: textblock
16059 #. type: textblock
16060 #: ../src/guestfs-actions.pod:5066 ../fish/guestfish-actions.pod:3412
16061 msgid "Amiga \"Rigid Disk Block\" format."
16062 msgstr ""
16063
16064 # type: =item
16065 #. type: =item
16066 #: ../src/guestfs-actions.pod:5068 ../fish/guestfish-actions.pod:3414
16067 msgid "B<bsd>"
16068 msgstr ""
16069
16070 # type: textblock
16071 #. type: textblock
16072 #: ../src/guestfs-actions.pod:5070 ../fish/guestfish-actions.pod:3416
16073 msgid "BSD disk labels."
16074 msgstr ""
16075
16076 # type: =item
16077 #. type: =item
16078 #: ../src/guestfs-actions.pod:5072 ../fish/guestfish-actions.pod:3418
16079 msgid "B<dasd>"
16080 msgstr ""
16081
16082 # type: textblock
16083 #. type: textblock
16084 #: ../src/guestfs-actions.pod:5074 ../fish/guestfish-actions.pod:3420
16085 msgid "DASD, used on IBM mainframes."
16086 msgstr ""
16087
16088 # type: =item
16089 #. type: =item
16090 #: ../src/guestfs-actions.pod:5076 ../fish/guestfish-actions.pod:3422
16091 msgid "B<dvh>"
16092 msgstr ""
16093
16094 # type: textblock
16095 #. type: textblock
16096 #: ../src/guestfs-actions.pod:5078 ../fish/guestfish-actions.pod:3424
16097 msgid "MIPS/SGI volumes."
16098 msgstr ""
16099
16100 # type: =item
16101 #. type: =item
16102 #: ../src/guestfs-actions.pod:5080 ../fish/guestfish-actions.pod:3426
16103 msgid "B<mac>"
16104 msgstr ""
16105
16106 # type: textblock
16107 #. type: textblock
16108 #: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3428
16109 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
16110 msgstr ""
16111
16112 # type: =item
16113 #. type: =item
16114 #: ../src/guestfs-actions.pod:5084 ../fish/guestfish-actions.pod:3430
16115 msgid "B<pc98>"
16116 msgstr ""
16117
16118 # type: textblock
16119 #. type: textblock
16120 #: ../src/guestfs-actions.pod:5086 ../fish/guestfish-actions.pod:3432
16121 msgid "NEC PC-98 format, common in Japan apparently."
16122 msgstr ""
16123
16124 # type: =item
16125 #. type: =item
16126 #: ../src/guestfs-actions.pod:5088 ../fish/guestfish-actions.pod:3434
16127 msgid "B<sun>"
16128 msgstr ""
16129
16130 # type: textblock
16131 #. type: textblock
16132 #: ../src/guestfs-actions.pod:5090 ../fish/guestfish-actions.pod:3436
16133 msgid "Sun disk labels."
16134 msgstr ""
16135
16136 # type: =head2
16137 #. type: =head2
16138 #: ../src/guestfs-actions.pod:5098
16139 msgid "guestfs_part_list"
16140 msgstr ""
16141
16142 # type: verbatim
16143 #. type: verbatim
16144 #: ../src/guestfs-actions.pod:5100
16145 #, no-wrap
16146 msgid ""
16147 " struct guestfs_partition_list *\n"
16148 " guestfs_part_list (guestfs_h *g,\n"
16149 "                    const char *device);\n"
16150 "\n"
16151 msgstr ""
16152
16153 # type: textblock
16154 #. type: textblock
16155 #: ../src/guestfs-actions.pod:5104 ../fish/guestfish-actions.pod:3444
16156 msgid ""
16157 "This command parses the partition table on C<device> and returns the list of "
16158 "partitions found."
16159 msgstr ""
16160
16161 # type: textblock
16162 #. type: textblock
16163 #: ../src/guestfs-actions.pod:5107 ../fish/guestfish-actions.pod:3447
16164 msgid "The fields in the returned structure are:"
16165 msgstr ""
16166
16167 # type: =item
16168 #. type: =item
16169 #: ../src/guestfs-actions.pod:5111 ../fish/guestfish-actions.pod:3451
16170 msgid "B<part_num>"
16171 msgstr ""
16172
16173 # type: textblock
16174 #. type: textblock
16175 #: ../src/guestfs-actions.pod:5113 ../fish/guestfish-actions.pod:3453
16176 msgid "Partition number, counting from 1."
16177 msgstr ""
16178
16179 # type: =item
16180 #. type: =item
16181 #: ../src/guestfs-actions.pod:5115 ../fish/guestfish-actions.pod:3455
16182 msgid "B<part_start>"
16183 msgstr ""
16184
16185 # type: textblock
16186 #. type: textblock
16187 #: ../src/guestfs-actions.pod:5117
16188 msgid ""
16189 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
16190 "the device's sector size, see C<guestfs_blockdev_getss>."
16191 msgstr ""
16192
16193 # type: =item
16194 #. type: =item
16195 #: ../src/guestfs-actions.pod:5120 ../fish/guestfish-actions.pod:3460
16196 msgid "B<part_end>"
16197 msgstr ""
16198
16199 # type: textblock
16200 #. type: textblock
16201 #: ../src/guestfs-actions.pod:5122 ../fish/guestfish-actions.pod:3462
16202 msgid "End of the partition in bytes."
16203 msgstr ""
16204
16205 # type: =item
16206 #. type: =item
16207 #: ../src/guestfs-actions.pod:5124 ../fish/guestfish-actions.pod:3464
16208 msgid "B<part_size>"
16209 msgstr ""
16210
16211 # type: textblock
16212 #. type: textblock
16213 #: ../src/guestfs-actions.pod:5126 ../fish/guestfish-actions.pod:3466
16214 msgid "Size of the partition in bytes."
16215 msgstr ""
16216
16217 # type: textblock
16218 #. type: textblock
16219 #: ../src/guestfs-actions.pod:5130
16220 msgid ""
16221 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
16222 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
16223 "use>."
16224 msgstr ""
16225
16226 # type: =head2
16227 #. type: =head2
16228 #: ../src/guestfs-actions.pod:5136
16229 msgid "guestfs_part_set_bootable"
16230 msgstr ""
16231
16232 # type: verbatim
16233 #. type: verbatim
16234 #: ../src/guestfs-actions.pod:5138
16235 #, no-wrap
16236 msgid ""
16237 " int\n"
16238 " guestfs_part_set_bootable (guestfs_h *g,\n"
16239 "                            const char *device,\n"
16240 "                            int partnum,\n"
16241 "                            int bootable);\n"
16242 "\n"
16243 msgstr ""
16244
16245 # type: textblock
16246 #. type: textblock
16247 #: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:3474
16248 msgid ""
16249 "This sets the bootable flag on partition numbered C<partnum> on device "
16250 "C<device>.  Note that partitions are numbered from 1."
16251 msgstr ""
16252
16253 # type: textblock
16254 #. type: textblock
16255 #: ../src/guestfs-actions.pod:5147 ../fish/guestfish-actions.pod:3477
16256 msgid ""
16257 "The bootable flag is used by some operating systems (notably Windows) to "
16258 "determine which partition to boot from.  It is by no means universally "
16259 "recognized."
16260 msgstr ""
16261
16262 # type: =head2
16263 #. type: =head2
16264 #: ../src/guestfs-actions.pod:5155
16265 msgid "guestfs_part_set_mbr_id"
16266 msgstr ""
16267
16268 # type: verbatim
16269 #. type: verbatim
16270 #: ../src/guestfs-actions.pod:5157
16271 #, no-wrap
16272 msgid ""
16273 " int\n"
16274 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
16275 "                          const char *device,\n"
16276 "                          int partnum,\n"
16277 "                          int idbyte);\n"
16278 "\n"
16279 msgstr ""
16280
16281 # type: textblock
16282 #. type: textblock
16283 #: ../src/guestfs-actions.pod:5163 ../fish/guestfish-actions.pod:3485
16284 msgid ""
16285 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
16286 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
16287 "documentation are in fact hexadecimal numbers, but usually documented "
16288 "without any leading \"0x\" which might be confusing."
16289 msgstr ""
16290
16291 # type: =head2
16292 #. type: =head2
16293 #: ../src/guestfs-actions.pod:5177
16294 msgid "guestfs_part_set_name"
16295 msgstr ""
16296
16297 # type: verbatim
16298 #. type: verbatim
16299 #: ../src/guestfs-actions.pod:5179
16300 #, no-wrap
16301 msgid ""
16302 " int\n"
16303 " guestfs_part_set_name (guestfs_h *g,\n"
16304 "                        const char *device,\n"
16305 "                        int partnum,\n"
16306 "                        const char *name);\n"
16307 "\n"
16308 msgstr ""
16309
16310 # type: textblock
16311 #. type: textblock
16312 #: ../src/guestfs-actions.pod:5185 ../fish/guestfish-actions.pod:3499
16313 msgid ""
16314 "This sets the partition name on partition numbered C<partnum> on device "
16315 "C<device>.  Note that partitions are numbered from 1."
16316 msgstr ""
16317
16318 # type: textblock
16319 #. type: textblock
16320 #: ../src/guestfs-actions.pod:5188 ../fish/guestfish-actions.pod:3502
16321 msgid ""
16322 "The partition name can only be set on certain types of partition table.  "
16323 "This works on C<gpt> but not on C<mbr> partitions."
16324 msgstr ""
16325
16326 # type: =head2
16327 #. type: =head2
16328 #: ../src/guestfs-actions.pod:5195
16329 msgid "guestfs_part_to_dev"
16330 msgstr ""
16331
16332 # type: verbatim
16333 #. type: verbatim
16334 #: ../src/guestfs-actions.pod:5197
16335 #, no-wrap
16336 msgid ""
16337 " char *\n"
16338 " guestfs_part_to_dev (guestfs_h *g,\n"
16339 "                      const char *partition);\n"
16340 "\n"
16341 msgstr ""
16342
16343 # type: textblock
16344 #. type: textblock
16345 #: ../src/guestfs-actions.pod:5201 ../fish/guestfish-actions.pod:3509
16346 msgid ""
16347 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
16348 "partition number, returning the device name (eg. \"/dev/sdb\")."
16349 msgstr ""
16350
16351 # type: textblock
16352 #. type: textblock
16353 #: ../src/guestfs-actions.pod:5205
16354 msgid ""
16355 "The named partition must exist, for example as a string returned from "
16356 "C<guestfs_list_partitions>."
16357 msgstr ""
16358
16359 # type: =head2
16360 #. type: =head2
16361 #: ../src/guestfs-actions.pod:5213
16362 msgid "guestfs_ping_daemon"
16363 msgstr ""
16364
16365 # type: verbatim
16366 #. type: verbatim
16367 #: ../src/guestfs-actions.pod:5215
16368 #, no-wrap
16369 msgid ""
16370 " int\n"
16371 " guestfs_ping_daemon (guestfs_h *g);\n"
16372 "\n"
16373 msgstr ""
16374
16375 # type: textblock
16376 #. type: textblock
16377 #: ../src/guestfs-actions.pod:5218 ../fish/guestfish-actions.pod:3520
16378 msgid ""
16379 "This is a test probe into the guestfs daemon running inside the qemu "
16380 "subprocess.  Calling this function checks that the daemon responds to the "
16381 "ping message, without affecting the daemon or attached block device(s) in "
16382 "any other way."
16383 msgstr ""
16384
16385 # type: =head2
16386 #. type: =head2
16387 #: ../src/guestfs-actions.pod:5227
16388 msgid "guestfs_pread"
16389 msgstr ""
16390
16391 # type: verbatim
16392 #. type: verbatim
16393 #: ../src/guestfs-actions.pod:5229
16394 #, no-wrap
16395 msgid ""
16396 " char *\n"
16397 " guestfs_pread (guestfs_h *g,\n"
16398 "                const char *path,\n"
16399 "                int count,\n"
16400 "                int64_t offset,\n"
16401 "                size_t *size_r);\n"
16402 "\n"
16403 msgstr ""
16404
16405 # type: textblock
16406 #. type: textblock
16407 #: ../src/guestfs-actions.pod:5236 ../fish/guestfish-actions.pod:3529
16408 msgid ""
16409 "This command lets you read part of a file.  It reads C<count> bytes of the "
16410 "file, starting at C<offset>, from file C<path>."
16411 msgstr ""
16412
16413 # type: textblock
16414 #. type: textblock
16415 #: ../src/guestfs-actions.pod:5239 ../src/guestfs-actions.pod:5265
16416 #: ../fish/guestfish-actions.pod:3532 ../fish/guestfish-actions.pod:3547
16417 msgid ""
16418 "This may read fewer bytes than requested.  For further details see the "
16419 "L<pread(2)> system call."
16420 msgstr ""
16421
16422 # type: textblock
16423 #. type: textblock
16424 #: ../src/guestfs-actions.pod:5242
16425 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
16426 msgstr ""
16427
16428 # type: =head2
16429 #. type: =head2
16430 #: ../src/guestfs-actions.pod:5253
16431 msgid "guestfs_pread_device"
16432 msgstr ""
16433
16434 # type: verbatim
16435 #. type: verbatim
16436 #: ../src/guestfs-actions.pod:5255
16437 #, no-wrap
16438 msgid ""
16439 " char *\n"
16440 " guestfs_pread_device (guestfs_h *g,\n"
16441 "                       const char *device,\n"
16442 "                       int count,\n"
16443 "                       int64_t offset,\n"
16444 "                       size_t *size_r);\n"
16445 "\n"
16446 msgstr ""
16447
16448 # type: textblock
16449 #. type: textblock
16450 #: ../src/guestfs-actions.pod:5262 ../fish/guestfish-actions.pod:3544
16451 msgid ""
16452 "This command lets you read part of a file.  It reads C<count> bytes of "
16453 "C<device>, starting at C<offset>."
16454 msgstr ""
16455
16456 # type: textblock
16457 #. type: textblock
16458 #: ../src/guestfs-actions.pod:5268
16459 msgid "See also C<guestfs_pread>."
16460 msgstr ""
16461
16462 # type: textblock
16463 #. type: textblock
16464 #: ../src/guestfs-actions.pod:5277
16465 msgid "(Added in 1.5.21)"
16466 msgstr ""
16467
16468 # type: =head2
16469 #. type: =head2
16470 #: ../src/guestfs-actions.pod:5279
16471 msgid "guestfs_pvcreate"
16472 msgstr ""
16473
16474 # type: verbatim
16475 #. type: verbatim
16476 #: ../src/guestfs-actions.pod:5281
16477 #, no-wrap
16478 msgid ""
16479 " int\n"
16480 " guestfs_pvcreate (guestfs_h *g,\n"
16481 "                   const char *device);\n"
16482 "\n"
16483 msgstr ""
16484
16485 # type: textblock
16486 #. type: textblock
16487 #: ../src/guestfs-actions.pod:5285 ../fish/guestfish-actions.pod:3559
16488 msgid ""
16489 "This creates an LVM physical volume on the named C<device>, where C<device> "
16490 "should usually be a partition name such as C</dev/sda1>."
16491 msgstr ""
16492
16493 # type: =head2
16494 #. type: =head2
16495 #: ../src/guestfs-actions.pod:5293
16496 msgid "guestfs_pvremove"
16497 msgstr ""
16498
16499 # type: verbatim
16500 #. type: verbatim
16501 #: ../src/guestfs-actions.pod:5295
16502 #, no-wrap
16503 msgid ""
16504 " int\n"
16505 " guestfs_pvremove (guestfs_h *g,\n"
16506 "                   const char *device);\n"
16507 "\n"
16508 msgstr ""
16509
16510 # type: textblock
16511 #. type: textblock
16512 #: ../src/guestfs-actions.pod:5299 ../fish/guestfish-actions.pod:3567
16513 msgid ""
16514 "This wipes a physical volume C<device> so that LVM will no longer recognise "
16515 "it."
16516 msgstr ""
16517
16518 # type: textblock
16519 #. type: textblock
16520 #: ../src/guestfs-actions.pod:5302 ../fish/guestfish-actions.pod:3570
16521 msgid ""
16522 "The implementation uses the C<pvremove> command which refuses to wipe "
16523 "physical volumes that contain any volume groups, so you have to remove those "
16524 "first."
16525 msgstr ""
16526
16527 # type: =head2
16528 #. type: =head2
16529 #: ../src/guestfs-actions.pod:5310
16530 msgid "guestfs_pvresize"
16531 msgstr ""
16532
16533 # type: verbatim
16534 #. type: verbatim
16535 #: ../src/guestfs-actions.pod:5312
16536 #, no-wrap
16537 msgid ""
16538 " int\n"
16539 " guestfs_pvresize (guestfs_h *g,\n"
16540 "                   const char *device);\n"
16541 "\n"
16542 msgstr ""
16543
16544 # type: textblock
16545 #. type: textblock
16546 #: ../src/guestfs-actions.pod:5316 ../fish/guestfish-actions.pod:3578
16547 msgid ""
16548 "This resizes (expands or shrinks) an existing LVM physical volume to match "
16549 "the new size of the underlying device."
16550 msgstr ""
16551
16552 # type: =head2
16553 #. type: =head2
16554 #: ../src/guestfs-actions.pod:5323
16555 msgid "guestfs_pvresize_size"
16556 msgstr ""
16557
16558 # type: verbatim
16559 #. type: verbatim
16560 #: ../src/guestfs-actions.pod:5325
16561 #, no-wrap
16562 msgid ""
16563 " int\n"
16564 " guestfs_pvresize_size (guestfs_h *g,\n"
16565 "                        const char *device,\n"
16566 "                        int64_t size);\n"
16567 "\n"
16568 msgstr ""
16569
16570 # type: textblock
16571 #. type: textblock
16572 #: ../src/guestfs-actions.pod:5330
16573 msgid ""
16574 "This command is the same as C<guestfs_pvresize> except that it allows you to "
16575 "specify the new size (in bytes) explicitly."
16576 msgstr ""
16577
16578 # type: =head2
16579 #. type: =head2
16580 #: ../src/guestfs-actions.pod:5337
16581 msgid "guestfs_pvs"
16582 msgstr ""
16583
16584 # type: verbatim
16585 #. type: verbatim
16586 #: ../src/guestfs-actions.pod:5339
16587 #, no-wrap
16588 msgid ""
16589 " char **\n"
16590 " guestfs_pvs (guestfs_h *g);\n"
16591 "\n"
16592 msgstr ""
16593
16594 # type: textblock
16595 #. type: textblock
16596 #: ../src/guestfs-actions.pod:5342 ../fish/guestfish-actions.pod:3592
16597 msgid ""
16598 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16599 "(8)> command."
16600 msgstr ""
16601
16602 # type: textblock
16603 #. type: textblock
16604 #: ../src/guestfs-actions.pod:5345 ../fish/guestfish-actions.pod:3595
16605 msgid ""
16606 "This returns a list of just the device names that contain PVs (eg. C</dev/"
16607 "sda2>)."
16608 msgstr ""
16609
16610 # type: textblock
16611 #. type: textblock
16612 #: ../src/guestfs-actions.pod:5348
16613 msgid "See also C<guestfs_pvs_full>."
16614 msgstr ""
16615
16616 # type: =head2
16617 #. type: =head2
16618 #: ../src/guestfs-actions.pod:5356
16619 msgid "guestfs_pvs_full"
16620 msgstr ""
16621
16622 # type: verbatim
16623 #. type: verbatim
16624 #: ../src/guestfs-actions.pod:5358
16625 #, no-wrap
16626 msgid ""
16627 " struct guestfs_lvm_pv_list *\n"
16628 " guestfs_pvs_full (guestfs_h *g);\n"
16629 "\n"
16630 msgstr ""
16631
16632 # type: textblock
16633 #. type: textblock
16634 #: ../src/guestfs-actions.pod:5361 ../fish/guestfish-actions.pod:3604
16635 msgid ""
16636 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16637 "(8)> command.  The \"full\" version includes all fields."
16638 msgstr ""
16639
16640 # type: textblock
16641 #. type: textblock
16642 #: ../src/guestfs-actions.pod:5364
16643 msgid ""
16644 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
16645 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
16646 msgstr ""
16647
16648 # type: =head2
16649 #. type: =head2
16650 #: ../src/guestfs-actions.pod:5370
16651 msgid "guestfs_pvuuid"
16652 msgstr ""
16653
16654 # type: verbatim
16655 #. type: verbatim
16656 #: ../src/guestfs-actions.pod:5372
16657 #, no-wrap
16658 msgid ""
16659 " char *\n"
16660 " guestfs_pvuuid (guestfs_h *g,\n"
16661 "                 const char *device);\n"
16662 "\n"
16663 msgstr ""
16664
16665 # type: textblock
16666 #. type: textblock
16667 #: ../src/guestfs-actions.pod:5376 ../fish/guestfish-actions.pod:3611
16668 msgid "This command returns the UUID of the LVM PV C<device>."
16669 msgstr ""
16670
16671 # type: =head2
16672 #. type: =head2
16673 #: ../src/guestfs-actions.pod:5383
16674 msgid "guestfs_pwrite"
16675 msgstr ""
16676
16677 # type: verbatim
16678 #. type: verbatim
16679 #: ../src/guestfs-actions.pod:5385
16680 #, no-wrap
16681 msgid ""
16682 " int\n"
16683 " guestfs_pwrite (guestfs_h *g,\n"
16684 "                 const char *path,\n"
16685 "                 const char *content,\n"
16686 "                 size_t content_size,\n"
16687 "                 int64_t offset);\n"
16688 "\n"
16689 msgstr ""
16690
16691 # type: textblock
16692 #. type: textblock
16693 #: ../src/guestfs-actions.pod:5392 ../fish/guestfish-actions.pod:3617
16694 msgid ""
16695 "This command writes to part of a file.  It writes the data buffer C<content> "
16696 "to the file C<path> starting at offset C<offset>."
16697 msgstr ""
16698
16699 # type: textblock
16700 #. type: textblock
16701 #: ../src/guestfs-actions.pod:5395 ../fish/guestfish-actions.pod:3620
16702 msgid ""
16703 "This command implements the L<pwrite(2)> system call, and like that system "
16704 "call it may not write the full data requested.  The return value is the "
16705 "number of bytes that were actually written to the file.  This could even be "
16706 "0, although short writes are unlikely for regular files in ordinary "
16707 "circumstances."
16708 msgstr ""
16709
16710 # type: textblock
16711 #. type: textblock
16712 #: ../src/guestfs-actions.pod:5401
16713 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
16714 msgstr ""
16715
16716 # type: =head2
16717 #. type: =head2
16718 #: ../src/guestfs-actions.pod:5410
16719 msgid "guestfs_pwrite_device"
16720 msgstr ""
16721
16722 # type: verbatim
16723 #. type: verbatim
16724 #: ../src/guestfs-actions.pod:5412
16725 #, no-wrap
16726 msgid ""
16727 " int\n"
16728 " guestfs_pwrite_device (guestfs_h *g,\n"
16729 "                        const char *device,\n"
16730 "                        const char *content,\n"
16731 "                        size_t content_size,\n"
16732 "                        int64_t offset);\n"
16733 "\n"
16734 msgstr ""
16735
16736 # type: textblock
16737 #. type: textblock
16738 #: ../src/guestfs-actions.pod:5419 ../fish/guestfish-actions.pod:3635
16739 msgid ""
16740 "This command writes to part of a device.  It writes the data buffer "
16741 "C<content> to C<device> starting at offset C<offset>."
16742 msgstr ""
16743
16744 # type: textblock
16745 #. type: textblock
16746 #: ../src/guestfs-actions.pod:5422 ../fish/guestfish-actions.pod:3638
16747 msgid ""
16748 "This command implements the L<pwrite(2)> system call, and like that system "
16749 "call it may not write the full data requested (although short writes to disk "
16750 "devices and partitions are probably impossible with standard Linux kernels)."
16751 msgstr ""
16752
16753 # type: textblock
16754 #. type: textblock
16755 #: ../src/guestfs-actions.pod:5427
16756 msgid "See also C<guestfs_pwrite>."
16757 msgstr ""
16758
16759 # type: textblock
16760 #. type: textblock
16761 #: ../src/guestfs-actions.pod:5434
16762 msgid "(Added in 1.5.20)"
16763 msgstr ""
16764
16765 # type: =head2
16766 #. type: =head2
16767 #: ../src/guestfs-actions.pod:5436
16768 msgid "guestfs_read_file"
16769 msgstr ""
16770
16771 # type: verbatim
16772 #. type: verbatim
16773 #: ../src/guestfs-actions.pod:5438
16774 #, no-wrap
16775 msgid ""
16776 " char *\n"
16777 " guestfs_read_file (guestfs_h *g,\n"
16778 "                    const char *path,\n"
16779 "                    size_t *size_r);\n"
16780 "\n"
16781 msgstr ""
16782
16783 # type: textblock
16784 #. type: textblock
16785 #: ../src/guestfs-actions.pod:5443 ../fish/guestfish-actions.pod:3652
16786 msgid "This calls returns the contents of the file C<path> as a buffer."
16787 msgstr ""
16788
16789 # type: textblock
16790 #. type: textblock
16791 #: ../src/guestfs-actions.pod:5446
16792 msgid ""
16793 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
16794 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
16795 "function is limited in the total size of file that can be handled."
16796 msgstr ""
16797
16798 # type: textblock
16799 #. type: textblock
16800 #: ../src/guestfs-actions.pod:5458
16801 msgid "(Added in 1.0.63)"
16802 msgstr ""
16803
16804 # type: =head2
16805 #. type: =head2
16806 #: ../src/guestfs-actions.pod:5460
16807 msgid "guestfs_read_lines"
16808 msgstr ""
16809
16810 # type: verbatim
16811 #. type: verbatim
16812 #: ../src/guestfs-actions.pod:5462
16813 #, no-wrap
16814 msgid ""
16815 " char **\n"
16816 " guestfs_read_lines (guestfs_h *g,\n"
16817 "                     const char *path);\n"
16818 "\n"
16819 msgstr ""
16820
16821 # type: textblock
16822 #. type: textblock
16823 #: ../src/guestfs-actions.pod:5468 ../fish/guestfish-actions.pod:3669
16824 msgid ""
16825 "The file contents are returned as a list of lines.  Trailing C<LF> and "
16826 "C<CRLF> character sequences are I<not> returned."
16827 msgstr ""
16828
16829 # type: textblock
16830 #. type: textblock
16831 #: ../src/guestfs-actions.pod:5471
16832 msgid ""
16833 "Note that this function cannot correctly handle binary files (specifically, "
16834 "files containing C<\\0> character which is treated as end of line).  For "
16835 "those you need to use the C<guestfs_read_file> function which has a more "
16836 "complex interface."
16837 msgstr ""
16838
16839 # type: =head2
16840 #. type: =head2
16841 #: ../src/guestfs-actions.pod:5482
16842 msgid "guestfs_readdir"
16843 msgstr ""
16844
16845 # type: verbatim
16846 #. type: verbatim
16847 #: ../src/guestfs-actions.pod:5484
16848 #, no-wrap
16849 msgid ""
16850 " struct guestfs_dirent_list *\n"
16851 " guestfs_readdir (guestfs_h *g,\n"
16852 "                  const char *dir);\n"
16853 "\n"
16854 msgstr ""
16855
16856 # type: textblock
16857 #. type: textblock
16858 #: ../src/guestfs-actions.pod:5488 ../fish/guestfish-actions.pod:3681
16859 msgid "This returns the list of directory entries in directory C<dir>."
16860 msgstr ""
16861
16862 # type: textblock
16863 #. type: textblock
16864 #: ../src/guestfs-actions.pod:5490 ../fish/guestfish-actions.pod:3683
16865 msgid ""
16866 "All entries in the directory are returned, including C<.> and C<..>.  The "
16867 "entries are I<not> sorted, but returned in the same order as the underlying "
16868 "filesystem."
16869 msgstr ""
16870
16871 # type: textblock
16872 #. type: textblock
16873 #: ../src/guestfs-actions.pod:5494 ../fish/guestfish-actions.pod:3687
16874 msgid ""
16875 "Also this call returns basic file type information about each file.  The "
16876 "C<ftyp> field will contain one of the following characters:"
16877 msgstr ""
16878
16879 # type: =item
16880 #. type: =item
16881 #: ../src/guestfs-actions.pod:5499 ../fish/guestfish-actions.pod:3692
16882 msgid "'b'"
16883 msgstr ""
16884
16885 # type: textblock
16886 #. type: textblock
16887 #: ../src/guestfs-actions.pod:5501 ../fish/guestfish-actions.pod:3694
16888 msgid "Block special"
16889 msgstr ""
16890
16891 # type: =item
16892 #. type: =item
16893 #: ../src/guestfs-actions.pod:5503 ../fish/guestfish-actions.pod:3696
16894 msgid "'c'"
16895 msgstr ""
16896
16897 # type: textblock
16898 #. type: textblock
16899 #: ../src/guestfs-actions.pod:5505 ../fish/guestfish-actions.pod:3698
16900 msgid "Char special"
16901 msgstr ""
16902
16903 # type: =item
16904 #. type: =item
16905 #: ../src/guestfs-actions.pod:5507 ../fish/guestfish-actions.pod:3700
16906 msgid "'d'"
16907 msgstr ""
16908
16909 # type: textblock
16910 #. type: textblock
16911 #: ../src/guestfs-actions.pod:5509 ../fish/guestfish-actions.pod:3702
16912 msgid "Directory"
16913 msgstr ""
16914
16915 # type: =item
16916 #. type: =item
16917 #: ../src/guestfs-actions.pod:5511 ../fish/guestfish-actions.pod:3704
16918 msgid "'f'"
16919 msgstr ""
16920
16921 # type: textblock
16922 #. type: textblock
16923 #: ../src/guestfs-actions.pod:5513 ../fish/guestfish-actions.pod:3706
16924 msgid "FIFO (named pipe)"
16925 msgstr ""
16926
16927 # type: =item
16928 #. type: =item
16929 #: ../src/guestfs-actions.pod:5515 ../fish/guestfish-actions.pod:3708
16930 msgid "'l'"
16931 msgstr ""
16932
16933 # type: textblock
16934 #. type: textblock
16935 #: ../src/guestfs-actions.pod:5517 ../fish/guestfish-actions.pod:3710
16936 msgid "Symbolic link"
16937 msgstr ""
16938
16939 # type: =item
16940 #. type: =item
16941 #: ../src/guestfs-actions.pod:5519 ../fish/guestfish-actions.pod:3712
16942 msgid "'r'"
16943 msgstr ""
16944
16945 # type: textblock
16946 #. type: textblock
16947 #: ../src/guestfs-actions.pod:5521 ../fish/guestfish-actions.pod:3714
16948 msgid "Regular file"
16949 msgstr ""
16950
16951 # type: =item
16952 #. type: =item
16953 #: ../src/guestfs-actions.pod:5523 ../fish/guestfish-actions.pod:3716
16954 msgid "'s'"
16955 msgstr ""
16956
16957 # type: textblock
16958 #. type: textblock
16959 #: ../src/guestfs-actions.pod:5525 ../fish/guestfish-actions.pod:3718
16960 msgid "Socket"
16961 msgstr ""
16962
16963 # type: =item
16964 #. type: =item
16965 #: ../src/guestfs-actions.pod:5527 ../fish/guestfish-actions.pod:3720
16966 msgid "'u'"
16967 msgstr ""
16968
16969 # type: textblock
16970 #. type: textblock
16971 #: ../src/guestfs-actions.pod:5529 ../fish/guestfish-actions.pod:3722
16972 msgid "Unknown file type"
16973 msgstr ""
16974
16975 # type: =item
16976 #. type: =item
16977 #: ../src/guestfs-actions.pod:5531 ../fish/guestfish-actions.pod:3724
16978 msgid "'?'"
16979 msgstr ""
16980
16981 # type: textblock
16982 #. type: textblock
16983 #: ../src/guestfs-actions.pod:5533 ../fish/guestfish-actions.pod:3726
16984 msgid ""
16985 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
16986 msgstr ""
16987
16988 # type: textblock
16989 #. type: textblock
16990 #: ../src/guestfs-actions.pod:5538
16991 msgid ""
16992 "This function is primarily intended for use by programs.  To get a simple "
16993 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
16994 "consumption, use C<guestfs_ll>."
16995 msgstr ""
16996
16997 # type: textblock
16998 #. type: textblock
16999 #: ../src/guestfs-actions.pod:5542
17000 msgid ""
17001 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
17002 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
17003 msgstr ""
17004
17005 # type: =head2
17006 #. type: =head2
17007 #: ../src/guestfs-actions.pod:5548
17008 msgid "guestfs_readlink"
17009 msgstr ""
17010
17011 # type: verbatim
17012 #. type: verbatim
17013 #: ../src/guestfs-actions.pod:5550
17014 #, no-wrap
17015 msgid ""
17016 " char *\n"
17017 " guestfs_readlink (guestfs_h *g,\n"
17018 "                   const char *path);\n"
17019 "\n"
17020 msgstr ""
17021
17022 # type: textblock
17023 #. type: textblock
17024 #: ../src/guestfs-actions.pod:5554 ../fish/guestfish-actions.pod:3739
17025 msgid "This command reads the target of a symbolic link."
17026 msgstr ""
17027
17028 # type: =head2
17029 #. type: =head2
17030 #: ../src/guestfs-actions.pod:5561
17031 msgid "guestfs_readlinklist"
17032 msgstr ""
17033
17034 # type: verbatim
17035 #. type: verbatim
17036 #: ../src/guestfs-actions.pod:5563
17037 #, no-wrap
17038 msgid ""
17039 " char **\n"
17040 " guestfs_readlinklist (guestfs_h *g,\n"
17041 "                       const char *path,\n"
17042 "                       char *const *names);\n"
17043 "\n"
17044 msgstr ""
17045
17046 # type: textblock
17047 #. type: textblock
17048 #: ../src/guestfs-actions.pod:5568 ../fish/guestfish-actions.pod:3745
17049 msgid ""
17050 "This call allows you to do a C<readlink> operation on multiple files, where "
17051 "all files are in the directory C<path>.  C<names> is the list of files from "
17052 "this directory."
17053 msgstr ""
17054
17055 # type: textblock
17056 #. type: textblock
17057 #: ../src/guestfs-actions.pod:5572 ../fish/guestfish-actions.pod:3749
17058 msgid ""
17059 "On return you get a list of strings, with a one-to-one correspondence to the "
17060 "C<names> list.  Each string is the value of the symbolic link."
17061 msgstr ""
17062
17063 # type: textblock
17064 #. type: textblock
17065 #: ../src/guestfs-actions.pod:5576 ../fish/guestfish-actions.pod:3753
17066 msgid ""
17067 "If the C<readlink(2)> operation fails on any name, then the corresponding "
17068 "result string is the empty string C<\"\">.  However the whole operation is "
17069 "completed even if there were C<readlink(2)> errors, and so you can call this "
17070 "function with names where you don't know if they are symbolic links already "
17071 "(albeit slightly less efficient)."
17072 msgstr ""
17073
17074 # type: textblock
17075 #. type: textblock
17076 #: ../src/guestfs-actions.pod:5583 ../fish/guestfish-actions.pod:3760
17077 msgid ""
17078 "This call is intended for programs that want to efficiently list a directory "
17079 "contents without making many round-trips.  Very long directory listings "
17080 "might cause the protocol message size to be exceeded, causing this call to "
17081 "fail.  The caller must split up such requests into smaller groups of names."
17082 msgstr ""
17083
17084 # type: =head2
17085 #. type: =head2
17086 #: ../src/guestfs-actions.pod:5596
17087 msgid "guestfs_realpath"
17088 msgstr ""
17089
17090 # type: verbatim
17091 #. type: verbatim
17092 #: ../src/guestfs-actions.pod:5598
17093 #, no-wrap
17094 msgid ""
17095 " char *\n"
17096 " guestfs_realpath (guestfs_h *g,\n"
17097 "                   const char *path);\n"
17098 "\n"
17099 msgstr ""
17100
17101 # type: textblock
17102 #. type: textblock
17103 #: ../src/guestfs-actions.pod:5602 ../fish/guestfish-actions.pod:3771
17104 msgid ""
17105 "Return the canonicalized absolute pathname of C<path>.  The returned path "
17106 "has no C<.>, C<..> or symbolic link path elements."
17107 msgstr ""
17108
17109 # type: =head2
17110 #. type: =head2
17111 #: ../src/guestfs-actions.pod:5610
17112 msgid "guestfs_removexattr"
17113 msgstr ""
17114
17115 # type: verbatim
17116 #. type: verbatim
17117 #: ../src/guestfs-actions.pod:5612
17118 #, no-wrap
17119 msgid ""
17120 " int\n"
17121 " guestfs_removexattr (guestfs_h *g,\n"
17122 "                      const char *xattr,\n"
17123 "                      const char *path);\n"
17124 "\n"
17125 msgstr ""
17126
17127 # type: textblock
17128 #. type: textblock
17129 #: ../src/guestfs-actions.pod:5617 ../fish/guestfish-actions.pod:3778
17130 msgid ""
17131 "This call removes the extended attribute named C<xattr> of the file C<path>."
17132 msgstr ""
17133
17134 # type: textblock
17135 #. type: textblock
17136 #: ../src/guestfs-actions.pod:5620
17137 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
17138 msgstr ""
17139
17140 # type: =head2
17141 #. type: =head2
17142 #: ../src/guestfs-actions.pod:5626
17143 msgid "guestfs_resize2fs"
17144 msgstr ""
17145
17146 # type: verbatim
17147 #. type: verbatim
17148 #: ../src/guestfs-actions.pod:5628
17149 #, no-wrap
17150 msgid ""
17151 " int\n"
17152 " guestfs_resize2fs (guestfs_h *g,\n"
17153 "                    const char *device);\n"
17154 "\n"
17155 msgstr ""
17156
17157 # type: textblock
17158 #. type: textblock
17159 #: ../src/guestfs-actions.pod:5632 ../fish/guestfish-actions.pod:3787
17160 msgid ""
17161 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
17162 "underlying device."
17163 msgstr ""
17164
17165 # type: textblock
17166 #. type: textblock
17167 #: ../src/guestfs-actions.pod:5635
17168 msgid ""
17169 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
17170 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
17171 "sometimes gives an error about this and sometimes not.  In any case, it is "
17172 "always safe to call C<guestfs_e2fsck_f> before calling this function."
17173 msgstr ""
17174
17175 #. type: =head2
17176 #: ../src/guestfs-actions.pod:5645
17177 msgid "guestfs_resize2fs_M"
17178 msgstr ""
17179
17180 #. type: verbatim
17181 #: ../src/guestfs-actions.pod:5647
17182 #, no-wrap
17183 msgid ""
17184 " int\n"
17185 " guestfs_resize2fs_M (guestfs_h *g,\n"
17186 "                      const char *device);\n"
17187 "\n"
17188 msgstr ""
17189
17190 #. type: textblock
17191 #: ../src/guestfs-actions.pod:5651
17192 msgid ""
17193 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
17194 "resized to its minimum size.  This works like the C<-M> option to the "
17195 "C<resize2fs> command."
17196 msgstr ""
17197
17198 #. type: textblock
17199 #: ../src/guestfs-actions.pod:5655
17200 msgid ""
17201 "To get the resulting size of the filesystem you should call "
17202 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
17203 "These two numbers, multiplied together, give the resulting size of the "
17204 "minimal filesystem in bytes."
17205 msgstr ""
17206
17207 # type: =head2
17208 #. type: =head2
17209 #: ../src/guestfs-actions.pod:5662
17210 msgid "guestfs_resize2fs_size"
17211 msgstr ""
17212
17213 # type: verbatim
17214 #. type: verbatim
17215 #: ../src/guestfs-actions.pod:5664
17216 #, no-wrap
17217 msgid ""
17218 " int\n"
17219 " guestfs_resize2fs_size (guestfs_h *g,\n"
17220 "                         const char *device,\n"
17221 "                         int64_t size);\n"
17222 "\n"
17223 msgstr ""
17224
17225 # type: textblock
17226 #. type: textblock
17227 #: ../src/guestfs-actions.pod:5669
17228 msgid ""
17229 "This command is the same as C<guestfs_resize2fs> except that it allows you "
17230 "to specify the new size (in bytes) explicitly."
17231 msgstr ""
17232
17233 # type: =head2
17234 #. type: =head2
17235 #: ../src/guestfs-actions.pod:5676
17236 msgid "guestfs_rm"
17237 msgstr ""
17238
17239 # type: verbatim
17240 #. type: verbatim
17241 #: ../src/guestfs-actions.pod:5678
17242 #, no-wrap
17243 msgid ""
17244 " int\n"
17245 " guestfs_rm (guestfs_h *g,\n"
17246 "             const char *path);\n"
17247 "\n"
17248 msgstr ""
17249
17250 # type: textblock
17251 #. type: textblock
17252 #: ../src/guestfs-actions.pod:5682 ../fish/guestfish-actions.pod:3820
17253 msgid "Remove the single file C<path>."
17254 msgstr ""
17255
17256 # type: =head2
17257 #. type: =head2
17258 #: ../src/guestfs-actions.pod:5688
17259 msgid "guestfs_rm_rf"
17260 msgstr ""
17261
17262 # type: verbatim
17263 #. type: verbatim
17264 #: ../src/guestfs-actions.pod:5690
17265 #, no-wrap
17266 msgid ""
17267 " int\n"
17268 " guestfs_rm_rf (guestfs_h *g,\n"
17269 "                const char *path);\n"
17270 "\n"
17271 msgstr ""
17272
17273 # type: textblock
17274 #. type: textblock
17275 #: ../src/guestfs-actions.pod:5694 ../fish/guestfish-actions.pod:3826
17276 msgid ""
17277 "Remove the file or directory C<path>, recursively removing the contents if "
17278 "its a directory.  This is like the C<rm -rf> shell command."
17279 msgstr ""
17280
17281 # type: =head2
17282 #. type: =head2
17283 #: ../src/guestfs-actions.pod:5702
17284 msgid "guestfs_rmdir"
17285 msgstr ""
17286
17287 # type: verbatim
17288 #. type: verbatim
17289 #: ../src/guestfs-actions.pod:5704
17290 #, no-wrap
17291 msgid ""
17292 " int\n"
17293 " guestfs_rmdir (guestfs_h *g,\n"
17294 "                const char *path);\n"
17295 "\n"
17296 msgstr ""
17297
17298 # type: textblock
17299 #. type: textblock
17300 #: ../src/guestfs-actions.pod:5708 ../fish/guestfish-actions.pod:3834
17301 msgid "Remove the single directory C<path>."
17302 msgstr ""
17303
17304 # type: =head2
17305 #. type: =head2
17306 #: ../src/guestfs-actions.pod:5714
17307 msgid "guestfs_rmmountpoint"
17308 msgstr ""
17309
17310 # type: verbatim
17311 #. type: verbatim
17312 #: ../src/guestfs-actions.pod:5716
17313 #, no-wrap
17314 msgid ""
17315 " int\n"
17316 " guestfs_rmmountpoint (guestfs_h *g,\n"
17317 "                       const char *exemptpath);\n"
17318 "\n"
17319 msgstr ""
17320
17321 # type: textblock
17322 #. type: textblock
17323 #: ../src/guestfs-actions.pod:5720
17324 msgid ""
17325 "This calls removes a mountpoint that was previously created with "
17326 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
17327 msgstr ""
17328
17329 # type: =head2
17330 #. type: =head2
17331 #: ../src/guestfs-actions.pod:5728
17332 msgid "guestfs_scrub_device"
17333 msgstr ""
17334
17335 # type: verbatim
17336 #. type: verbatim
17337 #: ../src/guestfs-actions.pod:5730
17338 #, no-wrap
17339 msgid ""
17340 " int\n"
17341 " guestfs_scrub_device (guestfs_h *g,\n"
17342 "                       const char *device);\n"
17343 "\n"
17344 msgstr ""
17345
17346 # type: textblock
17347 #. type: textblock
17348 #: ../src/guestfs-actions.pod:5734 ../fish/guestfish-actions.pod:3848
17349 msgid ""
17350 "This command writes patterns over C<device> to make data retrieval more "
17351 "difficult."
17352 msgstr ""
17353
17354 # type: textblock
17355 #. type: textblock
17356 #: ../src/guestfs-actions.pod:5737 ../src/guestfs-actions.pod:5758
17357 #: ../src/guestfs-actions.pod:5777 ../fish/guestfish-actions.pod:3851
17358 #: ../fish/guestfish-actions.pod:3866 ../fish/guestfish-actions.pod:3879
17359 msgid ""
17360 "It is an interface to the L<scrub(1)> program.  See that manual page for "
17361 "more details."
17362 msgstr ""
17363
17364 # type: textblock
17365 #. type: textblock
17366 #: ../src/guestfs-actions.pod:5745 ../src/guestfs-actions.pod:5763
17367 #: ../src/guestfs-actions.pod:5782
17368 msgid "(Added in 1.0.52)"
17369 msgstr ""
17370
17371 # type: =head2
17372 #. type: =head2
17373 #: ../src/guestfs-actions.pod:5747
17374 msgid "guestfs_scrub_file"
17375 msgstr ""
17376
17377 # type: verbatim
17378 #. type: verbatim
17379 #: ../src/guestfs-actions.pod:5749
17380 #, no-wrap
17381 msgid ""
17382 " int\n"
17383 " guestfs_scrub_file (guestfs_h *g,\n"
17384 "                     const char *file);\n"
17385 "\n"
17386 msgstr ""
17387
17388 # type: textblock
17389 #. type: textblock
17390 #: ../src/guestfs-actions.pod:5753 ../fish/guestfish-actions.pod:3861
17391 msgid ""
17392 "This command writes patterns over a file to make data retrieval more "
17393 "difficult."
17394 msgstr ""
17395
17396 # type: textblock
17397 #. type: textblock
17398 #: ../src/guestfs-actions.pod:5756 ../fish/guestfish-actions.pod:3864
17399 msgid "The file is I<removed> after scrubbing."
17400 msgstr ""
17401
17402 # type: =head2
17403 #. type: =head2
17404 #: ../src/guestfs-actions.pod:5765
17405 msgid "guestfs_scrub_freespace"
17406 msgstr ""
17407
17408 # type: verbatim
17409 #. type: verbatim
17410 #: ../src/guestfs-actions.pod:5767
17411 #, no-wrap
17412 msgid ""
17413 " int\n"
17414 " guestfs_scrub_freespace (guestfs_h *g,\n"
17415 "                          const char *dir);\n"
17416 "\n"
17417 msgstr ""
17418
17419 # type: textblock
17420 #. type: textblock
17421 #: ../src/guestfs-actions.pod:5771
17422 msgid ""
17423 "This command creates the directory C<dir> and then fills it with files until "
17424 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
17425 "and deletes them.  The intention is to scrub any free space on the partition "
17426 "containing C<dir>."
17427 msgstr ""
17428
17429 # type: =head2
17430 #. type: =head2
17431 #: ../src/guestfs-actions.pod:5784
17432 msgid "guestfs_set_append"
17433 msgstr ""
17434
17435 # type: verbatim
17436 #. type: verbatim
17437 #: ../src/guestfs-actions.pod:5786
17438 #, no-wrap
17439 msgid ""
17440 " int\n"
17441 " guestfs_set_append (guestfs_h *g,\n"
17442 "                     const char *append);\n"
17443 "\n"
17444 msgstr ""
17445
17446 # type: textblock
17447 #. type: textblock
17448 #: ../src/guestfs-actions.pod:5790 ../fish/guestfish-actions.pod:3888
17449 msgid ""
17450 "This function is used to add additional options to the guest kernel command "
17451 "line."
17452 msgstr ""
17453
17454 # type: textblock
17455 #. type: textblock
17456 #: ../src/guestfs-actions.pod:5793 ../fish/guestfish-actions.pod:3891
17457 msgid ""
17458 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
17459 "environment variable."
17460 msgstr ""
17461
17462 # type: textblock
17463 #. type: textblock
17464 #: ../src/guestfs-actions.pod:5796 ../fish/guestfish-actions.pod:3894
17465 msgid ""
17466 "Setting C<append> to C<NULL> means I<no> additional options are passed "
17467 "(libguestfs always adds a few of its own)."
17468 msgstr ""
17469
17470 #. type: =head2
17471 #: ../src/guestfs-actions.pod:5803
17472 msgid "guestfs_set_attach_method"
17473 msgstr ""
17474
17475 #. type: verbatim
17476 #: ../src/guestfs-actions.pod:5805
17477 #, no-wrap
17478 msgid ""
17479 " int\n"
17480 " guestfs_set_attach_method (guestfs_h *g,\n"
17481 "                            const char *attachmethod);\n"
17482 "\n"
17483 msgstr ""
17484
17485 #. type: textblock
17486 #: ../src/guestfs-actions.pod:5809 ../fish/guestfish-actions.pod:3903
17487 msgid ""
17488 "Set the method that libguestfs uses to connect to the back end guestfsd "
17489 "daemon.  Possible methods are:"
17490 msgstr ""
17491
17492 #. type: textblock
17493 #: ../src/guestfs-actions.pod:5816 ../fish/guestfish-actions.pod:3910
17494 msgid ""
17495 "Launch an appliance and connect to it.  This is the ordinary method and the "
17496 "default."
17497 msgstr ""
17498
17499 #. type: =item
17500 #: ../src/guestfs-actions.pod:5819 ../fish/guestfish-actions.pod:3913
17501 msgid "C<unix:I<path>>"
17502 msgstr ""
17503
17504 #. type: textblock
17505 #: ../src/guestfs-actions.pod:5821 ../fish/guestfish-actions.pod:3915
17506 msgid "Connect to the Unix domain socket I<path>."
17507 msgstr ""
17508
17509 #. type: textblock
17510 #: ../src/guestfs-actions.pod:5823 ../fish/guestfish-actions.pod:3917
17511 msgid ""
17512 "This method lets you connect to an existing daemon or (using virtio-serial) "
17513 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
17514 "RUNNING DAEMONS>."
17515 msgstr ""
17516
17517 # type: =head2
17518 #. type: =head2
17519 #: ../src/guestfs-actions.pod:5831
17520 msgid "guestfs_set_autosync"
17521 msgstr ""
17522
17523 # type: verbatim
17524 #. type: verbatim
17525 #: ../src/guestfs-actions.pod:5833
17526 #, no-wrap
17527 msgid ""
17528 " int\n"
17529 " guestfs_set_autosync (guestfs_h *g,\n"
17530 "                       int autosync);\n"
17531 "\n"
17532 msgstr ""
17533
17534 #. type: textblock
17535 #: ../src/guestfs-actions.pod:5837 ../fish/guestfish-actions.pod:3929
17536 msgid ""
17537 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
17538 "effort attempt to make filesystems consistent and synchronized when the "
17539 "handle is closed (also if the program exits without closing handles)."
17540 msgstr ""
17541
17542 # type: textblock
17543 #. type: textblock
17544 #: ../src/guestfs-actions.pod:5842 ../fish/guestfish-actions.pod:3934
17545 msgid ""
17546 "This is enabled by default (since libguestfs 1.5.24, previously it was "
17547 "disabled by default)."
17548 msgstr ""
17549
17550 # type: =head2
17551 #. type: =head2
17552 #: ../src/guestfs-actions.pod:5849
17553 msgid "guestfs_set_direct"
17554 msgstr ""
17555
17556 # type: verbatim
17557 #. type: verbatim
17558 #: ../src/guestfs-actions.pod:5851
17559 #, no-wrap
17560 msgid ""
17561 " int\n"
17562 " guestfs_set_direct (guestfs_h *g,\n"
17563 "                     int direct);\n"
17564 "\n"
17565 msgstr ""
17566
17567 # type: textblock
17568 #. type: textblock
17569 #: ../src/guestfs-actions.pod:5855 ../fish/guestfish-actions.pod:3943
17570 msgid ""
17571 "If the direct appliance mode flag is enabled, then stdin and stdout are "
17572 "passed directly through to the appliance once it is launched."
17573 msgstr ""
17574
17575 # type: textblock
17576 #. type: textblock
17577 #: ../src/guestfs-actions.pod:5859
17578 msgid ""
17579 "One consequence of this is that log messages aren't caught by the library "
17580 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
17581 "stdout."
17582 msgstr ""
17583
17584 # type: textblock
17585 #. type: textblock
17586 #: ../src/guestfs-actions.pod:5863 ../fish/guestfish-actions.pod:3951
17587 msgid "You probably don't want to use this unless you know what you are doing."
17588 msgstr ""
17589
17590 # type: textblock
17591 #. type: textblock
17592 #: ../src/guestfs-actions.pod:5866 ../fish/guestfish-actions.pod:3954
17593 msgid "The default is disabled."
17594 msgstr ""
17595
17596 # type: =head2
17597 #. type: =head2
17598 #: ../src/guestfs-actions.pod:5872
17599 msgid "guestfs_set_e2label"
17600 msgstr ""
17601
17602 # type: verbatim
17603 #. type: verbatim
17604 #: ../src/guestfs-actions.pod:5874
17605 #, no-wrap
17606 msgid ""
17607 " int\n"
17608 " guestfs_set_e2label (guestfs_h *g,\n"
17609 "                      const char *device,\n"
17610 "                      const char *label);\n"
17611 "\n"
17612 msgstr ""
17613
17614 # type: textblock
17615 #. type: textblock
17616 #: ../src/guestfs-actions.pod:5879 ../fish/guestfish-actions.pod:3960
17617 msgid ""
17618 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
17619 "C<label>.  Filesystem labels are limited to 16 characters."
17620 msgstr ""
17621
17622 # type: textblock
17623 #. type: textblock
17624 #: ../src/guestfs-actions.pod:5883
17625 msgid ""
17626 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
17627 "the existing label on a filesystem."
17628 msgstr ""
17629
17630 # type: =head2
17631 #. type: =head2
17632 #: ../src/guestfs-actions.pod:5890
17633 msgid "guestfs_set_e2uuid"
17634 msgstr ""
17635
17636 # type: verbatim
17637 #. type: verbatim
17638 #: ../src/guestfs-actions.pod:5892
17639 #, no-wrap
17640 msgid ""
17641 " int\n"
17642 " guestfs_set_e2uuid (guestfs_h *g,\n"
17643 "                     const char *device,\n"
17644 "                     const char *uuid);\n"
17645 "\n"
17646 msgstr ""
17647
17648 # type: textblock
17649 #. type: textblock
17650 #: ../src/guestfs-actions.pod:5897 ../fish/guestfish-actions.pod:3971
17651 msgid ""
17652 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
17653 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
17654 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
17655 msgstr ""
17656
17657 # type: textblock
17658 #. type: textblock
17659 #: ../src/guestfs-actions.pod:5902
17660 msgid ""
17661 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
17662 "the existing UUID of a filesystem."
17663 msgstr ""
17664
17665 # type: =head2
17666 #. type: =head2
17667 #: ../src/guestfs-actions.pod:5909
17668 msgid "guestfs_set_memsize"
17669 msgstr ""
17670
17671 # type: verbatim
17672 #. type: verbatim
17673 #: ../src/guestfs-actions.pod:5911
17674 #, no-wrap
17675 msgid ""
17676 " int\n"
17677 " guestfs_set_memsize (guestfs_h *g,\n"
17678 "                      int memsize);\n"
17679 "\n"
17680 msgstr ""
17681
17682 # type: textblock
17683 #. type: textblock
17684 #: ../src/guestfs-actions.pod:5915
17685 msgid ""
17686 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
17687 "This only has any effect if called before C<guestfs_launch>."
17688 msgstr ""
17689
17690 # type: textblock
17691 #. type: textblock
17692 #: ../src/guestfs-actions.pod:5919 ../fish/guestfish-actions.pod:3989
17693 msgid ""
17694 "You can also change this by setting the environment variable "
17695 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
17696 msgstr ""
17697
17698 # type: =head2
17699 #. type: =head2
17700 #: ../src/guestfs-actions.pod:5930
17701 msgid "guestfs_set_network"
17702 msgstr ""
17703
17704 # type: verbatim
17705 #. type: verbatim
17706 #: ../src/guestfs-actions.pod:5932
17707 #, no-wrap
17708 msgid ""
17709 " int\n"
17710 " guestfs_set_network (guestfs_h *g,\n"
17711 "                      int network);\n"
17712 "\n"
17713 msgstr ""
17714
17715 # type: textblock
17716 #. type: textblock
17717 #: ../src/guestfs-actions.pod:5936 ../fish/guestfish-actions.pod:4002
17718 msgid ""
17719 "If C<network> is true, then the network is enabled in the libguestfs "
17720 "appliance.  The default is false."
17721 msgstr ""
17722
17723 # type: textblock
17724 #. type: textblock
17725 #: ../src/guestfs-actions.pod:5939 ../fish/guestfish-actions.pod:4005
17726 msgid ""
17727 "This affects whether commands are able to access the network (see L<guestfs"
17728 "(3)/RUNNING COMMANDS>)."
17729 msgstr ""
17730
17731 # type: textblock
17732 #. type: textblock
17733 #: ../src/guestfs-actions.pod:5942
17734 msgid ""
17735 "You must call this before calling C<guestfs_launch>, otherwise it has no "
17736 "effect."
17737 msgstr ""
17738
17739 # type: =head2
17740 #. type: =head2
17741 #: ../src/guestfs-actions.pod:5949
17742 msgid "guestfs_set_path"
17743 msgstr ""
17744
17745 # type: verbatim
17746 #. type: verbatim
17747 #: ../src/guestfs-actions.pod:5951
17748 #, no-wrap
17749 msgid ""
17750 " int\n"
17751 " guestfs_set_path (guestfs_h *g,\n"
17752 "                   const char *searchpath);\n"
17753 "\n"
17754 msgstr ""
17755
17756 # type: textblock
17757 #. type: textblock
17758 #: ../src/guestfs-actions.pod:5955 ../fish/guestfish-actions.pod:4017
17759 msgid "Set the path that libguestfs searches for kernel and initrd.img."
17760 msgstr ""
17761
17762 # type: textblock
17763 #. type: textblock
17764 #: ../src/guestfs-actions.pod:5957 ../fish/guestfish-actions.pod:4019
17765 msgid ""
17766 "The default is C<$libdir/guestfs> unless overridden by setting "
17767 "C<LIBGUESTFS_PATH> environment variable."
17768 msgstr ""
17769
17770 # type: textblock
17771 #. type: textblock
17772 #: ../src/guestfs-actions.pod:5960 ../fish/guestfish-actions.pod:4022
17773 msgid "Setting C<path> to C<NULL> restores the default path."
17774 msgstr ""
17775
17776 # type: =head2
17777 #. type: =head2
17778 #: ../src/guestfs-actions.pod:5966
17779 msgid "guestfs_set_qemu"
17780 msgstr ""
17781
17782 # type: verbatim
17783 #. type: verbatim
17784 #: ../src/guestfs-actions.pod:5968
17785 #, no-wrap
17786 msgid ""
17787 " int\n"
17788 " guestfs_set_qemu (guestfs_h *g,\n"
17789 "                   const char *qemu);\n"
17790 "\n"
17791 msgstr ""
17792
17793 # type: textblock
17794 #. type: textblock
17795 #: ../src/guestfs-actions.pod:5972 ../fish/guestfish-actions.pod:4030
17796 msgid "Set the qemu binary that we will use."
17797 msgstr ""
17798
17799 # type: textblock
17800 #. type: textblock
17801 #: ../src/guestfs-actions.pod:5974 ../fish/guestfish-actions.pod:4032
17802 msgid ""
17803 "The default is chosen when the library was compiled by the configure script."
17804 msgstr ""
17805
17806 # type: textblock
17807 #. type: textblock
17808 #: ../src/guestfs-actions.pod:5977 ../fish/guestfish-actions.pod:4035
17809 msgid ""
17810 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
17811 "variable."
17812 msgstr ""
17813
17814 # type: textblock
17815 #. type: textblock
17816 #: ../src/guestfs-actions.pod:5980 ../fish/guestfish-actions.pod:4038
17817 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
17818 msgstr ""
17819
17820 # type: textblock
17821 #. type: textblock
17822 #: ../src/guestfs-actions.pod:5982 ../fish/guestfish-actions.pod:4040
17823 msgid ""
17824 "Note that you should call this function as early as possible after creating "
17825 "the handle.  This is because some pre-launch operations depend on testing "
17826 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
17827 "don't retest features, and so you might see inconsistent results.  Using the "
17828 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
17829 "the qemu binary at the same time as the handle is created."
17830 msgstr ""
17831
17832 # type: =head2
17833 #. type: =head2
17834 #: ../src/guestfs-actions.pod:5994
17835 msgid "guestfs_set_recovery_proc"
17836 msgstr ""
17837
17838 # type: verbatim
17839 #. type: verbatim
17840 #: ../src/guestfs-actions.pod:5996
17841 #, no-wrap
17842 msgid ""
17843 " int\n"
17844 " guestfs_set_recovery_proc (guestfs_h *g,\n"
17845 "                            int recoveryproc);\n"
17846 "\n"
17847 msgstr ""
17848
17849 # type: textblock
17850 #. type: textblock
17851 #: ../src/guestfs-actions.pod:6000
17852 msgid ""
17853 "If this is called with the parameter C<false> then C<guestfs_launch> does "
17854 "not create a recovery process.  The purpose of the recovery process is to "
17855 "stop runaway qemu processes in the case where the main program aborts "
17856 "abruptly."
17857 msgstr ""
17858
17859 # type: textblock
17860 #. type: textblock
17861 #: ../src/guestfs-actions.pod:6005
17862 msgid ""
17863 "This only has any effect if called before C<guestfs_launch>, and the default "
17864 "is true."
17865 msgstr ""
17866
17867 # type: textblock
17868 #. type: textblock
17869 #: ../src/guestfs-actions.pod:6008 ../fish/guestfish-actions.pod:4062
17870 msgid ""
17871 "About the only time when you would want to disable this is if the main "
17872 "process will fork itself into the background (\"daemonize\" itself).  In "
17873 "this case the recovery process thinks that the main program has disappeared "
17874 "and so kills qemu, which is not very helpful."
17875 msgstr ""
17876
17877 # type: =head2
17878 #. type: =head2
17879 #: ../src/guestfs-actions.pod:6018
17880 msgid "guestfs_set_selinux"
17881 msgstr ""
17882
17883 # type: verbatim
17884 #. type: verbatim
17885 #: ../src/guestfs-actions.pod:6020
17886 #, no-wrap
17887 msgid ""
17888 " int\n"
17889 " guestfs_set_selinux (guestfs_h *g,\n"
17890 "                      int selinux);\n"
17891 "\n"
17892 msgstr ""
17893
17894 # type: textblock
17895 #. type: textblock
17896 #: ../src/guestfs-actions.pod:6024 ../fish/guestfish-actions.pod:4074
17897 msgid ""
17898 "This sets the selinux flag that is passed to the appliance at boot time.  "
17899 "The default is C<selinux=0> (disabled)."
17900 msgstr ""
17901
17902 # type: textblock
17903 #. type: textblock
17904 #: ../src/guestfs-actions.pod:6027 ../fish/guestfish-actions.pod:4077
17905 msgid ""
17906 "Note that if SELinux is enabled, it is always in Permissive mode "
17907 "(C<enforcing=0>)."
17908 msgstr ""
17909
17910 # type: =head2
17911 #. type: =head2
17912 #: ../src/guestfs-actions.pod:6037
17913 msgid "guestfs_set_trace"
17914 msgstr ""
17915
17916 # type: verbatim
17917 #. type: verbatim
17918 #: ../src/guestfs-actions.pod:6039
17919 #, no-wrap
17920 msgid ""
17921 " int\n"
17922 " guestfs_set_trace (guestfs_h *g,\n"
17923 "                    int trace);\n"
17924 "\n"
17925 msgstr ""
17926
17927 #. type: textblock
17928 #: ../src/guestfs-actions.pod:6043 ../fish/guestfish-actions.pod:4089
17929 msgid ""
17930 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
17931 "return values are traced."
17932 msgstr ""
17933
17934 # type: textblock
17935 #. type: textblock
17936 #: ../src/guestfs-actions.pod:6046 ../fish/guestfish-actions.pod:4092
17937 msgid ""
17938 "If you want to trace C API calls into libguestfs (and other libraries) then "
17939 "possibly a better way is to use the external ltrace(1) command."
17940 msgstr ""
17941
17942 # type: textblock
17943 #. type: textblock
17944 #: ../src/guestfs-actions.pod:6050 ../fish/guestfish-actions.pod:4096
17945 msgid ""
17946 "Command traces are disabled unless the environment variable "
17947 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
17948 msgstr ""
17949
17950 #. type: textblock
17951 #: ../src/guestfs-actions.pod:6053
17952 msgid ""
17953 "Trace messages are normally sent to C<stderr>, unless you register a "
17954 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
17955 msgstr ""
17956
17957 # type: =head2
17958 #. type: =head2
17959 #: ../src/guestfs-actions.pod:6061
17960 msgid "guestfs_set_verbose"
17961 msgstr ""
17962
17963 # type: verbatim
17964 #. type: verbatim
17965 #: ../src/guestfs-actions.pod:6063
17966 #, no-wrap
17967 msgid ""
17968 " int\n"
17969 " guestfs_set_verbose (guestfs_h *g,\n"
17970 "                      int verbose);\n"
17971 "\n"
17972 msgstr ""
17973
17974 #. type: textblock
17975 #: ../src/guestfs-actions.pod:6067 ../fish/guestfish-actions.pod:4109
17976 msgid "If C<verbose> is true, this turns on verbose messages."
17977 msgstr ""
17978
17979 # type: textblock
17980 #. type: textblock
17981 #: ../src/guestfs-actions.pod:6069 ../fish/guestfish-actions.pod:4111
17982 msgid ""
17983 "Verbose messages are disabled unless the environment variable "
17984 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
17985 msgstr ""
17986
17987 #. type: textblock
17988 #: ../src/guestfs-actions.pod:6072
17989 msgid ""
17990 "Verbose messages are normally sent to C<stderr>, unless you register a "
17991 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
17992 msgstr ""
17993
17994 # type: =head2
17995 #. type: =head2
17996 #: ../src/guestfs-actions.pod:6080
17997 msgid "guestfs_setcon"
17998 msgstr ""
17999
18000 # type: verbatim
18001 #. type: verbatim
18002 #: ../src/guestfs-actions.pod:6082
18003 #, no-wrap
18004 msgid ""
18005 " int\n"
18006 " guestfs_setcon (guestfs_h *g,\n"
18007 "                 const char *context);\n"
18008 "\n"
18009 msgstr ""
18010
18011 # type: textblock
18012 #. type: textblock
18013 #: ../src/guestfs-actions.pod:6086 ../fish/guestfish-actions.pod:4122
18014 msgid ""
18015 "This sets the SELinux security context of the daemon to the string "
18016 "C<context>."
18017 msgstr ""
18018
18019 # type: textblock
18020 #. type: textblock
18021 #: ../src/guestfs-actions.pod:6089 ../fish/guestfish-actions.pod:4125
18022 msgid "See the documentation about SELINUX in L<guestfs(3)>."
18023 msgstr ""
18024
18025 # type: =head2
18026 #. type: =head2
18027 #: ../src/guestfs-actions.pod:6095
18028 msgid "guestfs_setxattr"
18029 msgstr ""
18030
18031 # type: verbatim
18032 #. type: verbatim
18033 #: ../src/guestfs-actions.pod:6097
18034 #, no-wrap
18035 msgid ""
18036 " int\n"
18037 " guestfs_setxattr (guestfs_h *g,\n"
18038 "                   const char *xattr,\n"
18039 "                   const char *val,\n"
18040 "                   int vallen,\n"
18041 "                   const char *path);\n"
18042 "\n"
18043 msgstr ""
18044
18045 # type: textblock
18046 #. type: textblock
18047 #: ../src/guestfs-actions.pod:6104 ../fish/guestfish-actions.pod:4131
18048 msgid ""
18049 "This call sets the extended attribute named C<xattr> of the file C<path> to "
18050 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
18051 msgstr ""
18052
18053 # type: textblock
18054 #. type: textblock
18055 #: ../src/guestfs-actions.pod:6108
18056 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
18057 msgstr ""
18058
18059 # type: =head2
18060 #. type: =head2
18061 #: ../src/guestfs-actions.pod:6114
18062 msgid "guestfs_sfdisk"
18063 msgstr ""
18064
18065 # type: verbatim
18066 #. type: verbatim
18067 #: ../src/guestfs-actions.pod:6116
18068 #, no-wrap
18069 msgid ""
18070 " int\n"
18071 " guestfs_sfdisk (guestfs_h *g,\n"
18072 "                 const char *device,\n"
18073 "                 int cyls,\n"
18074 "                 int heads,\n"
18075 "                 int sectors,\n"
18076 "                 char *const *lines);\n"
18077 "\n"
18078 msgstr ""
18079
18080 # type: textblock
18081 #. type: textblock
18082 #: ../src/guestfs-actions.pod:6124 ../fish/guestfish-actions.pod:4141
18083 msgid ""
18084 "This is a direct interface to the L<sfdisk(8)> program for creating "
18085 "partitions on block devices."
18086 msgstr ""
18087
18088 # type: textblock
18089 #. type: textblock
18090 #: ../src/guestfs-actions.pod:6127 ../fish/guestfish-actions.pod:4144
18091 msgid "C<device> should be a block device, for example C</dev/sda>."
18092 msgstr ""
18093
18094 # type: textblock
18095 #. type: textblock
18096 #: ../src/guestfs-actions.pod:6129 ../fish/guestfish-actions.pod:4146
18097 msgid ""
18098 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
18099 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
18100 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
18101 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
18102 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
18103 "the kernel) cannot work out the right geometry and you will need to tell it."
18104 msgstr ""
18105
18106 # type: textblock
18107 #. type: textblock
18108 #: ../src/guestfs-actions.pod:6137 ../fish/guestfish-actions.pod:4154
18109 msgid ""
18110 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
18111 "refer to the L<sfdisk(8)> manpage."
18112 msgstr ""
18113
18114 # type: textblock
18115 #. type: textblock
18116 #: ../src/guestfs-actions.pod:6140 ../fish/guestfish-actions.pod:4157
18117 msgid ""
18118 "To create a single partition occupying the whole disk, you would pass "
18119 "C<lines> as a single element list, when the single element being the string "
18120 "C<,> (comma)."
18121 msgstr ""
18122
18123 # type: textblock
18124 #. type: textblock
18125 #: ../src/guestfs-actions.pod:6144
18126 msgid ""
18127 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
18128 msgstr ""
18129
18130 # type: =head2
18131 #. type: =head2
18132 #: ../src/guestfs-actions.pod:6154
18133 msgid "guestfs_sfdiskM"
18134 msgstr ""
18135
18136 # type: verbatim
18137 #. type: verbatim
18138 #: ../src/guestfs-actions.pod:6156
18139 #, no-wrap
18140 msgid ""
18141 " int\n"
18142 " guestfs_sfdiskM (guestfs_h *g,\n"
18143 "                  const char *device,\n"
18144 "                  char *const *lines);\n"
18145 "\n"
18146 msgstr ""
18147
18148 # type: textblock
18149 #. type: textblock
18150 #: ../src/guestfs-actions.pod:6161
18151 msgid ""
18152 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
18153 "partition sizes are specified in megabytes only (rounded to the nearest "
18154 "cylinder) and you don't need to specify the cyls, heads and sectors "
18155 "parameters which were rarely if ever used anyway."
18156 msgstr ""
18157
18158 # type: textblock
18159 #. type: textblock
18160 #: ../src/guestfs-actions.pod:6167
18161 msgid ""
18162 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
18163 "C<guestfs_part_disk>"
18164 msgstr ""
18165
18166 # type: =head2
18167 #. type: =head2
18168 #: ../src/guestfs-actions.pod:6177
18169 msgid "guestfs_sfdisk_N"
18170 msgstr ""
18171
18172 # type: verbatim
18173 #. type: verbatim
18174 #: ../src/guestfs-actions.pod:6179
18175 #, no-wrap
18176 msgid ""
18177 " int\n"
18178 " guestfs_sfdisk_N (guestfs_h *g,\n"
18179 "                   const char *device,\n"
18180 "                   int partnum,\n"
18181 "                   int cyls,\n"
18182 "                   int heads,\n"
18183 "                   int sectors,\n"
18184 "                   const char *line);\n"
18185 "\n"
18186 msgstr ""
18187
18188 # type: textblock
18189 #. type: textblock
18190 #: ../src/guestfs-actions.pod:6188 ../fish/guestfish-actions.pod:4187
18191 msgid ""
18192 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
18193 "(note: C<n> counts from 1)."
18194 msgstr ""
18195
18196 # type: textblock
18197 #. type: textblock
18198 #: ../src/guestfs-actions.pod:6191
18199 msgid ""
18200 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
18201 "for the cyls/heads/sectors parameters."
18202 msgstr ""
18203
18204 # type: textblock
18205 #. type: textblock
18206 #: ../src/guestfs-actions.pod:6194
18207 msgid "See also: C<guestfs_part_add>"
18208 msgstr ""
18209
18210 # type: =head2
18211 #. type: =head2
18212 #: ../src/guestfs-actions.pod:6203
18213 msgid "guestfs_sfdisk_disk_geometry"
18214 msgstr ""
18215
18216 # type: verbatim
18217 #. type: verbatim
18218 #: ../src/guestfs-actions.pod:6205
18219 #, no-wrap
18220 msgid ""
18221 " char *\n"
18222 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
18223 "                               const char *device);\n"
18224 "\n"
18225 msgstr ""
18226
18227 # type: textblock
18228 #. type: textblock
18229 #: ../src/guestfs-actions.pod:6209
18230 msgid ""
18231 "This displays the disk geometry of C<device> read from the partition table.  "
18232 "Especially in the case where the underlying block device has been resized, "
18233 "this can be different from the kernel's idea of the geometry (see "
18234 "C<guestfs_sfdisk_kernel_geometry>)."
18235 msgstr ""
18236
18237 # type: textblock
18238 #. type: textblock
18239 #: ../src/guestfs-actions.pod:6214 ../src/guestfs-actions.pod:6230
18240 #: ../fish/guestfish-actions.pod:4207 ../fish/guestfish-actions.pod:4216
18241 msgid "The result is in human-readable format, and not designed to be parsed."
18242 msgstr ""
18243
18244 # type: =head2
18245 #. type: =head2
18246 #: ../src/guestfs-actions.pod:6222
18247 msgid "guestfs_sfdisk_kernel_geometry"
18248 msgstr ""
18249
18250 # type: verbatim
18251 #. type: verbatim
18252 #: ../src/guestfs-actions.pod:6224
18253 #, no-wrap
18254 msgid ""
18255 " char *\n"
18256 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
18257 "                                 const char *device);\n"
18258 "\n"
18259 msgstr ""
18260
18261 # type: textblock
18262 #. type: textblock
18263 #: ../src/guestfs-actions.pod:6228 ../fish/guestfish-actions.pod:4214
18264 msgid "This displays the kernel's idea of the geometry of C<device>."
18265 msgstr ""
18266
18267 # type: =head2
18268 #. type: =head2
18269 #: ../src/guestfs-actions.pod:6238
18270 msgid "guestfs_sfdisk_l"
18271 msgstr ""
18272
18273 # type: verbatim
18274 #. type: verbatim
18275 #: ../src/guestfs-actions.pod:6240
18276 #, no-wrap
18277 msgid ""
18278 " char *\n"
18279 " guestfs_sfdisk_l (guestfs_h *g,\n"
18280 "                   const char *device);\n"
18281 "\n"
18282 msgstr ""
18283
18284 # type: textblock
18285 #. type: textblock
18286 #: ../src/guestfs-actions.pod:6244 ../fish/guestfish-actions.pod:4223
18287 msgid ""
18288 "This displays the partition table on C<device>, in the human-readable output "
18289 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
18290 msgstr ""
18291
18292 # type: textblock
18293 #. type: textblock
18294 #: ../src/guestfs-actions.pod:6248
18295 msgid "See also: C<guestfs_part_list>"
18296 msgstr ""
18297
18298 # type: =head2
18299 #. type: =head2
18300 #: ../src/guestfs-actions.pod:6255
18301 msgid "guestfs_sh"
18302 msgstr ""
18303
18304 # type: verbatim
18305 #. type: verbatim
18306 #: ../src/guestfs-actions.pod:6257
18307 #, no-wrap
18308 msgid ""
18309 " char *\n"
18310 " guestfs_sh (guestfs_h *g,\n"
18311 "             const char *command);\n"
18312 "\n"
18313 msgstr ""
18314
18315 # type: textblock
18316 #. type: textblock
18317 #: ../src/guestfs-actions.pod:6261 ../fish/guestfish-actions.pod:4233
18318 msgid ""
18319 "This call runs a command from the guest filesystem via the guest's C</bin/"
18320 "sh>."
18321 msgstr ""
18322
18323 # type: textblock
18324 #. type: textblock
18325 #: ../src/guestfs-actions.pod:6264
18326 msgid "This is like C<guestfs_command>, but passes the command to:"
18327 msgstr ""
18328
18329 # type: verbatim
18330 #. type: verbatim
18331 #: ../src/guestfs-actions.pod:6266 ../fish/guestfish-actions.pod:4238
18332 #, no-wrap
18333 msgid ""
18334 " /bin/sh -c \"command\"\n"
18335 "\n"
18336 msgstr ""
18337
18338 # type: textblock
18339 #. type: textblock
18340 #: ../src/guestfs-actions.pod:6268 ../fish/guestfish-actions.pod:4240
18341 msgid ""
18342 "Depending on the guest's shell, this usually results in wildcards being "
18343 "expanded, shell expressions being interpolated and so on."
18344 msgstr ""
18345
18346 # type: textblock
18347 #. type: textblock
18348 #: ../src/guestfs-actions.pod:6272
18349 msgid "All the provisos about C<guestfs_command> apply to this call."
18350 msgstr ""
18351
18352 # type: =head2
18353 #. type: =head2
18354 #: ../src/guestfs-actions.pod:6279
18355 msgid "guestfs_sh_lines"
18356 msgstr ""
18357
18358 # type: verbatim
18359 #. type: verbatim
18360 #: ../src/guestfs-actions.pod:6281
18361 #, no-wrap
18362 msgid ""
18363 " char **\n"
18364 " guestfs_sh_lines (guestfs_h *g,\n"
18365 "                   const char *command);\n"
18366 "\n"
18367 msgstr ""
18368
18369 # type: textblock
18370 #. type: textblock
18371 #: ../src/guestfs-actions.pod:6285
18372 msgid ""
18373 "This is the same as C<guestfs_sh>, but splits the result into a list of "
18374 "lines."
18375 msgstr ""
18376
18377 # type: textblock
18378 #. type: textblock
18379 #: ../src/guestfs-actions.pod:6288
18380 msgid "See also: C<guestfs_command_lines>"
18381 msgstr ""
18382
18383 # type: =head2
18384 #. type: =head2
18385 #: ../src/guestfs-actions.pod:6296
18386 msgid "guestfs_sleep"
18387 msgstr ""
18388
18389 # type: verbatim
18390 #. type: verbatim
18391 #: ../src/guestfs-actions.pod:6298
18392 #, no-wrap
18393 msgid ""
18394 " int\n"
18395 " guestfs_sleep (guestfs_h *g,\n"
18396 "                int secs);\n"
18397 "\n"
18398 msgstr ""
18399
18400 # type: textblock
18401 #. type: textblock
18402 #: ../src/guestfs-actions.pod:6302 ../fish/guestfish-actions.pod:4259
18403 msgid "Sleep for C<secs> seconds."
18404 msgstr ""
18405
18406 # type: textblock
18407 #. type: textblock
18408 #: ../src/guestfs-actions.pod:6306
18409 msgid "(Added in 1.0.41)"
18410 msgstr ""
18411
18412 # type: =head2
18413 #. type: =head2
18414 #: ../src/guestfs-actions.pod:6308 ../src/guestfs-structs.pod:109
18415 msgid "guestfs_stat"
18416 msgstr ""
18417
18418 # type: verbatim
18419 #. type: verbatim
18420 #: ../src/guestfs-actions.pod:6310
18421 #, no-wrap
18422 msgid ""
18423 " struct guestfs_stat *\n"
18424 " guestfs_stat (guestfs_h *g,\n"
18425 "               const char *path);\n"
18426 "\n"
18427 msgstr ""
18428
18429 # type: textblock
18430 #. type: textblock
18431 #: ../src/guestfs-actions.pod:6316 ../fish/guestfish-actions.pod:4267
18432 msgid "This is the same as the C<stat(2)> system call."
18433 msgstr ""
18434
18435 # type: =head2
18436 #. type: =head2
18437 #: ../src/guestfs-actions.pod:6324 ../src/guestfs-structs.pod:135
18438 msgid "guestfs_statvfs"
18439 msgstr ""
18440
18441 # type: verbatim
18442 #. type: verbatim
18443 #: ../src/guestfs-actions.pod:6326
18444 #, no-wrap
18445 msgid ""
18446 " struct guestfs_statvfs *\n"
18447 " guestfs_statvfs (guestfs_h *g,\n"
18448 "                  const char *path);\n"
18449 "\n"
18450 msgstr ""
18451
18452 # type: textblock
18453 #. type: textblock
18454 #: ../src/guestfs-actions.pod:6330 ../fish/guestfish-actions.pod:4273
18455 msgid ""
18456 "Returns file system statistics for any mounted file system.  C<path> should "
18457 "be a file or directory in the mounted file system (typically it is the mount "
18458 "point itself, but it doesn't need to be)."
18459 msgstr ""
18460
18461 # type: textblock
18462 #. type: textblock
18463 #: ../src/guestfs-actions.pod:6334 ../fish/guestfish-actions.pod:4277
18464 msgid "This is the same as the C<statvfs(2)> system call."
18465 msgstr ""
18466
18467 # type: textblock
18468 #. type: textblock
18469 #: ../src/guestfs-actions.pod:6336
18470 msgid ""
18471 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
18472 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
18473 msgstr ""
18474
18475 # type: =head2
18476 #. type: =head2
18477 #: ../src/guestfs-actions.pod:6342
18478 msgid "guestfs_strings"
18479 msgstr ""
18480
18481 # type: verbatim
18482 #. type: verbatim
18483 #: ../src/guestfs-actions.pod:6344
18484 #, no-wrap
18485 msgid ""
18486 " char **\n"
18487 " guestfs_strings (guestfs_h *g,\n"
18488 "                  const char *path);\n"
18489 "\n"
18490 msgstr ""
18491
18492 # type: textblock
18493 #. type: textblock
18494 #: ../src/guestfs-actions.pod:6348 ../fish/guestfish-actions.pod:4283
18495 msgid ""
18496 "This runs the L<strings(1)> command on a file and returns the list of "
18497 "printable strings found."
18498 msgstr ""
18499
18500 # type: =head2
18501 #. type: =head2
18502 #: ../src/guestfs-actions.pod:6360
18503 msgid "guestfs_strings_e"
18504 msgstr ""
18505
18506 # type: verbatim
18507 #. type: verbatim
18508 #: ../src/guestfs-actions.pod:6362
18509 #, no-wrap
18510 msgid ""
18511 " char **\n"
18512 " guestfs_strings_e (guestfs_h *g,\n"
18513 "                    const char *encoding,\n"
18514 "                    const char *path);\n"
18515 "\n"
18516 msgstr ""
18517
18518 # type: textblock
18519 #. type: textblock
18520 #: ../src/guestfs-actions.pod:6367
18521 msgid ""
18522 "This is like the C<guestfs_strings> command, but allows you to specify the "
18523 "encoding of strings that are looked for in the source file C<path>."
18524 msgstr ""
18525
18526 # type: textblock
18527 #. type: textblock
18528 #: ../src/guestfs-actions.pod:6371 ../fish/guestfish-actions.pod:4297
18529 msgid "Allowed encodings are:"
18530 msgstr ""
18531
18532 # type: =item
18533 #. type: =item
18534 #: ../src/guestfs-actions.pod:6375 ../fish/guestfish-actions.pod:4301
18535 msgid "s"
18536 msgstr ""
18537
18538 # type: textblock
18539 #. type: textblock
18540 #: ../src/guestfs-actions.pod:6377
18541 msgid ""
18542 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
18543 "ISO-8859-X (this is what C<guestfs_strings> uses)."
18544 msgstr ""
18545
18546 # type: =item
18547 #. type: =item
18548 #: ../src/guestfs-actions.pod:6380 ../fish/guestfish-actions.pod:4306
18549 msgid "S"
18550 msgstr ""
18551
18552 # type: textblock
18553 #. type: textblock
18554 #: ../src/guestfs-actions.pod:6382 ../fish/guestfish-actions.pod:4308
18555 msgid "Single 8-bit-byte characters."
18556 msgstr ""
18557
18558 # type: =item
18559 #. type: =item
18560 #: ../src/guestfs-actions.pod:6384 ../fish/guestfish-actions.pod:4310
18561 msgid "b"
18562 msgstr ""
18563
18564 # type: textblock
18565 #. type: textblock
18566 #: ../src/guestfs-actions.pod:6386 ../fish/guestfish-actions.pod:4312
18567 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
18568 msgstr ""
18569
18570 # type: =item
18571 #. type: =item
18572 #: ../src/guestfs-actions.pod:6389 ../fish/guestfish-actions.pod:4315
18573 msgid "l (lower case letter L)"
18574 msgstr ""
18575
18576 # type: textblock
18577 #. type: textblock
18578 #: ../src/guestfs-actions.pod:6391 ../fish/guestfish-actions.pod:4317
18579 msgid ""
18580 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
18581 "examining binaries in Windows guests."
18582 msgstr ""
18583
18584 # type: =item
18585 #. type: =item
18586 #: ../src/guestfs-actions.pod:6394 ../fish/guestfish-actions.pod:4320
18587 msgid "B"
18588 msgstr ""
18589
18590 # type: textblock
18591 #. type: textblock
18592 #: ../src/guestfs-actions.pod:6396 ../fish/guestfish-actions.pod:4322
18593 msgid "32-bit big endian such as UCS-4BE."
18594 msgstr ""
18595
18596 # type: =item
18597 #. type: =item
18598 #: ../src/guestfs-actions.pod:6398 ../fish/guestfish-actions.pod:4324
18599 msgid "L"
18600 msgstr ""
18601
18602 # type: textblock
18603 #. type: textblock
18604 #: ../src/guestfs-actions.pod:6400 ../fish/guestfish-actions.pod:4326
18605 msgid "32-bit little endian such as UCS-4LE."
18606 msgstr ""
18607
18608 # type: textblock
18609 #. type: textblock
18610 #: ../src/guestfs-actions.pod:6404 ../fish/guestfish-actions.pod:4330
18611 msgid "The returned strings are transcoded to UTF-8."
18612 msgstr ""
18613
18614 # type: =head2
18615 #. type: =head2
18616 #: ../src/guestfs-actions.pod:6415
18617 msgid "guestfs_swapoff_device"
18618 msgstr ""
18619
18620 # type: verbatim
18621 #. type: verbatim
18622 #: ../src/guestfs-actions.pod:6417
18623 #, no-wrap
18624 msgid ""
18625 " int\n"
18626 " guestfs_swapoff_device (guestfs_h *g,\n"
18627 "                         const char *device);\n"
18628 "\n"
18629 msgstr ""
18630
18631 # type: textblock
18632 #. type: textblock
18633 #: ../src/guestfs-actions.pod:6421
18634 msgid ""
18635 "This command disables the libguestfs appliance swap device or partition "
18636 "named C<device>.  See C<guestfs_swapon_device>."
18637 msgstr ""
18638
18639 # type: =head2
18640 #. type: =head2
18641 #: ../src/guestfs-actions.pod:6429
18642 msgid "guestfs_swapoff_file"
18643 msgstr ""
18644
18645 # type: verbatim
18646 #. type: verbatim
18647 #: ../src/guestfs-actions.pod:6431
18648 #, no-wrap
18649 msgid ""
18650 " int\n"
18651 " guestfs_swapoff_file (guestfs_h *g,\n"
18652 "                       const char *file);\n"
18653 "\n"
18654 msgstr ""
18655
18656 # type: textblock
18657 #. type: textblock
18658 #: ../src/guestfs-actions.pod:6435 ../fish/guestfish-actions.pod:4347
18659 msgid "This command disables the libguestfs appliance swap on file."
18660 msgstr ""
18661
18662 # type: =head2
18663 #. type: =head2
18664 #: ../src/guestfs-actions.pod:6441
18665 msgid "guestfs_swapoff_label"
18666 msgstr ""
18667
18668 # type: verbatim
18669 #. type: verbatim
18670 #: ../src/guestfs-actions.pod:6443
18671 #, no-wrap
18672 msgid ""
18673 " int\n"
18674 " guestfs_swapoff_label (guestfs_h *g,\n"
18675 "                        const char *label);\n"
18676 "\n"
18677 msgstr ""
18678
18679 # type: textblock
18680 #. type: textblock
18681 #: ../src/guestfs-actions.pod:6447 ../fish/guestfish-actions.pod:4353
18682 msgid ""
18683 "This command disables the libguestfs appliance swap on labeled swap "
18684 "partition."
18685 msgstr ""
18686
18687 # type: =head2
18688 #. type: =head2
18689 #: ../src/guestfs-actions.pod:6454
18690 msgid "guestfs_swapoff_uuid"
18691 msgstr ""
18692
18693 # type: verbatim
18694 #. type: verbatim
18695 #: ../src/guestfs-actions.pod:6456
18696 #, no-wrap
18697 msgid ""
18698 " int\n"
18699 " guestfs_swapoff_uuid (guestfs_h *g,\n"
18700 "                       const char *uuid);\n"
18701 "\n"
18702 msgstr ""
18703
18704 # type: textblock
18705 #. type: textblock
18706 #: ../src/guestfs-actions.pod:6460 ../fish/guestfish-actions.pod:4360
18707 msgid ""
18708 "This command disables the libguestfs appliance swap partition with the given "
18709 "UUID."
18710 msgstr ""
18711
18712 # type: =head2
18713 #. type: =head2
18714 #: ../src/guestfs-actions.pod:6467
18715 msgid "guestfs_swapon_device"
18716 msgstr ""
18717
18718 # type: verbatim
18719 #. type: verbatim
18720 #: ../src/guestfs-actions.pod:6469
18721 #, no-wrap
18722 msgid ""
18723 " int\n"
18724 " guestfs_swapon_device (guestfs_h *g,\n"
18725 "                        const char *device);\n"
18726 "\n"
18727 msgstr ""
18728
18729 # type: textblock
18730 #. type: textblock
18731 #: ../src/guestfs-actions.pod:6473
18732 msgid ""
18733 "This command enables the libguestfs appliance to use the swap device or "
18734 "partition named C<device>.  The increased memory is made available for all "
18735 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
18736 msgstr ""
18737
18738 # type: textblock
18739 #. type: textblock
18740 #: ../src/guestfs-actions.pod:6478 ../fish/guestfish-actions.pod:4372
18741 msgid ""
18742 "Note that you should not swap to existing guest swap partitions unless you "
18743 "know what you are doing.  They may contain hibernation information, or other "
18744 "information that the guest doesn't want you to trash.  You also risk leaking "
18745 "information about the host to the guest this way.  Instead, attach a new "
18746 "host device to the guest and swap on that."
18747 msgstr ""
18748
18749 # type: =head2
18750 #. type: =head2
18751 #: ../src/guestfs-actions.pod:6489
18752 msgid "guestfs_swapon_file"
18753 msgstr ""
18754
18755 # type: verbatim
18756 #. type: verbatim
18757 #: ../src/guestfs-actions.pod:6491
18758 #, no-wrap
18759 msgid ""
18760 " int\n"
18761 " guestfs_swapon_file (guestfs_h *g,\n"
18762 "                      const char *file);\n"
18763 "\n"
18764 msgstr ""
18765
18766 # type: textblock
18767 #. type: textblock
18768 #: ../src/guestfs-actions.pod:6495
18769 msgid ""
18770 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
18771 "notes."
18772 msgstr ""
18773
18774 # type: =head2
18775 #. type: =head2
18776 #: ../src/guestfs-actions.pod:6502
18777 msgid "guestfs_swapon_label"
18778 msgstr ""
18779
18780 # type: verbatim
18781 #. type: verbatim
18782 #: ../src/guestfs-actions.pod:6504
18783 #, no-wrap
18784 msgid ""
18785 " int\n"
18786 " guestfs_swapon_label (guestfs_h *g,\n"
18787 "                       const char *label);\n"
18788 "\n"
18789 msgstr ""
18790
18791 # type: textblock
18792 #. type: textblock
18793 #: ../src/guestfs-actions.pod:6508
18794 msgid ""
18795 "This command enables swap to a labeled swap partition.  See "
18796 "C<guestfs_swapon_device> for other notes."
18797 msgstr ""
18798
18799 # type: =head2
18800 #. type: =head2
18801 #: ../src/guestfs-actions.pod:6515
18802 msgid "guestfs_swapon_uuid"
18803 msgstr ""
18804
18805 # type: verbatim
18806 #. type: verbatim
18807 #: ../src/guestfs-actions.pod:6517
18808 #, no-wrap
18809 msgid ""
18810 " int\n"
18811 " guestfs_swapon_uuid (guestfs_h *g,\n"
18812 "                      const char *uuid);\n"
18813 "\n"
18814 msgstr ""
18815
18816 # type: textblock
18817 #. type: textblock
18818 #: ../src/guestfs-actions.pod:6521
18819 msgid ""
18820 "This command enables swap to a swap partition with the given UUID.  See "
18821 "C<guestfs_swapon_device> for other notes."
18822 msgstr ""
18823
18824 # type: =head2
18825 #. type: =head2
18826 #: ../src/guestfs-actions.pod:6528
18827 msgid "guestfs_sync"
18828 msgstr ""
18829
18830 # type: verbatim
18831 #. type: verbatim
18832 #: ../src/guestfs-actions.pod:6530
18833 #, no-wrap
18834 msgid ""
18835 " int\n"
18836 " guestfs_sync (guestfs_h *g);\n"
18837 "\n"
18838 msgstr ""
18839
18840 # type: textblock
18841 #. type: textblock
18842 #: ../src/guestfs-actions.pod:6533 ../fish/guestfish-actions.pod:4404
18843 msgid ""
18844 "This syncs the disk, so that any writes are flushed through to the "
18845 "underlying disk image."
18846 msgstr ""
18847
18848 # type: textblock
18849 #. type: textblock
18850 #: ../src/guestfs-actions.pod:6536 ../fish/guestfish-actions.pod:4407
18851 msgid ""
18852 "You should always call this if you have modified a disk image, before "
18853 "closing the handle."
18854 msgstr ""
18855
18856 # type: =head2
18857 #. type: =head2
18858 #: ../src/guestfs-actions.pod:6543
18859 msgid "guestfs_tail"
18860 msgstr ""
18861
18862 # type: verbatim
18863 #. type: verbatim
18864 #: ../src/guestfs-actions.pod:6545
18865 #, no-wrap
18866 msgid ""
18867 " char **\n"
18868 " guestfs_tail (guestfs_h *g,\n"
18869 "               const char *path);\n"
18870 "\n"
18871 msgstr ""
18872
18873 # type: textblock
18874 #. type: textblock
18875 #: ../src/guestfs-actions.pod:6549 ../fish/guestfish-actions.pod:4414
18876 msgid ""
18877 "This command returns up to the last 10 lines of a file as a list of strings."
18878 msgstr ""
18879
18880 # type: =head2
18881 #. type: =head2
18882 #: ../src/guestfs-actions.pod:6561
18883 msgid "guestfs_tail_n"
18884 msgstr ""
18885
18886 # type: verbatim
18887 #. type: verbatim
18888 #: ../src/guestfs-actions.pod:6563
18889 #, no-wrap
18890 msgid ""
18891 " char **\n"
18892 " guestfs_tail_n (guestfs_h *g,\n"
18893 "                 int nrlines,\n"
18894 "                 const char *path);\n"
18895 "\n"
18896 msgstr ""
18897
18898 # type: textblock
18899 #. type: textblock
18900 #: ../src/guestfs-actions.pod:6568 ../fish/guestfish-actions.pod:4424
18901 msgid ""
18902 "If the parameter C<nrlines> is a positive number, this returns the last "
18903 "C<nrlines> lines of the file C<path>."
18904 msgstr ""
18905
18906 # type: textblock
18907 #. type: textblock
18908 #: ../src/guestfs-actions.pod:6571 ../fish/guestfish-actions.pod:4427
18909 msgid ""
18910 "If the parameter C<nrlines> is a negative number, this returns lines from "
18911 "the file C<path>, starting with the C<-nrlines>th line."
18912 msgstr ""
18913
18914 # type: =head2
18915 #. type: =head2
18916 #: ../src/guestfs-actions.pod:6585
18917 msgid "guestfs_tar_in"
18918 msgstr ""
18919
18920 # type: verbatim
18921 #. type: verbatim
18922 #: ../src/guestfs-actions.pod:6587
18923 #, no-wrap
18924 msgid ""
18925 " int\n"
18926 " guestfs_tar_in (guestfs_h *g,\n"
18927 "                 const char *tarfile,\n"
18928 "                 const char *directory);\n"
18929 "\n"
18930 msgstr ""
18931
18932 # type: textblock
18933 #. type: textblock
18934 #: ../src/guestfs-actions.pod:6592 ../fish/guestfish-actions.pod:4439
18935 msgid ""
18936 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
18937 "tar file) into C<directory>."
18938 msgstr ""
18939
18940 # type: textblock
18941 #. type: textblock
18942 #: ../src/guestfs-actions.pod:6595
18943 msgid ""
18944 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
18945 msgstr ""
18946
18947 # type: textblock
18948 #. type: textblock
18949 #: ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:6617
18950 #: ../src/guestfs-actions.pod:6633 ../src/guestfs-actions.pod:6649
18951 msgid "(Added in 1.0.3)"
18952 msgstr ""
18953
18954 # type: =head2
18955 #. type: =head2
18956 #: ../src/guestfs-actions.pod:6602
18957 msgid "guestfs_tar_out"
18958 msgstr ""
18959
18960 # type: verbatim
18961 #. type: verbatim
18962 #: ../src/guestfs-actions.pod:6604
18963 #, no-wrap
18964 msgid ""
18965 " int\n"
18966 " guestfs_tar_out (guestfs_h *g,\n"
18967 "                  const char *directory,\n"
18968 "                  const char *tarfile);\n"
18969 "\n"
18970 msgstr ""
18971
18972 # type: textblock
18973 #. type: textblock
18974 #: ../src/guestfs-actions.pod:6609 ../fish/guestfish-actions.pod:4451
18975 msgid ""
18976 "This command packs the contents of C<directory> and downloads it to local "
18977 "file C<tarfile>."
18978 msgstr ""
18979
18980 # type: textblock
18981 #. type: textblock
18982 #: ../src/guestfs-actions.pod:6612
18983 msgid ""
18984 "To download a compressed tarball, use C<guestfs_tgz_out> or "
18985 "C<guestfs_txz_out>."
18986 msgstr ""
18987
18988 # type: =head2
18989 #. type: =head2
18990 #: ../src/guestfs-actions.pod:6619
18991 msgid "guestfs_tgz_in"
18992 msgstr ""
18993
18994 # type: verbatim
18995 #. type: verbatim
18996 #: ../src/guestfs-actions.pod:6621
18997 #, no-wrap
18998 msgid ""
18999 " int\n"
19000 " guestfs_tgz_in (guestfs_h *g,\n"
19001 "                 const char *tarball,\n"
19002 "                 const char *directory);\n"
19003 "\n"
19004 msgstr ""
19005
19006 # type: textblock
19007 #. type: textblock
19008 #: ../src/guestfs-actions.pod:6626 ../fish/guestfish-actions.pod:4463
19009 msgid ""
19010 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
19011 "tar file) into C<directory>."
19012 msgstr ""
19013
19014 # type: textblock
19015 #. type: textblock
19016 #: ../src/guestfs-actions.pod:6629
19017 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
19018 msgstr ""
19019
19020 # type: =head2
19021 #. type: =head2
19022 #: ../src/guestfs-actions.pod:6635
19023 msgid "guestfs_tgz_out"
19024 msgstr ""
19025
19026 # type: verbatim
19027 #. type: verbatim
19028 #: ../src/guestfs-actions.pod:6637
19029 #, no-wrap
19030 msgid ""
19031 " int\n"
19032 " guestfs_tgz_out (guestfs_h *g,\n"
19033 "                  const char *directory,\n"
19034 "                  const char *tarball);\n"
19035 "\n"
19036 msgstr ""
19037
19038 # type: textblock
19039 #. type: textblock
19040 #: ../src/guestfs-actions.pod:6642 ../fish/guestfish-actions.pod:4474
19041 msgid ""
19042 "This command packs the contents of C<directory> and downloads it to local "
19043 "file C<tarball>."
19044 msgstr ""
19045
19046 # type: textblock
19047 #. type: textblock
19048 #: ../src/guestfs-actions.pod:6645
19049 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
19050 msgstr ""
19051
19052 # type: =head2
19053 #. type: =head2
19054 #: ../src/guestfs-actions.pod:6651
19055 msgid "guestfs_touch"
19056 msgstr ""
19057
19058 # type: verbatim
19059 #. type: verbatim
19060 #: ../src/guestfs-actions.pod:6653
19061 #, no-wrap
19062 msgid ""
19063 " int\n"
19064 " guestfs_touch (guestfs_h *g,\n"
19065 "                const char *path);\n"
19066 "\n"
19067 msgstr ""
19068
19069 # type: textblock
19070 #. type: textblock
19071 #: ../src/guestfs-actions.pod:6657 ../fish/guestfish-actions.pod:4485
19072 msgid ""
19073 "Touch acts like the L<touch(1)> command.  It can be used to update the "
19074 "timestamps on a file, or, if the file does not exist, to create a new zero-"
19075 "length file."
19076 msgstr ""
19077
19078 # type: textblock
19079 #. type: textblock
19080 #: ../src/guestfs-actions.pod:6661 ../fish/guestfish-actions.pod:4489
19081 msgid ""
19082 "This command only works on regular files, and will fail on other file types "
19083 "such as directories, symbolic links, block special etc."
19084 msgstr ""
19085
19086 # type: =head2
19087 #. type: =head2
19088 #: ../src/guestfs-actions.pod:6668
19089 msgid "guestfs_truncate"
19090 msgstr ""
19091
19092 # type: verbatim
19093 #. type: verbatim
19094 #: ../src/guestfs-actions.pod:6670
19095 #, no-wrap
19096 msgid ""
19097 " int\n"
19098 " guestfs_truncate (guestfs_h *g,\n"
19099 "                   const char *path);\n"
19100 "\n"
19101 msgstr ""
19102
19103 # type: textblock
19104 #. type: textblock
19105 #: ../src/guestfs-actions.pod:6674 ../fish/guestfish-actions.pod:4496
19106 msgid ""
19107 "This command truncates C<path> to a zero-length file.  The file must exist "
19108 "already."
19109 msgstr ""
19110
19111 # type: =head2
19112 #. type: =head2
19113 #: ../src/guestfs-actions.pod:6681
19114 msgid "guestfs_truncate_size"
19115 msgstr ""
19116
19117 # type: verbatim
19118 #. type: verbatim
19119 #: ../src/guestfs-actions.pod:6683
19120 #, no-wrap
19121 msgid ""
19122 " int\n"
19123 " guestfs_truncate_size (guestfs_h *g,\n"
19124 "                        const char *path,\n"
19125 "                        int64_t size);\n"
19126 "\n"
19127 msgstr ""
19128
19129 # type: textblock
19130 #. type: textblock
19131 #: ../src/guestfs-actions.pod:6688 ../fish/guestfish-actions.pod:4503
19132 msgid ""
19133 "This command truncates C<path> to size C<size> bytes.  The file must exist "
19134 "already."
19135 msgstr ""
19136
19137 # type: textblock
19138 #. type: textblock
19139 #: ../src/guestfs-actions.pod:6691
19140 msgid ""
19141 "If the current file size is less than C<size> then the file is extended to "
19142 "the required size with zero bytes.  This creates a sparse file (ie. disk "
19143 "blocks are not allocated for the file until you write to it).  To create a "
19144 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
19145 msgstr ""
19146
19147 # type: =head2
19148 #. type: =head2
19149 #: ../src/guestfs-actions.pod:6701
19150 msgid "guestfs_tune2fs_l"
19151 msgstr ""
19152
19153 # type: verbatim
19154 #. type: verbatim
19155 #: ../src/guestfs-actions.pod:6703
19156 #, no-wrap
19157 msgid ""
19158 " char **\n"
19159 " guestfs_tune2fs_l (guestfs_h *g,\n"
19160 "                    const char *device);\n"
19161 "\n"
19162 msgstr ""
19163
19164 # type: textblock
19165 #. type: textblock
19166 #: ../src/guestfs-actions.pod:6707 ../fish/guestfish-actions.pod:4516
19167 msgid ""
19168 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
19169 "C<device>."
19170 msgstr ""
19171
19172 # type: textblock
19173 #. type: textblock
19174 #: ../src/guestfs-actions.pod:6710 ../fish/guestfish-actions.pod:4519
19175 msgid ""
19176 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
19177 "for more details.  The list of fields returned isn't clearly defined, and "
19178 "depends on both the version of C<tune2fs> that libguestfs was built against, "
19179 "and the filesystem itself."
19180 msgstr ""
19181
19182 # type: =head2
19183 #. type: =head2
19184 #: ../src/guestfs-actions.pod:6723
19185 msgid "guestfs_txz_in"
19186 msgstr ""
19187
19188 # type: verbatim
19189 #. type: verbatim
19190 #: ../src/guestfs-actions.pod:6725
19191 #, no-wrap
19192 msgid ""
19193 " int\n"
19194 " guestfs_txz_in (guestfs_h *g,\n"
19195 "                 const char *tarball,\n"
19196 "                 const char *directory);\n"
19197 "\n"
19198 msgstr ""
19199
19200 # type: textblock
19201 #. type: textblock
19202 #: ../src/guestfs-actions.pod:6730 ../fish/guestfish-actions.pod:4528
19203 msgid ""
19204 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
19205 "tar file) into C<directory>."
19206 msgstr ""
19207
19208 # type: =head2
19209 #. type: =head2
19210 #: ../src/guestfs-actions.pod:6737
19211 msgid "guestfs_txz_out"
19212 msgstr ""
19213
19214 # type: verbatim
19215 #. type: verbatim
19216 #: ../src/guestfs-actions.pod:6739
19217 #, no-wrap
19218 msgid ""
19219 " int\n"
19220 " guestfs_txz_out (guestfs_h *g,\n"
19221 "                  const char *directory,\n"
19222 "                  const char *tarball);\n"
19223 "\n"
19224 msgstr ""
19225
19226 # type: textblock
19227 #. type: textblock
19228 #: ../src/guestfs-actions.pod:6744 ../fish/guestfish-actions.pod:4537
19229 msgid ""
19230 "This command packs the contents of C<directory> and downloads it to local "
19231 "file C<tarball> (as an xz compressed tar archive)."
19232 msgstr ""
19233
19234 # type: =head2
19235 #. type: =head2
19236 #: ../src/guestfs-actions.pod:6751
19237 msgid "guestfs_umask"
19238 msgstr ""
19239
19240 # type: verbatim
19241 #. type: verbatim
19242 #: ../src/guestfs-actions.pod:6753
19243 #, no-wrap
19244 msgid ""
19245 " int\n"
19246 " guestfs_umask (guestfs_h *g,\n"
19247 "                int mask);\n"
19248 "\n"
19249 msgstr ""
19250
19251 # type: textblock
19252 #. type: textblock
19253 #: ../src/guestfs-actions.pod:6757 ../fish/guestfish-actions.pod:4546
19254 msgid ""
19255 "This function sets the mask used for creating new files and device nodes to "
19256 "C<mask & 0777>."
19257 msgstr ""
19258
19259 # type: textblock
19260 #. type: textblock
19261 #: ../src/guestfs-actions.pod:6760 ../fish/guestfish-actions.pod:4549
19262 msgid ""
19263 "Typical umask values would be C<022> which creates new files with "
19264 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
19265 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
19266 msgstr ""
19267
19268 # type: textblock
19269 #. type: textblock
19270 #: ../src/guestfs-actions.pod:6765 ../fish/guestfish-actions.pod:4554
19271 msgid ""
19272 "The default umask is C<022>.  This is important because it means that "
19273 "directories and device nodes will be created with C<0644> or C<0755> mode "
19274 "even if you specify C<0777>."
19275 msgstr ""
19276
19277 # type: textblock
19278 #. type: textblock
19279 #: ../src/guestfs-actions.pod:6769
19280 msgid ""
19281 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
19282 "C<guestfs_mkdir>."
19283 msgstr ""
19284
19285 # type: textblock
19286 #. type: textblock
19287 #: ../src/guestfs-actions.pod:6772 ../fish/guestfish-actions.pod:4561
19288 msgid "This call returns the previous umask."
19289 msgstr ""
19290
19291 # type: =head2
19292 #. type: =head2
19293 #: ../src/guestfs-actions.pod:6778
19294 msgid "guestfs_umount"
19295 msgstr ""
19296
19297 # type: verbatim
19298 #. type: verbatim
19299 #: ../src/guestfs-actions.pod:6780
19300 #, no-wrap
19301 msgid ""
19302 " int\n"
19303 " guestfs_umount (guestfs_h *g,\n"
19304 "                 const char *pathordevice);\n"
19305 "\n"
19306 msgstr ""
19307
19308 # type: textblock
19309 #. type: textblock
19310 #: ../src/guestfs-actions.pod:6784 ../fish/guestfish-actions.pod:4569
19311 msgid ""
19312 "This unmounts the given filesystem.  The filesystem may be specified either "
19313 "by its mountpoint (path) or the device which contains the filesystem."
19314 msgstr ""
19315
19316 # type: =head2
19317 #. type: =head2
19318 #: ../src/guestfs-actions.pod:6792
19319 msgid "guestfs_umount_all"
19320 msgstr ""
19321
19322 # type: verbatim
19323 #. type: verbatim
19324 #: ../src/guestfs-actions.pod:6794
19325 #, no-wrap
19326 msgid ""
19327 " int\n"
19328 " guestfs_umount_all (guestfs_h *g);\n"
19329 "\n"
19330 msgstr ""
19331
19332 # type: textblock
19333 #. type: textblock
19334 #: ../src/guestfs-actions.pod:6797 ../fish/guestfish-actions.pod:4579
19335 msgid "This unmounts all mounted filesystems."
19336 msgstr ""
19337
19338 # type: textblock
19339 #. type: textblock
19340 #: ../src/guestfs-actions.pod:6799 ../fish/guestfish-actions.pod:4581
19341 msgid "Some internal mounts are not unmounted by this call."
19342 msgstr ""
19343
19344 # type: =head2
19345 #. type: =head2
19346 #: ../src/guestfs-actions.pod:6805
19347 msgid "guestfs_upload"
19348 msgstr ""
19349
19350 # type: verbatim
19351 #. type: verbatim
19352 #: ../src/guestfs-actions.pod:6807
19353 #, no-wrap
19354 msgid ""
19355 " int\n"
19356 " guestfs_upload (guestfs_h *g,\n"
19357 "                 const char *filename,\n"
19358 "                 const char *remotefilename);\n"
19359 "\n"
19360 msgstr ""
19361
19362 # type: textblock
19363 #. type: textblock
19364 #: ../src/guestfs-actions.pod:6812 ../src/guestfs-actions.pod:6836
19365 #: ../fish/guestfish-actions.pod:4587 ../fish/guestfish-actions.pod:4600
19366 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
19367 msgstr ""
19368
19369 # type: textblock
19370 #. type: textblock
19371 #: ../src/guestfs-actions.pod:6817
19372 msgid "See also C<guestfs_download>."
19373 msgstr ""
19374
19375 # type: =head2
19376 #. type: =head2
19377 #: ../src/guestfs-actions.pod:6828
19378 msgid "guestfs_upload_offset"
19379 msgstr ""
19380
19381 # type: verbatim
19382 #. type: verbatim
19383 #: ../src/guestfs-actions.pod:6830
19384 #, no-wrap
19385 msgid ""
19386 " int\n"
19387 " guestfs_upload_offset (guestfs_h *g,\n"
19388 "                        const char *filename,\n"
19389 "                        const char *remotefilename,\n"
19390 "                        int64_t offset);\n"
19391 "\n"
19392 msgstr ""
19393
19394 # type: textblock
19395 #. type: textblock
19396 #: ../src/guestfs-actions.pod:6839 ../fish/guestfish-actions.pod:4603
19397 msgid ""
19398 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
19399 "The intention is to overwrite parts of existing files or devices, although "
19400 "if a non-existant file is specified then it is created with a \"hole\" "
19401 "before C<offset>.  The size of the data written is implicit in the size of "
19402 "the source C<filename>."
19403 msgstr ""
19404
19405 # type: textblock
19406 #. type: textblock
19407 #: ../src/guestfs-actions.pod:6846
19408 msgid ""
19409 "Note that there is no limit on the amount of data that can be uploaded with "
19410 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
19411 "full amount unless an error occurs."
19412 msgstr ""
19413
19414 # type: textblock
19415 #. type: textblock
19416 #: ../src/guestfs-actions.pod:6851
19417 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
19418 msgstr ""
19419
19420 # type: =head2
19421 #. type: =head2
19422 #: ../src/guestfs-actions.pod:6862
19423 msgid "guestfs_utimens"
19424 msgstr ""
19425
19426 # type: verbatim
19427 #. type: verbatim
19428 #: ../src/guestfs-actions.pod:6864
19429 #, no-wrap
19430 msgid ""
19431 " int\n"
19432 " guestfs_utimens (guestfs_h *g,\n"
19433 "                  const char *path,\n"
19434 "                  int64_t atsecs,\n"
19435 "                  int64_t atnsecs,\n"
19436 "                  int64_t mtsecs,\n"
19437 "                  int64_t mtnsecs);\n"
19438 "\n"
19439 msgstr ""
19440
19441 # type: textblock
19442 #. type: textblock
19443 #: ../src/guestfs-actions.pod:6872 ../fish/guestfish-actions.pod:4623
19444 msgid "This command sets the timestamps of a file with nanosecond precision."
19445 msgstr ""
19446
19447 # type: textblock
19448 #. type: textblock
19449 #: ../src/guestfs-actions.pod:6875 ../fish/guestfish-actions.pod:4626
19450 msgid ""
19451 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
19452 "from the epoch."
19453 msgstr ""
19454
19455 # type: textblock
19456 #. type: textblock
19457 #: ../src/guestfs-actions.pod:6878 ../fish/guestfish-actions.pod:4629
19458 msgid ""
19459 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
19460 "nanoseconds from the epoch."
19461 msgstr ""
19462
19463 # type: textblock
19464 #. type: textblock
19465 #: ../src/guestfs-actions.pod:6881 ../fish/guestfish-actions.pod:4632
19466 msgid ""
19467 "If the C<*nsecs> field contains the special value C<-1> then the "
19468 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
19469 "ignored in this case)."
19470 msgstr ""
19471
19472 # type: textblock
19473 #. type: textblock
19474 #: ../src/guestfs-actions.pod:6885 ../fish/guestfish-actions.pod:4636
19475 msgid ""
19476 "If the C<*nsecs> field contains the special value C<-2> then the "
19477 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
19478 "in this case)."
19479 msgstr ""
19480
19481 # type: =head2
19482 #. type: =head2
19483 #: ../src/guestfs-actions.pod:6893 ../src/guestfs-structs.pod:175
19484 msgid "guestfs_version"
19485 msgstr ""
19486
19487 # type: verbatim
19488 #. type: verbatim
19489 #: ../src/guestfs-actions.pod:6895
19490 #, no-wrap
19491 msgid ""
19492 " struct guestfs_version *\n"
19493 " guestfs_version (guestfs_h *g);\n"
19494 "\n"
19495 msgstr ""
19496
19497 # type: textblock
19498 #. type: textblock
19499 #: ../src/guestfs-actions.pod:6898 ../fish/guestfish-actions.pod:4644
19500 msgid ""
19501 "Return the libguestfs version number that the program is linked against."
19502 msgstr ""
19503
19504 # type: textblock
19505 #. type: textblock
19506 #: ../src/guestfs-actions.pod:6901 ../fish/guestfish-actions.pod:4647
19507 msgid ""
19508 "Note that because of dynamic linking this is not necessarily the version of "
19509 "libguestfs that you compiled against.  You can compile the program, and then "
19510 "at runtime dynamically link against a completely different C<libguestfs.so> "
19511 "library."
19512 msgstr ""
19513
19514 # type: textblock
19515 #. type: textblock
19516 #: ../src/guestfs-actions.pod:6906 ../fish/guestfish-actions.pod:4652
19517 msgid ""
19518 "This call was added in version C<1.0.58>.  In previous versions of "
19519 "libguestfs there was no way to get the version number.  From C code you can "
19520 "use dynamic linker functions to find out if this symbol exists (if it "
19521 "doesn't, then it's an earlier version)."
19522 msgstr ""
19523
19524 # type: textblock
19525 #. type: textblock
19526 #: ../src/guestfs-actions.pod:6912 ../fish/guestfish-actions.pod:4658
19527 msgid ""
19528 "The call returns a structure with four elements.  The first three (C<major>, "
19529 "C<minor> and C<release>) are numbers and correspond to the usual version "
19530 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
19531 "but may be used for distro-specific information."
19532 msgstr ""
19533
19534 # type: textblock
19535 #. type: textblock
19536 #: ../src/guestfs-actions.pod:6918 ../fish/guestfish-actions.pod:4664
19537 msgid ""
19538 "To construct the original version string: C<$major.$minor.$release$extra>"
19539 msgstr ""
19540
19541 # type: textblock
19542 #. type: textblock
19543 #: ../src/guestfs-actions.pod:6921 ../fish/guestfish-actions.pod:4667
19544 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
19545 msgstr ""
19546
19547 # type: textblock
19548 #. type: textblock
19549 #: ../src/guestfs-actions.pod:6923
19550 msgid ""
19551 "I<Note:> Don't use this call to test for availability of features.  In "
19552 "enterprise distributions we backport features from later versions into "
19553 "earlier versions, making this an unreliable way to test for features.  Use "
19554 "C<guestfs_available> instead."
19555 msgstr ""
19556
19557 # type: textblock
19558 #. type: textblock
19559 #: ../src/guestfs-actions.pod:6929
19560 msgid ""
19561 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
19562 "error.  I<The caller must call C<guestfs_free_version> after use>."
19563 msgstr ""
19564
19565 # type: textblock
19566 #. type: textblock
19567 #: ../src/guestfs-actions.pod:6933
19568 msgid "(Added in 1.0.58)"
19569 msgstr ""
19570
19571 # type: =head2
19572 #. type: =head2
19573 #: ../src/guestfs-actions.pod:6935
19574 msgid "guestfs_vfs_label"
19575 msgstr ""
19576
19577 # type: verbatim
19578 #. type: verbatim
19579 #: ../src/guestfs-actions.pod:6937
19580 #, no-wrap
19581 msgid ""
19582 " char *\n"
19583 " guestfs_vfs_label (guestfs_h *g,\n"
19584 "                    const char *device);\n"
19585 "\n"
19586 msgstr ""
19587
19588 # type: textblock
19589 #. type: textblock
19590 #: ../src/guestfs-actions.pod:6941 ../fish/guestfish-actions.pod:4679
19591 msgid "This returns the filesystem label of the filesystem on C<device>."
19592 msgstr ""
19593
19594 # type: textblock
19595 #. type: textblock
19596 #: ../src/guestfs-actions.pod:6944 ../fish/guestfish-actions.pod:4682
19597 msgid "If the filesystem is unlabeled, this returns the empty string."
19598 msgstr ""
19599
19600 # type: textblock
19601 #. type: textblock
19602 #: ../src/guestfs-actions.pod:6946
19603 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
19604 msgstr ""
19605
19606 # type: textblock
19607 #. type: textblock
19608 #: ../src/guestfs-actions.pod:6951 ../src/guestfs-actions.pod:6988
19609 msgid "(Added in 1.3.18)"
19610 msgstr ""
19611
19612 # type: =head2
19613 #. type: =head2
19614 #: ../src/guestfs-actions.pod:6953
19615 msgid "guestfs_vfs_type"
19616 msgstr ""
19617
19618 # type: verbatim
19619 #. type: verbatim
19620 #: ../src/guestfs-actions.pod:6955
19621 #, no-wrap
19622 msgid ""
19623 " char *\n"
19624 " guestfs_vfs_type (guestfs_h *g,\n"
19625 "                   const char *device);\n"
19626 "\n"
19627 msgstr ""
19628
19629 # type: textblock
19630 #. type: textblock
19631 #: ../src/guestfs-actions.pod:6959 ../fish/guestfish-actions.pod:4690
19632 msgid ""
19633 "This command gets the filesystem type corresponding to the filesystem on "
19634 "C<device>."
19635 msgstr ""
19636
19637 # type: textblock
19638 #. type: textblock
19639 #: ../src/guestfs-actions.pod:6962 ../fish/guestfish-actions.pod:4693
19640 msgid ""
19641 "For most filesystems, the result is the name of the Linux VFS module which "
19642 "would be used to mount this filesystem if you mounted it without specifying "
19643 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
19644 msgstr ""
19645
19646 # type: =head2
19647 #. type: =head2
19648 #: ../src/guestfs-actions.pod:6972
19649 msgid "guestfs_vfs_uuid"
19650 msgstr ""
19651
19652 # type: verbatim
19653 #. type: verbatim
19654 #: ../src/guestfs-actions.pod:6974
19655 #, no-wrap
19656 msgid ""
19657 " char *\n"
19658 " guestfs_vfs_uuid (guestfs_h *g,\n"
19659 "                   const char *device);\n"
19660 "\n"
19661 msgstr ""
19662
19663 # type: textblock
19664 #. type: textblock
19665 #: ../src/guestfs-actions.pod:6978 ../fish/guestfish-actions.pod:4702
19666 msgid "This returns the filesystem UUID of the filesystem on C<device>."
19667 msgstr ""
19668
19669 # type: textblock
19670 #. type: textblock
19671 #: ../src/guestfs-actions.pod:6981 ../fish/guestfish-actions.pod:4705
19672 msgid "If the filesystem does not have a UUID, this returns the empty string."
19673 msgstr ""
19674
19675 # type: textblock
19676 #. type: textblock
19677 #: ../src/guestfs-actions.pod:6983
19678 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
19679 msgstr ""
19680
19681 # type: =head2
19682 #. type: =head2
19683 #: ../src/guestfs-actions.pod:6990
19684 msgid "guestfs_vg_activate"
19685 msgstr ""
19686
19687 # type: verbatim
19688 #. type: verbatim
19689 #: ../src/guestfs-actions.pod:6992
19690 #, no-wrap
19691 msgid ""
19692 " int\n"
19693 " guestfs_vg_activate (guestfs_h *g,\n"
19694 "                      int activate,\n"
19695 "                      char *const *volgroups);\n"
19696 "\n"
19697 msgstr ""
19698
19699 # type: textblock
19700 #. type: textblock
19701 #: ../src/guestfs-actions.pod:6997 ../fish/guestfish-actions.pod:4713
19702 msgid ""
19703 "This command activates or (if C<activate> is false) deactivates all logical "
19704 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
19705 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
19706 "deactivated, then those devices disappear."
19707 msgstr ""
19708
19709 # type: textblock
19710 #. type: textblock
19711 #: ../src/guestfs-actions.pod:7003 ../fish/guestfish-actions.pod:4719
19712 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
19713 msgstr ""
19714
19715 # type: textblock
19716 #. type: textblock
19717 #: ../src/guestfs-actions.pod:7005 ../fish/guestfish-actions.pod:4721
19718 msgid ""
19719 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
19720 "activated or deactivated."
19721 msgstr ""
19722
19723 # type: =head2
19724 #. type: =head2
19725 #: ../src/guestfs-actions.pod:7012
19726 msgid "guestfs_vg_activate_all"
19727 msgstr ""
19728
19729 # type: verbatim
19730 #. type: verbatim
19731 #: ../src/guestfs-actions.pod:7014
19732 #, no-wrap
19733 msgid ""
19734 " int\n"
19735 " guestfs_vg_activate_all (guestfs_h *g,\n"
19736 "                          int activate);\n"
19737 "\n"
19738 msgstr ""
19739
19740 # type: textblock
19741 #. type: textblock
19742 #: ../src/guestfs-actions.pod:7018 ../fish/guestfish-actions.pod:4728
19743 msgid ""
19744 "This command activates or (if C<activate> is false) deactivates all logical "
19745 "volumes in all volume groups.  If activated, then they are made known to the "
19746 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
19747 "those devices disappear."
19748 msgstr ""
19749
19750 # type: textblock
19751 #. type: textblock
19752 #: ../src/guestfs-actions.pod:7024 ../fish/guestfish-actions.pod:4734
19753 msgid "This command is the same as running C<vgchange -a y|n>"
19754 msgstr ""
19755
19756 # type: =head2
19757 #. type: =head2
19758 #: ../src/guestfs-actions.pod:7030
19759 msgid "guestfs_vgcreate"
19760 msgstr ""
19761
19762 # type: verbatim
19763 #. type: verbatim
19764 #: ../src/guestfs-actions.pod:7032
19765 #, no-wrap
19766 msgid ""
19767 " int\n"
19768 " guestfs_vgcreate (guestfs_h *g,\n"
19769 "                   const char *volgroup,\n"
19770 "                   char *const *physvols);\n"
19771 "\n"
19772 msgstr ""
19773
19774 # type: textblock
19775 #. type: textblock
19776 #: ../src/guestfs-actions.pod:7037 ../fish/guestfish-actions.pod:4740
19777 msgid ""
19778 "This creates an LVM volume group called C<volgroup> from the non-empty list "
19779 "of physical volumes C<physvols>."
19780 msgstr ""
19781
19782 # type: =head2
19783 #. type: =head2
19784 #: ../src/guestfs-actions.pod:7044
19785 msgid "guestfs_vglvuuids"
19786 msgstr ""
19787
19788 # type: verbatim
19789 #. type: verbatim
19790 #: ../src/guestfs-actions.pod:7046
19791 #, no-wrap
19792 msgid ""
19793 " char **\n"
19794 " guestfs_vglvuuids (guestfs_h *g,\n"
19795 "                    const char *vgname);\n"
19796 "\n"
19797 msgstr ""
19798
19799 # type: textblock
19800 #. type: textblock
19801 #: ../src/guestfs-actions.pod:7050 ../fish/guestfish-actions.pod:4747
19802 msgid ""
19803 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
19804 "volumes created in this volume group."
19805 msgstr ""
19806
19807 # type: textblock
19808 #. type: textblock
19809 #: ../src/guestfs-actions.pod:7053
19810 msgid ""
19811 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
19812 "associate logical volumes and volume groups."
19813 msgstr ""
19814
19815 # type: textblock
19816 #. type: textblock
19817 #: ../src/guestfs-actions.pod:7056
19818 msgid "See also C<guestfs_vgpvuuids>."
19819 msgstr ""
19820
19821 # type: =head2
19822 #. type: =head2
19823 #: ../src/guestfs-actions.pod:7064
19824 msgid "guestfs_vgpvuuids"
19825 msgstr ""
19826
19827 # type: verbatim
19828 #. type: verbatim
19829 #: ../src/guestfs-actions.pod:7066
19830 #, no-wrap
19831 msgid ""
19832 " char **\n"
19833 " guestfs_vgpvuuids (guestfs_h *g,\n"
19834 "                    const char *vgname);\n"
19835 "\n"
19836 msgstr ""
19837
19838 # type: textblock
19839 #. type: textblock
19840 #: ../src/guestfs-actions.pod:7070 ../fish/guestfish-actions.pod:4759
19841 msgid ""
19842 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
19843 "volumes that this volume group resides on."
19844 msgstr ""
19845
19846 # type: textblock
19847 #. type: textblock
19848 #: ../src/guestfs-actions.pod:7073
19849 msgid ""
19850 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
19851 "associate physical volumes and volume groups."
19852 msgstr ""
19853
19854 # type: textblock
19855 #. type: textblock
19856 #: ../src/guestfs-actions.pod:7076
19857 msgid "See also C<guestfs_vglvuuids>."
19858 msgstr ""
19859
19860 # type: =head2
19861 #. type: =head2
19862 #: ../src/guestfs-actions.pod:7084
19863 msgid "guestfs_vgremove"
19864 msgstr ""
19865
19866 # type: verbatim
19867 #. type: verbatim
19868 #: ../src/guestfs-actions.pod:7086
19869 #, no-wrap
19870 msgid ""
19871 " int\n"
19872 " guestfs_vgremove (guestfs_h *g,\n"
19873 "                   const char *vgname);\n"
19874 "\n"
19875 msgstr ""
19876
19877 # type: textblock
19878 #. type: textblock
19879 #: ../src/guestfs-actions.pod:7090 ../fish/guestfish-actions.pod:4771
19880 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
19881 msgstr ""
19882
19883 # type: textblock
19884 #. type: textblock
19885 #: ../src/guestfs-actions.pod:7092 ../fish/guestfish-actions.pod:4773
19886 msgid ""
19887 "This also forcibly removes all logical volumes in the volume group (if any)."
19888 msgstr ""
19889
19890 # type: =head2
19891 #. type: =head2
19892 #: ../src/guestfs-actions.pod:7099
19893 msgid "guestfs_vgrename"
19894 msgstr ""
19895
19896 # type: verbatim
19897 #. type: verbatim
19898 #: ../src/guestfs-actions.pod:7101
19899 #, no-wrap
19900 msgid ""
19901 " int\n"
19902 " guestfs_vgrename (guestfs_h *g,\n"
19903 "                   const char *volgroup,\n"
19904 "                   const char *newvolgroup);\n"
19905 "\n"
19906 msgstr ""
19907
19908 # type: textblock
19909 #. type: textblock
19910 #: ../src/guestfs-actions.pod:7106 ../fish/guestfish-actions.pod:4780
19911 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
19912 msgstr ""
19913
19914 # type: =head2
19915 #. type: =head2
19916 #: ../src/guestfs-actions.pod:7112
19917 msgid "guestfs_vgs"
19918 msgstr ""
19919
19920 # type: verbatim
19921 #. type: verbatim
19922 #: ../src/guestfs-actions.pod:7114
19923 #, no-wrap
19924 msgid ""
19925 " char **\n"
19926 " guestfs_vgs (guestfs_h *g);\n"
19927 "\n"
19928 msgstr ""
19929
19930 # type: textblock
19931 #. type: textblock
19932 #: ../src/guestfs-actions.pod:7117 ../fish/guestfish-actions.pod:4786
19933 msgid ""
19934 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
19935 "> command."
19936 msgstr ""
19937
19938 # type: textblock
19939 #. type: textblock
19940 #: ../src/guestfs-actions.pod:7120 ../fish/guestfish-actions.pod:4789
19941 msgid ""
19942 "This returns a list of just the volume group names that were detected (eg. "
19943 "C<VolGroup00>)."
19944 msgstr ""
19945
19946 # type: textblock
19947 #. type: textblock
19948 #: ../src/guestfs-actions.pod:7123
19949 msgid "See also C<guestfs_vgs_full>."
19950 msgstr ""
19951
19952 # type: =head2
19953 #. type: =head2
19954 #: ../src/guestfs-actions.pod:7131
19955 msgid "guestfs_vgs_full"
19956 msgstr ""
19957
19958 # type: verbatim
19959 #. type: verbatim
19960 #: ../src/guestfs-actions.pod:7133
19961 #, no-wrap
19962 msgid ""
19963 " struct guestfs_lvm_vg_list *\n"
19964 " guestfs_vgs_full (guestfs_h *g);\n"
19965 "\n"
19966 msgstr ""
19967
19968 # type: textblock
19969 #. type: textblock
19970 #: ../src/guestfs-actions.pod:7136 ../fish/guestfish-actions.pod:4798
19971 msgid ""
19972 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
19973 "> command.  The \"full\" version includes all fields."
19974 msgstr ""
19975
19976 # type: textblock
19977 #. type: textblock
19978 #: ../src/guestfs-actions.pod:7139
19979 msgid ""
19980 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
19981 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
19982 msgstr ""
19983
19984 # type: =head2
19985 #. type: =head2
19986 #: ../src/guestfs-actions.pod:7145
19987 msgid "guestfs_vgscan"
19988 msgstr ""
19989
19990 # type: verbatim
19991 #. type: verbatim
19992 #: ../src/guestfs-actions.pod:7147
19993 #, no-wrap
19994 msgid ""
19995 " int\n"
19996 " guestfs_vgscan (guestfs_h *g);\n"
19997 "\n"
19998 msgstr ""
19999
20000 # type: textblock
20001 #. type: textblock
20002 #: ../src/guestfs-actions.pod:7150 ../fish/guestfish-actions.pod:4805
20003 msgid ""
20004 "This rescans all block devices and rebuilds the list of LVM physical "
20005 "volumes, volume groups and logical volumes."
20006 msgstr ""
20007
20008 # type: =head2
20009 #. type: =head2
20010 #: ../src/guestfs-actions.pod:7157
20011 msgid "guestfs_vguuid"
20012 msgstr ""
20013
20014 # type: verbatim
20015 #. type: verbatim
20016 #: ../src/guestfs-actions.pod:7159
20017 #, no-wrap
20018 msgid ""
20019 " char *\n"
20020 " guestfs_vguuid (guestfs_h *g,\n"
20021 "                 const char *vgname);\n"
20022 "\n"
20023 msgstr ""
20024
20025 # type: textblock
20026 #. type: textblock
20027 #: ../src/guestfs-actions.pod:7163 ../fish/guestfish-actions.pod:4812
20028 msgid "This command returns the UUID of the LVM VG named C<vgname>."
20029 msgstr ""
20030
20031 # type: =head2
20032 #. type: =head2
20033 #: ../src/guestfs-actions.pod:7170
20034 msgid "guestfs_wait_ready"
20035 msgstr ""
20036
20037 # type: verbatim
20038 #. type: verbatim
20039 #: ../src/guestfs-actions.pod:7172
20040 #, no-wrap
20041 msgid ""
20042 " int\n"
20043 " guestfs_wait_ready (guestfs_h *g);\n"
20044 "\n"
20045 msgstr ""
20046
20047 # type: textblock
20048 #. type: textblock
20049 #: ../src/guestfs-actions.pod:7175
20050 msgid "This function is a no op."
20051 msgstr ""
20052
20053 # type: textblock
20054 #. type: textblock
20055 #: ../src/guestfs-actions.pod:7177
20056 msgid ""
20057 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
20058 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
20059 "is no longer necessary because C<guestfs_launch> now does the waiting."
20060 msgstr ""
20061
20062 # type: textblock
20063 #. type: textblock
20064 #: ../src/guestfs-actions.pod:7182
20065 msgid ""
20066 "If you see any calls to this function in code then you can just remove them, "
20067 "unless you want to retain compatibility with older versions of the API."
20068 msgstr ""
20069
20070 # type: =head2
20071 #. type: =head2
20072 #: ../src/guestfs-actions.pod:7190
20073 msgid "guestfs_wc_c"
20074 msgstr ""
20075
20076 # type: verbatim
20077 #. type: verbatim
20078 #: ../src/guestfs-actions.pod:7192
20079 #, no-wrap
20080 msgid ""
20081 " int\n"
20082 " guestfs_wc_c (guestfs_h *g,\n"
20083 "               const char *path);\n"
20084 "\n"
20085 msgstr ""
20086
20087 # type: textblock
20088 #. type: textblock
20089 #: ../src/guestfs-actions.pod:7196 ../fish/guestfish-actions.pod:4818
20090 msgid ""
20091 "This command counts the characters in a file, using the C<wc -c> external "
20092 "command."
20093 msgstr ""
20094
20095 # type: =head2
20096 #. type: =head2
20097 #: ../src/guestfs-actions.pod:7203
20098 msgid "guestfs_wc_l"
20099 msgstr ""
20100
20101 # type: verbatim
20102 #. type: verbatim
20103 #: ../src/guestfs-actions.pod:7205
20104 #, no-wrap
20105 msgid ""
20106 " int\n"
20107 " guestfs_wc_l (guestfs_h *g,\n"
20108 "               const char *path);\n"
20109 "\n"
20110 msgstr ""
20111
20112 # type: textblock
20113 #. type: textblock
20114 #: ../src/guestfs-actions.pod:7209 ../fish/guestfish-actions.pod:4825
20115 msgid ""
20116 "This command counts the lines in a file, using the C<wc -l> external command."
20117 msgstr ""
20118
20119 # type: =head2
20120 #. type: =head2
20121 #: ../src/guestfs-actions.pod:7216
20122 msgid "guestfs_wc_w"
20123 msgstr ""
20124
20125 # type: verbatim
20126 #. type: verbatim
20127 #: ../src/guestfs-actions.pod:7218
20128 #, no-wrap
20129 msgid ""
20130 " int\n"
20131 " guestfs_wc_w (guestfs_h *g,\n"
20132 "               const char *path);\n"
20133 "\n"
20134 msgstr ""
20135
20136 # type: textblock
20137 #. type: textblock
20138 #: ../src/guestfs-actions.pod:7222 ../fish/guestfish-actions.pod:4832
20139 msgid ""
20140 "This command counts the words in a file, using the C<wc -w> external command."
20141 msgstr ""
20142
20143 # type: =head2
20144 #. type: =head2
20145 #: ../src/guestfs-actions.pod:7229
20146 msgid "guestfs_write"
20147 msgstr ""
20148
20149 # type: verbatim
20150 #. type: verbatim
20151 #: ../src/guestfs-actions.pod:7231
20152 #, no-wrap
20153 msgid ""
20154 " int\n"
20155 " guestfs_write (guestfs_h *g,\n"
20156 "                const char *path,\n"
20157 "                const char *content,\n"
20158 "                size_t content_size);\n"
20159 "\n"
20160 msgstr ""
20161
20162 # type: textblock
20163 #. type: textblock
20164 #: ../src/guestfs-actions.pod:7237 ../fish/guestfish-actions.pod:4839
20165 msgid ""
20166 "This call creates a file called C<path>.  The content of the file is the "
20167 "string C<content> (which can contain any 8 bit data)."
20168 msgstr ""
20169
20170 # type: =head2
20171 #. type: =head2
20172 #: ../src/guestfs-actions.pod:7247
20173 msgid "guestfs_write_file"
20174 msgstr ""
20175
20176 # type: verbatim
20177 #. type: verbatim
20178 #: ../src/guestfs-actions.pod:7249
20179 #, no-wrap
20180 msgid ""
20181 " int\n"
20182 " guestfs_write_file (guestfs_h *g,\n"
20183 "                     const char *path,\n"
20184 "                     const char *content,\n"
20185 "                     int size);\n"
20186 "\n"
20187 msgstr ""
20188
20189 # type: textblock
20190 #. type: textblock
20191 #: ../src/guestfs-actions.pod:7255 ../fish/guestfish-actions.pod:4849
20192 msgid ""
20193 "This call creates a file called C<path>.  The contents of the file is the "
20194 "string C<content> (which can contain any 8 bit data), with length C<size>."
20195 msgstr ""
20196
20197 # type: textblock
20198 #. type: textblock
20199 #: ../src/guestfs-actions.pod:7259 ../fish/guestfish-actions.pod:4853
20200 msgid ""
20201 "As a special case, if C<size> is C<0> then the length is calculated using "
20202 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
20203 msgstr ""
20204
20205 # type: textblock
20206 #. type: textblock
20207 #: ../src/guestfs-actions.pod:7263 ../fish/guestfish-actions.pod:4857
20208 msgid ""
20209 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
20210 "I<not> work, even if the length is specified."
20211 msgstr ""
20212
20213 # type: textblock
20214 #. type: textblock
20215 #: ../src/guestfs-actions.pod:7271 ../fish/guestfish-actions.pod:4863
20216 msgid ""
20217 "This function is deprecated.  In new code, use the C<write> call instead."
20218 msgstr ""
20219
20220 # type: =head2
20221 #. type: =head2
20222 #: ../src/guestfs-actions.pod:7280
20223 msgid "guestfs_zegrep"
20224 msgstr ""
20225
20226 # type: verbatim
20227 #. type: verbatim
20228 #: ../src/guestfs-actions.pod:7282
20229 #, no-wrap
20230 msgid ""
20231 " char **\n"
20232 " guestfs_zegrep (guestfs_h *g,\n"
20233 "                 const char *regex,\n"
20234 "                 const char *path);\n"
20235 "\n"
20236 msgstr ""
20237
20238 # type: textblock
20239 #. type: textblock
20240 #: ../src/guestfs-actions.pod:7287 ../fish/guestfish-actions.pod:4874
20241 msgid ""
20242 "This calls the external C<zegrep> program and returns the matching lines."
20243 msgstr ""
20244
20245 # type: =head2
20246 #. type: =head2
20247 #: ../src/guestfs-actions.pod:7299
20248 msgid "guestfs_zegrepi"
20249 msgstr ""
20250
20251 # type: verbatim
20252 #. type: verbatim
20253 #: ../src/guestfs-actions.pod:7301
20254 #, no-wrap
20255 msgid ""
20256 " char **\n"
20257 " guestfs_zegrepi (guestfs_h *g,\n"
20258 "                  const char *regex,\n"
20259 "                  const char *path);\n"
20260 "\n"
20261 msgstr ""
20262
20263 # type: textblock
20264 #. type: textblock
20265 #: ../src/guestfs-actions.pod:7306 ../fish/guestfish-actions.pod:4884
20266 msgid ""
20267 "This calls the external C<zegrep -i> program and returns the matching lines."
20268 msgstr ""
20269
20270 # type: =head2
20271 #. type: =head2
20272 #: ../src/guestfs-actions.pod:7318
20273 msgid "guestfs_zero"
20274 msgstr ""
20275
20276 # type: verbatim
20277 #. type: verbatim
20278 #: ../src/guestfs-actions.pod:7320
20279 #, no-wrap
20280 msgid ""
20281 " int\n"
20282 " guestfs_zero (guestfs_h *g,\n"
20283 "               const char *device);\n"
20284 "\n"
20285 msgstr ""
20286
20287 # type: textblock
20288 #. type: textblock
20289 #: ../src/guestfs-actions.pod:7324 ../fish/guestfish-actions.pod:4894
20290 msgid "This command writes zeroes over the first few blocks of C<device>."
20291 msgstr ""
20292
20293 # type: textblock
20294 #. type: textblock
20295 #: ../src/guestfs-actions.pod:7326 ../fish/guestfish-actions.pod:4896
20296 msgid ""
20297 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
20298 "securely wipe the device).  It should be sufficient to remove any partition "
20299 "tables, filesystem superblocks and so on."
20300 msgstr ""
20301
20302 # type: textblock
20303 #. type: textblock
20304 #: ../src/guestfs-actions.pod:7330
20305 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
20306 msgstr ""
20307
20308 # type: =head2
20309 #. type: =head2
20310 #: ../src/guestfs-actions.pod:7341
20311 msgid "guestfs_zero_device"
20312 msgstr ""
20313
20314 # type: verbatim
20315 #. type: verbatim
20316 #: ../src/guestfs-actions.pod:7343
20317 #, no-wrap
20318 msgid ""
20319 " int\n"
20320 " guestfs_zero_device (guestfs_h *g,\n"
20321 "                      const char *device);\n"
20322 "\n"
20323 msgstr ""
20324
20325 # type: textblock
20326 #. type: textblock
20327 #: ../src/guestfs-actions.pod:7347
20328 msgid ""
20329 "This command writes zeroes over the entire C<device>.  Compare with "
20330 "C<guestfs_zero> which just zeroes the first few blocks of a device."
20331 msgstr ""
20332
20333 # type: textblock
20334 #. type: textblock
20335 #: ../src/guestfs-actions.pod:7361
20336 msgid "(Added in 1.3.1)"
20337 msgstr ""
20338
20339 # type: =head2
20340 #. type: =head2
20341 #: ../src/guestfs-actions.pod:7363
20342 msgid "guestfs_zerofree"
20343 msgstr ""
20344
20345 # type: verbatim
20346 #. type: verbatim
20347 #: ../src/guestfs-actions.pod:7365
20348 #, no-wrap
20349 msgid ""
20350 " int\n"
20351 " guestfs_zerofree (guestfs_h *g,\n"
20352 "                   const char *device);\n"
20353 "\n"
20354 msgstr ""
20355
20356 # type: textblock
20357 #. type: textblock
20358 #: ../src/guestfs-actions.pod:7369 ../fish/guestfish-actions.pod:4917
20359 msgid ""
20360 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
20361 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
20362 "possible to compress the filesystem more effectively."
20363 msgstr ""
20364
20365 # type: textblock
20366 #. type: textblock
20367 #: ../src/guestfs-actions.pod:7374 ../fish/guestfish-actions.pod:4922
20368 msgid "You should B<not> run this program if the filesystem is mounted."
20369 msgstr ""
20370
20371 # type: textblock
20372 #. type: textblock
20373 #: ../src/guestfs-actions.pod:7377 ../fish/guestfish-actions.pod:4925
20374 msgid ""
20375 "It is possible that using this program can damage the filesystem or data on "
20376 "the filesystem."
20377 msgstr ""
20378
20379 # type: =head2
20380 #. type: =head2
20381 #: ../src/guestfs-actions.pod:7384
20382 msgid "guestfs_zfgrep"
20383 msgstr ""
20384
20385 # type: verbatim
20386 #. type: verbatim
20387 #: ../src/guestfs-actions.pod:7386
20388 #, no-wrap
20389 msgid ""
20390 " char **\n"
20391 " guestfs_zfgrep (guestfs_h *g,\n"
20392 "                 const char *pattern,\n"
20393 "                 const char *path);\n"
20394 "\n"
20395 msgstr ""
20396
20397 # type: textblock
20398 #. type: textblock
20399 #: ../src/guestfs-actions.pod:7391 ../fish/guestfish-actions.pod:4932
20400 msgid ""
20401 "This calls the external C<zfgrep> program and returns the matching lines."
20402 msgstr ""
20403
20404 # type: =head2
20405 #. type: =head2
20406 #: ../src/guestfs-actions.pod:7403
20407 msgid "guestfs_zfgrepi"
20408 msgstr ""
20409
20410 # type: verbatim
20411 #. type: verbatim
20412 #: ../src/guestfs-actions.pod:7405
20413 #, no-wrap
20414 msgid ""
20415 " char **\n"
20416 " guestfs_zfgrepi (guestfs_h *g,\n"
20417 "                  const char *pattern,\n"
20418 "                  const char *path);\n"
20419 "\n"
20420 msgstr ""
20421
20422 # type: textblock
20423 #. type: textblock
20424 #: ../src/guestfs-actions.pod:7410 ../fish/guestfish-actions.pod:4942
20425 msgid ""
20426 "This calls the external C<zfgrep -i> program and returns the matching lines."
20427 msgstr ""
20428
20429 # type: =head2
20430 #. type: =head2
20431 #: ../src/guestfs-actions.pod:7422
20432 msgid "guestfs_zfile"
20433 msgstr ""
20434
20435 # type: verbatim
20436 #. type: verbatim
20437 #: ../src/guestfs-actions.pod:7424
20438 #, no-wrap
20439 msgid ""
20440 " char *\n"
20441 " guestfs_zfile (guestfs_h *g,\n"
20442 "                const char *meth,\n"
20443 "                const char *path);\n"
20444 "\n"
20445 msgstr ""
20446
20447 # type: textblock
20448 #. type: textblock
20449 #: ../src/guestfs-actions.pod:7429 ../fish/guestfish-actions.pod:4952
20450 msgid ""
20451 "This command runs C<file> after first decompressing C<path> using C<method>."
20452 msgstr ""
20453
20454 # type: textblock
20455 #. type: textblock
20456 #: ../src/guestfs-actions.pod:7432 ../fish/guestfish-actions.pod:4955
20457 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
20458 msgstr ""
20459
20460 # type: textblock
20461 #. type: textblock
20462 #: ../src/guestfs-actions.pod:7434
20463 msgid ""
20464 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
20465 "files."
20466 msgstr ""
20467
20468 # type: textblock
20469 #. type: textblock
20470 #: ../src/guestfs-actions.pod:7440 ../fish/guestfish-actions.pod:4960
20471 msgid ""
20472 "This function is deprecated.  In new code, use the C<file> call instead."
20473 msgstr ""
20474
20475 # type: =head2
20476 #. type: =head2
20477 #: ../src/guestfs-actions.pod:7449
20478 msgid "guestfs_zgrep"
20479 msgstr ""
20480
20481 # type: verbatim
20482 #. type: verbatim
20483 #: ../src/guestfs-actions.pod:7451
20484 #, no-wrap
20485 msgid ""
20486 " char **\n"
20487 " guestfs_zgrep (guestfs_h *g,\n"
20488 "                const char *regex,\n"
20489 "                const char *path);\n"
20490 "\n"
20491 msgstr ""
20492
20493 # type: textblock
20494 #. type: textblock
20495 #: ../src/guestfs-actions.pod:7456 ../fish/guestfish-actions.pod:4971
20496 msgid ""
20497 "This calls the external C<zgrep> program and returns the matching lines."
20498 msgstr ""
20499
20500 # type: =head2
20501 #. type: =head2
20502 #: ../src/guestfs-actions.pod:7468
20503 msgid "guestfs_zgrepi"
20504 msgstr ""
20505
20506 # type: verbatim
20507 #. type: verbatim
20508 #: ../src/guestfs-actions.pod:7470
20509 #, no-wrap
20510 msgid ""
20511 " char **\n"
20512 " guestfs_zgrepi (guestfs_h *g,\n"
20513 "                 const char *regex,\n"
20514 "                 const char *path);\n"
20515 "\n"
20516 msgstr ""
20517
20518 # type: textblock
20519 #. type: textblock
20520 #: ../src/guestfs-actions.pod:7475 ../fish/guestfish-actions.pod:4981
20521 msgid ""
20522 "This calls the external C<zgrep -i> program and returns the matching lines."
20523 msgstr ""
20524
20525 # type: =item
20526 #. type: =item
20527 #: ../src/guestfs-availability.pod:3
20528 msgid "B<augeas>"
20529 msgstr ""
20530
20531 # type: textblock
20532 #. type: textblock
20533 #: ../src/guestfs-availability.pod:5
20534 msgid ""
20535 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
20536 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
20537 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
20538 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
20539 "L</guestfs_aug_save> L</guestfs_aug_set>"
20540 msgstr ""
20541
20542 # type: =item
20543 #. type: =item
20544 #: ../src/guestfs-availability.pod:21
20545 msgid "B<inotify>"
20546 msgstr ""
20547
20548 # type: textblock
20549 #. type: textblock
20550 #: ../src/guestfs-availability.pod:23
20551 msgid ""
20552 "The following functions: L</guestfs_inotify_add_watch> L</"
20553 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
20554 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
20555 msgstr ""
20556
20557 # type: =item
20558 #. type: =item
20559 #: ../src/guestfs-availability.pod:31
20560 msgid "B<linuxfsuuid>"
20561 msgstr ""
20562
20563 # type: textblock
20564 #. type: textblock
20565 #: ../src/guestfs-availability.pod:33
20566 msgid ""
20567 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
20568 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
20569 msgstr ""
20570
20571 # type: =item
20572 #. type: =item
20573 #: ../src/guestfs-availability.pod:40
20574 msgid "B<linuxmodules>"
20575 msgstr ""
20576
20577 # type: textblock
20578 #. type: textblock
20579 #: ../src/guestfs-availability.pod:42
20580 msgid "The following functions: L</guestfs_modprobe>"
20581 msgstr ""
20582
20583 # type: =item
20584 #. type: =item
20585 #: ../src/guestfs-availability.pod:45
20586 msgid "B<linuxxattrs>"
20587 msgstr ""
20588
20589 # type: textblock
20590 #. type: textblock
20591 #: ../src/guestfs-availability.pod:47
20592 msgid ""
20593 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
20594 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
20595 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
20596 "guestfs_setxattr>"
20597 msgstr ""
20598
20599 # type: =item
20600 #. type: =item
20601 #: ../src/guestfs-availability.pod:58
20602 msgid "B<luks>"
20603 msgstr ""
20604
20605 # type: textblock
20606 #. type: textblock
20607 #: ../src/guestfs-availability.pod:60
20608 msgid ""
20609 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
20610 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
20611 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
20612 msgstr ""
20613
20614 # type: =item
20615 #. type: =item
20616 #: ../src/guestfs-availability.pod:69
20617 msgid "B<lvm2>"
20618 msgstr ""
20619
20620 # type: textblock
20621 #. type: textblock
20622 #: ../src/guestfs-availability.pod:71
20623 msgid ""
20624 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
20625 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
20626 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
20627 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
20628 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
20629 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
20630 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
20631 msgstr ""
20632
20633 # type: =item
20634 #. type: =item
20635 #: ../src/guestfs-availability.pod:94
20636 msgid "B<mknod>"
20637 msgstr ""
20638
20639 # type: textblock
20640 #. type: textblock
20641 #: ../src/guestfs-availability.pod:96
20642 msgid ""
20643 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
20644 "guestfs_mknod_b> L</guestfs_mknod_c>"
20645 msgstr ""
20646
20647 # type: =item
20648 #. type: =item
20649 #: ../src/guestfs-availability.pod:102
20650 msgid "B<ntfs3g>"
20651 msgstr ""
20652
20653 # type: textblock
20654 #. type: textblock
20655 #: ../src/guestfs-availability.pod:104
20656 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
20657 msgstr ""
20658
20659 # type: =item
20660 #. type: =item
20661 #: ../src/guestfs-availability.pod:107
20662 msgid "B<ntfsprogs>"
20663 msgstr ""
20664
20665 # type: textblock
20666 #. type: textblock
20667 #: ../src/guestfs-availability.pod:109
20668 msgid ""
20669 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
20670 msgstr ""
20671
20672 # type: =item
20673 #. type: =item
20674 #: ../src/guestfs-availability.pod:113
20675 msgid "B<realpath>"
20676 msgstr ""
20677
20678 # type: textblock
20679 #. type: textblock
20680 #: ../src/guestfs-availability.pod:115
20681 msgid "The following functions: L</guestfs_realpath>"
20682 msgstr ""
20683
20684 # type: =item
20685 #. type: =item
20686 #: ../src/guestfs-availability.pod:118
20687 msgid "B<scrub>"
20688 msgstr ""
20689
20690 # type: textblock
20691 #. type: textblock
20692 #: ../src/guestfs-availability.pod:120
20693 msgid ""
20694 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
20695 "guestfs_scrub_freespace>"
20696 msgstr ""
20697
20698 # type: =item
20699 #. type: =item
20700 #: ../src/guestfs-availability.pod:125
20701 msgid "B<selinux>"
20702 msgstr ""
20703
20704 # type: textblock
20705 #. type: textblock
20706 #: ../src/guestfs-availability.pod:127
20707 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
20708 msgstr ""
20709
20710 # type: =item
20711 #. type: =item
20712 #: ../src/guestfs-availability.pod:131
20713 msgid "B<xz>"
20714 msgstr ""
20715
20716 # type: textblock
20717 #. type: textblock
20718 #: ../src/guestfs-availability.pod:133
20719 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
20720 msgstr ""
20721
20722 # type: =item
20723 #. type: =item
20724 #: ../src/guestfs-availability.pod:137
20725 msgid "B<zerofree>"
20726 msgstr ""
20727
20728 # type: textblock
20729 #. type: textblock
20730 #: ../src/guestfs-availability.pod:139
20731 msgid "The following functions: L</guestfs_zerofree>"
20732 msgstr ""
20733
20734 # type: =head2
20735 #. type: =head2
20736 #: ../src/guestfs-structs.pod:1
20737 msgid "guestfs_int_bool"
20738 msgstr ""
20739
20740 # type: verbatim
20741 #. type: verbatim
20742 #: ../src/guestfs-structs.pod:3
20743 #, no-wrap
20744 msgid ""
20745 " struct guestfs_int_bool {\n"
20746 "   int32_t i;\n"
20747 "   int32_t b;\n"
20748 " };\n"
20749 " \n"
20750 msgstr ""
20751
20752 # type: verbatim
20753 #. type: verbatim
20754 #: ../src/guestfs-structs.pod:8
20755 #, no-wrap
20756 msgid ""
20757 " struct guestfs_int_bool_list {\n"
20758 "   uint32_t len; /* Number of elements in list. */\n"
20759 "   struct guestfs_int_bool *val; /* Elements. */\n"
20760 " };\n"
20761 " \n"
20762 msgstr ""
20763
20764 # type: verbatim
20765 #. type: verbatim
20766 #: ../src/guestfs-structs.pod:13
20767 #, no-wrap
20768 msgid ""
20769 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
20770 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
20771 "\n"
20772 msgstr ""
20773
20774 # type: =head2
20775 #. type: =head2
20776 #: ../src/guestfs-structs.pod:16
20777 msgid "guestfs_lvm_pv"
20778 msgstr ""
20779
20780 # type: verbatim
20781 #. type: verbatim
20782 #: ../src/guestfs-structs.pod:18
20783 #, no-wrap
20784 msgid ""
20785 " struct guestfs_lvm_pv {\n"
20786 "   char *pv_name;\n"
20787 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20788 "   char pv_uuid[32];\n"
20789 "   char *pv_fmt;\n"
20790 "   uint64_t pv_size;\n"
20791 "   uint64_t dev_size;\n"
20792 "   uint64_t pv_free;\n"
20793 "   uint64_t pv_used;\n"
20794 "   char *pv_attr;\n"
20795 "   int64_t pv_pe_count;\n"
20796 "   int64_t pv_pe_alloc_count;\n"
20797 "   char *pv_tags;\n"
20798 "   uint64_t pe_start;\n"
20799 "   int64_t pv_mda_count;\n"
20800 "   uint64_t pv_mda_free;\n"
20801 " };\n"
20802 " \n"
20803 msgstr ""
20804
20805 # type: verbatim
20806 #. type: verbatim
20807 #: ../src/guestfs-structs.pod:36
20808 #, no-wrap
20809 msgid ""
20810 " struct guestfs_lvm_pv_list {\n"
20811 "   uint32_t len; /* Number of elements in list. */\n"
20812 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
20813 " };\n"
20814 " \n"
20815 msgstr ""
20816
20817 # type: verbatim
20818 #. type: verbatim
20819 #: ../src/guestfs-structs.pod:41
20820 #, no-wrap
20821 msgid ""
20822 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
20823 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
20824 "\n"
20825 msgstr ""
20826
20827 # type: =head2
20828 #. type: =head2
20829 #: ../src/guestfs-structs.pod:44
20830 msgid "guestfs_lvm_vg"
20831 msgstr ""
20832
20833 # type: verbatim
20834 #. type: verbatim
20835 #: ../src/guestfs-structs.pod:46
20836 #, no-wrap
20837 msgid ""
20838 " struct guestfs_lvm_vg {\n"
20839 "   char *vg_name;\n"
20840 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20841 "   char vg_uuid[32];\n"
20842 "   char *vg_fmt;\n"
20843 "   char *vg_attr;\n"
20844 "   uint64_t vg_size;\n"
20845 "   uint64_t vg_free;\n"
20846 "   char *vg_sysid;\n"
20847 "   uint64_t vg_extent_size;\n"
20848 "   int64_t vg_extent_count;\n"
20849 "   int64_t vg_free_count;\n"
20850 "   int64_t max_lv;\n"
20851 "   int64_t max_pv;\n"
20852 "   int64_t pv_count;\n"
20853 "   int64_t lv_count;\n"
20854 "   int64_t snap_count;\n"
20855 "   int64_t vg_seqno;\n"
20856 "   char *vg_tags;\n"
20857 "   int64_t vg_mda_count;\n"
20858 "   uint64_t vg_mda_free;\n"
20859 " };\n"
20860 " \n"
20861 msgstr ""
20862
20863 # type: verbatim
20864 #. type: verbatim
20865 #: ../src/guestfs-structs.pod:69
20866 #, no-wrap
20867 msgid ""
20868 " struct guestfs_lvm_vg_list {\n"
20869 "   uint32_t len; /* Number of elements in list. */\n"
20870 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
20871 " };\n"
20872 " \n"
20873 msgstr ""
20874
20875 # type: verbatim
20876 #. type: verbatim
20877 #: ../src/guestfs-structs.pod:74
20878 #, no-wrap
20879 msgid ""
20880 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
20881 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
20882 "\n"
20883 msgstr ""
20884
20885 # type: =head2
20886 #. type: =head2
20887 #: ../src/guestfs-structs.pod:77
20888 msgid "guestfs_lvm_lv"
20889 msgstr ""
20890
20891 # type: verbatim
20892 #. type: verbatim
20893 #: ../src/guestfs-structs.pod:79
20894 #, no-wrap
20895 msgid ""
20896 " struct guestfs_lvm_lv {\n"
20897 "   char *lv_name;\n"
20898 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20899 "   char lv_uuid[32];\n"
20900 "   char *lv_attr;\n"
20901 "   int64_t lv_major;\n"
20902 "   int64_t lv_minor;\n"
20903 "   int64_t lv_kernel_major;\n"
20904 "   int64_t lv_kernel_minor;\n"
20905 "   uint64_t lv_size;\n"
20906 "   int64_t seg_count;\n"
20907 "   char *origin;\n"
20908 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
20909 "   float snap_percent;\n"
20910 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
20911 "   float copy_percent;\n"
20912 "   char *move_pv;\n"
20913 "   char *lv_tags;\n"
20914 "   char *mirror_log;\n"
20915 "   char *modules;\n"
20916 " };\n"
20917 " \n"
20918 msgstr ""
20919
20920 # type: verbatim
20921 #. type: verbatim
20922 #: ../src/guestfs-structs.pod:101
20923 #, no-wrap
20924 msgid ""
20925 " struct guestfs_lvm_lv_list {\n"
20926 "   uint32_t len; /* Number of elements in list. */\n"
20927 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
20928 " };\n"
20929 " \n"
20930 msgstr ""
20931
20932 # type: verbatim
20933 #. type: verbatim
20934 #: ../src/guestfs-structs.pod:106
20935 #, no-wrap
20936 msgid ""
20937 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
20938 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
20939 "\n"
20940 msgstr ""
20941
20942 # type: verbatim
20943 #. type: verbatim
20944 #: ../src/guestfs-structs.pod:111
20945 #, no-wrap
20946 msgid ""
20947 " struct guestfs_stat {\n"
20948 "   int64_t dev;\n"
20949 "   int64_t ino;\n"
20950 "   int64_t mode;\n"
20951 "   int64_t nlink;\n"
20952 "   int64_t uid;\n"
20953 "   int64_t gid;\n"
20954 "   int64_t rdev;\n"
20955 "   int64_t size;\n"
20956 "   int64_t blksize;\n"
20957 "   int64_t blocks;\n"
20958 "   int64_t atime;\n"
20959 "   int64_t mtime;\n"
20960 "   int64_t ctime;\n"
20961 " };\n"
20962 " \n"
20963 msgstr ""
20964
20965 # type: verbatim
20966 #. type: verbatim
20967 #: ../src/guestfs-structs.pod:127
20968 #, no-wrap
20969 msgid ""
20970 " struct guestfs_stat_list {\n"
20971 "   uint32_t len; /* Number of elements in list. */\n"
20972 "   struct guestfs_stat *val; /* Elements. */\n"
20973 " };\n"
20974 " \n"
20975 msgstr ""
20976
20977 # type: verbatim
20978 #. type: verbatim
20979 #: ../src/guestfs-structs.pod:132
20980 #, no-wrap
20981 msgid ""
20982 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
20983 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
20984 "\n"
20985 msgstr ""
20986
20987 # type: verbatim
20988 #. type: verbatim
20989 #: ../src/guestfs-structs.pod:137
20990 #, no-wrap
20991 msgid ""
20992 " struct guestfs_statvfs {\n"
20993 "   int64_t bsize;\n"
20994 "   int64_t frsize;\n"
20995 "   int64_t blocks;\n"
20996 "   int64_t bfree;\n"
20997 "   int64_t bavail;\n"
20998 "   int64_t files;\n"
20999 "   int64_t ffree;\n"
21000 "   int64_t favail;\n"
21001 "   int64_t fsid;\n"
21002 "   int64_t flag;\n"
21003 "   int64_t namemax;\n"
21004 " };\n"
21005 " \n"
21006 msgstr ""
21007
21008 # type: verbatim
21009 #. type: verbatim
21010 #: ../src/guestfs-structs.pod:151
21011 #, no-wrap
21012 msgid ""
21013 " struct guestfs_statvfs_list {\n"
21014 "   uint32_t len; /* Number of elements in list. */\n"
21015 "   struct guestfs_statvfs *val; /* Elements. */\n"
21016 " };\n"
21017 " \n"
21018 msgstr ""
21019
21020 # type: verbatim
21021 #. type: verbatim
21022 #: ../src/guestfs-structs.pod:156
21023 #, no-wrap
21024 msgid ""
21025 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
21026 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
21027 "\n"
21028 msgstr ""
21029
21030 # type: =head2
21031 #. type: =head2
21032 #: ../src/guestfs-structs.pod:159
21033 msgid "guestfs_dirent"
21034 msgstr ""
21035
21036 # type: verbatim
21037 #. type: verbatim
21038 #: ../src/guestfs-structs.pod:161
21039 #, no-wrap
21040 msgid ""
21041 " struct guestfs_dirent {\n"
21042 "   int64_t ino;\n"
21043 "   char ftyp;\n"
21044 "   char *name;\n"
21045 " };\n"
21046 " \n"
21047 msgstr ""
21048
21049 # type: verbatim
21050 #. type: verbatim
21051 #: ../src/guestfs-structs.pod:167
21052 #, no-wrap
21053 msgid ""
21054 " struct guestfs_dirent_list {\n"
21055 "   uint32_t len; /* Number of elements in list. */\n"
21056 "   struct guestfs_dirent *val; /* Elements. */\n"
21057 " };\n"
21058 " \n"
21059 msgstr ""
21060
21061 # type: verbatim
21062 #. type: verbatim
21063 #: ../src/guestfs-structs.pod:172
21064 #, no-wrap
21065 msgid ""
21066 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
21067 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
21068 "\n"
21069 msgstr ""
21070
21071 # type: verbatim
21072 #. type: verbatim
21073 #: ../src/guestfs-structs.pod:177
21074 #, no-wrap
21075 msgid ""
21076 " struct guestfs_version {\n"
21077 "   int64_t major;\n"
21078 "   int64_t minor;\n"
21079 "   int64_t release;\n"
21080 "   char *extra;\n"
21081 " };\n"
21082 " \n"
21083 msgstr ""
21084
21085 # type: verbatim
21086 #. type: verbatim
21087 #: ../src/guestfs-structs.pod:184
21088 #, no-wrap
21089 msgid ""
21090 " struct guestfs_version_list {\n"
21091 "   uint32_t len; /* Number of elements in list. */\n"
21092 "   struct guestfs_version *val; /* Elements. */\n"
21093 " };\n"
21094 " \n"
21095 msgstr ""
21096
21097 # type: verbatim
21098 #. type: verbatim
21099 #: ../src/guestfs-structs.pod:189
21100 #, no-wrap
21101 msgid ""
21102 " void guestfs_free_version (struct guestfs_free_version *);\n"
21103 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
21104 "\n"
21105 msgstr ""
21106
21107 # type: =head2
21108 #. type: =head2
21109 #: ../src/guestfs-structs.pod:192
21110 msgid "guestfs_xattr"
21111 msgstr ""
21112
21113 # type: verbatim
21114 #. type: verbatim
21115 #: ../src/guestfs-structs.pod:194
21116 #, no-wrap
21117 msgid ""
21118 " struct guestfs_xattr {\n"
21119 "   char *attrname;\n"
21120 "   /* The next two fields describe a byte array. */\n"
21121 "   uint32_t attrval_len;\n"
21122 "   char *attrval;\n"
21123 " };\n"
21124 " \n"
21125 msgstr ""
21126
21127 # type: verbatim
21128 #. type: verbatim
21129 #: ../src/guestfs-structs.pod:201
21130 #, no-wrap
21131 msgid ""
21132 " struct guestfs_xattr_list {\n"
21133 "   uint32_t len; /* Number of elements in list. */\n"
21134 "   struct guestfs_xattr *val; /* Elements. */\n"
21135 " };\n"
21136 " \n"
21137 msgstr ""
21138
21139 # type: verbatim
21140 #. type: verbatim
21141 #: ../src/guestfs-structs.pod:206
21142 #, no-wrap
21143 msgid ""
21144 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
21145 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
21146 "\n"
21147 msgstr ""
21148
21149 # type: =head2
21150 #. type: =head2
21151 #: ../src/guestfs-structs.pod:209
21152 msgid "guestfs_inotify_event"
21153 msgstr ""
21154
21155 # type: verbatim
21156 #. type: verbatim
21157 #: ../src/guestfs-structs.pod:211
21158 #, no-wrap
21159 msgid ""
21160 " struct guestfs_inotify_event {\n"
21161 "   int64_t in_wd;\n"
21162 "   uint32_t in_mask;\n"
21163 "   uint32_t in_cookie;\n"
21164 "   char *in_name;\n"
21165 " };\n"
21166 " \n"
21167 msgstr ""
21168
21169 # type: verbatim
21170 #. type: verbatim
21171 #: ../src/guestfs-structs.pod:218
21172 #, no-wrap
21173 msgid ""
21174 " struct guestfs_inotify_event_list {\n"
21175 "   uint32_t len; /* Number of elements in list. */\n"
21176 "   struct guestfs_inotify_event *val; /* Elements. */\n"
21177 " };\n"
21178 " \n"
21179 msgstr ""
21180
21181 # type: verbatim
21182 #. type: verbatim
21183 #: ../src/guestfs-structs.pod:223
21184 #, no-wrap
21185 msgid ""
21186 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
21187 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
21188 "\n"
21189 msgstr ""
21190
21191 # type: =head2
21192 #. type: =head2
21193 #: ../src/guestfs-structs.pod:226
21194 msgid "guestfs_partition"
21195 msgstr ""
21196
21197 # type: verbatim
21198 #. type: verbatim
21199 #: ../src/guestfs-structs.pod:228
21200 #, no-wrap
21201 msgid ""
21202 " struct guestfs_partition {\n"
21203 "   int32_t part_num;\n"
21204 "   uint64_t part_start;\n"
21205 "   uint64_t part_end;\n"
21206 "   uint64_t part_size;\n"
21207 " };\n"
21208 " \n"
21209 msgstr ""
21210
21211 # type: verbatim
21212 #. type: verbatim
21213 #: ../src/guestfs-structs.pod:235
21214 #, no-wrap
21215 msgid ""
21216 " struct guestfs_partition_list {\n"
21217 "   uint32_t len; /* Number of elements in list. */\n"
21218 "   struct guestfs_partition *val; /* Elements. */\n"
21219 " };\n"
21220 " \n"
21221 msgstr ""
21222
21223 # type: verbatim
21224 #. type: verbatim
21225 #: ../src/guestfs-structs.pod:240
21226 #, no-wrap
21227 msgid ""
21228 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
21229 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
21230 "\n"
21231 msgstr ""
21232
21233 # type: =head2
21234 #. type: =head2
21235 #: ../src/guestfs-structs.pod:243
21236 msgid "guestfs_application"
21237 msgstr ""
21238
21239 # type: verbatim
21240 #. type: verbatim
21241 #: ../src/guestfs-structs.pod:245
21242 #, no-wrap
21243 msgid ""
21244 " struct guestfs_application {\n"
21245 "   char *app_name;\n"
21246 "   char *app_display_name;\n"
21247 "   int32_t app_epoch;\n"
21248 "   char *app_version;\n"
21249 "   char *app_release;\n"
21250 "   char *app_install_path;\n"
21251 "   char *app_trans_path;\n"
21252 "   char *app_publisher;\n"
21253 "   char *app_url;\n"
21254 "   char *app_source_package;\n"
21255 "   char *app_summary;\n"
21256 "   char *app_description;\n"
21257 " };\n"
21258 " \n"
21259 msgstr ""
21260
21261 # type: verbatim
21262 #. type: verbatim
21263 #: ../src/guestfs-structs.pod:260
21264 #, no-wrap
21265 msgid ""
21266 " struct guestfs_application_list {\n"
21267 "   uint32_t len; /* Number of elements in list. */\n"
21268 "   struct guestfs_application *val; /* Elements. */\n"
21269 " };\n"
21270 " \n"
21271 msgstr ""
21272
21273 # type: verbatim
21274 #. type: verbatim
21275 #: ../src/guestfs-structs.pod:265
21276 #, no-wrap
21277 msgid ""
21278 " void guestfs_free_application (struct guestfs_free_application *);\n"
21279 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
21280 "\n"
21281 msgstr ""
21282
21283 # type: textblock
21284 #. type: textblock
21285 #: ../fish/guestfish.pod:5
21286 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
21287 msgstr ""
21288
21289 # type: verbatim
21290 #. type: verbatim
21291 #: ../fish/guestfish.pod:9
21292 #, no-wrap
21293 msgid ""
21294 " guestfish [--options] [commands]\n"
21295 "\n"
21296 msgstr ""
21297
21298 # type: verbatim
21299 #. type: verbatim
21300 #: ../fish/guestfish.pod:11
21301 #, no-wrap
21302 msgid ""
21303 " guestfish\n"
21304 "\n"
21305 msgstr ""
21306
21307 # type: verbatim
21308 #. type: verbatim
21309 #: ../fish/guestfish.pod:13
21310 #, no-wrap
21311 msgid ""
21312 " guestfish [--ro|--rw] -a disk.img\n"
21313 "\n"
21314 msgstr ""
21315
21316 # type: verbatim
21317 #. type: verbatim
21318 #: ../fish/guestfish.pod:15
21319 #, no-wrap
21320 msgid ""
21321 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
21322 "\n"
21323 msgstr ""
21324
21325 # type: verbatim
21326 #. type: verbatim
21327 #: ../fish/guestfish.pod:17
21328 #, no-wrap
21329 msgid ""
21330 " guestfish -d libvirt-domain\n"
21331 "\n"
21332 msgstr ""
21333
21334 # type: verbatim
21335 #. type: verbatim
21336 #: ../fish/guestfish.pod:19
21337 #, no-wrap
21338 msgid ""
21339 " guestfish [--ro|--rw] -a disk.img -i\n"
21340 "\n"
21341 msgstr ""
21342
21343 # type: verbatim
21344 #. type: verbatim
21345 #: ../fish/guestfish.pod:21
21346 #, no-wrap
21347 msgid ""
21348 " guestfish -d libvirt-domain -i\n"
21349 "\n"
21350 msgstr ""
21351
21352 # type: =head1
21353 #. type: =head1
21354 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
21355 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
21356 msgid "WARNING"
21357 msgstr ""
21358
21359 # type: textblock
21360 #. type: textblock
21361 #: ../fish/guestfish.pod:25
21362 msgid ""
21363 "Using guestfish in read/write mode on live virtual machines can be "
21364 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
21365 "option to use guestfish safely if the disk image or virtual machine might be "
21366 "live."
21367 msgstr ""
21368
21369 # type: textblock
21370 #. type: textblock
21371 #: ../fish/guestfish.pod:32
21372 msgid ""
21373 "Guestfish is a shell and command-line tool for examining and modifying "
21374 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
21375 "functionality of the guestfs API, see L<guestfs(3)>."
21376 msgstr ""
21377
21378 # type: textblock
21379 #. type: textblock
21380 #: ../fish/guestfish.pod:36
21381 msgid ""
21382 "Guestfish gives you structured access to the libguestfs API, from shell "
21383 "scripts or the command line or interactively.  If you want to rescue a "
21384 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
21385 "command."
21386 msgstr ""
21387
21388 # type: =head1
21389 #. type: =head1
21390 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:947
21391 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63 ../tools/virt-tar.pl:50
21392 msgid "EXAMPLES"
21393 msgstr ""
21394
21395 # type: =head2
21396 #. type: =head2
21397 #: ../fish/guestfish.pod:43
21398 msgid "As an interactive shell"
21399 msgstr ""
21400
21401 # type: verbatim
21402 #. type: verbatim
21403 #: ../fish/guestfish.pod:45
21404 #, no-wrap
21405 msgid ""
21406 " $ guestfish\n"
21407 " \n"
21408 msgstr ""
21409
21410 # type: verbatim
21411 #. type: verbatim
21412 #: ../fish/guestfish.pod:47
21413 #, no-wrap
21414 msgid ""
21415 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
21416 " editing virtual machine filesystems.\n"
21417 " \n"
21418 msgstr ""
21419
21420 # type: verbatim
21421 #. type: verbatim
21422 #: ../fish/guestfish.pod:50
21423 #, no-wrap
21424 msgid ""
21425 " Type: 'help' for a list of commands\n"
21426 "       'man' to read the manual\n"
21427 "       'quit' to quit the shell\n"
21428 " \n"
21429 msgstr ""
21430
21431 # type: verbatim
21432 #. type: verbatim
21433 #: ../fish/guestfish.pod:54
21434 #, no-wrap
21435 msgid ""
21436 " ><fs> add-ro disk.img\n"
21437 " ><fs> run\n"
21438 " ><fs> list-filesystems\n"
21439 " /dev/sda1: ext4\n"
21440 " /dev/vg_guest/lv_root: ext4\n"
21441 " /dev/vg_guest/lv_swap: swap\n"
21442 " ><fs> mount /dev/vg_guest/lv_root /\n"
21443 " ><fs> cat /etc/fstab\n"
21444 " # /etc/fstab\n"
21445 " # Created by anaconda\n"
21446 " [...]\n"
21447 " ><fs> exit\n"
21448 "\n"
21449 msgstr ""
21450
21451 # type: =head2
21452 #. type: =head2
21453 #: ../fish/guestfish.pod:67
21454 msgid "From shell scripts"
21455 msgstr ""
21456
21457 # type: textblock
21458 #. type: textblock
21459 #: ../fish/guestfish.pod:69
21460 msgid "Create a new C</etc/motd> file in a guest or disk image:"
21461 msgstr ""
21462
21463 # type: verbatim
21464 #. type: verbatim
21465 #: ../fish/guestfish.pod:71
21466 #, no-wrap
21467 msgid ""
21468 " guestfish <<_EOF_\n"
21469 " add disk.img\n"
21470 " run\n"
21471 " mount /dev/vg_guest/lv_root /\n"
21472 " write /etc/motd \"Welcome, new users\"\n"
21473 " _EOF_\n"
21474 "\n"
21475 msgstr ""
21476
21477 # type: textblock
21478 #. type: textblock
21479 #: ../fish/guestfish.pod:78
21480 msgid "List the LVM logical volumes in a disk image:"
21481 msgstr ""
21482
21483 # type: verbatim
21484 #. type: verbatim
21485 #: ../fish/guestfish.pod:80
21486 #, no-wrap
21487 msgid ""
21488 " guestfish -a disk.img --ro <<_EOF_\n"
21489 " run\n"
21490 " lvs\n"
21491 " _EOF_\n"
21492 "\n"
21493 msgstr ""
21494
21495 # type: textblock
21496 #. type: textblock
21497 #: ../fish/guestfish.pod:85
21498 msgid "List all the filesystems in a disk image:"
21499 msgstr ""
21500
21501 # type: verbatim
21502 #. type: verbatim
21503 #: ../fish/guestfish.pod:87
21504 #, no-wrap
21505 msgid ""
21506 " guestfish -a disk.img --ro <<_EOF_\n"
21507 " run\n"
21508 " list-filesystems\n"
21509 " _EOF_\n"
21510 "\n"
21511 msgstr ""
21512
21513 # type: =head2
21514 #. type: =head2
21515 #: ../fish/guestfish.pod:92
21516 msgid "On one command line"
21517 msgstr ""
21518
21519 # type: textblock
21520 #. type: textblock
21521 #: ../fish/guestfish.pod:94
21522 msgid "Update C</etc/resolv.conf> in a guest:"
21523 msgstr ""
21524
21525 # type: verbatim
21526 #. type: verbatim
21527 #: ../fish/guestfish.pod:96
21528 #, no-wrap
21529 msgid ""
21530 " guestfish \\\n"
21531 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
21532 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
21533 "\n"
21534 msgstr ""
21535
21536 # type: textblock
21537 #. type: textblock
21538 #: ../fish/guestfish.pod:100
21539 msgid "Edit C</boot/grub/grub.conf> interactively:"
21540 msgstr ""
21541
21542 # type: verbatim
21543 #. type: verbatim
21544 #: ../fish/guestfish.pod:102
21545 #, no-wrap
21546 msgid ""
21547 " guestfish --rw --add disk.img \\\n"
21548 "   --mount /dev/vg_guest/lv_root \\\n"
21549 "   --mount /dev/sda1:/boot \\\n"
21550 "   edit /boot/grub/grub.conf\n"
21551 "\n"
21552 msgstr ""
21553
21554 # type: =head2
21555 #. type: =head2
21556 #: ../fish/guestfish.pod:107
21557 msgid "Mount disks automatically"
21558 msgstr ""
21559
21560 # type: textblock
21561 #. type: textblock
21562 #: ../fish/guestfish.pod:109
21563 msgid ""
21564 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
21565 msgstr ""
21566
21567 # type: verbatim
21568 #. type: verbatim
21569 #: ../fish/guestfish.pod:112
21570 #, no-wrap
21571 msgid ""
21572 " guestfish --ro -a disk.img -i cat /etc/group\n"
21573 "\n"
21574 msgstr ""
21575
21576 # type: verbatim
21577 #. type: verbatim
21578 #: ../fish/guestfish.pod:114
21579 #, no-wrap
21580 msgid ""
21581 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
21582 "\n"
21583 msgstr ""
21584
21585 # type: textblock
21586 #. type: textblock
21587 #: ../fish/guestfish.pod:116
21588 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
21589 msgstr ""
21590
21591 # type: verbatim
21592 #. type: verbatim
21593 #: ../fish/guestfish.pod:118
21594 #, no-wrap
21595 msgid ""
21596 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
21597 "\n"
21598 msgstr ""
21599
21600 # type: =head2
21601 #. type: =head2
21602 #: ../fish/guestfish.pod:120
21603 msgid "As a script interpreter"
21604 msgstr ""
21605
21606 # type: textblock
21607 #. type: textblock
21608 #: ../fish/guestfish.pod:122
21609 msgid "Create a 100MB disk containing an ext2-formatted partition:"
21610 msgstr ""
21611
21612 # type: verbatim
21613 #. type: verbatim
21614 #: ../fish/guestfish.pod:124
21615 #, no-wrap
21616 msgid ""
21617 " #!/usr/bin/guestfish -f\n"
21618 " sparse test1.img 100M\n"
21619 " run\n"
21620 " part-disk /dev/sda mbr\n"
21621 " mkfs ext2 /dev/sda1\n"
21622 "\n"
21623 msgstr ""
21624
21625 # type: =head2
21626 #. type: =head2
21627 #: ../fish/guestfish.pod:130
21628 msgid "Start with a prepared disk"
21629 msgstr ""
21630
21631 # type: textblock
21632 #. type: textblock
21633 #: ../fish/guestfish.pod:132
21634 msgid ""
21635 "An alternate way to create a 100MB disk called C<test1.img> containing a "
21636 "single ext2-formatted partition:"
21637 msgstr ""
21638
21639 # type: verbatim
21640 #. type: verbatim
21641 #: ../fish/guestfish.pod:135
21642 #, no-wrap
21643 msgid ""
21644 " guestfish -N fs\n"
21645 "\n"
21646 msgstr ""
21647
21648 # type: textblock
21649 #. type: textblock
21650 #: ../fish/guestfish.pod:137
21651 msgid "To list what is available do:"
21652 msgstr ""
21653
21654 # type: verbatim
21655 #. type: verbatim
21656 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:938
21657 #, no-wrap
21658 msgid ""
21659 " guestfish -N help | less\n"
21660 "\n"
21661 msgstr ""
21662
21663 # type: =head2
21664 #. type: =head2
21665 #: ../fish/guestfish.pod:141
21666 msgid "Remote control"
21667 msgstr ""
21668
21669 # type: verbatim
21670 #. type: verbatim
21671 #: ../fish/guestfish.pod:143
21672 #, no-wrap
21673 msgid ""
21674 " eval \"`guestfish --listen`\"\n"
21675 " guestfish --remote add-ro disk.img\n"
21676 " guestfish --remote run\n"
21677 " guestfish --remote lvs\n"
21678 "\n"
21679 msgstr ""
21680
21681 # type: =head1
21682 #. type: =head1
21683 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
21684 #: ../fuse/guestmount.pod:73 ../tools/virt-edit.pl:81
21685 #: ../tools/virt-win-reg.pl:96 ../tools/virt-list-filesystems.pl:53
21686 #: ../tools/virt-tar.pl:103 ../tools/virt-make-fs.pl:153
21687 #: ../tools/virt-list-partitions.pl:54
21688 msgid "OPTIONS"
21689 msgstr ""
21690
21691 # type: =item
21692 #. type: =item
21693 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:131
21694 #: ../tools/virt-edit.pl:89 ../tools/virt-win-reg.pl:104
21695 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:111
21696 #: ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62
21697 msgid "B<--help>"
21698 msgstr ""
21699
21700 # type: textblock
21701 #. type: textblock
21702 #: ../fish/guestfish.pod:154
21703 msgid "Displays general help on options."
21704 msgstr ""
21705
21706 # type: =item
21707 #. type: =item
21708 #: ../fish/guestfish.pod:156
21709 msgid "B<-h>"
21710 msgstr ""
21711
21712 # type: =item
21713 #. type: =item
21714 #: ../fish/guestfish.pod:158
21715 msgid "B<--cmd-help>"
21716 msgstr ""
21717
21718 # type: textblock
21719 #. type: textblock
21720 #: ../fish/guestfish.pod:160
21721 msgid "Lists all available guestfish commands."
21722 msgstr ""
21723
21724 # type: =item
21725 #. type: =item
21726 #: ../fish/guestfish.pod:162
21727 msgid "B<-h cmd>"
21728 msgstr ""
21729
21730 # type: =item
21731 #. type: =item
21732 #: ../fish/guestfish.pod:164
21733 msgid "B<--cmd-help cmd>"
21734 msgstr ""
21735
21736 # type: textblock
21737 #. type: textblock
21738 #: ../fish/guestfish.pod:166
21739 msgid "Displays detailed help on a single command C<cmd>."
21740 msgstr ""
21741
21742 # type: =item
21743 #. type: =item
21744 #: ../fish/guestfish.pod:168
21745 msgid "B<-a image>"
21746 msgstr ""
21747
21748 # type: =item
21749 #. type: =item
21750 #: ../fish/guestfish.pod:170
21751 msgid "B<--add image>"
21752 msgstr ""
21753
21754 # type: textblock
21755 #. type: textblock
21756 #: ../fish/guestfish.pod:172
21757 msgid "Add a block device or virtual machine image to the shell."
21758 msgstr ""
21759
21760 # type: textblock
21761 #. type: textblock
21762 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:81
21763 msgid ""
21764 "The format of the disk image is auto-detected.  To override this and force a "
21765 "particular format use the I<--format=..> option."
21766 msgstr ""
21767
21768 #. type: textblock
21769 #: ../fish/guestfish.pod:177
21770 msgid ""
21771 "Using this flag is mostly equivalent to using the C<add> command, with "
21772 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
21773 "the I<--format=...> flag was given."
21774 msgstr ""
21775
21776 # type: =item
21777 #. type: =item
21778 #: ../fish/guestfish.pod:181
21779 msgid "B<-c URI>"
21780 msgstr ""
21781
21782 # type: =item
21783 #. type: =item
21784 #: ../fish/guestfish.pod:183
21785 msgid "B<--connect URI>"
21786 msgstr ""
21787
21788 # type: textblock
21789 #. type: textblock
21790 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:86
21791 msgid ""
21792 "When used in conjunction with the I<-d> option, this specifies the libvirt "
21793 "URI to use.  The default is to use the default libvirt connection."
21794 msgstr ""
21795
21796 # type: =item
21797 #. type: =item
21798 #: ../fish/guestfish.pod:189
21799 msgid "B<--csh>"
21800 msgstr ""
21801
21802 # type: textblock
21803 #. type: textblock
21804 #: ../fish/guestfish.pod:191
21805 msgid ""
21806 "If using the I<--listen> option and a csh-like shell, use this option.  See "
21807 "section L</REMOTE CONTROL AND CSH> below."
21808 msgstr ""
21809
21810 # type: =item
21811 #. type: =item
21812 #: ../fish/guestfish.pod:194
21813 msgid "B<-d libvirt-domain>"
21814 msgstr ""
21815
21816 # type: =item
21817 #. type: =item
21818 #: ../fish/guestfish.pod:196
21819 msgid "B<--domain libvirt-domain>"
21820 msgstr ""
21821
21822 # type: textblock
21823 #. type: textblock
21824 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:92
21825 msgid ""
21826 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
21827 "used, then any libvirt domain can be used.  However in write mode, only "
21828 "libvirt domains which are shut down can be named here."
21829 msgstr ""
21830
21831 # type: textblock
21832 #. type: textblock
21833 #: ../fish/guestfish.pod:202
21834 msgid ""
21835 "Using this flag is mostly equivalent to using the C<add-domain> command, "
21836 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
21837 "if the I<--format:...> flag was given."
21838 msgstr ""
21839
21840 # type: =item
21841 #. type: =item
21842 #: ../fish/guestfish.pod:206
21843 msgid "B<-D>"
21844 msgstr ""
21845
21846 # type: =item
21847 #. type: =item
21848 #: ../fish/guestfish.pod:208
21849 msgid "B<--no-dest-paths>"
21850 msgstr ""
21851
21852 # type: textblock
21853 #. type: textblock
21854 #: ../fish/guestfish.pod:210
21855 msgid ""
21856 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
21857 "to hit the tab key to complete paths on the guest filesystem, but this "
21858 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
21859 "allow this feature to be disabled."
21860 msgstr ""
21861
21862 # type: =item
21863 #. type: =item
21864 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:108
21865 msgid "B<--echo-keys>"
21866 msgstr ""
21867
21868 # type: textblock
21869 #. type: textblock
21870 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:110
21871 msgid ""
21872 "When prompting for keys and passphrases, guestfish normally turns echoing "
21873 "off so you cannot see what you are typing.  If you are not worried about "
21874 "Tempest attacks and there is no one else in the room you can specify this "
21875 "flag to see what you are typing."
21876 msgstr ""
21877
21878 # type: =item
21879 #. type: =item
21880 #: ../fish/guestfish.pod:222
21881 msgid "B<-f file>"
21882 msgstr ""
21883
21884 # type: =item
21885 #. type: =item
21886 #: ../fish/guestfish.pod:224
21887 msgid "B<--file file>"
21888 msgstr ""
21889
21890 # type: textblock
21891 #. type: textblock
21892 #: ../fish/guestfish.pod:226
21893 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
21894 msgstr ""
21895
21896 # type: verbatim
21897 #. type: verbatim
21898 #: ../fish/guestfish.pod:229
21899 #, no-wrap
21900 msgid ""
21901 " #!/usr/bin/guestfish -f\n"
21902 "\n"
21903 msgstr ""
21904
21905 # type: =item
21906 #. type: =item
21907 #: ../fish/guestfish.pod:231
21908 msgid "B<--format=raw|qcow2|..>"
21909 msgstr ""
21910
21911 # type: =item
21912 #. type: =item
21913 #: ../fish/guestfish.pod:233
21914 msgid "B<--format>"
21915 msgstr ""
21916
21917 # type: textblock
21918 #. type: textblock
21919 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:117
21920 msgid ""
21921 "The default for the I<-a> option is to auto-detect the format of the disk "
21922 "image.  Using this forces the disk format for I<-a> options which follow on "
21923 "the command line.  Using I<--format> with no argument switches back to auto-"
21924 "detection for subsequent I<-a> options."
21925 msgstr ""
21926
21927 # type: verbatim
21928 #. type: verbatim
21929 #: ../fish/guestfish.pod:242
21930 #, no-wrap
21931 msgid ""
21932 " guestfish --format=raw -a disk.img\n"
21933 "\n"
21934 msgstr ""
21935
21936 # type: textblock
21937 #. type: textblock
21938 #: ../fish/guestfish.pod:244
21939 msgid "forces raw format (no auto-detection) for C<disk.img>."
21940 msgstr ""
21941
21942 # type: verbatim
21943 #. type: verbatim
21944 #: ../fish/guestfish.pod:246
21945 #, no-wrap
21946 msgid ""
21947 " guestfish --format=raw -a disk.img --format -a another.img\n"
21948 "\n"
21949 msgstr ""
21950
21951 # type: textblock
21952 #. type: textblock
21953 #: ../fish/guestfish.pod:248
21954 msgid ""
21955 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
21956 "detection for C<another.img>."
21957 msgstr ""
21958
21959 # type: textblock
21960 #. type: textblock
21961 #: ../fish/guestfish.pod:251
21962 msgid ""
21963 "If you have untrusted raw-format guest disk images, you should use this "
21964 "option to specify the disk format.  This avoids a possible security problem "
21965 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
21966 msgstr ""
21967
21968 # type: =item
21969 #. type: =item
21970 #: ../fish/guestfish.pod:256
21971 msgid "B<-i>"
21972 msgstr ""
21973
21974 # type: =item
21975 #. type: =item
21976 #: ../fish/guestfish.pod:258
21977 msgid "B<--inspector>"
21978 msgstr ""
21979
21980 # type: textblock
21981 #. type: textblock
21982 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:137
21983 msgid ""
21984 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
21985 "system and mount filesystems as they would be mounted on the real virtual "
21986 "machine."
21987 msgstr ""
21988
21989 # type: textblock
21990 #. type: textblock
21991 #: ../fish/guestfish.pod:264
21992 msgid "Typical usage is either:"
21993 msgstr ""
21994
21995 # type: verbatim
21996 #. type: verbatim
21997 #: ../fish/guestfish.pod:266
21998 #, no-wrap
21999 msgid ""
22000 " guestfish -d myguest -i\n"
22001 "\n"
22002 msgstr ""
22003
22004 # type: textblock
22005 #. type: textblock
22006 #: ../fish/guestfish.pod:268
22007 msgid "(for an inactive libvirt domain called I<myguest>), or:"
22008 msgstr ""
22009
22010 # type: verbatim
22011 #. type: verbatim
22012 #: ../fish/guestfish.pod:270
22013 #, no-wrap
22014 msgid ""
22015 " guestfish --ro -d myguest -i\n"
22016 "\n"
22017 msgstr ""
22018
22019 # type: textblock
22020 #. type: textblock
22021 #: ../fish/guestfish.pod:272
22022 msgid "(for active domains, readonly), or specify the block device directly:"
22023 msgstr ""
22024
22025 # type: verbatim
22026 #. type: verbatim
22027 #: ../fish/guestfish.pod:274
22028 #, no-wrap
22029 msgid ""
22030 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
22031 "\n"
22032 msgstr ""
22033
22034 # type: textblock
22035 #. type: textblock
22036 #: ../fish/guestfish.pod:276
22037 msgid ""
22038 "Note that the command line syntax changed slightly over older versions of "
22039 "guestfish.  You can still use the old syntax:"
22040 msgstr ""
22041
22042 # type: verbatim
22043 #. type: verbatim
22044 #: ../fish/guestfish.pod:279
22045 #, no-wrap
22046 msgid ""
22047 " guestfish [--ro] -i disk.img\n"
22048 "\n"
22049 msgstr ""
22050
22051 # type: verbatim
22052 #. type: verbatim
22053 #: ../fish/guestfish.pod:281
22054 #, no-wrap
22055 msgid ""
22056 " guestfish [--ro] -i libvirt-domain\n"
22057 "\n"
22058 msgstr ""
22059
22060 # type: textblock
22061 #. type: textblock
22062 #: ../fish/guestfish.pod:283
22063 msgid ""
22064 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
22065 "then using other commands to mount the filesystems that were found."
22066 msgstr ""
22067
22068 # type: =item
22069 #. type: =item
22070 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:141
22071 msgid "B<--keys-from-stdin>"
22072 msgstr ""
22073
22074 # type: textblock
22075 #. type: textblock
22076 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:143
22077 msgid ""
22078 "Read key or passphrase parameters from stdin.  The default is to try to read "
22079 "passphrases from the user by opening C</dev/tty>."
22080 msgstr ""
22081
22082 # type: =item
22083 #. type: =item
22084 #: ../fish/guestfish.pod:292
22085 msgid "B<--listen>"
22086 msgstr ""
22087
22088 # type: textblock
22089 #. type: textblock
22090 #: ../fish/guestfish.pod:294
22091 msgid ""
22092 "Fork into the background and listen for remote commands.  See section L</"
22093 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
22094 msgstr ""
22095
22096 #. type: =item
22097 #: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:146
22098 msgid "B<--live>"
22099 msgstr ""
22100
22101 #. type: textblock
22102 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:148
22103 msgid ""
22104 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
22105 "ATTACHING TO RUNNING DAEMONS>)."
22106 msgstr ""
22107
22108 #. type: =item
22109 #: ../fish/guestfish.pod:302 ../fuse/guestmount.pod:151
22110 msgid "B<-m dev[:mountpoint[:options]]>"
22111 msgstr ""
22112
22113 #. type: =item
22114 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:153
22115 msgid "B<--mount dev[:mountpoint[:options]]>"
22116 msgstr ""
22117
22118 # type: textblock
22119 #. type: textblock
22120 #: ../fish/guestfish.pod:306
22121 msgid "Mount the named partition or logical volume on the given mountpoint."
22122 msgstr ""
22123
22124 # type: textblock
22125 #. type: textblock
22126 #: ../fish/guestfish.pod:308
22127 msgid "If the mountpoint is omitted, it defaults to C</>."
22128 msgstr ""
22129
22130 # type: textblock
22131 #. type: textblock
22132 #: ../fish/guestfish.pod:310
22133 msgid "You have to mount something on C</> before most commands will work."
22134 msgstr ""
22135
22136 # type: textblock
22137 #. type: textblock
22138 #: ../fish/guestfish.pod:312
22139 msgid ""
22140 "If any I<-m> or I<--mount> options are given, the guest is automatically "
22141 "launched."
22142 msgstr ""
22143
22144 # type: textblock
22145 #. type: textblock
22146 #: ../fish/guestfish.pod:315
22147 msgid ""
22148 "If you don't know what filesystems a disk image contains, you can either run "
22149 "guestfish without this option, then list the partitions, filesystems and LVs "
22150 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
22151 "commands), or you can use the L<virt-filesystems(1)> program."
22152 msgstr ""
22153
22154 #. type: textblock
22155 #: ../fish/guestfish.pod:321 ../fuse/guestmount.pod:161
22156 msgid ""
22157 "The third (and rarely used) part of the mount parameter is the list of mount "
22158 "options used to mount the underlying filesystem.  If this is not given, then "
22159 "the mount options are either the empty string or C<ro> (the latter if the "
22160 "I<--ro> flag is used).  By specifying the mount options, you override this "
22161 "default choice.  Probably the only time you would use this is to enable ACLs "
22162 "and/or extended attributes if the filesystem can support them:"
22163 msgstr ""
22164
22165 #. type: verbatim
22166 #: ../fish/guestfish.pod:329 ../fuse/guestmount.pod:169
22167 #, no-wrap
22168 msgid ""
22169 " -m /dev/sda1:/:acl,user_xattr\n"
22170 "\n"
22171 msgstr ""
22172
22173 #. type: textblock
22174 #: ../fish/guestfish.pod:331
22175 msgid "Using this flag is equivalent to using the C<mount-options> command."
22176 msgstr ""
22177
22178 # type: =item
22179 #. type: =item
22180 #: ../fish/guestfish.pod:333
22181 msgid "B<-n>"
22182 msgstr ""
22183
22184 # type: =item
22185 #. type: =item
22186 #: ../fish/guestfish.pod:335
22187 msgid "B<--no-sync>"
22188 msgstr ""
22189
22190 # type: textblock
22191 #. type: textblock
22192 #: ../fish/guestfish.pod:337
22193 msgid ""
22194 "Disable autosync.  This is enabled by default.  See the discussion of "
22195 "autosync in the L<guestfs(3)> manpage."
22196 msgstr ""
22197
22198 # type: =item
22199 #. type: =item
22200 #: ../fish/guestfish.pod:340
22201 msgid "B<-N type>"
22202 msgstr ""
22203
22204 # type: =item
22205 #. type: =item
22206 #: ../fish/guestfish.pod:342
22207 msgid "B<--new type>"
22208 msgstr ""
22209
22210 # type: =item
22211 #. type: =item
22212 #: ../fish/guestfish.pod:344
22213 msgid "B<-N help>"
22214 msgstr ""
22215
22216 # type: textblock
22217 #. type: textblock
22218 #: ../fish/guestfish.pod:346
22219 msgid ""
22220 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
22221 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
22222 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
22223 "IMAGES> below."
22224 msgstr ""
22225
22226 # type: =item
22227 #. type: =item
22228 #: ../fish/guestfish.pod:351
22229 msgid "B<--progress-bars>"
22230 msgstr ""
22231
22232 # type: textblock
22233 #. type: textblock
22234 #: ../fish/guestfish.pod:353
22235 msgid "Enable progress bars, even when guestfish is used non-interactively."
22236 msgstr ""
22237
22238 # type: textblock
22239 #. type: textblock
22240 #: ../fish/guestfish.pod:355
22241 msgid ""
22242 "Progress bars are enabled by default when guestfish is used as an "
22243 "interactive shell."
22244 msgstr ""
22245
22246 # type: =item
22247 #. type: =item
22248 #: ../fish/guestfish.pod:358
22249 msgid "B<--no-progress-bars>"
22250 msgstr ""
22251
22252 # type: textblock
22253 #. type: textblock
22254 #: ../fish/guestfish.pod:360
22255 msgid "Disable progress bars."
22256 msgstr ""
22257
22258 # type: =item
22259 #. type: =item
22260 #: ../fish/guestfish.pod:362
22261 msgid "B<--remote[=pid]>"
22262 msgstr ""
22263
22264 # type: textblock
22265 #. type: textblock
22266 #: ../fish/guestfish.pod:364
22267 msgid ""
22268 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
22269 "CONTROL GUESTFISH OVER A SOCKET> below."
22270 msgstr ""
22271
22272 # type: =item
22273 #. type: =item
22274 #: ../fish/guestfish.pod:367
22275 msgid "B<-r>"
22276 msgstr ""
22277
22278 # type: =item
22279 #. type: =item
22280 #: ../fish/guestfish.pod:369
22281 msgid "B<--ro>"
22282 msgstr ""
22283
22284 # type: textblock
22285 #. type: textblock
22286 #: ../fish/guestfish.pod:371
22287 msgid ""
22288 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22289 "mounts are done read-only."
22290 msgstr ""
22291
22292 # type: textblock
22293 #. type: textblock
22294 #: ../fish/guestfish.pod:374
22295 msgid ""
22296 "The option must always be used if the disk image or virtual machine might be "
22297 "running, and is generally recommended in cases where you don't need write "
22298 "access to the disk."
22299 msgstr ""
22300
22301 # type: textblock
22302 #. type: textblock
22303 #: ../fish/guestfish.pod:378
22304 msgid ""
22305 "Note that prepared disk images created with I<-N> are not affected by this "
22306 "option.  Also commands like C<add> are not affected - you have to specify "
22307 "the C<readonly:true> option explicitly if you need it."
22308 msgstr ""
22309
22310 # type: textblock
22311 #. type: textblock
22312 #: ../fish/guestfish.pod:382
22313 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
22314 msgstr ""
22315
22316 # type: =item
22317 #. type: =item
22318 #: ../fish/guestfish.pod:384 ../fuse/guestmount.pod:225
22319 msgid "B<--selinux>"
22320 msgstr ""
22321
22322 # type: textblock
22323 #. type: textblock
22324 #: ../fish/guestfish.pod:386
22325 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
22326 msgstr ""
22327
22328 # type: =item
22329 #. type: =item
22330 #: ../fish/guestfish.pod:388
22331 msgid "B<-v>"
22332 msgstr ""
22333
22334 # type: =item
22335 #. type: =item
22336 #: ../fish/guestfish.pod:390
22337 msgid "B<--verbose>"
22338 msgstr ""
22339
22340 # type: textblock
22341 #. type: textblock
22342 #: ../fish/guestfish.pod:392
22343 msgid ""
22344 "Enable very verbose messages.  This is particularly useful if you find a bug."
22345 msgstr ""
22346
22347 # type: =item
22348 #. type: =item
22349 #: ../fish/guestfish.pod:395
22350 msgid "B<-V>"
22351 msgstr ""
22352
22353 # type: =item
22354 #. type: =item
22355 #: ../fish/guestfish.pod:397 ../tools/virt-edit.pl:97
22356 #: ../tools/virt-win-reg.pl:112 ../tools/virt-list-filesystems.pl:69
22357 #: ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169
22358 #: ../tools/virt-list-partitions.pl:70
22359 msgid "B<--version>"
22360 msgstr ""
22361
22362 # type: textblock
22363 #. type: textblock
22364 #: ../fish/guestfish.pod:399
22365 msgid "Display the guestfish / libguestfs version number and exit."
22366 msgstr ""
22367
22368 # type: =item
22369 #. type: =item
22370 #: ../fish/guestfish.pod:401
22371 msgid "B<-w>"
22372 msgstr ""
22373
22374 # type: =item
22375 #. type: =item
22376 #: ../fish/guestfish.pod:403
22377 msgid "B<--rw>"
22378 msgstr ""
22379
22380 #. type: textblock
22381 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:239
22382 msgid ""
22383 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22384 "mounts are done read-write."
22385 msgstr ""
22386
22387 #. type: textblock
22388 #: ../fish/guestfish.pod:408
22389 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
22390 msgstr ""
22391
22392 # type: =item
22393 #. type: =item
22394 #: ../fish/guestfish.pod:410
22395 msgid "B<-x>"
22396 msgstr ""
22397
22398 # type: textblock
22399 #. type: textblock
22400 #: ../fish/guestfish.pod:412
22401 msgid "Echo each command before executing it."
22402 msgstr ""
22403
22404 # type: =head1
22405 #. type: =head1
22406 #: ../fish/guestfish.pod:416
22407 msgid "COMMANDS ON COMMAND LINE"
22408 msgstr ""
22409
22410 # type: textblock
22411 #. type: textblock
22412 #: ../fish/guestfish.pod:418
22413 msgid ""
22414 "Any additional (non-option) arguments are treated as commands to execute."
22415 msgstr ""
22416
22417 # type: textblock
22418 #. type: textblock
22419 #: ../fish/guestfish.pod:421
22420 msgid ""
22421 "Commands to execute should be separated by a colon (C<:>), where the colon "
22422 "is a separate parameter.  Thus:"
22423 msgstr ""
22424
22425 # type: verbatim
22426 #. type: verbatim
22427 #: ../fish/guestfish.pod:424
22428 #, no-wrap
22429 msgid ""
22430 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
22431 "\n"
22432 msgstr ""
22433
22434 # type: textblock
22435 #. type: textblock
22436 #: ../fish/guestfish.pod:426
22437 msgid ""
22438 "If there are no additional arguments, then we enter a shell, either an "
22439 "interactive shell with a prompt (if the input is a terminal) or a non-"
22440 "interactive shell."
22441 msgstr ""
22442
22443 # type: textblock
22444 #. type: textblock
22445 #: ../fish/guestfish.pod:430
22446 msgid ""
22447 "In either command line mode or non-interactive shell, the first command that "
22448 "gives an error causes the whole shell to exit.  In interactive mode (with a "
22449 "prompt) if a command fails, you can continue to enter commands."
22450 msgstr ""
22451
22452 # type: =head1
22453 #. type: =head1
22454 #: ../fish/guestfish.pod:435
22455 msgid "USING launch (OR run)"
22456 msgstr ""
22457
22458 # type: textblock
22459 #. type: textblock
22460 #: ../fish/guestfish.pod:437
22461 msgid ""
22462 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
22463 "then launch it, then mount any disks you need, and finally issue actions/"
22464 "commands.  So the general order of the day is:"
22465 msgstr ""
22466
22467 # type: textblock
22468 #. type: textblock
22469 #: ../fish/guestfish.pod:445
22470 msgid "add or -a/--add"
22471 msgstr ""
22472
22473 # type: textblock
22474 #. type: textblock
22475 #: ../fish/guestfish.pod:449
22476 msgid "launch (aka run)"
22477 msgstr ""
22478
22479 # type: textblock
22480 #. type: textblock
22481 #: ../fish/guestfish.pod:453
22482 msgid "mount or -m/--mount"
22483 msgstr ""
22484
22485 # type: textblock
22486 #. type: textblock
22487 #: ../fish/guestfish.pod:457
22488 msgid "any other commands"
22489 msgstr ""
22490
22491 # type: textblock
22492 #. type: textblock
22493 #: ../fish/guestfish.pod:461
22494 msgid ""
22495 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
22496 "guest before mounting or performing any other commands."
22497 msgstr ""
22498
22499 # type: textblock
22500 #. type: textblock
22501 #: ../fish/guestfish.pod:464
22502 msgid ""
22503 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
22504 "I<--new> options were given then C<run> is done automatically, simply "
22505 "because guestfish can't perform the action you asked for without doing this."
22506 msgstr ""
22507
22508 # type: =head1
22509 #. type: =head1
22510 #: ../fish/guestfish.pod:469
22511 msgid "OPENING DISKS FOR READ AND WRITE"
22512 msgstr ""
22513
22514 #. type: textblock
22515 #: ../fish/guestfish.pod:471
22516 msgid ""
22517 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
22518 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
22519 "I<-i> and I<-m> open disk images read-only or for writing."
22520 msgstr ""
22521
22522 #. type: textblock
22523 #: ../fish/guestfish.pod:476
22524 msgid ""
22525 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
22526 "opening disk images supplied on the command line for write.  To open a disk "
22527 "image read-only you have to do I<-a image --ro>."
22528 msgstr ""
22529
22530 # type: textblock
22531 #. type: textblock
22532 #: ../fish/guestfish.pod:480
22533 msgid ""
22534 "This matters: If you accidentally open a live VM disk image writable then "
22535 "you will cause irreversible disk corruption."
22536 msgstr ""
22537
22538 #. type: textblock
22539 #: ../fish/guestfish.pod:483
22540 msgid ""
22541 "By libguestfs 1.12 we intend to change the default the other way.  Disk "
22542 "images will be opened read-only.  You will have to either specify "
22543 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
22544 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
22545 "access for disk images specified by those other command line options."
22546 msgstr ""
22547
22548 #. type: textblock
22549 #: ../fish/guestfish.pod:490
22550 msgid ""
22551 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
22552 "which does nothing (it is already the default).  However it is highly "
22553 "recommended that you use this option to indicate that you need write access, "
22554 "and prepare your scripts for the day when this option will be required for "
22555 "write access."
22556 msgstr ""
22557
22558 # type: textblock
22559 #. type: textblock
22560 #: ../fish/guestfish.pod:496
22561 msgid ""
22562 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
22563 "other libguestfs program apart from guestfish and guestmount."
22564 msgstr ""
22565
22566 # type: =head1
22567 #. type: =head1
22568 #: ../fish/guestfish.pod:499
22569 msgid "QUOTING"
22570 msgstr ""
22571
22572 # type: textblock
22573 #. type: textblock
22574 #: ../fish/guestfish.pod:501
22575 msgid ""
22576 "You can quote ordinary parameters using either single or double quotes.  For "
22577 "example:"
22578 msgstr ""
22579
22580 # type: verbatim
22581 #. type: verbatim
22582 #: ../fish/guestfish.pod:504
22583 #, no-wrap
22584 msgid ""
22585 " add \"file with a space.img\"\n"
22586 "\n"
22587 msgstr ""
22588
22589 # type: verbatim
22590 #. type: verbatim
22591 #: ../fish/guestfish.pod:506
22592 #, no-wrap
22593 msgid ""
22594 " rm '/file name'\n"
22595 "\n"
22596 msgstr ""
22597
22598 # type: verbatim
22599 #. type: verbatim
22600 #: ../fish/guestfish.pod:508
22601 #, no-wrap
22602 msgid ""
22603 " rm '/\"'\n"
22604 "\n"
22605 msgstr ""
22606
22607 # type: textblock
22608 #. type: textblock
22609 #: ../fish/guestfish.pod:510
22610 msgid ""
22611 "A few commands require a list of strings to be passed.  For these, use a "
22612 "whitespace-separated list, enclosed in quotes.  Strings containing "
22613 "whitespace to be passed through must be enclosed in single quotes.  A "
22614 "literal single quote must be escaped with a backslash."
22615 msgstr ""
22616
22617 # type: verbatim
22618 #. type: verbatim
22619 #: ../fish/guestfish.pod:515
22620 #, no-wrap
22621 msgid ""
22622 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
22623 " command \"/bin/echo 'foo      bar'\"\n"
22624 " command \"/bin/echo \\'foo\\'\"\n"
22625 "\n"
22626 msgstr ""
22627
22628 # type: =head1
22629 #. type: =head1
22630 #: ../fish/guestfish.pod:519
22631 msgid "OPTIONAL ARGUMENTS"
22632 msgstr ""
22633
22634 # type: textblock
22635 #. type: textblock
22636 #: ../fish/guestfish.pod:521
22637 msgid ""
22638 "Some commands take optional arguments.  These arguments appear in this "
22639 "documentation as C<[argname:..]>.  You can use them as in these examples:"
22640 msgstr ""
22641
22642 # type: verbatim
22643 #. type: verbatim
22644 #: ../fish/guestfish.pod:525
22645 #, no-wrap
22646 msgid ""
22647 " add-drive-opts filename\n"
22648 "\n"
22649 msgstr ""
22650
22651 # type: verbatim
22652 #. type: verbatim
22653 #: ../fish/guestfish.pod:527
22654 #, no-wrap
22655 msgid ""
22656 " add-drive-opts filename readonly:true\n"
22657 "\n"
22658 msgstr ""
22659
22660 # type: verbatim
22661 #. type: verbatim
22662 #: ../fish/guestfish.pod:529
22663 #, no-wrap
22664 msgid ""
22665 " add-drive-opts filename format:qcow2 readonly:false\n"
22666 "\n"
22667 msgstr ""
22668
22669 # type: textblock
22670 #. type: textblock
22671 #: ../fish/guestfish.pod:531
22672 msgid ""
22673 "Each optional argument can appear at most once.  All optional arguments must "
22674 "appear after the required ones."
22675 msgstr ""
22676
22677 # type: =head1
22678 #. type: =head1
22679 #: ../fish/guestfish.pod:534
22680 msgid "NUMBERS"
22681 msgstr ""
22682
22683 # type: textblock
22684 #. type: textblock
22685 #: ../fish/guestfish.pod:536
22686 msgid ""
22687 "This section applies to all commands which can take integers as parameters."
22688 msgstr ""
22689
22690 # type: =head2
22691 #. type: =head2
22692 #: ../fish/guestfish.pod:539
22693 msgid "SIZE SUFFIX"
22694 msgstr ""
22695
22696 # type: textblock
22697 #. type: textblock
22698 #: ../fish/guestfish.pod:541
22699 msgid ""
22700 "When the command takes a parameter measured in bytes, you can use one of the "
22701 "following suffixes to specify kilobytes, megabytes and larger sizes:"
22702 msgstr ""
22703
22704 # type: =item
22705 #. type: =item
22706 #: ../fish/guestfish.pod:547
22707 msgid "B<k> or B<K> or B<KiB>"
22708 msgstr ""
22709
22710 # type: textblock
22711 #. type: textblock
22712 #: ../fish/guestfish.pod:549
22713 msgid "The size in kilobytes (multiplied by 1024)."
22714 msgstr ""
22715
22716 # type: =item
22717 #. type: =item
22718 #: ../fish/guestfish.pod:551
22719 msgid "B<KB>"
22720 msgstr ""
22721
22722 # type: textblock
22723 #. type: textblock
22724 #: ../fish/guestfish.pod:553
22725 msgid "The size in SI 1000 byte units."
22726 msgstr ""
22727
22728 # type: =item
22729 #. type: =item
22730 #: ../fish/guestfish.pod:555
22731 msgid "B<M> or B<MiB>"
22732 msgstr ""
22733
22734 # type: textblock
22735 #. type: textblock
22736 #: ../fish/guestfish.pod:557
22737 msgid "The size in megabytes (multiplied by 1048576)."
22738 msgstr ""
22739
22740 # type: =item
22741 #. type: =item
22742 #: ../fish/guestfish.pod:559
22743 msgid "B<MB>"
22744 msgstr ""
22745
22746 # type: textblock
22747 #. type: textblock
22748 #: ../fish/guestfish.pod:561
22749 msgid "The size in SI 1000000 byte units."
22750 msgstr ""
22751
22752 # type: =item
22753 #. type: =item
22754 #: ../fish/guestfish.pod:563
22755 msgid "B<G> or B<GiB>"
22756 msgstr ""
22757
22758 # type: textblock
22759 #. type: textblock
22760 #: ../fish/guestfish.pod:565
22761 msgid "The size in gigabytes (multiplied by 2**30)."
22762 msgstr ""
22763
22764 # type: =item
22765 #. type: =item
22766 #: ../fish/guestfish.pod:567
22767 msgid "B<GB>"
22768 msgstr ""
22769
22770 # type: textblock
22771 #. type: textblock
22772 #: ../fish/guestfish.pod:569
22773 msgid "The size in SI 10**9 byte units."
22774 msgstr ""
22775
22776 # type: =item
22777 #. type: =item
22778 #: ../fish/guestfish.pod:571
22779 msgid "B<T> or B<TiB>"
22780 msgstr ""
22781
22782 # type: textblock
22783 #. type: textblock
22784 #: ../fish/guestfish.pod:573
22785 msgid "The size in terabytes (multiplied by 2**40)."
22786 msgstr ""
22787
22788 # type: =item
22789 #. type: =item
22790 #: ../fish/guestfish.pod:575
22791 msgid "B<TB>"
22792 msgstr ""
22793
22794 # type: textblock
22795 #. type: textblock
22796 #: ../fish/guestfish.pod:577
22797 msgid "The size in SI 10**12 byte units."
22798 msgstr ""
22799
22800 # type: =item
22801 #. type: =item
22802 #: ../fish/guestfish.pod:579
22803 msgid "B<P> or B<PiB>"
22804 msgstr ""
22805
22806 # type: textblock
22807 #. type: textblock
22808 #: ../fish/guestfish.pod:581
22809 msgid "The size in petabytes (multiplied by 2**50)."
22810 msgstr ""
22811
22812 # type: =item
22813 #. type: =item
22814 #: ../fish/guestfish.pod:583
22815 msgid "B<PB>"
22816 msgstr ""
22817
22818 # type: textblock
22819 #. type: textblock
22820 #: ../fish/guestfish.pod:585
22821 msgid "The size in SI 10**15 byte units."
22822 msgstr ""
22823
22824 # type: =item
22825 #. type: =item
22826 #: ../fish/guestfish.pod:587
22827 msgid "B<E> or B<EiB>"
22828 msgstr ""
22829
22830 # type: textblock
22831 #. type: textblock
22832 #: ../fish/guestfish.pod:589
22833 msgid "The size in exabytes (multiplied by 2**60)."
22834 msgstr ""
22835
22836 # type: =item
22837 #. type: =item
22838 #: ../fish/guestfish.pod:591
22839 msgid "B<EB>"
22840 msgstr ""
22841
22842 # type: textblock
22843 #. type: textblock
22844 #: ../fish/guestfish.pod:593
22845 msgid "The size in SI 10**18 byte units."
22846 msgstr ""
22847
22848 # type: =item
22849 #. type: =item
22850 #: ../fish/guestfish.pod:595
22851 msgid "B<Z> or B<ZiB>"
22852 msgstr ""
22853
22854 # type: textblock
22855 #. type: textblock
22856 #: ../fish/guestfish.pod:597
22857 msgid "The size in zettabytes (multiplied by 2**70)."
22858 msgstr ""
22859
22860 # type: =item
22861 #. type: =item
22862 #: ../fish/guestfish.pod:599
22863 msgid "B<ZB>"
22864 msgstr ""
22865
22866 # type: textblock
22867 #. type: textblock
22868 #: ../fish/guestfish.pod:601
22869 msgid "The size in SI 10**21 byte units."
22870 msgstr ""
22871
22872 # type: =item
22873 #. type: =item
22874 #: ../fish/guestfish.pod:603
22875 msgid "B<Y> or B<YiB>"
22876 msgstr ""
22877
22878 # type: textblock
22879 #. type: textblock
22880 #: ../fish/guestfish.pod:605
22881 msgid "The size in yottabytes (multiplied by 2**80)."
22882 msgstr ""
22883
22884 # type: =item
22885 #. type: =item
22886 #: ../fish/guestfish.pod:607
22887 msgid "B<YB>"
22888 msgstr ""
22889
22890 # type: textblock
22891 #. type: textblock
22892 #: ../fish/guestfish.pod:609
22893 msgid "The size in SI 10**24 byte units."
22894 msgstr ""
22895
22896 # type: verbatim
22897 #. type: verbatim
22898 #: ../fish/guestfish.pod:615
22899 #, no-wrap
22900 msgid ""
22901 " truncate-size /file 1G\n"
22902 "\n"
22903 msgstr ""
22904
22905 # type: textblock
22906 #. type: textblock
22907 #: ../fish/guestfish.pod:617
22908 msgid "would truncate the file to 1 gigabyte."
22909 msgstr ""
22910
22911 # type: textblock
22912 #. type: textblock
22913 #: ../fish/guestfish.pod:619
22914 msgid ""
22915 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
22916 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
22917 "suffix will probably not do what you expect."
22918 msgstr ""
22919
22920 # type: =head2
22921 #. type: =head2
22922 #: ../fish/guestfish.pod:623
22923 msgid "OCTAL AND HEXADECIMAL NUMBERS"
22924 msgstr ""
22925
22926 # type: textblock
22927 #. type: textblock
22928 #: ../fish/guestfish.pod:625
22929 msgid ""
22930 "For specifying the radix (base) use the C convention: C<0> to prefix an "
22931 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
22932 msgstr ""
22933
22934 # type: verbatim
22935 #. type: verbatim
22936 #: ../fish/guestfish.pod:628
22937 #, no-wrap
22938 msgid ""
22939 " 1234      decimal number 1234\n"
22940 " 02322     octal number, equivalent to decimal 1234\n"
22941 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
22942 "\n"
22943 msgstr ""
22944
22945 # type: textblock
22946 #. type: textblock
22947 #: ../fish/guestfish.pod:632
22948 msgid ""
22949 "When using the C<chmod> command, you almost always want to specify an octal "
22950 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
22951 "L<chmod(1)> program):"
22952 msgstr ""
22953
22954 # type: verbatim
22955 #. type: verbatim
22956 #: ../fish/guestfish.pod:636
22957 #, no-wrap
22958 msgid ""
22959 " chmod 0777 /public  # OK\n"
22960 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
22961 "\n"
22962 msgstr ""
22963
22964 # type: textblock
22965 #. type: textblock
22966 #: ../fish/guestfish.pod:639
22967 msgid ""
22968 "Commands that return numbers usually print them in decimal, but some "
22969 "commands print numbers in other radices (eg. C<umask> prints the mode in "
22970 "octal, preceeded by C<0>)."
22971 msgstr ""
22972
22973 # type: =head1
22974 #. type: =head1
22975 #: ../fish/guestfish.pod:643
22976 msgid "WILDCARDS AND GLOBBING"
22977 msgstr ""
22978
22979 # type: textblock
22980 #. type: textblock
22981 #: ../fish/guestfish.pod:645
22982 msgid ""
22983 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
22984 "(globbing) by default.  So for example the following will not do what you "
22985 "expect:"
22986 msgstr ""
22987
22988 # type: verbatim
22989 #. type: verbatim
22990 #: ../fish/guestfish.pod:649
22991 #, no-wrap
22992 msgid ""
22993 " rm-rf /home/*\n"
22994 "\n"
22995 msgstr ""
22996
22997 # type: textblock
22998 #. type: textblock
22999 #: ../fish/guestfish.pod:651
23000 msgid ""
23001 "Assuming you don't have a directory called literally C</home/*> then the "
23002 "above command will return an error."
23003 msgstr ""
23004
23005 # type: textblock
23006 #. type: textblock
23007 #: ../fish/guestfish.pod:654
23008 msgid "To perform wildcard expansion, use the C<glob> command."
23009 msgstr ""
23010
23011 # type: verbatim
23012 #. type: verbatim
23013 #: ../fish/guestfish.pod:656
23014 #, no-wrap
23015 msgid ""
23016 " glob rm-rf /home/*\n"
23017 "\n"
23018 msgstr ""
23019
23020 # type: textblock
23021 #. type: textblock
23022 #: ../fish/guestfish.pod:658
23023 msgid ""
23024 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
23025 "many times), equivalent to:"
23026 msgstr ""
23027
23028 # type: verbatim
23029 #. type: verbatim
23030 #: ../fish/guestfish.pod:661
23031 #, no-wrap
23032 msgid ""
23033 " rm-rf /home/jim\n"
23034 " rm-rf /home/joe\n"
23035 " rm-rf /home/mary\n"
23036 "\n"
23037 msgstr ""
23038
23039 # type: textblock
23040 #. type: textblock
23041 #: ../fish/guestfish.pod:665
23042 msgid "C<glob> only works on simple guest paths and not on device names."
23043 msgstr ""
23044
23045 # type: textblock
23046 #. type: textblock
23047 #: ../fish/guestfish.pod:667
23048 msgid ""
23049 "If you have several parameters, each containing a wildcard, then glob will "
23050 "perform a Cartesian product."
23051 msgstr ""
23052
23053 # type: =head1
23054 #. type: =head1
23055 #: ../fish/guestfish.pod:670
23056 msgid "COMMENTS"
23057 msgstr ""
23058
23059 # type: textblock
23060 #. type: textblock
23061 #: ../fish/guestfish.pod:672
23062 msgid ""
23063 "Any line which starts with a I<#> character is treated as a comment and "
23064 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
23065 "a command.  For example:"
23066 msgstr ""
23067
23068 # type: verbatim
23069 #. type: verbatim
23070 #: ../fish/guestfish.pod:676
23071 #, no-wrap
23072 msgid ""
23073 " # this is a comment\n"
23074 "         # this is a comment\n"
23075 " foo # NOT a comment\n"
23076 "\n"
23077 msgstr ""
23078
23079 # type: textblock
23080 #. type: textblock
23081 #: ../fish/guestfish.pod:680
23082 msgid "Blank lines are also ignored."
23083 msgstr ""
23084
23085 # type: =head1
23086 #. type: =head1
23087 #: ../fish/guestfish.pod:682
23088 msgid "RUNNING COMMANDS LOCALLY"
23089 msgstr ""
23090
23091 # type: textblock
23092 #. type: textblock
23093 #: ../fish/guestfish.pod:684
23094 msgid ""
23095 "Any line which starts with a I<!> character is treated as a command sent to "
23096 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
23097 msgstr ""
23098
23099 # type: verbatim
23100 #. type: verbatim
23101 #: ../fish/guestfish.pod:688
23102 #, no-wrap
23103 msgid ""
23104 " !mkdir local\n"
23105 " tgz-out /remote local/remote-data.tar.gz\n"
23106 "\n"
23107 msgstr ""
23108
23109 # type: textblock
23110 #. type: textblock
23111 #: ../fish/guestfish.pod:691
23112 msgid ""
23113 "will create a directory C<local> on the host, and then export the contents "
23114 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
23115 "(See C<tgz-out>)."
23116 msgstr ""
23117
23118 # type: textblock
23119 #. type: textblock
23120 #: ../fish/guestfish.pod:695
23121 msgid ""
23122 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
23123 "effect, due to the way that subprocesses work in Unix."
23124 msgstr ""
23125
23126 #. type: =head2
23127 #: ../fish/guestfish.pod:698
23128 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
23129 msgstr ""
23130
23131 #. type: textblock
23132 #: ../fish/guestfish.pod:700
23133 msgid ""
23134 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
23135 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
23136 "and executed as guestfish commands."
23137 msgstr ""
23138
23139 #. type: textblock
23140 #: ../fish/guestfish.pod:704
23141 msgid ""
23142 "Thus you can use shell script to construct arbitrary guestfish commands "
23143 "which are then parsed by guestfish."
23144 msgstr ""
23145
23146 #. type: textblock
23147 #: ../fish/guestfish.pod:707
23148 msgid ""
23149 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
23150 "through C</foo.100>) using guestfish commands alone.  However this is simple "
23151 "if we use a shell script to create the guestfish commands for us:"
23152 msgstr ""
23153
23154 #. type: verbatim
23155 #: ../fish/guestfish.pod:712
23156 #, no-wrap
23157 msgid ""
23158 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
23159 "\n"
23160 msgstr ""
23161
23162 #. type: textblock
23163 #: ../fish/guestfish.pod:714
23164 msgid "or with names like C</foo.001>:"
23165 msgstr ""
23166
23167 #. type: verbatim
23168 #: ../fish/guestfish.pod:716
23169 #, no-wrap
23170 msgid ""
23171 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
23172 "\n"
23173 msgstr ""
23174
23175 #. type: textblock
23176 #: ../fish/guestfish.pod:718
23177 msgid ""
23178 "When using guestfish interactively it can be helpful to just run the shell "
23179 "script first (ie. remove the initial C<E<lt>> character so it is just an "
23180 "ordinary I<!> local command), see what guestfish commands it would run, and "
23181 "when you are happy with those prepend the C<E<lt>> character to run the "
23182 "guestfish commands for real."
23183 msgstr ""
23184
23185 # type: =head1
23186 #. type: =head1
23187 #: ../fish/guestfish.pod:724
23188 msgid "PIPES"
23189 msgstr ""
23190
23191 # type: textblock
23192 #. type: textblock
23193 #: ../fish/guestfish.pod:726
23194 msgid ""
23195 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
23196 "command (a guestfish command) to the second command (any host command).  For "
23197 "example:"
23198 msgstr ""
23199
23200 # type: verbatim
23201 #. type: verbatim
23202 #: ../fish/guestfish.pod:730
23203 #, no-wrap
23204 msgid ""
23205 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
23206 "\n"
23207 msgstr ""
23208
23209 # type: textblock
23210 #. type: textblock
23211 #: ../fish/guestfish.pod:732
23212 msgid ""
23213 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
23214 "program).  The above command would list all accounts in the guest filesystem "
23215 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
23216 msgstr ""
23217
23218 # type: verbatim
23219 #. type: verbatim
23220 #: ../fish/guestfish.pod:737
23221 #, no-wrap
23222 msgid ""
23223 " hexdump /bin/ls | head\n"
23224 " list-devices | tail -1\n"
23225 " tgz-out / - | tar ztf -\n"
23226 "\n"
23227 msgstr ""
23228
23229 # type: textblock
23230 #. type: textblock
23231 #: ../fish/guestfish.pod:741
23232 msgid ""
23233 "The space before the pipe symbol is required, any space after the pipe "
23234 "symbol is optional.  Everything after the pipe symbol is just passed "
23235 "straight to the host shell, so it can contain redirections, globs and "
23236 "anything else that makes sense on the host side."
23237 msgstr ""
23238
23239 # type: textblock
23240 #. type: textblock
23241 #: ../fish/guestfish.pod:746
23242 msgid ""
23243 "To use a literal argument which begins with a pipe symbol, you have to quote "
23244 "it, eg:"
23245 msgstr ""
23246
23247 # type: verbatim
23248 #. type: verbatim
23249 #: ../fish/guestfish.pod:749
23250 #, no-wrap
23251 msgid ""
23252 " echo \"|\"\n"
23253 "\n"
23254 msgstr ""
23255
23256 # type: =head1
23257 #. type: =head1
23258 #: ../fish/guestfish.pod:751
23259 msgid "HOME DIRECTORIES"
23260 msgstr ""
23261
23262 # type: textblock
23263 #. type: textblock
23264 #: ../fish/guestfish.pod:753
23265 msgid ""
23266 "If a parameter starts with the character C<~> then the tilde may be expanded "
23267 "as a home directory path (either C<~> for the current user's home directory, "
23268 "or C<~user> for another user)."
23269 msgstr ""
23270
23271 # type: textblock
23272 #. type: textblock
23273 #: ../fish/guestfish.pod:757
23274 msgid ""
23275 "Note that home directory expansion happens for users known I<on the host>, "
23276 "not in the guest filesystem."
23277 msgstr ""
23278
23279 # type: textblock
23280 #. type: textblock
23281 #: ../fish/guestfish.pod:760
23282 msgid ""
23283 "To use a literal argument which begins with a tilde, you have to quote it, "
23284 "eg:"
23285 msgstr ""
23286
23287 # type: verbatim
23288 #. type: verbatim
23289 #: ../fish/guestfish.pod:763
23290 #, no-wrap
23291 msgid ""
23292 " echo \"~\"\n"
23293 "\n"
23294 msgstr ""
23295
23296 # type: textblock
23297 #. type: textblock
23298 #: ../fish/guestfish.pod:767
23299 msgid ""
23300 "Libguestfs has some support for Linux guests encrypted according to the "
23301 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
23302 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
23303 "LUKS is supported."
23304 msgstr ""
23305
23306 # type: textblock
23307 #. type: textblock
23308 #: ../fish/guestfish.pod:772
23309 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
23310 msgstr ""
23311
23312 # type: verbatim
23313 #. type: verbatim
23314 #: ../fish/guestfish.pod:774
23315 #, no-wrap
23316 msgid ""
23317 " ><fs> vfs-type /dev/sda2\n"
23318 " crypto_LUKS\n"
23319 "\n"
23320 msgstr ""
23321
23322 # type: textblock
23323 #. type: textblock
23324 #: ../fish/guestfish.pod:777
23325 msgid ""
23326 "Then open those devices using L</luks-open>.  This creates a device-mapper "
23327 "device called C</dev/mapper/luksdev>."
23328 msgstr ""
23329
23330 # type: verbatim
23331 #. type: verbatim
23332 #: ../fish/guestfish.pod:780
23333 #, no-wrap
23334 msgid ""
23335 " ><fs> luks-open /dev/sda2 luksdev\n"
23336 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
23337 "\n"
23338 msgstr ""
23339
23340 # type: textblock
23341 #. type: textblock
23342 #: ../fish/guestfish.pod:783
23343 msgid ""
23344 "Finally you have to tell LVM to scan for volume groups on the newly created "
23345 "mapper device:"
23346 msgstr ""
23347
23348 # type: verbatim
23349 #. type: verbatim
23350 #: ../fish/guestfish.pod:786
23351 #, no-wrap
23352 msgid ""
23353 " vgscan\n"
23354 " vg-activate-all true\n"
23355 "\n"
23356 msgstr ""
23357
23358 # type: textblock
23359 #. type: textblock
23360 #: ../fish/guestfish.pod:789
23361 msgid "The logical volume(s) can now be mounted in the usual way."
23362 msgstr ""
23363
23364 # type: textblock
23365 #. type: textblock
23366 #: ../fish/guestfish.pod:791
23367 msgid ""
23368 "Before closing a LUKS device you must unmount any logical volumes on it and "
23369 "deactivate the volume groups by calling C<vg-activate false VG> on each "
23370 "one.  Then you can close the mapper device:"
23371 msgstr ""
23372
23373 # type: verbatim
23374 #. type: verbatim
23375 #: ../fish/guestfish.pod:795
23376 #, no-wrap
23377 msgid ""
23378 " vg-activate false /dev/VG\n"
23379 " luks-close /dev/mapper/luksdev\n"
23380 "\n"
23381 msgstr ""
23382
23383 # type: =head1
23384 #. type: =head1
23385 #: ../fish/guestfish.pod:798 ../tools/virt-edit.pl:342
23386 msgid "WINDOWS PATHS"
23387 msgstr ""
23388
23389 #. type: textblock
23390 #: ../fish/guestfish.pod:800
23391 msgid ""
23392 "If a path is prefixed with C<win:> then you can use Windows-style drive "
23393 "letters and paths (with some limitations).  The following commands are "
23394 "equivalent:"
23395 msgstr ""
23396
23397 # type: verbatim
23398 #. type: verbatim
23399 #: ../fish/guestfish.pod:804
23400 #, no-wrap
23401 msgid ""
23402 " file /WINDOWS/system32/config/system.LOG\n"
23403 "\n"
23404 msgstr ""
23405
23406 # type: verbatim
23407 #. type: verbatim
23408 #: ../fish/guestfish.pod:806
23409 #, no-wrap
23410 msgid ""
23411 " file win:\\windows\\system32\\config\\system.log\n"
23412 "\n"
23413 msgstr ""
23414
23415 #. type: verbatim
23416 #: ../fish/guestfish.pod:808
23417 #, no-wrap
23418 msgid ""
23419 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
23420 "\n"
23421 msgstr ""
23422
23423 #. type: textblock
23424 #: ../fish/guestfish.pod:810
23425 msgid ""
23426 "The parameter is rewritten \"behind the scenes\" by looking up the position "
23427 "where the drive is mounted, prepending that to the path, changing all "
23428 "backslash characters to forward slash, then resolving the result using L</"
23429 "case-sensitive-path>.  For example if the E: drive was mounted on C</e> then "
23430 "the parameter might be rewritten like this:"
23431 msgstr ""
23432
23433 #. type: verbatim
23434 #: ../fish/guestfish.pod:816
23435 #, no-wrap
23436 msgid ""
23437 " win:e:\\foo\\bar => /e/FOO/bar\n"
23438 "\n"
23439 msgstr ""
23440
23441 #. type: textblock
23442 #: ../fish/guestfish.pod:818
23443 msgid "This only works in argument positions that expect a path."
23444 msgstr ""
23445
23446 # type: =head1
23447 #. type: =head1
23448 #: ../fish/guestfish.pod:820
23449 msgid "UPLOADING AND DOWNLOADING FILES"
23450 msgstr ""
23451
23452 # type: textblock
23453 #. type: textblock
23454 #: ../fish/guestfish.pod:822
23455 msgid ""
23456 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
23457 "others which upload from or download to a local file, you can use the "
23458 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
23459 msgstr ""
23460
23461 # type: verbatim
23462 #. type: verbatim
23463 #: ../fish/guestfish.pod:826
23464 #, no-wrap
23465 msgid ""
23466 " upload - /foo\n"
23467 "\n"
23468 msgstr ""
23469
23470 # type: textblock
23471 #. type: textblock
23472 #: ../fish/guestfish.pod:828
23473 msgid ""
23474 "reads stdin and creates from that a file C</foo> in the disk image, and:"
23475 msgstr ""
23476
23477 # type: verbatim
23478 #. type: verbatim
23479 #: ../fish/guestfish.pod:831
23480 #, no-wrap
23481 msgid ""
23482 " tar-out /etc - | tar tf -\n"
23483 "\n"
23484 msgstr ""
23485
23486 # type: textblock
23487 #. type: textblock
23488 #: ../fish/guestfish.pod:833
23489 msgid ""
23490 "writes the tarball to stdout and then pipes that into the external \"tar\" "
23491 "command (see L</PIPES>)."
23492 msgstr ""
23493
23494 # type: textblock
23495 #. type: textblock
23496 #: ../fish/guestfish.pod:836
23497 msgid ""
23498 "When using C<-> to read from stdin, the input is read up to the end of "
23499 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
23500 "some arbitrary end marker:"
23501 msgstr ""
23502
23503 # type: verbatim
23504 #. type: verbatim
23505 #: ../fish/guestfish.pod:840
23506 #, no-wrap
23507 msgid ""
23508 " upload -<<END /foo\n"
23509 " input line 1\n"
23510 " input line 2\n"
23511 " input line 3\n"
23512 " END\n"
23513 "\n"
23514 msgstr ""
23515
23516 # type: textblock
23517 #. type: textblock
23518 #: ../fish/guestfish.pod:846
23519 msgid ""
23520 "Any string of characters can be used instead of C<END>.  The end marker must "
23521 "appear on a line of its own, without any preceeding or following characters "
23522 "(not even spaces)."
23523 msgstr ""
23524
23525 # type: textblock
23526 #. type: textblock
23527 #: ../fish/guestfish.pod:850
23528 msgid ""
23529 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
23530 "upload local files (so-called \"FileIn\" parameters in the generator)."
23531 msgstr ""
23532
23533 # type: =head1
23534 #. type: =head1
23535 #: ../fish/guestfish.pod:853
23536 msgid "EXIT ON ERROR BEHAVIOUR"
23537 msgstr ""
23538
23539 # type: textblock
23540 #. type: textblock
23541 #: ../fish/guestfish.pod:855
23542 msgid ""
23543 "By default, guestfish will ignore any errors when in interactive mode (ie. "
23544 "taking commands from a human over a tty), and will exit on the first error "
23545 "in non-interactive mode (scripts, commands given on the command line)."
23546 msgstr ""
23547
23548 # type: textblock
23549 #. type: textblock
23550 #: ../fish/guestfish.pod:860
23551 msgid ""
23552 "If you prefix a command with a I<-> character, then that command will not "
23553 "cause guestfish to exit, even if that (one) command returns an error."
23554 msgstr ""
23555
23556 # type: =head1
23557 #. type: =head1
23558 #: ../fish/guestfish.pod:864
23559 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
23560 msgstr ""
23561
23562 # type: textblock
23563 #. type: textblock
23564 #: ../fish/guestfish.pod:866
23565 msgid ""
23566 "Guestfish can be remote-controlled over a socket.  This is useful "
23567 "particularly in shell scripts where you want to make several different "
23568 "changes to a filesystem, but you don't want the overhead of starting up a "
23569 "guestfish process each time."
23570 msgstr ""
23571
23572 # type: textblock
23573 #. type: textblock
23574 #: ../fish/guestfish.pod:871
23575 msgid "Start a guestfish server process using:"
23576 msgstr ""
23577
23578 # type: verbatim
23579 #. type: verbatim
23580 #: ../fish/guestfish.pod:873
23581 #, no-wrap
23582 msgid ""
23583 " eval \"`guestfish --listen`\"\n"
23584 "\n"
23585 msgstr ""
23586
23587 # type: textblock
23588 #. type: textblock
23589 #: ../fish/guestfish.pod:875
23590 msgid "and then send it commands by doing:"
23591 msgstr ""
23592
23593 # type: verbatim
23594 #. type: verbatim
23595 #: ../fish/guestfish.pod:877
23596 #, no-wrap
23597 msgid ""
23598 " guestfish --remote cmd [...]\n"
23599 "\n"
23600 msgstr ""
23601
23602 # type: textblock
23603 #. type: textblock
23604 #: ../fish/guestfish.pod:879
23605 msgid "To cause the server to exit, send it the exit command:"
23606 msgstr ""
23607
23608 # type: verbatim
23609 #. type: verbatim
23610 #: ../fish/guestfish.pod:881
23611 #, no-wrap
23612 msgid ""
23613 " guestfish --remote exit\n"
23614 "\n"
23615 msgstr ""
23616
23617 # type: textblock
23618 #. type: textblock
23619 #: ../fish/guestfish.pod:883
23620 msgid ""
23621 "Note that the server will normally exit if there is an error in a command.  "
23622 "You can change this in the usual way.  See section L</EXIT ON ERROR "
23623 "BEHAVIOUR>."
23624 msgstr ""
23625
23626 # type: =head2
23627 #. type: =head2
23628 #: ../fish/guestfish.pod:887
23629 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
23630 msgstr ""
23631
23632 # type: textblock
23633 #. type: textblock
23634 #: ../fish/guestfish.pod:889
23635 msgid ""
23636 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
23637 "is how the I<--remote> option knows where to send the commands.  You can "
23638 "have several guestfish listener processes running using:"
23639 msgstr ""
23640
23641 # type: verbatim
23642 #. type: verbatim
23643 #: ../fish/guestfish.pod:893
23644 #, no-wrap
23645 msgid ""
23646 " eval \"`guestfish --listen`\"\n"
23647 " pid1=$GUESTFISH_PID\n"
23648 " eval \"`guestfish --listen`\"\n"
23649 " pid2=$GUESTFISH_PID\n"
23650 " ...\n"
23651 " guestfish --remote=$pid1 cmd\n"
23652 " guestfish --remote=$pid2 cmd\n"
23653 "\n"
23654 msgstr ""
23655
23656 # type: =head2
23657 #. type: =head2
23658 #: ../fish/guestfish.pod:901
23659 msgid "REMOTE CONTROL AND CSH"
23660 msgstr ""
23661
23662 # type: textblock
23663 #. type: textblock
23664 #: ../fish/guestfish.pod:903
23665 msgid ""
23666 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
23667 "option:"
23668 msgstr ""
23669
23670 # type: verbatim
23671 #. type: verbatim
23672 #: ../fish/guestfish.pod:906
23673 #, no-wrap
23674 msgid ""
23675 " eval \"`guestfish --listen --csh`\"\n"
23676 "\n"
23677 msgstr ""
23678
23679 # type: =head2
23680 #. type: =head2
23681 #: ../fish/guestfish.pod:908
23682 msgid "REMOTE CONTROL DETAILS"
23683 msgstr ""
23684
23685 # type: textblock
23686 #. type: textblock
23687 #: ../fish/guestfish.pod:910
23688 msgid ""
23689 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
23690 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
23691 "and C<$PID> is the process ID of the server."
23692 msgstr ""
23693
23694 # type: textblock
23695 #. type: textblock
23696 #: ../fish/guestfish.pod:914
23697 msgid "Guestfish client and server versions must match exactly."
23698 msgstr ""
23699
23700 # type: =head1
23701 #. type: =head1
23702 #: ../fish/guestfish.pod:916
23703 msgid "PREPARED DISK IMAGES"
23704 msgstr ""
23705
23706 # type: textblock
23707 #. type: textblock
23708 #: ../fish/guestfish.pod:918
23709 msgid ""
23710 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
23711 "preformatted disk images that guestfish can make for you to save typing.  "
23712 "This is particularly useful for testing purposes.  This option is used "
23713 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
23714 "can be mixed with I<-a>)."
23715 msgstr ""
23716
23717 # type: textblock
23718 #. type: textblock
23719 #: ../fish/guestfish.pod:924
23720 msgid ""
23721 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
23722 "the second and so on.  Existing files in the current directory are "
23723 "I<overwritten>."
23724 msgstr ""
23725
23726 # type: textblock
23727 #. type: textblock
23728 #: ../fish/guestfish.pod:928
23729 msgid ""
23730 "The type briefly describes how the disk should be sized, partitioned, how "
23731 "filesystem(s) should be created, and how content should be added.  "
23732 "Optionally the type can be followed by extra parameters, separated by C<:> "
23733 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
23734 "allocated disk, containing a single partition, with the partition formatted "
23735 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
23736 "disk instead."
23737 msgstr ""
23738
23739 # type: textblock
23740 #. type: textblock
23741 #: ../fish/guestfish.pod:936
23742 msgid "To list the available types and any extra parameters they take, run:"
23743 msgstr ""
23744
23745 # type: textblock
23746 #. type: textblock
23747 #: ../fish/guestfish.pod:940
23748 msgid ""
23749 "Note that the prepared filesystem is not mounted.  You would usually have to "
23750 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
23751 msgstr ""
23752
23753 # type: textblock
23754 #. type: textblock
23755 #: ../fish/guestfish.pod:944
23756 msgid ""
23757 "If any I<-N> or I<--new> options are given, the guest is automatically "
23758 "launched."
23759 msgstr ""
23760
23761 # type: textblock
23762 #. type: textblock
23763 #: ../fish/guestfish.pod:949
23764 msgid "Create a 100MB disk with an ext4-formatted partition:"
23765 msgstr ""
23766
23767 # type: verbatim
23768 #. type: verbatim
23769 #: ../fish/guestfish.pod:951
23770 #, no-wrap
23771 msgid ""
23772 " guestfish -N fs:ext4\n"
23773 "\n"
23774 msgstr ""
23775
23776 # type: textblock
23777 #. type: textblock
23778 #: ../fish/guestfish.pod:953
23779 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
23780 msgstr ""
23781
23782 # type: verbatim
23783 #. type: verbatim
23784 #: ../fish/guestfish.pod:955
23785 #, no-wrap
23786 msgid ""
23787 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
23788 "\n"
23789 msgstr ""
23790
23791 # type: textblock
23792 #. type: textblock
23793 #: ../fish/guestfish.pod:957
23794 msgid "Create a blank 200MB disk:"
23795 msgstr ""
23796
23797 # type: verbatim
23798 #. type: verbatim
23799 #: ../fish/guestfish.pod:959
23800 #, no-wrap
23801 msgid ""
23802 " guestfish -N disk:200M\n"
23803 "\n"
23804 msgstr ""
23805
23806 # type: =head1
23807 #. type: =head1
23808 #: ../fish/guestfish.pod:961
23809 msgid "PROGRESS BARS"
23810 msgstr ""
23811
23812 # type: textblock
23813 #. type: textblock
23814 #: ../fish/guestfish.pod:963
23815 msgid ""
23816 "Some (not all) long-running commands send progress notification messages as "
23817 "they are running.  Guestfish turns these messages into progress bars."
23818 msgstr ""
23819
23820 # type: textblock
23821 #. type: textblock
23822 #: ../fish/guestfish.pod:967
23823 msgid ""
23824 "When a command that supports progress bars takes longer than two seconds to "
23825 "run, and if progress bars are enabled, then you will see one appearing below "
23826 "the command:"
23827 msgstr ""
23828
23829 # type: verbatim
23830 #. type: verbatim
23831 #: ../fish/guestfish.pod:971
23832 #, no-wrap
23833 msgid ""
23834 " ><fs> copy-size /large-file /another-file 2048M\n"
23835 " / 10% [#####-----------------------------------------] 00:30\n"
23836 "\n"
23837 msgstr ""
23838
23839 # type: textblock
23840 #. type: textblock
23841 #: ../fish/guestfish.pod:974
23842 msgid ""
23843 "The spinner on the left hand side moves round once for every progress "
23844 "notification received from the backend.  This is a (reasonably) golden "
23845 "assurance that the command is \"doing something\" even if the progress bar "
23846 "is not moving, because the command is able to send the progress "
23847 "notifications.  When the bar reaches 100% and the command finishes, the "
23848 "spinner disappears."
23849 msgstr ""
23850
23851 # type: textblock
23852 #. type: textblock
23853 #: ../fish/guestfish.pod:981
23854 msgid ""
23855 "Progress bars are enabled by default when guestfish is used interactively.  "
23856 "You can enable them even for non-interactive modes using I<--progress-bars>, "
23857 "and you can disable them completely using I<--no-progress-bars>."
23858 msgstr ""
23859
23860 # type: =head1
23861 #. type: =head1
23862 #: ../fish/guestfish.pod:986
23863 msgid "GUESTFISH COMMANDS"
23864 msgstr ""
23865
23866 # type: textblock
23867 #. type: textblock
23868 #: ../fish/guestfish.pod:988
23869 msgid ""
23870 "The commands in this section are guestfish convenience commands, in other "
23871 "words, they are not part of the L<guestfs(3)> API."
23872 msgstr ""
23873
23874 # type: =head2
23875 #. type: =head2
23876 #: ../fish/guestfish.pod:991
23877 msgid "help"
23878 msgstr ""
23879
23880 # type: verbatim
23881 #. type: verbatim
23882 #: ../fish/guestfish.pod:993
23883 #, no-wrap
23884 msgid ""
23885 " help\n"
23886 " help cmd\n"
23887 "\n"
23888 msgstr ""
23889
23890 # type: textblock
23891 #. type: textblock
23892 #: ../fish/guestfish.pod:996
23893 msgid "Without any parameter, this provides general help."
23894 msgstr ""
23895
23896 # type: textblock
23897 #. type: textblock
23898 #: ../fish/guestfish.pod:998
23899 msgid "With a C<cmd> parameter, this displays detailed help for that command."
23900 msgstr ""
23901
23902 # type: =head2
23903 #. type: =head2
23904 #: ../fish/guestfish.pod:1000
23905 msgid "quit | exit"
23906 msgstr ""
23907
23908 # type: textblock
23909 #. type: textblock
23910 #: ../fish/guestfish.pod:1002
23911 msgid "This exits guestfish.  You can also use C<^D> key."
23912 msgstr ""
23913
23914 # type: textblock
23915 #. type: textblock
23916 #: ../fish/guestfish.pod:1004
23917 msgid "@FISH_COMMANDS@"
23918 msgstr ""
23919
23920 # type: =head1
23921 #. type: =head1
23922 #: ../fish/guestfish.pod:1006
23923 msgid "COMMANDS"
23924 msgstr ""
23925
23926 # type: =head1
23927 #. type: =head1
23928 #: ../fish/guestfish.pod:1010 ../test-tool/libguestfs-test-tool.pod:77
23929 msgid "EXIT CODE"
23930 msgstr ""
23931
23932 # type: textblock
23933 #. type: textblock
23934 #: ../fish/guestfish.pod:1012
23935 msgid ""
23936 "guestfish returns 0 if the commands completed without error, or 1 if there "
23937 "was an error."
23938 msgstr ""
23939
23940 # type: =item
23941 #. type: =item
23942 #: ../fish/guestfish.pod:1019
23943 msgid "EDITOR"
23944 msgstr ""
23945
23946 # type: textblock
23947 #. type: textblock
23948 #: ../fish/guestfish.pod:1021
23949 msgid ""
23950 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
23951 "C<vi>."
23952 msgstr ""
23953
23954 # type: =item
23955 #. type: =item
23956 #: ../fish/guestfish.pod:1024
23957 msgid "GUESTFISH_PID"
23958 msgstr ""
23959
23960 # type: textblock
23961 #. type: textblock
23962 #: ../fish/guestfish.pod:1026
23963 msgid ""
23964 "Used with the I<--remote> option to specify the remote guestfish process to "
23965 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
23966 msgstr ""
23967
23968 # type: =item
23969 #. type: =item
23970 #: ../fish/guestfish.pod:1030
23971 msgid "HEXEDITOR"
23972 msgstr ""
23973
23974 # type: textblock
23975 #. type: textblock
23976 #: ../fish/guestfish.pod:1032
23977 msgid ""
23978 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
23979 "not specified, the external L<hexedit(1)> program is used."
23980 msgstr ""
23981
23982 # type: =item
23983 #. type: =item
23984 #: ../fish/guestfish.pod:1036
23985 msgid "HOME"
23986 msgstr ""
23987
23988 # type: textblock
23989 #. type: textblock
23990 #: ../fish/guestfish.pod:1038
23991 msgid ""
23992 "If compiled with GNU readline support, various files in the home directory "
23993 "can be used.  See L</FILES>."
23994 msgstr ""
23995
23996 # type: textblock
23997 #. type: textblock
23998 #: ../fish/guestfish.pod:1047
23999 msgid ""
24000 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
24001 "effect as using the B<-v> option."
24002 msgstr ""
24003
24004 # type: textblock
24005 #. type: textblock
24006 #: ../fish/guestfish.pod:1059
24007 msgid ""
24008 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
24009 "the discussion of paths in L<guestfs(3)>."
24010 msgstr ""
24011
24012 # type: textblock
24013 #. type: textblock
24014 #: ../fish/guestfish.pod:1070
24015 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
24016 msgstr ""
24017
24018 # type: =item
24019 #. type: =item
24020 #: ../fish/guestfish.pod:1072
24021 msgid "PAGER"
24022 msgstr ""
24023
24024 # type: textblock
24025 #. type: textblock
24026 #: ../fish/guestfish.pod:1074
24027 msgid ""
24028 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
24029 "C<more>."
24030 msgstr ""
24031
24032 # type: =head1
24033 #. type: =head1
24034 #: ../fish/guestfish.pod:1090 ../fuse/guestmount.pod:252
24035 msgid "FILES"
24036 msgstr ""
24037
24038 #. type: =item
24039 #: ../fish/guestfish.pod:1094 ../fuse/guestmount.pod:256
24040 msgid "$HOME/.libguestfs-tools.rc"
24041 msgstr ""
24042
24043 #. type: =item
24044 #: ../fish/guestfish.pod:1096 ../fuse/guestmount.pod:258
24045 msgid "/etc/libguestfs-tools.conf"
24046 msgstr ""
24047
24048 #. type: textblock
24049 #: ../fish/guestfish.pod:1098 ../fuse/guestmount.pod:260
24050 msgid ""
24051 "This configuration file controls the default read-only or read-write mode "
24052 "(I<--ro> or I<--rw>)."
24053 msgstr ""
24054
24055 #. type: textblock
24056 #: ../fish/guestfish.pod:1101
24057 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
24058 msgstr ""
24059
24060 # type: =item
24061 #. type: =item
24062 #: ../fish/guestfish.pod:1103
24063 msgid "$HOME/.guestfish"
24064 msgstr ""
24065
24066 # type: textblock
24067 #. type: textblock
24068 #: ../fish/guestfish.pod:1105
24069 msgid ""
24070 "If compiled with GNU readline support, then the command history is saved in "
24071 "this file."
24072 msgstr ""
24073
24074 # type: =item
24075 #. type: =item
24076 #: ../fish/guestfish.pod:1108
24077 msgid "$HOME/.inputrc"
24078 msgstr ""
24079
24080 # type: =item
24081 #. type: =item
24082 #: ../fish/guestfish.pod:1110
24083 msgid "/etc/inputrc"
24084 msgstr ""
24085
24086 # type: textblock
24087 #. type: textblock
24088 #: ../fish/guestfish.pod:1112
24089 msgid ""
24090 "If compiled with GNU readline support, then these files can be used to "
24091 "configure readline.  For further information, please see L<readline(3)/"
24092 "INITIALIZATION FILE>."
24093 msgstr ""
24094
24095 # type: textblock
24096 #. type: textblock
24097 #: ../fish/guestfish.pod:1116
24098 msgid "To write rules which only apply to guestfish, use:"
24099 msgstr ""
24100
24101 # type: verbatim
24102 #. type: verbatim
24103 #: ../fish/guestfish.pod:1118
24104 #, no-wrap
24105 msgid ""
24106 " $if guestfish\n"
24107 " ...\n"
24108 " $endif\n"
24109 "\n"
24110 msgstr ""
24111
24112 # type: textblock
24113 #. type: textblock
24114 #: ../fish/guestfish.pod:1122
24115 msgid ""
24116 "Variables that you can set in inputrc that change the behaviour of guestfish "
24117 "in useful ways include:"
24118 msgstr ""
24119
24120 # type: =item
24121 #. type: =item
24122 #: ../fish/guestfish.pod:1127
24123 msgid "completion-ignore-case (default: on)"
24124 msgstr ""
24125
24126 # type: textblock
24127 #. type: textblock
24128 #: ../fish/guestfish.pod:1129
24129 msgid ""
24130 "By default, guestfish will ignore case when tab-completing paths on the "
24131 "disk.  Use:"
24132 msgstr ""
24133
24134 # type: verbatim
24135 #. type: verbatim
24136 #: ../fish/guestfish.pod:1132
24137 #, no-wrap
24138 msgid ""
24139 " set completion-ignore-case off\n"
24140 "\n"
24141 msgstr ""
24142
24143 # type: textblock
24144 #. type: textblock
24145 #: ../fish/guestfish.pod:1134
24146 msgid "to make guestfish case sensitive."
24147 msgstr ""
24148
24149 # type: =item
24150 #. type: =item
24151 #: ../fish/guestfish.pod:1138
24152 msgid "test1.img"
24153 msgstr ""
24154
24155 # type: =item
24156 #. type: =item
24157 #: ../fish/guestfish.pod:1140
24158 msgid "test2.img (etc)"
24159 msgstr ""
24160
24161 # type: textblock
24162 #. type: textblock
24163 #: ../fish/guestfish.pod:1142
24164 msgid ""
24165 "When using the C<-N> or C<--new> option, the prepared disk or filesystem "
24166 "will be created in the file C<test1.img> in the current directory.  The "
24167 "second use of C<-N> will use C<test2.img> and so on.  Any existing file with "
24168 "the same name will be overwritten."
24169 msgstr ""
24170
24171 #. type: textblock
24172 #: ../fish/guestfish.pod:1151
24173 msgid ""
24174 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
24175 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
24176 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
24177 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
24178 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
24179 ">, L<hexedit(1)>."
24180 msgstr ""
24181
24182 # type: textblock
24183 #. type: textblock
24184 #: ../fish/guestfish.pod:1181 ../test-tool/libguestfs-test-tool.pod:102
24185 #: ../fuse/guestmount.pod:287 ../tools/virt-edit.pl:518
24186 #: ../tools/virt-win-reg.pl:606 ../tools/virt-list-filesystems.pl:210
24187 #: ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572
24188 #: ../tools/virt-list-partitions.pl:277
24189 msgid ""
24190 "This program is free software; you can redistribute it and/or modify it "
24191 "under the terms of the GNU General Public License as published by the Free "
24192 "Software Foundation; either version 2 of the License, or (at your option) "
24193 "any later version."
24194 msgstr ""
24195
24196 # type: textblock
24197 #. type: textblock
24198 #: ../fish/guestfish.pod:1186 ../test-tool/libguestfs-test-tool.pod:107
24199 #: ../fuse/guestmount.pod:292 ../tools/virt-edit.pl:523
24200 #: ../tools/virt-win-reg.pl:611 ../tools/virt-list-filesystems.pl:215
24201 #: ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577
24202 #: ../tools/virt-list-partitions.pl:282
24203 msgid ""
24204 "This program is distributed in the hope that it will be useful, but WITHOUT "
24205 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
24206 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
24207 "more details."
24208 msgstr ""
24209
24210 # type: textblock
24211 #. type: textblock
24212 #: ../fish/guestfish.pod:1191 ../test-tool/libguestfs-test-tool.pod:112
24213 #: ../fuse/guestmount.pod:297 ../tools/virt-edit.pl:528
24214 #: ../tools/virt-win-reg.pl:616 ../tools/virt-list-filesystems.pl:220
24215 #: ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582
24216 #: ../tools/virt-list-partitions.pl:287
24217 msgid ""
24218 "You should have received a copy of the GNU General Public License along with "
24219 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
24220 "Ave, Cambridge, MA 02139, USA."
24221 msgstr ""
24222
24223 # type: =head2
24224 #. type: =head2
24225 #: ../fish/guestfish-actions.pod:1
24226 msgid "add-cdrom"
24227 msgstr ""
24228
24229 # type: verbatim
24230 #. type: verbatim
24231 #: ../fish/guestfish-actions.pod:3
24232 #, no-wrap
24233 msgid ""
24234 " add-cdrom filename\n"
24235 "\n"
24236 msgstr ""
24237
24238 # type: textblock
24239 #. type: textblock
24240 #: ../fish/guestfish-actions.pod:15
24241 msgid ""
24242 "This call checks for the existence of C<filename>.  This stops you from "
24243 "specifying other types of drive which are supported by qemu such as C<nbd:> "
24244 "and C<http:> URLs.  To specify those, use the general L</config> call "
24245 "instead."
24246 msgstr ""
24247
24248 # type: textblock
24249 #. type: textblock
24250 #: ../fish/guestfish-actions.pod:22
24251 msgid ""
24252 "If you just want to add an ISO file (often you use this as an efficient way "
24253 "to transfer large files into the guest), then you should probably use L</add-"
24254 "drive-ro> instead."
24255 msgstr ""
24256
24257 # type: =head2
24258 #. type: =head2
24259 #: ../fish/guestfish-actions.pod:35
24260 msgid "add-domain"
24261 msgstr ""
24262
24263 # type: =head2
24264 #. type: =head2
24265 #: ../fish/guestfish-actions.pod:37
24266 msgid "domain"
24267 msgstr ""
24268
24269 #. type: verbatim
24270 #: ../fish/guestfish-actions.pod:39
24271 #, no-wrap
24272 msgid ""
24273 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n"
24274 "\n"
24275 msgstr ""
24276
24277 # type: textblock
24278 #. type: textblock
24279 #: ../fish/guestfish-actions.pod:41
24280 msgid ""
24281 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
24282 "It works by connecting to libvirt, requesting the domain and domain XML from "
24283 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
24284 msgstr ""
24285
24286 # type: textblock
24287 #. type: textblock
24288 #: ../fish/guestfish-actions.pod:71
24289 msgid ""
24290 "The other optional parameters are passed directly through to L</add-drive-"
24291 "opts>."
24292 msgstr ""
24293
24294 # type: textblock
24295 #. type: textblock
24296 #: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138
24297 #: ../fish/guestfish-actions.pod:3047
24298 msgid ""
24299 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
24300 msgstr ""
24301
24302 # type: =head2
24303 #. type: =head2
24304 #: ../fish/guestfish-actions.pod:76
24305 msgid "add-drive"
24306 msgstr ""
24307
24308 # type: verbatim
24309 #. type: verbatim
24310 #: ../fish/guestfish-actions.pod:78
24311 #, no-wrap
24312 msgid ""
24313 " add-drive filename\n"
24314 "\n"
24315 msgstr ""
24316
24317 # type: textblock
24318 #. type: textblock
24319 #: ../fish/guestfish-actions.pod:80
24320 msgid ""
24321 "This function is the equivalent of calling L</add-drive-opts> with no "
24322 "optional parameters, so the disk is added writable, with the format being "
24323 "detected automatically."
24324 msgstr ""
24325
24326 # type: textblock
24327 #. type: textblock
24328 #: ../fish/guestfish-actions.pod:84
24329 msgid ""
24330 "Automatic detection of the format opens you up to a potential security hole "
24331 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
24332 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
24333 "you should think about replacing calls to this function with calls to L</add-"
24334 "drive-opts>, and specifying the format."
24335 msgstr ""
24336
24337 # type: =head2
24338 #. type: =head2
24339 #: ../fish/guestfish-actions.pod:91
24340 msgid "add-drive-opts"
24341 msgstr ""
24342
24343 # type: =head2
24344 #. type: =head2
24345 #: ../fish/guestfish-actions.pod:93
24346 msgid "add"
24347 msgstr ""
24348
24349 # type: verbatim
24350 #. type: verbatim
24351 #: ../fish/guestfish-actions.pod:95
24352 #, no-wrap
24353 msgid ""
24354 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
24355 "\n"
24356 msgstr ""
24357
24358 # type: textblock
24359 #. type: textblock
24360 #: ../fish/guestfish-actions.pod:122
24361 msgid ""
24362 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
24363 "add-drive-ro>) then the format is automatically detected.  Possible formats "
24364 "include C<raw> and C<qcow2>."
24365 msgstr ""
24366
24367 # type: textblock
24368 #. type: textblock
24369 #: ../fish/guestfish-actions.pod:133
24370 msgid ""
24371 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
24372 "add-drive-with-if> call (q.v.)"
24373 msgstr ""
24374
24375 # type: =head2
24376 #. type: =head2
24377 #: ../fish/guestfish-actions.pod:140
24378 msgid "add-drive-ro"
24379 msgstr ""
24380
24381 # type: =head2
24382 #. type: =head2
24383 #: ../fish/guestfish-actions.pod:142
24384 msgid "add-ro"
24385 msgstr ""
24386
24387 # type: verbatim
24388 #. type: verbatim
24389 #: ../fish/guestfish-actions.pod:144
24390 #, no-wrap
24391 msgid ""
24392 " add-drive-ro filename\n"
24393 "\n"
24394 msgstr ""
24395
24396 # type: textblock
24397 #. type: textblock
24398 #: ../fish/guestfish-actions.pod:146
24399 msgid ""
24400 "This function is the equivalent of calling L</add-drive-opts> with the "
24401 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
24402 "is added read-only, with the format being detected automatically."
24403 msgstr ""
24404
24405 # type: =head2
24406 #. type: =head2
24407 #: ../fish/guestfish-actions.pod:151
24408 msgid "add-drive-ro-with-if"
24409 msgstr ""
24410
24411 # type: verbatim
24412 #. type: verbatim
24413 #: ../fish/guestfish-actions.pod:153
24414 #, no-wrap
24415 msgid ""
24416 " add-drive-ro-with-if filename iface\n"
24417 "\n"
24418 msgstr ""
24419
24420 # type: textblock
24421 #. type: textblock
24422 #: ../fish/guestfish-actions.pod:155
24423 msgid ""
24424 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
24425 "interface emulation to use at run time."
24426 msgstr ""
24427
24428 # type: =head2
24429 #. type: =head2
24430 #: ../fish/guestfish-actions.pod:165
24431 msgid "add-drive-with-if"
24432 msgstr ""
24433
24434 # type: verbatim
24435 #. type: verbatim
24436 #: ../fish/guestfish-actions.pod:167
24437 #, no-wrap
24438 msgid ""
24439 " add-drive-with-if filename iface\n"
24440 "\n"
24441 msgstr ""
24442
24443 # type: textblock
24444 #. type: textblock
24445 #: ../fish/guestfish-actions.pod:169
24446 msgid ""
24447 "This is the same as L</add-drive> but it allows you to specify the QEMU "
24448 "interface emulation to use at run time."
24449 msgstr ""
24450
24451 # type: =head2
24452 #. type: =head2
24453 #: ../fish/guestfish-actions.pod:179
24454 msgid "aug-clear"
24455 msgstr ""
24456
24457 # type: verbatim
24458 #. type: verbatim
24459 #: ../fish/guestfish-actions.pod:181
24460 #, no-wrap
24461 msgid ""
24462 " aug-clear augpath\n"
24463 "\n"
24464 msgstr ""
24465
24466 # type: =head2
24467 #. type: =head2
24468 #: ../fish/guestfish-actions.pod:186
24469 msgid "aug-close"
24470 msgstr ""
24471
24472 # type: verbatim
24473 #. type: verbatim
24474 #: ../fish/guestfish-actions.pod:188
24475 #, no-wrap
24476 msgid ""
24477 " aug-close\n"
24478 "\n"
24479 msgstr ""
24480
24481 # type: textblock
24482 #. type: textblock
24483 #: ../fish/guestfish-actions.pod:190
24484 msgid ""
24485 "Close the current Augeas handle and free up any resources used by it.  After "
24486 "calling this, you have to call L</aug-init> again before you can use any "
24487 "other Augeas functions."
24488 msgstr ""
24489
24490 # type: =head2
24491 #. type: =head2
24492 #: ../fish/guestfish-actions.pod:195
24493 msgid "aug-defnode"
24494 msgstr ""
24495
24496 # type: verbatim
24497 #. type: verbatim
24498 #: ../fish/guestfish-actions.pod:197
24499 #, no-wrap
24500 msgid ""
24501 " aug-defnode name expr val\n"
24502 "\n"
24503 msgstr ""
24504
24505 # type: textblock
24506 #. type: textblock
24507 #: ../fish/guestfish-actions.pod:202
24508 msgid ""
24509 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
24510 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
24511 "containing that single node."
24512 msgstr ""
24513
24514 # type: =head2
24515 #. type: =head2
24516 #: ../fish/guestfish-actions.pod:210
24517 msgid "aug-defvar"
24518 msgstr ""
24519
24520 # type: verbatim
24521 #. type: verbatim
24522 #: ../fish/guestfish-actions.pod:212
24523 #, no-wrap
24524 msgid ""
24525 " aug-defvar name expr\n"
24526 "\n"
24527 msgstr ""
24528
24529 # type: =head2
24530 #. type: =head2
24531 #: ../fish/guestfish-actions.pod:221
24532 msgid "aug-get"
24533 msgstr ""
24534
24535 # type: verbatim
24536 #. type: verbatim
24537 #: ../fish/guestfish-actions.pod:223
24538 #, no-wrap
24539 msgid ""
24540 " aug-get augpath\n"
24541 "\n"
24542 msgstr ""
24543
24544 # type: =head2
24545 #. type: =head2
24546 #: ../fish/guestfish-actions.pod:228
24547 msgid "aug-init"
24548 msgstr ""
24549
24550 # type: verbatim
24551 #. type: verbatim
24552 #: ../fish/guestfish-actions.pod:230
24553 #, no-wrap
24554 msgid ""
24555 " aug-init root flags\n"
24556 "\n"
24557 msgstr ""
24558
24559 # type: textblock
24560 #. type: textblock
24561 #: ../fish/guestfish-actions.pod:236
24562 msgid "You must call this before using any other L</aug-*> commands."
24563 msgstr ""
24564
24565 # type: textblock
24566 #. type: textblock
24567 #: ../fish/guestfish-actions.pod:271
24568 msgid "Do not load the tree in L</aug-init>."
24569 msgstr ""
24570
24571 # type: textblock
24572 #. type: textblock
24573 #: ../fish/guestfish-actions.pod:275
24574 msgid "To close the handle, you can call L</aug-close>."
24575 msgstr ""
24576
24577 # type: =head2
24578 #. type: =head2
24579 #: ../fish/guestfish-actions.pod:279
24580 msgid "aug-insert"
24581 msgstr ""
24582
24583 # type: verbatim
24584 #. type: verbatim
24585 #: ../fish/guestfish-actions.pod:281
24586 #, no-wrap
24587 msgid ""
24588 " aug-insert augpath label true|false\n"
24589 "\n"
24590 msgstr ""
24591
24592 # type: =head2
24593 #. type: =head2
24594 #: ../fish/guestfish-actions.pod:291
24595 msgid "aug-load"
24596 msgstr ""
24597
24598 # type: verbatim
24599 #. type: verbatim
24600 #: ../fish/guestfish-actions.pod:293
24601 #, no-wrap
24602 msgid ""
24603 " aug-load\n"
24604 "\n"
24605 msgstr ""
24606
24607 # type: =head2
24608 #. type: =head2
24609 #: ../fish/guestfish-actions.pod:300
24610 msgid "aug-ls"
24611 msgstr ""
24612
24613 # type: verbatim
24614 #. type: verbatim
24615 #: ../fish/guestfish-actions.pod:302
24616 #, no-wrap
24617 msgid ""
24618 " aug-ls augpath\n"
24619 "\n"
24620 msgstr ""
24621
24622 # type: textblock
24623 #. type: textblock
24624 #: ../fish/guestfish-actions.pod:304
24625 msgid ""
24626 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
24627 "resulting nodes into alphabetical order."
24628 msgstr ""
24629
24630 # type: =head2
24631 #. type: =head2
24632 #: ../fish/guestfish-actions.pod:307
24633 msgid "aug-match"
24634 msgstr ""
24635
24636 # type: verbatim
24637 #. type: verbatim
24638 #: ../fish/guestfish-actions.pod:309
24639 #, no-wrap
24640 msgid ""
24641 " aug-match augpath\n"
24642 "\n"
24643 msgstr ""
24644
24645 # type: =head2
24646 #. type: =head2
24647 #: ../fish/guestfish-actions.pod:315
24648 msgid "aug-mv"
24649 msgstr ""
24650
24651 # type: verbatim
24652 #. type: verbatim
24653 #: ../fish/guestfish-actions.pod:317
24654 #, no-wrap
24655 msgid ""
24656 " aug-mv src dest\n"
24657 "\n"
24658 msgstr ""
24659
24660 # type: =head2
24661 #. type: =head2
24662 #: ../fish/guestfish-actions.pod:322
24663 msgid "aug-rm"
24664 msgstr ""
24665
24666 # type: verbatim
24667 #. type: verbatim
24668 #: ../fish/guestfish-actions.pod:324
24669 #, no-wrap
24670 msgid ""
24671 " aug-rm augpath\n"
24672 "\n"
24673 msgstr ""
24674
24675 # type: =head2
24676 #. type: =head2
24677 #: ../fish/guestfish-actions.pod:330
24678 msgid "aug-save"
24679 msgstr ""
24680
24681 # type: verbatim
24682 #. type: verbatim
24683 #: ../fish/guestfish-actions.pod:332
24684 #, no-wrap
24685 msgid ""
24686 " aug-save\n"
24687 "\n"
24688 msgstr ""
24689
24690 # type: textblock
24691 #. type: textblock
24692 #: ../fish/guestfish-actions.pod:336
24693 msgid ""
24694 "The flags which were passed to L</aug-init> affect exactly how files are "
24695 "saved."
24696 msgstr ""
24697
24698 # type: =head2
24699 #. type: =head2
24700 #: ../fish/guestfish-actions.pod:339
24701 msgid "aug-set"
24702 msgstr ""
24703
24704 # type: verbatim
24705 #. type: verbatim
24706 #: ../fish/guestfish-actions.pod:341
24707 #, no-wrap
24708 msgid ""
24709 " aug-set augpath val\n"
24710 "\n"
24711 msgstr ""
24712
24713 # type: textblock
24714 #. type: textblock
24715 #: ../fish/guestfish-actions.pod:345
24716 msgid ""
24717 "In the Augeas API, it is possible to clear a node by setting the value to "
24718 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
24719 "this call.  Instead you must use the L</aug-clear> call."
24720 msgstr ""
24721
24722 # type: =head2
24723 #. type: =head2
24724 #: ../fish/guestfish-actions.pod:350
24725 msgid "available"
24726 msgstr ""
24727
24728 # type: verbatim
24729 #. type: verbatim
24730 #: ../fish/guestfish-actions.pod:352
24731 #, no-wrap
24732 msgid ""
24733 " available 'groups ...'\n"
24734 "\n"
24735 msgstr ""
24736
24737 # type: textblock
24738 #. type: textblock
24739 #: ../fish/guestfish-actions.pod:358
24740 msgid ""
24741 "The libguestfs groups, and the functions that those groups correspond to, "
24742 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
24743 "runtime by calling L</available-all-groups>."
24744 msgstr ""
24745
24746 # type: textblock
24747 #. type: textblock
24748 #: ../fish/guestfish-actions.pod:382
24749 msgid "You must call L</launch> before calling this function."
24750 msgstr ""
24751
24752 # type: textblock
24753 #. type: textblock
24754 #: ../fish/guestfish-actions.pod:404
24755 msgid ""
24756 "This call was added in version C<1.0.80>.  In previous versions of "
24757 "libguestfs all you could do would be to speculatively execute a command to "
24758 "find out if the daemon implemented it.  See also L</version>."
24759 msgstr ""
24760
24761 # type: =head2
24762 #. type: =head2
24763 #: ../fish/guestfish-actions.pod:411
24764 msgid "available-all-groups"
24765 msgstr ""
24766
24767 # type: verbatim
24768 #. type: verbatim
24769 #: ../fish/guestfish-actions.pod:413
24770 #, no-wrap
24771 msgid ""
24772 " available-all-groups\n"
24773 "\n"
24774 msgstr ""
24775
24776 # type: textblock
24777 #. type: textblock
24778 #: ../fish/guestfish-actions.pod:415
24779 msgid ""
24780 "This command returns a list of all optional groups that this daemon knows "
24781 "about.  Note this returns both supported and unsupported groups.  To find "
24782 "out which ones the daemon can actually support you have to call L</"
24783 "available> on each member of the returned list."
24784 msgstr ""
24785
24786 # type: textblock
24787 #. type: textblock
24788 #: ../fish/guestfish-actions.pod:421
24789 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
24790 msgstr ""
24791
24792 # type: =head2
24793 #. type: =head2
24794 #: ../fish/guestfish-actions.pod:423
24795 msgid "base64-in"
24796 msgstr ""
24797
24798 # type: verbatim
24799 #. type: verbatim
24800 #: ../fish/guestfish-actions.pod:425
24801 #, no-wrap
24802 msgid ""
24803 " base64-in (base64file|-) filename\n"
24804 "\n"
24805 msgstr ""
24806
24807 # type: textblock
24808 #. type: textblock
24809 #: ../fish/guestfish-actions.pod:430 ../fish/guestfish-actions.pod:439
24810 #: ../fish/guestfish-actions.pod:663 ../fish/guestfish-actions.pod:832
24811 #: ../fish/guestfish-actions.pod:851 ../fish/guestfish-actions.pod:1228
24812 #: ../fish/guestfish-actions.pod:4445 ../fish/guestfish-actions.pod:4457
24813 #: ../fish/guestfish-actions.pod:4468 ../fish/guestfish-actions.pod:4479
24814 #: ../fish/guestfish-actions.pod:4531 ../fish/guestfish-actions.pod:4540
24815 #: ../fish/guestfish-actions.pod:4594 ../fish/guestfish-actions.pod:4617
24816 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
24817 msgstr ""
24818
24819 # type: =head2
24820 #. type: =head2
24821 #: ../fish/guestfish-actions.pod:432
24822 msgid "base64-out"
24823 msgstr ""
24824
24825 # type: verbatim
24826 #. type: verbatim
24827 #: ../fish/guestfish-actions.pod:434
24828 #, no-wrap
24829 msgid ""
24830 " base64-out filename (base64file|-)\n"
24831 "\n"
24832 msgstr ""
24833
24834 # type: =head2
24835 #. type: =head2
24836 #: ../fish/guestfish-actions.pod:441
24837 msgid "blockdev-flushbufs"
24838 msgstr ""
24839
24840 # type: verbatim
24841 #. type: verbatim
24842 #: ../fish/guestfish-actions.pod:443
24843 #, no-wrap
24844 msgid ""
24845 " blockdev-flushbufs device\n"
24846 "\n"
24847 msgstr ""
24848
24849 # type: =head2
24850 #. type: =head2
24851 #: ../fish/guestfish-actions.pod:450
24852 msgid "blockdev-getbsz"
24853 msgstr ""
24854
24855 # type: verbatim
24856 #. type: verbatim
24857 #: ../fish/guestfish-actions.pod:452
24858 #, no-wrap
24859 msgid ""
24860 " blockdev-getbsz device\n"
24861 "\n"
24862 msgstr ""
24863
24864 # type: =head2
24865 #. type: =head2
24866 #: ../fish/guestfish-actions.pod:461
24867 msgid "blockdev-getro"
24868 msgstr ""
24869
24870 # type: verbatim
24871 #. type: verbatim
24872 #: ../fish/guestfish-actions.pod:463
24873 #, no-wrap
24874 msgid ""
24875 " blockdev-getro device\n"
24876 "\n"
24877 msgstr ""
24878
24879 # type: =head2
24880 #. type: =head2
24881 #: ../fish/guestfish-actions.pod:470
24882 msgid "blockdev-getsize64"
24883 msgstr ""
24884
24885 # type: verbatim
24886 #. type: verbatim
24887 #: ../fish/guestfish-actions.pod:472
24888 #, no-wrap
24889 msgid ""
24890 " blockdev-getsize64 device\n"
24891 "\n"
24892 msgstr ""
24893
24894 # type: textblock
24895 #. type: textblock
24896 #: ../fish/guestfish-actions.pod:476
24897 msgid "See also L</blockdev-getsz>."
24898 msgstr ""
24899
24900 # type: =head2
24901 #. type: =head2
24902 #: ../fish/guestfish-actions.pod:480
24903 msgid "blockdev-getss"
24904 msgstr ""
24905
24906 # type: verbatim
24907 #. type: verbatim
24908 #: ../fish/guestfish-actions.pod:482
24909 #, no-wrap
24910 msgid ""
24911 " blockdev-getss device\n"
24912 "\n"
24913 msgstr ""
24914
24915 # type: textblock
24916 #. type: textblock
24917 #: ../fish/guestfish-actions.pod:487
24918 msgid ""
24919 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
24920 msgstr ""
24921
24922 # type: =head2
24923 #. type: =head2
24924 #: ../fish/guestfish-actions.pod:492
24925 msgid "blockdev-getsz"
24926 msgstr ""
24927
24928 # type: verbatim
24929 #. type: verbatim
24930 #: ../fish/guestfish-actions.pod:494
24931 #, no-wrap
24932 msgid ""
24933 " blockdev-getsz device\n"
24934 "\n"
24935 msgstr ""
24936
24937 # type: textblock
24938 #. type: textblock
24939 #: ../fish/guestfish-actions.pod:499
24940 msgid ""
24941 "See also L</blockdev-getss> for the real sector size of the device, and L</"
24942 "blockdev-getsize64> for the more useful I<size in bytes>."
24943 msgstr ""
24944
24945 # type: =head2
24946 #. type: =head2
24947 #: ../fish/guestfish-actions.pod:505
24948 msgid "blockdev-rereadpt"
24949 msgstr ""
24950
24951 # type: verbatim
24952 #. type: verbatim
24953 #: ../fish/guestfish-actions.pod:507
24954 #, no-wrap
24955 msgid ""
24956 " blockdev-rereadpt device\n"
24957 "\n"
24958 msgstr ""
24959
24960 # type: =head2
24961 #. type: =head2
24962 #: ../fish/guestfish-actions.pod:513
24963 msgid "blockdev-setbsz"
24964 msgstr ""
24965
24966 # type: verbatim
24967 #. type: verbatim
24968 #: ../fish/guestfish-actions.pod:515
24969 #, no-wrap
24970 msgid ""
24971 " blockdev-setbsz device blocksize\n"
24972 "\n"
24973 msgstr ""
24974
24975 # type: =head2
24976 #. type: =head2
24977 #: ../fish/guestfish-actions.pod:524
24978 msgid "blockdev-setro"
24979 msgstr ""
24980
24981 # type: verbatim
24982 #. type: verbatim
24983 #: ../fish/guestfish-actions.pod:526
24984 #, no-wrap
24985 msgid ""
24986 " blockdev-setro device\n"
24987 "\n"
24988 msgstr ""
24989
24990 # type: =head2
24991 #. type: =head2
24992 #: ../fish/guestfish-actions.pod:532
24993 msgid "blockdev-setrw"
24994 msgstr ""
24995
24996 # type: verbatim
24997 #. type: verbatim
24998 #: ../fish/guestfish-actions.pod:534
24999 #, no-wrap
25000 msgid ""
25001 " blockdev-setrw device\n"
25002 "\n"
25003 msgstr ""
25004
25005 # type: =head2
25006 #. type: =head2
25007 #: ../fish/guestfish-actions.pod:540
25008 msgid "case-sensitive-path"
25009 msgstr ""
25010
25011 # type: verbatim
25012 #. type: verbatim
25013 #: ../fish/guestfish-actions.pod:542
25014 #, no-wrap
25015 msgid ""
25016 " case-sensitive-path path\n"
25017 "\n"
25018 msgstr ""
25019
25020 # type: textblock
25021 #. type: textblock
25022 #: ../fish/guestfish-actions.pod:566
25023 msgid ""
25024 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
25025 "WINDOWS/system32\"> (the exact return value would depend on details of how "
25026 "the directories were originally created under Windows)."
25027 msgstr ""
25028
25029 # type: textblock
25030 #. type: textblock
25031 #: ../fish/guestfish-actions.pod:574
25032 msgid "See also L</realpath>."
25033 msgstr ""
25034
25035 # type: =head2
25036 #. type: =head2
25037 #: ../fish/guestfish-actions.pod:576
25038 msgid "cat"
25039 msgstr ""
25040
25041 # type: verbatim
25042 #. type: verbatim
25043 #: ../fish/guestfish-actions.pod:578
25044 #, no-wrap
25045 msgid ""
25046 " cat path\n"
25047 "\n"
25048 msgstr ""
25049
25050 # type: textblock
25051 #. type: textblock
25052 #: ../fish/guestfish-actions.pod:582
25053 msgid ""
25054 "Note that this function cannot correctly handle binary files (specifically, "
25055 "files containing C<\\0> character which is treated as end of string).  For "
25056 "those you need to use the L</read-file> or L</download> functions which have "
25057 "a more complex interface."
25058 msgstr ""
25059
25060 # type: =head2
25061 #. type: =head2
25062 #: ../fish/guestfish-actions.pod:590
25063 msgid "checksum"
25064 msgstr ""
25065
25066 # type: verbatim
25067 #. type: verbatim
25068 #: ../fish/guestfish-actions.pod:592
25069 #, no-wrap
25070 msgid ""
25071 " checksum csumtype path\n"
25072 "\n"
25073 msgstr ""
25074
25075 # type: textblock
25076 #. type: textblock
25077 #: ../fish/guestfish-actions.pod:635
25078 msgid "To get the checksum for a device, use L</checksum-device>."
25079 msgstr ""
25080
25081 # type: textblock
25082 #. type: textblock
25083 #: ../fish/guestfish-actions.pod:637
25084 msgid "To get the checksums for many files, use L</checksums-out>."
25085 msgstr ""
25086
25087 # type: =head2
25088 #. type: =head2
25089 #: ../fish/guestfish-actions.pod:639
25090 msgid "checksum-device"
25091 msgstr ""
25092
25093 # type: verbatim
25094 #. type: verbatim
25095 #: ../fish/guestfish-actions.pod:641
25096 #, no-wrap
25097 msgid ""
25098 " checksum-device csumtype device\n"
25099 "\n"
25100 msgstr ""
25101
25102 # type: textblock
25103 #. type: textblock
25104 #: ../fish/guestfish-actions.pod:643
25105 msgid ""
25106 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
25107 "device named C<device>.  For the types of checksums supported see the L</"
25108 "checksum> command."
25109 msgstr ""
25110
25111 # type: =head2
25112 #. type: =head2
25113 #: ../fish/guestfish-actions.pod:647
25114 msgid "checksums-out"
25115 msgstr ""
25116
25117 # type: verbatim
25118 #. type: verbatim
25119 #: ../fish/guestfish-actions.pod:649
25120 #, no-wrap
25121 msgid ""
25122 " checksums-out csumtype directory (sumsfile|-)\n"
25123 "\n"
25124 msgstr ""
25125
25126 # type: =head2
25127 #. type: =head2
25128 #: ../fish/guestfish-actions.pod:665
25129 msgid "chmod"
25130 msgstr ""
25131
25132 # type: verbatim
25133 #. type: verbatim
25134 #: ../fish/guestfish-actions.pod:667
25135 #, no-wrap
25136 msgid ""
25137 " chmod mode path\n"
25138 "\n"
25139 msgstr ""
25140
25141 # type: =head2
25142 #. type: =head2
25143 #: ../fish/guestfish-actions.pod:678
25144 msgid "chown"
25145 msgstr ""
25146
25147 # type: verbatim
25148 #. type: verbatim
25149 #: ../fish/guestfish-actions.pod:680
25150 #, no-wrap
25151 msgid ""
25152 " chown owner group path\n"
25153 "\n"
25154 msgstr ""
25155
25156 # type: =head2
25157 #. type: =head2
25158 #: ../fish/guestfish-actions.pod:688
25159 msgid "command"
25160 msgstr ""
25161
25162 # type: verbatim
25163 #. type: verbatim
25164 #: ../fish/guestfish-actions.pod:690
25165 #, no-wrap
25166 msgid ""
25167 " command 'arguments ...'\n"
25168 "\n"
25169 msgstr ""
25170
25171 # type: textblock
25172 #. type: textblock
25173 #: ../fish/guestfish-actions.pod:697
25174 msgid ""
25175 "The single parameter is an argv-style list of arguments.  The first element "
25176 "is the name of the program to run.  Subsequent elements are parameters.  The "
25177 "list must be non-empty (ie. must contain a program name).  Note that the "
25178 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
25179 msgstr ""
25180
25181 # type: =head2
25182 #. type: =head2
25183 #: ../fish/guestfish-actions.pod:725
25184 msgid "command-lines"
25185 msgstr ""
25186
25187 # type: verbatim
25188 #. type: verbatim
25189 #: ../fish/guestfish-actions.pod:727
25190 #, no-wrap
25191 msgid ""
25192 " command-lines 'arguments ...'\n"
25193 "\n"
25194 msgstr ""
25195
25196 # type: textblock
25197 #. type: textblock
25198 #: ../fish/guestfish-actions.pod:729
25199 msgid ""
25200 "This is the same as L</command>, but splits the result into a list of lines."
25201 msgstr ""
25202
25203 # type: textblock
25204 #. type: textblock
25205 #: ../fish/guestfish-actions.pod:732
25206 msgid "See also: L</sh-lines>"
25207 msgstr ""
25208
25209 # type: =head2
25210 #. type: =head2
25211 #: ../fish/guestfish-actions.pod:737
25212 msgid "config"
25213 msgstr ""
25214
25215 # type: verbatim
25216 #. type: verbatim
25217 #: ../fish/guestfish-actions.pod:739
25218 #, no-wrap
25219 msgid ""
25220 " config qemuparam qemuvalue\n"
25221 "\n"
25222 msgstr ""
25223
25224 # type: =head2
25225 #. type: =head2
25226 #: ../fish/guestfish-actions.pod:750
25227 msgid "copy-size"
25228 msgstr ""
25229
25230 # type: verbatim
25231 #. type: verbatim
25232 #: ../fish/guestfish-actions.pod:752
25233 #, no-wrap
25234 msgid ""
25235 " copy-size src dest size\n"
25236 "\n"
25237 msgstr ""
25238
25239 # type: =head2
25240 #. type: =head2
25241 #: ../fish/guestfish-actions.pod:760
25242 msgid "cp"
25243 msgstr ""
25244
25245 # type: verbatim
25246 #. type: verbatim
25247 #: ../fish/guestfish-actions.pod:762
25248 #, no-wrap
25249 msgid ""
25250 " cp src dest\n"
25251 "\n"
25252 msgstr ""
25253
25254 # type: =head2
25255 #. type: =head2
25256 #: ../fish/guestfish-actions.pod:767
25257 msgid "cp-a"
25258 msgstr ""
25259
25260 # type: verbatim
25261 #. type: verbatim
25262 #: ../fish/guestfish-actions.pod:769
25263 #, no-wrap
25264 msgid ""
25265 " cp-a src dest\n"
25266 "\n"
25267 msgstr ""
25268
25269 # type: =head2
25270 #. type: =head2
25271 #: ../fish/guestfish-actions.pod:774
25272 msgid "dd"
25273 msgstr ""
25274
25275 # type: verbatim
25276 #. type: verbatim
25277 #: ../fish/guestfish-actions.pod:776
25278 #, no-wrap
25279 msgid ""
25280 " dd src dest\n"
25281 "\n"
25282 msgstr ""
25283
25284 # type: textblock
25285 #. type: textblock
25286 #: ../fish/guestfish-actions.pod:783
25287 msgid ""
25288 "If the destination is a device, it must be as large or larger than the "
25289 "source file or device, otherwise the copy will fail.  This command cannot do "
25290 "partial copies (see L</copy-size>)."
25291 msgstr ""
25292
25293 # type: =head2
25294 #. type: =head2
25295 #: ../fish/guestfish-actions.pod:787
25296 msgid "df"
25297 msgstr ""
25298
25299 # type: verbatim
25300 #. type: verbatim
25301 #: ../fish/guestfish-actions.pod:789
25302 #, no-wrap
25303 msgid ""
25304 " df\n"
25305 "\n"
25306 msgstr ""
25307
25308 # type: textblock
25309 #. type: textblock
25310 #: ../fish/guestfish-actions.pod:793 ../fish/guestfish-actions.pod:804
25311 msgid ""
25312 "This command is mostly useful for interactive sessions.  It is I<not> "
25313 "intended that you try to parse the output string.  Use L</statvfs> from "
25314 "programs."
25315 msgstr ""
25316
25317 # type: =head2
25318 #. type: =head2
25319 #: ../fish/guestfish-actions.pod:797
25320 msgid "df-h"
25321 msgstr ""
25322
25323 # type: verbatim
25324 #. type: verbatim
25325 #: ../fish/guestfish-actions.pod:799
25326 #, no-wrap
25327 msgid ""
25328 " df-h\n"
25329 "\n"
25330 msgstr ""
25331
25332 # type: =head2
25333 #. type: =head2
25334 #: ../fish/guestfish-actions.pod:808
25335 msgid "dmesg"
25336 msgstr ""
25337
25338 # type: verbatim
25339 #. type: verbatim
25340 #: ../fish/guestfish-actions.pod:810
25341 #, no-wrap
25342 msgid ""
25343 " dmesg\n"
25344 "\n"
25345 msgstr ""
25346
25347 # type: textblock
25348 #. type: textblock
25349 #: ../fish/guestfish-actions.pod:816
25350 msgid ""
25351 "Another way to get the same information is to enable verbose messages with "
25352 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
25353 "before running the program."
25354 msgstr ""
25355
25356 # type: =head2
25357 #. type: =head2
25358 #: ../fish/guestfish-actions.pod:821
25359 msgid "download"
25360 msgstr ""
25361
25362 # type: verbatim
25363 #. type: verbatim
25364 #: ../fish/guestfish-actions.pod:823
25365 #, no-wrap
25366 msgid ""
25367 " download remotefilename (filename|-)\n"
25368 "\n"
25369 msgstr ""
25370
25371 # type: textblock
25372 #. type: textblock
25373 #: ../fish/guestfish-actions.pod:830
25374 msgid "See also L</upload>, L</cat>."
25375 msgstr ""
25376
25377 # type: =head2
25378 #. type: =head2
25379 #: ../fish/guestfish-actions.pod:834
25380 msgid "download-offset"
25381 msgstr ""
25382
25383 # type: verbatim
25384 #. type: verbatim
25385 #: ../fish/guestfish-actions.pod:836
25386 #, no-wrap
25387 msgid ""
25388 " download-offset remotefilename (filename|-) offset size\n"
25389 "\n"
25390 msgstr ""
25391
25392 # type: textblock
25393 #. type: textblock
25394 #: ../fish/guestfish-actions.pod:844
25395 msgid ""
25396 "Note that there is no limit on the amount of data that can be downloaded "
25397 "with this call, unlike with L</pread>, and this call always reads the full "
25398 "amount unless an error occurs."
25399 msgstr ""
25400
25401 # type: textblock
25402 #. type: textblock
25403 #: ../fish/guestfish-actions.pod:849
25404 msgid "See also L</download>, L</pread>."
25405 msgstr ""
25406
25407 # type: =head2
25408 #. type: =head2
25409 #: ../fish/guestfish-actions.pod:853
25410 msgid "drop-caches"
25411 msgstr ""
25412
25413 # type: verbatim
25414 #. type: verbatim
25415 #: ../fish/guestfish-actions.pod:855
25416 #, no-wrap
25417 msgid ""
25418 " drop-caches whattodrop\n"
25419 "\n"
25420 msgstr ""
25421
25422 # type: =head2
25423 #. type: =head2
25424 #: ../fish/guestfish-actions.pod:867
25425 msgid "du"
25426 msgstr ""
25427
25428 # type: verbatim
25429 #. type: verbatim
25430 #: ../fish/guestfish-actions.pod:869
25431 #, no-wrap
25432 msgid ""
25433 " du path\n"
25434 "\n"
25435 msgstr ""
25436
25437 # type: =head2
25438 #. type: =head2
25439 #: ../fish/guestfish-actions.pod:881
25440 msgid "e2fsck-f"
25441 msgstr ""
25442
25443 # type: verbatim
25444 #. type: verbatim
25445 #: ../fish/guestfish-actions.pod:883
25446 #, no-wrap
25447 msgid ""
25448 " e2fsck-f device\n"
25449 "\n"
25450 msgstr ""
25451
25452 # type: textblock
25453 #. type: textblock
25454 #: ../fish/guestfish-actions.pod:889
25455 msgid ""
25456 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
25457 "should use L</fsck>."
25458 msgstr ""
25459
25460 # type: =head2
25461 #. type: =head2
25462 #: ../fish/guestfish-actions.pod:892
25463 msgid "echo-daemon"
25464 msgstr ""
25465
25466 # type: verbatim
25467 #. type: verbatim
25468 #: ../fish/guestfish-actions.pod:894
25469 #, no-wrap
25470 msgid ""
25471 " echo-daemon 'words ...'\n"
25472 "\n"
25473 msgstr ""
25474
25475 # type: textblock
25476 #. type: textblock
25477 #: ../fish/guestfish-actions.pod:901
25478 msgid "See also L</ping-daemon>."
25479 msgstr ""
25480
25481 # type: =head2
25482 #. type: =head2
25483 #: ../fish/guestfish-actions.pod:903
25484 msgid "egrep"
25485 msgstr ""
25486
25487 # type: verbatim
25488 #. type: verbatim
25489 #: ../fish/guestfish-actions.pod:905
25490 #, no-wrap
25491 msgid ""
25492 " egrep regex path\n"
25493 "\n"
25494 msgstr ""
25495
25496 # type: =head2
25497 #. type: =head2
25498 #: ../fish/guestfish-actions.pod:913
25499 msgid "egrepi"
25500 msgstr ""
25501
25502 # type: verbatim
25503 #. type: verbatim
25504 #: ../fish/guestfish-actions.pod:915
25505 #, no-wrap
25506 msgid ""
25507 " egrepi regex path\n"
25508 "\n"
25509 msgstr ""
25510
25511 # type: =head2
25512 #. type: =head2
25513 #: ../fish/guestfish-actions.pod:923
25514 msgid "equal"
25515 msgstr ""
25516
25517 # type: verbatim
25518 #. type: verbatim
25519 #: ../fish/guestfish-actions.pod:925
25520 #, no-wrap
25521 msgid ""
25522 " equal file1 file2\n"
25523 "\n"
25524 msgstr ""
25525
25526 # type: =head2
25527 #. type: =head2
25528 #: ../fish/guestfish-actions.pod:932
25529 msgid "exists"
25530 msgstr ""
25531
25532 # type: verbatim
25533 #. type: verbatim
25534 #: ../fish/guestfish-actions.pod:934
25535 #, no-wrap
25536 msgid ""
25537 " exists path\n"
25538 "\n"
25539 msgstr ""
25540
25541 # type: textblock
25542 #. type: textblock
25543 #: ../fish/guestfish-actions.pod:939
25544 msgid "See also L</is-file>, L</is-dir>, L</stat>."
25545 msgstr ""
25546
25547 # type: =head2
25548 #. type: =head2
25549 #: ../fish/guestfish-actions.pod:941
25550 msgid "fallocate"
25551 msgstr ""
25552
25553 # type: verbatim
25554 #. type: verbatim
25555 #: ../fish/guestfish-actions.pod:943
25556 #, no-wrap
25557 msgid ""
25558 " fallocate path len\n"
25559 "\n"
25560 msgstr ""
25561
25562 # type: =head2
25563 #. type: =head2
25564 #: ../fish/guestfish-actions.pod:960
25565 msgid "fallocate64"
25566 msgstr ""
25567
25568 # type: verbatim
25569 #. type: verbatim
25570 #: ../fish/guestfish-actions.pod:962
25571 #, no-wrap
25572 msgid ""
25573 " fallocate64 path len\n"
25574 "\n"
25575 msgstr ""
25576
25577 # type: textblock
25578 #. type: textblock
25579 #: ../fish/guestfish-actions.pod:968
25580 msgid ""
25581 "Note that this call allocates disk blocks for the file.  To create a sparse "
25582 "file use L</truncate-size> instead."
25583 msgstr ""
25584
25585 # type: textblock
25586 #. type: textblock
25587 #: ../fish/guestfish-actions.pod:971
25588 msgid ""
25589 "The deprecated call L</fallocate> does the same, but owing to an oversight "
25590 "it only allowed 30 bit lengths to be specified, effectively limiting the "
25591 "maximum size of files created through that call to 1GB."
25592 msgstr ""
25593
25594 # type: =head2
25595 #. type: =head2
25596 #: ../fish/guestfish-actions.pod:980
25597 msgid "fgrep"
25598 msgstr ""
25599
25600 # type: verbatim
25601 #. type: verbatim
25602 #: ../fish/guestfish-actions.pod:982
25603 #, no-wrap
25604 msgid ""
25605 " fgrep pattern path\n"
25606 "\n"
25607 msgstr ""
25608
25609 # type: =head2
25610 #. type: =head2
25611 #: ../fish/guestfish-actions.pod:990
25612 msgid "fgrepi"
25613 msgstr ""
25614
25615 # type: verbatim
25616 #. type: verbatim
25617 #: ../fish/guestfish-actions.pod:992
25618 #, no-wrap
25619 msgid ""
25620 " fgrepi pattern path\n"
25621 "\n"
25622 msgstr ""
25623
25624 # type: =head2
25625 #. type: =head2
25626 #: ../fish/guestfish-actions.pod:1000
25627 msgid "file"
25628 msgstr ""
25629
25630 # type: verbatim
25631 #. type: verbatim
25632 #: ../fish/guestfish-actions.pod:1002
25633 #, no-wrap
25634 msgid ""
25635 " file path\n"
25636 "\n"
25637 msgstr ""
25638
25639 # type: textblock
25640 #. type: textblock
25641 #: ../fish/guestfish-actions.pod:1014
25642 msgid ""
25643 "This command can also be used on C</dev/> devices (and partitions, LV "
25644 "names).  You can for example use this to determine if a device contains a "
25645 "filesystem, although it's usually better to use L</vfs-type>."
25646 msgstr ""
25647
25648 # type: =head2
25649 #. type: =head2
25650 #: ../fish/guestfish-actions.pod:1024
25651 msgid "file-architecture"
25652 msgstr ""
25653
25654 # type: verbatim
25655 #. type: verbatim
25656 #: ../fish/guestfish-actions.pod:1026
25657 #, no-wrap
25658 msgid ""
25659 " file-architecture filename\n"
25660 "\n"
25661 msgstr ""
25662
25663 # type: =head2
25664 #. type: =head2
25665 #: ../fish/guestfish-actions.pod:1129
25666 msgid "filesize"
25667 msgstr ""
25668
25669 # type: verbatim
25670 #. type: verbatim
25671 #: ../fish/guestfish-actions.pod:1131
25672 #, no-wrap
25673 msgid ""
25674 " filesize file\n"
25675 "\n"
25676 msgstr ""
25677
25678 # type: textblock
25679 #. type: textblock
25680 #: ../fish/guestfish-actions.pod:1135
25681 msgid ""
25682 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
25683 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
25684 msgstr ""
25685
25686 # type: =head2
25687 #. type: =head2
25688 #: ../fish/guestfish-actions.pod:1139
25689 msgid "fill"
25690 msgstr ""
25691
25692 # type: verbatim
25693 #. type: verbatim
25694 #: ../fish/guestfish-actions.pod:1141
25695 #, no-wrap
25696 msgid ""
25697 " fill c len path\n"
25698 "\n"
25699 msgstr ""
25700
25701 # type: textblock
25702 #. type: textblock
25703 #: ../fish/guestfish-actions.pod:1147
25704 msgid ""
25705 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
25706 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
25707 "L</fill-pattern>."
25708 msgstr ""
25709
25710 # type: =head2
25711 #. type: =head2
25712 #: ../fish/guestfish-actions.pod:1152
25713 msgid "fill-pattern"
25714 msgstr ""
25715
25716 # type: verbatim
25717 #. type: verbatim
25718 #: ../fish/guestfish-actions.pod:1154
25719 #, no-wrap
25720 msgid ""
25721 " fill-pattern pattern len path\n"
25722 "\n"
25723 msgstr ""
25724
25725 # type: textblock
25726 #. type: textblock
25727 #: ../fish/guestfish-actions.pod:1156
25728 msgid ""
25729 "This function is like L</fill> except that it creates a new file of length "
25730 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
25731 "is truncated if necessary to ensure the length of the file is exactly C<len> "
25732 "bytes."
25733 msgstr ""
25734
25735 # type: =head2
25736 #. type: =head2
25737 #: ../fish/guestfish-actions.pod:1161
25738 msgid "find"
25739 msgstr ""
25740
25741 # type: verbatim
25742 #. type: verbatim
25743 #: ../fish/guestfish-actions.pod:1163
25744 #, no-wrap
25745 msgid ""
25746 " find directory\n"
25747 "\n"
25748 msgstr ""
25749
25750 # type: textblock
25751 #. type: textblock
25752 #: ../fish/guestfish-actions.pod:1177
25753 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
25754 msgstr ""
25755
25756 # type: textblock
25757 #. type: textblock
25758 #: ../fish/guestfish-actions.pod:1190
25759 msgid "See also L</find0>."
25760 msgstr ""
25761
25762 # type: =head2
25763 #. type: =head2
25764 #: ../fish/guestfish-actions.pod:1195
25765 msgid "find0"
25766 msgstr ""
25767
25768 # type: verbatim
25769 #. type: verbatim
25770 #: ../fish/guestfish-actions.pod:1197
25771 #, no-wrap
25772 msgid ""
25773 " find0 directory (files|-)\n"
25774 "\n"
25775 msgstr ""
25776
25777 # type: textblock
25778 #. type: textblock
25779 #: ../fish/guestfish-actions.pod:1203
25780 msgid ""
25781 "This command works the same way as L</find> with the following exceptions:"
25782 msgstr ""
25783
25784 # type: =head2
25785 #. type: =head2
25786 #: ../fish/guestfish-actions.pod:1230
25787 msgid "findfs-label"
25788 msgstr ""
25789
25790 # type: verbatim
25791 #. type: verbatim
25792 #: ../fish/guestfish-actions.pod:1232
25793 #, no-wrap
25794 msgid ""
25795 " findfs-label label\n"
25796 "\n"
25797 msgstr ""
25798
25799 # type: textblock
25800 #. type: textblock
25801 #: ../fish/guestfish-actions.pod:1238
25802 msgid "To find the label of a filesystem, use L</vfs-label>."
25803 msgstr ""
25804
25805 # type: =head2
25806 #. type: =head2
25807 #: ../fish/guestfish-actions.pod:1240
25808 msgid "findfs-uuid"
25809 msgstr ""
25810
25811 # type: verbatim
25812 #. type: verbatim
25813 #: ../fish/guestfish-actions.pod:1242
25814 #, no-wrap
25815 msgid ""
25816 " findfs-uuid uuid\n"
25817 "\n"
25818 msgstr ""
25819
25820 # type: textblock
25821 #. type: textblock
25822 #: ../fish/guestfish-actions.pod:1248
25823 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
25824 msgstr ""
25825
25826 # type: =head2
25827 #. type: =head2
25828 #: ../fish/guestfish-actions.pod:1250
25829 msgid "fsck"
25830 msgstr ""
25831
25832 # type: verbatim
25833 #. type: verbatim
25834 #: ../fish/guestfish-actions.pod:1252
25835 #, no-wrap
25836 msgid ""
25837 " fsck fstype device\n"
25838 "\n"
25839 msgstr ""
25840
25841 # type: =head2
25842 #. type: =head2
25843 #: ../fish/guestfish-actions.pod:1282
25844 msgid "get-append"
25845 msgstr ""
25846
25847 # type: verbatim
25848 #. type: verbatim
25849 #: ../fish/guestfish-actions.pod:1284
25850 #, no-wrap
25851 msgid ""
25852 " get-append\n"
25853 "\n"
25854 msgstr ""
25855
25856 #. type: =head2
25857 #: ../fish/guestfish-actions.pod:1291
25858 msgid "get-attach-method"
25859 msgstr ""
25860
25861 #. type: verbatim
25862 #: ../fish/guestfish-actions.pod:1293
25863 #, no-wrap
25864 msgid ""
25865 " get-attach-method\n"
25866 "\n"
25867 msgstr ""
25868
25869 #. type: textblock
25870 #: ../fish/guestfish-actions.pod:1295
25871 msgid "Return the current attach method.  See L</set-attach-method>."
25872 msgstr ""
25873
25874 # type: =head2
25875 #. type: =head2
25876 #: ../fish/guestfish-actions.pod:1297
25877 msgid "get-autosync"
25878 msgstr ""
25879
25880 # type: verbatim
25881 #. type: verbatim
25882 #: ../fish/guestfish-actions.pod:1299
25883 #, no-wrap
25884 msgid ""
25885 " get-autosync\n"
25886 "\n"
25887 msgstr ""
25888
25889 # type: =head2
25890 #. type: =head2
25891 #: ../fish/guestfish-actions.pod:1303
25892 msgid "get-direct"
25893 msgstr ""
25894
25895 # type: verbatim
25896 #. type: verbatim
25897 #: ../fish/guestfish-actions.pod:1305
25898 #, no-wrap
25899 msgid ""
25900 " get-direct\n"
25901 "\n"
25902 msgstr ""
25903
25904 # type: =head2
25905 #. type: =head2
25906 #: ../fish/guestfish-actions.pod:1309
25907 msgid "get-e2label"
25908 msgstr ""
25909
25910 # type: verbatim
25911 #. type: verbatim
25912 #: ../fish/guestfish-actions.pod:1311
25913 #, no-wrap
25914 msgid ""
25915 " get-e2label device\n"
25916 "\n"
25917 msgstr ""
25918
25919 # type: =head2
25920 #. type: =head2
25921 #: ../fish/guestfish-actions.pod:1323
25922 msgid "get-e2uuid"
25923 msgstr ""
25924
25925 # type: verbatim
25926 #. type: verbatim
25927 #: ../fish/guestfish-actions.pod:1325
25928 #, no-wrap
25929 msgid ""
25930 " get-e2uuid device\n"
25931 "\n"
25932 msgstr ""
25933
25934 # type: =head2
25935 #. type: =head2
25936 #: ../fish/guestfish-actions.pod:1337
25937 msgid "get-memsize"
25938 msgstr ""
25939
25940 # type: verbatim
25941 #. type: verbatim
25942 #: ../fish/guestfish-actions.pod:1339
25943 #, no-wrap
25944 msgid ""
25945 " get-memsize\n"
25946 "\n"
25947 msgstr ""
25948
25949 # type: textblock
25950 #. type: textblock
25951 #: ../fish/guestfish-actions.pod:1344
25952 msgid ""
25953 "If L</set-memsize> was not called on this handle, and if "
25954 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
25955 "value for memsize."
25956 msgstr ""
25957
25958 # type: =head2
25959 #. type: =head2
25960 #: ../fish/guestfish-actions.pod:1351
25961 msgid "get-network"
25962 msgstr ""
25963
25964 # type: verbatim
25965 #. type: verbatim
25966 #: ../fish/guestfish-actions.pod:1353
25967 #, no-wrap
25968 msgid ""
25969 " get-network\n"
25970 "\n"
25971 msgstr ""
25972
25973 # type: =head2
25974 #. type: =head2
25975 #: ../fish/guestfish-actions.pod:1357
25976 msgid "get-path"
25977 msgstr ""
25978
25979 # type: verbatim
25980 #. type: verbatim
25981 #: ../fish/guestfish-actions.pod:1359
25982 #, no-wrap
25983 msgid ""
25984 " get-path\n"
25985 "\n"
25986 msgstr ""
25987
25988 # type: =head2
25989 #. type: =head2
25990 #: ../fish/guestfish-actions.pod:1366
25991 msgid "get-pid"
25992 msgstr ""
25993
25994 # type: =head2
25995 #. type: =head2
25996 #: ../fish/guestfish-actions.pod:1368
25997 msgid "pid"
25998 msgstr ""
25999
26000 # type: verbatim
26001 #. type: verbatim
26002 #: ../fish/guestfish-actions.pod:1370
26003 #, no-wrap
26004 msgid ""
26005 " get-pid\n"
26006 "\n"
26007 msgstr ""
26008
26009 # type: =head2
26010 #. type: =head2
26011 #: ../fish/guestfish-actions.pod:1377
26012 msgid "get-qemu"
26013 msgstr ""
26014
26015 # type: verbatim
26016 #. type: verbatim
26017 #: ../fish/guestfish-actions.pod:1379
26018 #, no-wrap
26019 msgid ""
26020 " get-qemu\n"
26021 "\n"
26022 msgstr ""
26023
26024 # type: =head2
26025 #. type: =head2
26026 #: ../fish/guestfish-actions.pod:1386
26027 msgid "get-recovery-proc"
26028 msgstr ""
26029
26030 # type: verbatim
26031 #. type: verbatim
26032 #: ../fish/guestfish-actions.pod:1388
26033 #, no-wrap
26034 msgid ""
26035 " get-recovery-proc\n"
26036 "\n"
26037 msgstr ""
26038
26039 # type: =head2
26040 #. type: =head2
26041 #: ../fish/guestfish-actions.pod:1392
26042 msgid "get-selinux"
26043 msgstr ""
26044
26045 # type: verbatim
26046 #. type: verbatim
26047 #: ../fish/guestfish-actions.pod:1394
26048 #, no-wrap
26049 msgid ""
26050 " get-selinux\n"
26051 "\n"
26052 msgstr ""
26053
26054 # type: textblock
26055 #. type: textblock
26056 #: ../fish/guestfish-actions.pod:1396
26057 msgid ""
26058 "This returns the current setting of the selinux flag which is passed to the "
26059 "appliance at boot time.  See L</set-selinux>."
26060 msgstr ""
26061
26062 # type: =head2
26063 #. type: =head2
26064 #: ../fish/guestfish-actions.pod:1402
26065 msgid "get-state"
26066 msgstr ""
26067
26068 # type: verbatim
26069 #. type: verbatim
26070 #: ../fish/guestfish-actions.pod:1404
26071 #, no-wrap
26072 msgid ""
26073 " get-state\n"
26074 "\n"
26075 msgstr ""
26076
26077 # type: =head2
26078 #. type: =head2
26079 #: ../fish/guestfish-actions.pod:1411
26080 msgid "get-trace"
26081 msgstr ""
26082
26083 # type: verbatim
26084 #. type: verbatim
26085 #: ../fish/guestfish-actions.pod:1413
26086 #, no-wrap
26087 msgid ""
26088 " get-trace\n"
26089 "\n"
26090 msgstr ""
26091
26092 # type: =head2
26093 #. type: =head2
26094 #: ../fish/guestfish-actions.pod:1417
26095 msgid "get-umask"
26096 msgstr ""
26097
26098 # type: verbatim
26099 #. type: verbatim
26100 #: ../fish/guestfish-actions.pod:1419
26101 #, no-wrap
26102 msgid ""
26103 " get-umask\n"
26104 "\n"
26105 msgstr ""
26106
26107 # type: textblock
26108 #. type: textblock
26109 #: ../fish/guestfish-actions.pod:1421
26110 msgid ""
26111 "Return the current umask.  By default the umask is C<022> unless it has been "
26112 "set by calling L</umask>."
26113 msgstr ""
26114
26115 # type: =head2
26116 #. type: =head2
26117 #: ../fish/guestfish-actions.pod:1424
26118 msgid "get-verbose"
26119 msgstr ""
26120
26121 # type: verbatim
26122 #. type: verbatim
26123 #: ../fish/guestfish-actions.pod:1426
26124 #, no-wrap
26125 msgid ""
26126 " get-verbose\n"
26127 "\n"
26128 msgstr ""
26129
26130 # type: =head2
26131 #. type: =head2
26132 #: ../fish/guestfish-actions.pod:1430
26133 msgid "getcon"
26134 msgstr ""
26135
26136 # type: verbatim
26137 #. type: verbatim
26138 #: ../fish/guestfish-actions.pod:1432
26139 #, no-wrap
26140 msgid ""
26141 " getcon\n"
26142 "\n"
26143 msgstr ""
26144
26145 # type: textblock
26146 #. type: textblock
26147 #: ../fish/guestfish-actions.pod:1436
26148 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
26149 msgstr ""
26150
26151 # type: =head2
26152 #. type: =head2
26153 #: ../fish/guestfish-actions.pod:1439
26154 msgid "getxattr"
26155 msgstr ""
26156
26157 # type: verbatim
26158 #. type: verbatim
26159 #: ../fish/guestfish-actions.pod:1441
26160 #, no-wrap
26161 msgid ""
26162 " getxattr path name\n"
26163 "\n"
26164 msgstr ""
26165
26166 # type: textblock
26167 #. type: textblock
26168 #: ../fish/guestfish-actions.pod:1443
26169 msgid ""
26170 "Get a single extended attribute from file C<path> named C<name>.  This call "
26171 "follows symlinks.  If you want to lookup an extended attribute for the "
26172 "symlink itself, use L</lgetxattr>."
26173 msgstr ""
26174
26175 # type: textblock
26176 #. type: textblock
26177 #: ../fish/guestfish-actions.pod:1447 ../fish/guestfish-actions.pod:2453
26178 msgid ""
26179 "Normally it is better to get all extended attributes from a file in one go "
26180 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
26181 "buggy and do not provide a way to list out attributes.  For these "
26182 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
26183 "attributes you want in advance and call this function."
26184 msgstr ""
26185
26186 # type: textblock
26187 #. type: textblock
26188 #: ../fish/guestfish-actions.pod:1457
26189 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
26190 msgstr ""
26191
26192 # type: =head2
26193 #. type: =head2
26194 #: ../fish/guestfish-actions.pod:1459
26195 msgid "getxattrs"
26196 msgstr ""
26197
26198 # type: verbatim
26199 #. type: verbatim
26200 #: ../fish/guestfish-actions.pod:1461
26201 #, no-wrap
26202 msgid ""
26203 " getxattrs path\n"
26204 "\n"
26205 msgstr ""
26206
26207 # type: textblock
26208 #. type: textblock
26209 #: ../fish/guestfish-actions.pod:1469
26210 msgid "See also: L</lgetxattrs>, L<attr(5)>."
26211 msgstr ""
26212
26213 # type: =head2
26214 #. type: =head2
26215 #: ../fish/guestfish-actions.pod:1471
26216 msgid "glob-expand"
26217 msgstr ""
26218
26219 # type: verbatim
26220 #. type: verbatim
26221 #: ../fish/guestfish-actions.pod:1473
26222 #, no-wrap
26223 msgid ""
26224 " glob-expand pattern\n"
26225 "\n"
26226 msgstr ""
26227
26228 # type: =head2
26229 #. type: =head2
26230 #: ../fish/guestfish-actions.pod:1486
26231 msgid "grep"
26232 msgstr ""
26233
26234 # type: verbatim
26235 #. type: verbatim
26236 #: ../fish/guestfish-actions.pod:1488
26237 #, no-wrap
26238 msgid ""
26239 " grep regex path\n"
26240 "\n"
26241 msgstr ""
26242
26243 # type: =head2
26244 #. type: =head2
26245 #: ../fish/guestfish-actions.pod:1496
26246 msgid "grepi"
26247 msgstr ""
26248
26249 # type: verbatim
26250 #. type: verbatim
26251 #: ../fish/guestfish-actions.pod:1498
26252 #, no-wrap
26253 msgid ""
26254 " grepi regex path\n"
26255 "\n"
26256 msgstr ""
26257
26258 # type: =head2
26259 #. type: =head2
26260 #: ../fish/guestfish-actions.pod:1506
26261 msgid "grub-install"
26262 msgstr ""
26263
26264 # type: verbatim
26265 #. type: verbatim
26266 #: ../fish/guestfish-actions.pod:1508
26267 #, no-wrap
26268 msgid ""
26269 " grub-install root device\n"
26270 "\n"
26271 msgstr ""
26272
26273 # type: =head2
26274 #. type: =head2
26275 #: ../fish/guestfish-actions.pod:1524
26276 msgid "head"
26277 msgstr ""
26278
26279 # type: verbatim
26280 #. type: verbatim
26281 #: ../fish/guestfish-actions.pod:1526
26282 #, no-wrap
26283 msgid ""
26284 " head path\n"
26285 "\n"
26286 msgstr ""
26287
26288 # type: =head2
26289 #. type: =head2
26290 #: ../fish/guestfish-actions.pod:1534
26291 msgid "head-n"
26292 msgstr ""
26293
26294 # type: verbatim
26295 #. type: verbatim
26296 #: ../fish/guestfish-actions.pod:1536
26297 #, no-wrap
26298 msgid ""
26299 " head-n nrlines path\n"
26300 "\n"
26301 msgstr ""
26302
26303 # type: =head2
26304 #. type: =head2
26305 #: ../fish/guestfish-actions.pod:1549
26306 msgid "hexdump"
26307 msgstr ""
26308
26309 # type: verbatim
26310 #. type: verbatim
26311 #: ../fish/guestfish-actions.pod:1551
26312 #, no-wrap
26313 msgid ""
26314 " hexdump path\n"
26315 "\n"
26316 msgstr ""
26317
26318 # type: =head2
26319 #. type: =head2
26320 #: ../fish/guestfish-actions.pod:1559
26321 msgid "initrd-cat"
26322 msgstr ""
26323
26324 # type: verbatim
26325 #. type: verbatim
26326 #: ../fish/guestfish-actions.pod:1561
26327 #, no-wrap
26328 msgid ""
26329 " initrd-cat initrdpath filename\n"
26330 "\n"
26331 msgstr ""
26332
26333 # type: textblock
26334 #. type: textblock
26335 #: ../fish/guestfish-actions.pod:1573
26336 msgid "See also L</initrd-list>."
26337 msgstr ""
26338
26339 # type: =head2
26340 #. type: =head2
26341 #: ../fish/guestfish-actions.pod:1578
26342 msgid "initrd-list"
26343 msgstr ""
26344
26345 # type: verbatim
26346 #. type: verbatim
26347 #: ../fish/guestfish-actions.pod:1580
26348 #, no-wrap
26349 msgid ""
26350 " initrd-list path\n"
26351 "\n"
26352 msgstr ""
26353
26354 # type: =head2
26355 #. type: =head2
26356 #: ../fish/guestfish-actions.pod:1592
26357 msgid "inotify-add-watch"
26358 msgstr ""
26359
26360 # type: verbatim
26361 #. type: verbatim
26362 #: ../fish/guestfish-actions.pod:1594
26363 #, no-wrap
26364 msgid ""
26365 " inotify-add-watch path mask\n"
26366 "\n"
26367 msgstr ""
26368
26369 # type: =head2
26370 #. type: =head2
26371 #: ../fish/guestfish-actions.pod:1606
26372 msgid "inotify-close"
26373 msgstr ""
26374
26375 # type: verbatim
26376 #. type: verbatim
26377 #: ../fish/guestfish-actions.pod:1608
26378 #, no-wrap
26379 msgid ""
26380 " inotify-close\n"
26381 "\n"
26382 msgstr ""
26383
26384 # type: =head2
26385 #. type: =head2
26386 #: ../fish/guestfish-actions.pod:1614
26387 msgid "inotify-files"
26388 msgstr ""
26389
26390 # type: verbatim
26391 #. type: verbatim
26392 #: ../fish/guestfish-actions.pod:1616
26393 #, no-wrap
26394 msgid ""
26395 " inotify-files\n"
26396 "\n"
26397 msgstr ""
26398
26399 # type: textblock
26400 #. type: textblock
26401 #: ../fish/guestfish-actions.pod:1618
26402 msgid ""
26403 "This function is a helpful wrapper around L</inotify-read> which just "
26404 "returns a list of pathnames of objects that were touched.  The returned "
26405 "pathnames are sorted and deduplicated."
26406 msgstr ""
26407
26408 # type: =head2
26409 #. type: =head2
26410 #: ../fish/guestfish-actions.pod:1622
26411 msgid "inotify-init"
26412 msgstr ""
26413
26414 # type: verbatim
26415 #. type: verbatim
26416 #: ../fish/guestfish-actions.pod:1624
26417 #, no-wrap
26418 msgid ""
26419 " inotify-init maxevents\n"
26420 "\n"
26421 msgstr ""
26422
26423 # type: textblock
26424 #. type: textblock
26425 #: ../fish/guestfish-actions.pod:1630
26426 msgid ""
26427 "C<maxevents> is the maximum number of events which will be queued up between "
26428 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
26429 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
26430 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
26431 "but records the fact that it threw them away by setting a flag "
26432 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
26433 msgstr ""
26434
26435 # type: textblock
26436 #. type: textblock
26437 #: ../fish/guestfish-actions.pod:1640
26438 msgid ""
26439 "Before any events are generated, you have to add some watches to the "
26440 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
26441 "L</inotify-watch-all>."
26442 msgstr ""
26443
26444 # type: textblock
26445 #. type: textblock
26446 #: ../fish/guestfish-actions.pod:1646
26447 msgid ""
26448 "Queued up events should be read periodically by calling L</inotify-read> (or "
26449 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
26450 "If you don't read the events out often enough then you risk the internal "
26451 "queue overflowing."
26452 msgstr ""
26453
26454 # type: textblock
26455 #. type: textblock
26456 #: ../fish/guestfish-actions.pod:1653
26457 msgid ""
26458 "The handle should be closed after use by calling L</inotify-close>.  This "
26459 "also removes any watches automatically."
26460 msgstr ""
26461
26462 # type: =head2
26463 #. type: =head2
26464 #: ../fish/guestfish-actions.pod:1662
26465 msgid "inotify-read"
26466 msgstr ""
26467
26468 # type: verbatim
26469 #. type: verbatim
26470 #: ../fish/guestfish-actions.pod:1664
26471 #, no-wrap
26472 msgid ""
26473 " inotify-read\n"
26474 "\n"
26475 msgstr ""
26476
26477 # type: =head2
26478 #. type: =head2
26479 #: ../fish/guestfish-actions.pod:1677
26480 msgid "inotify-rm-watch"
26481 msgstr ""
26482
26483 # type: verbatim
26484 #. type: verbatim
26485 #: ../fish/guestfish-actions.pod:1679
26486 #, no-wrap
26487 msgid ""
26488 " inotify-rm-watch wd\n"
26489 "\n"
26490 msgstr ""
26491
26492 # type: textblock
26493 #. type: textblock
26494 #: ../fish/guestfish-actions.pod:1681
26495 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
26496 msgstr ""
26497
26498 # type: =head2
26499 #. type: =head2
26500 #: ../fish/guestfish-actions.pod:1684
26501 msgid "inspect-get-arch"
26502 msgstr ""
26503
26504 # type: verbatim
26505 #. type: verbatim
26506 #: ../fish/guestfish-actions.pod:1686
26507 #, no-wrap
26508 msgid ""
26509 " inspect-get-arch root\n"
26510 "\n"
26511 msgstr ""
26512
26513 # type: textblock
26514 #. type: textblock
26515 #: ../fish/guestfish-actions.pod:1688 ../fish/guestfish-actions.pod:1704
26516 #: ../fish/guestfish-actions.pod:1790 ../fish/guestfish-actions.pod:1826
26517 #: ../fish/guestfish-actions.pod:1844 ../fish/guestfish-actions.pod:1878
26518 #: ../fish/guestfish-actions.pod:1893 ../fish/guestfish-actions.pod:1914
26519 #: ../fish/guestfish-actions.pod:1929 ../fish/guestfish-actions.pod:1962
26520 #: ../fish/guestfish-actions.pod:1984 ../fish/guestfish-actions.pod:2008
26521 #: ../fish/guestfish-actions.pod:2025 ../fish/guestfish-actions.pod:2068
26522 #: ../fish/guestfish-actions.pod:2103 ../fish/guestfish-actions.pod:2119
26523 #: ../fish/guestfish-actions.pod:2135 ../fish/guestfish-actions.pod:2148
26524 #: ../fish/guestfish-actions.pod:2161 ../fish/guestfish-actions.pod:2176
26525 msgid ""
26526 "This function should only be called with a root device string as returned by "
26527 "L</inspect-os>."
26528 msgstr ""
26529
26530 # type: textblock
26531 #. type: textblock
26532 #: ../fish/guestfish-actions.pod:1691
26533 msgid ""
26534 "This returns the architecture of the inspected operating system.  The "
26535 "possible return values are listed under L</file-architecture>."
26536 msgstr ""
26537
26538 # type: =head2
26539 #. type: =head2
26540 #: ../fish/guestfish-actions.pod:1700
26541 msgid "inspect-get-distro"
26542 msgstr ""
26543
26544 # type: verbatim
26545 #. type: verbatim
26546 #: ../fish/guestfish-actions.pod:1702
26547 #, no-wrap
26548 msgid ""
26549 " inspect-get-distro root\n"
26550 "\n"
26551 msgstr ""
26552
26553 #. type: =head2
26554 #: ../fish/guestfish-actions.pod:1786
26555 msgid "inspect-get-drive-mappings"
26556 msgstr ""
26557
26558 #. type: verbatim
26559 #: ../fish/guestfish-actions.pod:1788
26560 #, no-wrap
26561 msgid ""
26562 " inspect-get-drive-mappings root\n"
26563 "\n"
26564 msgstr ""
26565
26566 #. type: textblock
26567 #: ../fish/guestfish-actions.pod:1818
26568 msgid ""
26569 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26570 "get-mountpoints>, L</inspect-get-filesystems>."
26571 msgstr ""
26572
26573 # type: =head2
26574 #. type: =head2
26575 #: ../fish/guestfish-actions.pod:1822
26576 msgid "inspect-get-filesystems"
26577 msgstr ""
26578
26579 # type: verbatim
26580 #. type: verbatim
26581 #: ../fish/guestfish-actions.pod:1824
26582 #, no-wrap
26583 msgid ""
26584 " inspect-get-filesystems root\n"
26585 "\n"
26586 msgstr ""
26587
26588 # type: textblock
26589 #. type: textblock
26590 #: ../fish/guestfish-actions.pod:1837
26591 msgid ""
26592 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26593 "get-mountpoints>."
26594 msgstr ""
26595
26596 #. type: =head2
26597 #: ../fish/guestfish-actions.pod:1840
26598 msgid "inspect-get-format"
26599 msgstr ""
26600
26601 #. type: verbatim
26602 #: ../fish/guestfish-actions.pod:1842
26603 #, no-wrap
26604 msgid ""
26605 " inspect-get-format root\n"
26606 "\n"
26607 msgstr ""
26608
26609 # type: =head2
26610 #. type: =head2
26611 #: ../fish/guestfish-actions.pod:1874
26612 msgid "inspect-get-hostname"
26613 msgstr ""
26614
26615 # type: verbatim
26616 #. type: verbatim
26617 #: ../fish/guestfish-actions.pod:1876
26618 #, no-wrap
26619 msgid ""
26620 " inspect-get-hostname root\n"
26621 "\n"
26622 msgstr ""
26623
26624 # type: =head2
26625 #. type: =head2
26626 #: ../fish/guestfish-actions.pod:1889
26627 msgid "inspect-get-major-version"
26628 msgstr ""
26629
26630 # type: verbatim
26631 #. type: verbatim
26632 #: ../fish/guestfish-actions.pod:1891
26633 #, no-wrap
26634 msgid ""
26635 " inspect-get-major-version root\n"
26636 "\n"
26637 msgstr ""
26638
26639 # type: =head2
26640 #. type: =head2
26641 #: ../fish/guestfish-actions.pod:1910
26642 msgid "inspect-get-minor-version"
26643 msgstr ""
26644
26645 # type: verbatim
26646 #. type: verbatim
26647 #: ../fish/guestfish-actions.pod:1912
26648 #, no-wrap
26649 msgid ""
26650 " inspect-get-minor-version root\n"
26651 "\n"
26652 msgstr ""
26653
26654 # type: textblock
26655 #. type: textblock
26656 #: ../fish/guestfish-actions.pod:1922
26657 msgid ""
26658 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26659 "get-major-version>."
26660 msgstr ""
26661
26662 # type: =head2
26663 #. type: =head2
26664 #: ../fish/guestfish-actions.pod:1925
26665 msgid "inspect-get-mountpoints"
26666 msgstr ""
26667
26668 # type: verbatim
26669 #. type: verbatim
26670 #: ../fish/guestfish-actions.pod:1927
26671 #, no-wrap
26672 msgid ""
26673 " inspect-get-mountpoints root\n"
26674 "\n"
26675 msgstr ""
26676
26677 #. type: textblock
26678 #: ../fish/guestfish-actions.pod:1949
26679 msgid ""
26680 "For operating systems like Windows which still use drive letters, this call "
26681 "will only return an entry for the first drive \"mounted on\" C</>.  For "
26682 "information about the mapping of drive letters to partitions, see L</inspect-"
26683 "get-drive-mappings>."
26684 msgstr ""
26685
26686 # type: textblock
26687 #. type: textblock
26688 #: ../fish/guestfish-actions.pod:1955
26689 msgid ""
26690 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26691 "get-filesystems>."
26692 msgstr ""
26693
26694 # type: =head2
26695 #. type: =head2
26696 #: ../fish/guestfish-actions.pod:1958
26697 msgid "inspect-get-package-format"
26698 msgstr ""
26699
26700 # type: verbatim
26701 #. type: verbatim
26702 #: ../fish/guestfish-actions.pod:1960
26703 #, no-wrap
26704 msgid ""
26705 " inspect-get-package-format root\n"
26706 "\n"
26707 msgstr ""
26708
26709 # type: textblock
26710 #. type: textblock
26711 #: ../fish/guestfish-actions.pod:1965
26712 msgid ""
26713 "This function and L</inspect-get-package-management> return the package "
26714 "format and package management tool used by the inspected operating system.  "
26715 "For example for Fedora these functions would return C<rpm> (package format) "
26716 "and C<yum> (package management)."
26717 msgstr ""
26718
26719 # type: =head2
26720 #. type: =head2
26721 #: ../fish/guestfish-actions.pod:1980
26722 msgid "inspect-get-package-management"
26723 msgstr ""
26724
26725 # type: verbatim
26726 #. type: verbatim
26727 #: ../fish/guestfish-actions.pod:1982
26728 #, no-wrap
26729 msgid ""
26730 " inspect-get-package-management root\n"
26731 "\n"
26732 msgstr ""
26733
26734 # type: textblock
26735 #. type: textblock
26736 #: ../fish/guestfish-actions.pod:1987
26737 msgid ""
26738 "L</inspect-get-package-format> and this function return the package format "
26739 "and package management tool used by the inspected operating system.  For "
26740 "example for Fedora these functions would return C<rpm> (package format) and "
26741 "C<yum> (package management)."
26742 msgstr ""
26743
26744 # type: =head2
26745 #. type: =head2
26746 #: ../fish/guestfish-actions.pod:2004
26747 msgid "inspect-get-product-name"
26748 msgstr ""
26749
26750 # type: verbatim
26751 #. type: verbatim
26752 #: ../fish/guestfish-actions.pod:2006
26753 #, no-wrap
26754 msgid ""
26755 " inspect-get-product-name root\n"
26756 "\n"
26757 msgstr ""
26758
26759 #. type: =head2
26760 #: ../fish/guestfish-actions.pod:2021
26761 msgid "inspect-get-product-variant"
26762 msgstr ""
26763
26764 #. type: verbatim
26765 #: ../fish/guestfish-actions.pod:2023
26766 #, no-wrap
26767 msgid ""
26768 " inspect-get-product-variant root\n"
26769 "\n"
26770 msgstr ""
26771
26772 #. type: textblock
26773 #: ../fish/guestfish-actions.pod:2047
26774 msgid ""
26775 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26776 "get-product-name>, L</inspect-get-major-version>."
26777 msgstr ""
26778
26779 # type: =head2
26780 #. type: =head2
26781 #: ../fish/guestfish-actions.pod:2051
26782 msgid "inspect-get-roots"
26783 msgstr ""
26784
26785 # type: verbatim
26786 #. type: verbatim
26787 #: ../fish/guestfish-actions.pod:2053
26788 #, no-wrap
26789 msgid ""
26790 " inspect-get-roots\n"
26791 "\n"
26792 msgstr ""
26793
26794 # type: textblock
26795 #. type: textblock
26796 #: ../fish/guestfish-actions.pod:2055
26797 msgid ""
26798 "This function is a convenient way to get the list of root devices, as "
26799 "returned from a previous call to L</inspect-os>, but without redoing the "
26800 "whole inspection process."
26801 msgstr ""
26802
26803 # type: textblock
26804 #. type: textblock
26805 #: ../fish/guestfish-actions.pod:2059
26806 msgid ""
26807 "This returns an empty list if either no root devices were found or the "
26808 "caller has not called L</inspect-os>."
26809 msgstr ""
26810
26811 # type: =head2
26812 #. type: =head2
26813 #: ../fish/guestfish-actions.pod:2064
26814 msgid "inspect-get-type"
26815 msgstr ""
26816
26817 # type: verbatim
26818 #. type: verbatim
26819 #: ../fish/guestfish-actions.pod:2066
26820 #, no-wrap
26821 msgid ""
26822 " inspect-get-type root\n"
26823 "\n"
26824 msgstr ""
26825
26826 #. type: =head2
26827 #: ../fish/guestfish-actions.pod:2099
26828 msgid "inspect-get-windows-current-control-set"
26829 msgstr ""
26830
26831 #. type: verbatim
26832 #: ../fish/guestfish-actions.pod:2101
26833 #, no-wrap
26834 msgid ""
26835 " inspect-get-windows-current-control-set root\n"
26836 "\n"
26837 msgstr ""
26838
26839 # type: =head2
26840 #. type: =head2
26841 #: ../fish/guestfish-actions.pod:2115
26842 msgid "inspect-get-windows-systemroot"
26843 msgstr ""
26844
26845 # type: verbatim
26846 #. type: verbatim
26847 #: ../fish/guestfish-actions.pod:2117
26848 #, no-wrap
26849 msgid ""
26850 " inspect-get-windows-systemroot root\n"
26851 "\n"
26852 msgstr ""
26853
26854 #. type: =head2
26855 #: ../fish/guestfish-actions.pod:2131
26856 msgid "inspect-is-live"
26857 msgstr ""
26858
26859 #. type: verbatim
26860 #: ../fish/guestfish-actions.pod:2133
26861 #, no-wrap
26862 msgid ""
26863 " inspect-is-live root\n"
26864 "\n"
26865 msgstr ""
26866
26867 #. type: textblock
26868 #: ../fish/guestfish-actions.pod:2138
26869 msgid ""
26870 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26871 "then this returns true if a live image was detected on the disk."
26872 msgstr ""
26873
26874 #. type: =head2
26875 #: ../fish/guestfish-actions.pod:2144
26876 msgid "inspect-is-multipart"
26877 msgstr ""
26878
26879 #. type: verbatim
26880 #: ../fish/guestfish-actions.pod:2146
26881 #, no-wrap
26882 msgid ""
26883 " inspect-is-multipart root\n"
26884 "\n"
26885 msgstr ""
26886
26887 #. type: textblock
26888 #: ../fish/guestfish-actions.pod:2151
26889 msgid ""
26890 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26891 "then this returns true if the disk is part of a set."
26892 msgstr ""
26893
26894 #. type: =head2
26895 #: ../fish/guestfish-actions.pod:2157
26896 msgid "inspect-is-netinst"
26897 msgstr ""
26898
26899 #. type: verbatim
26900 #: ../fish/guestfish-actions.pod:2159
26901 #, no-wrap
26902 msgid ""
26903 " inspect-is-netinst root\n"
26904 "\n"
26905 msgstr ""
26906
26907 #. type: textblock
26908 #: ../fish/guestfish-actions.pod:2164
26909 msgid ""
26910 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26911 "then this returns true if the disk is a network installer, ie. not a self-"
26912 "contained install CD but one which is likely to require network access to "
26913 "complete the install."
26914 msgstr ""
26915
26916 # type: =head2
26917 #. type: =head2
26918 #: ../fish/guestfish-actions.pod:2172
26919 msgid "inspect-list-applications"
26920 msgstr ""
26921
26922 # type: verbatim
26923 #. type: verbatim
26924 #: ../fish/guestfish-actions.pod:2174
26925 #, no-wrap
26926 msgid ""
26927 " inspect-list-applications root\n"
26928 "\n"
26929 msgstr ""
26930
26931 # type: textblock
26932 #. type: textblock
26933 #: ../fish/guestfish-actions.pod:2181
26934 msgid ""
26935 "I<Note:> This call works differently from other parts of the inspection "
26936 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
26937 "then mount up the disks, before calling this.  Listing applications is a "
26938 "significantly more difficult operation which requires access to the full "
26939 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
26940 "are just returning data cached in the libguestfs handle, this call actually "
26941 "reads parts of the mounted filesystems during the call."
26942 msgstr ""
26943
26944 # type: =head2
26945 #. type: =head2
26946 #: ../fish/guestfish-actions.pod:2271
26947 msgid "inspect-os"
26948 msgstr ""
26949
26950 # type: verbatim
26951 #. type: verbatim
26952 #: ../fish/guestfish-actions.pod:2273
26953 #, no-wrap
26954 msgid ""
26955 " inspect-os\n"
26956 "\n"
26957 msgstr ""
26958
26959 # type: textblock
26960 #. type: textblock
26961 #: ../fish/guestfish-actions.pod:2288
26962 msgid ""
26963 "You can pass the root string(s) returned to other L</inspect-get-*> "
26964 "functions in order to query further information about each operating system, "
26965 "such as the name and version."
26966 msgstr ""
26967
26968 # type: textblock
26969 #. type: textblock
26970 #: ../fish/guestfish-actions.pod:2293
26971 msgid ""
26972 "This function uses other libguestfs features such as L</mount-ro> and L</"
26973 "umount-all> in order to mount and unmount filesystems and look at the "
26974 "contents.  This should be called with no disks currently mounted.  The "
26975 "function may also use Augeas, so any existing Augeas handle will be closed."
26976 msgstr ""
26977
26978 # type: textblock
26979 #. type: textblock
26980 #: ../fish/guestfish-actions.pod:2305 ../fish/guestfish-actions.pod:2481
26981 #: ../fish/guestfish-actions.pod:2527
26982 msgid "See also L</list-filesystems>."
26983 msgstr ""
26984
26985 # type: =head2
26986 #. type: =head2
26987 #: ../fish/guestfish-actions.pod:2307
26988 msgid "is-blockdev"
26989 msgstr ""
26990
26991 # type: verbatim
26992 #. type: verbatim
26993 #: ../fish/guestfish-actions.pod:2309
26994 #, no-wrap
26995 msgid ""
26996 " is-blockdev path\n"
26997 "\n"
26998 msgstr ""
26999
27000 # type: textblock
27001 #. type: textblock
27002 #: ../fish/guestfish-actions.pod:2314 ../fish/guestfish-actions.pod:2332
27003 #: ../fish/guestfish-actions.pod:2351 ../fish/guestfish-actions.pod:2360
27004 #: ../fish/guestfish-actions.pod:2370 ../fish/guestfish-actions.pod:2404
27005 #: ../fish/guestfish-actions.pod:2413
27006 msgid "See also L</stat>."
27007 msgstr ""
27008
27009 # type: =head2
27010 #. type: =head2
27011 #: ../fish/guestfish-actions.pod:2316
27012 msgid "is-busy"
27013 msgstr ""
27014
27015 # type: verbatim
27016 #. type: verbatim
27017 #: ../fish/guestfish-actions.pod:2318
27018 #, no-wrap
27019 msgid ""
27020 " is-busy\n"
27021 "\n"
27022 msgstr ""
27023
27024 # type: =head2
27025 #. type: =head2
27026 #: ../fish/guestfish-actions.pod:2325
27027 msgid "is-chardev"
27028 msgstr ""
27029
27030 # type: verbatim
27031 #. type: verbatim
27032 #: ../fish/guestfish-actions.pod:2327
27033 #, no-wrap
27034 msgid ""
27035 " is-chardev path\n"
27036 "\n"
27037 msgstr ""
27038
27039 # type: =head2
27040 #. type: =head2
27041 #: ../fish/guestfish-actions.pod:2334
27042 msgid "is-config"
27043 msgstr ""
27044
27045 # type: verbatim
27046 #. type: verbatim
27047 #: ../fish/guestfish-actions.pod:2336
27048 #, no-wrap
27049 msgid ""
27050 " is-config\n"
27051 "\n"
27052 msgstr ""
27053
27054 # type: =head2
27055 #. type: =head2
27056 #: ../fish/guestfish-actions.pod:2343
27057 msgid "is-dir"
27058 msgstr ""
27059
27060 # type: verbatim
27061 #. type: verbatim
27062 #: ../fish/guestfish-actions.pod:2345
27063 #, no-wrap
27064 msgid ""
27065 " is-dir path\n"
27066 "\n"
27067 msgstr ""
27068
27069 # type: =head2
27070 #. type: =head2
27071 #: ../fish/guestfish-actions.pod:2353
27072 msgid "is-fifo"
27073 msgstr ""
27074
27075 # type: verbatim
27076 #. type: verbatim
27077 #: ../fish/guestfish-actions.pod:2355
27078 #, no-wrap
27079 msgid ""
27080 " is-fifo path\n"
27081 "\n"
27082 msgstr ""
27083
27084 # type: =head2
27085 #. type: =head2
27086 #: ../fish/guestfish-actions.pod:2362
27087 msgid "is-file"
27088 msgstr ""
27089
27090 # type: verbatim
27091 #. type: verbatim
27092 #: ../fish/guestfish-actions.pod:2364
27093 #, no-wrap
27094 msgid ""
27095 " is-file path\n"
27096 "\n"
27097 msgstr ""
27098
27099 # type: =head2
27100 #. type: =head2
27101 #: ../fish/guestfish-actions.pod:2372
27102 msgid "is-launching"
27103 msgstr ""
27104
27105 # type: verbatim
27106 #. type: verbatim
27107 #: ../fish/guestfish-actions.pod:2374
27108 #, no-wrap
27109 msgid ""
27110 " is-launching\n"
27111 "\n"
27112 msgstr ""
27113
27114 # type: =head2
27115 #. type: =head2
27116 #: ../fish/guestfish-actions.pod:2381
27117 msgid "is-lv"
27118 msgstr ""
27119
27120 # type: verbatim
27121 #. type: verbatim
27122 #: ../fish/guestfish-actions.pod:2383
27123 #, no-wrap
27124 msgid ""
27125 " is-lv device\n"
27126 "\n"
27127 msgstr ""
27128
27129 # type: =head2
27130 #. type: =head2
27131 #: ../fish/guestfish-actions.pod:2388
27132 msgid "is-ready"
27133 msgstr ""
27134
27135 # type: verbatim
27136 #. type: verbatim
27137 #: ../fish/guestfish-actions.pod:2390
27138 #, no-wrap
27139 msgid ""
27140 " is-ready\n"
27141 "\n"
27142 msgstr ""
27143
27144 # type: =head2
27145 #. type: =head2
27146 #: ../fish/guestfish-actions.pod:2397
27147 msgid "is-socket"
27148 msgstr ""
27149
27150 # type: verbatim
27151 #. type: verbatim
27152 #: ../fish/guestfish-actions.pod:2399
27153 #, no-wrap
27154 msgid ""
27155 " is-socket path\n"
27156 "\n"
27157 msgstr ""
27158
27159 # type: =head2
27160 #. type: =head2
27161 #: ../fish/guestfish-actions.pod:2406
27162 msgid "is-symlink"
27163 msgstr ""
27164
27165 # type: verbatim
27166 #. type: verbatim
27167 #: ../fish/guestfish-actions.pod:2408
27168 #, no-wrap
27169 msgid ""
27170 " is-symlink path\n"
27171 "\n"
27172 msgstr ""
27173
27174 # type: =head2
27175 #. type: =head2
27176 #: ../fish/guestfish-actions.pod:2415
27177 msgid "kill-subprocess"
27178 msgstr ""
27179
27180 # type: verbatim
27181 #. type: verbatim
27182 #: ../fish/guestfish-actions.pod:2417
27183 #, no-wrap
27184 msgid ""
27185 " kill-subprocess\n"
27186 "\n"
27187 msgstr ""
27188
27189 # type: =head2
27190 #. type: =head2
27191 #: ../fish/guestfish-actions.pod:2421
27192 msgid "launch"
27193 msgstr ""
27194
27195 # type: =head2
27196 #. type: =head2
27197 #: ../fish/guestfish-actions.pod:2423
27198 msgid "run"
27199 msgstr ""
27200
27201 # type: verbatim
27202 #. type: verbatim
27203 #: ../fish/guestfish-actions.pod:2425
27204 #, no-wrap
27205 msgid ""
27206 " launch\n"
27207 "\n"
27208 msgstr ""
27209
27210 # type: =head2
27211 #. type: =head2
27212 #: ../fish/guestfish-actions.pod:2433
27213 msgid "lchown"
27214 msgstr ""
27215
27216 # type: verbatim
27217 #. type: verbatim
27218 #: ../fish/guestfish-actions.pod:2435
27219 #, no-wrap
27220 msgid ""
27221 " lchown owner group path\n"
27222 "\n"
27223 msgstr ""
27224
27225 # type: textblock
27226 #. type: textblock
27227 #: ../fish/guestfish-actions.pod:2437
27228 msgid ""
27229 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
27230 "chown> but if C<path> is a symlink then the link itself is changed, not the "
27231 "target."
27232 msgstr ""
27233
27234 # type: =head2
27235 #. type: =head2
27236 #: ../fish/guestfish-actions.pod:2445
27237 msgid "lgetxattr"
27238 msgstr ""
27239
27240 # type: verbatim
27241 #. type: verbatim
27242 #: ../fish/guestfish-actions.pod:2447
27243 #, no-wrap
27244 msgid ""
27245 " lgetxattr path name\n"
27246 "\n"
27247 msgstr ""
27248
27249 # type: textblock
27250 #. type: textblock
27251 #: ../fish/guestfish-actions.pod:2463
27252 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
27253 msgstr ""
27254
27255 # type: =head2
27256 #. type: =head2
27257 #: ../fish/guestfish-actions.pod:2465
27258 msgid "lgetxattrs"
27259 msgstr ""
27260
27261 # type: verbatim
27262 #. type: verbatim
27263 #: ../fish/guestfish-actions.pod:2467
27264 #, no-wrap
27265 msgid ""
27266 " lgetxattrs path\n"
27267 "\n"
27268 msgstr ""
27269
27270 # type: textblock
27271 #. type: textblock
27272 #: ../fish/guestfish-actions.pod:2469
27273 msgid ""
27274 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
27275 "it returns the extended attributes of the link itself."
27276 msgstr ""
27277
27278 # type: =head2
27279 #. type: =head2
27280 #: ../fish/guestfish-actions.pod:2473
27281 msgid "list-devices"
27282 msgstr ""
27283
27284 # type: verbatim
27285 #. type: verbatim
27286 #: ../fish/guestfish-actions.pod:2475
27287 #, no-wrap
27288 msgid ""
27289 " list-devices\n"
27290 "\n"
27291 msgstr ""
27292
27293 # type: =head2
27294 #. type: =head2
27295 #: ../fish/guestfish-actions.pod:2483
27296 msgid "list-filesystems"
27297 msgstr ""
27298
27299 # type: verbatim
27300 #. type: verbatim
27301 #: ../fish/guestfish-actions.pod:2485
27302 #, no-wrap
27303 msgid ""
27304 " list-filesystems\n"
27305 "\n"
27306 msgstr ""
27307
27308 # type: textblock
27309 #. type: textblock
27310 #: ../fish/guestfish-actions.pod:2504
27311 msgid ""
27312 "This command runs other libguestfs commands, which might include L</mount> "
27313 "and L</umount>, and therefore you should use this soon after launch and only "
27314 "when nothing is mounted."
27315 msgstr ""
27316
27317 # type: textblock
27318 #. type: textblock
27319 #: ../fish/guestfish-actions.pod:2508
27320 msgid ""
27321 "Not all of the filesystems returned will be mountable.  In particular, swap "
27322 "partitions are returned in the list.  Also this command does not check that "
27323 "each filesystem found is valid and mountable, and some filesystems might be "
27324 "mountable but require special options.  Filesystems may not all belong to a "
27325 "single logical operating system (use L</inspect-os> to look for OSes)."
27326 msgstr ""
27327
27328 # type: =head2
27329 #. type: =head2
27330 #: ../fish/guestfish-actions.pod:2516
27331 msgid "list-partitions"
27332 msgstr ""
27333
27334 # type: verbatim
27335 #. type: verbatim
27336 #: ../fish/guestfish-actions.pod:2518
27337 #, no-wrap
27338 msgid ""
27339 " list-partitions\n"
27340 "\n"
27341 msgstr ""
27342
27343 # type: textblock
27344 #. type: textblock
27345 #: ../fish/guestfish-actions.pod:2524
27346 msgid ""
27347 "This does not return logical volumes.  For that you will need to call L</"
27348 "lvs>."
27349 msgstr ""
27350
27351 # type: =head2
27352 #. type: =head2
27353 #: ../fish/guestfish-actions.pod:2529
27354 msgid "ll"
27355 msgstr ""
27356
27357 # type: verbatim
27358 #. type: verbatim
27359 #: ../fish/guestfish-actions.pod:2531
27360 #, no-wrap
27361 msgid ""
27362 " ll directory\n"
27363 "\n"
27364 msgstr ""
27365
27366 # type: =head2
27367 #. type: =head2
27368 #: ../fish/guestfish-actions.pod:2539
27369 msgid "ln"
27370 msgstr ""
27371
27372 # type: verbatim
27373 #. type: verbatim
27374 #: ../fish/guestfish-actions.pod:2541
27375 #, no-wrap
27376 msgid ""
27377 " ln target linkname\n"
27378 "\n"
27379 msgstr ""
27380
27381 # type: =head2
27382 #. type: =head2
27383 #: ../fish/guestfish-actions.pod:2545
27384 msgid "ln-f"
27385 msgstr ""
27386
27387 # type: verbatim
27388 #. type: verbatim
27389 #: ../fish/guestfish-actions.pod:2547
27390 #, no-wrap
27391 msgid ""
27392 " ln-f target linkname\n"
27393 "\n"
27394 msgstr ""
27395
27396 # type: =head2
27397 #. type: =head2
27398 #: ../fish/guestfish-actions.pod:2552
27399 msgid "ln-s"
27400 msgstr ""
27401
27402 # type: verbatim
27403 #. type: verbatim
27404 #: ../fish/guestfish-actions.pod:2554
27405 #, no-wrap
27406 msgid ""
27407 " ln-s target linkname\n"
27408 "\n"
27409 msgstr ""
27410
27411 # type: =head2
27412 #. type: =head2
27413 #: ../fish/guestfish-actions.pod:2558
27414 msgid "ln-sf"
27415 msgstr ""
27416
27417 # type: verbatim
27418 #. type: verbatim
27419 #: ../fish/guestfish-actions.pod:2560
27420 #, no-wrap
27421 msgid ""
27422 " ln-sf target linkname\n"
27423 "\n"
27424 msgstr ""
27425
27426 # type: =head2
27427 #. type: =head2
27428 #: ../fish/guestfish-actions.pod:2565
27429 msgid "lremovexattr"
27430 msgstr ""
27431
27432 # type: verbatim
27433 #. type: verbatim
27434 #: ../fish/guestfish-actions.pod:2567
27435 #, no-wrap
27436 msgid ""
27437 " lremovexattr xattr path\n"
27438 "\n"
27439 msgstr ""
27440
27441 # type: textblock
27442 #. type: textblock
27443 #: ../fish/guestfish-actions.pod:2569
27444 msgid ""
27445 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
27446 "it removes an extended attribute of the link itself."
27447 msgstr ""
27448
27449 # type: =head2
27450 #. type: =head2
27451 #: ../fish/guestfish-actions.pod:2573
27452 msgid "ls"
27453 msgstr ""
27454
27455 # type: verbatim
27456 #. type: verbatim
27457 #: ../fish/guestfish-actions.pod:2575
27458 #, no-wrap
27459 msgid ""
27460 " ls directory\n"
27461 "\n"
27462 msgstr ""
27463
27464 # type: textblock
27465 #. type: textblock
27466 #: ../fish/guestfish-actions.pod:2581
27467 msgid ""
27468 "This command is mostly useful for interactive sessions.  Programs should "
27469 "probably use L</readdir> instead."
27470 msgstr ""
27471
27472 # type: =head2
27473 #. type: =head2
27474 #: ../fish/guestfish-actions.pod:2584
27475 msgid "lsetxattr"
27476 msgstr ""
27477
27478 # type: verbatim
27479 #. type: verbatim
27480 #: ../fish/guestfish-actions.pod:2586
27481 #, no-wrap
27482 msgid ""
27483 " lsetxattr xattr val vallen path\n"
27484 "\n"
27485 msgstr ""
27486
27487 # type: textblock
27488 #. type: textblock
27489 #: ../fish/guestfish-actions.pod:2588
27490 msgid ""
27491 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
27492 "sets an extended attribute of the link itself."
27493 msgstr ""
27494
27495 # type: =head2
27496 #. type: =head2
27497 #: ../fish/guestfish-actions.pod:2592
27498 msgid "lstat"
27499 msgstr ""
27500
27501 # type: verbatim
27502 #. type: verbatim
27503 #: ../fish/guestfish-actions.pod:2594
27504 #, no-wrap
27505 msgid ""
27506 " lstat path\n"
27507 "\n"
27508 msgstr ""
27509
27510 # type: textblock
27511 #. type: textblock
27512 #: ../fish/guestfish-actions.pod:2598
27513 msgid ""
27514 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
27515 "the link is stat-ed, not the file it refers to."
27516 msgstr ""
27517
27518 # type: =head2
27519 #. type: =head2
27520 #: ../fish/guestfish-actions.pod:2604
27521 msgid "lstatlist"
27522 msgstr ""
27523
27524 # type: verbatim
27525 #. type: verbatim
27526 #: ../fish/guestfish-actions.pod:2606
27527 #, no-wrap
27528 msgid ""
27529 " lstatlist path 'names ...'\n"
27530 "\n"
27531 msgstr ""
27532
27533 # type: textblock
27534 #. type: textblock
27535 #: ../fish/guestfish-actions.pod:2608
27536 msgid ""
27537 "This call allows you to perform the L</lstat> operation on multiple files, "
27538 "where all files are in the directory C<path>.  C<names> is the list of files "
27539 "from this directory."
27540 msgstr ""
27541
27542 # type: textblock
27543 #. type: textblock
27544 #: ../fish/guestfish-actions.pod:2617
27545 msgid ""
27546 "This call is intended for programs that want to efficiently list a directory "
27547 "contents without making many round-trips.  See also L</lxattrlist> for a "
27548 "similarly efficient call for getting extended attributes.  Very long "
27549 "directory listings might cause the protocol message size to be exceeded, "
27550 "causing this call to fail.  The caller must split up such requests into "
27551 "smaller groups of names."
27552 msgstr ""
27553
27554 # type: =head2
27555 #. type: =head2
27556 #: ../fish/guestfish-actions.pod:2625
27557 msgid "luks-add-key"
27558 msgstr ""
27559
27560 # type: verbatim
27561 #. type: verbatim
27562 #: ../fish/guestfish-actions.pod:2627
27563 #, no-wrap
27564 msgid ""
27565 " luks-add-key device keyslot\n"
27566 "\n"
27567 msgstr ""
27568
27569 # type: textblock
27570 #. type: textblock
27571 #: ../fish/guestfish-actions.pod:2634
27572 msgid ""
27573 "Note that if C<keyslot> already contains a key, then this command will "
27574 "fail.  You have to use L</luks-kill-slot> first to remove that key."
27575 msgstr ""
27576
27577 # type: textblock
27578 #. type: textblock
27579 #: ../fish/guestfish-actions.pod:2638 ../fish/guestfish-actions.pod:2660
27580 #: ../fish/guestfish-actions.pod:2673 ../fish/guestfish-actions.pod:2687
27581 #: ../fish/guestfish-actions.pod:2710 ../fish/guestfish-actions.pod:2720
27582 msgid ""
27583 "This command has one or more key or passphrase parameters.  Guestfish will "
27584 "prompt for these separately."
27585 msgstr ""
27586
27587 # type: =head2
27588 #. type: =head2
27589 #: ../fish/guestfish-actions.pod:2641
27590 msgid "luks-close"
27591 msgstr ""
27592
27593 # type: verbatim
27594 #. type: verbatim
27595 #: ../fish/guestfish-actions.pod:2643
27596 #, no-wrap
27597 msgid ""
27598 " luks-close device\n"
27599 "\n"
27600 msgstr ""
27601
27602 # type: textblock
27603 #. type: textblock
27604 #: ../fish/guestfish-actions.pod:2645
27605 msgid ""
27606 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
27607 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
27608 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
27609 "block device."
27610 msgstr ""
27611
27612 # type: =head2
27613 #. type: =head2
27614 #: ../fish/guestfish-actions.pod:2651
27615 msgid "luks-format"
27616 msgstr ""
27617
27618 # type: verbatim
27619 #. type: verbatim
27620 #: ../fish/guestfish-actions.pod:2653
27621 #, no-wrap
27622 msgid ""
27623 " luks-format device keyslot\n"
27624 "\n"
27625 msgstr ""
27626
27627 # type: =head2
27628 #. type: =head2
27629 #: ../fish/guestfish-actions.pod:2666
27630 msgid "luks-format-cipher"
27631 msgstr ""
27632
27633 # type: verbatim
27634 #. type: verbatim
27635 #: ../fish/guestfish-actions.pod:2668
27636 #, no-wrap
27637 msgid ""
27638 " luks-format-cipher device keyslot cipher\n"
27639 "\n"
27640 msgstr ""
27641
27642 # type: textblock
27643 #. type: textblock
27644 #: ../fish/guestfish-actions.pod:2670
27645 msgid ""
27646 "This command is the same as L</luks-format> but it also allows you to set "
27647 "the C<cipher> used."
27648 msgstr ""
27649
27650 # type: =head2
27651 #. type: =head2
27652 #: ../fish/guestfish-actions.pod:2679
27653 msgid "luks-kill-slot"
27654 msgstr ""
27655
27656 # type: verbatim
27657 #. type: verbatim
27658 #: ../fish/guestfish-actions.pod:2681
27659 #, no-wrap
27660 msgid ""
27661 " luks-kill-slot device keyslot\n"
27662 "\n"
27663 msgstr ""
27664
27665 # type: =head2
27666 #. type: =head2
27667 #: ../fish/guestfish-actions.pod:2690
27668 msgid "luks-open"
27669 msgstr ""
27670
27671 # type: verbatim
27672 #. type: verbatim
27673 #: ../fish/guestfish-actions.pod:2692
27674 #, no-wrap
27675 msgid ""
27676 " luks-open device mapname\n"
27677 "\n"
27678 msgstr ""
27679
27680 # type: textblock
27681 #. type: textblock
27682 #: ../fish/guestfish-actions.pod:2706
27683 msgid ""
27684 "If this block device contains LVM volume groups, then calling L</vgscan> "
27685 "followed by L</vg-activate-all> will make them visible."
27686 msgstr ""
27687
27688 # type: =head2
27689 #. type: =head2
27690 #: ../fish/guestfish-actions.pod:2713
27691 msgid "luks-open-ro"
27692 msgstr ""
27693
27694 # type: verbatim
27695 #. type: verbatim
27696 #: ../fish/guestfish-actions.pod:2715
27697 #, no-wrap
27698 msgid ""
27699 " luks-open-ro device mapname\n"
27700 "\n"
27701 msgstr ""
27702
27703 # type: textblock
27704 #. type: textblock
27705 #: ../fish/guestfish-actions.pod:2717
27706 msgid ""
27707 "This is the same as L</luks-open> except that a read-only mapping is created."
27708 msgstr ""
27709
27710 # type: =head2
27711 #. type: =head2
27712 #: ../fish/guestfish-actions.pod:2723
27713 msgid "lvcreate"
27714 msgstr ""
27715
27716 # type: verbatim
27717 #. type: verbatim
27718 #: ../fish/guestfish-actions.pod:2725
27719 #, no-wrap
27720 msgid ""
27721 " lvcreate logvol volgroup mbytes\n"
27722 "\n"
27723 msgstr ""
27724
27725 # type: =head2
27726 #. type: =head2
27727 #: ../fish/guestfish-actions.pod:2730
27728 msgid "lvm-canonical-lv-name"
27729 msgstr ""
27730
27731 # type: verbatim
27732 #. type: verbatim
27733 #: ../fish/guestfish-actions.pod:2732
27734 #, no-wrap
27735 msgid ""
27736 " lvm-canonical-lv-name lvname\n"
27737 "\n"
27738 msgstr ""
27739
27740 # type: textblock
27741 #. type: textblock
27742 #: ../fish/guestfish-actions.pod:2741
27743 msgid "See also L</is-lv>."
27744 msgstr ""
27745
27746 # type: =head2
27747 #. type: =head2
27748 #: ../fish/guestfish-actions.pod:2743
27749 msgid "lvm-clear-filter"
27750 msgstr ""
27751
27752 # type: verbatim
27753 #. type: verbatim
27754 #: ../fish/guestfish-actions.pod:2745
27755 #, no-wrap
27756 msgid ""
27757 " lvm-clear-filter\n"
27758 "\n"
27759 msgstr ""
27760
27761 # type: textblock
27762 #. type: textblock
27763 #: ../fish/guestfish-actions.pod:2747
27764 msgid ""
27765 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
27766 "block device."
27767 msgstr ""
27768
27769 # type: =head2
27770 #. type: =head2
27771 #: ../fish/guestfish-actions.pod:2753
27772 msgid "lvm-remove-all"
27773 msgstr ""
27774
27775 # type: verbatim
27776 #. type: verbatim
27777 #: ../fish/guestfish-actions.pod:2755
27778 #, no-wrap
27779 msgid ""
27780 " lvm-remove-all\n"
27781 "\n"
27782 msgstr ""
27783
27784 # type: =head2
27785 #. type: =head2
27786 #: ../fish/guestfish-actions.pod:2763
27787 msgid "lvm-set-filter"
27788 msgstr ""
27789
27790 # type: verbatim
27791 #. type: verbatim
27792 #: ../fish/guestfish-actions.pod:2765
27793 #, no-wrap
27794 msgid ""
27795 " lvm-set-filter 'devices ...'\n"
27796 "\n"
27797 msgstr ""
27798
27799 # type: =head2
27800 #. type: =head2
27801 #: ../fish/guestfish-actions.pod:2790
27802 msgid "lvremove"
27803 msgstr ""
27804
27805 # type: verbatim
27806 #. type: verbatim
27807 #: ../fish/guestfish-actions.pod:2792
27808 #, no-wrap
27809 msgid ""
27810 " lvremove device\n"
27811 "\n"
27812 msgstr ""
27813
27814 # type: =head2
27815 #. type: =head2
27816 #: ../fish/guestfish-actions.pod:2800
27817 msgid "lvrename"
27818 msgstr ""
27819
27820 # type: verbatim
27821 #. type: verbatim
27822 #: ../fish/guestfish-actions.pod:2802
27823 #, no-wrap
27824 msgid ""
27825 " lvrename logvol newlogvol\n"
27826 "\n"
27827 msgstr ""
27828
27829 # type: =head2
27830 #. type: =head2
27831 #: ../fish/guestfish-actions.pod:2806
27832 msgid "lvresize"
27833 msgstr ""
27834
27835 # type: verbatim
27836 #. type: verbatim
27837 #: ../fish/guestfish-actions.pod:2808
27838 #, no-wrap
27839 msgid ""
27840 " lvresize device mbytes\n"
27841 "\n"
27842 msgstr ""
27843
27844 # type: =head2
27845 #. type: =head2
27846 #: ../fish/guestfish-actions.pod:2814
27847 msgid "lvresize-free"
27848 msgstr ""
27849
27850 # type: verbatim
27851 #. type: verbatim
27852 #: ../fish/guestfish-actions.pod:2816
27853 #, no-wrap
27854 msgid ""
27855 " lvresize-free lv percent\n"
27856 "\n"
27857 msgstr ""
27858
27859 # type: =head2
27860 #. type: =head2
27861 #: ../fish/guestfish-actions.pod:2824
27862 msgid "lvs"
27863 msgstr ""
27864
27865 # type: verbatim
27866 #. type: verbatim
27867 #: ../fish/guestfish-actions.pod:2826
27868 #, no-wrap
27869 msgid ""
27870 " lvs\n"
27871 "\n"
27872 msgstr ""
27873
27874 # type: textblock
27875 #. type: textblock
27876 #: ../fish/guestfish-actions.pod:2834
27877 msgid "See also L</lvs-full>, L</list-filesystems>."
27878 msgstr ""
27879
27880 # type: =head2
27881 #. type: =head2
27882 #: ../fish/guestfish-actions.pod:2836
27883 msgid "lvs-full"
27884 msgstr ""
27885
27886 # type: verbatim
27887 #. type: verbatim
27888 #: ../fish/guestfish-actions.pod:2838
27889 #, no-wrap
27890 msgid ""
27891 " lvs-full\n"
27892 "\n"
27893 msgstr ""
27894
27895 # type: =head2
27896 #. type: =head2
27897 #: ../fish/guestfish-actions.pod:2843
27898 msgid "lvuuid"
27899 msgstr ""
27900
27901 # type: verbatim
27902 #. type: verbatim
27903 #: ../fish/guestfish-actions.pod:2845
27904 #, no-wrap
27905 msgid ""
27906 " lvuuid device\n"
27907 "\n"
27908 msgstr ""
27909
27910 # type: =head2
27911 #. type: =head2
27912 #: ../fish/guestfish-actions.pod:2849
27913 msgid "lxattrlist"
27914 msgstr ""
27915
27916 # type: verbatim
27917 #. type: verbatim
27918 #: ../fish/guestfish-actions.pod:2851
27919 #, no-wrap
27920 msgid ""
27921 " lxattrlist path 'names ...'\n"
27922 "\n"
27923 msgstr ""
27924
27925 # type: textblock
27926 #. type: textblock
27927 #: ../fish/guestfish-actions.pod:2867
27928 msgid ""
27929 "This call is intended for programs that want to efficiently list a directory "
27930 "contents without making many round-trips.  See also L</lstatlist> for a "
27931 "similarly efficient call for getting standard stats.  Very long directory "
27932 "listings might cause the protocol message size to be exceeded, causing this "
27933 "call to fail.  The caller must split up such requests into smaller groups of "
27934 "names."
27935 msgstr ""
27936
27937 # type: =head2
27938 #. type: =head2
27939 #: ../fish/guestfish-actions.pod:2875
27940 msgid "mkdir"
27941 msgstr ""
27942
27943 # type: verbatim
27944 #. type: verbatim
27945 #: ../fish/guestfish-actions.pod:2877
27946 #, no-wrap
27947 msgid ""
27948 " mkdir path\n"
27949 "\n"
27950 msgstr ""
27951
27952 # type: =head2
27953 #. type: =head2
27954 #: ../fish/guestfish-actions.pod:2881
27955 msgid "mkdir-mode"
27956 msgstr ""
27957
27958 # type: verbatim
27959 #. type: verbatim
27960 #: ../fish/guestfish-actions.pod:2883
27961 #, no-wrap
27962 msgid ""
27963 " mkdir-mode path mode\n"
27964 "\n"
27965 msgstr ""
27966
27967 # type: textblock
27968 #. type: textblock
27969 #: ../fish/guestfish-actions.pod:2892
27970 msgid "See also L</mkdir>, L</umask>"
27971 msgstr ""
27972
27973 # type: =head2
27974 #. type: =head2
27975 #: ../fish/guestfish-actions.pod:2894
27976 msgid "mkdir-p"
27977 msgstr ""
27978
27979 # type: verbatim
27980 #. type: verbatim
27981 #: ../fish/guestfish-actions.pod:2896
27982 #, no-wrap
27983 msgid ""
27984 " mkdir-p path\n"
27985 "\n"
27986 msgstr ""
27987
27988 # type: =head2
27989 #. type: =head2
27990 #: ../fish/guestfish-actions.pod:2901
27991 msgid "mkdtemp"
27992 msgstr ""
27993
27994 # type: verbatim
27995 #. type: verbatim
27996 #: ../fish/guestfish-actions.pod:2903
27997 #, no-wrap
27998 msgid ""
27999 " mkdtemp template\n"
28000 "\n"
28001 msgstr ""
28002
28003 # type: =head2
28004 #. type: =head2
28005 #: ../fish/guestfish-actions.pod:2924
28006 msgid "mke2fs-J"
28007 msgstr ""
28008
28009 # type: verbatim
28010 #. type: verbatim
28011 #: ../fish/guestfish-actions.pod:2926
28012 #, no-wrap
28013 msgid ""
28014 " mke2fs-J fstype blocksize device journal\n"
28015 "\n"
28016 msgstr ""
28017
28018 # type: textblock
28019 #. type: textblock
28020 #: ../fish/guestfish-actions.pod:2934
28021 msgid "See also L</mke2journal>."
28022 msgstr ""
28023
28024 # type: =head2
28025 #. type: =head2
28026 #: ../fish/guestfish-actions.pod:2936
28027 msgid "mke2fs-JL"
28028 msgstr ""
28029
28030 # type: verbatim
28031 #. type: verbatim
28032 #: ../fish/guestfish-actions.pod:2938
28033 #, no-wrap
28034 msgid ""
28035 " mke2fs-JL fstype blocksize device label\n"
28036 "\n"
28037 msgstr ""
28038
28039 # type: textblock
28040 #. type: textblock
28041 #: ../fish/guestfish-actions.pod:2943
28042 msgid "See also L</mke2journal-L>."
28043 msgstr ""
28044
28045 # type: =head2
28046 #. type: =head2
28047 #: ../fish/guestfish-actions.pod:2945
28048 msgid "mke2fs-JU"
28049 msgstr ""
28050
28051 # type: verbatim
28052 #. type: verbatim
28053 #: ../fish/guestfish-actions.pod:2947
28054 #, no-wrap
28055 msgid ""
28056 " mke2fs-JU fstype blocksize device uuid\n"
28057 "\n"
28058 msgstr ""
28059
28060 # type: textblock
28061 #. type: textblock
28062 #: ../fish/guestfish-actions.pod:2952
28063 msgid "See also L</mke2journal-U>."
28064 msgstr ""
28065
28066 # type: =head2
28067 #. type: =head2
28068 #: ../fish/guestfish-actions.pod:2954
28069 msgid "mke2journal"
28070 msgstr ""
28071
28072 # type: verbatim
28073 #. type: verbatim
28074 #: ../fish/guestfish-actions.pod:2956
28075 #, no-wrap
28076 msgid ""
28077 " mke2journal blocksize device\n"
28078 "\n"
28079 msgstr ""
28080
28081 # type: =head2
28082 #. type: =head2
28083 #: ../fish/guestfish-actions.pod:2963
28084 msgid "mke2journal-L"
28085 msgstr ""
28086
28087 # type: verbatim
28088 #. type: verbatim
28089 #: ../fish/guestfish-actions.pod:2965
28090 #, no-wrap
28091 msgid ""
28092 " mke2journal-L blocksize label device\n"
28093 "\n"
28094 msgstr ""
28095
28096 # type: =head2
28097 #. type: =head2
28098 #: ../fish/guestfish-actions.pod:2969
28099 msgid "mke2journal-U"
28100 msgstr ""
28101
28102 # type: verbatim
28103 #. type: verbatim
28104 #: ../fish/guestfish-actions.pod:2971
28105 #, no-wrap
28106 msgid ""
28107 " mke2journal-U blocksize uuid device\n"
28108 "\n"
28109 msgstr ""
28110
28111 # type: =head2
28112 #. type: =head2
28113 #: ../fish/guestfish-actions.pod:2975
28114 msgid "mkfifo"
28115 msgstr ""
28116
28117 # type: verbatim
28118 #. type: verbatim
28119 #: ../fish/guestfish-actions.pod:2977
28120 #, no-wrap
28121 msgid ""
28122 " mkfifo mode path\n"
28123 "\n"
28124 msgstr ""
28125
28126 # type: textblock
28127 #. type: textblock
28128 #: ../fish/guestfish-actions.pod:2979
28129 msgid ""
28130 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
28131 "is just a convenient wrapper around L</mknod>."
28132 msgstr ""
28133
28134 # type: =head2
28135 #. type: =head2
28136 #: ../fish/guestfish-actions.pod:2985
28137 msgid "mkfs"
28138 msgstr ""
28139
28140 # type: verbatim
28141 #. type: verbatim
28142 #: ../fish/guestfish-actions.pod:2987
28143 #, no-wrap
28144 msgid ""
28145 " mkfs fstype device\n"
28146 "\n"
28147 msgstr ""
28148
28149 # type: =head2
28150 #. type: =head2
28151 #: ../fish/guestfish-actions.pod:2993
28152 msgid "mkfs-b"
28153 msgstr ""
28154
28155 # type: verbatim
28156 #. type: verbatim
28157 #: ../fish/guestfish-actions.pod:2995
28158 #, no-wrap
28159 msgid ""
28160 " mkfs-b fstype blocksize device\n"
28161 "\n"
28162 msgstr ""
28163
28164 # type: textblock
28165 #. type: textblock
28166 #: ../fish/guestfish-actions.pod:2997
28167 msgid ""
28168 "This call is similar to L</mkfs>, but it allows you to control the block "
28169 "size of the resulting filesystem.  Supported block sizes depend on the "
28170 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
28171 msgstr ""
28172
28173 # type: =head2
28174 #. type: =head2
28175 #: ../fish/guestfish-actions.pod:3012
28176 msgid "mkfs-opts"
28177 msgstr ""
28178
28179 #. type: verbatim
28180 #: ../fish/guestfish-actions.pod:3014
28181 #, no-wrap
28182 msgid ""
28183 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
28184 "\n"
28185 msgstr ""
28186
28187 # type: =head2
28188 #. type: =head2
28189 #: ../fish/guestfish-actions.pod:3049
28190 msgid "mkmountpoint"
28191 msgstr ""
28192
28193 # type: verbatim
28194 #. type: verbatim
28195 #: ../fish/guestfish-actions.pod:3051
28196 #, no-wrap
28197 msgid ""
28198 " mkmountpoint exemptpath\n"
28199 "\n"
28200 msgstr ""
28201
28202 # type: textblock
28203 #. type: textblock
28204 #: ../fish/guestfish-actions.pod:3053
28205 msgid ""
28206 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
28207 "to create extra mountpoints before mounting the first filesystem."
28208 msgstr ""
28209
28210 # type: textblock
28211 #. type: textblock
28212 #: ../fish/guestfish-actions.pod:3077
28213 msgid ""
28214 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
28215 "unexpected errors if you try to mix these calls.  It is safest to manually "
28216 "unmount filesystems and remove mountpoints after use."
28217 msgstr ""
28218
28219 # type: textblock
28220 #. type: textblock
28221 #: ../fish/guestfish-actions.pod:3081
28222 msgid ""
28223 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
28224 "for this to work for manual mountpoints, you must ensure that the innermost "
28225 "mountpoints have the longest pathnames, as in the example code above."
28226 msgstr ""
28227
28228 #. type: textblock
28229 #: ../fish/guestfish-actions.pod:3088
28230 msgid ""
28231 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
28232 "L</umount-all> to be called when the handle is closed which can also trigger "
28233 "these issues."
28234 msgstr ""
28235
28236 # type: =head2
28237 #. type: =head2
28238 #: ../fish/guestfish-actions.pod:3092
28239 msgid "mknod"
28240 msgstr ""
28241
28242 # type: verbatim
28243 #. type: verbatim
28244 #: ../fish/guestfish-actions.pod:3094
28245 #, no-wrap
28246 msgid ""
28247 " mknod mode devmajor devminor path\n"
28248 "\n"
28249 msgstr ""
28250
28251 # type: textblock
28252 #. type: textblock
28253 #: ../fish/guestfish-actions.pod:3104
28254 msgid ""
28255 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
28256 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
28257 "regular file).  These constants are available in the standard Linux header "
28258 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
28259 "wrappers around this command which bitwise OR in the appropriate constant "
28260 "for you."
28261 msgstr ""
28262
28263 # type: =head2
28264 #. type: =head2
28265 #: ../fish/guestfish-actions.pod:3114
28266 msgid "mknod-b"
28267 msgstr ""
28268
28269 # type: verbatim
28270 #. type: verbatim
28271 #: ../fish/guestfish-actions.pod:3116
28272 #, no-wrap
28273 msgid ""
28274 " mknod-b mode devmajor devminor path\n"
28275 "\n"
28276 msgstr ""
28277
28278 # type: textblock
28279 #. type: textblock
28280 #: ../fish/guestfish-actions.pod:3118
28281 msgid ""
28282 "This call creates a block device node called C<path> with mode C<mode> and "
28283 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28284 "wrapper around L</mknod>."
28285 msgstr ""
28286
28287 # type: =head2
28288 #. type: =head2
28289 #: ../fish/guestfish-actions.pod:3124
28290 msgid "mknod-c"
28291 msgstr ""
28292
28293 # type: verbatim
28294 #. type: verbatim
28295 #: ../fish/guestfish-actions.pod:3126
28296 #, no-wrap
28297 msgid ""
28298 " mknod-c mode devmajor devminor path\n"
28299 "\n"
28300 msgstr ""
28301
28302 # type: textblock
28303 #. type: textblock
28304 #: ../fish/guestfish-actions.pod:3128
28305 msgid ""
28306 "This call creates a char device node called C<path> with mode C<mode> and "
28307 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28308 "wrapper around L</mknod>."
28309 msgstr ""
28310
28311 # type: =head2
28312 #. type: =head2
28313 #: ../fish/guestfish-actions.pod:3134
28314 msgid "mkswap"
28315 msgstr ""
28316
28317 # type: verbatim
28318 #. type: verbatim
28319 #: ../fish/guestfish-actions.pod:3136
28320 #, no-wrap
28321 msgid ""
28322 " mkswap device\n"
28323 "\n"
28324 msgstr ""
28325
28326 # type: =head2
28327 #. type: =head2
28328 #: ../fish/guestfish-actions.pod:3140
28329 msgid "mkswap-L"
28330 msgstr ""
28331
28332 # type: verbatim
28333 #. type: verbatim
28334 #: ../fish/guestfish-actions.pod:3142
28335 #, no-wrap
28336 msgid ""
28337 " mkswap-L label device\n"
28338 "\n"
28339 msgstr ""
28340
28341 # type: =head2
28342 #. type: =head2
28343 #: ../fish/guestfish-actions.pod:3150
28344 msgid "mkswap-U"
28345 msgstr ""
28346
28347 # type: verbatim
28348 #. type: verbatim
28349 #: ../fish/guestfish-actions.pod:3152
28350 #, no-wrap
28351 msgid ""
28352 " mkswap-U uuid device\n"
28353 "\n"
28354 msgstr ""
28355
28356 # type: =head2
28357 #. type: =head2
28358 #: ../fish/guestfish-actions.pod:3156
28359 msgid "mkswap-file"
28360 msgstr ""
28361
28362 # type: verbatim
28363 #. type: verbatim
28364 #: ../fish/guestfish-actions.pod:3158
28365 #, no-wrap
28366 msgid ""
28367 " mkswap-file path\n"
28368 "\n"
28369 msgstr ""
28370
28371 # type: textblock
28372 #. type: textblock
28373 #: ../fish/guestfish-actions.pod:3162
28374 msgid ""
28375 "This command just writes a swap file signature to an existing file.  To "
28376 "create the file itself, use something like L</fallocate>."
28377 msgstr ""
28378
28379 # type: =head2
28380 #. type: =head2
28381 #: ../fish/guestfish-actions.pod:3165
28382 msgid "modprobe"
28383 msgstr ""
28384
28385 # type: verbatim
28386 #. type: verbatim
28387 #: ../fish/guestfish-actions.pod:3167
28388 #, no-wrap
28389 msgid ""
28390 " modprobe modulename\n"
28391 "\n"
28392 msgstr ""
28393
28394 # type: =head2
28395 #. type: =head2
28396 #: ../fish/guestfish-actions.pod:3174
28397 msgid "mount"
28398 msgstr ""
28399
28400 # type: verbatim
28401 #. type: verbatim
28402 #: ../fish/guestfish-actions.pod:3176
28403 #, no-wrap
28404 msgid ""
28405 " mount device mountpoint\n"
28406 "\n"
28407 msgstr ""
28408
28409 # type: textblock
28410 #. type: textblock
28411 #: ../fish/guestfish-actions.pod:3192
28412 msgid ""
28413 "B<Important note:> When you use this call, the filesystem options C<sync> "
28414 "and C<noatime> are set implicitly.  This was originally done because we "
28415 "thought it would improve reliability, but it turns out that I<-o sync> has a "
28416 "very large negative performance impact and negligible effect on "
28417 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
28418 "code that needs performance, and instead use L</mount-options> (use an empty "
28419 "string for the first parameter if you don't want any options)."
28420 msgstr ""
28421
28422 # type: =head2
28423 #. type: =head2
28424 #: ../fish/guestfish-actions.pod:3202
28425 msgid "mount-loop"
28426 msgstr ""
28427
28428 # type: verbatim
28429 #. type: verbatim
28430 #: ../fish/guestfish-actions.pod:3204
28431 #, no-wrap
28432 msgid ""
28433 " mount-loop file mountpoint\n"
28434 "\n"
28435 msgstr ""
28436
28437 # type: =head2
28438 #. type: =head2
28439 #: ../fish/guestfish-actions.pod:3210
28440 msgid "mount-options"
28441 msgstr ""
28442
28443 # type: verbatim
28444 #. type: verbatim
28445 #: ../fish/guestfish-actions.pod:3212
28446 #, no-wrap
28447 msgid ""
28448 " mount-options options device mountpoint\n"
28449 "\n"
28450 msgstr ""
28451
28452 # type: textblock
28453 #. type: textblock
28454 #: ../fish/guestfish-actions.pod:3214
28455 msgid ""
28456 "This is the same as the L</mount> command, but it allows you to set the "
28457 "mount options as for the L<mount(8)> I<-o> flag."
28458 msgstr ""
28459
28460 # type: =head2
28461 #. type: =head2
28462 #: ../fish/guestfish-actions.pod:3222
28463 msgid "mount-ro"
28464 msgstr ""
28465
28466 # type: verbatim
28467 #. type: verbatim
28468 #: ../fish/guestfish-actions.pod:3224
28469 #, no-wrap
28470 msgid ""
28471 " mount-ro device mountpoint\n"
28472 "\n"
28473 msgstr ""
28474
28475 # type: textblock
28476 #. type: textblock
28477 #: ../fish/guestfish-actions.pod:3226
28478 msgid ""
28479 "This is the same as the L</mount> command, but it mounts the filesystem with "
28480 "the read-only (I<-o ro>) flag."
28481 msgstr ""
28482
28483 # type: =head2
28484 #. type: =head2
28485 #: ../fish/guestfish-actions.pod:3229
28486 msgid "mount-vfs"
28487 msgstr ""
28488
28489 # type: verbatim
28490 #. type: verbatim
28491 #: ../fish/guestfish-actions.pod:3231
28492 #, no-wrap
28493 msgid ""
28494 " mount-vfs options vfstype device mountpoint\n"
28495 "\n"
28496 msgstr ""
28497
28498 # type: textblock
28499 #. type: textblock
28500 #: ../fish/guestfish-actions.pod:3233
28501 msgid ""
28502 "This is the same as the L</mount> command, but it allows you to set both the "
28503 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
28504 msgstr ""
28505
28506 # type: =head2
28507 #. type: =head2
28508 #: ../fish/guestfish-actions.pod:3237
28509 msgid "mountpoints"
28510 msgstr ""
28511
28512 # type: verbatim
28513 #. type: verbatim
28514 #: ../fish/guestfish-actions.pod:3239
28515 #, no-wrap
28516 msgid ""
28517 " mountpoints\n"
28518 "\n"
28519 msgstr ""
28520
28521 # type: textblock
28522 #. type: textblock
28523 #: ../fish/guestfish-actions.pod:3241
28524 msgid ""
28525 "This call is similar to L</mounts>.  That call returns a list of devices.  "
28526 "This one returns a hash table (map) of device name to directory where the "
28527 "device is mounted."
28528 msgstr ""
28529
28530 # type: =head2
28531 #. type: =head2
28532 #: ../fish/guestfish-actions.pod:3245
28533 msgid "mounts"
28534 msgstr ""
28535
28536 # type: verbatim
28537 #. type: verbatim
28538 #: ../fish/guestfish-actions.pod:3247
28539 #, no-wrap
28540 msgid ""
28541 " mounts\n"
28542 "\n"
28543 msgstr ""
28544
28545 # type: textblock
28546 #. type: textblock
28547 #: ../fish/guestfish-actions.pod:3254
28548 msgid "See also: L</mountpoints>"
28549 msgstr ""
28550
28551 # type: =head2
28552 #. type: =head2
28553 #: ../fish/guestfish-actions.pod:3256
28554 msgid "mv"
28555 msgstr ""
28556
28557 # type: verbatim
28558 #. type: verbatim
28559 #: ../fish/guestfish-actions.pod:3258
28560 #, no-wrap
28561 msgid ""
28562 " mv src dest\n"
28563 "\n"
28564 msgstr ""
28565
28566 # type: =head2
28567 #. type: =head2
28568 #: ../fish/guestfish-actions.pod:3263
28569 msgid "ntfs-3g-probe"
28570 msgstr ""
28571
28572 # type: verbatim
28573 #. type: verbatim
28574 #: ../fish/guestfish-actions.pod:3265
28575 #, no-wrap
28576 msgid ""
28577 " ntfs-3g-probe true|false device\n"
28578 "\n"
28579 msgstr ""
28580
28581 # type: =head2
28582 #. type: =head2
28583 #: ../fish/guestfish-actions.pod:3279
28584 msgid "ntfsresize"
28585 msgstr ""
28586
28587 # type: verbatim
28588 #. type: verbatim
28589 #: ../fish/guestfish-actions.pod:3281
28590 #, no-wrap
28591 msgid ""
28592 " ntfsresize device\n"
28593 "\n"
28594 msgstr ""
28595
28596 # type: =head2
28597 #. type: =head2
28598 #: ../fish/guestfish-actions.pod:3287
28599 msgid "ntfsresize-size"
28600 msgstr ""
28601
28602 # type: verbatim
28603 #. type: verbatim
28604 #: ../fish/guestfish-actions.pod:3289
28605 #, no-wrap
28606 msgid ""
28607 " ntfsresize-size device size\n"
28608 "\n"
28609 msgstr ""
28610
28611 # type: textblock
28612 #. type: textblock
28613 #: ../fish/guestfish-actions.pod:3291
28614 msgid ""
28615 "This command is the same as L</ntfsresize> except that it allows you to "
28616 "specify the new size (in bytes) explicitly."
28617 msgstr ""
28618
28619 # type: =head2
28620 #. type: =head2
28621 #: ../fish/guestfish-actions.pod:3294
28622 msgid "part-add"
28623 msgstr ""
28624
28625 # type: verbatim
28626 #. type: verbatim
28627 #: ../fish/guestfish-actions.pod:3296
28628 #, no-wrap
28629 msgid ""
28630 " part-add device prlogex startsect endsect\n"
28631 "\n"
28632 msgstr ""
28633
28634 # type: textblock
28635 #. type: textblock
28636 #: ../fish/guestfish-actions.pod:3298
28637 msgid ""
28638 "This command adds a partition to C<device>.  If there is no partition table "
28639 "on the device, call L</part-init> first."
28640 msgstr ""
28641
28642 # type: textblock
28643 #. type: textblock
28644 #: ../fish/guestfish-actions.pod:3310
28645 msgid ""
28646 "Creating a partition which covers the whole disk is not so easy.  Use L</"
28647 "part-disk> to do that."
28648 msgstr ""
28649
28650 # type: =head2
28651 #. type: =head2
28652 #: ../fish/guestfish-actions.pod:3313
28653 msgid "part-del"
28654 msgstr ""
28655
28656 # type: verbatim
28657 #. type: verbatim
28658 #: ../fish/guestfish-actions.pod:3315
28659 #, no-wrap
28660 msgid ""
28661 " part-del device partnum\n"
28662 "\n"
28663 msgstr ""
28664
28665 # type: =head2
28666 #. type: =head2
28667 #: ../fish/guestfish-actions.pod:3323
28668 msgid "part-disk"
28669 msgstr ""
28670
28671 # type: verbatim
28672 #. type: verbatim
28673 #: ../fish/guestfish-actions.pod:3325
28674 #, no-wrap
28675 msgid ""
28676 " part-disk device parttype\n"
28677 "\n"
28678 msgstr ""
28679
28680 # type: textblock
28681 #. type: textblock
28682 #: ../fish/guestfish-actions.pod:3327
28683 msgid ""
28684 "This command is simply a combination of L</part-init> followed by L</part-"
28685 "add> to create a single primary partition covering the whole disk."
28686 msgstr ""
28687
28688 # type: textblock
28689 #. type: textblock
28690 #: ../fish/guestfish-actions.pod:3331
28691 msgid ""
28692 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
28693 "possible values are described in L</part-init>."
28694 msgstr ""
28695
28696 # type: =head2
28697 #. type: =head2
28698 #: ../fish/guestfish-actions.pod:3337
28699 msgid "part-get-bootable"
28700 msgstr ""
28701
28702 # type: verbatim
28703 #. type: verbatim
28704 #: ../fish/guestfish-actions.pod:3339
28705 #, no-wrap
28706 msgid ""
28707 " part-get-bootable device partnum\n"
28708 "\n"
28709 msgstr ""
28710
28711 # type: textblock
28712 #. type: textblock
28713 #: ../fish/guestfish-actions.pod:3344
28714 msgid "See also L</part-set-bootable>."
28715 msgstr ""
28716
28717 # type: =head2
28718 #. type: =head2
28719 #: ../fish/guestfish-actions.pod:3346
28720 msgid "part-get-mbr-id"
28721 msgstr ""
28722
28723 # type: verbatim
28724 #. type: verbatim
28725 #: ../fish/guestfish-actions.pod:3348
28726 #, no-wrap
28727 msgid ""
28728 " part-get-mbr-id device partnum\n"
28729 "\n"
28730 msgstr ""
28731
28732 # type: textblock
28733 #. type: textblock
28734 #: ../fish/guestfish-actions.pod:3353 ../fish/guestfish-actions.pod:3491
28735 msgid ""
28736 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
28737 "undefined results for other partition table types (see L</part-get-"
28738 "parttype>)."
28739 msgstr ""
28740
28741 # type: =head2
28742 #. type: =head2
28743 #: ../fish/guestfish-actions.pod:3357
28744 msgid "part-get-parttype"
28745 msgstr ""
28746
28747 # type: verbatim
28748 #. type: verbatim
28749 #: ../fish/guestfish-actions.pod:3359
28750 #, no-wrap
28751 msgid ""
28752 " part-get-parttype device\n"
28753 "\n"
28754 msgstr ""
28755
28756 # type: textblock
28757 #. type: textblock
28758 #: ../fish/guestfish-actions.pod:3364
28759 msgid ""
28760 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
28761 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
28762 "possible, although unusual.  See L</part-init> for a full list."
28763 msgstr ""
28764
28765 # type: =head2
28766 #. type: =head2
28767 #: ../fish/guestfish-actions.pod:3369
28768 msgid "part-init"
28769 msgstr ""
28770
28771 # type: verbatim
28772 #. type: verbatim
28773 #: ../fish/guestfish-actions.pod:3371
28774 #, no-wrap
28775 msgid ""
28776 " part-init device parttype\n"
28777 "\n"
28778 msgstr ""
28779
28780 # type: textblock
28781 #. type: textblock
28782 #: ../fish/guestfish-actions.pod:3377
28783 msgid ""
28784 "Initially there are no partitions.  Following this, you should call L</part-"
28785 "add> for each partition required."
28786 msgstr ""
28787
28788 # type: =head2
28789 #. type: =head2
28790 #: ../fish/guestfish-actions.pod:3440
28791 msgid "part-list"
28792 msgstr ""
28793
28794 # type: verbatim
28795 #. type: verbatim
28796 #: ../fish/guestfish-actions.pod:3442
28797 #, no-wrap
28798 msgid ""
28799 " part-list device\n"
28800 "\n"
28801 msgstr ""
28802
28803 # type: textblock
28804 #. type: textblock
28805 #: ../fish/guestfish-actions.pod:3457
28806 msgid ""
28807 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
28808 "the device's sector size, see L</blockdev-getss>."
28809 msgstr ""
28810
28811 # type: =head2
28812 #. type: =head2
28813 #: ../fish/guestfish-actions.pod:3470
28814 msgid "part-set-bootable"
28815 msgstr ""
28816
28817 # type: verbatim
28818 #. type: verbatim
28819 #: ../fish/guestfish-actions.pod:3472
28820 #, no-wrap
28821 msgid ""
28822 " part-set-bootable device partnum true|false\n"
28823 "\n"
28824 msgstr ""
28825
28826 # type: =head2
28827 #. type: =head2
28828 #: ../fish/guestfish-actions.pod:3481
28829 msgid "part-set-mbr-id"
28830 msgstr ""
28831
28832 # type: verbatim
28833 #. type: verbatim
28834 #: ../fish/guestfish-actions.pod:3483
28835 #, no-wrap
28836 msgid ""
28837 " part-set-mbr-id device partnum idbyte\n"
28838 "\n"
28839 msgstr ""
28840
28841 # type: =head2
28842 #. type: =head2
28843 #: ../fish/guestfish-actions.pod:3495
28844 msgid "part-set-name"
28845 msgstr ""
28846
28847 # type: verbatim
28848 #. type: verbatim
28849 #: ../fish/guestfish-actions.pod:3497
28850 #, no-wrap
28851 msgid ""
28852 " part-set-name device partnum name\n"
28853 "\n"
28854 msgstr ""
28855
28856 # type: =head2
28857 #. type: =head2
28858 #: ../fish/guestfish-actions.pod:3505
28859 msgid "part-to-dev"
28860 msgstr ""
28861
28862 # type: verbatim
28863 #. type: verbatim
28864 #: ../fish/guestfish-actions.pod:3507
28865 #, no-wrap
28866 msgid ""
28867 " part-to-dev partition\n"
28868 "\n"
28869 msgstr ""
28870
28871 # type: textblock
28872 #. type: textblock
28873 #: ../fish/guestfish-actions.pod:3513
28874 msgid ""
28875 "The named partition must exist, for example as a string returned from L</"
28876 "list-partitions>."
28877 msgstr ""
28878
28879 # type: =head2
28880 #. type: =head2
28881 #: ../fish/guestfish-actions.pod:3516
28882 msgid "ping-daemon"
28883 msgstr ""
28884
28885 # type: verbatim
28886 #. type: verbatim
28887 #: ../fish/guestfish-actions.pod:3518
28888 #, no-wrap
28889 msgid ""
28890 " ping-daemon\n"
28891 "\n"
28892 msgstr ""
28893
28894 # type: =head2
28895 #. type: =head2
28896 #: ../fish/guestfish-actions.pod:3525
28897 msgid "pread"
28898 msgstr ""
28899
28900 # type: verbatim
28901 #. type: verbatim
28902 #: ../fish/guestfish-actions.pod:3527
28903 #, no-wrap
28904 msgid ""
28905 " pread path count offset\n"
28906 "\n"
28907 msgstr ""
28908
28909 # type: textblock
28910 #. type: textblock
28911 #: ../fish/guestfish-actions.pod:3535
28912 msgid "See also L</pwrite>, L</pread-device>."
28913 msgstr ""
28914
28915 # type: =head2
28916 #. type: =head2
28917 #: ../fish/guestfish-actions.pod:3540
28918 msgid "pread-device"
28919 msgstr ""
28920
28921 # type: verbatim
28922 #. type: verbatim
28923 #: ../fish/guestfish-actions.pod:3542
28924 #, no-wrap
28925 msgid ""
28926 " pread-device device count offset\n"
28927 "\n"
28928 msgstr ""
28929
28930 # type: textblock
28931 #. type: textblock
28932 #: ../fish/guestfish-actions.pod:3550
28933 msgid "See also L</pread>."
28934 msgstr ""
28935
28936 # type: =head2
28937 #. type: =head2
28938 #: ../fish/guestfish-actions.pod:3555
28939 msgid "pvcreate"
28940 msgstr ""
28941
28942 # type: verbatim
28943 #. type: verbatim
28944 #: ../fish/guestfish-actions.pod:3557
28945 #, no-wrap
28946 msgid ""
28947 " pvcreate device\n"
28948 "\n"
28949 msgstr ""
28950
28951 # type: =head2
28952 #. type: =head2
28953 #: ../fish/guestfish-actions.pod:3563
28954 msgid "pvremove"
28955 msgstr ""
28956
28957 # type: verbatim
28958 #. type: verbatim
28959 #: ../fish/guestfish-actions.pod:3565
28960 #, no-wrap
28961 msgid ""
28962 " pvremove device\n"
28963 "\n"
28964 msgstr ""
28965
28966 # type: =head2
28967 #. type: =head2
28968 #: ../fish/guestfish-actions.pod:3574
28969 msgid "pvresize"
28970 msgstr ""
28971
28972 # type: verbatim
28973 #. type: verbatim
28974 #: ../fish/guestfish-actions.pod:3576
28975 #, no-wrap
28976 msgid ""
28977 " pvresize device\n"
28978 "\n"
28979 msgstr ""
28980
28981 # type: =head2
28982 #. type: =head2
28983 #: ../fish/guestfish-actions.pod:3581
28984 msgid "pvresize-size"
28985 msgstr ""
28986
28987 # type: verbatim
28988 #. type: verbatim
28989 #: ../fish/guestfish-actions.pod:3583
28990 #, no-wrap
28991 msgid ""
28992 " pvresize-size device size\n"
28993 "\n"
28994 msgstr ""
28995
28996 # type: textblock
28997 #. type: textblock
28998 #: ../fish/guestfish-actions.pod:3585
28999 msgid ""
29000 "This command is the same as L</pvresize> except that it allows you to "
29001 "specify the new size (in bytes) explicitly."
29002 msgstr ""
29003
29004 # type: =head2
29005 #. type: =head2
29006 #: ../fish/guestfish-actions.pod:3588
29007 msgid "pvs"
29008 msgstr ""
29009
29010 # type: verbatim
29011 #. type: verbatim
29012 #: ../fish/guestfish-actions.pod:3590
29013 #, no-wrap
29014 msgid ""
29015 " pvs\n"
29016 "\n"
29017 msgstr ""
29018
29019 # type: textblock
29020 #. type: textblock
29021 #: ../fish/guestfish-actions.pod:3598
29022 msgid "See also L</pvs-full>."
29023 msgstr ""
29024
29025 # type: =head2
29026 #. type: =head2
29027 #: ../fish/guestfish-actions.pod:3600
29028 msgid "pvs-full"
29029 msgstr ""
29030
29031 # type: verbatim
29032 #. type: verbatim
29033 #: ../fish/guestfish-actions.pod:3602
29034 #, no-wrap
29035 msgid ""
29036 " pvs-full\n"
29037 "\n"
29038 msgstr ""
29039
29040 # type: =head2
29041 #. type: =head2
29042 #: ../fish/guestfish-actions.pod:3607
29043 msgid "pvuuid"
29044 msgstr ""
29045
29046 # type: verbatim
29047 #. type: verbatim
29048 #: ../fish/guestfish-actions.pod:3609
29049 #, no-wrap
29050 msgid ""
29051 " pvuuid device\n"
29052 "\n"
29053 msgstr ""
29054
29055 # type: =head2
29056 #. type: =head2
29057 #: ../fish/guestfish-actions.pod:3613
29058 msgid "pwrite"
29059 msgstr ""
29060
29061 # type: verbatim
29062 #. type: verbatim
29063 #: ../fish/guestfish-actions.pod:3615
29064 #, no-wrap
29065 msgid ""
29066 " pwrite path content offset\n"
29067 "\n"
29068 msgstr ""
29069
29070 # type: textblock
29071 #. type: textblock
29072 #: ../fish/guestfish-actions.pod:3626
29073 msgid "See also L</pread>, L</pwrite-device>."
29074 msgstr ""
29075
29076 # type: =head2
29077 #. type: =head2
29078 #: ../fish/guestfish-actions.pod:3631
29079 msgid "pwrite-device"
29080 msgstr ""
29081
29082 # type: verbatim
29083 #. type: verbatim
29084 #: ../fish/guestfish-actions.pod:3633
29085 #, no-wrap
29086 msgid ""
29087 " pwrite-device device content offset\n"
29088 "\n"
29089 msgstr ""
29090
29091 # type: textblock
29092 #. type: textblock
29093 #: ../fish/guestfish-actions.pod:3643
29094 msgid "See also L</pwrite>."
29095 msgstr ""
29096
29097 # type: =head2
29098 #. type: =head2
29099 #: ../fish/guestfish-actions.pod:3648
29100 msgid "read-file"
29101 msgstr ""
29102
29103 # type: verbatim
29104 #. type: verbatim
29105 #: ../fish/guestfish-actions.pod:3650
29106 #, no-wrap
29107 msgid ""
29108 " read-file path\n"
29109 "\n"
29110 msgstr ""
29111
29112 # type: textblock
29113 #. type: textblock
29114 #: ../fish/guestfish-actions.pod:3655
29115 msgid ""
29116 "Unlike L</cat>, this function can correctly handle files that contain "
29117 "embedded ASCII NUL characters.  However unlike L</download>, this function "
29118 "is limited in the total size of file that can be handled."
29119 msgstr ""
29120
29121 # type: =head2
29122 #. type: =head2
29123 #: ../fish/guestfish-actions.pod:3663
29124 msgid "read-lines"
29125 msgstr ""
29126
29127 # type: verbatim
29128 #. type: verbatim
29129 #: ../fish/guestfish-actions.pod:3665
29130 #, no-wrap
29131 msgid ""
29132 " read-lines path\n"
29133 "\n"
29134 msgstr ""
29135
29136 # type: textblock
29137 #. type: textblock
29138 #: ../fish/guestfish-actions.pod:3672
29139 msgid ""
29140 "Note that this function cannot correctly handle binary files (specifically, "
29141 "files containing C<\\0> character which is treated as end of line).  For "
29142 "those you need to use the L</read-file> function which has a more complex "
29143 "interface."
29144 msgstr ""
29145
29146 # type: =head2
29147 #. type: =head2
29148 #: ../fish/guestfish-actions.pod:3677
29149 msgid "readdir"
29150 msgstr ""
29151
29152 # type: verbatim
29153 #. type: verbatim
29154 #: ../fish/guestfish-actions.pod:3679
29155 #, no-wrap
29156 msgid ""
29157 " readdir dir\n"
29158 "\n"
29159 msgstr ""
29160
29161 # type: textblock
29162 #. type: textblock
29163 #: ../fish/guestfish-actions.pod:3731
29164 msgid ""
29165 "This function is primarily intended for use by programs.  To get a simple "
29166 "list of names, use L</ls>.  To get a printable directory for human "
29167 "consumption, use L</ll>."
29168 msgstr ""
29169
29170 # type: =head2
29171 #. type: =head2
29172 #: ../fish/guestfish-actions.pod:3735
29173 msgid "readlink"
29174 msgstr ""
29175
29176 # type: verbatim
29177 #. type: verbatim
29178 #: ../fish/guestfish-actions.pod:3737
29179 #, no-wrap
29180 msgid ""
29181 " readlink path\n"
29182 "\n"
29183 msgstr ""
29184
29185 # type: =head2
29186 #. type: =head2
29187 #: ../fish/guestfish-actions.pod:3741
29188 msgid "readlinklist"
29189 msgstr ""
29190
29191 # type: verbatim
29192 #. type: verbatim
29193 #: ../fish/guestfish-actions.pod:3743
29194 #, no-wrap
29195 msgid ""
29196 " readlinklist path 'names ...'\n"
29197 "\n"
29198 msgstr ""
29199
29200 # type: =head2
29201 #. type: =head2
29202 #: ../fish/guestfish-actions.pod:3767
29203 msgid "realpath"
29204 msgstr ""
29205
29206 # type: verbatim
29207 #. type: verbatim
29208 #: ../fish/guestfish-actions.pod:3769
29209 #, no-wrap
29210 msgid ""
29211 " realpath path\n"
29212 "\n"
29213 msgstr ""
29214
29215 # type: =head2
29216 #. type: =head2
29217 #: ../fish/guestfish-actions.pod:3774
29218 msgid "removexattr"
29219 msgstr ""
29220
29221 # type: verbatim
29222 #. type: verbatim
29223 #: ../fish/guestfish-actions.pod:3776
29224 #, no-wrap
29225 msgid ""
29226 " removexattr xattr path\n"
29227 "\n"
29228 msgstr ""
29229
29230 # type: textblock
29231 #. type: textblock
29232 #: ../fish/guestfish-actions.pod:3781
29233 msgid "See also: L</lremovexattr>, L<attr(5)>."
29234 msgstr ""
29235
29236 # type: =head2
29237 #. type: =head2
29238 #: ../fish/guestfish-actions.pod:3783
29239 msgid "resize2fs"
29240 msgstr ""
29241
29242 # type: verbatim
29243 #. type: verbatim
29244 #: ../fish/guestfish-actions.pod:3785
29245 #, no-wrap
29246 msgid ""
29247 " resize2fs device\n"
29248 "\n"
29249 msgstr ""
29250
29251 # type: textblock
29252 #. type: textblock
29253 #: ../fish/guestfish-actions.pod:3790
29254 msgid ""
29255 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
29256 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
29257 "gives an error about this and sometimes not.  In any case, it is always safe "
29258 "to call L</e2fsck-f> before calling this function."
29259 msgstr ""
29260
29261 #. type: =head2
29262 #: ../fish/guestfish-actions.pod:3796
29263 msgid "resize2fs-M"
29264 msgstr ""
29265
29266 #. type: verbatim
29267 #: ../fish/guestfish-actions.pod:3798
29268 #, no-wrap
29269 msgid ""
29270 " resize2fs-M device\n"
29271 "\n"
29272 msgstr ""
29273
29274 #. type: textblock
29275 #: ../fish/guestfish-actions.pod:3800
29276 msgid ""
29277 "This command is the same as L</resize2fs>, but the filesystem is resized to "
29278 "its minimum size.  This works like the C<-M> option to the C<resize2fs> "
29279 "command."
29280 msgstr ""
29281
29282 #. type: textblock
29283 #: ../fish/guestfish-actions.pod:3804
29284 msgid ""
29285 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
29286 "and read the C<Block size> and C<Block count> values.  These two numbers, "
29287 "multiplied together, give the resulting size of the minimal filesystem in "
29288 "bytes."
29289 msgstr ""
29290
29291 # type: =head2
29292 #. type: =head2
29293 #: ../fish/guestfish-actions.pod:3809
29294 msgid "resize2fs-size"
29295 msgstr ""
29296
29297 # type: verbatim
29298 #. type: verbatim
29299 #: ../fish/guestfish-actions.pod:3811
29300 #, no-wrap
29301 msgid ""
29302 " resize2fs-size device size\n"
29303 "\n"
29304 msgstr ""
29305
29306 # type: textblock
29307 #. type: textblock
29308 #: ../fish/guestfish-actions.pod:3813
29309 msgid ""
29310 "This command is the same as L</resize2fs> except that it allows you to "
29311 "specify the new size (in bytes) explicitly."
29312 msgstr ""
29313
29314 # type: =head2
29315 #. type: =head2
29316 #: ../fish/guestfish-actions.pod:3816
29317 msgid "rm"
29318 msgstr ""
29319
29320 # type: verbatim
29321 #. type: verbatim
29322 #: ../fish/guestfish-actions.pod:3818
29323 #, no-wrap
29324 msgid ""
29325 " rm path\n"
29326 "\n"
29327 msgstr ""
29328
29329 # type: =head2
29330 #. type: =head2
29331 #: ../fish/guestfish-actions.pod:3822
29332 msgid "rm-rf"
29333 msgstr ""
29334
29335 # type: verbatim
29336 #. type: verbatim
29337 #: ../fish/guestfish-actions.pod:3824
29338 #, no-wrap
29339 msgid ""
29340 " rm-rf path\n"
29341 "\n"
29342 msgstr ""
29343
29344 # type: =head2
29345 #. type: =head2
29346 #: ../fish/guestfish-actions.pod:3830
29347 msgid "rmdir"
29348 msgstr ""
29349
29350 # type: verbatim
29351 #. type: verbatim
29352 #: ../fish/guestfish-actions.pod:3832
29353 #, no-wrap
29354 msgid ""
29355 " rmdir path\n"
29356 "\n"
29357 msgstr ""
29358
29359 # type: =head2
29360 #. type: =head2
29361 #: ../fish/guestfish-actions.pod:3836
29362 msgid "rmmountpoint"
29363 msgstr ""
29364
29365 # type: verbatim
29366 #. type: verbatim
29367 #: ../fish/guestfish-actions.pod:3838
29368 #, no-wrap
29369 msgid ""
29370 " rmmountpoint exemptpath\n"
29371 "\n"
29372 msgstr ""
29373
29374 # type: textblock
29375 #. type: textblock
29376 #: ../fish/guestfish-actions.pod:3840
29377 msgid ""
29378 "This calls removes a mountpoint that was previously created with L</"
29379 "mkmountpoint>.  See L</mkmountpoint> for full details."
29380 msgstr ""
29381
29382 # type: =head2
29383 #. type: =head2
29384 #: ../fish/guestfish-actions.pod:3844
29385 msgid "scrub-device"
29386 msgstr ""
29387
29388 # type: verbatim
29389 #. type: verbatim
29390 #: ../fish/guestfish-actions.pod:3846
29391 #, no-wrap
29392 msgid ""
29393 " scrub-device device\n"
29394 "\n"
29395 msgstr ""
29396
29397 # type: =head2
29398 #. type: =head2
29399 #: ../fish/guestfish-actions.pod:3857
29400 msgid "scrub-file"
29401 msgstr ""
29402
29403 # type: verbatim
29404 #. type: verbatim
29405 #: ../fish/guestfish-actions.pod:3859
29406 #, no-wrap
29407 msgid ""
29408 " scrub-file file\n"
29409 "\n"
29410 msgstr ""
29411
29412 # type: =head2
29413 #. type: =head2
29414 #: ../fish/guestfish-actions.pod:3869
29415 msgid "scrub-freespace"
29416 msgstr ""
29417
29418 # type: verbatim
29419 #. type: verbatim
29420 #: ../fish/guestfish-actions.pod:3871
29421 #, no-wrap
29422 msgid ""
29423 " scrub-freespace dir\n"
29424 "\n"
29425 msgstr ""
29426
29427 # type: textblock
29428 #. type: textblock
29429 #: ../fish/guestfish-actions.pod:3873
29430 msgid ""
29431 "This command creates the directory C<dir> and then fills it with files until "
29432 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
29433 "deletes them.  The intention is to scrub any free space on the partition "
29434 "containing C<dir>."
29435 msgstr ""
29436
29437 # type: =head2
29438 #. type: =head2
29439 #: ../fish/guestfish-actions.pod:3882
29440 msgid "set-append"
29441 msgstr ""
29442
29443 # type: =head2
29444 #. type: =head2
29445 #: ../fish/guestfish-actions.pod:3884
29446 msgid "append"
29447 msgstr ""
29448
29449 # type: verbatim
29450 #. type: verbatim
29451 #: ../fish/guestfish-actions.pod:3886
29452 #, no-wrap
29453 msgid ""
29454 " set-append append\n"
29455 "\n"
29456 msgstr ""
29457
29458 #. type: =head2
29459 #: ../fish/guestfish-actions.pod:3897
29460 msgid "set-attach-method"
29461 msgstr ""
29462
29463 #. type: =head2
29464 #: ../fish/guestfish-actions.pod:3899
29465 msgid "attach-method"
29466 msgstr ""
29467
29468 #. type: verbatim
29469 #: ../fish/guestfish-actions.pod:3901
29470 #, no-wrap
29471 msgid ""
29472 " set-attach-method attachmethod\n"
29473 "\n"
29474 msgstr ""
29475
29476 # type: =head2
29477 #. type: =head2
29478 #: ../fish/guestfish-actions.pod:3923
29479 msgid "set-autosync"
29480 msgstr ""
29481
29482 # type: =head2
29483 #. type: =head2
29484 #: ../fish/guestfish-actions.pod:3925
29485 msgid "autosync"
29486 msgstr ""
29487
29488 # type: verbatim
29489 #. type: verbatim
29490 #: ../fish/guestfish-actions.pod:3927
29491 #, no-wrap
29492 msgid ""
29493 " set-autosync true|false\n"
29494 "\n"
29495 msgstr ""
29496
29497 # type: =head2
29498 #. type: =head2
29499 #: ../fish/guestfish-actions.pod:3937
29500 msgid "set-direct"
29501 msgstr ""
29502
29503 # type: =head2
29504 #. type: =head2
29505 #: ../fish/guestfish-actions.pod:3939
29506 msgid "direct"
29507 msgstr ""
29508
29509 # type: verbatim
29510 #. type: verbatim
29511 #: ../fish/guestfish-actions.pod:3941
29512 #, no-wrap
29513 msgid ""
29514 " set-direct true|false\n"
29515 "\n"
29516 msgstr ""
29517
29518 # type: textblock
29519 #. type: textblock
29520 #: ../fish/guestfish-actions.pod:3947
29521 msgid ""
29522 "One consequence of this is that log messages aren't caught by the library "
29523 "and handled by L</set-log-message-callback>, but go straight to stdout."
29524 msgstr ""
29525
29526 # type: =head2
29527 #. type: =head2
29528 #: ../fish/guestfish-actions.pod:3956
29529 msgid "set-e2label"
29530 msgstr ""
29531
29532 # type: verbatim
29533 #. type: verbatim
29534 #: ../fish/guestfish-actions.pod:3958
29535 #, no-wrap
29536 msgid ""
29537 " set-e2label device label\n"
29538 "\n"
29539 msgstr ""
29540
29541 # type: textblock
29542 #. type: textblock
29543 #: ../fish/guestfish-actions.pod:3964
29544 msgid ""
29545 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
29546 "label on a filesystem."
29547 msgstr ""
29548
29549 # type: =head2
29550 #. type: =head2
29551 #: ../fish/guestfish-actions.pod:3967
29552 msgid "set-e2uuid"
29553 msgstr ""
29554
29555 # type: verbatim
29556 #. type: verbatim
29557 #: ../fish/guestfish-actions.pod:3969
29558 #, no-wrap
29559 msgid ""
29560 " set-e2uuid device uuid\n"
29561 "\n"
29562 msgstr ""
29563
29564 # type: textblock
29565 #. type: textblock
29566 #: ../fish/guestfish-actions.pod:3976
29567 msgid ""
29568 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
29569 "UUID of a filesystem."
29570 msgstr ""
29571
29572 # type: =head2
29573 #. type: =head2
29574 #: ../fish/guestfish-actions.pod:3979
29575 msgid "set-memsize"
29576 msgstr ""
29577
29578 # type: =head2
29579 #. type: =head2
29580 #: ../fish/guestfish-actions.pod:3981
29581 msgid "memsize"
29582 msgstr ""
29583
29584 # type: verbatim
29585 #. type: verbatim
29586 #: ../fish/guestfish-actions.pod:3983
29587 #, no-wrap
29588 msgid ""
29589 " set-memsize memsize\n"
29590 "\n"
29591 msgstr ""
29592
29593 # type: textblock
29594 #. type: textblock
29595 #: ../fish/guestfish-actions.pod:3985
29596 msgid ""
29597 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
29598 "This only has any effect if called before L</launch>."
29599 msgstr ""
29600
29601 # type: =head2
29602 #. type: =head2
29603 #: ../fish/guestfish-actions.pod:3996
29604 msgid "set-network"
29605 msgstr ""
29606
29607 # type: =head2
29608 #. type: =head2
29609 #: ../fish/guestfish-actions.pod:3998
29610 msgid "network"
29611 msgstr ""
29612
29613 # type: verbatim
29614 #. type: verbatim
29615 #: ../fish/guestfish-actions.pod:4000
29616 #, no-wrap
29617 msgid ""
29618 " set-network true|false\n"
29619 "\n"
29620 msgstr ""
29621
29622 # type: textblock
29623 #. type: textblock
29624 #: ../fish/guestfish-actions.pod:4008
29625 msgid ""
29626 "You must call this before calling L</launch>, otherwise it has no effect."
29627 msgstr ""
29628
29629 # type: =head2
29630 #. type: =head2
29631 #: ../fish/guestfish-actions.pod:4011
29632 msgid "set-path"
29633 msgstr ""
29634
29635 # type: =head2
29636 #. type: =head2
29637 #: ../fish/guestfish-actions.pod:4013
29638 msgid "path"
29639 msgstr ""
29640
29641 # type: verbatim
29642 #. type: verbatim
29643 #: ../fish/guestfish-actions.pod:4015
29644 #, no-wrap
29645 msgid ""
29646 " set-path searchpath\n"
29647 "\n"
29648 msgstr ""
29649
29650 # type: =head2
29651 #. type: =head2
29652 #: ../fish/guestfish-actions.pod:4024
29653 msgid "set-qemu"
29654 msgstr ""
29655
29656 # type: =head2
29657 #. type: =head2
29658 #: ../fish/guestfish-actions.pod:4026
29659 msgid "qemu"
29660 msgstr ""
29661
29662 # type: verbatim
29663 #. type: verbatim
29664 #: ../fish/guestfish-actions.pod:4028
29665 #, no-wrap
29666 msgid ""
29667 " set-qemu qemu\n"
29668 "\n"
29669 msgstr ""
29670
29671 # type: =head2
29672 #. type: =head2
29673 #: ../fish/guestfish-actions.pod:4048
29674 msgid "set-recovery-proc"
29675 msgstr ""
29676
29677 # type: =head2
29678 #. type: =head2
29679 #: ../fish/guestfish-actions.pod:4050
29680 msgid "recovery-proc"
29681 msgstr ""
29682
29683 # type: verbatim
29684 #. type: verbatim
29685 #: ../fish/guestfish-actions.pod:4052
29686 #, no-wrap
29687 msgid ""
29688 " set-recovery-proc true|false\n"
29689 "\n"
29690 msgstr ""
29691
29692 # type: textblock
29693 #. type: textblock
29694 #: ../fish/guestfish-actions.pod:4054
29695 msgid ""
29696 "If this is called with the parameter C<false> then L</launch> does not "
29697 "create a recovery process.  The purpose of the recovery process is to stop "
29698 "runaway qemu processes in the case where the main program aborts abruptly."
29699 msgstr ""
29700
29701 # type: textblock
29702 #. type: textblock
29703 #: ../fish/guestfish-actions.pod:4059
29704 msgid ""
29705 "This only has any effect if called before L</launch>, and the default is "
29706 "true."
29707 msgstr ""
29708
29709 # type: =head2
29710 #. type: =head2
29711 #: ../fish/guestfish-actions.pod:4068
29712 msgid "set-selinux"
29713 msgstr ""
29714
29715 # type: =head2
29716 #. type: =head2
29717 #: ../fish/guestfish-actions.pod:4070
29718 msgid "selinux"
29719 msgstr ""
29720
29721 # type: verbatim
29722 #. type: verbatim
29723 #: ../fish/guestfish-actions.pod:4072
29724 #, no-wrap
29725 msgid ""
29726 " set-selinux true|false\n"
29727 "\n"
29728 msgstr ""
29729
29730 # type: =head2
29731 #. type: =head2
29732 #: ../fish/guestfish-actions.pod:4083
29733 msgid "set-trace"
29734 msgstr ""
29735
29736 # type: =head2
29737 #. type: =head2
29738 #: ../fish/guestfish-actions.pod:4085
29739 msgid "trace"
29740 msgstr ""
29741
29742 # type: verbatim
29743 #. type: verbatim
29744 #: ../fish/guestfish-actions.pod:4087
29745 #, no-wrap
29746 msgid ""
29747 " set-trace true|false\n"
29748 "\n"
29749 msgstr ""
29750
29751 #. type: textblock
29752 #: ../fish/guestfish-actions.pod:4099
29753 msgid ""
29754 "Trace messages are normally sent to C<stderr>, unless you register a "
29755 "callback to send them somewhere else (see L</set-event-callback>)."
29756 msgstr ""
29757
29758 # type: =head2
29759 #. type: =head2
29760 #: ../fish/guestfish-actions.pod:4103
29761 msgid "set-verbose"
29762 msgstr ""
29763
29764 # type: =head2
29765 #. type: =head2
29766 #: ../fish/guestfish-actions.pod:4105
29767 msgid "verbose"
29768 msgstr ""
29769
29770 # type: verbatim
29771 #. type: verbatim
29772 #: ../fish/guestfish-actions.pod:4107
29773 #, no-wrap
29774 msgid ""
29775 " set-verbose true|false\n"
29776 "\n"
29777 msgstr ""
29778
29779 #. type: textblock
29780 #: ../fish/guestfish-actions.pod:4114
29781 msgid ""
29782 "Verbose messages are normally sent to C<stderr>, unless you register a "
29783 "callback to send them somewhere else (see L</set-event-callback>)."
29784 msgstr ""
29785
29786 # type: =head2
29787 #. type: =head2
29788 #: ../fish/guestfish-actions.pod:4118
29789 msgid "setcon"
29790 msgstr ""
29791
29792 # type: verbatim
29793 #. type: verbatim
29794 #: ../fish/guestfish-actions.pod:4120
29795 #, no-wrap
29796 msgid ""
29797 " setcon context\n"
29798 "\n"
29799 msgstr ""
29800
29801 # type: =head2
29802 #. type: =head2
29803 #: ../fish/guestfish-actions.pod:4127
29804 msgid "setxattr"
29805 msgstr ""
29806
29807 # type: verbatim
29808 #. type: verbatim
29809 #: ../fish/guestfish-actions.pod:4129
29810 #, no-wrap
29811 msgid ""
29812 " setxattr xattr val vallen path\n"
29813 "\n"
29814 msgstr ""
29815
29816 # type: textblock
29817 #. type: textblock
29818 #: ../fish/guestfish-actions.pod:4135
29819 msgid "See also: L</lsetxattr>, L<attr(5)>."
29820 msgstr ""
29821
29822 # type: =head2
29823 #. type: =head2
29824 #: ../fish/guestfish-actions.pod:4137
29825 msgid "sfdisk"
29826 msgstr ""
29827
29828 # type: verbatim
29829 #. type: verbatim
29830 #: ../fish/guestfish-actions.pod:4139
29831 #, no-wrap
29832 msgid ""
29833 " sfdisk device cyls heads sectors 'lines ...'\n"
29834 "\n"
29835 msgstr ""
29836
29837 # type: textblock
29838 #. type: textblock
29839 #: ../fish/guestfish-actions.pod:4161
29840 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
29841 msgstr ""
29842
29843 # type: =head2
29844 #. type: =head2
29845 #: ../fish/guestfish-actions.pod:4167
29846 msgid "sfdiskM"
29847 msgstr ""
29848
29849 # type: verbatim
29850 #. type: verbatim
29851 #: ../fish/guestfish-actions.pod:4169
29852 #, no-wrap
29853 msgid ""
29854 " sfdiskM device 'lines ...'\n"
29855 "\n"
29856 msgstr ""
29857
29858 # type: textblock
29859 #. type: textblock
29860 #: ../fish/guestfish-actions.pod:4171
29861 msgid ""
29862 "This is a simplified interface to the L</sfdisk> command, where partition "
29863 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
29864 "you don't need to specify the cyls, heads and sectors parameters which were "
29865 "rarely if ever used anyway."
29866 msgstr ""
29867
29868 # type: textblock
29869 #. type: textblock
29870 #: ../fish/guestfish-actions.pod:4177
29871 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
29872 msgstr ""
29873
29874 # type: =head2
29875 #. type: =head2
29876 #: ../fish/guestfish-actions.pod:4183
29877 msgid "sfdisk-N"
29878 msgstr ""
29879
29880 # type: verbatim
29881 #. type: verbatim
29882 #: ../fish/guestfish-actions.pod:4185
29883 #, no-wrap
29884 msgid ""
29885 " sfdisk-N device partnum cyls heads sectors line\n"
29886 "\n"
29887 msgstr ""
29888
29889 # type: textblock
29890 #. type: textblock
29891 #: ../fish/guestfish-actions.pod:4190
29892 msgid ""
29893 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
29894 "cyls/heads/sectors parameters."
29895 msgstr ""
29896
29897 # type: textblock
29898 #. type: textblock
29899 #: ../fish/guestfish-actions.pod:4193
29900 msgid "See also: L</part-add>"
29901 msgstr ""
29902
29903 # type: =head2
29904 #. type: =head2
29905 #: ../fish/guestfish-actions.pod:4198
29906 msgid "sfdisk-disk-geometry"
29907 msgstr ""
29908
29909 # type: verbatim
29910 #. type: verbatim
29911 #: ../fish/guestfish-actions.pod:4200
29912 #, no-wrap
29913 msgid ""
29914 " sfdisk-disk-geometry device\n"
29915 "\n"
29916 msgstr ""
29917
29918 # type: textblock
29919 #. type: textblock
29920 #: ../fish/guestfish-actions.pod:4202
29921 msgid ""
29922 "This displays the disk geometry of C<device> read from the partition table.  "
29923 "Especially in the case where the underlying block device has been resized, "
29924 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
29925 "kernel-geometry>)."
29926 msgstr ""
29927
29928 # type: =head2
29929 #. type: =head2
29930 #: ../fish/guestfish-actions.pod:4210
29931 msgid "sfdisk-kernel-geometry"
29932 msgstr ""
29933
29934 # type: verbatim
29935 #. type: verbatim
29936 #: ../fish/guestfish-actions.pod:4212
29937 #, no-wrap
29938 msgid ""
29939 " sfdisk-kernel-geometry device\n"
29940 "\n"
29941 msgstr ""
29942
29943 # type: =head2
29944 #. type: =head2
29945 #: ../fish/guestfish-actions.pod:4219
29946 msgid "sfdisk-l"
29947 msgstr ""
29948
29949 # type: verbatim
29950 #. type: verbatim
29951 #: ../fish/guestfish-actions.pod:4221
29952 #, no-wrap
29953 msgid ""
29954 " sfdisk-l device\n"
29955 "\n"
29956 msgstr ""
29957
29958 # type: textblock
29959 #. type: textblock
29960 #: ../fish/guestfish-actions.pod:4227
29961 msgid "See also: L</part-list>"
29962 msgstr ""
29963
29964 # type: =head2
29965 #. type: =head2
29966 #: ../fish/guestfish-actions.pod:4229
29967 msgid "sh"
29968 msgstr ""
29969
29970 # type: verbatim
29971 #. type: verbatim
29972 #: ../fish/guestfish-actions.pod:4231
29973 #, no-wrap
29974 msgid ""
29975 " sh command\n"
29976 "\n"
29977 msgstr ""
29978
29979 # type: textblock
29980 #. type: textblock
29981 #: ../fish/guestfish-actions.pod:4236
29982 msgid "This is like L</command>, but passes the command to:"
29983 msgstr ""
29984
29985 # type: textblock
29986 #. type: textblock
29987 #: ../fish/guestfish-actions.pod:4244
29988 msgid "All the provisos about L</command> apply to this call."
29989 msgstr ""
29990
29991 # type: =head2
29992 #. type: =head2
29993 #: ../fish/guestfish-actions.pod:4246
29994 msgid "sh-lines"
29995 msgstr ""
29996
29997 # type: verbatim
29998 #. type: verbatim
29999 #: ../fish/guestfish-actions.pod:4248
30000 #, no-wrap
30001 msgid ""
30002 " sh-lines command\n"
30003 "\n"
30004 msgstr ""
30005
30006 # type: textblock
30007 #. type: textblock
30008 #: ../fish/guestfish-actions.pod:4250
30009 msgid "This is the same as L</sh>, but splits the result into a list of lines."
30010 msgstr ""
30011
30012 # type: textblock
30013 #. type: textblock
30014 #: ../fish/guestfish-actions.pod:4253
30015 msgid "See also: L</command-lines>"
30016 msgstr ""
30017
30018 # type: =head2
30019 #. type: =head2
30020 #: ../fish/guestfish-actions.pod:4255
30021 msgid "sleep"
30022 msgstr ""
30023
30024 # type: verbatim
30025 #. type: verbatim
30026 #: ../fish/guestfish-actions.pod:4257
30027 #, no-wrap
30028 msgid ""
30029 " sleep secs\n"
30030 "\n"
30031 msgstr ""
30032
30033 # type: =head2
30034 #. type: =head2
30035 #: ../fish/guestfish-actions.pod:4261
30036 msgid "stat"
30037 msgstr ""
30038
30039 # type: verbatim
30040 #. type: verbatim
30041 #: ../fish/guestfish-actions.pod:4263
30042 #, no-wrap
30043 msgid ""
30044 " stat path\n"
30045 "\n"
30046 msgstr ""
30047
30048 # type: =head2
30049 #. type: =head2
30050 #: ../fish/guestfish-actions.pod:4269
30051 msgid "statvfs"
30052 msgstr ""
30053
30054 # type: verbatim
30055 #. type: verbatim
30056 #: ../fish/guestfish-actions.pod:4271
30057 #, no-wrap
30058 msgid ""
30059 " statvfs path\n"
30060 "\n"
30061 msgstr ""
30062
30063 # type: =head2
30064 #. type: =head2
30065 #: ../fish/guestfish-actions.pod:4279
30066 msgid "strings"
30067 msgstr ""
30068
30069 # type: verbatim
30070 #. type: verbatim
30071 #: ../fish/guestfish-actions.pod:4281
30072 #, no-wrap
30073 msgid ""
30074 " strings path\n"
30075 "\n"
30076 msgstr ""
30077
30078 # type: =head2
30079 #. type: =head2
30080 #: ../fish/guestfish-actions.pod:4289
30081 msgid "strings-e"
30082 msgstr ""
30083
30084 # type: verbatim
30085 #. type: verbatim
30086 #: ../fish/guestfish-actions.pod:4291
30087 #, no-wrap
30088 msgid ""
30089 " strings-e encoding path\n"
30090 "\n"
30091 msgstr ""
30092
30093 # type: textblock
30094 #. type: textblock
30095 #: ../fish/guestfish-actions.pod:4293
30096 msgid ""
30097 "This is like the L</strings> command, but allows you to specify the encoding "
30098 "of strings that are looked for in the source file C<path>."
30099 msgstr ""
30100
30101 # type: textblock
30102 #. type: textblock
30103 #: ../fish/guestfish-actions.pod:4303
30104 msgid ""
30105 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
30106 "ISO-8859-X (this is what L</strings> uses)."
30107 msgstr ""
30108
30109 # type: =head2
30110 #. type: =head2
30111 #: ../fish/guestfish-actions.pod:4335
30112 msgid "swapoff-device"
30113 msgstr ""
30114
30115 # type: verbatim
30116 #. type: verbatim
30117 #: ../fish/guestfish-actions.pod:4337
30118 #, no-wrap
30119 msgid ""
30120 " swapoff-device device\n"
30121 "\n"
30122 msgstr ""
30123
30124 # type: textblock
30125 #. type: textblock
30126 #: ../fish/guestfish-actions.pod:4339
30127 msgid ""
30128 "This command disables the libguestfs appliance swap device or partition "
30129 "named C<device>.  See L</swapon-device>."
30130 msgstr ""
30131
30132 # type: =head2
30133 #. type: =head2
30134 #: ../fish/guestfish-actions.pod:4343
30135 msgid "swapoff-file"
30136 msgstr ""
30137
30138 # type: verbatim
30139 #. type: verbatim
30140 #: ../fish/guestfish-actions.pod:4345
30141 #, no-wrap
30142 msgid ""
30143 " swapoff-file file\n"
30144 "\n"
30145 msgstr ""
30146
30147 # type: =head2
30148 #. type: =head2
30149 #: ../fish/guestfish-actions.pod:4349
30150 msgid "swapoff-label"
30151 msgstr ""
30152
30153 # type: verbatim
30154 #. type: verbatim
30155 #: ../fish/guestfish-actions.pod:4351
30156 #, no-wrap
30157 msgid ""
30158 " swapoff-label label\n"
30159 "\n"
30160 msgstr ""
30161
30162 # type: =head2
30163 #. type: =head2
30164 #: ../fish/guestfish-actions.pod:4356
30165 msgid "swapoff-uuid"
30166 msgstr ""
30167
30168 # type: verbatim
30169 #. type: verbatim
30170 #: ../fish/guestfish-actions.pod:4358
30171 #, no-wrap
30172 msgid ""
30173 " swapoff-uuid uuid\n"
30174 "\n"
30175 msgstr ""
30176
30177 # type: =head2
30178 #. type: =head2
30179 #: ../fish/guestfish-actions.pod:4363
30180 msgid "swapon-device"
30181 msgstr ""
30182
30183 # type: verbatim
30184 #. type: verbatim
30185 #: ../fish/guestfish-actions.pod:4365
30186 #, no-wrap
30187 msgid ""
30188 " swapon-device device\n"
30189 "\n"
30190 msgstr ""
30191
30192 # type: textblock
30193 #. type: textblock
30194 #: ../fish/guestfish-actions.pod:4367
30195 msgid ""
30196 "This command enables the libguestfs appliance to use the swap device or "
30197 "partition named C<device>.  The increased memory is made available for all "
30198 "commands, for example those run using L</command> or L</sh>."
30199 msgstr ""
30200
30201 # type: =head2
30202 #. type: =head2
30203 #: ../fish/guestfish-actions.pod:4379
30204 msgid "swapon-file"
30205 msgstr ""
30206
30207 # type: verbatim
30208 #. type: verbatim
30209 #: ../fish/guestfish-actions.pod:4381
30210 #, no-wrap
30211 msgid ""
30212 " swapon-file file\n"
30213 "\n"
30214 msgstr ""
30215
30216 # type: textblock
30217 #. type: textblock
30218 #: ../fish/guestfish-actions.pod:4383
30219 msgid ""
30220 "This command enables swap to a file.  See L</swapon-device> for other notes."
30221 msgstr ""
30222
30223 # type: =head2
30224 #. type: =head2
30225 #: ../fish/guestfish-actions.pod:4386
30226 msgid "swapon-label"
30227 msgstr ""
30228
30229 # type: verbatim
30230 #. type: verbatim
30231 #: ../fish/guestfish-actions.pod:4388
30232 #, no-wrap
30233 msgid ""
30234 " swapon-label label\n"
30235 "\n"
30236 msgstr ""
30237
30238 # type: textblock
30239 #. type: textblock
30240 #: ../fish/guestfish-actions.pod:4390
30241 msgid ""
30242 "This command enables swap to a labeled swap partition.  See L</swapon-"
30243 "device> for other notes."
30244 msgstr ""
30245
30246 # type: =head2
30247 #. type: =head2
30248 #: ../fish/guestfish-actions.pod:4393
30249 msgid "swapon-uuid"
30250 msgstr ""
30251
30252 # type: verbatim
30253 #. type: verbatim
30254 #: ../fish/guestfish-actions.pod:4395
30255 #, no-wrap
30256 msgid ""
30257 " swapon-uuid uuid\n"
30258 "\n"
30259 msgstr ""
30260
30261 # type: textblock
30262 #. type: textblock
30263 #: ../fish/guestfish-actions.pod:4397
30264 msgid ""
30265 "This command enables swap to a swap partition with the given UUID.  See L</"
30266 "swapon-device> for other notes."
30267 msgstr ""
30268
30269 # type: =head2
30270 #. type: =head2
30271 #: ../fish/guestfish-actions.pod:4400
30272 msgid "sync"
30273 msgstr ""
30274
30275 # type: verbatim
30276 #. type: verbatim
30277 #: ../fish/guestfish-actions.pod:4402
30278 #, no-wrap
30279 msgid ""
30280 " sync\n"
30281 "\n"
30282 msgstr ""
30283
30284 # type: =head2
30285 #. type: =head2
30286 #: ../fish/guestfish-actions.pod:4410
30287 msgid "tail"
30288 msgstr ""
30289
30290 # type: verbatim
30291 #. type: verbatim
30292 #: ../fish/guestfish-actions.pod:4412
30293 #, no-wrap
30294 msgid ""
30295 " tail path\n"
30296 "\n"
30297 msgstr ""
30298
30299 # type: =head2
30300 #. type: =head2
30301 #: ../fish/guestfish-actions.pod:4420
30302 msgid "tail-n"
30303 msgstr ""
30304
30305 # type: verbatim
30306 #. type: verbatim
30307 #: ../fish/guestfish-actions.pod:4422
30308 #, no-wrap
30309 msgid ""
30310 " tail-n nrlines path\n"
30311 "\n"
30312 msgstr ""
30313
30314 # type: =head2
30315 #. type: =head2
30316 #: ../fish/guestfish-actions.pod:4435
30317 msgid "tar-in"
30318 msgstr ""
30319
30320 # type: verbatim
30321 #. type: verbatim
30322 #: ../fish/guestfish-actions.pod:4437
30323 #, no-wrap
30324 msgid ""
30325 " tar-in (tarfile|-) directory\n"
30326 "\n"
30327 msgstr ""
30328
30329 # type: textblock
30330 #. type: textblock
30331 #: ../fish/guestfish-actions.pod:4442
30332 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
30333 msgstr ""
30334
30335 # type: =head2
30336 #. type: =head2
30337 #: ../fish/guestfish-actions.pod:4447
30338 msgid "tar-out"
30339 msgstr ""
30340
30341 # type: verbatim
30342 #. type: verbatim
30343 #: ../fish/guestfish-actions.pod:4449
30344 #, no-wrap
30345 msgid ""
30346 " tar-out directory (tarfile|-)\n"
30347 "\n"
30348 msgstr ""
30349
30350 # type: textblock
30351 #. type: textblock
30352 #: ../fish/guestfish-actions.pod:4454
30353 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
30354 msgstr ""
30355
30356 # type: =head2
30357 #. type: =head2
30358 #: ../fish/guestfish-actions.pod:4459
30359 msgid "tgz-in"
30360 msgstr ""
30361
30362 # type: verbatim
30363 #. type: verbatim
30364 #: ../fish/guestfish-actions.pod:4461
30365 #, no-wrap
30366 msgid ""
30367 " tgz-in (tarball|-) directory\n"
30368 "\n"
30369 msgstr ""
30370
30371 # type: textblock
30372 #. type: textblock
30373 #: ../fish/guestfish-actions.pod:4466
30374 msgid "To upload an uncompressed tarball, use L</tar-in>."
30375 msgstr ""
30376
30377 # type: =head2
30378 #. type: =head2
30379 #: ../fish/guestfish-actions.pod:4470
30380 msgid "tgz-out"
30381 msgstr ""
30382
30383 # type: verbatim
30384 #. type: verbatim
30385 #: ../fish/guestfish-actions.pod:4472
30386 #, no-wrap
30387 msgid ""
30388 " tgz-out directory (tarball|-)\n"
30389 "\n"
30390 msgstr ""
30391
30392 # type: textblock
30393 #. type: textblock
30394 #: ../fish/guestfish-actions.pod:4477
30395 msgid "To download an uncompressed tarball, use L</tar-out>."
30396 msgstr ""
30397
30398 # type: =head2
30399 #. type: =head2
30400 #: ../fish/guestfish-actions.pod:4481
30401 msgid "touch"
30402 msgstr ""
30403
30404 # type: verbatim
30405 #. type: verbatim
30406 #: ../fish/guestfish-actions.pod:4483
30407 #, no-wrap
30408 msgid ""
30409 " touch path\n"
30410 "\n"
30411 msgstr ""
30412
30413 # type: =head2
30414 #. type: =head2
30415 #: ../fish/guestfish-actions.pod:4492
30416 msgid "truncate"
30417 msgstr ""
30418
30419 # type: verbatim
30420 #. type: verbatim
30421 #: ../fish/guestfish-actions.pod:4494
30422 #, no-wrap
30423 msgid ""
30424 " truncate path\n"
30425 "\n"
30426 msgstr ""
30427
30428 # type: =head2
30429 #. type: =head2
30430 #: ../fish/guestfish-actions.pod:4499
30431 msgid "truncate-size"
30432 msgstr ""
30433
30434 # type: verbatim
30435 #. type: verbatim
30436 #: ../fish/guestfish-actions.pod:4501
30437 #, no-wrap
30438 msgid ""
30439 " truncate-size path size\n"
30440 "\n"
30441 msgstr ""
30442
30443 # type: textblock
30444 #. type: textblock
30445 #: ../fish/guestfish-actions.pod:4506
30446 msgid ""
30447 "If the current file size is less than C<size> then the file is extended to "
30448 "the required size with zero bytes.  This creates a sparse file (ie. disk "
30449 "blocks are not allocated for the file until you write to it).  To create a "
30450 "non-sparse file of zeroes, use L</fallocate64> instead."
30451 msgstr ""
30452
30453 # type: =head2
30454 #. type: =head2
30455 #: ../fish/guestfish-actions.pod:4512
30456 msgid "tune2fs-l"
30457 msgstr ""
30458
30459 # type: verbatim
30460 #. type: verbatim
30461 #: ../fish/guestfish-actions.pod:4514
30462 #, no-wrap
30463 msgid ""
30464 " tune2fs-l device\n"
30465 "\n"
30466 msgstr ""
30467
30468 # type: =head2
30469 #. type: =head2
30470 #: ../fish/guestfish-actions.pod:4524
30471 msgid "txz-in"
30472 msgstr ""
30473
30474 # type: verbatim
30475 #. type: verbatim
30476 #: ../fish/guestfish-actions.pod:4526
30477 #, no-wrap
30478 msgid ""
30479 " txz-in (tarball|-) directory\n"
30480 "\n"
30481 msgstr ""
30482
30483 # type: =head2
30484 #. type: =head2
30485 #: ../fish/guestfish-actions.pod:4533
30486 msgid "txz-out"
30487 msgstr ""
30488
30489 # type: verbatim
30490 #. type: verbatim
30491 #: ../fish/guestfish-actions.pod:4535
30492 #, no-wrap
30493 msgid ""
30494 " txz-out directory (tarball|-)\n"
30495 "\n"
30496 msgstr ""
30497
30498 # type: =head2
30499 #. type: =head2
30500 #: ../fish/guestfish-actions.pod:4542
30501 msgid "umask"
30502 msgstr ""
30503
30504 # type: verbatim
30505 #. type: verbatim
30506 #: ../fish/guestfish-actions.pod:4544
30507 #, no-wrap
30508 msgid ""
30509 " umask mask\n"
30510 "\n"
30511 msgstr ""
30512
30513 # type: textblock
30514 #. type: textblock
30515 #: ../fish/guestfish-actions.pod:4558
30516 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
30517 msgstr ""
30518
30519 # type: =head2
30520 #. type: =head2
30521 #: ../fish/guestfish-actions.pod:4563
30522 msgid "umount"
30523 msgstr ""
30524
30525 # type: =head2
30526 #. type: =head2
30527 #: ../fish/guestfish-actions.pod:4565
30528 msgid "unmount"
30529 msgstr ""
30530
30531 # type: verbatim
30532 #. type: verbatim
30533 #: ../fish/guestfish-actions.pod:4567
30534 #, no-wrap
30535 msgid ""
30536 " umount pathordevice\n"
30537 "\n"
30538 msgstr ""
30539
30540 # type: =head2
30541 #. type: =head2
30542 #: ../fish/guestfish-actions.pod:4573
30543 msgid "umount-all"
30544 msgstr ""
30545
30546 # type: =head2
30547 #. type: =head2
30548 #: ../fish/guestfish-actions.pod:4575
30549 msgid "unmount-all"
30550 msgstr ""
30551
30552 # type: verbatim
30553 #. type: verbatim
30554 #: ../fish/guestfish-actions.pod:4577
30555 #, no-wrap
30556 msgid ""
30557 " umount-all\n"
30558 "\n"
30559 msgstr ""
30560
30561 # type: =head2
30562 #. type: =head2
30563 #: ../fish/guestfish-actions.pod:4583
30564 msgid "upload"
30565 msgstr ""
30566
30567 # type: verbatim
30568 #. type: verbatim
30569 #: ../fish/guestfish-actions.pod:4585
30570 #, no-wrap
30571 msgid ""
30572 " upload (filename|-) remotefilename\n"
30573 "\n"
30574 msgstr ""
30575
30576 # type: textblock
30577 #. type: textblock
30578 #: ../fish/guestfish-actions.pod:4592
30579 msgid "See also L</download>."
30580 msgstr ""
30581
30582 # type: =head2
30583 #. type: =head2
30584 #: ../fish/guestfish-actions.pod:4596
30585 msgid "upload-offset"
30586 msgstr ""
30587
30588 # type: verbatim
30589 #. type: verbatim
30590 #: ../fish/guestfish-actions.pod:4598
30591 #, no-wrap
30592 msgid ""
30593 " upload-offset (filename|-) remotefilename offset\n"
30594 "\n"
30595 msgstr ""
30596
30597 # type: textblock
30598 #. type: textblock
30599 #: ../fish/guestfish-actions.pod:4610
30600 msgid ""
30601 "Note that there is no limit on the amount of data that can be uploaded with "
30602 "this call, unlike with L</pwrite>, and this call always writes the full "
30603 "amount unless an error occurs."
30604 msgstr ""
30605
30606 # type: textblock
30607 #. type: textblock
30608 #: ../fish/guestfish-actions.pod:4615
30609 msgid "See also L</upload>, L</pwrite>."
30610 msgstr ""
30611
30612 # type: =head2
30613 #. type: =head2
30614 #: ../fish/guestfish-actions.pod:4619
30615 msgid "utimens"
30616 msgstr ""
30617
30618 # type: verbatim
30619 #. type: verbatim
30620 #: ../fish/guestfish-actions.pod:4621
30621 #, no-wrap
30622 msgid ""
30623 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
30624 "\n"
30625 msgstr ""
30626
30627 # type: =head2
30628 #. type: =head2
30629 #: ../fish/guestfish-actions.pod:4640
30630 msgid "version"
30631 msgstr ""
30632
30633 # type: verbatim
30634 #. type: verbatim
30635 #: ../fish/guestfish-actions.pod:4642
30636 #, no-wrap
30637 msgid ""
30638 " version\n"
30639 "\n"
30640 msgstr ""
30641
30642 # type: textblock
30643 #. type: textblock
30644 #: ../fish/guestfish-actions.pod:4669
30645 msgid ""
30646 "I<Note:> Don't use this call to test for availability of features.  In "
30647 "enterprise distributions we backport features from later versions into "
30648 "earlier versions, making this an unreliable way to test for features.  Use "
30649 "L</available> instead."
30650 msgstr ""
30651
30652 # type: =head2
30653 #. type: =head2
30654 #: ../fish/guestfish-actions.pod:4675
30655 msgid "vfs-label"
30656 msgstr ""
30657
30658 # type: verbatim
30659 #. type: verbatim
30660 #: ../fish/guestfish-actions.pod:4677
30661 #, no-wrap
30662 msgid ""
30663 " vfs-label device\n"
30664 "\n"
30665 msgstr ""
30666
30667 # type: textblock
30668 #. type: textblock
30669 #: ../fish/guestfish-actions.pod:4684
30670 msgid "To find a filesystem from the label, use L</findfs-label>."
30671 msgstr ""
30672
30673 # type: =head2
30674 #. type: =head2
30675 #: ../fish/guestfish-actions.pod:4686
30676 msgid "vfs-type"
30677 msgstr ""
30678
30679 # type: verbatim
30680 #. type: verbatim
30681 #: ../fish/guestfish-actions.pod:4688
30682 #, no-wrap
30683 msgid ""
30684 " vfs-type device\n"
30685 "\n"
30686 msgstr ""
30687
30688 # type: =head2
30689 #. type: =head2
30690 #: ../fish/guestfish-actions.pod:4698
30691 msgid "vfs-uuid"
30692 msgstr ""
30693
30694 # type: verbatim
30695 #. type: verbatim
30696 #: ../fish/guestfish-actions.pod:4700
30697 #, no-wrap
30698 msgid ""
30699 " vfs-uuid device\n"
30700 "\n"
30701 msgstr ""
30702
30703 # type: textblock
30704 #. type: textblock
30705 #: ../fish/guestfish-actions.pod:4707
30706 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
30707 msgstr ""
30708
30709 # type: =head2
30710 #. type: =head2
30711 #: ../fish/guestfish-actions.pod:4709
30712 msgid "vg-activate"
30713 msgstr ""
30714
30715 # type: verbatim
30716 #. type: verbatim
30717 #: ../fish/guestfish-actions.pod:4711
30718 #, no-wrap
30719 msgid ""
30720 " vg-activate true|false 'volgroups ...'\n"
30721 "\n"
30722 msgstr ""
30723
30724 # type: =head2
30725 #. type: =head2
30726 #: ../fish/guestfish-actions.pod:4724
30727 msgid "vg-activate-all"
30728 msgstr ""
30729
30730 # type: verbatim
30731 #. type: verbatim
30732 #: ../fish/guestfish-actions.pod:4726
30733 #, no-wrap
30734 msgid ""
30735 " vg-activate-all true|false\n"
30736 "\n"
30737 msgstr ""
30738
30739 # type: =head2
30740 #. type: =head2
30741 #: ../fish/guestfish-actions.pod:4736
30742 msgid "vgcreate"
30743 msgstr ""
30744
30745 # type: verbatim
30746 #. type: verbatim
30747 #: ../fish/guestfish-actions.pod:4738
30748 #, no-wrap
30749 msgid ""
30750 " vgcreate volgroup 'physvols ...'\n"
30751 "\n"
30752 msgstr ""
30753
30754 # type: =head2
30755 #. type: =head2
30756 #: ../fish/guestfish-actions.pod:4743
30757 msgid "vglvuuids"
30758 msgstr ""
30759
30760 # type: verbatim
30761 #. type: verbatim
30762 #: ../fish/guestfish-actions.pod:4745
30763 #, no-wrap
30764 msgid ""
30765 " vglvuuids vgname\n"
30766 "\n"
30767 msgstr ""
30768
30769 # type: textblock
30770 #. type: textblock
30771 #: ../fish/guestfish-actions.pod:4750
30772 msgid ""
30773 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
30774 "logical volumes and volume groups."
30775 msgstr ""
30776
30777 # type: textblock
30778 #. type: textblock
30779 #: ../fish/guestfish-actions.pod:4753
30780 msgid "See also L</vgpvuuids>."
30781 msgstr ""
30782
30783 # type: =head2
30784 #. type: =head2
30785 #: ../fish/guestfish-actions.pod:4755
30786 msgid "vgpvuuids"
30787 msgstr ""
30788
30789 # type: verbatim
30790 #. type: verbatim
30791 #: ../fish/guestfish-actions.pod:4757
30792 #, no-wrap
30793 msgid ""
30794 " vgpvuuids vgname\n"
30795 "\n"
30796 msgstr ""
30797
30798 # type: textblock
30799 #. type: textblock
30800 #: ../fish/guestfish-actions.pod:4762
30801 msgid ""
30802 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
30803 "physical volumes and volume groups."
30804 msgstr ""
30805
30806 # type: textblock
30807 #. type: textblock
30808 #: ../fish/guestfish-actions.pod:4765
30809 msgid "See also L</vglvuuids>."
30810 msgstr ""
30811
30812 # type: =head2
30813 #. type: =head2
30814 #: ../fish/guestfish-actions.pod:4767
30815 msgid "vgremove"
30816 msgstr ""
30817
30818 # type: verbatim
30819 #. type: verbatim
30820 #: ../fish/guestfish-actions.pod:4769
30821 #, no-wrap
30822 msgid ""
30823 " vgremove vgname\n"
30824 "\n"
30825 msgstr ""
30826
30827 # type: =head2
30828 #. type: =head2
30829 #: ../fish/guestfish-actions.pod:4776
30830 msgid "vgrename"
30831 msgstr ""
30832
30833 # type: verbatim
30834 #. type: verbatim
30835 #: ../fish/guestfish-actions.pod:4778
30836 #, no-wrap
30837 msgid ""
30838 " vgrename volgroup newvolgroup\n"
30839 "\n"
30840 msgstr ""
30841
30842 # type: =head2
30843 #. type: =head2
30844 #: ../fish/guestfish-actions.pod:4782
30845 msgid "vgs"
30846 msgstr ""
30847
30848 # type: verbatim
30849 #. type: verbatim
30850 #: ../fish/guestfish-actions.pod:4784
30851 #, no-wrap
30852 msgid ""
30853 " vgs\n"
30854 "\n"
30855 msgstr ""
30856
30857 # type: textblock
30858 #. type: textblock
30859 #: ../fish/guestfish-actions.pod:4792
30860 msgid "See also L</vgs-full>."
30861 msgstr ""
30862
30863 # type: =head2
30864 #. type: =head2
30865 #: ../fish/guestfish-actions.pod:4794
30866 msgid "vgs-full"
30867 msgstr ""
30868
30869 # type: verbatim
30870 #. type: verbatim
30871 #: ../fish/guestfish-actions.pod:4796
30872 #, no-wrap
30873 msgid ""
30874 " vgs-full\n"
30875 "\n"
30876 msgstr ""
30877
30878 # type: =head2
30879 #. type: =head2
30880 #: ../fish/guestfish-actions.pod:4801
30881 msgid "vgscan"
30882 msgstr ""
30883
30884 # type: verbatim
30885 #. type: verbatim
30886 #: ../fish/guestfish-actions.pod:4803
30887 #, no-wrap
30888 msgid ""
30889 " vgscan\n"
30890 "\n"
30891 msgstr ""
30892
30893 # type: =head2
30894 #. type: =head2
30895 #: ../fish/guestfish-actions.pod:4808
30896 msgid "vguuid"
30897 msgstr ""
30898
30899 # type: verbatim
30900 #. type: verbatim
30901 #: ../fish/guestfish-actions.pod:4810
30902 #, no-wrap
30903 msgid ""
30904 " vguuid vgname\n"
30905 "\n"
30906 msgstr ""
30907
30908 # type: =head2
30909 #. type: =head2
30910 #: ../fish/guestfish-actions.pod:4814
30911 msgid "wc-c"
30912 msgstr ""
30913
30914 # type: verbatim
30915 #. type: verbatim
30916 #: ../fish/guestfish-actions.pod:4816
30917 #, no-wrap
30918 msgid ""
30919 " wc-c path\n"
30920 "\n"
30921 msgstr ""
30922
30923 # type: =head2
30924 #. type: =head2
30925 #: ../fish/guestfish-actions.pod:4821
30926 msgid "wc-l"
30927 msgstr ""
30928
30929 # type: verbatim
30930 #. type: verbatim
30931 #: ../fish/guestfish-actions.pod:4823
30932 #, no-wrap
30933 msgid ""
30934 " wc-l path\n"
30935 "\n"
30936 msgstr ""
30937
30938 # type: =head2
30939 #. type: =head2
30940 #: ../fish/guestfish-actions.pod:4828
30941 msgid "wc-w"
30942 msgstr ""
30943
30944 # type: verbatim
30945 #. type: verbatim
30946 #: ../fish/guestfish-actions.pod:4830
30947 #, no-wrap
30948 msgid ""
30949 " wc-w path\n"
30950 "\n"
30951 msgstr ""
30952
30953 # type: =head2
30954 #. type: =head2
30955 #: ../fish/guestfish-actions.pod:4835
30956 msgid "write"
30957 msgstr ""
30958
30959 # type: verbatim
30960 #. type: verbatim
30961 #: ../fish/guestfish-actions.pod:4837
30962 #, no-wrap
30963 msgid ""
30964 " write path content\n"
30965 "\n"
30966 msgstr ""
30967
30968 # type: =head2
30969 #. type: =head2
30970 #: ../fish/guestfish-actions.pod:4845
30971 msgid "write-file"
30972 msgstr ""
30973
30974 # type: verbatim
30975 #. type: verbatim
30976 #: ../fish/guestfish-actions.pod:4847
30977 #, no-wrap
30978 msgid ""
30979 " write-file path content size\n"
30980 "\n"
30981 msgstr ""
30982
30983 # type: =head2
30984 #. type: =head2
30985 #: ../fish/guestfish-actions.pod:4870
30986 msgid "zegrep"
30987 msgstr ""
30988
30989 # type: verbatim
30990 #. type: verbatim
30991 #: ../fish/guestfish-actions.pod:4872
30992 #, no-wrap
30993 msgid ""
30994 " zegrep regex path\n"
30995 "\n"
30996 msgstr ""
30997
30998 # type: =head2
30999 #. type: =head2
31000 #: ../fish/guestfish-actions.pod:4880
31001 msgid "zegrepi"
31002 msgstr ""
31003
31004 # type: verbatim
31005 #. type: verbatim
31006 #: ../fish/guestfish-actions.pod:4882
31007 #, no-wrap
31008 msgid ""
31009 " zegrepi regex path\n"
31010 "\n"
31011 msgstr ""
31012
31013 # type: =head2
31014 #. type: =head2
31015 #: ../fish/guestfish-actions.pod:4890
31016 msgid "zero"
31017 msgstr ""
31018
31019 # type: verbatim
31020 #. type: verbatim
31021 #: ../fish/guestfish-actions.pod:4892
31022 #, no-wrap
31023 msgid ""
31024 " zero device\n"
31025 "\n"
31026 msgstr ""
31027
31028 # type: textblock
31029 #. type: textblock
31030 #: ../fish/guestfish-actions.pod:4900
31031 msgid "See also: L</zero-device>, L</scrub-device>."
31032 msgstr ""
31033
31034 # type: =head2
31035 #. type: =head2
31036 #: ../fish/guestfish-actions.pod:4902
31037 msgid "zero-device"
31038 msgstr ""
31039
31040 # type: verbatim
31041 #. type: verbatim
31042 #: ../fish/guestfish-actions.pod:4904
31043 #, no-wrap
31044 msgid ""
31045 " zero-device device\n"
31046 "\n"
31047 msgstr ""
31048
31049 # type: textblock
31050 #. type: textblock
31051 #: ../fish/guestfish-actions.pod:4906
31052 msgid ""
31053 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
31054 "which just zeroes the first few blocks of a device."
31055 msgstr ""
31056
31057 # type: =head2
31058 #. type: =head2
31059 #: ../fish/guestfish-actions.pod:4913
31060 msgid "zerofree"
31061 msgstr ""
31062
31063 # type: verbatim
31064 #. type: verbatim
31065 #: ../fish/guestfish-actions.pod:4915
31066 #, no-wrap
31067 msgid ""
31068 " zerofree device\n"
31069 "\n"
31070 msgstr ""
31071
31072 # type: =head2
31073 #. type: =head2
31074 #: ../fish/guestfish-actions.pod:4928
31075 msgid "zfgrep"
31076 msgstr ""
31077
31078 # type: verbatim
31079 #. type: verbatim
31080 #: ../fish/guestfish-actions.pod:4930
31081 #, no-wrap
31082 msgid ""
31083 " zfgrep pattern path\n"
31084 "\n"
31085 msgstr ""
31086
31087 # type: =head2
31088 #. type: =head2
31089 #: ../fish/guestfish-actions.pod:4938
31090 msgid "zfgrepi"
31091 msgstr ""
31092
31093 # type: verbatim
31094 #. type: verbatim
31095 #: ../fish/guestfish-actions.pod:4940
31096 #, no-wrap
31097 msgid ""
31098 " zfgrepi pattern path\n"
31099 "\n"
31100 msgstr ""
31101
31102 # type: =head2
31103 #. type: =head2
31104 #: ../fish/guestfish-actions.pod:4948
31105 msgid "zfile"
31106 msgstr ""
31107
31108 # type: verbatim
31109 #. type: verbatim
31110 #: ../fish/guestfish-actions.pod:4950
31111 #, no-wrap
31112 msgid ""
31113 " zfile meth path\n"
31114 "\n"
31115 msgstr ""
31116
31117 # type: textblock
31118 #. type: textblock
31119 #: ../fish/guestfish-actions.pod:4957
31120 msgid ""
31121 "Since 1.0.63, use L</file> instead which can now process compressed files."
31122 msgstr ""
31123
31124 # type: =head2
31125 #. type: =head2
31126 #: ../fish/guestfish-actions.pod:4967
31127 msgid "zgrep"
31128 msgstr ""
31129
31130 # type: verbatim
31131 #. type: verbatim
31132 #: ../fish/guestfish-actions.pod:4969
31133 #, no-wrap
31134 msgid ""
31135 " zgrep regex path\n"
31136 "\n"
31137 msgstr ""
31138
31139 # type: =head2
31140 #. type: =head2
31141 #: ../fish/guestfish-actions.pod:4977
31142 msgid "zgrepi"
31143 msgstr ""
31144
31145 # type: verbatim
31146 #. type: verbatim
31147 #: ../fish/guestfish-actions.pod:4979
31148 #, no-wrap
31149 msgid ""
31150 " zgrepi regex path\n"
31151 "\n"
31152 msgstr ""
31153
31154 # type: =head2
31155 #. type: =head2
31156 #: ../fish/guestfish-commands.pod:1
31157 msgid "alloc"
31158 msgstr ""
31159
31160 # type: =head2
31161 #. type: =head2
31162 #: ../fish/guestfish-commands.pod:3
31163 msgid "allocate"
31164 msgstr ""
31165
31166 # type: verbatim
31167 #. type: verbatim
31168 #: ../fish/guestfish-commands.pod:5
31169 #, no-wrap
31170 msgid ""
31171 " alloc filename size\n"
31172 "\n"
31173 msgstr ""
31174
31175 # type: textblock
31176 #. type: textblock
31177 #: ../fish/guestfish-commands.pod:7
31178 msgid ""
31179 "This creates an empty (zeroed) file of the given size, and then adds so it "
31180 "can be further examined."
31181 msgstr ""
31182
31183 # type: textblock
31184 #. type: textblock
31185 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
31186 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
31187 msgstr ""
31188
31189 # type: textblock
31190 #. type: textblock
31191 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
31192 msgid "Size can be specified using standard suffixes, eg. C<1M>."
31193 msgstr ""
31194
31195 # type: textblock
31196 #. type: textblock
31197 #: ../fish/guestfish-commands.pod:14
31198 msgid ""
31199 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
31200 "image, see L</PREPARED DISK IMAGES>."
31201 msgstr ""
31202
31203 # type: =head2
31204 #. type: =head2
31205 #: ../fish/guestfish-commands.pod:17
31206 msgid "copy-in"
31207 msgstr ""
31208
31209 # type: verbatim
31210 #. type: verbatim
31211 #: ../fish/guestfish-commands.pod:19
31212 #, no-wrap
31213 msgid ""
31214 " copy-in local [local ...] /remotedir\n"
31215 "\n"
31216 msgstr ""
31217
31218 # type: textblock
31219 #. type: textblock
31220 #: ../fish/guestfish-commands.pod:21
31221 msgid ""
31222 "C<copy-in> copies local files or directories recursively into the disk "
31223 "image, placing them in the directory called C</remotedir> (which must "
31224 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
31225 "other commands as necessary."
31226 msgstr ""
31227
31228 # type: textblock
31229 #. type: textblock
31230 #: ../fish/guestfish-commands.pod:26
31231 msgid ""
31232 "Multiple local files and directories can be specified, but the last "
31233 "parameter must always be a remote directory.  Wildcards cannot be used."
31234 msgstr ""
31235
31236 # type: =head2
31237 #. type: =head2
31238 #: ../fish/guestfish-commands.pod:30
31239 msgid "copy-out"
31240 msgstr ""
31241
31242 # type: verbatim
31243 #. type: verbatim
31244 #: ../fish/guestfish-commands.pod:32
31245 #, no-wrap
31246 msgid ""
31247 " copy-out remote [remote ...] localdir\n"
31248 "\n"
31249 msgstr ""
31250
31251 # type: textblock
31252 #. type: textblock
31253 #: ../fish/guestfish-commands.pod:34
31254 msgid ""
31255 "C<copy-out> copies remote files or directories recursively out of the disk "
31256 "image, placing them on the host disk in a local directory called C<localdir> "
31257 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
31258 "download>, L</tar-out> and other commands as necessary."
31259 msgstr ""
31260
31261 # type: textblock
31262 #. type: textblock
31263 #: ../fish/guestfish-commands.pod:40
31264 msgid ""
31265 "Multiple remote files and directories can be specified, but the last "
31266 "parameter must always be a local directory.  To download to the current "
31267 "directory, use C<.> as in:"
31268 msgstr ""
31269
31270 # type: verbatim
31271 #. type: verbatim
31272 #: ../fish/guestfish-commands.pod:44
31273 #, no-wrap
31274 msgid ""
31275 " copy-out /home .\n"
31276 "\n"
31277 msgstr ""
31278
31279 # type: textblock
31280 #. type: textblock
31281 #: ../fish/guestfish-commands.pod:46
31282 msgid ""
31283 "Wildcards cannot be used in the ordinary command, but you can use them with "
31284 "the help of L</glob> like this:"
31285 msgstr ""
31286
31287 # type: verbatim
31288 #. type: verbatim
31289 #: ../fish/guestfish-commands.pod:49
31290 #, no-wrap
31291 msgid ""
31292 " glob copy-out /home/* .\n"
31293 "\n"
31294 msgstr ""
31295
31296 # type: =head2
31297 #. type: =head2
31298 #: ../fish/guestfish-commands.pod:51
31299 msgid "echo"
31300 msgstr ""
31301
31302 # type: verbatim
31303 #. type: verbatim
31304 #: ../fish/guestfish-commands.pod:53
31305 #, no-wrap
31306 msgid ""
31307 " echo [params ...]\n"
31308 "\n"
31309 msgstr ""
31310
31311 # type: textblock
31312 #. type: textblock
31313 #: ../fish/guestfish-commands.pod:55
31314 msgid "This echos the parameters to the terminal."
31315 msgstr ""
31316
31317 # type: =head2
31318 #. type: =head2
31319 #: ../fish/guestfish-commands.pod:57
31320 msgid "edit"
31321 msgstr ""
31322
31323 # type: =head2
31324 #. type: =head2
31325 #: ../fish/guestfish-commands.pod:59
31326 msgid "vi"
31327 msgstr ""
31328
31329 # type: =head2
31330 #. type: =head2
31331 #: ../fish/guestfish-commands.pod:61
31332 msgid "emacs"
31333 msgstr ""
31334
31335 # type: verbatim
31336 #. type: verbatim
31337 #: ../fish/guestfish-commands.pod:63
31338 #, no-wrap
31339 msgid ""
31340 " edit filename\n"
31341 "\n"
31342 msgstr ""
31343
31344 # type: textblock
31345 #. type: textblock
31346 #: ../fish/guestfish-commands.pod:65
31347 msgid ""
31348 "This is used to edit a file.  It downloads the file, edits it locally using "
31349 "your editor, then uploads the result."
31350 msgstr ""
31351
31352 # type: textblock
31353 #. type: textblock
31354 #: ../fish/guestfish-commands.pod:68
31355 msgid ""
31356 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
31357 "or C<emacs> you will get those corresponding editors."
31358 msgstr ""
31359
31360 # type: =head2
31361 #. type: =head2
31362 #: ../fish/guestfish-commands.pod:72
31363 msgid "glob"
31364 msgstr ""
31365
31366 # type: verbatim
31367 #. type: verbatim
31368 #: ../fish/guestfish-commands.pod:74
31369 #, no-wrap
31370 msgid ""
31371 " glob command args...\n"
31372 "\n"
31373 msgstr ""
31374
31375 # type: textblock
31376 #. type: textblock
31377 #: ../fish/guestfish-commands.pod:76
31378 msgid ""
31379 "Expand wildcards in any paths in the args list, and run C<command> "
31380 "repeatedly on each matching path."
31381 msgstr ""
31382
31383 # type: textblock
31384 #. type: textblock
31385 #: ../fish/guestfish-commands.pod:79
31386 msgid "See L</WILDCARDS AND GLOBBING>."
31387 msgstr ""
31388
31389 # type: =head2
31390 #. type: =head2
31391 #: ../fish/guestfish-commands.pod:81
31392 msgid "hexedit"
31393 msgstr ""
31394
31395 # type: verbatim
31396 #. type: verbatim
31397 #: ../fish/guestfish-commands.pod:83
31398 #, no-wrap
31399 msgid ""
31400 " hexedit <filename|device>\n"
31401 " hexedit <filename|device> <max>\n"
31402 " hexedit <filename|device> <start> <max>\n"
31403 "\n"
31404 msgstr ""
31405
31406 # type: textblock
31407 #. type: textblock
31408 #: ../fish/guestfish-commands.pod:87
31409 msgid ""
31410 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
31411 "device."
31412 msgstr ""
31413
31414 # type: textblock
31415 #. type: textblock
31416 #: ../fish/guestfish-commands.pod:90
31417 msgid ""
31418 "This command works by downloading potentially the whole file or device, "
31419 "editing it locally, then uploading it.  If the file or device is large, you "
31420 "have to specify which part you wish to edit by using C<max> and/or C<start> "
31421 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
31422 "usual modifiers allowed such as C<1M> (1 megabyte)."
31423 msgstr ""
31424
31425 # type: textblock
31426 #. type: textblock
31427 #: ../fish/guestfish-commands.pod:97
31428 msgid "For example to edit the first few sectors of a disk you might do:"
31429 msgstr ""
31430
31431 # type: verbatim
31432 #. type: verbatim
31433 #: ../fish/guestfish-commands.pod:100
31434 #, no-wrap
31435 msgid ""
31436 " hexedit /dev/sda 1M\n"
31437 "\n"
31438 msgstr ""
31439
31440 # type: textblock
31441 #. type: textblock
31442 #: ../fish/guestfish-commands.pod:102
31443 msgid ""
31444 "which would allow you to edit anywhere within the first megabyte of the disk."
31445 msgstr ""
31446
31447 # type: textblock
31448 #. type: textblock
31449 #: ../fish/guestfish-commands.pod:105
31450 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
31451 msgstr ""
31452
31453 # type: verbatim
31454 #. type: verbatim
31455 #: ../fish/guestfish-commands.pod:107
31456 #, no-wrap
31457 msgid ""
31458 " hexedit /dev/sda1 0x400 0x400\n"
31459 "\n"
31460 msgstr ""
31461
31462 # type: textblock
31463 #. type: textblock
31464 #: ../fish/guestfish-commands.pod:109
31465 msgid "(assuming the superblock is in the standard location)."
31466 msgstr ""
31467
31468 # type: textblock
31469 #. type: textblock
31470 #: ../fish/guestfish-commands.pod:111
31471 msgid ""
31472 "This command requires the external L<hexedit(1)> program.  You can specify "
31473 "another program to use by setting the C<HEXEDITOR> environment variable."
31474 msgstr ""
31475
31476 # type: textblock
31477 #. type: textblock
31478 #: ../fish/guestfish-commands.pod:115
31479 msgid "See also L</hexdump>."
31480 msgstr ""
31481
31482 # type: =head2
31483 #. type: =head2
31484 #: ../fish/guestfish-commands.pod:117
31485 msgid "lcd"
31486 msgstr ""
31487
31488 # type: verbatim
31489 #. type: verbatim
31490 #: ../fish/guestfish-commands.pod:119
31491 #, no-wrap
31492 msgid ""
31493 " lcd directory\n"
31494 "\n"
31495 msgstr ""
31496
31497 # type: textblock
31498 #. type: textblock
31499 #: ../fish/guestfish-commands.pod:121
31500 msgid ""
31501 "Change the local directory, ie. the current directory of guestfish itself."
31502 msgstr ""
31503
31504 # type: textblock
31505 #. type: textblock
31506 #: ../fish/guestfish-commands.pod:124
31507 msgid "Note that C<!cd> won't do what you might expect."
31508 msgstr ""
31509
31510 # type: =head2
31511 #. type: =head2
31512 #: ../fish/guestfish-commands.pod:126
31513 msgid "man"
31514 msgstr ""
31515
31516 # type: =head2
31517 #. type: =head2
31518 #: ../fish/guestfish-commands.pod:128
31519 msgid "manual"
31520 msgstr ""
31521
31522 # type: verbatim
31523 #. type: verbatim
31524 #: ../fish/guestfish-commands.pod:130
31525 #, no-wrap
31526 msgid ""
31527 "  man\n"
31528 "\n"
31529 msgstr ""
31530
31531 # type: textblock
31532 #. type: textblock
31533 #: ../fish/guestfish-commands.pod:132
31534 msgid "Opens the manual page for guestfish."
31535 msgstr ""
31536
31537 # type: =head2
31538 #. type: =head2
31539 #: ../fish/guestfish-commands.pod:134
31540 msgid "more"
31541 msgstr ""
31542
31543 # type: =head2
31544 #. type: =head2
31545 #: ../fish/guestfish-commands.pod:136
31546 msgid "less"
31547 msgstr ""
31548
31549 # type: verbatim
31550 #. type: verbatim
31551 #: ../fish/guestfish-commands.pod:138
31552 #, no-wrap
31553 msgid ""
31554 " more filename\n"
31555 "\n"
31556 msgstr ""
31557
31558 # type: verbatim
31559 #. type: verbatim
31560 #: ../fish/guestfish-commands.pod:140
31561 #, no-wrap
31562 msgid ""
31563 " less filename\n"
31564 "\n"
31565 msgstr ""
31566
31567 # type: textblock
31568 #. type: textblock
31569 #: ../fish/guestfish-commands.pod:142
31570 msgid "This is used to view a file."
31571 msgstr ""
31572
31573 # type: textblock
31574 #. type: textblock
31575 #: ../fish/guestfish-commands.pod:144
31576 msgid ""
31577 "The default viewer is C<$PAGER>.  However if you use the alternate command "
31578 "C<less> you will get the C<less> command specifically."
31579 msgstr ""
31580
31581 # type: =head2
31582 #. type: =head2
31583 #: ../fish/guestfish-commands.pod:147
31584 msgid "reopen"
31585 msgstr ""
31586
31587 # type: verbatim
31588 #. type: verbatim
31589 #: ../fish/guestfish-commands.pod:149
31590 #, no-wrap
31591 msgid ""
31592 "  reopen\n"
31593 "\n"
31594 msgstr ""
31595
31596 # type: textblock
31597 #. type: textblock
31598 #: ../fish/guestfish-commands.pod:151
31599 msgid ""
31600 "Close and reopen the libguestfs handle.  It is not necessary to use this "
31601 "normally, because the handle is closed properly when guestfish exits.  "
31602 "However this is occasionally useful for testing."
31603 msgstr ""
31604
31605 # type: =head2
31606 #. type: =head2
31607 #: ../fish/guestfish-commands.pod:155
31608 msgid "sparse"
31609 msgstr ""
31610
31611 # type: verbatim
31612 #. type: verbatim
31613 #: ../fish/guestfish-commands.pod:157
31614 #, no-wrap
31615 msgid ""
31616 " sparse filename size\n"
31617 "\n"
31618 msgstr ""
31619
31620 # type: textblock
31621 #. type: textblock
31622 #: ../fish/guestfish-commands.pod:159
31623 msgid ""
31624 "This creates an empty sparse file of the given size, and then adds so it can "
31625 "be further examined."
31626 msgstr ""
31627
31628 # type: textblock
31629 #. type: textblock
31630 #: ../fish/guestfish-commands.pod:162
31631 msgid ""
31632 "In all respects it works the same as the L</alloc> command, except that the "
31633 "image file is allocated sparsely, which means that disk blocks are not "
31634 "assigned to the file until they are needed.  Sparse disk files only use "
31635 "space when written to, but they are slower and there is a danger you could "
31636 "run out of real disk space during a write operation."
31637 msgstr ""
31638
31639 # type: =head2
31640 #. type: =head2
31641 #: ../fish/guestfish-commands.pod:172
31642 msgid "supported"
31643 msgstr ""
31644
31645 # type: verbatim
31646 #. type: verbatim
31647 #: ../fish/guestfish-commands.pod:174
31648 #, no-wrap
31649 msgid ""
31650 " supported\n"
31651 "\n"
31652 msgstr ""
31653
31654 # type: textblock
31655 #. type: textblock
31656 #: ../fish/guestfish-commands.pod:176
31657 msgid ""
31658 "This command returns a list of the optional groups known to the daemon, and "
31659 "indicates which ones are supported by this build of the libguestfs appliance."
31660 msgstr ""
31661
31662 # type: textblock
31663 #. type: textblock
31664 #: ../fish/guestfish-commands.pod:180
31665 msgid "See also L<guestfs(3)/AVAILABILITY>."
31666 msgstr ""
31667
31668 # type: =head2
31669 #. type: =head2
31670 #: ../fish/guestfish-commands.pod:182
31671 msgid "time"
31672 msgstr ""
31673
31674 # type: verbatim
31675 #. type: verbatim
31676 #: ../fish/guestfish-commands.pod:184
31677 #, no-wrap
31678 msgid ""
31679 " time command args...\n"
31680 "\n"
31681 msgstr ""
31682
31683 # type: textblock
31684 #. type: textblock
31685 #: ../fish/guestfish-commands.pod:186
31686 msgid ""
31687 "Run the command as usual, but print the elapsed time afterwards.  This can "
31688 "be useful for benchmarking operations."
31689 msgstr ""
31690
31691 # type: textblock
31692 #. type: textblock
31693 #: ../test-tool/libguestfs-test-tool.pod:5
31694 msgid "libguestfs-test-tool - End user tests for libguestfs"
31695 msgstr ""
31696
31697 # type: verbatim
31698 #. type: verbatim
31699 #: ../test-tool/libguestfs-test-tool.pod:9
31700 #, no-wrap
31701 msgid ""
31702 " libguestfs-test-tool [--options]\n"
31703 "\n"
31704 msgstr ""
31705
31706 # type: textblock
31707 #. type: textblock
31708 #: ../test-tool/libguestfs-test-tool.pod:13
31709 msgid ""
31710 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
31711 "and developers, to allow them to check basic libguestfs functionality is "
31712 "working.  This is needed because libguestfs occasionally breaks for reasons "
31713 "beyond our control: usually because of changes in the underlying qemu or "
31714 "kernel packages, or the host environment."
31715 msgstr ""
31716
31717 # type: textblock
31718 #. type: textblock
31719 #: ../test-tool/libguestfs-test-tool.pod:20
31720 msgid "If you suspect a problem in libguestfs, then just run:"
31721 msgstr ""
31722
31723 # type: verbatim
31724 #. type: verbatim
31725 #: ../test-tool/libguestfs-test-tool.pod:22
31726 #, no-wrap
31727 msgid ""
31728 " libguestfs-test-tool\n"
31729 "\n"
31730 msgstr ""
31731
31732 # type: textblock
31733 #. type: textblock
31734 #: ../test-tool/libguestfs-test-tool.pod:24
31735 msgid "It will print lots of diagnostic messages."
31736 msgstr ""
31737
31738 # type: textblock
31739 #. type: textblock
31740 #: ../test-tool/libguestfs-test-tool.pod:26
31741 msgid "If it runs to completion successfully, you will see this near the end:"
31742 msgstr ""
31743
31744 # type: verbatim
31745 #. type: verbatim
31746 #: ../test-tool/libguestfs-test-tool.pod:28
31747 #, no-wrap
31748 msgid ""
31749 " ===== TEST FINISHED OK =====\n"
31750 "\n"
31751 msgstr ""
31752
31753 # type: textblock
31754 #. type: textblock
31755 #: ../test-tool/libguestfs-test-tool.pod:30
31756 msgid "and the test tool will exit with code 0."
31757 msgstr ""
31758
31759 # type: textblock
31760 #. type: textblock
31761 #: ../test-tool/libguestfs-test-tool.pod:32
31762 msgid ""
31763 "If it fails (and/or exits with non-zero error code), please paste the "
31764 "B<complete, unedited> output of the test tool into a bug report.  More "
31765 "information about reporting bugs can be found on the L<http://libguestfs.org/"
31766 "> website."
31767 msgstr ""
31768
31769 # type: =item
31770 #. type: =item
31771 #: ../test-tool/libguestfs-test-tool.pod:41
31772 msgid "I<--help>"
31773 msgstr ""
31774
31775 # type: textblock
31776 #. type: textblock
31777 #: ../test-tool/libguestfs-test-tool.pod:43
31778 msgid "Display short usage information and exit."
31779 msgstr ""
31780
31781 # type: =item
31782 #. type: =item
31783 #: ../test-tool/libguestfs-test-tool.pod:45
31784 msgid "I<--qemu qemu_binary>"
31785 msgstr ""
31786
31787 # type: textblock
31788 #. type: textblock
31789 #: ../test-tool/libguestfs-test-tool.pod:47
31790 msgid ""
31791 "If you have downloaded another qemu binary, point this option at the full "
31792 "path of the binary to try it."
31793 msgstr ""
31794
31795 # type: =item
31796 #. type: =item
31797 #: ../test-tool/libguestfs-test-tool.pod:50
31798 msgid "I<--qemudir qemu_source_dir>"
31799 msgstr ""
31800
31801 # type: textblock
31802 #. type: textblock
31803 #: ../test-tool/libguestfs-test-tool.pod:52
31804 msgid ""
31805 "If you have compiled qemu from source, point this option at the source "
31806 "directory to try it."
31807 msgstr ""
31808
31809 # type: =item
31810 #. type: =item
31811 #: ../test-tool/libguestfs-test-tool.pod:55
31812 msgid "I<--timeout N>"
31813 msgstr ""
31814
31815 # type: textblock
31816 #. type: textblock
31817 #: ../test-tool/libguestfs-test-tool.pod:57
31818 msgid ""
31819 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
31820 "does not usually need to be adjusted unless your machine is very slow."
31821 msgstr ""
31822
31823 # type: =head1
31824 #. type: =head1
31825 #: ../test-tool/libguestfs-test-tool.pod:63
31826 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
31827 msgstr ""
31828
31829 # type: textblock
31830 #. type: textblock
31831 #: ../test-tool/libguestfs-test-tool.pod:65
31832 msgid ""
31833 "If you have compiled another version of qemu from source and would like to "
31834 "try that, then you can use the I<--qemudir> option to point to the qemu "
31835 "source directory."
31836 msgstr ""
31837
31838 # type: textblock
31839 #. type: textblock
31840 #: ../test-tool/libguestfs-test-tool.pod:69
31841 msgid ""
31842 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
31843 "option to point to the binary."
31844 msgstr ""
31845
31846 # type: textblock
31847 #. type: textblock
31848 #: ../test-tool/libguestfs-test-tool.pod:72
31849 msgid ""
31850 "When using an alternate qemu with libguestfs, usually you would need to "
31851 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
31852 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
31853 "use either of the I<--qemudir> or I<--qemu> options."
31854 msgstr ""
31855
31856 # type: textblock
31857 #. type: textblock
31858 #: ../test-tool/libguestfs-test-tool.pod:79
31859 msgid ""
31860 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
31861 "I<1> if there was an error."
31862 msgstr ""
31863
31864 # type: textblock
31865 #. type: textblock
31866 #: ../test-tool/libguestfs-test-tool.pod:84
31867 msgid ""
31868 "For the full list of environment variables which may affect libguestfs, "
31869 "please see the L<guestfs(3)> manual page."
31870 msgstr ""
31871
31872 # type: textblock
31873 #. type: textblock
31874 #: ../test-tool/libguestfs-test-tool.pod:89
31875 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
31876 msgstr ""
31877
31878 # type: textblock
31879 #. type: textblock
31880 #: ../fuse/guestmount.pod:5
31881 msgid ""
31882 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
31883 msgstr ""
31884
31885 # type: verbatim
31886 #. type: verbatim
31887 #: ../fuse/guestmount.pod:9
31888 #, no-wrap
31889 msgid ""
31890 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
31891 "\n"
31892 msgstr ""
31893
31894 # type: verbatim
31895 #. type: verbatim
31896 #: ../fuse/guestmount.pod:11
31897 #, no-wrap
31898 msgid ""
31899 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
31900 "\n"
31901 msgstr ""
31902
31903 # type: verbatim
31904 #. type: verbatim
31905 #: ../fuse/guestmount.pod:13
31906 #, no-wrap
31907 msgid ""
31908 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
31909 "\n"
31910 msgstr ""
31911
31912 # type: textblock
31913 #. type: textblock
31914 #: ../fuse/guestmount.pod:17
31915 msgid ""
31916 "You must I<not> use C<guestmount> in read-write mode on live virtual "
31917 "machines.  If you do this, you risk disk corruption in the VM."
31918 msgstr ""
31919
31920 # type: textblock
31921 #. type: textblock
31922 #: ../fuse/guestmount.pod:22
31923 msgid ""
31924 "The guestmount program can be used to mount virtual machine filesystems and "
31925 "other disk images on the host.  It uses libguestfs for access to the guest "
31926 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
31927 "a mountable device."
31928 msgstr ""
31929
31930 # type: textblock
31931 #. type: textblock
31932 #: ../fuse/guestmount.pod:27
31933 msgid ""
31934 "Along with other options, you have to give at least one device (I<-a> "
31935 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
31936 "option) or use the I<-i> inspection option.  How this works is better "
31937 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
31938 "below."
31939 msgstr ""
31940
31941 # type: textblock
31942 #. type: textblock
31943 #: ../fuse/guestmount.pod:33
31944 msgid ""
31945 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
31946 "by you, and the filesystem will not be visible to any other users unless you "
31947 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
31948 "the filesystem, use the C<fusermount -u> command."
31949 msgstr ""
31950
31951 # type: textblock
31952 #. type: textblock
31953 #: ../fuse/guestmount.pod:41
31954 msgid ""
31955 "For a typical Windows guest which has its main filesystem on the first "
31956 "partition:"
31957 msgstr ""
31958
31959 # type: verbatim
31960 #. type: verbatim
31961 #: ../fuse/guestmount.pod:44
31962 #, no-wrap
31963 msgid ""
31964 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
31965 "\n"
31966 msgstr ""
31967
31968 # type: textblock
31969 #. type: textblock
31970 #: ../fuse/guestmount.pod:46
31971 msgid ""
31972 "For a typical Linux guest which has a /boot filesystem on the first "
31973 "partition, and the root filesystem on a logical volume:"
31974 msgstr ""
31975
31976 # type: verbatim
31977 #. type: verbatim
31978 #: ../fuse/guestmount.pod:49
31979 #, no-wrap
31980 msgid ""
31981 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
31982 "\n"
31983 msgstr ""
31984
31985 # type: textblock
31986 #. type: textblock
31987 #: ../fuse/guestmount.pod:51
31988 msgid "To get libguestfs to detect guest mountpoints for you:"
31989 msgstr ""
31990
31991 # type: verbatim
31992 #. type: verbatim
31993 #: ../fuse/guestmount.pod:53
31994 #, no-wrap
31995 msgid ""
31996 " guestmount -a guest.img -i --ro /mnt\n"
31997 "\n"
31998 msgstr ""
31999
32000 # type: textblock
32001 #. type: textblock
32002 #: ../fuse/guestmount.pod:55
32003 msgid "For a libvirt guest called \"Guest\" you could do:"
32004 msgstr ""
32005
32006 # type: verbatim
32007 #. type: verbatim
32008 #: ../fuse/guestmount.pod:57
32009 #, no-wrap
32010 msgid ""
32011 " guestmount -d Guest -i --ro /mnt\n"
32012 "\n"
32013 msgstr ""
32014
32015 # type: textblock
32016 #. type: textblock
32017 #: ../fuse/guestmount.pod:59
32018 msgid ""
32019 "If you don't know what filesystems are contained in a guest or disk image, "
32020 "use L<virt-filesystems(1)> first:"
32021 msgstr ""
32022
32023 # type: verbatim
32024 #. type: verbatim
32025 #: ../fuse/guestmount.pod:62
32026 #, no-wrap
32027 msgid ""
32028 " virt-filesystems MyGuest\n"
32029 "\n"
32030 msgstr ""
32031
32032 # type: textblock
32033 #. type: textblock
32034 #: ../fuse/guestmount.pod:64
32035 msgid ""
32036 "If you want to trace the libguestfs calls but without excessive debugging "
32037 "information, we recommend:"
32038 msgstr ""
32039
32040 # type: verbatim
32041 #. type: verbatim
32042 #: ../fuse/guestmount.pod:67
32043 #, no-wrap
32044 msgid ""
32045 " guestmount [...] --trace /mnt\n"
32046 "\n"
32047 msgstr ""
32048
32049 # type: textblock
32050 #. type: textblock
32051 #: ../fuse/guestmount.pod:69
32052 msgid "If you want to debug the program, we recommend:"
32053 msgstr ""
32054
32055 # type: verbatim
32056 #. type: verbatim
32057 #: ../fuse/guestmount.pod:71
32058 #, no-wrap
32059 msgid ""
32060 " guestmount [...] --trace --verbose /mnt\n"
32061 "\n"
32062 msgstr ""
32063
32064 # type: =item
32065 #. type: =item
32066 #: ../fuse/guestmount.pod:77
32067 msgid "B<-a image> | B<--add image>"
32068 msgstr ""
32069
32070 # type: textblock
32071 #. type: textblock
32072 #: ../fuse/guestmount.pod:79
32073 msgid "Add a block device or virtual machine image."
32074 msgstr ""
32075
32076 # type: =item
32077 #. type: =item
32078 #: ../fuse/guestmount.pod:84
32079 msgid "B<-c URI> | B<--connect URI>"
32080 msgstr ""
32081
32082 # type: =item
32083 #. type: =item
32084 #: ../fuse/guestmount.pod:90
32085 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
32086 msgstr ""
32087
32088 # type: =item
32089 #. type: =item
32090 #: ../fuse/guestmount.pod:96
32091 msgid "B<--dir-cache-timeout N>"
32092 msgstr ""
32093
32094 # type: textblock
32095 #. type: textblock
32096 #: ../fuse/guestmount.pod:98
32097 msgid ""
32098 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
32099 "seconds.  The readdir cache [actually, there are several semi-independent "
32100 "caches] is populated after a readdir(2) call with the stat and extended "
32101 "attributes of the files in the directory, in anticipation that they will be "
32102 "requested soon after."
32103 msgstr ""
32104
32105 # type: textblock
32106 #. type: textblock
32107 #: ../fuse/guestmount.pod:104
32108 msgid ""
32109 "There is also a different attribute cache implemented by FUSE (see the FUSE "
32110 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
32111 "requests, only cache existing ones."
32112 msgstr ""
32113
32114 # type: =item
32115 #. type: =item
32116 #: ../fuse/guestmount.pod:115
32117 msgid "B<--format=raw|qcow2|..> | B<--format>"
32118 msgstr ""
32119
32120 # type: textblock
32121 #. type: textblock
32122 #: ../fuse/guestmount.pod:122
32123 msgid ""
32124 "If you have untrusted raw-format guest disk images, you should use this "
32125 "option to specify the disk format.  This avoids a possible security problem "
32126 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
32127 "guestfs_add_drive_opts>."
32128 msgstr ""
32129
32130 # type: =item
32131 #. type: =item
32132 #: ../fuse/guestmount.pod:127
32133 msgid "B<--fuse-help>"
32134 msgstr ""
32135
32136 # type: textblock
32137 #. type: textblock
32138 #: ../fuse/guestmount.pod:129
32139 msgid "Display help on special FUSE options (see I<-o> below)."
32140 msgstr ""
32141
32142 # type: textblock
32143 #. type: textblock
32144 #: ../fuse/guestmount.pod:133
32145 msgid "Display brief help and exit."
32146 msgstr ""
32147
32148 # type: =item
32149 #. type: =item
32150 #: ../fuse/guestmount.pod:135
32151 msgid "B<-i> | B<--inspector>"
32152 msgstr ""
32153
32154 # type: textblock
32155 #. type: textblock
32156 #: ../fuse/guestmount.pod:155
32157 msgid ""
32158 "Mount the named partition or logical volume on the given mountpoint B<in the "
32159 "guest> (this has nothing to do with mountpoints in the host)."
32160 msgstr ""
32161
32162 # type: textblock
32163 #. type: textblock
32164 #: ../fuse/guestmount.pod:158
32165 msgid ""
32166 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
32167 "something on C</>."
32168 msgstr ""
32169
32170 # type: =item
32171 #. type: =item
32172 #: ../fuse/guestmount.pod:171
32173 msgid "B<-n> | B<--no-sync>"
32174 msgstr ""
32175
32176 # type: textblock
32177 #. type: textblock
32178 #: ../fuse/guestmount.pod:173
32179 msgid ""
32180 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
32181 "unmounted.  If you specify this option, then we don't attempt to sync the "
32182 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
32183 msgstr ""
32184
32185 # type: =item
32186 #. type: =item
32187 #: ../fuse/guestmount.pod:178
32188 msgid "B<-o option> | B<--option option>"
32189 msgstr ""
32190
32191 # type: textblock
32192 #. type: textblock
32193 #: ../fuse/guestmount.pod:180
32194 msgid "Pass extra options to FUSE."
32195 msgstr ""
32196
32197 # type: textblock
32198 #. type: textblock
32199 #: ../fuse/guestmount.pod:182
32200 msgid ""
32201 "To get a list of all the extra options supported by FUSE, use the command "
32202 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
32203 "of them are a good idea."
32204 msgstr ""
32205
32206 # type: verbatim
32207 #. type: verbatim
32208 #: ../fuse/guestmount.pod:186
32209 #, no-wrap
32210 msgid ""
32211 " guestmount --fuse-help\n"
32212 "\n"
32213 msgstr ""
32214
32215 # type: textblock
32216 #. type: textblock
32217 #: ../fuse/guestmount.pod:188
32218 msgid "Some potentially useful FUSE options:"
32219 msgstr ""
32220
32221 # type: =item
32222 #. type: =item
32223 #: ../fuse/guestmount.pod:192
32224 msgid "B<-o allow_other>"
32225 msgstr ""
32226
32227 # type: textblock
32228 #. type: textblock
32229 #: ../fuse/guestmount.pod:194
32230 msgid "Allow other users to see the filesystem."
32231 msgstr ""
32232
32233 # type: =item
32234 #. type: =item
32235 #: ../fuse/guestmount.pod:196
32236 msgid "B<-o attr_timeout=N>"
32237 msgstr ""
32238
32239 # type: textblock
32240 #. type: textblock
32241 #: ../fuse/guestmount.pod:198
32242 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
32243 msgstr ""
32244
32245 # type: =item
32246 #. type: =item
32247 #: ../fuse/guestmount.pod:200
32248 msgid "B<-o kernel_cache>"
32249 msgstr ""
32250
32251 # type: textblock
32252 #. type: textblock
32253 #: ../fuse/guestmount.pod:202
32254 msgid ""
32255 "Allow the kernel to cache files (reduces the number of reads that have to go "
32256 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
32257 "afford the extra memory usage."
32258 msgstr ""
32259
32260 # type: =item
32261 #. type: =item
32262 #: ../fuse/guestmount.pod:206
32263 msgid "B<-o uid=N> B<-o gid=N>"
32264 msgstr ""
32265
32266 # type: textblock
32267 #. type: textblock
32268 #: ../fuse/guestmount.pod:208
32269 msgid ""
32270 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
32271 "the chosen values."
32272 msgstr ""
32273
32274 # type: =item
32275 #. type: =item
32276 #: ../fuse/guestmount.pod:213
32277 msgid "B<-r> | B<--ro>"
32278 msgstr ""
32279
32280 # type: textblock
32281 #. type: textblock
32282 #: ../fuse/guestmount.pod:215
32283 msgid ""
32284 "Add devices and mount everything read-only.  Also disallow writes and make "
32285 "the disk appear read-only to FUSE."
32286 msgstr ""
32287
32288 # type: textblock
32289 #. type: textblock
32290 #: ../fuse/guestmount.pod:218
32291 msgid ""
32292 "This is highly recommended if you are not going to edit the guest disk.  If "
32293 "the guest is running and this option is I<not> supplied, then there is a "
32294 "strong risk of disk corruption in the guest.  We try to prevent this from "
32295 "happening, but it is not always possible."
32296 msgstr ""
32297
32298 # type: textblock
32299 #. type: textblock
32300 #: ../fuse/guestmount.pod:223
32301 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32302 msgstr ""
32303
32304 # type: textblock
32305 #. type: textblock
32306 #: ../fuse/guestmount.pod:227
32307 msgid "Enable SELinux support for the guest."
32308 msgstr ""
32309
32310 # type: =item
32311 #. type: =item
32312 #: ../fuse/guestmount.pod:229
32313 msgid "B<-v> | B<--verbose>"
32314 msgstr ""
32315
32316 # type: textblock
32317 #. type: textblock
32318 #: ../fuse/guestmount.pod:231
32319 msgid "Enable verbose messages from underlying libguestfs."
32320 msgstr ""
32321
32322 # type: =item
32323 #. type: =item
32324 #: ../fuse/guestmount.pod:233
32325 msgid "B<-V> | B<--version>"
32326 msgstr ""
32327
32328 # type: textblock
32329 #. type: textblock
32330 #: ../fuse/guestmount.pod:235
32331 msgid "Display the program version and exit."
32332 msgstr ""
32333
32334 # type: =item
32335 #. type: =item
32336 #: ../fuse/guestmount.pod:237
32337 msgid "B<-w> | B<--rw>"
32338 msgstr ""
32339
32340 #. type: textblock
32341 #: ../fuse/guestmount.pod:242 ../fuse/guestmount.pod:263
32342 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32343 msgstr ""
32344
32345 # type: =item
32346 #. type: =item
32347 #: ../fuse/guestmount.pod:244
32348 msgid "B<-x> | B<--trace>"
32349 msgstr ""
32350
32351 # type: textblock
32352 #. type: textblock
32353 #: ../fuse/guestmount.pod:246
32354 msgid "Trace libguestfs calls and entry into each FUSE function."
32355 msgstr ""
32356
32357 # type: textblock
32358 #. type: textblock
32359 #: ../fuse/guestmount.pod:248
32360 msgid "This also stops the daemon from forking into the background."
32361 msgstr ""
32362
32363 # type: textblock
32364 #. type: textblock
32365 #: ../fuse/guestmount.pod:269
32366 msgid ""
32367 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
32368 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
32369 "net/>."
32370 msgstr ""
32371
32372 # type: textblock
32373 #. type: textblock
32374 #: ../fuse/guestmount.pod:284
32375 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
32376 msgstr ""
32377
32378 # type: textblock
32379 #. type: textblock
32380 #: ../tools/virt-edit.pl:34
32381 msgid "virt-edit - Edit a file in a virtual machine"
32382 msgstr ""
32383
32384 # type: verbatim
32385 #. type: verbatim
32386 #: ../tools/virt-edit.pl:38
32387 #, no-wrap
32388 msgid ""
32389 " virt-edit [--options] domname file\n"
32390 "\n"
32391 msgstr ""
32392
32393 # type: verbatim
32394 #. type: verbatim
32395 #: ../tools/virt-edit.pl:40
32396 #, no-wrap
32397 msgid ""
32398 " virt-edit [--options] disk.img [disk.img ...] file\n"
32399 "\n"
32400 msgstr ""
32401
32402 # type: verbatim
32403 #. type: verbatim
32404 #: ../tools/virt-edit.pl:42
32405 #, no-wrap
32406 msgid ""
32407 " virt-edit [domname|disk.img] file -e 'expr'\n"
32408 "\n"
32409 msgstr ""
32410
32411 # type: textblock
32412 #. type: textblock
32413 #: ../tools/virt-edit.pl:46
32414 msgid ""
32415 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
32416 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
32417 "doing this, but doesn't catch all cases."
32418 msgstr ""
32419
32420 # type: textblock
32421 #. type: textblock
32422 #: ../tools/virt-edit.pl:52
32423 msgid ""
32424 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
32425 "the named virtual machine (or disk image)."
32426 msgstr ""
32427
32428 #. type: textblock
32429 #: ../tools/virt-edit.pl:55
32430 msgid "If you want to just view a file, use L<virt-cat(1)>."
32431 msgstr ""
32432
32433 #. type: textblock
32434 #: ../tools/virt-edit.pl:57
32435 msgid ""
32436 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
32437 "USING GUESTFISH> below)."
32438 msgstr ""
32439
32440 #. type: textblock
32441 #: ../tools/virt-edit.pl:60
32442 msgid ""
32443 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
32444 "files.  L<guestfish(1)> can do that and much more."
32445 msgstr ""
32446
32447 # type: textblock
32448 #. type: textblock
32449 #: ../tools/virt-edit.pl:65
32450 msgid "Edit the named files interactively:"
32451 msgstr ""
32452
32453 # type: verbatim
32454 #. type: verbatim
32455 #: ../tools/virt-edit.pl:67
32456 #, no-wrap
32457 msgid ""
32458 " virt-edit mydomain /boot/grub/grub.conf\n"
32459 "\n"
32460 msgstr ""
32461
32462 # type: verbatim
32463 #. type: verbatim
32464 #: ../tools/virt-edit.pl:69
32465 #, no-wrap
32466 msgid ""
32467 " virt-edit mydomain /etc/passwd\n"
32468 "\n"
32469 msgstr ""
32470
32471 #. type: textblock
32472 #: ../tools/virt-edit.pl:71
32473 msgid "For Windows guests, some Windows paths are understood:"
32474 msgstr ""
32475
32476 #. type: verbatim
32477 #: ../tools/virt-edit.pl:73
32478 #, no-wrap
32479 msgid ""
32480 " virt-edit mywindomain 'c:\\autoexec.bat'\n"
32481 "\n"
32482 msgstr ""
32483
32484 # type: textblock
32485 #. type: textblock
32486 #: ../tools/virt-edit.pl:75
32487 msgid ""
32488 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
32489 "below).  To change the init default level to 5:"
32490 msgstr ""
32491
32492 # type: verbatim
32493 #. type: verbatim
32494 #: ../tools/virt-edit.pl:79
32495 #, no-wrap
32496 msgid ""
32497 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
32498 "\n"
32499 msgstr ""
32500
32501 # type: textblock
32502 #. type: textblock
32503 #: ../tools/virt-edit.pl:91 ../tools/virt-win-reg.pl:106
32504 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113
32505 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
32506 msgid "Display brief help."
32507 msgstr ""
32508
32509 # type: textblock
32510 #. type: textblock
32511 #: ../tools/virt-edit.pl:99 ../tools/virt-win-reg.pl:114
32512 #: ../tools/virt-list-filesystems.pl:71 ../tools/virt-tar.pl:121
32513 #: ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:72
32514 msgid "Display version number and exit."
32515 msgstr ""
32516
32517 # type: =item
32518 #. type: =item
32519 #: ../tools/virt-edit.pl:105
32520 msgid "B<--backup extension> | B<-b extension>"
32521 msgstr ""
32522
32523 # type: textblock
32524 #. type: textblock
32525 #: ../tools/virt-edit.pl:107
32526 msgid ""
32527 "Create a backup of the original file I<in the guest disk image>.  The backup "
32528 "has the original filename with C<extension> added."
32529 msgstr ""
32530
32531 # type: textblock
32532 #. type: textblock
32533 #: ../tools/virt-edit.pl:110
32534 msgid ""
32535 "Usually the first character of C<extension> would be a dot C<.> so you would "
32536 "write:"
32537 msgstr ""
32538
32539 # type: verbatim
32540 #. type: verbatim
32541 #: ../tools/virt-edit.pl:113
32542 #, no-wrap
32543 msgid ""
32544 " virt-edit -b .orig [etc]\n"
32545 "\n"
32546 msgstr ""
32547
32548 # type: textblock
32549 #. type: textblock
32550 #: ../tools/virt-edit.pl:115
32551 msgid "By default, no backup file is made."
32552 msgstr ""
32553
32554 # type: =item
32555 #. type: =item
32556 #: ../tools/virt-edit.pl:121 ../tools/virt-win-reg.pl:128
32557 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127
32558 #: ../tools/virt-list-partitions.pl:78
32559 msgid "B<--connect URI> | B<-c URI>"
32560 msgstr ""
32561
32562 # type: textblock
32563 #. type: textblock
32564 #: ../tools/virt-edit.pl:123 ../tools/virt-win-reg.pl:130
32565 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129
32566 #: ../tools/virt-list-partitions.pl:80
32567 msgid ""
32568 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
32569 "to the default libvirt hypervisor."
32570 msgstr ""
32571
32572 # type: textblock
32573 #. type: textblock
32574 #: ../tools/virt-edit.pl:126 ../tools/virt-win-reg.pl:133
32575 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132
32576 #: ../tools/virt-list-partitions.pl:83
32577 msgid ""
32578 "If you specify guest block devices directly, then libvirt is not used at all."
32579 msgstr ""
32580
32581 # type: =item
32582 #. type: =item
32583 #: ../tools/virt-edit.pl:133 ../tools/virt-win-reg.pl:140
32584 #: ../tools/virt-list-filesystems.pl:89 ../tools/virt-tar.pl:139
32585 #: ../tools/virt-list-partitions.pl:90
32586 msgid "B<--format> raw"
32587 msgstr ""
32588
32589 # type: textblock
32590 #. type: textblock
32591 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:142
32592 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141
32593 #: ../tools/virt-list-partitions.pl:92
32594 msgid ""
32595 "Specify the format of disk images given on the command line.  If this is "
32596 "omitted then the format is autodetected from the content of the disk image."
32597 msgstr ""
32598
32599 # type: textblock
32600 #. type: textblock
32601 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:146
32602 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145
32603 #: ../tools/virt-list-partitions.pl:96
32604 msgid ""
32605 "If disk images are requested from libvirt, then this program asks libvirt "
32606 "for this information.  In this case, the value of the format parameter is "
32607 "ignored."
32608 msgstr ""
32609
32610 # type: textblock
32611 #. type: textblock
32612 #: ../tools/virt-edit.pl:143 ../tools/virt-win-reg.pl:150
32613 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149
32614 #: ../tools/virt-list-partitions.pl:100
32615 msgid ""
32616 "If working with untrusted raw-format guest disk images, you should ensure "
32617 "the format is always specified."
32618 msgstr ""
32619
32620 # type: =item
32621 #. type: =item
32622 #: ../tools/virt-edit.pl:150
32623 msgid "B<--expr EXPR> | B<-e EXPR>"
32624 msgstr ""
32625
32626 # type: textblock
32627 #. type: textblock
32628 #: ../tools/virt-edit.pl:152
32629 msgid ""
32630 "Instead of launching the external editor, non-interactively apply the Perl "
32631 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
32632 "EDITING> below."
32633 msgstr ""
32634
32635 # type: textblock
32636 #. type: textblock
32637 #: ../tools/virt-edit.pl:156
32638 msgid ""
32639 "Be careful to properly quote the expression to prevent it from being altered "
32640 "by the shell."
32641 msgstr ""
32642
32643 # type: =head1
32644 #. type: =head1
32645 #: ../tools/virt-edit.pl:280
32646 msgid "NON-INTERACTIVE EDITING"
32647 msgstr ""
32648
32649 # type: textblock
32650 #. type: textblock
32651 #: ../tools/virt-edit.pl:282
32652 msgid ""
32653 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
32654 "administrator can interactively edit the file."
32655 msgstr ""
32656
32657 # type: textblock
32658 #. type: textblock
32659 #: ../tools/virt-edit.pl:285
32660 msgid ""
32661 "There are two ways also to use C<virt-edit> from scripts in order to make "
32662 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
32663 "like this, it's less error-prone to write scripts directly using the "
32664 "libguestfs API and Augeas for configuration file editing.)"
32665 msgstr ""
32666
32667 # type: textblock
32668 #. type: textblock
32669 #: ../tools/virt-edit.pl:291
32670 msgid ""
32671 "The first method is to temporarily set C<$EDITOR> to any script or program "
32672 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
32673 "update C<tmpfile> in place however it likes."
32674 msgstr ""
32675
32676 # type: textblock
32677 #. type: textblock
32678 #: ../tools/virt-edit.pl:295
32679 msgid ""
32680 "The second method is to use the C<-e> parameter of C<virt-edit> to run a "
32681 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
32682 "instances of C<foo> with C<bar> in a file:"
32683 msgstr ""
32684
32685 # type: verbatim
32686 #. type: verbatim
32687 #: ../tools/virt-edit.pl:299
32688 #, no-wrap
32689 msgid ""
32690 " virt-edit domname filename -e 's/foo/bar/'\n"
32691 "\n"
32692 msgstr ""
32693
32694 # type: textblock
32695 #. type: textblock
32696 #: ../tools/virt-edit.pl:301
32697 msgid ""
32698 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
32699 "For example to delete root's password you could do:"
32700 msgstr ""
32701
32702 # type: verbatim
32703 #. type: verbatim
32704 #: ../tools/virt-edit.pl:304
32705 #, no-wrap
32706 msgid ""
32707 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
32708 "\n"
32709 msgstr ""
32710
32711 # type: textblock
32712 #. type: textblock
32713 #: ../tools/virt-edit.pl:306
32714 msgid ""
32715 "What really happens is that the snippet is evaluated as a Perl expression "
32716 "for each line of the file.  The line, including the final C<\\n>, is passed "
32717 "in C<$_> and the expression should update C<$_> or leave it unchanged."
32718 msgstr ""
32719
32720 # type: textblock
32721 #. type: textblock
32722 #: ../tools/virt-edit.pl:311
32723 msgid ""
32724 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
32725 "C<apache> user account from the password file you can do:"
32726 msgstr ""
32727
32728 # type: verbatim
32729 #. type: verbatim
32730 #: ../tools/virt-edit.pl:314
32731 #, no-wrap
32732 msgid ""
32733 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
32734 "\n"
32735 msgstr ""
32736
32737 # type: textblock
32738 #. type: textblock
32739 #: ../tools/virt-edit.pl:316
32740 msgid ""
32741 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
32742 "the end of the file is rather difficult this way since there is no concept "
32743 "of \"last line of the file\" - your expression just doesn't get called "
32744 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
32745 "want to do this."
32746 msgstr ""
32747
32748 # type: textblock
32749 #. type: textblock
32750 #: ../tools/virt-edit.pl:322
32751 msgid ""
32752 "The variable C<$lineno> contains the current line number.  As is "
32753 "traditional, the first line in the file is number C<1>."
32754 msgstr ""
32755
32756 # type: textblock
32757 #. type: textblock
32758 #: ../tools/virt-edit.pl:325
32759 msgid ""
32760 "The return value from the expression is ignored, but the expression may call "
32761 "C<die> in order to abort the whole program, leaving the original file "
32762 "untouched."
32763 msgstr ""
32764
32765 # type: textblock
32766 #. type: textblock
32767 #: ../tools/virt-edit.pl:329
32768 msgid ""
32769 "Remember when matching the end of a line that C<$_> may contain the final C<"
32770 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
32771 "newline then neither of these.  Thus to match or substitute some text at the "
32772 "end of a line, use this regular expression:"
32773 msgstr ""
32774
32775 # type: verbatim
32776 #. type: verbatim
32777 #: ../tools/virt-edit.pl:334
32778 #, no-wrap
32779 msgid ""
32780 " /some text(\\r?\\n)?$/\n"
32781 "\n"
32782 msgstr ""
32783
32784 # type: textblock
32785 #. type: textblock
32786 #: ../tools/virt-edit.pl:336
32787 msgid ""
32788 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
32789 "$_> itself (since that would remove all newlines from the file):"
32790 msgstr ""
32791
32792 # type: verbatim
32793 #. type: verbatim
32794 #: ../tools/virt-edit.pl:340
32795 #, no-wrap
32796 msgid ""
32797 " my $m = $_; chomp $m; $m =~ /some text$/\n"
32798 "\n"
32799 msgstr ""
32800
32801 #. type: textblock
32802 #: ../tools/virt-edit.pl:344
32803 msgid ""
32804 "C<virt-edit> has a limited ability to understand Windows drive letters and "
32805 "paths (eg. C<E:\\foo\\bar.txt>)."
32806 msgstr ""
32807
32808 #. type: textblock
32809 #: ../tools/virt-edit.pl:347
32810 msgid "If and only if the guest is running Windows then:"
32811 msgstr ""
32812
32813 #. type: textblock
32814 #: ../tools/virt-edit.pl:353
32815 msgid ""
32816 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
32817 "to the correct filesystem."
32818 msgstr ""
32819
32820 #. type: textblock
32821 #: ../tools/virt-edit.pl:358
32822 msgid ""
32823 "Any backslash (C<\\>) characters in the path are replaced with forward "
32824 "slashes so that libguestfs can process it."
32825 msgstr ""
32826
32827 #. type: textblock
32828 #: ../tools/virt-edit.pl:363
32829 msgid ""
32830 "The path is resolved case insensitively to locate the file that should be "
32831 "edited."
32832 msgstr ""
32833
32834 #. type: textblock
32835 #: ../tools/virt-edit.pl:368
32836 msgid "There are some known shortcomings:"
32837 msgstr ""
32838
32839 #. type: textblock
32840 #: ../tools/virt-edit.pl:374
32841 msgid "Some NTFS symbolic links may not be followed correctly."
32842 msgstr ""
32843
32844 #. type: textblock
32845 #: ../tools/virt-edit.pl:378
32846 msgid "NTFS junction points that cross filesystems are not followed."
32847 msgstr ""
32848
32849 #. type: =head1
32850 #: ../tools/virt-edit.pl:435
32851 msgid "USING GUESTFISH"
32852 msgstr ""
32853
32854 #. type: textblock
32855 #: ../tools/virt-edit.pl:437
32856 msgid ""
32857 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
32858 "C<virt-edit> doesn't work."
32859 msgstr ""
32860
32861 #. type: textblock
32862 #: ../tools/virt-edit.pl:440
32863 msgid "Using C<virt-edit> is approximately equivalent to doing:"
32864 msgstr ""
32865
32866 #. type: verbatim
32867 #: ../tools/virt-edit.pl:442
32868 #, no-wrap
32869 msgid ""
32870 " guestfish --rw -i -d domname edit /file\n"
32871 "\n"
32872 msgstr ""
32873
32874 #. type: textblock
32875 #: ../tools/virt-edit.pl:444
32876 msgid ""
32877 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
32878 "path to the file."
32879 msgstr ""
32880
32881 #. type: textblock
32882 #: ../tools/virt-edit.pl:447
32883 msgid ""
32884 "The command above uses libguestfs's guest inspection feature and so does not "
32885 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
32886 "disk images that don't contain guests.  To edit a file on a disk image "
32887 "directly, use:"
32888 msgstr ""
32889
32890 #. type: verbatim
32891 #: ../tools/virt-edit.pl:452
32892 #, no-wrap
32893 msgid ""
32894 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
32895 "\n"
32896 msgstr ""
32897
32898 #. type: textblock
32899 #: ../tools/virt-edit.pl:454
32900 msgid ""
32901 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
32902 "the disk image to edit, and C</file> is the full path to the file."
32903 msgstr ""
32904
32905 #. type: textblock
32906 #: ../tools/virt-edit.pl:458
32907 msgid ""
32908 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
32909 "C<write> or C<upload> instead:"
32910 msgstr ""
32911
32912 #. type: verbatim
32913 #: ../tools/virt-edit.pl:461
32914 #, no-wrap
32915 msgid ""
32916 " guestfish --rw -i -d domname touch /newfile\n"
32917 "\n"
32918 msgstr ""
32919
32920 #. type: verbatim
32921 #: ../tools/virt-edit.pl:463
32922 #, no-wrap
32923 msgid ""
32924 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
32925 "\n"
32926 msgstr ""
32927
32928 #. type: verbatim
32929 #: ../tools/virt-edit.pl:465
32930 #, no-wrap
32931 msgid ""
32932 " guestfish --rw -i -d domname upload localfile /newfile\n"
32933 "\n"
32934 msgstr ""
32935
32936 #. type: textblock
32937 #: ../tools/virt-edit.pl:467
32938 msgid ""
32939 "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
32940 msgstr ""
32941
32942 #. type: verbatim
32943 #: ../tools/virt-edit.pl:470
32944 #, no-wrap
32945 msgid ""
32946 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
32947 "\n"
32948 msgstr ""
32949
32950 # type: =item
32951 #. type: =item
32952 #: ../tools/virt-edit.pl:480
32953 msgid "C<EDITOR>"
32954 msgstr ""
32955
32956 # type: textblock
32957 #. type: textblock
32958 #: ../tools/virt-edit.pl:482
32959 msgid ""
32960 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
32961 "\"emacs -nw\">"
32962 msgstr ""
32963
32964 # type: textblock
32965 #. type: textblock
32966 #: ../tools/virt-edit.pl:485
32967 msgid "If not set, C<vi> is used."
32968 msgstr ""
32969
32970 # type: =head2
32971 #. type: =head1
32972 #: ../tools/virt-edit.pl:489 ../tools/virt-win-reg.pl:559
32973 #: ../tools/virt-list-filesystems.pl:182 ../tools/virt-tar.pl:279
32974 #: ../tools/virt-make-fs.pl:532 ../tools/virt-list-partitions.pl:250
32975 msgid "SHELL QUOTING"
32976 msgstr ""
32977
32978 # type: textblock
32979 #. type: textblock
32980 #: ../tools/virt-edit.pl:491 ../tools/virt-win-reg.pl:567
32981 #: ../tools/virt-list-filesystems.pl:184 ../tools/virt-tar.pl:281
32982 #: ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:252
32983 msgid ""
32984 "Libvirt guest names can contain arbitrary characters, some of which have "
32985 "meaning to the shell such as C<#> and space.  You may need to quote or "
32986 "escape these characters on the command line.  See the shell manual page L<sh"
32987 "(1)> for details."
32988 msgstr ""
32989
32990 #. type: textblock
32991 #: ../tools/virt-edit.pl:498
32992 msgid ""
32993 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
32994 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
32995 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
32996 msgstr ""
32997
32998 # type: =head1
32999 #. type: =head1
33000 #: ../tools/virt-edit.pl:510 ../tools/virt-win-reg.pl:598
33001 #: ../tools/virt-list-filesystems.pl:202 ../tools/virt-tar.pl:301
33002 #: ../tools/virt-make-fs.pl:564 ../tools/virt-list-partitions.pl:269
33003 msgid "AUTHOR"
33004 msgstr ""
33005
33006 # type: textblock
33007 #. type: textblock
33008 #: ../tools/virt-edit.pl:512 ../tools/virt-win-reg.pl:600
33009 #: ../tools/virt-list-filesystems.pl:204 ../tools/virt-tar.pl:303
33010 #: ../tools/virt-make-fs.pl:566 ../tools/virt-list-partitions.pl:271
33011 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
33012 msgstr ""
33013
33014 #. type: textblock
33015 #: ../tools/virt-edit.pl:516
33016 msgid "Copyright (C) 2009-2011 Red Hat Inc."
33017 msgstr ""
33018
33019 # type: textblock
33020 #. type: textblock
33021 #: ../tools/virt-win-reg.pl:37
33022 msgid ""
33023 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
33024 msgstr ""
33025
33026 # type: verbatim
33027 #. type: verbatim
33028 #: ../tools/virt-win-reg.pl:41
33029 #, no-wrap
33030 msgid ""
33031 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
33032 "\n"
33033 msgstr ""
33034
33035 # type: verbatim
33036 #. type: verbatim
33037 #: ../tools/virt-win-reg.pl:43
33038 #, no-wrap
33039 msgid ""
33040 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
33041 "\n"
33042 msgstr ""
33043
33044 # type: verbatim
33045 #. type: verbatim
33046 #: ../tools/virt-win-reg.pl:45
33047 #, no-wrap
33048 msgid ""
33049 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
33050 "\n"
33051 msgstr ""
33052
33053 # type: verbatim
33054 #. type: verbatim
33055 #: ../tools/virt-win-reg.pl:47
33056 #, no-wrap
33057 msgid ""
33058 " virt-win-reg --merge domname [input.reg ...]\n"
33059 "\n"
33060 msgstr ""
33061
33062 # type: verbatim
33063 #. type: verbatim
33064 #: ../tools/virt-win-reg.pl:49
33065 #, no-wrap
33066 msgid ""
33067 " virt-win-reg [--options] disk.img ... # instead of domname\n"
33068 "\n"
33069 msgstr ""
33070
33071 # type: textblock
33072 #. type: textblock
33073 #: ../tools/virt-win-reg.pl:53
33074 msgid ""
33075 "You must I<not> use C<virt-win-reg> with the C<--merge> option on live "
33076 "virtual machines.  If you do this, you I<will> get irreversible disk "
33077 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
33078 "but doesn't catch all cases."
33079 msgstr ""
33080
33081 # type: textblock
33082 #. type: textblock
33083 #: ../tools/virt-win-reg.pl:58
33084 msgid ""
33085 "Modifying the Windows Registry is an inherently risky operation.  The format "
33086 "is deliberately obscure and undocumented, and Registry changes can leave the "
33087 "system unbootable.  Therefore when using the C<--merge> option, make sure "
33088 "you have a reliable backup first."
33089 msgstr ""
33090
33091 # type: textblock
33092 #. type: textblock
33093 #: ../tools/virt-win-reg.pl:65
33094 msgid ""
33095 "This program can export and merge Windows Registry entries from a Windows "
33096 "guest."
33097 msgstr ""
33098
33099 # type: textblock
33100 #. type: textblock
33101 #: ../tools/virt-win-reg.pl:68
33102 msgid ""
33103 "The first parameter is the libvirt guest name or the raw disk image of a "
33104 "Windows guest."
33105 msgstr ""
33106
33107 # type: textblock
33108 #. type: textblock
33109 #: ../tools/virt-win-reg.pl:71
33110 msgid ""
33111 "If C<--merge> is I<not> specified, then the chosen registry key is displayed/"
33112 "exported (recursively).  For example:"
33113 msgstr ""
33114
33115 # type: verbatim
33116 #. type: verbatim
33117 #: ../tools/virt-win-reg.pl:74
33118 #, no-wrap
33119 msgid ""
33120 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
33121 "\n"
33122 msgstr ""
33123
33124 # type: textblock
33125 #. type: textblock
33126 #: ../tools/virt-win-reg.pl:76
33127 msgid ""
33128 "You can also display single values from within registry keys, for example:"
33129 msgstr ""
33130
33131 # type: verbatim
33132 #. type: verbatim
33133 #: ../tools/virt-win-reg.pl:79
33134 #, no-wrap
33135 msgid ""
33136 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
33137 " $ virt-win-reg Windows7 $cvkey ProductName\n"
33138 " Windows 7 Enterprise\n"
33139 "\n"
33140 msgstr ""
33141
33142 # type: textblock
33143 #. type: textblock
33144 #: ../tools/virt-win-reg.pl:83
33145 msgid ""
33146 "With C<--merge>, you can merge a textual regedit file into the Windows "
33147 "Registry:"
33148 msgstr ""
33149
33150 # type: verbatim
33151 #. type: verbatim
33152 #: ../tools/virt-win-reg.pl:86
33153 #, no-wrap
33154 msgid ""
33155 " $ virt-win-reg --merge Windows7 changes.reg\n"
33156 "\n"
33157 msgstr ""
33158
33159 # type: =head2
33160 #. type: =head1
33161 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
33162 msgid "NOTE"
33163 msgstr ""
33164
33165 # type: textblock
33166 #. type: textblock
33167 #: ../tools/virt-win-reg.pl:90
33168 msgid ""
33169 "This program is only meant for simple access to the registry.  If you want "
33170 "to do complicated things with the registry, we suggest you download the "
33171 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
33172 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
33173 "L<hivexregedit(1)>."
33174 msgstr ""
33175
33176 # type: =item
33177 #. type: =item
33178 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
33179 msgid "B<--debug>"
33180 msgstr ""
33181
33182 # type: textblock
33183 #. type: textblock
33184 #: ../tools/virt-win-reg.pl:122
33185 msgid "Enable debugging messages."
33186 msgstr ""
33187
33188 # type: =item
33189 #. type: =item
33190 #: ../tools/virt-win-reg.pl:157
33191 msgid "B<--merge>"
33192 msgstr ""
33193
33194 # type: textblock
33195 #. type: textblock
33196 #: ../tools/virt-win-reg.pl:159
33197 msgid ""
33198 "In merge mode, this merges a textual regedit file into the Windows Registry "
33199 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
33200 "displays or exports Registry entries instead."
33201 msgstr ""
33202
33203 # type: textblock
33204 #. type: textblock
33205 #: ../tools/virt-win-reg.pl:163
33206 msgid ""
33207 "Note that C<--merge> is I<unsafe> to use on live virtual machines, and will "
33208 "result in disk corruption.  However exporting (without this flag)  is always "
33209 "safe."
33210 msgstr ""
33211
33212 # type: =item
33213 #. type: =item
33214 #: ../tools/virt-win-reg.pl:171
33215 msgid "B<--encoding> UTF-16LE|ASCII"
33216 msgstr ""
33217
33218 # type: textblock
33219 #. type: textblock
33220 #: ../tools/virt-win-reg.pl:173
33221 msgid ""
33222 "When merging (only), you may need to specify the encoding for strings to be "
33223 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
33224 "(3)/ENCODING STRINGS>."
33225 msgstr ""
33226
33227 # type: textblock
33228 #. type: textblock
33229 #: ../tools/virt-win-reg.pl:177
33230 msgid ""
33231 "The default is to use UTF-16LE, which should work with recent versions of "
33232 "Windows."
33233 msgstr ""
33234
33235 # type: =head2
33236 #. type: =head1
33237 #: ../tools/virt-win-reg.pl:402
33238 msgid "SUPPORTED SYSTEMS"
33239 msgstr ""
33240
33241 # type: textblock
33242 #. type: textblock
33243 #: ../tools/virt-win-reg.pl:404
33244 msgid ""
33245 "The program currently supports Windows NT-derived guests starting with "
33246 "Windows XP through to at least Windows 7."
33247 msgstr ""
33248
33249 # type: textblock
33250 #. type: textblock
33251 #: ../tools/virt-win-reg.pl:407
33252 msgid ""
33253 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
33254 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
33255 "and C<HKEY_USERS\\.DEFAULT>."
33256 msgstr ""
33257
33258 # type: textblock
33259 #. type: textblock
33260 #: ../tools/virt-win-reg.pl:411
33261 msgid ""
33262 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
33263 "C<HKEY_USERS>."
33264 msgstr ""
33265
33266 # type: textblock
33267 #. type: textblock
33268 #: ../tools/virt-win-reg.pl:414
33269 msgid ""
33270 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
33271 "time."
33272 msgstr ""
33273
33274 # type: =head2
33275 #. type: =head1
33276 #: ../tools/virt-win-reg.pl:417
33277 msgid "ENCODING"
33278 msgstr ""
33279
33280 # type: textblock
33281 #. type: textblock
33282 #: ../tools/virt-win-reg.pl:419
33283 msgid ""
33284 "C<virt-win-reg> expects that regedit files have already been reencoded in "
33285 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
33286 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
33287 "Windows-style line endings, you may need to reencode the whole file before "
33288 "or after processing."
33289 msgstr ""
33290
33291 # type: textblock
33292 #. type: textblock
33293 #: ../tools/virt-win-reg.pl:425
33294 msgid ""
33295 "To reencode a file from Windows format to Linux (before processing it with "
33296 "the C<--merge> option), you would do something like this:"
33297 msgstr ""
33298
33299 # type: verbatim
33300 #. type: verbatim
33301 #: ../tools/virt-win-reg.pl:428
33302 #, no-wrap
33303 msgid ""
33304 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
33305 "\n"
33306 msgstr ""
33307
33308 # type: textblock
33309 #. type: textblock
33310 #: ../tools/virt-win-reg.pl:430
33311 msgid ""
33312 "To go in the opposite direction, after exporting and before sending the file "
33313 "to a Windows user, do something like this:"
33314 msgstr ""
33315
33316 # type: verbatim
33317 #. type: verbatim
33318 #: ../tools/virt-win-reg.pl:433
33319 #, no-wrap
33320 msgid ""
33321 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
33322 "\n"
33323 msgstr ""
33324
33325 # type: textblock
33326 #. type: textblock
33327 #: ../tools/virt-win-reg.pl:435
33328 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
33329 msgstr ""
33330
33331 # type: textblock
33332 #. type: textblock
33333 #: ../tools/virt-win-reg.pl:437
33334 msgid ""
33335 "If you are unsure about the current encoding, use the L<file(1)> command.  "
33336 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
33337 "style (CRLF) line endings, like this:"
33338 msgstr ""
33339
33340 # type: verbatim
33341 #. type: verbatim
33342 #: ../tools/virt-win-reg.pl:441
33343 #, no-wrap
33344 msgid ""
33345 " $ file software.reg\n"
33346 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
33347 " with CRLF line terminators\n"
33348 "\n"
33349 msgstr ""
33350
33351 # type: textblock
33352 #. type: textblock
33353 #: ../tools/virt-win-reg.pl:445
33354 msgid "This file would need conversion before you could C<--merge> it."
33355 msgstr ""
33356
33357 # type: =head2
33358 #. type: =head1
33359 #: ../tools/virt-win-reg.pl:447
33360 msgid "CurrentControlSet etc."
33361 msgstr ""
33362
33363 # type: textblock
33364 #. type: textblock
33365 #: ../tools/virt-win-reg.pl:449
33366 msgid ""
33367 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
33368 "Registry at the level of the hive file, and therefore you cannot modify "
33369 "these."
33370 msgstr ""
33371
33372 # type: textblock
33373 #. type: textblock
33374 #: ../tools/virt-win-reg.pl:453
33375 msgid ""
33376 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
33377 "circumstances it might refer to another control set.  The way to find out is "
33378 "to look at the C<HKLM\\SYSTEM\\Select> key:"
33379 msgstr ""
33380
33381 # type: verbatim
33382 #. type: verbatim
33383 #: ../tools/virt-win-reg.pl:457
33384 #, no-wrap
33385 msgid ""
33386 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
33387 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
33388 " \"Current\"=dword:00000001\n"
33389 " \"Default\"=dword:00000001\n"
33390 " \"Failed\"=dword:00000000\n"
33391 " \"LastKnownGood\"=dword:00000002\n"
33392 "\n"
33393 msgstr ""
33394
33395 # type: textblock
33396 #. type: textblock
33397 #: ../tools/virt-win-reg.pl:464
33398 msgid "\"Current\" is the one which Windows will choose when it boots."
33399 msgstr ""
33400
33401 # type: textblock
33402 #. type: textblock
33403 #: ../tools/virt-win-reg.pl:466
33404 msgid ""
33405 "Similarly, other C<Current...> keys in the path may need to be replaced."
33406 msgstr ""
33407
33408 # type: =head1
33409 #. type: =head1
33410 #: ../tools/virt-win-reg.pl:469
33411 msgid "WINDOWS TIPS"
33412 msgstr ""
33413
33414 # type: textblock
33415 #. type: textblock
33416 #: ../tools/virt-win-reg.pl:471
33417 msgid ""
33418 "Note that some of these tips modify the guest disk image.  The guest I<must> "
33419 "be shut off, else you will get disk corruption."
33420 msgstr ""
33421
33422 # type: =head2
33423 #. type: =head2
33424 #: ../tools/virt-win-reg.pl:474
33425 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
33426 msgstr ""
33427
33428 # type: textblock
33429 #. type: textblock
33430 #: ../tools/virt-win-reg.pl:476
33431 msgid ""
33432 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
33433 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
33434 "is uploaded into C<C:\\>:"
33435 msgstr ""
33436
33437 # type: verbatim
33438 #. type: verbatim
33439 #: ../tools/virt-win-reg.pl:480
33440 #, no-wrap
33441 msgid ""
33442 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
33443 "\n"
33444 msgstr ""
33445
33446 # type: textblock
33447 #. type: textblock
33448 #: ../tools/virt-win-reg.pl:482
33449 msgid "Prepare a regedit file containing the registry change:"
33450 msgstr ""
33451
33452 # type: verbatim
33453 #. type: verbatim
33454 #: ../tools/virt-win-reg.pl:484
33455 #, no-wrap
33456 msgid ""
33457 " cat > test.reg <<'EOF'\n"
33458 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
33459 " \"Test\"=\"c:\\\\test.bat\"\n"
33460 " EOF\n"
33461 "\n"
33462 msgstr ""
33463
33464 # type: textblock
33465 #. type: textblock
33466 #: ../tools/virt-win-reg.pl:489
33467 msgid ""
33468 "In this example we use the key C<RunOnce> which means that the script will "
33469 "run precisely once when the first user logs in.  If you want it to run every "
33470 "time a user logs in, replace C<RunOnce> with C<Run>."
33471 msgstr ""
33472
33473 # type: textblock
33474 #. type: textblock
33475 #: ../tools/virt-win-reg.pl:493
33476 msgid "Now update the registry:"
33477 msgstr ""
33478
33479 # type: verbatim
33480 #. type: verbatim
33481 #: ../tools/virt-win-reg.pl:495
33482 #, no-wrap
33483 msgid ""
33484 " virt-win-reg --merge WindowsGuest test.reg\n"
33485 "\n"
33486 msgstr ""
33487
33488 # type: =head2
33489 #. type: =head2
33490 #: ../tools/virt-win-reg.pl:497
33491 msgid "INSTALLING A SERVICE"
33492 msgstr ""
33493
33494 # type: textblock
33495 #. type: textblock
33496 #: ../tools/virt-win-reg.pl:499
33497 msgid ""
33498 "This section assumes you are familiar with Windows services, and you either "
33499 "have a program which handles the Windows Service Control Protocol directly "
33500 "or you want to run any program using a service wrapper like SrvAny or the "
33501 "free RHSrvAny."
33502 msgstr ""
33503
33504 # type: textblock
33505 #. type: textblock
33506 #: ../tools/virt-win-reg.pl:504
33507 msgid ""
33508 "First upload the program and optionally the service wrapper.  In this case "
33509 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
33510 msgstr ""
33511
33512 # type: verbatim
33513 #. type: verbatim
33514 #: ../tools/virt-win-reg.pl:508
33515 #, no-wrap
33516 msgid ""
33517 " guestfish -i -d WindowsGuest <<EOF\n"
33518 "   upload rhsrvany.exe /rhsrvany.exe\n"
33519 "   upload test.exe /test.exe\n"
33520 " EOF\n"
33521 "\n"
33522 msgstr ""
33523
33524 # type: textblock
33525 #. type: textblock
33526 #: ../tools/virt-win-reg.pl:513
33527 msgid ""
33528 "Prepare a regedit file containing the registry changes.  In this example, "
33529 "the first registry change is needed for the service itself or the service "
33530 "wrapper (if used).  The second registry change is only needed because I am "
33531 "using the RHSrvAny service wrapper."
33532 msgstr ""
33533
33534 # type: verbatim
33535 #. type: verbatim
33536 #: ../tools/virt-win-reg.pl:518
33537 #, no-wrap
33538 msgid ""
33539 " cat > service.reg <<'EOF'\n"
33540 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
33541 " \"Type\"=dword:00000010\n"
33542 " \"Start\"=dword:00000002\n"
33543 " \"ErrorControl\"=dword:00000001\n"
33544 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
33545 " \"DisplayName\"=\"RHSrvAny\"\n"
33546 " \"ObjectName\"=\"NetworkService\"\n"
33547 " \n"
33548 msgstr ""
33549
33550 # type: verbatim
33551 #. type: verbatim
33552 #: ../tools/virt-win-reg.pl:527
33553 #, no-wrap
33554 msgid ""
33555 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
33556 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
33557 " \"PWD\"=\"c:\\\\Temp\"\n"
33558 " EOF\n"
33559 "\n"
33560 msgstr ""
33561
33562 # type: textblock
33563 #. type: textblock
33564 #: ../tools/virt-win-reg.pl:538
33565 msgid ""
33566 "For use of C<ControlSet001> see the section above in this manual page.  You "
33567 "may need to adjust this according to the control set that is in use by the "
33568 "guest."
33569 msgstr ""
33570
33571 # type: textblock
33572 #. type: textblock
33573 #: ../tools/virt-win-reg.pl:544
33574 msgid ""
33575 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
33576 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
33577 "privileged account."
33578 msgstr ""
33579
33580 # type: textblock
33581 #. type: textblock
33582 #: ../tools/virt-win-reg.pl:550
33583 msgid ""
33584 "For the meaning of the magic numbers, see this Microsoft KB article: "
33585 "L<http://support.microsoft.com/kb/103000>."
33586 msgstr ""
33587
33588 # type: textblock
33589 #. type: textblock
33590 #: ../tools/virt-win-reg.pl:555
33591 msgid "Update the registry:"
33592 msgstr ""
33593
33594 # type: verbatim
33595 #. type: verbatim
33596 #: ../tools/virt-win-reg.pl:557
33597 #, no-wrap
33598 msgid ""
33599 " virt-win-reg --merge WindowsGuest service.reg\n"
33600 "\n"
33601 msgstr ""
33602
33603 # type: textblock
33604 #. type: textblock
33605 #: ../tools/virt-win-reg.pl:561
33606 msgid ""
33607 "Be careful when passing parameters containing C<\\> (backslash) in the "
33608 "shell.  Usually you will have to use 'single quotes' or double backslashes "
33609 "(but not both) to protect them from the shell."
33610 msgstr ""
33611
33612 # type: textblock
33613 #. type: textblock
33614 #: ../tools/virt-win-reg.pl:565
33615 msgid "Paths and value names are case-insensitive."
33616 msgstr ""
33617
33618 # type: textblock
33619 #. type: textblock
33620 #: ../tools/virt-win-reg.pl:574
33621 msgid ""
33622 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
33623 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
33624 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33625 msgstr ""
33626
33627 # type: textblock
33628 #. type: textblock
33629 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
33630 msgid ""
33631 "When reporting bugs, please enable debugging and capture the I<complete> "
33632 "output:"
33633 msgstr ""
33634
33635 # type: verbatim
33636 #. type: verbatim
33637 #: ../tools/virt-win-reg.pl:592
33638 #, no-wrap
33639 msgid ""
33640 " export LIBGUESTFS_DEBUG=1\n"
33641 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
33642 "\n"
33643 msgstr ""
33644
33645 # type: textblock
33646 #. type: textblock
33647 #: ../tools/virt-win-reg.pl:595
33648 msgid ""
33649 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
33650 "redhat.com/>"
33651 msgstr ""
33652
33653 # type: textblock
33654 #. type: textblock
33655 #: ../tools/virt-win-reg.pl:604 ../tools/virt-make-fs.pl:570
33656 msgid "Copyright (C) 2010 Red Hat Inc."
33657 msgstr ""
33658
33659 # type: textblock
33660 #. type: textblock
33661 #: ../tools/virt-list-filesystems.pl:32
33662 msgid ""
33663 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
33664 msgstr ""
33665
33666 # type: verbatim
33667 #. type: verbatim
33668 #: ../tools/virt-list-filesystems.pl:36
33669 #, no-wrap
33670 msgid ""
33671 " virt-list-filesystems [--options] domname\n"
33672 "\n"
33673 msgstr ""
33674
33675 # type: verbatim
33676 #. type: verbatim
33677 #: ../tools/virt-list-filesystems.pl:38
33678 #, no-wrap
33679 msgid ""
33680 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
33681 "\n"
33682 msgstr ""
33683
33684 # type: textblock
33685 #. type: textblock
33686 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
33687 msgid ""
33688 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
33689 "replacement."
33690 msgstr ""
33691
33692 # type: textblock
33693 #. type: textblock
33694 #: ../tools/virt-list-filesystems.pl:45
33695 msgid ""
33696 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
33697 "are contained in a virtual machine or disk image."
33698 msgstr ""
33699
33700 # type: textblock
33701 #. type: textblock
33702 #: ../tools/virt-list-filesystems.pl:49
33703 msgid ""
33704 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
33705 "functionality.  For more complex cases you should look at the L<guestfish(1)"
33706 "> tool."
33707 msgstr ""
33708
33709 # type: =item
33710 #. type: =item
33711 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
33712 msgid "B<-l> | B<--long>"
33713 msgstr ""
33714
33715 # type: textblock
33716 #. type: textblock
33717 #: ../tools/virt-list-filesystems.pl:108
33718 msgid ""
33719 "With this option, C<virt-list-filesystems> displays the type of each "
33720 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
33721 msgstr ""
33722
33723 # type: =item
33724 #. type: =item
33725 #: ../tools/virt-list-filesystems.pl:115
33726 msgid "B<-a> | B<--all>"
33727 msgstr ""
33728
33729 # type: textblock
33730 #. type: textblock
33731 #: ../tools/virt-list-filesystems.pl:117
33732 msgid ""
33733 "Normally we only show mountable filesystems.  If this option is given then "
33734 "swap devices are shown too."
33735 msgstr ""
33736
33737 # type: textblock
33738 #. type: textblock
33739 #: ../tools/virt-list-filesystems.pl:191
33740 msgid ""
33741 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
33742 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
33743 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33744 msgstr ""
33745
33746 # type: textblock
33747 #. type: textblock
33748 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
33749 msgid "Copyright (C) 2009 Red Hat Inc."
33750 msgstr ""
33751
33752 # type: textblock
33753 #. type: textblock
33754 #: ../tools/virt-tar.pl:33
33755 msgid "virt-tar - Extract or upload files to a virtual machine"
33756 msgstr ""
33757
33758 # type: verbatim
33759 #. type: verbatim
33760 #: ../tools/virt-tar.pl:37
33761 #, no-wrap
33762 msgid ""
33763 " virt-tar [--options] -x domname directory tarball\n"
33764 "\n"
33765 msgstr ""
33766
33767 # type: verbatim
33768 #. type: verbatim
33769 #: ../tools/virt-tar.pl:39
33770 #, no-wrap
33771 msgid ""
33772 " virt-tar [--options] -u domname tarball directory\n"
33773 "\n"
33774 msgstr ""
33775
33776 # type: verbatim
33777 #. type: verbatim
33778 #: ../tools/virt-tar.pl:41
33779 #, no-wrap
33780 msgid ""
33781 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
33782 "\n"
33783 msgstr ""
33784
33785 # type: verbatim
33786 #. type: verbatim
33787 #: ../tools/virt-tar.pl:43
33788 #, no-wrap
33789 msgid ""
33790 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
33791 "\n"
33792 msgstr ""
33793
33794 #. type: textblock
33795 #: ../tools/virt-tar.pl:47
33796 msgid ""
33797 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
33798 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
33799 msgstr ""
33800
33801 # type: textblock
33802 #. type: textblock
33803 #: ../tools/virt-tar.pl:52
33804 msgid "Download C</home> from the VM into a local tarball:"
33805 msgstr ""
33806
33807 # type: verbatim
33808 #. type: verbatim
33809 #: ../tools/virt-tar.pl:54
33810 #, no-wrap
33811 msgid ""
33812 " virt-tar -x domname /home home.tar\n"
33813 "\n"
33814 msgstr ""
33815
33816 # type: verbatim
33817 #. type: verbatim
33818 #: ../tools/virt-tar.pl:56
33819 #, no-wrap
33820 msgid ""
33821 " virt-tar -zx domname /home home.tar.gz\n"
33822 "\n"
33823 msgstr ""
33824
33825 # type: textblock
33826 #. type: textblock
33827 #: ../tools/virt-tar.pl:58
33828 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
33829 msgstr ""
33830
33831 # type: verbatim
33832 #. type: verbatim
33833 #: ../tools/virt-tar.pl:60
33834 #, no-wrap
33835 msgid ""
33836 " virt-tar -u domname uploadstuff.tar /tmp\n"
33837 "\n"
33838 msgstr ""
33839
33840 # type: verbatim
33841 #. type: verbatim
33842 #: ../tools/virt-tar.pl:62
33843 #, no-wrap
33844 msgid ""
33845 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
33846 "\n"
33847 msgstr ""
33848
33849 # type: textblock
33850 #. type: textblock
33851 #: ../tools/virt-tar.pl:66
33852 msgid ""
33853 "You must I<not> use C<virt-tar> with the C<-u> option (upload) on live "
33854 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
33855 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
33856 msgstr ""
33857
33858 # type: textblock
33859 #. type: textblock
33860 #: ../tools/virt-tar.pl:71
33861 msgid ""
33862 "You can use C<-x> (extract) on live virtual machines, but you might get "
33863 "inconsistent results or errors if there is filesystem activity inside the "
33864 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
33865 "work, but the only way to guarantee consistent results is if the virtual "
33866 "machine is shut down."
33867 msgstr ""
33868
33869 # type: textblock
33870 #. type: textblock
33871 #: ../tools/virt-tar.pl:79
33872 msgid ""
33873 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
33874 "parts of a guest filesystem.  There are many possibilities: making backups, "
33875 "uploading data files, snooping on guest activity, fixing or customizing "
33876 "guests, etc."
33877 msgstr ""
33878
33879 # type: textblock
33880 #. type: textblock
33881 #: ../tools/virt-tar.pl:84
33882 msgid ""
33883 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
33884 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
33885 "should look at the L<guestfish(1)> tool."
33886 msgstr ""
33887
33888 # type: textblock
33889 #. type: textblock
33890 #: ../tools/virt-tar.pl:88
33891 msgid ""
33892 "There are two modes of operation: C<-x> (eXtract) downloads a directory and "
33893 "its contents (recursively) from the virtual machine into a local tarball.  "
33894 "C<-u> uploads from a local tarball, unpacking it into a directory inside the "
33895 "virtual machine.  You cannot use these two options together."
33896 msgstr ""
33897
33898 # type: textblock
33899 #. type: textblock
33900 #: ../tools/virt-tar.pl:94
33901 msgid ""
33902 "In addition, you may need to use the C<-z> (gZip) option to enable "
33903 "compression.  When uploading, you have to specify C<-z> if the upload file "
33904 "is compressed because virt-tar won't detect this on its own."
33905 msgstr ""
33906
33907 # type: textblock
33908 #. type: textblock
33909 #: ../tools/virt-tar.pl:98
33910 msgid ""
33911 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
33912 "example it cannot do PKZip files or bzip2 compression.  If you want that "
33913 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
33914 "the L<libguestfs(3)> API)."
33915 msgstr ""
33916
33917 # type: =item
33918 #. type: =item
33919 #: ../tools/virt-tar.pl:156
33920 msgid "B<-x> | B<--extract> | B<--download>"
33921 msgstr ""
33922
33923 # type: =item
33924 #. type: =item
33925 #: ../tools/virt-tar.pl:158
33926 msgid "B<-u> | B<--upload>"
33927 msgstr ""
33928
33929 # type: textblock
33930 #. type: textblock
33931 #: ../tools/virt-tar.pl:160
33932 msgid ""
33933 "Use C<-x> to extract (download) a directory from a virtual machine to a "
33934 "local tarball."
33935 msgstr ""
33936
33937 # type: textblock
33938 #. type: textblock
33939 #: ../tools/virt-tar.pl:163
33940 msgid ""
33941 "Use C<-u> to upload and unpack from a local tarball into a virtual machine.  "
33942 "Please read the L</WARNING> section above before using this option."
33943 msgstr ""
33944
33945 # type: textblock
33946 #. type: textblock
33947 #: ../tools/virt-tar.pl:167
33948 msgid "You must specify exactly one of these options."
33949 msgstr ""
33950
33951 # type: =item
33952 #. type: =item
33953 #: ../tools/virt-tar.pl:173
33954 msgid "B<-z> | B<--gzip>"
33955 msgstr ""
33956
33957 # type: textblock
33958 #. type: textblock
33959 #: ../tools/virt-tar.pl:175
33960 msgid "Specify that the input or output tarball is gzip-compressed."
33961 msgstr ""
33962
33963 #. type: textblock
33964 #: ../tools/virt-tar.pl:288
33965 msgid ""
33966 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
33967 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
33968 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
33969 "org/>."
33970 msgstr ""
33971
33972 # type: textblock
33973 #. type: textblock
33974 #: ../tools/virt-make-fs.pl:37
33975 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
33976 msgstr ""
33977
33978 # type: verbatim
33979 #. type: verbatim
33980 #: ../tools/virt-make-fs.pl:41
33981 #, no-wrap
33982 msgid ""
33983 " virt-make-fs [--options] input.tar output.img\n"
33984 "\n"
33985 msgstr ""
33986
33987 # type: verbatim
33988 #. type: verbatim
33989 #: ../tools/virt-make-fs.pl:43
33990 #, no-wrap
33991 msgid ""
33992 " virt-make-fs [--options] input.tar.gz output.img\n"
33993 "\n"
33994 msgstr ""
33995
33996 # type: verbatim
33997 #. type: verbatim
33998 #: ../tools/virt-make-fs.pl:45
33999 #, no-wrap
34000 msgid ""
34001 " virt-make-fs [--options] directory output.img\n"
34002 "\n"
34003 msgstr ""
34004
34005 # type: textblock
34006 #. type: textblock
34007 #: ../tools/virt-make-fs.pl:49
34008 msgid ""
34009 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
34010 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
34011 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
34012 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
34013 "you want to attach these filesystems to existing virtual machines (eg. to "
34014 "import large amounts of read-only data to a VM)."
34015 msgstr ""
34016
34017 # type: textblock
34018 #. type: textblock
34019 #: ../tools/virt-make-fs.pl:57
34020 msgid "Basic usage is:"
34021 msgstr ""
34022
34023 # type: verbatim
34024 #. type: verbatim
34025 #: ../tools/virt-make-fs.pl:59
34026 #, no-wrap
34027 msgid ""
34028 " virt-make-fs input output\n"
34029 "\n"
34030 msgstr ""
34031
34032 # type: textblock
34033 #. type: textblock
34034 #: ../tools/virt-make-fs.pl:61
34035 msgid ""
34036 "where C<input> is either a directory containing files that you want to add, "
34037 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
34038 "C<output> is a disk image.  The input type is detected automatically.  The "
34039 "output disk image defaults to a raw ext2 image unless you specify extra "
34040 "flags (see L</OPTIONS> below)."
34041 msgstr ""
34042
34043 # type: =head2
34044 #. type: =head2
34045 #: ../tools/virt-make-fs.pl:67
34046 msgid "EXTRA SPACE"
34047 msgstr ""
34048
34049 # type: textblock
34050 #. type: textblock
34051 #: ../tools/virt-make-fs.pl:69
34052 msgid ""
34053 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
34054 "the files that it contains, but might have extra space.  Depending on how "
34055 "you are going to use the output, you might think this extra space is wasted "
34056 "and want to minimize it, or you might want to leave space so that more files "
34057 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
34058 "but you can use the C<--size> flag to leave space in the filesystem if you "
34059 "want it."
34060 msgstr ""
34061
34062 # type: textblock
34063 #. type: textblock
34064 #: ../tools/virt-make-fs.pl:77
34065 msgid ""
34066 "An alternative way to leave extra space but not make the output image any "
34067 "bigger is to use an alternative disk image format (instead of the default "
34068 "\"raw\" format).  Using C<--format=qcow2> will use the native QEmu/KVM qcow2 "
34069 "image format (check your hypervisor supports this before using it).  This "
34070 "allows you to choose a large C<--size> but the extra space won't actually be "
34071 "allocated in the image until you try to store something in it."
34072 msgstr ""
34073
34074 #. type: textblock
34075 #: ../tools/virt-make-fs.pl:85
34076 msgid ""
34077 "Don't forget that you can also use local commands including L<resize2fs(8)> "
34078 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
34079 "to build another image from scratch."
34080 msgstr ""
34081
34082 # type: =head3
34083 #. type: =head3
34084 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
34085 #: ../tools/virt-make-fs.pl:142
34086 msgid "EXAMPLE"
34087 msgstr ""
34088
34089 # type: verbatim
34090 #. type: verbatim
34091 #: ../tools/virt-make-fs.pl:91
34092 #, no-wrap
34093 msgid ""
34094 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
34095 "\n"
34096 msgstr ""
34097
34098 # type: =head2
34099 #. type: =head2
34100 #: ../tools/virt-make-fs.pl:93
34101 msgid "FILESYSTEM TYPE"
34102 msgstr ""
34103
34104 # type: textblock
34105 #. type: textblock
34106 #: ../tools/virt-make-fs.pl:95
34107 msgid ""
34108 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
34109 "libguestfs supports can be used (but I<not> read-only formats like "
34110 "ISO9660).  Here are some of the more common choices:"
34111 msgstr ""
34112
34113 # type: =item
34114 #. type: =item
34115 #: ../tools/virt-make-fs.pl:101
34116 msgid "I<ext3>"
34117 msgstr ""
34118
34119 # type: textblock
34120 #. type: textblock
34121 #: ../tools/virt-make-fs.pl:103
34122 msgid ""
34123 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
34124 "you are not going to use the filesystem in a way that requires the journal, "
34125 "then this is just wasted overhead."
34126 msgstr ""
34127
34128 # type: =item
34129 #. type: =item
34130 #: ../tools/virt-make-fs.pl:107
34131 msgid "I<ntfs> or I<vfat>"
34132 msgstr ""
34133
34134 # type: textblock
34135 #. type: textblock
34136 #: ../tools/virt-make-fs.pl:109
34137 msgid "Useful if exporting data to a Windows guest."
34138 msgstr ""
34139
34140 # type: textblock
34141 #. type: textblock
34142 #: ../tools/virt-make-fs.pl:111
34143 msgid ""
34144 "I<Note for vfat>: The tar archive or local directory must only contain files "
34145 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
34146 "program running within libguestfs is unable to change the ownership of non-"
34147 "root files, since vfat itself does not support this."
34148 msgstr ""
34149
34150 # type: =item
34151 #. type: =item
34152 #: ../tools/virt-make-fs.pl:116
34153 msgid "I<minix>"
34154 msgstr ""
34155
34156 # type: textblock
34157 #. type: textblock
34158 #: ../tools/virt-make-fs.pl:118
34159 msgid ""
34160 "Lower overhead than C<ext2>, but certain limitations on filename length and "
34161 "total filesystem size."
34162 msgstr ""
34163
34164 # type: verbatim
34165 #. type: verbatim
34166 #: ../tools/virt-make-fs.pl:125
34167 #, no-wrap
34168 msgid ""
34169 " virt-make-fs --type=minix input minixfs.img\n"
34170 "\n"
34171 msgstr ""
34172
34173 # type: =head2
34174 #. type: =head2
34175 #: ../tools/virt-make-fs.pl:127
34176 msgid "TO PARTITION OR NOT TO PARTITION"
34177 msgstr ""
34178
34179 # type: textblock
34180 #. type: textblock
34181 #: ../tools/virt-make-fs.pl:129
34182 msgid "Optionally virt-make-fs can add a partition table to the output disk."
34183 msgstr ""
34184
34185 # type: textblock
34186 #. type: textblock
34187 #: ../tools/virt-make-fs.pl:131
34188 msgid ""
34189 "Adding a partition can make the disk image more compatible with certain "
34190 "virtualized operating systems which don't expect to see a filesystem "
34191 "directly located on a block device (Linux doesn't care and will happily "
34192 "handle both types)."
34193 msgstr ""
34194
34195 # type: textblock
34196 #. type: textblock
34197 #: ../tools/virt-make-fs.pl:136
34198 msgid ""
34199 "On the other hand, if you have a partition table then the output image is no "
34200 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
34201 "directly on a partitioned disk image.  (However libguestfs tools such as "
34202 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
34203 msgstr ""
34204
34205 # type: textblock
34206 #. type: textblock
34207 #: ../tools/virt-make-fs.pl:144
34208 msgid "Add an MBR partition:"
34209 msgstr ""
34210
34211 # type: verbatim
34212 #. type: verbatim
34213 #: ../tools/virt-make-fs.pl:146
34214 #, no-wrap
34215 msgid ""
34216 " virt-make-fs --partition -- input disk.img\n"
34217 "\n"
34218 msgstr ""
34219
34220 # type: textblock
34221 #. type: textblock
34222 #: ../tools/virt-make-fs.pl:148
34223 msgid ""
34224 "If the output disk image could be terabyte-sized or larger, it's better to "
34225 "use an EFI/GPT-compatible partition table:"
34226 msgstr ""
34227
34228 # type: verbatim
34229 #. type: verbatim
34230 #: ../tools/virt-make-fs.pl:151
34231 #, no-wrap
34232 msgid ""
34233 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
34234 "\n"
34235 msgstr ""
34236
34237 # type: textblock
34238 #. type: textblock
34239 #: ../tools/virt-make-fs.pl:179
34240 msgid "Enable debugging information."
34241 msgstr ""
34242
34243 # type: =item
34244 #. type: =item
34245 #: ../tools/virt-make-fs.pl:185
34246 msgid "B<--size=E<lt>NE<gt>>"
34247 msgstr ""
34248
34249 # type: =item
34250 #. type: =item
34251 #: ../tools/virt-make-fs.pl:187
34252 msgid "B<--size=+E<lt>NE<gt>>"
34253 msgstr ""
34254
34255 # type: =item
34256 #. type: =item
34257 #: ../tools/virt-make-fs.pl:189
34258 msgid "B<-s E<lt>NE<gt>>"
34259 msgstr ""
34260
34261 # type: =item
34262 #. type: =item
34263 #: ../tools/virt-make-fs.pl:191
34264 msgid "B<-s +E<lt>NE<gt>>"
34265 msgstr ""
34266
34267 # type: textblock
34268 #. type: textblock
34269 #: ../tools/virt-make-fs.pl:193
34270 msgid ""
34271 "Use the C<--size> (or C<-s>) option to choose the size of the output image."
34272 msgstr ""
34273
34274 # type: textblock
34275 #. type: textblock
34276 #: ../tools/virt-make-fs.pl:196
34277 msgid ""
34278 "If this option is I<not> given, then the output image will be just large "
34279 "enough to contain all the files, with not much wasted space."
34280 msgstr ""
34281
34282 # type: textblock
34283 #. type: textblock
34284 #: ../tools/virt-make-fs.pl:199
34285 msgid ""
34286 "To choose a fixed size output disk, specify an absolute number followed by b/"
34287 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34288 "Petabytes or Exabytes.  This must be large enough to contain all the input "
34289 "files, else you will get an error."
34290 msgstr ""
34291
34292 # type: textblock
34293 #. type: textblock
34294 #: ../tools/virt-make-fs.pl:204
34295 msgid ""
34296 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
34297 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34298 "Petabytes or Exabytes.  For example: C<--size=+200M> means enough space for "
34299 "the input files, and (approximately) an extra 200 MB free space."
34300 msgstr ""
34301
34302 # type: textblock
34303 #. type: textblock
34304 #: ../tools/virt-make-fs.pl:210
34305 msgid ""
34306 "Note that virt-make-fs estimates free space, and therefore will not produce "
34307 "filesystems containing precisely the free space requested.  (It is much more "
34308 "expensive and time-consuming to produce a filesystem which has precisely the "
34309 "desired free space)."
34310 msgstr ""
34311
34312 # type: =item
34313 #. type: =item
34314 #: ../tools/virt-make-fs.pl:219
34315 msgid "B<--format=E<lt>fmtE<gt>>"
34316 msgstr ""
34317
34318 # type: =item
34319 #. type: =item
34320 #: ../tools/virt-make-fs.pl:221
34321 msgid "B<-F E<lt>fmtE<gt>>"
34322 msgstr ""
34323
34324 # type: textblock
34325 #. type: textblock
34326 #: ../tools/virt-make-fs.pl:223
34327 msgid "Choose the output disk image format."
34328 msgstr ""
34329
34330 # type: textblock
34331 #. type: textblock
34332 #: ../tools/virt-make-fs.pl:225
34333 msgid "The default is C<raw> (raw disk image)."
34334 msgstr ""
34335
34336 # type: textblock
34337 #. type: textblock
34338 #: ../tools/virt-make-fs.pl:227
34339 msgid ""
34340 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
34341 "that would really make sense here is C<qcow2>."
34342 msgstr ""
34343
34344 # type: =item
34345 #. type: =item
34346 #: ../tools/virt-make-fs.pl:234
34347 msgid "B<--type=E<lt>fsE<gt>>"
34348 msgstr ""
34349
34350 # type: =item
34351 #. type: =item
34352 #: ../tools/virt-make-fs.pl:236
34353 msgid "B<-t E<lt>fsE<gt>>"
34354 msgstr ""
34355
34356 # type: textblock
34357 #. type: textblock
34358 #: ../tools/virt-make-fs.pl:238
34359 msgid "Choose the output filesystem type."
34360 msgstr ""
34361
34362 # type: textblock
34363 #. type: textblock
34364 #: ../tools/virt-make-fs.pl:240
34365 msgid "The default is C<ext2>."
34366 msgstr ""
34367
34368 # type: textblock
34369 #. type: textblock
34370 #: ../tools/virt-make-fs.pl:242
34371 msgid ""
34372 "Any filesystem which is supported read-write by libguestfs can be used here."
34373 msgstr ""
34374
34375 # type: =item
34376 #. type: =item
34377 #: ../tools/virt-make-fs.pl:249
34378 msgid "B<--partition>"
34379 msgstr ""
34380
34381 # type: =item
34382 #. type: =item
34383 #: ../tools/virt-make-fs.pl:251
34384 msgid "B<--partition=E<lt>parttypeE<gt>>"
34385 msgstr ""
34386
34387 # type: textblock
34388 #. type: textblock
34389 #: ../tools/virt-make-fs.pl:253
34390 msgid ""
34391 "If specified, this flag adds an MBR partition table to the output disk image."
34392 msgstr ""
34393
34394 # type: textblock
34395 #. type: textblock
34396 #: ../tools/virt-make-fs.pl:256
34397 msgid ""
34398 "You can change the partition table type, eg. C<--partition=gpt> for large "
34399 "disks."
34400 msgstr ""
34401
34402 # type: textblock
34403 #. type: textblock
34404 #: ../tools/virt-make-fs.pl:259
34405 msgid ""
34406 "Note that if you just use a lonesome C<--partition>, the Perl option parser "
34407 "might consider the next parameter to be the partition type.  For example:"
34408 msgstr ""
34409
34410 # type: verbatim
34411 #. type: verbatim
34412 #: ../tools/virt-make-fs.pl:263
34413 #, no-wrap
34414 msgid ""
34415 " virt-make-fs --partition input.tar ...\n"
34416 "\n"
34417 msgstr ""
34418
34419 # type: textblock
34420 #. type: textblock
34421 #: ../tools/virt-make-fs.pl:265
34422 msgid ""
34423 "would cause virt-make-fs to think you wanted to use a partition type of "
34424 "C<input.tar> which is completely wrong.  To avoid this, use C<--> (a double "
34425 "dash) between options and the input file argument:"
34426 msgstr ""
34427
34428 # type: verbatim
34429 #. type: verbatim
34430 #: ../tools/virt-make-fs.pl:269
34431 #, no-wrap
34432 msgid ""
34433 " virt-make-fs --partition -- input.tar ...\n"
34434 "\n"
34435 msgstr ""
34436
34437 #. type: textblock
34438 #: ../tools/virt-make-fs.pl:541
34439 msgid ""
34440 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
34441 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
34442 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
34443 msgstr ""
34444
34445 # type: verbatim
34446 #. type: verbatim
34447 #: ../tools/virt-make-fs.pl:558
34448 #, no-wrap
34449 msgid ""
34450 " export LIBGUESTFS_DEBUG=1\n"
34451 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
34452 "\n"
34453 msgstr ""
34454
34455 # type: textblock
34456 #. type: textblock
34457 #: ../tools/virt-make-fs.pl:561
34458 msgid ""
34459 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
34460 "redhat.com/>"
34461 msgstr ""
34462
34463 # type: textblock
34464 #. type: textblock
34465 #: ../tools/virt-list-partitions.pl:32
34466 msgid ""
34467 "virt-list-partitions - List partitions in a virtual machine or disk image"
34468 msgstr ""
34469
34470 # type: verbatim
34471 #. type: verbatim
34472 #: ../tools/virt-list-partitions.pl:36
34473 #, no-wrap
34474 msgid ""
34475 " virt-list-partitions [--options] domname\n"
34476 "\n"
34477 msgstr ""
34478
34479 # type: verbatim
34480 #. type: verbatim
34481 #: ../tools/virt-list-partitions.pl:38
34482 #, no-wrap
34483 msgid ""
34484 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
34485 "\n"
34486 msgstr ""
34487
34488 # type: textblock
34489 #. type: textblock
34490 #: ../tools/virt-list-partitions.pl:45
34491 msgid ""
34492 "C<virt-list-partitions> is a command line tool to list the partitions that "
34493 "are contained in a virtual machine or disk image.  It is mainly useful as a "
34494 "first step to using L<virt-resize(1)>."
34495 msgstr ""
34496
34497 # type: textblock
34498 #. type: textblock
34499 #: ../tools/virt-list-partitions.pl:50
34500 msgid ""
34501 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
34502 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34503 "> tool."
34504 msgstr ""
34505
34506 # type: =item
34507 #. type: =item
34508 #: ../tools/virt-list-partitions.pl:107
34509 msgid "B<-h> | B<--human-readable>"
34510 msgstr ""
34511
34512 # type: textblock
34513 #. type: textblock
34514 #: ../tools/virt-list-partitions.pl:109
34515 msgid "Show sizes in human-readable form (eg. \"1G\")."
34516 msgstr ""
34517
34518 # type: textblock
34519 #. type: textblock
34520 #: ../tools/virt-list-partitions.pl:117
34521 msgid ""
34522 "With this option, C<virt-list-partitions> displays the type and size of each "
34523 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
34524 msgstr ""
34525
34526 # type: =item
34527 #. type: =item
34528 #: ../tools/virt-list-partitions.pl:124
34529 msgid "B<-t> | B<--total>"
34530 msgstr ""
34531
34532 # type: textblock
34533 #. type: textblock
34534 #: ../tools/virt-list-partitions.pl:126
34535 msgid ""
34536 "Display the total size of each block device (as a separate row or rows)."
34537 msgstr ""
34538
34539 # type: textblock
34540 #. type: textblock
34541 #: ../tools/virt-list-partitions.pl:259
34542 msgid ""
34543 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
34544 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
34545 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34546 msgstr ""
34547
34548 # type: textblock
34549 #. type: textblock
34550 #: ../tools/virt-list-partitions.pl:275
34551 msgid "Copyright (C) 2009-2010 Red Hat Inc."
34552 msgstr ""