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-02-06 17:14+0000\n"
  11 "PO-Revision-Date: 2010-09-02 14:46+0100\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 # type: =head1
  20 #. type: =head1
  21 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3
  22 #: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3
  23 #: ../tools/virt-edit.pl:32 ../tools/virt-win-reg.pl:35
  24 #: ../tools/virt-resize.pl:40 ../tools/virt-list-filesystems.pl:30
  25 #: ../tools/virt-tar.pl:31 ../tools/virt-make-fs.pl:35
  26 #: ../tools/virt-list-partitions.pl:30
  27 msgid "NAME"
  28 msgstr "名前"
  29
  30 # type: textblock
  31 #. type: textblock
  32 #: ../src/guestfs.pod:5
  33 msgid "guestfs - Library for accessing and modifying virtual machine images"
  34 msgstr ""
  35
  36 # type: =head1
  37 #. type: =head1
  38 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7
  39 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7
  40 #: ../tools/virt-edit.pl:36 ../tools/virt-win-reg.pl:39
  41 #: ../tools/virt-resize.pl:44 ../tools/virt-list-filesystems.pl:34
  42 #: ../tools/virt-tar.pl:35 ../tools/virt-make-fs.pl:39
  43 #: ../tools/virt-list-partitions.pl:34
  44 msgid "SYNOPSIS"
  45 msgstr ""
  46
  47 # type: verbatim
  48 #. type: verbatim
  49 #: ../src/guestfs.pod:9
  50 #, no-wrap
  51 msgid ""
  52 " #include <guestfs.h>\n"
  53 " \n"
  54 msgstr ""
  55
  56 # type: verbatim
  57 #. type: verbatim
  58 #: ../src/guestfs.pod:11
  59 #, no-wrap
  60 msgid ""
  61 " guestfs_h *g = guestfs_create ();\n"
  62 " guestfs_add_drive (g, \"guest.img\");\n"
  63 " guestfs_launch (g);\n"
  64 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
  65 " guestfs_touch (g, \"/hello\");\n"
  66 " guestfs_umount (g, \"/\");\n"
  67 " guestfs_close (g);\n"
  68 "\n"
  69 msgstr ""
  70
  71 # type: verbatim
  72 #. type: verbatim
  73 #: ../src/guestfs.pod:19
  74 #, no-wrap
  75 msgid ""
  76 " cc prog.c -o prog -lguestfs\n"
  77 "or:\n"
  78 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
  79 "\n"
  80 msgstr ""
  81
  82 # type: =head1
  83 #. type: =head1
  84 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
  85 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
  86 #: ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63
  87 #: ../tools/virt-resize.pl:50 ../tools/virt-list-filesystems.pl:40
  88 #: ../tools/virt-tar.pl:77 ../tools/virt-make-fs.pl:47
  89 #: ../tools/virt-list-partitions.pl:40
  90 msgid "DESCRIPTION"
  91 msgstr ""
  92
  93 # type: textblock
  94 #. type: textblock
  95 #: ../src/guestfs.pod:25
  96 msgid ""
  97 "Libguestfs is a library for accessing and modifying guest disk images.  "
  98 "Amongst the things this is good for: making batch configuration changes to "
  99 "guests, getting disk used/free statistics (see also: virt-df), migrating "
 100 "between virtualization systems (see also: virt-p2v), performing partial "
 101 "backups, performing partial guest clones, cloning guests and changing "
 102 "registry/UUID/hostname info, and much else besides."
 103 msgstr ""
 104
 105 # type: textblock
 106 #. type: textblock
 107 #: ../src/guestfs.pod:33
 108 msgid ""
 109 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
 110 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
 111 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
 112 "qcow2, vmdk."
 113 msgstr ""
 114
 115 # type: textblock
 116 #. type: textblock
 117 #: ../src/guestfs.pod:38
 118 msgid ""
 119 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
 120 "what filesystem is in each LV, etc.).  It can also run commands in the "
 121 "context of the guest.  Also you can access filesystems over FUSE."
 122 msgstr ""
 123
 124 # type: textblock
 125 #. type: textblock
 126 #: ../src/guestfs.pod:43
 127 msgid ""
 128 "Libguestfs is a library that can be linked with C and C++ management "
 129 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
 130 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
 131 "line."
 132 msgstr ""
 133
 134 # type: textblock
 135 #. type: textblock
 136 #: ../src/guestfs.pod:48
 137 msgid ""
 138 "You don't need to be root to use libguestfs, although obviously you do need "
 139 "enough permissions to access the disk images."
 140 msgstr ""
 141
 142 # type: textblock
 143 #. type: textblock
 144 #: ../src/guestfs.pod:51
 145 msgid ""
 146 "Libguestfs is a large API because it can do many things.  For a gentle "
 147 "introduction, please read the L</API OVERVIEW> section next."
 148 msgstr ""
 149
 150 # type: textblock
 151 #. type: textblock
 152 #: ../src/guestfs.pod:54
 153 msgid ""
 154 "There are also some example programs in the L<guestfs-examples(3)> manual "
 155 "page."
 156 msgstr ""
 157
 158 # type: =head1
 159 #. type: =head1
 160 #: ../src/guestfs.pod:57
 161 msgid "API OVERVIEW"
 162 msgstr ""
 163
 164 # type: textblock
 165 #. type: textblock
 166 #: ../src/guestfs.pod:59
 167 msgid ""
 168 "This section provides a gentler overview of the libguestfs API.  We also try "
 169 "to group API calls together, where that may not be obvious from reading "
 170 "about the individual calls in the main section of this manual."
 171 msgstr ""
 172
 173 # type: =head2
 174 #. type: =head2
 175 #: ../src/guestfs.pod:64
 176 msgid "HANDLES"
 177 msgstr ""
 178
 179 # type: textblock
 180 #. type: textblock
 181 #: ../src/guestfs.pod:66
 182 msgid ""
 183 "Before you can use libguestfs calls, you have to create a handle.  Then you "
 184 "must add at least one disk image to the handle, followed by launching the "
 185 "handle, then performing whatever operations you want, and finally closing "
 186 "the handle.  By convention we use the single letter C<g> for the name of the "
 187 "handle variable, although of course you can use any name you want."
 188 msgstr ""
 189
 190 # type: textblock
 191 #. type: textblock
 192 #: ../src/guestfs.pod:73
 193 msgid "The general structure of all libguestfs-using programs looks like this:"
 194 msgstr ""
 195
 196 # type: verbatim
 197 #. type: verbatim
 198 #: ../src/guestfs.pod:76
 199 #, no-wrap
 200 msgid ""
 201 " guestfs_h *g = guestfs_create ();\n"
 202 " \n"
 203 msgstr ""
 204
 205 # type: verbatim
 206 #. type: verbatim
 207 #: ../src/guestfs.pod:78
 208 #, no-wrap
 209 msgid ""
 210 " /* Call guestfs_add_drive additional times if there are\n"
 211 "  * multiple disk images.\n"
 212 "  */\n"
 213 " guestfs_add_drive (g, \"guest.img\");\n"
 214 " \n"
 215 msgstr ""
 216
 217 # type: verbatim
 218 #. type: verbatim
 219 #: ../src/guestfs.pod:83
 220 #, no-wrap
 221 msgid ""
 222 " /* Most manipulation calls won't work until you've launched\n"
 223 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
 224 "  * and _before_ other commands.\n"
 225 "  */\n"
 226 " guestfs_launch (g);\n"
 227 " \n"
 228 msgstr ""
 229
 230 # type: verbatim
 231 #. type: verbatim
 232 #: ../src/guestfs.pod:89
 233 #, no-wrap
 234 msgid ""
 235 " /* Now you can examine what partitions, LVs etc are available.\n"
 236 "  */\n"
 237 " char **partitions = guestfs_list_partitions (g);\n"
 238 " char **logvols = guestfs_lvs (g);\n"
 239 " \n"
 240 msgstr ""
 241
 242 # type: verbatim
 243 #. type: verbatim
 244 #: ../src/guestfs.pod:94
 245 #, no-wrap
 246 msgid ""
 247 " /* To access a filesystem in the image, you must mount it.\n"
 248 "  */\n"
 249 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
 250 " \n"
 251 msgstr ""
 252
 253 # type: verbatim
 254 #. type: verbatim
 255 #: ../src/guestfs.pod:98
 256 #, no-wrap
 257 msgid ""
 258 " /* Now you can perform filesystem actions on the guest\n"
 259 "  * disk image.\n"
 260 "  */\n"
 261 " guestfs_touch (g, \"/hello\");\n"
 262 "\n"
 263 msgstr ""
 264
 265 # type: verbatim
 266 #. type: verbatim
 267 #: ../src/guestfs.pod:103
 268 #, no-wrap
 269 msgid ""
 270 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
 271 "  * it is done automatically when you close the handle.  See\n"
 272 "  * discussion of autosync in this page.\n"
 273 "  */\n"
 274 " guestfs_sync (g);\n"
 275 " \n"
 276 msgstr ""
 277
 278 # type: verbatim
 279 #. type: verbatim
 280 #: ../src/guestfs.pod:109
 281 #, no-wrap
 282 msgid ""
 283 " /* Close the handle 'g'. */\n"
 284 " guestfs_close (g);\n"
 285 "\n"
 286 msgstr ""
 287
 288 # type: textblock
 289 #. type: textblock
 290 #: ../src/guestfs.pod:112
 291 msgid ""
 292 "The code above doesn't include any error checking.  In real code you should "
 293 "check return values carefully for errors.  In general all functions that "
 294 "return integers return C<-1> on error, and all functions that return "
 295 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
 296 "how to handle errors, and consult the documentation for each function call "
 297 "below to see precisely how they return error indications.  See L<guestfs-"
 298 "examples(3)> for fully worked examples."
 299 msgstr ""
 300
 301 # type: =head2
 302 #. type: =head2
 303 #: ../src/guestfs.pod:121
 304 msgid "DISK IMAGES"
 305 msgstr ""
 306
 307 # type: textblock
 308 #. type: textblock
 309 #: ../src/guestfs.pod:123
 310 msgid ""
 311 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
 312 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
 313 "actual block device, or simply an empty file of zeroes that you have created "
 314 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
 315 "of these."
 316 msgstr ""
 317
 318 # type: textblock
 319 #. type: textblock
 320 #: ../src/guestfs.pod:129
 321 msgid ""
 322 "The call you should use in modern code for adding drives is L</"
 323 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
 324 "specifying that the format is raw, do:"
 325 msgstr ""
 326
 327 # type: verbatim
 328 #. type: verbatim
 329 #: ../src/guestfs.pod:133
 330 #, no-wrap
 331 msgid ""
 332 " guestfs_add_drive_opts (g, filename,\n"
 333 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 334 "                         -1);\n"
 335 "\n"
 336 msgstr ""
 337
 338 # type: textblock
 339 #. type: textblock
 340 #: ../src/guestfs.pod:137
 341 msgid "You can add a disk read-only using:"
 342 msgstr ""
 343
 344 # type: verbatim
 345 #. type: verbatim
 346 #: ../src/guestfs.pod:139
 347 #, no-wrap
 348 msgid ""
 349 " guestfs_add_drive_opts (g, filename,\n"
 350 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 351 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
 352 "                         -1);\n"
 353 "\n"
 354 msgstr ""
 355
 356 # type: textblock
 357 #. type: textblock
 358 #: ../src/guestfs.pod:144
 359 msgid ""
 360 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
 361 "libguestfs won't modify the file."
 362 msgstr ""
 363
 364 # type: textblock
 365 #. type: textblock
 366 #: ../src/guestfs.pod:147
 367 msgid ""
 368 "Be extremely cautious if the disk image is in use, eg. if it is being used "
 369 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
 370 "corruption, but adding it read-only is safe."
 371 msgstr ""
 372
 373 # type: textblock
 374 #. type: textblock
 375 #: ../src/guestfs.pod:151
 376 msgid ""
 377 "You must add at least one disk image, and you may add multiple disk images.  "
 378 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
 379 "first one you added), C</dev/sdb> (for the second one you added), etc."
 380 msgstr ""
 381
 382 # type: textblock
 383 #. type: textblock
 384 #: ../src/guestfs.pod:156
 385 msgid ""
 386 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
 387 "can call L</guestfs_list_devices> to get a list of the device names, in the "
 388 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
 389 msgstr ""
 390
 391 # type: =head2
 392 #. type: =head2
 393 #: ../src/guestfs.pod:161
 394 msgid "MOUNTING"
 395 msgstr ""
 396
 397 #. type: textblock
 398 #: ../src/guestfs.pod:163
 399 msgid ""
 400 "Before you can read or write files, create directories and so on in a disk "
 401 "image that contains filesystems, you have to mount those filesystems using "
 402 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
 403 "a disk image contains (for example) one partition with a filesystem on that "
 404 "partition, then you can mount it directly:"
 405 msgstr ""
 406
 407 #. type: verbatim
 408 #: ../src/guestfs.pod:170
 409 #, no-wrap
 410 msgid ""
 411 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
 412 "\n"
 413 msgstr ""
 414
 415 #. type: textblock
 416 #: ../src/guestfs.pod:172
 417 msgid ""
 418 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
 419 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
 420 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
 421 "that these are libguestfs virtual devices, and are nothing to do with host "
 422 "devices."
 423 msgstr ""
 424
 425 #. type: textblock
 426 #: ../src/guestfs.pod:178
 427 msgid ""
 428 "If you are given a disk image and you don't know what it contains then you "
 429 "have to find out.  Libguestfs can do that too: use L</"
 430 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
 431 "LVs, and either try mounting each to see what is mountable, or else examine "
 432 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
 433 "filesystems, use L</guestfs_list_filesystems>."
 434 msgstr ""
 435
 436 #. type: textblock
 437 #: ../src/guestfs.pod:186
 438 msgid ""
 439 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
 440 "L</INSPECTION> below).  But you might find it easier to look at higher level "
 441 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
 442 msgstr ""
 443
 444 #. type: textblock
 445 #: ../src/guestfs.pod:191
 446 msgid ""
 447 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
 448 "several other variations of the C<guestfs_mount_*> call."
 449 msgstr ""
 450
 451 # type: =head2
 452 #. type: =head2
 453 #: ../src/guestfs.pod:194
 454 msgid "FILESYSTEM ACCESS AND MODIFICATION"
 455 msgstr ""
 456
 457 # type: textblock
 458 #. type: textblock
 459 #: ../src/guestfs.pod:196
 460 msgid ""
 461 "The majority of the libguestfs API consists of fairly low-level calls for "
 462 "accessing and modifying the files, directories, symlinks etc on mounted "
 463 "filesystems.  There are over a hundred such calls which you can find listed "
 464 "in detail below in this man page, and we don't even pretend to cover them "
 465 "all in this overview."
 466 msgstr ""
 467
 468 # type: textblock
 469 #. type: textblock
 470 #: ../src/guestfs.pod:202
 471 msgid ""
 472 "Specify filenames as full paths, starting with C<\"/\"> and including the "
 473 "mount point."
 474 msgstr ""
 475
 476 # type: textblock
 477 #. type: textblock
 478 #: ../src/guestfs.pod:205
 479 msgid ""
 480 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
 481 "the file called C<\"etc/passwd\"> then you could do:"
 482 msgstr ""
 483
 484 # type: verbatim
 485 #. type: verbatim
 486 #: ../src/guestfs.pod:208
 487 #, no-wrap
 488 msgid ""
 489 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
 490 "\n"
 491 msgstr ""
 492
 493 # type: textblock
 494 #. type: textblock
 495 #: ../src/guestfs.pod:210
 496 msgid ""
 497 "This would return C<data> as a newly allocated buffer containing the full "
 498 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
 499 "or C<NULL> if there was an error."
 500 msgstr ""
 501
 502 # type: textblock
 503 #. type: textblock
 504 #: ../src/guestfs.pod:214
 505 msgid ""
 506 "As another example, to create a top-level directory on that filesystem "
 507 "called C<\"var\"> you would do:"
 508 msgstr ""
 509
 510 # type: verbatim
 511 #. type: verbatim
 512 #: ../src/guestfs.pod:217
 513 #, no-wrap
 514 msgid ""
 515 " guestfs_mkdir (g, \"/var\");\n"
 516 "\n"
 517 msgstr ""
 518
 519 # type: textblock
 520 #. type: textblock
 521 #: ../src/guestfs.pod:219
 522 msgid "To create a symlink you could do:"
 523 msgstr ""
 524
 525 # type: verbatim
 526 #. type: verbatim
 527 #: ../src/guestfs.pod:221
 528 #, no-wrap
 529 msgid ""
 530 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
 531 "               \"/etc/rc3.d/S30portmap\");\n"
 532 "\n"
 533 msgstr ""
 534
 535 # type: textblock
 536 #. type: textblock
 537 #: ../src/guestfs.pod:224
 538 msgid ""
 539 "Libguestfs will reject attempts to use relative paths and there is no "
 540 "concept of a current working directory."
 541 msgstr ""
 542
 543 # type: textblock
 544 #. type: textblock
 545 #: ../src/guestfs.pod:227
 546 msgid ""
 547 "Libguestfs can return errors in many situations: for example if the "
 548 "filesystem isn't writable, or if a file or directory that you requested "
 549 "doesn't exist.  If you are using the C API (documented here)  you have to "
 550 "check for those error conditions after each call.  (Other language bindings "
 551 "turn these errors into exceptions)."
 552 msgstr ""
 553
 554 # type: textblock
 555 #. type: textblock
 556 #: ../src/guestfs.pod:233
 557 msgid ""
 558 "File writes are affected by the per-handle umask, set by calling L</"
 559 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
 560 msgstr ""
 561
 562 # type: =head2
 563 #. type: =head2
 564 #: ../src/guestfs.pod:236
 565 msgid "PARTITIONING"
 566 msgstr ""
 567
 568 # type: textblock
 569 #. type: textblock
 570 #: ../src/guestfs.pod:238
 571 msgid ""
 572 "Libguestfs contains API calls to read, create and modify partition tables on "
 573 "disk images."
 574 msgstr ""
 575
 576 # type: textblock
 577 #. type: textblock
 578 #: ../src/guestfs.pod:241
 579 msgid ""
 580 "In the common case where you want to create a single partition covering the "
 581 "whole disk, you should use the L</guestfs_part_disk> call:"
 582 msgstr ""
 583
 584 # type: verbatim
 585 #. type: verbatim
 586 #: ../src/guestfs.pod:245
 587 #, no-wrap
 588 msgid ""
 589 " const char *parttype = \"mbr\";\n"
 590 " if (disk_is_larger_than_2TB)\n"
 591 "   parttype = \"gpt\";\n"
 592 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
 593 "\n"
 594 msgstr ""
 595
 596 # type: textblock
 597 #. type: textblock
 598 #: ../src/guestfs.pod:250
 599 msgid ""
 600 "Obviously this effectively wipes anything that was on that disk image before."
 601 msgstr ""
 602
 603 # type: =head2
 604 #. type: =head2
 605 #: ../src/guestfs.pod:253
 606 msgid "LVM2"
 607 msgstr ""
 608
 609 # type: textblock
 610 #. type: textblock
 611 #: ../src/guestfs.pod:255
 612 msgid ""
 613 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
 614 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
 615 "you familiarize yourself with the concepts of physical volumes, volume "
 616 "groups and logical volumes."
 617 msgstr ""
 618
 619 # type: textblock
 620 #. type: textblock
 621 #: ../src/guestfs.pod:260
 622 msgid ""
 623 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
 624 "tldp.org/HOWTO/LVM-HOWTO/>."
 625 msgstr ""
 626
 627 # type: =head2
 628 #. type: =head2
 629 #: ../src/guestfs.pod:263
 630 msgid "DOWNLOADING"
 631 msgstr ""
 632
 633 #. type: textblock
 634 #: ../src/guestfs.pod:265
 635 msgid ""
 636 "Use L</guestfs_cat> to download small, text only files.  This call is "
 637 "limited to files which are less than 2 MB and which cannot contain any ASCII "
 638 "NUL (C<\\0>) characters.  However the API is very simple to use."
 639 msgstr ""
 640
 641 # type: textblock
 642 #. type: textblock
 643 #: ../src/guestfs.pod:269
 644 msgid ""
 645 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
 646 "bit data, since it returns a (pointer, size) pair.  However it is still "
 647 "limited to \"small\" files, less than 2 MB."
 648 msgstr ""
 649
 650 # type: textblock
 651 #. type: textblock
 652 #: ../src/guestfs.pod:273
 653 msgid ""
 654 "L</guestfs_download> can be used to download any file, with no limits on "
 655 "content or size (even files larger than 4 GB)."
 656 msgstr ""
 657
 658 # type: textblock
 659 #. type: textblock
 660 #: ../src/guestfs.pod:276
 661 msgid ""
 662 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
 663 msgstr ""
 664
 665 # type: =head2
 666 #. type: =head2
 667 #: ../src/guestfs.pod:279
 668 msgid "UPLOADING"
 669 msgstr ""
 670
 671 # type: textblock
 672 #. type: textblock
 673 #: ../src/guestfs.pod:281
 674 msgid ""
 675 "It's often the case that you want to write a file or files to the disk image."
 676 msgstr ""
 677
 678 # type: textblock
 679 #. type: textblock
 680 #: ../src/guestfs.pod:284
 681 msgid ""
 682 "To write a small file with fixed content, use L</guestfs_write>.  To create "
 683 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
 684 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
 685 "of other functions for creating test files, for example L</guestfs_fill> and "
 686 "L</guestfs_fill_pattern>."
 687 msgstr ""
 688
 689 # type: textblock
 690 #. type: textblock
 691 #: ../src/guestfs.pod:290
 692 msgid ""
 693 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
 694 "file content or size (even files larger than 4 GB)."
 695 msgstr ""
 696
 697 # type: textblock
 698 #. type: textblock
 699 #: ../src/guestfs.pod:293
 700 msgid ""
 701 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
 702 msgstr ""
 703
 704 # type: textblock
 705 #. type: textblock
 706 #: ../src/guestfs.pod:295
 707 msgid ""
 708 "However the fastest way to upload I<large numbers of arbitrary files> is to "
 709 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
 710 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
 711 "in a predictable way (eg. adding it last after all other drives) then you "
 712 "can get the device name from L</guestfs_list_devices> and mount it directly "
 713 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
 714 "portable between kernel versions, and they don't support labels or UUIDs.  "
 715 "If you want to pre-build an image or you need to mount it using a label or "
 716 "UUID, use an ISO image instead."
 717 msgstr ""
 718
 719 # type: =head2
 720 #. type: =head2
 721 #: ../src/guestfs.pod:306
 722 msgid "COPYING"
 723 msgstr ""
 724
 725 # type: textblock
 726 #. type: textblock
 727 #: ../src/guestfs.pod:308
 728 msgid ""
 729 "There are various different commands for copying between files and devices "
 730 "and in and out of the guest filesystem.  These are summarised in the table "
 731 "below."
 732 msgstr ""
 733
 734 # type: =item
 735 #. type: =item
 736 #: ../src/guestfs.pod:314
 737 msgid "B<file> to B<file>"
 738 msgstr ""
 739
 740 # type: textblock
 741 #. type: textblock
 742 #: ../src/guestfs.pod:316
 743 msgid ""
 744 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
 745 "directories recursively."
 746 msgstr ""
 747
 748 # type: =item
 749 #. type: =item
 750 #: ../src/guestfs.pod:319
 751 msgid "B<file or device> to B<file or device>"
 752 msgstr ""
 753
 754 # type: textblock
 755 #. type: textblock
 756 #: ../src/guestfs.pod:321
 757 msgid ""
 758 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
 759 "devices in the guest."
 760 msgstr ""
 761
 762 # type: textblock
 763 #. type: textblock
 764 #: ../src/guestfs.pod:324
 765 msgid "Example: duplicate the contents of an LV:"
 766 msgstr ""
 767
 768 # type: verbatim
 769 #. type: verbatim
 770 #: ../src/guestfs.pod:326
 771 #, no-wrap
 772 msgid ""
 773 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
 774 "\n"
 775 msgstr ""
 776
 777 # type: textblock
 778 #. type: textblock
 779 #: ../src/guestfs.pod:328
 780 msgid ""
 781 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
 782 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
 783 "guestfs_copy_size>."
 784 msgstr ""
 785
 786 # type: =item
 787 #. type: =item
 788 #: ../src/guestfs.pod:332
 789 msgid "B<file on the host> to B<file or device>"
 790 msgstr ""
 791
 792 # type: textblock
 793 #. type: textblock
 794 #: ../src/guestfs.pod:334
 795 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
 796 msgstr ""
 797
 798 # type: =item
 799 #. type: =item
 800 #: ../src/guestfs.pod:336
 801 msgid "B<file or device> to B<file on the host>"
 802 msgstr ""
 803
 804 # type: textblock
 805 #. type: textblock
 806 #: ../src/guestfs.pod:338
 807 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
 808 msgstr ""
 809
 810 # type: =head2
 811 #. type: =head2
 812 #: ../src/guestfs.pod:342
 813 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
 814 msgstr ""
 815
 816 # type: textblock
 817 #. type: textblock
 818 #: ../src/guestfs.pod:344
 819 msgid ""
 820 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
 821 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
 822 "appears you can only upload and download to files.  However many Un*x-like "
 823 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
 824 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
 825 "and arbitrary file descriptor N."
 826 msgstr ""
 827
 828 # type: textblock
 829 #. type: textblock
 830 #: ../src/guestfs.pod:352
 831 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
 832 msgstr ""
 833
 834 #. type: verbatim
 835 #: ../src/guestfs.pod:355
 836 #, no-wrap
 837 msgid ""
 838 " guestfs_download (g, filename, \"/dev/stdout\");\n"
 839 "\n"
 840 msgstr ""
 841
 842 # type: textblock
 843 #. type: textblock
 844 #: ../src/guestfs.pod:357
 845 msgid "and you can write tar output to a pipe C<fd> by doing:"
 846 msgstr ""
 847
 848 #. type: verbatim
 849 #: ../src/guestfs.pod:359
 850 #, no-wrap
 851 msgid ""
 852 " char devfd[64];\n"
 853 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
 854 " guestfs_tar_out (g, \"/\", devfd);\n"
 855 "\n"
 856 msgstr ""
 857
 858 # type: =head2
 859 #. type: =head2
 860 #: ../src/guestfs.pod:363
 861 msgid "LISTING FILES"
 862 msgstr ""
 863
 864 # type: textblock
 865 #. type: textblock
 866 #: ../src/guestfs.pod:365
 867 msgid ""
 868 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
 869 "L<guestfish(1)>-equivalent command C<ll>)."
 870 msgstr ""
 871
 872 # type: textblock
 873 #. type: textblock
 874 #: ../src/guestfs.pod:368
 875 msgid ""
 876 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
 877 "programs, as a flat list of strings."
 878 msgstr ""
 879
 880 # type: textblock
 881 #. type: textblock
 882 #: ../src/guestfs.pod:371
 883 msgid ""
 884 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
 885 "directory, plus additional information about each one.  It is more "
 886 "equivalent to using the L<readdir(3)> call on a local filesystem."
 887 msgstr ""
 888
 889 # type: textblock
 890 #. type: textblock
 891 #: ../src/guestfs.pod:375
 892 msgid ""
 893 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
 894 msgstr ""
 895
 896 # type: =head2
 897 #. type: =head2
 898 #: ../src/guestfs.pod:378
 899 msgid "RUNNING COMMANDS"
 900 msgstr ""
 901
 902 # type: textblock
 903 #. type: textblock
 904 #: ../src/guestfs.pod:380
 905 msgid ""
 906 "Although libguestfs is primarily an API for manipulating files inside guest "
 907 "images, we also provide some limited facilities for running commands inside "
 908 "guests."
 909 msgstr ""
 910
 911 # type: textblock
 912 #. type: textblock
 913 #: ../src/guestfs.pod:384
 914 msgid "There are many limitations to this:"
 915 msgstr ""
 916
 917 # type: =item
 918 #. type: =item
 919 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
 920 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
 921 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1088
 922 #: ../src/guestfs.pod:1092 ../src/guestfs.pod:1096 ../src/guestfs.pod:1101
 923 #: ../src/guestfs.pod:1109 ../src/guestfs.pod:1128 ../src/guestfs.pod:1136
 924 #: ../src/guestfs.pod:1158 ../src/guestfs.pod:1162 ../src/guestfs.pod:1166
 925 #: ../src/guestfs.pod:1170 ../src/guestfs.pod:1174 ../src/guestfs.pod:1178
 926 #: ../src/guestfs.pod:1660 ../src/guestfs.pod:1665 ../src/guestfs.pod:1669
 927 #: ../src/guestfs.pod:1779 ../src/guestfs.pod:1784 ../src/guestfs.pod:1788
 928 #: ../src/guestfs.pod:2140 ../src/guestfs.pod:2146 ../src/guestfs.pod:2151
 929 #: ../src/guestfs.pod:2157 ../src/guestfs.pod:2622 ../src/guestfs.pod:2626
 930 #: ../src/guestfs.pod:2630 ../src/guestfs.pod:2634
 931 #: ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22
 932 #: ../src/guestfs-actions.pod:577 ../src/guestfs-actions.pod:585
 933 #: ../src/guestfs-actions.pod:592 ../src/guestfs-actions.pod:599
 934 #: ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1599
 935 #: ../src/guestfs-actions.pod:1603 ../src/guestfs-actions.pod:1607
 936 #: ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1619
 937 #: ../src/guestfs-actions.pod:1623 ../src/guestfs-actions.pod:1633
 938 #: ../src/guestfs-actions.pod:1637 ../src/guestfs-actions.pod:1641
 939 #: ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1783
 940 #: ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1793
 941 #: ../src/guestfs-actions.pod:1854 ../src/guestfs-actions.pod:1858
 942 #: ../src/guestfs-actions.pod:1863 ../fish/guestfish.pod:432
 943 #: ../fish/guestfish.pod:436 ../fish/guestfish.pod:440
 944 #: ../fish/guestfish.pod:444 ../fish/guestfish-actions.pod:13
 945 #: ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:380
 946 #: ../fish/guestfish-actions.pod:388 ../fish/guestfish-actions.pod:395
 947 #: ../fish/guestfish-actions.pod:402 ../fish/guestfish-actions.pod:1072
 948 #: ../fish/guestfish-actions.pod:1076 ../fish/guestfish-actions.pod:1080
 949 #: ../fish/guestfish-actions.pod:1084 ../fish/guestfish-actions.pod:1092
 950 #: ../fish/guestfish-actions.pod:1096 ../fish/guestfish-actions.pod:1100
 951 #: ../fish/guestfish-actions.pod:1110 ../fish/guestfish-actions.pod:1114
 952 #: ../fish/guestfish-actions.pod:1118 ../fish/guestfish-actions.pod:1208
 953 #: ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1217
 954 #: ../fish/guestfish-actions.pod:1222 ../fish/guestfish-actions.pod:1264
 955 #: ../fish/guestfish-actions.pod:1268 ../fish/guestfish-actions.pod:1273
 956 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
 957 #: ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345
 958 #: ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360
 959 msgid "*"
 960 msgstr ""
 961
 962 # type: textblock
 963 #. type: textblock
 964 #: ../src/guestfs.pod:390
 965 msgid ""
 966 "The kernel version that the command runs under will be different from what "
 967 "it expects."
 968 msgstr ""
 969
 970 # type: textblock
 971 #. type: textblock
 972 #: ../src/guestfs.pod:395
 973 msgid ""
 974 "If the command needs to communicate with daemons, then most likely they "
 975 "won't be running."
 976 msgstr ""
 977
 978 # type: textblock
 979 #. type: textblock
 980 #: ../src/guestfs.pod:400
 981 msgid "The command will be running in limited memory."
 982 msgstr ""
 983
 984 # type: textblock
 985 #. type: textblock
 986 #: ../src/guestfs.pod:404
 987 msgid ""
 988 "The network may not be available unless you enable it (see L</"
 989 "guestfs_set_network>)."
 990 msgstr ""
 991
 992 # type: textblock
 993 #. type: textblock
 994 #: ../src/guestfs.pod:409
 995 msgid "Only supports Linux guests (not Windows, BSD, etc)."
 996 msgstr ""
 997
 998 # type: textblock
 999 #. type: textblock
1000 #: ../src/guestfs.pod:413
1001 msgid ""
1002 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1003 msgstr ""
1004
1005 # type: textblock
1006 #. type: textblock
1007 #: ../src/guestfs.pod:418
1008 msgid ""
1009 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1010 "See L</SELINUX> in this manpage."
1011 msgstr ""
1012
1013 # type: textblock
1014 #. type: textblock
1015 #: ../src/guestfs.pod:423
1016 msgid ""
1017 "I<Security:> It is not safe to run commands from untrusted, possibly "
1018 "malicious guests.  These commands may attempt to exploit your program by "
1019 "sending unexpected output.  They could also try to exploit the Linux kernel "
1020 "or qemu provided by the libguestfs appliance.  They could use the network "
1021 "provided by the libguestfs appliance to bypass ordinary network partitions "
1022 "and firewalls.  They could use the elevated privileges or different SELinux "
1023 "context of your program to their advantage."
1024 msgstr ""
1025
1026 # type: textblock
1027 #. type: textblock
1028 #: ../src/guestfs.pod:432
1029 msgid ""
1030 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1031 "(a script which runs when the guest next boots normally), and to have this "
1032 "script run the commands you want in the normal context of the running guest, "
1033 "network security and so on.  For information about other security issues, "
1034 "see L</SECURITY>."
1035 msgstr ""
1036
1037 # type: textblock
1038 #. type: textblock
1039 #: ../src/guestfs.pod:440
1040 msgid ""
1041 "The two main API calls to run commands are L</guestfs_command> and L</"
1042 "guestfs_sh> (there are also variations)."
1043 msgstr ""
1044
1045 # type: textblock
1046 #. type: textblock
1047 #: ../src/guestfs.pod:443
1048 msgid ""
1049 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1050 "shell globs, redirections, etc will work."
1051 msgstr ""
1052
1053 # type: =head2
1054 #. type: =head2
1055 #: ../src/guestfs.pod:446
1056 msgid "CONFIGURATION FILES"
1057 msgstr ""
1058
1059 # type: textblock
1060 #. type: textblock
1061 #: ../src/guestfs.pod:448
1062 msgid ""
1063 "To read and write configuration files in Linux guest filesystems, we "
1064 "strongly recommend using Augeas.  For example, Augeas understands how to "
1065 "read and write, say, a Linux shadow password file or X.org configuration "
1066 "file, and so avoids you having to write that code."
1067 msgstr ""
1068
1069 # type: textblock
1070 #. type: textblock
1071 #: ../src/guestfs.pod:453
1072 msgid ""
1073 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1074 "document Augeas itself here because there is excellent documentation on the "
1075 "L<http://augeas.net/> website."
1076 msgstr ""
1077
1078 # type: textblock
1079 #. type: textblock
1080 #: ../src/guestfs.pod:457
1081 msgid ""
1082 "If you don't want to use Augeas (you fool!) then try calling L</"
1083 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1084 "over."
1085 msgstr ""
1086
1087 # type: =head2
1088 #. type: =head2
1089 #: ../src/guestfs.pod:461
1090 msgid "SELINUX"
1091 msgstr ""
1092
1093 # type: textblock
1094 #. type: textblock
1095 #: ../src/guestfs.pod:463
1096 msgid ""
1097 "We support SELinux guests.  To ensure that labeling happens correctly in "
1098 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1099 msgstr ""
1100
1101 # type: =item
1102 #. type: =item
1103 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1281 ../src/guestfs.pod:1412
1104 #: ../src/guestfs.pod:2185
1105 msgid "1."
1106 msgstr ""
1107
1108 # type: textblock
1109 #. type: textblock
1110 #: ../src/guestfs.pod:471
1111 msgid "Before launching, do:"
1112 msgstr ""
1113
1114 # type: verbatim
1115 #. type: verbatim
1116 #: ../src/guestfs.pod:473
1117 #, no-wrap
1118 msgid ""
1119 " guestfs_set_selinux (g, 1);\n"
1120 "\n"
1121 msgstr ""
1122
1123 # type: =item
1124 #. type: =item
1125 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1285 ../src/guestfs.pod:1416
1126 #: ../src/guestfs.pod:2210
1127 msgid "2."
1128 msgstr ""
1129
1130 # type: textblock
1131 #. type: textblock
1132 #: ../src/guestfs.pod:477
1133 msgid ""
1134 "After mounting the guest's filesystem(s), load the policy.  This is best "
1135 "done by running the L<load_policy(8)> command in the guest itself:"
1136 msgstr ""
1137
1138 # type: verbatim
1139 #. type: verbatim
1140 #: ../src/guestfs.pod:481
1141 #, no-wrap
1142 msgid ""
1143 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1144 "\n"
1145 msgstr ""
1146
1147 # type: textblock
1148 #. type: textblock
1149 #: ../src/guestfs.pod:483
1150 msgid ""
1151 "(Older versions of C<load_policy> require you to specify the name of the "
1152 "policy file)."
1153 msgstr ""
1154
1155 # type: =item
1156 #. type: =item
1157 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1422
1158 msgid "3."
1159 msgstr ""
1160
1161 # type: textblock
1162 #. type: textblock
1163 #: ../src/guestfs.pod:488
1164 msgid ""
1165 "Optionally, set the security context for the API.  The correct security "
1166 "context to use can only be known by inspecting the guest.  As an example:"
1167 msgstr ""
1168
1169 # type: verbatim
1170 #. type: verbatim
1171 #: ../src/guestfs.pod:492
1172 #, no-wrap
1173 msgid ""
1174 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1175 "\n"
1176 msgstr ""
1177
1178 # type: textblock
1179 #. type: textblock
1180 #: ../src/guestfs.pod:496
1181 msgid "This will work for running commands and editing existing files."
1182 msgstr ""
1183
1184 # type: textblock
1185 #. type: textblock
1186 #: ../src/guestfs.pod:498
1187 msgid ""
1188 "When new files are created, you may need to label them explicitly, for "
1189 "example by running the external command C<restorecon pathname>."
1190 msgstr ""
1191
1192 # type: =head2
1193 #. type: =head2
1194 #: ../src/guestfs.pod:502
1195 msgid "UMASK"
1196 msgstr ""
1197
1198 # type: textblock
1199 #. type: textblock
1200 #: ../src/guestfs.pod:504
1201 msgid ""
1202 "Certain calls are affected by the current file mode creation mask (the "
1203 "\"umask\").  In particular ones which create files or directories, such as "
1204 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1205 "either the default mode that the file is created with or modifies the mode "
1206 "that you supply."
1207 msgstr ""
1208
1209 # type: textblock
1210 #. type: textblock
1211 #: ../src/guestfs.pod:510
1212 msgid ""
1213 "The default umask is C<022>, so files are created with modes such as C<0644> "
1214 "and directories with C<0755>."
1215 msgstr ""
1216
1217 # type: textblock
1218 #. type: textblock
1219 #: ../src/guestfs.pod:513
1220 msgid ""
1221 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1222 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1223 "guestfs_chmod> after creating each file or directory."
1224 msgstr ""
1225
1226 # type: textblock
1227 #. type: textblock
1228 #: ../src/guestfs.pod:517
1229 msgid "For more information about umask, see L<umask(2)>."
1230 msgstr ""
1231
1232 # type: =head1
1233 #. type: =head1
1234 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:751
1235 msgid "ENCRYPTED DISKS"
1236 msgstr ""
1237
1238 # type: textblock
1239 #. type: textblock
1240 #: ../src/guestfs.pod:521
1241 msgid ""
1242 "Libguestfs allows you to access Linux guests which have been encrypted using "
1243 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1244 "standard.  This includes nearly all whole disk encryption systems used by "
1245 "modern Linux guests."
1246 msgstr ""
1247
1248 # type: textblock
1249 #. type: textblock
1250 #: ../src/guestfs.pod:527
1251 msgid ""
1252 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1253 "returns the string C<crypto_LUKS>)."
1254 msgstr ""
1255
1256 # type: textblock
1257 #. type: textblock
1258 #: ../src/guestfs.pod:530
1259 msgid ""
1260 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1261 "will require the passphrase!"
1262 msgstr ""
1263
1264 # type: textblock
1265 #. type: textblock
1266 #: ../src/guestfs.pod:533
1267 msgid ""
1268 "Opening a LUKS device creates a new device mapper device called C</dev/"
1269 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1270 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1271 "from and encrypted to the underlying block device respectively."
1272 msgstr ""
1273
1274 # type: textblock
1275 #. type: textblock
1276 #: ../src/guestfs.pod:539
1277 msgid ""
1278 "LVM volume groups on the device can be made visible by calling L</"
1279 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1280 "(s) can now be mounted in the usual way."
1281 msgstr ""
1282
1283 # type: textblock
1284 #. type: textblock
1285 #: ../src/guestfs.pod:543
1286 msgid ""
1287 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1288 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1289 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1290 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1291 "underlying encrypted block device)."
1292 msgstr ""
1293
1294 # type: =head2
1295 #. type: =head2
1296 #: ../src/guestfs.pod:550
1297 msgid "INSPECTION"
1298 msgstr ""
1299
1300 #. type: textblock
1301 #: ../src/guestfs.pod:552
1302 msgid ""
1303 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1304 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1305 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1306 "version 1.5.3 the most frequently used part of this library has been "
1307 "rewritten in C and moved into the core code)."
1308 msgstr ""
1309
1310 # type: textblock
1311 #. type: textblock
1312 #: ../src/guestfs.pod:559
1313 msgid ""
1314 "Add all disks belonging to the unknown virtual machine and call L</"
1315 "guestfs_launch> in the usual way."
1316 msgstr ""
1317
1318 # type: textblock
1319 #. type: textblock
1320 #: ../src/guestfs.pod:562
1321 msgid ""
1322 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1323 "and certain heuristics, and returns a list of operating systems that were "
1324 "found.  An empty list means none were found.  A single element is the root "
1325 "filesystem of the operating system.  For dual- or multi-boot guests, "
1326 "multiple roots can be returned, each one corresponding to a separate "
1327 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1328 "world of virtualization, but since this scenario can happen, we have built "
1329 "libguestfs to deal with it.)"
1330 msgstr ""
1331
1332 # type: textblock
1333 #. type: textblock
1334 #: ../src/guestfs.pod:571
1335 msgid ""
1336 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1337 "to get additional details about that operating system.  For example, call L</"
1338 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1339 "Windows and Linux-based operating systems respectively."
1340 msgstr ""
1341
1342 # type: textblock
1343 #. type: textblock
1344 #: ../src/guestfs.pod:577
1345 msgid ""
1346 "Un*x-like and Linux-based operating systems usually consist of several "
1347 "filesystems which are mounted at boot time (for example, a separate boot "
1348 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1349 "filesystems correspond to mount points.  Call "
1350 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1351 "hash table like this example:"
1352 msgstr ""
1353
1354 # type: verbatim
1355 #. type: verbatim
1356 #: ../src/guestfs.pod:584
1357 #, no-wrap
1358 msgid ""
1359 " /boot => /dev/sda1\n"
1360 " /     => /dev/vg_guest/lv_root\n"
1361 " /usr  => /dev/vg_guest/lv_usr\n"
1362 "\n"
1363 msgstr ""
1364
1365 # type: textblock
1366 #. type: textblock
1367 #: ../src/guestfs.pod:588
1368 msgid ""
1369 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1370 "filesystems as suggested."
1371 msgstr ""
1372
1373 # type: textblock
1374 #. type: textblock
1375 #: ../src/guestfs.pod:591
1376 msgid ""
1377 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1378 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1379 msgstr ""
1380
1381 # type: textblock
1382 #. type: textblock
1383 #: ../src/guestfs.pod:595
1384 msgid ""
1385 "Inspection currently only works for some common operating systems.  "
1386 "Contributors are welcome to send patches for other operating systems that we "
1387 "currently cannot detect."
1388 msgstr ""
1389
1390 # type: textblock
1391 #. type: textblock
1392 #: ../src/guestfs.pod:599
1393 msgid ""
1394 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1395 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1396 "encrypted devices."
1397 msgstr ""
1398
1399 # type: textblock
1400 #. type: textblock
1401 #: ../src/guestfs.pod:603
1402 msgid ""
1403 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1404 "inspection and caches the results in the guest handle.  Subsequent calls to "
1405 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1406 "read the disks.  If you change the content of the guest disks, you can redo "
1407 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1408 "guestfs_inspect_list_applications> works a little differently from the other "
1409 "calls and does read the disks.  See documentation for that function for "
1410 "details)."
1411 msgstr ""
1412
1413 #. type: =head3
1414 #: ../src/guestfs.pod:612
1415 msgid "INSPECTING INSTALL DISKS"
1416 msgstr ""
1417
1418 #. type: textblock
1419 #: ../src/guestfs.pod:614
1420 msgid ""
1421 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1422 "CDs and more."
1423 msgstr ""
1424
1425 #. type: textblock
1426 #: ../src/guestfs.pod:617
1427 msgid ""
1428 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1429 "system, which currently can be C<installed> (a regular operating system) or "
1430 "C<installer> (some sort of install disk)."
1431 msgstr ""
1432
1433 #. type: textblock
1434 #: ../src/guestfs.pod:621
1435 msgid ""
1436 "Further information is available about the operating system that can be "
1437 "installed using the regular inspection APIs like L</"
1438 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
1439 msgstr ""
1440
1441 #. type: textblock
1442 #: ../src/guestfs.pod:626
1443 msgid ""
1444 "Some additional information specific to installer disks is also available "
1445 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
1446 "guestfs_inspect_is_multipart> calls."
1447 msgstr ""
1448
1449 # type: =head2
1450 #. type: =head2
1451 #: ../src/guestfs.pod:631
1452 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1453 msgstr ""
1454
1455 # type: textblock
1456 #. type: textblock
1457 #: ../src/guestfs.pod:633
1458 msgid ""
1459 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1460 "ntfs-3g.org/> driver."
1461 msgstr ""
1462
1463 # type: =head3
1464 #. type: =head3
1465 #: ../src/guestfs.pod:636
1466 msgid "DRIVE LETTERS AND PATHS"
1467 msgstr ""
1468
1469 # type: textblock
1470 #. type: textblock
1471 #: ../src/guestfs.pod:638
1472 msgid ""
1473 "DOS and Windows still use drive letters, and the filesystems are always "
1474 "treated as case insensitive by Windows itself, and therefore you might find "
1475 "a Windows configuration file referring to a path like C<c:\\windows"
1476 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1477 "might be referred to as C</WINDOWS/System32>."
1478 msgstr ""
1479
1480 # type: textblock
1481 #. type: textblock
1482 #: ../src/guestfs.pod:644
1483 msgid ""
1484 "Drive letter mappings are outside the scope of libguestfs.  You have to use "
1485 "libguestfs to read the appropriate Windows Registry and configuration files, "
1486 "to determine yourself how drives are mapped (see also L<hivex(3)> and L<virt-"
1487 "inspector(1)>)."
1488 msgstr ""
1489
1490 # type: textblock
1491 #. type: textblock
1492 #: ../src/guestfs.pod:649
1493 msgid ""
1494 "Replacing backslash characters with forward slash characters is also outside "
1495 "the scope of libguestfs, but something that you can easily do."
1496 msgstr ""
1497
1498 # type: textblock
1499 #. type: textblock
1500 #: ../src/guestfs.pod:652
1501 msgid ""
1502 "Where we can help is in resolving the case insensitivity of paths.  For "
1503 "this, call L</guestfs_case_sensitive_path>."
1504 msgstr ""
1505
1506 # type: =head3
1507 #. type: =head3
1508 #: ../src/guestfs.pod:655
1509 msgid "ACCESSING THE WINDOWS REGISTRY"
1510 msgstr ""
1511
1512 # type: textblock
1513 #. type: textblock
1514 #: ../src/guestfs.pod:657
1515 msgid ""
1516 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1517 "files, through the library C<hivex> which is part of the libguestfs project "
1518 "although ships as a separate tarball.  You have to locate and download the "
1519 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1520 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1521 "reg(1)> for more help on this issue."
1522 msgstr ""
1523
1524 # type: =head3
1525 #. type: =head3
1526 #: ../src/guestfs.pod:665
1527 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1528 msgstr ""
1529
1530 # type: textblock
1531 #. type: textblock
1532 #: ../src/guestfs.pod:667
1533 msgid ""
1534 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1535 "provide something which looks like a Linux symlink.  The way it tries to do "
1536 "the rewriting is described here:"
1537 msgstr ""
1538
1539 # type: textblock
1540 #. type: textblock
1541 #: ../src/guestfs.pod:671
1542 msgid ""
1543 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1544 "symbolic-links/>"
1545 msgstr ""
1546
1547 # type: textblock
1548 #. type: textblock
1549 #: ../src/guestfs.pod:673
1550 msgid ""
1551 "The essential problem is that ntfs-3g simply does not have enough "
1552 "information to do a correct job.  NTFS links can contain drive letters and "
1553 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1554 "It is almost certainly the case that libguestfs callers should ignore what "
1555 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1556 msgstr ""
1557
1558 # type: textblock
1559 #. type: textblock
1560 #: ../src/guestfs.pod:680
1561 msgid ""
1562 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1563 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1564 "attribute, and read the raw reparse data from that (you can find the format "
1565 "documented in various places around the web)."
1566 msgstr ""
1567
1568 # type: =head3
1569 #. type: =head3
1570 #: ../src/guestfs.pod:685
1571 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1572 msgstr ""
1573
1574 # type: textblock
1575 #. type: textblock
1576 #: ../src/guestfs.pod:687
1577 msgid ""
1578 "There are other useful extended attributes that can be read from ntfs-3g "
1579 "filesystems (using L</guestfs_getxattr>).  See:"
1580 msgstr ""
1581
1582 # type: textblock
1583 #. type: textblock
1584 #: ../src/guestfs.pod:690
1585 msgid ""
1586 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1587 msgstr ""
1588
1589 # type: =head2
1590 #. type: =head2
1591 #: ../src/guestfs.pod:692
1592 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1593 msgstr ""
1594
1595 # type: textblock
1596 #. type: textblock
1597 #: ../src/guestfs.pod:694
1598 msgid ""
1599 "Although we don't want to discourage you from using the C API, we will "
1600 "mention here that the same API is also available in other languages."
1601 msgstr ""
1602
1603 #. type: textblock
1604 #: ../src/guestfs.pod:697
1605 msgid ""
1606 "The API is broadly identical in all supported languages.  This means that "
1607 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1608 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1609 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1610 "each language."
1611 msgstr ""
1612
1613 # type: textblock
1614 #. type: textblock
1615 #: ../src/guestfs.pod:703
1616 msgid ""
1617 "Error messages are automatically transformed into exceptions if the language "
1618 "supports it."
1619 msgstr ""
1620
1621 # type: textblock
1622 #. type: textblock
1623 #: ../src/guestfs.pod:706
1624 msgid ""
1625 "We don't try to \"object orientify\" parts of the API in OO languages, "
1626 "although contributors are welcome to write higher level APIs above what we "
1627 "provide in their favourite languages if they wish."
1628 msgstr ""
1629
1630 # type: =item
1631 #. type: =item
1632 #: ../src/guestfs.pod:712
1633 msgid "B<C++>"
1634 msgstr ""
1635
1636 # type: textblock
1637 #. type: textblock
1638 #: ../src/guestfs.pod:714
1639 msgid ""
1640 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1641 "identical to the C API.  C++ classes and exceptions are not used."
1642 msgstr ""
1643
1644 # type: =item
1645 #. type: =item
1646 #: ../src/guestfs.pod:718
1647 msgid "B<C#>"
1648 msgstr ""
1649
1650 # type: textblock
1651 #. type: textblock
1652 #: ../src/guestfs.pod:720
1653 msgid ""
1654 "The C# bindings are highly experimental.  Please read the warnings at the "
1655 "top of C<csharp/Libguestfs.cs>."
1656 msgstr ""
1657
1658 # type: =item
1659 #. type: =item
1660 #: ../src/guestfs.pod:723
1661 msgid "B<Haskell>"
1662 msgstr ""
1663
1664 # type: textblock
1665 #. type: textblock
1666 #: ../src/guestfs.pod:725
1667 msgid ""
1668 "This is the only language binding that is working but incomplete.  Only "
1669 "calls which return simple integers have been bound in Haskell, and we are "
1670 "looking for help to complete this binding."
1671 msgstr ""
1672
1673 # type: =item
1674 #. type: =item
1675 #: ../src/guestfs.pod:729
1676 msgid "B<Java>"
1677 msgstr ""
1678
1679 # type: textblock
1680 #. type: textblock
1681 #: ../src/guestfs.pod:731
1682 msgid ""
1683 "Full documentation is contained in the Javadoc which is distributed with "
1684 "libguestfs."
1685 msgstr ""
1686
1687 # type: =item
1688 #. type: =item
1689 #: ../src/guestfs.pod:734
1690 msgid "B<OCaml>"
1691 msgstr ""
1692
1693 #. type: textblock
1694 #: ../src/guestfs.pod:736
1695 msgid "See L<guestfs-ocaml(3)>."
1696 msgstr ""
1697
1698 # type: =item
1699 #. type: =item
1700 #: ../src/guestfs.pod:738
1701 msgid "B<Perl>"
1702 msgstr ""
1703
1704 #. type: textblock
1705 #: ../src/guestfs.pod:740
1706 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1707 msgstr ""
1708
1709 # type: =item
1710 #. type: =item
1711 #: ../src/guestfs.pod:742
1712 msgid "B<PHP>"
1713 msgstr ""
1714
1715 # type: textblock
1716 #. type: textblock
1717 #: ../src/guestfs.pod:744
1718 msgid ""
1719 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1720 "the php-libguestfs package for your distribution."
1721 msgstr ""
1722
1723 # type: textblock
1724 #. type: textblock
1725 #: ../src/guestfs.pod:747
1726 msgid "The PHP binding only works correctly on 64 bit machines."
1727 msgstr ""
1728
1729 # type: =item
1730 #. type: =item
1731 #: ../src/guestfs.pod:749
1732 msgid "B<Python>"
1733 msgstr ""
1734
1735 #. type: textblock
1736 #: ../src/guestfs.pod:751
1737 msgid "See L<guestfs-python(3)>."
1738 msgstr ""
1739
1740 # type: =item
1741 #. type: =item
1742 #: ../src/guestfs.pod:753
1743 msgid "B<Ruby>"
1744 msgstr ""
1745
1746 #. type: textblock
1747 #: ../src/guestfs.pod:755
1748 msgid "See L<guestfs-ruby(3)>."
1749 msgstr ""
1750
1751 # type: =item
1752 #. type: =item
1753 #: ../src/guestfs.pod:757
1754 msgid "B<shell scripts>"
1755 msgstr ""
1756
1757 #. type: textblock
1758 #: ../src/guestfs.pod:759
1759 msgid "See L<guestfish(1)>."
1760 msgstr ""
1761
1762 # type: =head2
1763 #. type: =head2
1764 #: ../src/guestfs.pod:763
1765 msgid "LIBGUESTFS GOTCHAS"
1766 msgstr ""
1767
1768 # type: textblock
1769 #. type: textblock
1770 #: ../src/guestfs.pod:765
1771 msgid ""
1772 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1773 "system [...] that works in the way it is documented but is counterintuitive "
1774 "and almost invites mistakes.\""
1775 msgstr ""
1776
1777 # type: textblock
1778 #. type: textblock
1779 #: ../src/guestfs.pod:769
1780 msgid ""
1781 "Since we developed libguestfs and the associated tools, there are several "
1782 "things we would have designed differently, but are now stuck with for "
1783 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1784 "release, you can expect these to change.  Beware of them."
1785 msgstr ""
1786
1787 # type: =item
1788 #. type: =item
1789 #: ../src/guestfs.pod:777
1790 msgid "Autosync / forgetting to sync."
1791 msgstr ""
1792
1793 # type: textblock
1794 #. type: textblock
1795 #: ../src/guestfs.pod:779
1796 msgid ""
1797 "When modifying a filesystem from C or another language, you B<must> unmount "
1798 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1799 "libguestfs handle.  You can also call:"
1800 msgstr ""
1801
1802 # type: verbatim
1803 #. type: verbatim
1804 #: ../src/guestfs.pod:783
1805 #, no-wrap
1806 msgid ""
1807 " guestfs_set_autosync (g, 1);\n"
1808 "\n"
1809 msgstr ""
1810
1811 # type: textblock
1812 #. type: textblock
1813 #: ../src/guestfs.pod:785
1814 msgid ""
1815 "to have the unmount/sync done automatically for you when the handle 'g' is "
1816 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1817 msgstr ""
1818
1819 # type: textblock
1820 #. type: textblock
1821 #: ../src/guestfs.pod:789
1822 msgid ""
1823 "If you forget to do this, then it is entirely possible that your changes "
1824 "won't be written out, or will be partially written, or (very rarely) that "
1825 "you'll get disk corruption."
1826 msgstr ""
1827
1828 # type: textblock
1829 #. type: textblock
1830 #: ../src/guestfs.pod:793
1831 msgid ""
1832 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1833 "guestfish scripts that forget to sync will work just fine, which can make "
1834 "this very puzzling if you are trying to debug a problem."
1835 msgstr ""
1836
1837 # type: textblock
1838 #. type: textblock
1839 #: ../src/guestfs.pod:797
1840 msgid ""
1841 "Update: Autosync is enabled by default for all API users starting from "
1842 "libguestfs 1.5.24."
1843 msgstr ""
1844
1845 # type: =item
1846 #. type: =item
1847 #: ../src/guestfs.pod:800
1848 msgid "Mount option C<-o sync> should not be the default."
1849 msgstr ""
1850
1851 # type: textblock
1852 #. type: textblock
1853 #: ../src/guestfs.pod:802
1854 msgid ""
1855 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1856 "However C<-o sync> does not add any reliability benefit, but does have a "
1857 "very large performance impact."
1858 msgstr ""
1859
1860 # type: textblock
1861 #. type: textblock
1862 #: ../src/guestfs.pod:806
1863 msgid ""
1864 "The work around is to use L</guestfs_mount_options> and set the mount "
1865 "options that you actually want to use."
1866 msgstr ""
1867
1868 # type: =item
1869 #. type: =item
1870 #: ../src/guestfs.pod:809
1871 msgid "Read-only should be the default."
1872 msgstr ""
1873
1874 # type: textblock
1875 #. type: textblock
1876 #: ../src/guestfs.pod:811
1877 msgid ""
1878 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1879 "specify I<--rw> if you want to make changes to the image."
1880 msgstr ""
1881
1882 # type: textblock
1883 #. type: textblock
1884 #: ../src/guestfs.pod:814
1885 msgid "This would reduce the potential to corrupt live VM images."
1886 msgstr ""
1887
1888 # type: textblock
1889 #. type: textblock
1890 #: ../src/guestfs.pod:816
1891 msgid ""
1892 "Note that many filesystems change the disk when you just mount and unmount, "
1893 "even if you didn't perform any writes.  You need to use L</"
1894 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1895 msgstr ""
1896
1897 # type: =item
1898 #. type: =item
1899 #: ../src/guestfs.pod:820
1900 msgid "guestfish command line is hard to use."
1901 msgstr ""
1902
1903 # type: textblock
1904 #. type: textblock
1905 #: ../src/guestfs.pod:822
1906 msgid ""
1907 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1908 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1909 "exist, so it fails.  In earlier versions of guestfish the error message was "
1910 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1911 "we should have used C<guestfish -c command> to run commands."
1912 msgstr ""
1913
1914 # type: =item
1915 #. type: =item
1916 #: ../src/guestfs.pod:829
1917 msgid "guestfish megabyte modifiers don't work right on all commands"
1918 msgstr ""
1919
1920 # type: textblock
1921 #. type: textblock
1922 #: ../src/guestfs.pod:831
1923 msgid ""
1924 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1925 "other modifiers).  What guestfish actually does is to multiply the number "
1926 "part by the modifier part and pass the result to the C API.  However this "
1927 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1928 "expecting some other unit (eg. megabytes)."
1929 msgstr ""
1930
1931 # type: textblock
1932 #. type: textblock
1933 #: ../src/guestfs.pod:838
1934 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1935 msgstr ""
1936
1937 # type: verbatim
1938 #. type: verbatim
1939 #: ../src/guestfs.pod:840
1940 #, no-wrap
1941 msgid ""
1942 " lvcreate LV VG 100M\n"
1943 "\n"
1944 msgstr ""
1945
1946 # type: textblock
1947 #. type: textblock
1948 #: ../src/guestfs.pod:842
1949 msgid ""
1950 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1951 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1952 "megabytes * megabytes) logical volume.  The error message you get from this "
1953 "is also a little obscure."
1954 msgstr ""
1955
1956 # type: textblock
1957 #. type: textblock
1958 #: ../src/guestfs.pod:847
1959 msgid ""
1960 "This could be fixed in the generator by specially marking parameters and "
1961 "return values which take bytes or other units."
1962 msgstr ""
1963
1964 # type: =item
1965 #. type: =item
1966 #: ../src/guestfs.pod:850
1967 msgid "Ambiguity between devices and paths"
1968 msgstr ""
1969
1970 # type: textblock
1971 #. type: textblock
1972 #: ../src/guestfs.pod:852
1973 msgid ""
1974 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1975 "sdb2>) and a similar pathname.  A file might just happen to be called "
1976 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1977 msgstr ""
1978
1979 # type: textblock
1980 #. type: textblock
1981 #: ../src/guestfs.pod:857
1982 msgid ""
1983 "In the current API we usually resolve this ambiguity by having two separate "
1984 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1985 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1986 "detecting if the path supplied begins with C</dev/>."
1987 msgstr ""
1988
1989 # type: textblock
1990 #. type: textblock
1991 #: ../src/guestfs.pod:863
1992 msgid ""
1993 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1994 "make paths/devices into structured names.  One way to do this would be to "
1995 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1996 "aspect of grub.  Another way would be to use a structured type, equivalent "
1997 "to this OCaml type:"
1998 msgstr ""
1999
2000 # type: verbatim
2001 #. type: verbatim
2002 #: ../src/guestfs.pod:869
2003 #, no-wrap
2004 msgid ""
2005 " type path = Path of string | Device of int | Partition of int * int\n"
2006 "\n"
2007 msgstr ""
2008
2009 # type: textblock
2010 #. type: textblock
2011 #: ../src/guestfs.pod:871
2012 msgid "which would allow you to pass arguments like:"
2013 msgstr ""
2014
2015 # type: verbatim
2016 #. type: verbatim
2017 #: ../src/guestfs.pod:873
2018 #, no-wrap
2019 msgid ""
2020 " Path \"/foo/bar\"\n"
2021 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
2022 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
2023 " Path \"/dev/sdb2\"    (* not a device *)\n"
2024 "\n"
2025 msgstr ""
2026
2027 # type: textblock
2028 #. type: textblock
2029 #: ../src/guestfs.pod:878
2030 msgid ""
2031 "As you can see there are still problems to resolve even with this "
2032 "representation.  Also consider how it might work in guestfish."
2033 msgstr ""
2034
2035 # type: =head2
2036 #. type: =head2
2037 #: ../src/guestfs.pod:883
2038 msgid "PROTOCOL LIMITS"
2039 msgstr ""
2040
2041 # type: textblock
2042 #. type: textblock
2043 #: ../src/guestfs.pod:885
2044 msgid ""
2045 "Internally libguestfs uses a message-based protocol to pass API calls and "
2046 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
2047 "plenty more detail about this).  The maximum message size used by the "
2048 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
2049 "aware of this limit.  The API calls which may be affected are individually "
2050 "documented, with a link back to this section of the documentation."
2051 msgstr ""
2052
2053 # type: textblock
2054 #. type: textblock
2055 #: ../src/guestfs.pod:893
2056 msgid ""
2057 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
2058 "a simple string.  Because this string is at some point internally encoded as "
2059 "a message, the maximum size that it can return is slightly under 4 MB.  If "
2060 "the requested file is larger than this then you will get an error."
2061 msgstr ""
2062
2063 # type: textblock
2064 #. type: textblock
2065 #: ../src/guestfs.pod:899
2066 msgid ""
2067 "In order to transfer large files into and out of the guest filesystem, you "
2068 "need to use particular calls that support this.  The sections L</UPLOADING> "
2069 "and L</DOWNLOADING> document how to do this."
2070 msgstr ""
2071
2072 # type: textblock
2073 #. type: textblock
2074 #: ../src/guestfs.pod:903
2075 msgid ""
2076 "You might also consider mounting the disk image using our FUSE filesystem "
2077 "support (L<guestmount(1)>)."
2078 msgstr ""
2079
2080 # type: =head2
2081 #. type: =head2
2082 #: ../src/guestfs.pod:906
2083 msgid "KEYS AND PASSPHRASES"
2084 msgstr ""
2085
2086 # type: textblock
2087 #. type: textblock
2088 #: ../src/guestfs.pod:908
2089 msgid ""
2090 "Certain libguestfs calls take a parameter that contains sensitive key "
2091 "material, passed in as a C string."
2092 msgstr ""
2093
2094 # type: textblock
2095 #. type: textblock
2096 #: ../src/guestfs.pod:911
2097 msgid ""
2098 "In the future we would hope to change the libguestfs implementation so that "
2099 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2100 "swap.  However this is I<not> done at the moment, because of the complexity "
2101 "of such an implementation."
2102 msgstr ""
2103
2104 # type: textblock
2105 #. type: textblock
2106 #: ../src/guestfs.pod:916
2107 msgid ""
2108 "Therefore you should be aware that any key parameter you pass to libguestfs "
2109 "might end up being written out to the swap partition.  If this is a concern, "
2110 "scrub the swap partition or don't use libguestfs on encrypted devices."
2111 msgstr ""
2112
2113 # type: =head1
2114 #. type: =head2
2115 #: ../src/guestfs.pod:921
2116 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2117 msgstr ""
2118
2119 # type: textblock
2120 #. type: textblock
2121 #: ../src/guestfs.pod:923
2122 msgid ""
2123 "All high-level libguestfs actions are synchronous.  If you want to use "
2124 "libguestfs asynchronously then you must create a thread."
2125 msgstr ""
2126
2127 # type: textblock
2128 #. type: textblock
2129 #: ../src/guestfs.pod:926
2130 msgid ""
2131 "Only use the handle from a single thread.  Either use the handle exclusively "
2132 "from one thread, or provide your own mutex so that two threads cannot issue "
2133 "calls on the same handle at the same time."
2134 msgstr ""
2135
2136 # type: textblock
2137 #. type: textblock
2138 #: ../src/guestfs.pod:930
2139 msgid ""
2140 "See the graphical program guestfs-browser for one possible architecture for "
2141 "multithreaded programs using libvirt and libguestfs."
2142 msgstr ""
2143
2144 # type: =head1
2145 #. type: =head2
2146 #: ../src/guestfs.pod:933
2147 msgid "PATH"
2148 msgstr ""
2149
2150 # type: textblock
2151 #. type: textblock
2152 #: ../src/guestfs.pod:935
2153 msgid ""
2154 "Libguestfs needs a kernel and initrd.img, which it finds by looking along an "
2155 "internal path."
2156 msgstr ""
2157
2158 # type: textblock
2159 #. type: textblock
2160 #: ../src/guestfs.pod:938
2161 msgid ""
2162 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2163 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2164 msgstr ""
2165
2166 # type: textblock
2167 #. type: textblock
2168 #: ../src/guestfs.pod:941
2169 msgid ""
2170 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2171 "to change the directories that libguestfs will search in.  The value is a "
2172 "colon-separated list of paths.  The current directory is I<not> searched "
2173 "unless the path contains an empty element or C<.>.  For example "
2174 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2175 "then C</usr/lib/guestfs>."
2176 msgstr ""
2177
2178 # type: =head1
2179 #. type: =head2
2180 #: ../src/guestfs.pod:948
2181 msgid "QEMU WRAPPERS"
2182 msgstr ""
2183
2184 # type: textblock
2185 #. type: textblock
2186 #: ../src/guestfs.pod:950
2187 msgid ""
2188 "If you want to compile your own qemu, run qemu from a non-standard location, "
2189 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2190 "around qemu."
2191 msgstr ""
2192
2193 # type: textblock
2194 #. type: textblock
2195 #: ../src/guestfs.pod:954
2196 msgid ""
2197 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2198 "last command in the shell script (so that qemu replaces the shell and "
2199 "becomes the direct child of the libguestfs-using program).  If you don't do "
2200 "this, then the qemu process won't be cleaned up correctly."
2201 msgstr ""
2202
2203 # type: textblock
2204 #. type: textblock
2205 #: ../src/guestfs.pod:959
2206 msgid ""
2207 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2208 "source:"
2209 msgstr ""
2210
2211 # type: verbatim
2212 #. type: verbatim
2213 #: ../src/guestfs.pod:962
2214 #, no-wrap
2215 msgid ""
2216 " #!/bin/sh -\n"
2217 " qemudir=/home/rjones/d/qemu\n"
2218 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2219 "\n"
2220 msgstr ""
2221
2222 # type: textblock
2223 #. type: textblock
2224 #: ../src/guestfs.pod:966
2225 msgid ""
2226 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2227 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2228 "example:"
2229 msgstr ""
2230
2231 # type: verbatim
2232 #. type: verbatim
2233 #: ../src/guestfs.pod:970
2234 #, no-wrap
2235 msgid ""
2236 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2237 "\n"
2238 msgstr ""
2239
2240 # type: textblock
2241 #. type: textblock
2242 #: ../src/guestfs.pod:972
2243 msgid ""
2244 "Note that libguestfs also calls qemu with the -help and -version options in "
2245 "order to determine features."
2246 msgstr ""
2247
2248 #. type: =head2
2249 #: ../src/guestfs.pod:975
2250 msgid "ATTACHING TO RUNNING DAEMONS"
2251 msgstr ""
2252
2253 #. type: textblock
2254 #: ../src/guestfs.pod:977
2255 msgid ""
2256 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
2257 "babies.  Use with caution."
2258 msgstr ""
2259
2260 #. type: textblock
2261 #: ../src/guestfs.pod:980
2262 msgid ""
2263 "I<Note (2):> This section explains how to attach to a running daemon from a "
2264 "low level perspective.  For most users, simply using virt tools such as "
2265 "L<guestfish(1)> with the I<--live> option will \"just work\"."
2266 msgstr ""
2267
2268 #. type: =head3
2269 #: ../src/guestfs.pod:984
2270 msgid "Using guestfs_set_attach_method"
2271 msgstr ""
2272
2273 #. type: textblock
2274 #: ../src/guestfs.pod:986
2275 msgid ""
2276 "By calling L</guestfs_set_attach_method> you can change how the library "
2277 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
2278 "ARCHITECTURE> for some background)."
2279 msgstr ""
2280
2281 #. type: textblock
2282 #: ../src/guestfs.pod:990
2283 msgid ""
2284 "The normal attach method is C<appliance>, where a small appliance is created "
2285 "containing the daemon, and then the library connects to this."
2286 msgstr ""
2287
2288 #. type: textblock
2289 #: ../src/guestfs.pod:993
2290 msgid ""
2291 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
2292 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
2293 "daemon over the Unix domain socket."
2294 msgstr ""
2295
2296 #. type: textblock
2297 #: ../src/guestfs.pod:997
2298 msgid ""
2299 "The normal use for this is to connect to a running virtual machine that "
2300 "contains a C<guestfsd> daemon, and send commands so you can read and write "
2301 "files inside the live virtual machine."
2302 msgstr ""
2303
2304 #. type: =head3
2305 #: ../src/guestfs.pod:1001
2306 msgid "Using guestfs_add_domain with live flag"
2307 msgstr ""
2308
2309 #. type: textblock
2310 #: ../src/guestfs.pod:1003
2311 msgid ""
2312 "L</guestfs_add_domain> provides some help for getting the correct attach "
2313 "method.  If you pass the C<live> option to this function, then (if the "
2314 "virtual machine is running) it will examine the libvirt XML looking for a "
2315 "virtio-serial channel to connect to:"
2316 msgstr ""
2317
2318 #. type: verbatim
2319 #: ../src/guestfs.pod:1009
2320 #, no-wrap
2321 msgid ""
2322 " <domain>\n"
2323 "   ...\n"
2324 "   <devices>\n"
2325 "     ...\n"
2326 "     <channel type='unix'>\n"
2327 "       <source mode='bind' path='/path/to/socket'/>\n"
2328 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
2329 "     </channel>\n"
2330 "     ...\n"
2331 "   </devices>\n"
2332 " </domain>\n"
2333 "\n"
2334 msgstr ""
2335
2336 #. type: textblock
2337 #: ../src/guestfs.pod:1021
2338 msgid ""
2339 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2340 "method to C<unix:/path/to/socket>."
2341 msgstr ""
2342
2343 #. type: textblock
2344 #: ../src/guestfs.pod:1024
2345 msgid ""
2346 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2347 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2348 "to attach to and modify live virtual machines."
2349 msgstr ""
2350
2351 #. type: textblock
2352 #: ../src/guestfs.pod:1028
2353 msgid ""
2354 "The virtual machine needs to have been set up beforehand so that it has the "
2355 "virtio-serial channel and so that guestfsd is running inside it."
2356 msgstr ""
2357
2358 # type: =head2
2359 #. type: =head2
2360 #: ../src/guestfs.pod:1032
2361 msgid "ABI GUARANTEE"
2362 msgstr ""
2363
2364 # type: textblock
2365 #. type: textblock
2366 #: ../src/guestfs.pod:1034
2367 msgid ""
2368 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2369 "actions as outlined in this section.  Although we will deprecate some "
2370 "actions, for example if they get replaced by newer calls, we will keep the "
2371 "old actions forever.  This allows you the developer to program in confidence "
2372 "against the libguestfs API."
2373 msgstr ""
2374
2375 # type: =head1
2376 #. type: =head2
2377 #: ../src/guestfs.pod:1040
2378 msgid "BLOCK DEVICE NAMING"
2379 msgstr ""
2380
2381 # type: textblock
2382 #. type: textblock
2383 #: ../src/guestfs.pod:1042
2384 msgid ""
2385 "In the kernel there is now quite a profusion of schemata for naming block "
2386 "devices (in this context, by I<block device> I mean a physical or virtual "
2387 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2388 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2389 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2390 "for the old IDE driver (particularly for SATA devices) those devices also "
2391 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2392 "paravirtualized drivers.  This has created several different naming systems, "
2393 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2394 msgstr ""
2395
2396 # type: textblock
2397 #. type: textblock
2398 #: ../src/guestfs.pod:1054
2399 msgid ""
2400 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2401 "Linux kernel to access block devices.  We can run a variety of appliances "
2402 "based on a variety of Linux kernels."
2403 msgstr ""
2404
2405 # type: textblock
2406 #. type: textblock
2407 #: ../src/guestfs.pod:1058
2408 msgid ""
2409 "This causes a problem for libguestfs because many API calls use device or "
2410 "partition names.  Working scripts and the recipe (example) scripts that we "
2411 "make available over the internet could fail if the naming scheme changes."
2412 msgstr ""
2413
2414 # type: textblock
2415 #. type: textblock
2416 #: ../src/guestfs.pod:1063
2417 msgid ""
2418 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2419 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2420 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2421 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2422 msgstr ""
2423
2424 # type: textblock
2425 #. type: textblock
2426 #: ../src/guestfs.pod:1069
2427 msgid ""
2428 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2429 "L</guestfs_list_partitions> and similar calls return the true names of the "
2430 "devices and partitions as known to the appliance."
2431 msgstr ""
2432
2433 # type: =head2
2434 #. type: =head3
2435 #: ../src/guestfs.pod:1074
2436 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2437 msgstr ""
2438
2439 # type: textblock
2440 #. type: textblock
2441 #: ../src/guestfs.pod:1076
2442 msgid ""
2443 "Usually this translation is transparent.  However in some (very rare)  cases "
2444 "you may need to know the exact algorithm.  Such cases include where you use "
2445 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2446 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2447 msgstr ""
2448
2449 # type: textblock
2450 #. type: textblock
2451 #: ../src/guestfs.pod:1082
2452 msgid ""
2453 "The algorithm is applied only to I<parameters> which are known to be either "
2454 "device or partition names.  Return values from functions such as L</"
2455 "guestfs_list_devices> are never changed."
2456 msgstr ""
2457
2458 # type: textblock
2459 #. type: textblock
2460 #: ../src/guestfs.pod:1090
2461 msgid "Is the string a parameter which is a device or partition name?"
2462 msgstr ""
2463
2464 # type: textblock
2465 #. type: textblock
2466 #: ../src/guestfs.pod:1094
2467 msgid "Does the string begin with C</dev/sd>?"
2468 msgstr ""
2469
2470 # type: textblock
2471 #. type: textblock
2472 #: ../src/guestfs.pod:1098
2473 msgid ""
2474 "Does the named device exist? If so, we use that device.  However if I<not> "
2475 "then we continue with this algorithm."
2476 msgstr ""
2477
2478 # type: textblock
2479 #. type: textblock
2480 #: ../src/guestfs.pod:1103
2481 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2482 msgstr ""
2483
2484 # type: textblock
2485 #. type: textblock
2486 #: ../src/guestfs.pod:1105
2487 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2488 msgstr ""
2489
2490 # type: textblock
2491 #. type: textblock
2492 #: ../src/guestfs.pod:1107
2493 msgid "If that named device exists, use it.  If not, continue."
2494 msgstr ""
2495
2496 # type: textblock
2497 #. type: textblock
2498 #: ../src/guestfs.pod:1111
2499 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2500 msgstr ""
2501
2502 # type: textblock
2503 #. type: textblock
2504 #: ../src/guestfs.pod:1113
2505 msgid "If that named device exists, use it.  If not, return an error."
2506 msgstr ""
2507
2508 # type: =head3
2509 #. type: =head3
2510 #: ../src/guestfs.pod:1117
2511 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2512 msgstr ""
2513
2514 # type: textblock
2515 #. type: textblock
2516 #: ../src/guestfs.pod:1119
2517 msgid ""
2518 "Although the standard naming scheme and automatic translation is useful for "
2519 "simple programs and guestfish scripts, for larger programs it is best not to "
2520 "rely on this mechanism."
2521 msgstr ""
2522
2523 # type: textblock
2524 #. type: textblock
2525 #: ../src/guestfs.pod:1123
2526 msgid ""
2527 "Where possible for maximum future portability programs using libguestfs "
2528 "should use these future-proof techniques:"
2529 msgstr ""
2530
2531 # type: textblock
2532 #. type: textblock
2533 #: ../src/guestfs.pod:1130
2534 msgid ""
2535 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2536 "device names, and then use those names directly."
2537 msgstr ""
2538
2539 # type: textblock
2540 #. type: textblock
2541 #: ../src/guestfs.pod:1133
2542 msgid ""
2543 "Since those device names exist by definition, they will never be translated."
2544 msgstr ""
2545
2546 # type: textblock
2547 #. type: textblock
2548 #: ../src/guestfs.pod:1138
2549 msgid ""
2550 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2551 "filesystem labels."
2552 msgstr ""
2553
2554 # type: =head1
2555 #. type: =head1
2556 #: ../src/guestfs.pod:1143
2557 msgid "SECURITY"
2558 msgstr ""
2559
2560 # type: textblock
2561 #. type: textblock
2562 #: ../src/guestfs.pod:1145
2563 msgid ""
2564 "This section discusses security implications of using libguestfs, "
2565 "particularly with untrusted or malicious guests or disk images."
2566 msgstr ""
2567
2568 # type: =head2
2569 #. type: =head2
2570 #: ../src/guestfs.pod:1148
2571 msgid "GENERAL SECURITY CONSIDERATIONS"
2572 msgstr ""
2573
2574 # type: textblock
2575 #. type: textblock
2576 #: ../src/guestfs.pod:1150
2577 msgid ""
2578 "Be careful with any files or data that you download from a guest (by "
2579 "\"download\" we mean not just the L</guestfs_download> command but any "
2580 "command that reads files, filenames, directories or anything else from a "
2581 "disk image).  An attacker could manipulate the data to fool your program "
2582 "into doing the wrong thing.  Consider cases such as:"
2583 msgstr ""
2584
2585 # type: textblock
2586 #. type: textblock
2587 #: ../src/guestfs.pod:1160
2588 msgid "the data (file etc) not being present"
2589 msgstr ""
2590
2591 # type: textblock
2592 #. type: textblock
2593 #: ../src/guestfs.pod:1164
2594 msgid "being present but empty"
2595 msgstr ""
2596
2597 # type: textblock
2598 #. type: textblock
2599 #: ../src/guestfs.pod:1168
2600 msgid "being much larger than normal"
2601 msgstr ""
2602
2603 # type: textblock
2604 #. type: textblock
2605 #: ../src/guestfs.pod:1172
2606 msgid "containing arbitrary 8 bit data"
2607 msgstr ""
2608
2609 # type: textblock
2610 #. type: textblock
2611 #: ../src/guestfs.pod:1176
2612 msgid "being in an unexpected character encoding"
2613 msgstr ""
2614
2615 # type: textblock
2616 #. type: textblock
2617 #: ../src/guestfs.pod:1180
2618 msgid "containing homoglyphs."
2619 msgstr ""
2620
2621 # type: =head2
2622 #. type: =head2
2623 #: ../src/guestfs.pod:1184
2624 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2625 msgstr ""
2626
2627 # type: textblock
2628 #. type: textblock
2629 #: ../src/guestfs.pod:1186
2630 msgid ""
2631 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2632 "(VFS) module can sometimes be escalated into exploits by deliberately "
2633 "creating a malicious, malformed filesystem.  These exploits are very severe "
2634 "for two reasons.  Firstly there are very many filesystem drivers in the "
2635 "kernel, and many of them are infrequently used and not much developer "
2636 "attention has been paid to the code.  Linux userspace helps potential "
2637 "crackers by detecting the filesystem type and automatically choosing the "
2638 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2639 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2640 "exploit (worse in some ways), giving immediate and total access to the "
2641 "system right down to the hardware level."
2642 msgstr ""
2643
2644 # type: textblock
2645 #. type: textblock
2646 #: ../src/guestfs.pod:1199
2647 msgid ""
2648 "That explains why you should never mount a filesystem from an untrusted "
2649 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2650 "inside a qemu virtual machine, usually running as a non-root user.  The "
2651 "attacker would need to write a filesystem which first exploited the kernel, "
2652 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2653 "the libguestfs protocol, and finally to be as serious as the host kernel "
2654 "exploit it would need to escalate its privileges to root.  This multi-step "
2655 "escalation, performed by a static piece of data, is thought to be extremely "
2656 "hard to do, although we never say 'never' about security issues."
2657 msgstr ""
2658
2659 # type: textblock
2660 #. type: textblock
2661 #: ../src/guestfs.pod:1210
2662 msgid ""
2663 "In any case callers can reduce the attack surface by forcing the filesystem "
2664 "type when mounting (use L</guestfs_mount_vfs>)."
2665 msgstr ""
2666
2667 # type: =head2
2668 #. type: =head2
2669 #: ../src/guestfs.pod:1213
2670 msgid "PROTOCOL SECURITY"
2671 msgstr ""
2672
2673 # type: textblock
2674 #. type: textblock
2675 #: ../src/guestfs.pod:1215
2676 msgid ""
2677 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2678 "defined upper message size.  However a program that uses libguestfs must "
2679 "also take care - for example you can write a program that downloads a binary "
2680 "from a disk image and executes it locally, and no amount of protocol "
2681 "security will save you from the consequences."
2682 msgstr ""
2683
2684 # type: =head2
2685 #. type: =head2
2686 #: ../src/guestfs.pod:1221
2687 msgid "INSPECTION SECURITY"
2688 msgstr ""
2689
2690 # type: textblock
2691 #. type: textblock
2692 #: ../src/guestfs.pod:1223
2693 msgid ""
2694 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2695 "directly from the guest, and these could contain any 8 bit data.  Callers "
2696 "should be careful to escape these before printing them to a structured file "
2697 "(for example, use HTML escaping if creating a web page)."
2698 msgstr ""
2699
2700 # type: textblock
2701 #. type: textblock
2702 #: ../src/guestfs.pod:1229
2703 msgid ""
2704 "Guest configuration may be altered in unusual ways by the administrator of "
2705 "the virtual machine, and may not reflect reality (particularly for untrusted "
2706 "or actively malicious guests).  For example we parse the hostname from "
2707 "configuration files like C</etc/sysconfig/network> that we find in the "
2708 "guest, but the guest administrator can easily manipulate these files to "
2709 "provide the wrong hostname."
2710 msgstr ""
2711
2712 # type: textblock
2713 #. type: textblock
2714 #: ../src/guestfs.pod:1237
2715 msgid ""
2716 "The inspection API parses guest configuration using two external libraries: "
2717 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2718 "designed to be robust in the face of malicious data, although denial of "
2719 "service attacks are still possible, for example with oversized configuration "
2720 "files."
2721 msgstr ""
2722
2723 # type: =head2
2724 #. type: =head2
2725 #: ../src/guestfs.pod:1243
2726 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2727 msgstr ""
2728
2729 # type: textblock
2730 #. type: textblock
2731 #: ../src/guestfs.pod:1245
2732 msgid ""
2733 "Be very cautious about running commands from the guest.  By running a "
2734 "command in the guest, you are giving CPU time to a binary that you do not "
2735 "control, under the same user account as the library, albeit wrapped in qemu "
2736 "virtualization.  More information and alternatives can be found in the "
2737 "section L</RUNNING COMMANDS>."
2738 msgstr ""
2739
2740 # type: =head2
2741 #. type: =head2
2742 #: ../src/guestfs.pod:1251
2743 msgid "CVE-2010-3851"
2744 msgstr ""
2745
2746 # type: textblock
2747 #. type: textblock
2748 #: ../src/guestfs.pod:1253
2749 msgid "https://bugzilla.redhat.com/642934"
2750 msgstr ""
2751
2752 # type: textblock
2753 #. type: textblock
2754 #: ../src/guestfs.pod:1255
2755 msgid ""
2756 "This security bug concerns the automatic disk format detection that qemu "
2757 "does on disk images."
2758 msgstr ""
2759
2760 # type: textblock
2761 #. type: textblock
2762 #: ../src/guestfs.pod:1258
2763 msgid ""
2764 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2765 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2766 "for one of the known headers, and if none is found then assuming the disk "
2767 "image must be raw."
2768 msgstr ""
2769
2770 # type: textblock
2771 #. type: textblock
2772 #: ../src/guestfs.pod:1263
2773 msgid ""
2774 "This allows a guest which has been given a raw disk image to write some "
2775 "other header.  At next boot (or when the disk image is accessed by "
2776 "libguestfs) qemu would do autodetection and think the disk image format was, "
2777 "say, qcow2 based on the header written by the guest."
2778 msgstr ""
2779
2780 # type: textblock
2781 #. type: textblock
2782 #: ../src/guestfs.pod:1268
2783 msgid ""
2784 "This in itself would not be a problem, but qcow2 offers many features, one "
2785 "of which is to allow a disk image to refer to another image (called the "
2786 "\"backing disk\").  It does this by placing the path to the backing disk "
2787 "into the qcow2 header.  This path is not validated and could point to any "
2788 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2789 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2790 "control of the attacker."
2791 msgstr ""
2792
2793 # type: textblock
2794 #. type: textblock
2795 #: ../src/guestfs.pod:1276
2796 msgid ""
2797 "In libguestfs this is rather hard to exploit except under two circumstances:"
2798 msgstr ""
2799
2800 # type: textblock
2801 #. type: textblock
2802 #: ../src/guestfs.pod:1283
2803 msgid "You have enabled the network or have opened the disk in write mode."
2804 msgstr ""
2805
2806 # type: textblock
2807 #. type: textblock
2808 #: ../src/guestfs.pod:1287
2809 msgid ""
2810 "You are also running untrusted code from the guest (see L</RUNNING "
2811 "COMMANDS>)."
2812 msgstr ""
2813
2814 # type: textblock
2815 #. type: textblock
2816 #: ../src/guestfs.pod:1292
2817 msgid ""
2818 "The way to avoid this is to specify the expected disk format when adding "
2819 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2820 "should always do this if the disk is raw format, and it's a good idea for "
2821 "other cases too."
2822 msgstr ""
2823
2824 # type: textblock
2825 #. type: textblock
2826 #: ../src/guestfs.pod:1297
2827 msgid ""
2828 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2829 "format is fetched from libvirt and passed through."
2830 msgstr ""
2831
2832 # type: textblock
2833 #. type: textblock
2834 #: ../src/guestfs.pod:1300
2835 msgid ""
2836 "For libguestfs tools, use the I<--format> command line parameter as "
2837 "appropriate."
2838 msgstr ""
2839
2840 # type: =head1
2841 #. type: =head1
2842 #: ../src/guestfs.pod:1303
2843 msgid "CONNECTION MANAGEMENT"
2844 msgstr ""
2845
2846 # type: =head2
2847 #. type: =head2
2848 #: ../src/guestfs.pod:1305
2849 msgid "guestfs_h *"
2850 msgstr ""
2851
2852 # type: textblock
2853 #. type: textblock
2854 #: ../src/guestfs.pod:1307
2855 msgid ""
2856 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2857 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2858 "handle and release all resources used."
2859 msgstr ""
2860
2861 # type: textblock
2862 #. type: textblock
2863 #: ../src/guestfs.pod:1311
2864 msgid ""
2865 "For information on using multiple handles and threads, see the section L</"
2866 "MULTIPLE HANDLES AND MULTIPLE THREADS> below."
2867 msgstr ""
2868
2869 # type: =head2
2870 #. type: =head2
2871 #: ../src/guestfs.pod:1314
2872 msgid "guestfs_create"
2873 msgstr ""
2874
2875 # type: verbatim
2876 #. type: verbatim
2877 #: ../src/guestfs.pod:1316
2878 #, no-wrap
2879 msgid ""
2880 " guestfs_h *guestfs_create (void);\n"
2881 "\n"
2882 msgstr ""
2883
2884 # type: textblock
2885 #. type: textblock
2886 #: ../src/guestfs.pod:1318
2887 msgid "Create a connection handle."
2888 msgstr ""
2889
2890 # type: textblock
2891 #. type: textblock
2892 #: ../src/guestfs.pod:1320
2893 msgid ""
2894 "You have to call L</guestfs_add_drive_opts> (or one of the equivalent calls) "
2895 "on the handle at least once."
2896 msgstr ""
2897
2898 # type: textblock
2899 #. type: textblock
2900 #: ../src/guestfs.pod:1323
2901 msgid ""
2902 "This function returns a non-NULL pointer to a handle on success or NULL on "
2903 "error."
2904 msgstr ""
2905
2906 # type: textblock
2907 #. type: textblock
2908 #: ../src/guestfs.pod:1326
2909 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2910 msgstr ""
2911
2912 # type: textblock
2913 #. type: textblock
2914 #: ../src/guestfs.pod:1328
2915 msgid ""
2916 "You may also want to configure error handling for the handle.  See L</ERROR "
2917 "HANDLING> section below."
2918 msgstr ""
2919
2920 # type: =head2
2921 #. type: =head2
2922 #: ../src/guestfs.pod:1331
2923 msgid "guestfs_close"
2924 msgstr ""
2925
2926 # type: verbatim
2927 #. type: verbatim
2928 #: ../src/guestfs.pod:1333
2929 #, no-wrap
2930 msgid ""
2931 " void guestfs_close (guestfs_h *g);\n"
2932 "\n"
2933 msgstr ""
2934
2935 # type: textblock
2936 #. type: textblock
2937 #: ../src/guestfs.pod:1335
2938 msgid "This closes the connection handle and frees up all resources used."
2939 msgstr ""
2940
2941 # type: =head1
2942 #. type: =head1
2943 #: ../src/guestfs.pod:1337
2944 msgid "ERROR HANDLING"
2945 msgstr ""
2946
2947 # type: textblock
2948 #. type: textblock
2949 #: ../src/guestfs.pod:1339
2950 msgid ""
2951 "API functions can return errors.  For example, almost all functions that "
2952 "return C<int> will return C<-1> to indicate an error."
2953 msgstr ""
2954
2955 # type: textblock
2956 #. type: textblock
2957 #: ../src/guestfs.pod:1342
2958 msgid ""
2959 "Additional information is available for errors: an error message string and "
2960 "optionally an error number (errno) if the thing that failed was a system "
2961 "call."
2962 msgstr ""
2963
2964 # type: textblock
2965 #. type: textblock
2966 #: ../src/guestfs.pod:1346
2967 msgid ""
2968 "You can get at the additional information about the last error on the handle "
2969 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2970 "up an error handler with L</guestfs_set_error_handler>."
2971 msgstr ""
2972
2973 # type: textblock
2974 #. type: textblock
2975 #: ../src/guestfs.pod:1351
2976 msgid ""
2977 "When the handle is created, a default error handler is installed which "
2978 "prints the error message string to C<stderr>.  For small short-running "
2979 "command line programs it is sufficient to do:"
2980 msgstr ""
2981
2982 # type: verbatim
2983 #. type: verbatim
2984 #: ../src/guestfs.pod:1355
2985 #, no-wrap
2986 msgid ""
2987 " if (guestfs_launch (g) == -1)\n"
2988 "   exit (EXIT_FAILURE);\n"
2989 "\n"
2990 msgstr ""
2991
2992 # type: textblock
2993 #. type: textblock
2994 #: ../src/guestfs.pod:1358
2995 msgid ""
2996 "since the default error handler will ensure that an error message has been "
2997 "printed to C<stderr> before the program exits."
2998 msgstr ""
2999
3000 # type: textblock
3001 #. type: textblock
3002 #: ../src/guestfs.pod:1361
3003 msgid ""
3004 "For other programs the caller will almost certainly want to install an "
3005 "alternate error handler or do error handling in-line like this:"
3006 msgstr ""
3007
3008 # type: verbatim
3009 #. type: verbatim
3010 #: ../src/guestfs.pod:1364
3011 #, no-wrap
3012 msgid ""
3013 " g = guestfs_create ();\n"
3014 " \n"
3015 msgstr ""
3016
3017 # type: verbatim
3018 #. type: verbatim
3019 #: ../src/guestfs.pod:1366
3020 #, no-wrap
3021 msgid ""
3022 " /* This disables the default behaviour of printing errors\n"
3023 "    on stderr. */\n"
3024 " guestfs_set_error_handler (g, NULL, NULL);\n"
3025 " \n"
3026 msgstr ""
3027
3028 # type: verbatim
3029 #. type: verbatim
3030 #: ../src/guestfs.pod:1370
3031 #, no-wrap
3032 msgid ""
3033 " if (guestfs_launch (g) == -1) {\n"
3034 "   /* Examine the error message and print it etc. */\n"
3035 "   char *msg = guestfs_last_error (g);\n"
3036 "   int errnum = guestfs_last_errno (g);\n"
3037 "   fprintf (stderr, \"%s\\n\", msg);\n"
3038 "   /* ... */\n"
3039 "  }\n"
3040 "\n"
3041 msgstr ""
3042
3043 # type: textblock
3044 #. type: textblock
3045 #: ../src/guestfs.pod:1378
3046 msgid ""
3047 "Out of memory errors are handled differently.  The default action is to call "
3048 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
3049 "guestfs_set_out_of_memory_handler>."
3050 msgstr ""
3051
3052 # type: textblock
3053 #. type: textblock
3054 #: ../src/guestfs.pod:1382
3055 msgid ""
3056 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
3057 "because there is no handle if this happens there is no way to get additional "
3058 "error information.  However L</guestfs_create> is supposed to be a "
3059 "lightweight operation which can only fail because of insufficient memory (it "
3060 "returns NULL in this case)."
3061 msgstr ""
3062
3063 # type: =head2
3064 #. type: =head2
3065 #: ../src/guestfs.pod:1388
3066 msgid "guestfs_last_error"
3067 msgstr ""
3068
3069 # type: verbatim
3070 #. type: verbatim
3071 #: ../src/guestfs.pod:1390
3072 #, no-wrap
3073 msgid ""
3074 " const char *guestfs_last_error (guestfs_h *g);\n"
3075 "\n"
3076 msgstr ""
3077
3078 # type: textblock
3079 #. type: textblock
3080 #: ../src/guestfs.pod:1392
3081 msgid ""
3082 "This returns the last error message that happened on C<g>.  If there has not "
3083 "been an error since the handle was created, then this returns C<NULL>."
3084 msgstr ""
3085
3086 # type: textblock
3087 #. type: textblock
3088 #: ../src/guestfs.pod:1396
3089 msgid ""
3090 "The lifetime of the returned string is until the next error occurs, or L</"
3091 "guestfs_close> is called."
3092 msgstr ""
3093
3094 # type: =head2
3095 #. type: =head2
3096 #: ../src/guestfs.pod:1399
3097 msgid "guestfs_last_errno"
3098 msgstr ""
3099
3100 # type: verbatim
3101 #. type: verbatim
3102 #: ../src/guestfs.pod:1401
3103 #, no-wrap
3104 msgid ""
3105 " int guestfs_last_errno (guestfs_h *g);\n"
3106 "\n"
3107 msgstr ""
3108
3109 # type: textblock
3110 #. type: textblock
3111 #: ../src/guestfs.pod:1403
3112 msgid "This returns the last error number (errno) that happened on C<g>."
3113 msgstr ""
3114
3115 # type: textblock
3116 #. type: textblock
3117 #: ../src/guestfs.pod:1405
3118 msgid "If successful, an errno integer not equal to zero is returned."
3119 msgstr ""
3120
3121 # type: textblock
3122 #. type: textblock
3123 #: ../src/guestfs.pod:1407
3124 msgid ""
3125 "If no error, this returns 0.  This call can return 0 in three situations:"
3126 msgstr ""
3127
3128 # type: textblock
3129 #. type: textblock
3130 #: ../src/guestfs.pod:1414
3131 msgid "There has not been any error on the handle."
3132 msgstr ""
3133
3134 # type: textblock
3135 #. type: textblock
3136 #: ../src/guestfs.pod:1418
3137 msgid ""
3138 "There has been an error but the errno was meaningless.  This corresponds to "
3139 "the case where the error did not come from a failed system call, but for "
3140 "some other reason."
3141 msgstr ""
3142
3143 # type: textblock
3144 #. type: textblock
3145 #: ../src/guestfs.pod:1424
3146 msgid ""
3147 "There was an error from a failed system call, but for some reason the errno "
3148 "was not captured and returned.  This usually indicates a bug in libguestfs."
3149 msgstr ""
3150
3151 # type: textblock
3152 #. type: textblock
3153 #: ../src/guestfs.pod:1430
3154 msgid ""
3155 "Libguestfs tries to convert the errno from inside the applicance into a "
3156 "corresponding errno for the caller (not entirely trivial: the appliance "
3157 "might be running a completely different operating system from the library "
3158 "and error numbers are not standardized across Un*xen).  If this could not be "
3159 "done, then the error is translated to C<EINVAL>.  In practice this should "
3160 "only happen in very rare circumstances."
3161 msgstr ""
3162
3163 # type: =head2
3164 #. type: =head2
3165 #: ../src/guestfs.pod:1438
3166 msgid "guestfs_set_error_handler"
3167 msgstr ""
3168
3169 # type: verbatim
3170 #. type: verbatim
3171 #: ../src/guestfs.pod:1440
3172 #, no-wrap
3173 msgid ""
3174 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3175 "                                           void *opaque,\n"
3176 "                                           const char *msg);\n"
3177 " void guestfs_set_error_handler (guestfs_h *g,\n"
3178 "                                 guestfs_error_handler_cb cb,\n"
3179 "                                 void *opaque);\n"
3180 "\n"
3181 msgstr ""
3182
3183 # type: textblock
3184 #. type: textblock
3185 #: ../src/guestfs.pod:1447
3186 msgid ""
3187 "The callback C<cb> will be called if there is an error.  The parameters "
3188 "passed to the callback are an opaque data pointer and the error message "
3189 "string."
3190 msgstr ""
3191
3192 # type: textblock
3193 #. type: textblock
3194 #: ../src/guestfs.pod:1451
3195 msgid ""
3196 "C<errno> is not passed to the callback.  To get that the callback must call "
3197 "L</guestfs_last_errno>."
3198 msgstr ""
3199
3200 # type: textblock
3201 #. type: textblock
3202 #: ../src/guestfs.pod:1454
3203 msgid ""
3204 "Note that the message string C<msg> is freed as soon as the callback "
3205 "function returns, so if you want to stash it somewhere you must make your "
3206 "own copy."
3207 msgstr ""
3208
3209 # type: textblock
3210 #. type: textblock
3211 #: ../src/guestfs.pod:1458
3212 msgid "The default handler prints messages on C<stderr>."
3213 msgstr ""
3214
3215 # type: textblock
3216 #. type: textblock
3217 #: ../src/guestfs.pod:1460
3218 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3219 msgstr ""
3220
3221 # type: =head2
3222 #. type: =head2
3223 #: ../src/guestfs.pod:1462
3224 msgid "guestfs_get_error_handler"
3225 msgstr ""
3226
3227 # type: verbatim
3228 #. type: verbatim
3229 #: ../src/guestfs.pod:1464
3230 #, no-wrap
3231 msgid ""
3232 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3233 "                                                     void **opaque_rtn);\n"
3234 "\n"
3235 msgstr ""
3236
3237 # type: textblock
3238 #. type: textblock
3239 #: ../src/guestfs.pod:1467
3240 msgid "Returns the current error handler callback."
3241 msgstr ""
3242
3243 # type: =head2
3244 #. type: =head2
3245 #: ../src/guestfs.pod:1469
3246 msgid "guestfs_set_out_of_memory_handler"
3247 msgstr ""
3248
3249 # type: verbatim
3250 #. type: verbatim
3251 #: ../src/guestfs.pod:1471
3252 #, no-wrap
3253 msgid ""
3254 " typedef void (*guestfs_abort_cb) (void);\n"
3255 " int guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3256 "                                        guestfs_abort_cb);\n"
3257 "\n"
3258 msgstr ""
3259
3260 # type: textblock
3261 #. type: textblock
3262 #: ../src/guestfs.pod:1475
3263 msgid ""
3264 "The callback C<cb> will be called if there is an out of memory situation.  "
3265 "I<Note this callback must not return>."
3266 msgstr ""
3267
3268 # type: textblock
3269 #. type: textblock
3270 #: ../src/guestfs.pod:1478
3271 msgid "The default is to call L<abort(3)>."
3272 msgstr ""
3273
3274 # type: textblock
3275 #. type: textblock
3276 #: ../src/guestfs.pod:1480
3277 msgid ""
3278 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3279 msgstr ""
3280
3281 # type: =head2
3282 #. type: =head2
3283 #: ../src/guestfs.pod:1483
3284 msgid "guestfs_get_out_of_memory_handler"
3285 msgstr ""
3286
3287 # type: verbatim
3288 #. type: verbatim
3289 #: ../src/guestfs.pod:1485
3290 #, no-wrap
3291 msgid ""
3292 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3293 "\n"
3294 msgstr ""
3295
3296 # type: textblock
3297 #. type: textblock
3298 #: ../src/guestfs.pod:1487
3299 msgid "This returns the current out of memory handler."
3300 msgstr ""
3301
3302 # type: =head1
3303 #. type: =head1
3304 #: ../src/guestfs.pod:1489
3305 msgid "API CALLS"
3306 msgstr ""
3307
3308 # type: textblock
3309 #. type: textblock
3310 #: ../src/guestfs.pod:1491 ../fish/guestfish.pod:989
3311 msgid "@ACTIONS@"
3312 msgstr ""
3313
3314 # type: =head1
3315 #. type: =head1
3316 #: ../src/guestfs.pod:1493
3317 msgid "STRUCTURES"
3318 msgstr ""
3319
3320 # type: textblock
3321 #. type: textblock
3322 #: ../src/guestfs.pod:1495
3323 msgid "@STRUCTS@"
3324 msgstr ""
3325
3326 # type: =head1
3327 #. type: =head1
3328 #: ../src/guestfs.pod:1497
3329 msgid "AVAILABILITY"
3330 msgstr ""
3331
3332 # type: =head2
3333 #. type: =head2
3334 #: ../src/guestfs.pod:1499
3335 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3336 msgstr ""
3337
3338 # type: textblock
3339 #. type: textblock
3340 #: ../src/guestfs.pod:1501
3341 msgid ""
3342 "Using L</guestfs_available> you can test availability of the following "
3343 "groups of functions.  This test queries the appliance to see if the "
3344 "appliance you are currently using supports the functionality."
3345 msgstr ""
3346
3347 # type: textblock
3348 #. type: textblock
3349 #: ../src/guestfs.pod:1506
3350 msgid "@AVAILABILITY@"
3351 msgstr ""
3352
3353 # type: =head2
3354 #. type: =head2
3355 #: ../src/guestfs.pod:1508
3356 msgid "GUESTFISH supported COMMAND"
3357 msgstr ""
3358
3359 # type: textblock
3360 #. type: textblock
3361 #: ../src/guestfs.pod:1510
3362 msgid ""
3363 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3364 "prints out the available groups and whether they are supported by this build "
3365 "of libguestfs.  Note however that you have to do C<run> first."
3366 msgstr ""
3367
3368 # type: =head2
3369 #. type: =head2
3370 #: ../src/guestfs.pod:1515
3371 msgid "SINGLE CALLS AT COMPILE TIME"
3372 msgstr ""
3373
3374 # type: textblock
3375 #. type: textblock
3376 #: ../src/guestfs.pod:1517
3377 msgid ""
3378 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3379 "function, such as:"
3380 msgstr ""
3381
3382 # type: verbatim
3383 #. type: verbatim
3384 #: ../src/guestfs.pod:1520
3385 #, no-wrap
3386 msgid ""
3387 " #define LIBGUESTFS_HAVE_DD 1\n"
3388 "\n"
3389 msgstr ""
3390
3391 # type: textblock
3392 #. type: textblock
3393 #: ../src/guestfs.pod:1522
3394 msgid "if L</guestfs_dd> is available."
3395 msgstr ""
3396
3397 # type: textblock
3398 #. type: textblock
3399 #: ../src/guestfs.pod:1524
3400 msgid ""
3401 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3402 "function is available at compile time, we recommended using build tools such "
3403 "as autoconf or cmake.  For example in autotools you could use:"
3404 msgstr ""
3405
3406 # type: verbatim
3407 #. type: verbatim
3408 #: ../src/guestfs.pod:1529
3409 #, no-wrap
3410 msgid ""
3411 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3412 " AC_CHECK_FUNCS([guestfs_dd])\n"
3413 "\n"
3414 msgstr ""
3415
3416 # type: textblock
3417 #. type: textblock
3418 #: ../src/guestfs.pod:1532
3419 msgid ""
3420 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3421 "in your program."
3422 msgstr ""
3423
3424 # type: =head2
3425 #. type: =head2
3426 #: ../src/guestfs.pod:1535
3427 msgid "SINGLE CALLS AT RUN TIME"
3428 msgstr ""
3429
3430 # type: textblock
3431 #. type: textblock
3432 #: ../src/guestfs.pod:1537
3433 msgid ""
3434 "Testing at compile time doesn't guarantee that a function really exists in "
3435 "the library.  The reason is that you might be dynamically linked against a "
3436 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3437 "This situation unfortunately results in a segmentation fault, which is a "
3438 "shortcoming of the C dynamic linking system itself."
3439 msgstr ""
3440
3441 # type: textblock
3442 #. type: textblock
3443 #: ../src/guestfs.pod:1544
3444 msgid ""
3445 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3446 "in this example program (note that you still need the compile time check as "
3447 "well):"
3448 msgstr ""
3449
3450 # type: verbatim
3451 #. type: verbatim
3452 #: ../src/guestfs.pod:1548
3453 #, no-wrap
3454 msgid ""
3455 " #include <stdio.h>\n"
3456 " #include <stdlib.h>\n"
3457 " #include <unistd.h>\n"
3458 " #include <dlfcn.h>\n"
3459 " #include <guestfs.h>\n"
3460 " \n"
3461 msgstr ""
3462
3463 # type: verbatim
3464 #. type: verbatim
3465 #: ../src/guestfs.pod:1554
3466 #, no-wrap
3467 msgid ""
3468 " main ()\n"
3469 " {\n"
3470 " #ifdef LIBGUESTFS_HAVE_DD\n"
3471 "   void *dl;\n"
3472 "   int has_function;\n"
3473 " \n"
3474 msgstr ""
3475
3476 # type: verbatim
3477 #. type: verbatim
3478 #: ../src/guestfs.pod:1560
3479 #, no-wrap
3480 msgid ""
3481 "   /* Test if the function guestfs_dd is really available. */\n"
3482 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3483 "   if (!dl) {\n"
3484 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3485 "     exit (EXIT_FAILURE);\n"
3486 "   }\n"
3487 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3488 "   dlclose (dl);\n"
3489 " \n"
3490 msgstr ""
3491
3492 # type: verbatim
3493 #. type: verbatim
3494 #: ../src/guestfs.pod:1569
3495 #, no-wrap
3496 msgid ""
3497 "   if (!has_function)\n"
3498 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3499 "   else {\n"
3500 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3501 "     /* Now it's safe to call\n"
3502 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3503 "     */\n"
3504 "   }\n"
3505 " #else\n"
3506 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3507 " #endif\n"
3508 "  }\n"
3509 "\n"
3510 msgstr ""
3511
3512 # type: textblock
3513 #. type: textblock
3514 #: ../src/guestfs.pod:1582
3515 msgid ""
3516 "You may think the above is an awful lot of hassle, and it is.  There are "
3517 "other ways outside of the C linking system to ensure that this kind of "
3518 "incompatibility never arises, such as using package versioning:"
3519 msgstr ""
3520
3521 # type: verbatim
3522 #. type: verbatim
3523 #: ../src/guestfs.pod:1587
3524 #, no-wrap
3525 msgid ""
3526 " Requires: libguestfs >= 1.0.80\n"
3527 "\n"
3528 msgstr ""
3529
3530 # type: =head1
3531 #. type: =head1
3532 #: ../src/guestfs.pod:1589
3533 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3534 msgstr ""
3535
3536 # type: textblock
3537 #. type: textblock
3538 #: ../src/guestfs.pod:1591
3539 msgid ""
3540 "A recent feature of the API is the introduction of calls which take optional "
3541 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3542 "takes variable arguments (ie. C<...>), as in this example:"
3543 msgstr ""
3544
3545 # type: verbatim
3546 #. type: verbatim
3547 #: ../src/guestfs.pod:1596
3548 #, no-wrap
3549 msgid ""
3550 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3551 "\n"
3552 msgstr ""
3553
3554 # type: textblock
3555 #. type: textblock
3556 #: ../src/guestfs.pod:1598
3557 msgid ""
3558 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3559 "call with no optional arguments specified:"
3560 msgstr ""
3561
3562 # type: verbatim
3563 #. type: verbatim
3564 #: ../src/guestfs.pod:1601
3565 #, no-wrap
3566 msgid ""
3567 " guestfs_add_drive_opts (g, filename, -1);\n"
3568 "\n"
3569 msgstr ""
3570
3571 # type: textblock
3572 #. type: textblock
3573 #: ../src/guestfs.pod:1603
3574 msgid "With a single optional argument:"
3575 msgstr ""
3576
3577 # type: verbatim
3578 #. type: verbatim
3579 #: ../src/guestfs.pod:1605
3580 #, no-wrap
3581 msgid ""
3582 " guestfs_add_drive_opts (g, filename,\n"
3583 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3584 "                         -1);\n"
3585 "\n"
3586 msgstr ""
3587
3588 # type: textblock
3589 #. type: textblock
3590 #: ../src/guestfs.pod:1609
3591 msgid "With two:"
3592 msgstr ""
3593
3594 # type: verbatim
3595 #. type: verbatim
3596 #: ../src/guestfs.pod:1611
3597 #, no-wrap
3598 msgid ""
3599 " guestfs_add_drive_opts (g, filename,\n"
3600 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3601 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3602 "                         -1);\n"
3603 "\n"
3604 msgstr ""
3605
3606 # type: textblock
3607 #. type: textblock
3608 #: ../src/guestfs.pod:1616
3609 msgid ""
3610 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3611 "happen!"
3612 msgstr ""
3613
3614 # type: =head2
3615 #. type: =head2
3616 #: ../src/guestfs.pod:1619
3617 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3618 msgstr ""
3619
3620 # type: textblock
3621 #. type: textblock
3622 #: ../src/guestfs.pod:1621
3623 msgid ""
3624 "The second variant has the same name with the suffix C<_va>, which works the "
3625 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3626 "example function, this is declared:"
3627 msgstr ""
3628
3629 # type: verbatim
3630 #. type: verbatim
3631 #: ../src/guestfs.pod:1625
3632 #, no-wrap
3633 msgid ""
3634 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3635 "                                va_list args);\n"
3636 "\n"
3637 msgstr ""
3638
3639 # type: =head2
3640 #. type: =head2
3641 #: ../src/guestfs.pod:1628
3642 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3643 msgstr ""
3644
3645 # type: textblock
3646 #. type: textblock
3647 #: ../src/guestfs.pod:1630
3648 msgid ""
3649 "The third variant is useful where you need to construct these calls.  You "
3650 "pass in a structure where you fill in the optional fields.  The structure "
3651 "has a bitmask as the first element which you must set to indicate which "
3652 "fields you have filled in.  For our example function the structure and call "
3653 "are declared:"
3654 msgstr ""
3655
3656 # type: verbatim
3657 #. type: verbatim
3658 #: ../src/guestfs.pod:1636
3659 #, no-wrap
3660 msgid ""
3661 " struct guestfs_add_drive_opts_argv {\n"
3662 "   uint64_t bitmask;\n"
3663 "   int readonly;\n"
3664 "   const char *format;\n"
3665 "   /* ... */\n"
3666 " };\n"
3667 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3668 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3669 "\n"
3670 msgstr ""
3671
3672 # type: textblock
3673 #. type: textblock
3674 #: ../src/guestfs.pod:1645
3675 msgid "You could call it like this:"
3676 msgstr ""
3677
3678 # type: verbatim
3679 #. type: verbatim
3680 #: ../src/guestfs.pod:1647
3681 #, no-wrap
3682 msgid ""
3683 " struct guestfs_add_drive_opts_argv optargs = {\n"
3684 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3685 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3686 "   .readonly = 1,\n"
3687 "   .format = \"qcow2\"\n"
3688 " };\n"
3689 " \n"
3690 msgstr ""
3691
3692 # type: verbatim
3693 #. type: verbatim
3694 #: ../src/guestfs.pod:1654
3695 #, no-wrap
3696 msgid ""
3697 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3698 "\n"
3699 msgstr ""
3700
3701 # type: textblock
3702 #. type: textblock
3703 #: ../src/guestfs.pod:1656 ../src/guestfs-actions.pod:11
3704 #: ../src/guestfs-actions.pod:1850 ../fish/guestfish-actions.pod:9
3705 #: ../fish/guestfish-actions.pod:1260 ../tools/virt-win-reg.pl:532
3706 msgid "Notes:"
3707 msgstr ""
3708
3709 # type: textblock
3710 #. type: textblock
3711 #: ../src/guestfs.pod:1662
3712 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3713 msgstr ""
3714
3715 # type: textblock
3716 #. type: textblock
3717 #: ../src/guestfs.pod:1667
3718 msgid "You do not need to fill in all fields of the structure."
3719 msgstr ""
3720
3721 # type: textblock
3722 #. type: textblock
3723 #: ../src/guestfs.pod:1671
3724 msgid ""
3725 "There must be a one-to-one correspondence between fields of the structure "
3726 "that are filled in, and bits set in the bitmask."
3727 msgstr ""
3728
3729 # type: =head2
3730 #. type: =head2
3731 #: ../src/guestfs.pod:1676
3732 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3733 msgstr ""
3734
3735 # type: textblock
3736 #. type: textblock
3737 #: ../src/guestfs.pod:1678
3738 msgid ""
3739 "In other languages, optional arguments are expressed in the way that is "
3740 "natural for that language.  We refer you to the language-specific "
3741 "documentation for more details on that."
3742 msgstr ""
3743
3744 # type: textblock
3745 #. type: textblock
3746 #: ../src/guestfs.pod:1682
3747 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3748 msgstr ""
3749
3750 # type: =head2
3751 #. type: =head2
3752 #: ../src/guestfs.pod:1684
3753 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3754 msgstr ""
3755
3756 # type: textblock
3757 #. type: textblock
3758 #: ../src/guestfs.pod:1686
3759 msgid ""
3760 "The child process generates events in some situations.  Current events "
3761 "include: receiving a log message, the child process exits."
3762 msgstr ""
3763
3764 # type: textblock
3765 #. type: textblock
3766 #: ../src/guestfs.pod:1689
3767 msgid ""
3768 "Use the C<guestfs_set_*_callback> functions to set a callback for different "
3769 "types of events."
3770 msgstr ""
3771
3772 # type: textblock
3773 #. type: textblock
3774 #: ../src/guestfs.pod:1692
3775 msgid ""
3776 "Only I<one callback of each type> can be registered for each handle.  "
3777 "Calling C<guestfs_set_*_callback> again overwrites the previous callback of "
3778 "that type.  Cancel all callbacks of this type by calling this function with "
3779 "C<cb> set to C<NULL>."
3780 msgstr ""
3781
3782 # type: =head2
3783 #. type: =head2
3784 #: ../src/guestfs.pod:1697
3785 msgid "guestfs_set_log_message_callback"
3786 msgstr ""
3787
3788 # type: verbatim
3789 #. type: verbatim
3790 #: ../src/guestfs.pod:1699
3791 #, no-wrap
3792 msgid ""
3793 " typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n"
3794 "                                         char *buf, int len);\n"
3795 " void guestfs_set_log_message_callback (guestfs_h *g,\n"
3796 "                                        guestfs_log_message_cb cb,\n"
3797 "                                        void *opaque);\n"
3798 "\n"
3799 msgstr ""
3800
3801 # type: textblock
3802 #. type: textblock
3803 #: ../src/guestfs.pod:1705
3804 msgid ""
3805 "The callback function C<cb> will be called whenever qemu or the guest writes "
3806 "anything to the console."
3807 msgstr ""
3808
3809 # type: textblock
3810 #. type: textblock
3811 #: ../src/guestfs.pod:1708
3812 msgid "Use this function to capture kernel messages and similar."
3813 msgstr ""
3814
3815 # type: textblock
3816 #. type: textblock
3817 #: ../src/guestfs.pod:1710
3818 msgid ""
3819 "Normally there is no log message handler, and log messages are just "
3820 "discarded."
3821 msgstr ""
3822
3823 # type: =head2
3824 #. type: =head2
3825 #: ../src/guestfs.pod:1713
3826 msgid "guestfs_set_subprocess_quit_callback"
3827 msgstr ""
3828
3829 # type: verbatim
3830 #. type: verbatim
3831 #: ../src/guestfs.pod:1715
3832 #, no-wrap
3833 msgid ""
3834 " typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n"
3835 " void guestfs_set_subprocess_quit_callback (guestfs_h *g,\n"
3836 "                                            guestfs_subprocess_quit_cb cb,\n"
3837 "                                            void *opaque);\n"
3838 "\n"
3839 msgstr ""
3840
3841 # type: textblock
3842 #. type: textblock
3843 #: ../src/guestfs.pod:1720
3844 msgid ""
3845 "The callback function C<cb> will be called when the child process quits, "
3846 "either asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3847 "corresponds to a transition from any state to the CONFIG state)."
3848 msgstr ""
3849
3850 # type: =head2
3851 #. type: =head2
3852 #: ../src/guestfs.pod:1725
3853 msgid "guestfs_set_launch_done_callback"
3854 msgstr ""
3855
3856 # type: verbatim
3857 #. type: verbatim
3858 #: ../src/guestfs.pod:1727
3859 #, no-wrap
3860 msgid ""
3861 " typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n"
3862 " void guestfs_set_launch_done_callback (guestfs_h *g,\n"
3863 "                                        guestfs_launch_done_cb cb,\n"
3864 "                                        void *opaque);\n"
3865 "\n"
3866 msgstr ""
3867
3868 # type: textblock
3869 #. type: textblock
3870 #: ../src/guestfs.pod:1732
3871 msgid ""
3872 "The callback function C<cb> will be called when the child process becomes "
3873 "ready first time after it has been launched.  (This corresponds to a "
3874 "transition from LAUNCHING to the READY state)."
3875 msgstr ""
3876
3877 # type: =head2
3878 #. type: =head2
3879 #: ../src/guestfs.pod:1736
3880 msgid "guestfs_set_close_callback"
3881 msgstr ""
3882
3883 # type: verbatim
3884 #. type: verbatim
3885 #: ../src/guestfs.pod:1738
3886 #, no-wrap
3887 msgid ""
3888 " typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n"
3889 " void guestfs_set_close_callback (guestfs_h *g,\n"
3890 "                                  guestfs_close_cb cb,\n"
3891 "                                  void *opaque);\n"
3892 "\n"
3893 msgstr ""
3894
3895 # type: textblock
3896 #. type: textblock
3897 #: ../src/guestfs.pod:1743
3898 msgid ""
3899 "The callback function C<cb> will be called while the handle is being closed "
3900 "(synchronously from L</guestfs_close>)."
3901 msgstr ""
3902
3903 # type: textblock
3904 #. type: textblock
3905 #: ../src/guestfs.pod:1746
3906 msgid ""
3907 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3908 "handles that are open when the program exits.  This means that this callback "
3909 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3910 "problems in higher-level languages (eg. if your HLL interpreter has already "
3911 "been cleaned up by the time this is called, and if your callback then jumps "
3912 "into some HLL function)."
3913 msgstr ""
3914
3915 # type: =head2
3916 #. type: =head2
3917 #: ../src/guestfs.pod:1754
3918 msgid "guestfs_set_progress_callback"
3919 msgstr ""
3920
3921 # type: verbatim
3922 #. type: verbatim
3923 #: ../src/guestfs.pod:1756
3924 #, no-wrap
3925 msgid ""
3926 " typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n"
3927 "                                      int proc_nr, int serial,\n"
3928 "                                      uint64_t position, uint64_t total);\n"
3929 " void guestfs_set_progress_callback (guestfs_h *g,\n"
3930 "                                     guestfs_progress_cb cb,\n"
3931 "                                     void *opaque);\n"
3932 "\n"
3933 msgstr ""
3934
3935 # type: textblock
3936 #. type: textblock
3937 #: ../src/guestfs.pod:1763
3938 msgid ""
3939 "Some long-running operations can generate progress messages.  If this "
3940 "callback is registered, then it will be called each time a progress message "
3941 "is generated (usually two seconds after the operation started, and three "
3942 "times per second thereafter until it completes, although the frequency may "
3943 "change in future versions)."
3944 msgstr ""
3945
3946 # type: textblock
3947 #. type: textblock
3948 #: ../src/guestfs.pod:1769
3949 msgid ""
3950 "The callback receives two numbers: C<position> and C<total>.  The units of "
3951 "C<total> are not defined, although for some operations C<total> may relate "
3952 "in some way to the amount of data to be transferred (eg. in bytes or "
3953 "megabytes), and C<position> may be the portion which has been transferred."
3954 msgstr ""
3955
3956 # type: textblock
3957 #. type: textblock
3958 #: ../src/guestfs.pod:1775
3959 msgid "The only defined and stable parts of the API are:"
3960 msgstr ""
3961
3962 # type: textblock
3963 #. type: textblock
3964 #: ../src/guestfs.pod:1781
3965 msgid ""
3966 "The callback can display to the user some type of progress bar or indicator "
3967 "which shows the ratio of C<position>:C<total>."
3968 msgstr ""
3969
3970 # type: textblock
3971 #. type: textblock
3972 #: ../src/guestfs.pod:1786
3973 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3974 msgstr ""
3975
3976 # type: textblock
3977 #. type: textblock
3978 #: ../src/guestfs.pod:1790
3979 msgid ""
3980 "If any progress notification is sent during a call, then a final progress "
3981 "notification is always sent when C<position> = C<total>."
3982 msgstr ""
3983
3984 # type: textblock
3985 #. type: textblock
3986 #: ../src/guestfs.pod:1793
3987 msgid ""
3988 "This is to simplify caller code, so callers can easily set the progress "
3989 "indicator to \"100%\" at the end of the operation, without requiring special "
3990 "code to detect this case."
3991 msgstr ""
3992
3993 # type: textblock
3994 #. type: textblock
3995 #: ../src/guestfs.pod:1799
3996 msgid ""
3997 "The callback also receives the procedure number and serial number of the "
3998 "call.  These are only useful for debugging protocol issues, and the callback "
3999 "can normally ignore them.  The callback may want to print these numbers in "
4000 "error messages or debugging messages."
4001 msgstr ""
4002
4003 # type: =head1
4004 #. type: =head1
4005 #: ../src/guestfs.pod:1804
4006 msgid "PRIVATE DATA AREA"
4007 msgstr ""
4008
4009 # type: textblock
4010 #. type: textblock
4011 #: ../src/guestfs.pod:1806
4012 msgid ""
4013 "You can attach named pieces of private data to the libguestfs handle, and "
4014 "fetch them by name for the lifetime of the handle.  This is called the "
4015 "private data area and is only available from the C API."
4016 msgstr ""
4017
4018 # type: textblock
4019 #. type: textblock
4020 #: ../src/guestfs.pod:1810
4021 msgid "To attach a named piece of data, use the following call:"
4022 msgstr ""
4023
4024 # type: verbatim
4025 #. type: verbatim
4026 #: ../src/guestfs.pod:1812
4027 #, no-wrap
4028 msgid ""
4029 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
4030 "\n"
4031 msgstr ""
4032
4033 # type: textblock
4034 #. type: textblock
4035 #: ../src/guestfs.pod:1814
4036 msgid ""
4037 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
4038 "pointer (which can be C<NULL>).  Any previous item with the same name is "
4039 "overwritten."
4040 msgstr ""
4041
4042 # type: textblock
4043 #. type: textblock
4044 #: ../src/guestfs.pod:1818
4045 msgid ""
4046 "You can use any C<key> you want, but names beginning with an underscore "
4047 "character are reserved for internal libguestfs purposes (for implementing "
4048 "language bindings).  It is recommended to prefix the name with some unique "
4049 "string to avoid collisions with other users."
4050 msgstr ""
4051
4052 # type: textblock
4053 #. type: textblock
4054 #: ../src/guestfs.pod:1823
4055 msgid "To retrieve the pointer, use:"
4056 msgstr ""
4057
4058 # type: verbatim
4059 #. type: verbatim
4060 #: ../src/guestfs.pod:1825
4061 #, no-wrap
4062 msgid ""
4063 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
4064 "\n"
4065 msgstr ""
4066
4067 # type: textblock
4068 #. type: textblock
4069 #: ../src/guestfs.pod:1827
4070 msgid ""
4071 "This function returns C<NULL> if either no data is found associated with "
4072 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
4073 "C<NULL>."
4074 msgstr ""
4075
4076 # type: textblock
4077 #. type: textblock
4078 #: ../src/guestfs.pod:1831
4079 msgid ""
4080 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
4081 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
4082 "all.  In particular, libguestfs does I<not> try to free the data when the "
4083 "handle is closed.  If the data must be freed, then the caller must either "
4084 "free it before calling L</guestfs_close> or must set up a close callback to "
4085 "do it (see L</guestfs_set_close_callback>, and note that only one callback "
4086 "can be registered for a handle)."
4087 msgstr ""
4088
4089 # type: textblock
4090 #. type: textblock
4091 #: ../src/guestfs.pod:1839
4092 msgid ""
4093 "The private data area is implemented using a hash table, and should be "
4094 "reasonably efficient for moderate numbers of keys."
4095 msgstr ""
4096
4097 # type: =end
4098 #. type: =end
4099 #: ../src/guestfs.pod:1842 ../src/guestfs.pod:1847
4100 msgid "html"
4101 msgstr ""
4102
4103 # type: textblock
4104 #. type: textblock
4105 #: ../src/guestfs.pod:1844
4106 msgid ""
4107 "<!-- old anchor for the next section --> <a name="
4108 "\"state_machine_and_low_level_event_api\"/>"
4109 msgstr ""
4110
4111 # type: =head1
4112 #. type: =head1
4113 #: ../src/guestfs.pod:1849
4114 msgid "ARCHITECTURE"
4115 msgstr ""
4116
4117 # type: textblock
4118 #. type: textblock
4119 #: ../src/guestfs.pod:1851
4120 msgid ""
4121 "Internally, libguestfs is implemented by running an appliance (a special "
4122 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4123 "process of the main program."
4124 msgstr ""
4125
4126 # type: verbatim
4127 #. type: verbatim
4128 #: ../src/guestfs.pod:1855
4129 #, no-wrap
4130 msgid ""
4131 "  ___________________\n"
4132 " /                   \\\n"
4133 " | main program      |\n"
4134 " |                   |\n"
4135 " |                   |           child process / appliance\n"
4136 " |                   |           __________________________\n"
4137 " |                   |          / qemu                     \\\n"
4138 " +-------------------+   RPC    |      +-----------------+ |\n"
4139 " | libguestfs     <--------------------> guestfsd        | |\n"
4140 " |                   |          |      +-----------------+ |\n"
4141 " \\___________________/          |      | Linux kernel    | |\n"
4142 "                                |      +--^--------------+ |\n"
4143 "                                \\_________|________________/\n"
4144 "                                          |\n"
4145 "                                   _______v______\n"
4146 "                                  /              \\\n"
4147 "                                  | Device or    |\n"
4148 "                                  | disk image   |\n"
4149 "                                  \\______________/\n"
4150 "\n"
4151 msgstr ""
4152
4153 # type: textblock
4154 #. type: textblock
4155 #: ../src/guestfs.pod:1875
4156 msgid ""
4157 "The library, linked to the main program, creates the child process and hence "
4158 "the appliance in the L</guestfs_launch> function."
4159 msgstr ""
4160
4161 # type: textblock
4162 #. type: textblock
4163 #: ../src/guestfs.pod:1878
4164 msgid ""
4165 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4166 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4167 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4168 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4169 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4170 "attached to the qemu process which translates device access by the "
4171 "appliance's Linux kernel into accesses to the image."
4172 msgstr ""
4173
4174 # type: textblock
4175 #. type: textblock
4176 #: ../src/guestfs.pod:1887
4177 msgid ""
4178 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4179 "Although the disk image you are attached to might also be used by some "
4180 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4181 "care if both libguestfs's qemu process and your virtual machine are trying "
4182 "to update the disk image at the same time, since these usually results in "
4183 "massive disk corruption)."
4184 msgstr ""
4185
4186 # type: =head1
4187 #. type: =head1
4188 #: ../src/guestfs.pod:1894
4189 msgid "STATE MACHINE"
4190 msgstr ""
4191
4192 # type: textblock
4193 #. type: textblock
4194 #: ../src/guestfs.pod:1896
4195 msgid "libguestfs uses a state machine to model the child process:"
4196 msgstr ""
4197
4198 # type: verbatim
4199 #. type: verbatim
4200 #: ../src/guestfs.pod:1898
4201 #, no-wrap
4202 msgid ""
4203 "                         |\n"
4204 "                    guestfs_create\n"
4205 "                         |\n"
4206 "                         |\n"
4207 "                     ____V_____\n"
4208 "                    /          \\\n"
4209 "                    |  CONFIG  |\n"
4210 "                    \\__________/\n"
4211 "                     ^ ^   ^  \\\n"
4212 "                    /  |    \\  \\ guestfs_launch\n"
4213 "                   /   |    _\\__V______\n"
4214 "                  /    |   /           \\\n"
4215 "                 /     |   | LAUNCHING |\n"
4216 "                /      |   \\___________/\n"
4217 "               /       |       /\n"
4218 "              /        |  guestfs_launch\n"
4219 "             /         |     /\n"
4220 "    ______  /        __|____V\n"
4221 "   /      \\ ------> /        \\\n"
4222 "   | BUSY |         | READY  |\n"
4223 "   \\______/ <------ \\________/\n"
4224 "\n"
4225 msgstr ""
4226
4227 # type: textblock
4228 #. type: textblock
4229 #: ../src/guestfs.pod:1920
4230 msgid ""
4231 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4232 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4233 "(3) alternating between READY and BUSY as commands are issued to, and "
4234 "carried out by, the child process."
4235 msgstr ""
4236
4237 # type: textblock
4238 #. type: textblock
4239 #: ../src/guestfs.pod:1925
4240 msgid ""
4241 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4242 "asynchronously at any time (eg. due to some internal error), and that causes "
4243 "the state to transition back to CONFIG."
4244 msgstr ""
4245
4246 # type: textblock
4247 #. type: textblock
4248 #: ../src/guestfs.pod:1929
4249 msgid ""
4250 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4251 "issued when in the CONFIG state."
4252 msgstr ""
4253
4254 # type: textblock
4255 #. type: textblock
4256 #: ../src/guestfs.pod:1932
4257 msgid ""
4258 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4259 "L</guestfs_launch> blocks until the child process is READY to accept "
4260 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4261 "moves the state from CONFIG to LAUNCHING while it is running."
4262 msgstr ""
4263
4264 # type: textblock
4265 #. type: textblock
4266 #: ../src/guestfs.pod:1938
4267 msgid ""
4268 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4269 "state.  These API calls block waiting for the command to be carried out (ie. "
4270 "the state to transition to BUSY and then back to READY).  There are no non-"
4271 "blocking versions, and no way to issue more than one command per handle at "
4272 "the same time."
4273 msgstr ""
4274
4275 # type: textblock
4276 #. type: textblock
4277 #: ../src/guestfs.pod:1944
4278 msgid ""
4279 "Finally, the child process sends asynchronous messages back to the main "
4280 "program, such as kernel log messages.  You can register a callback to "
4281 "receive these messages."
4282 msgstr ""
4283
4284 # type: =head1
4285 #. type: =head1
4286 #: ../src/guestfs.pod:1948
4287 msgid "INTERNALS"
4288 msgstr ""
4289
4290 # type: =head2
4291 #. type: =head2
4292 #: ../src/guestfs.pod:1950
4293 msgid "COMMUNICATION PROTOCOL"
4294 msgstr ""
4295
4296 # type: textblock
4297 #. type: textblock
4298 #: ../src/guestfs.pod:1952
4299 msgid ""
4300 "Don't rely on using this protocol directly.  This section documents how it "
4301 "currently works, but it may change at any time."
4302 msgstr ""
4303
4304 # type: textblock
4305 #. type: textblock
4306 #: ../src/guestfs.pod:1955
4307 msgid ""
4308 "The protocol used to talk between the library and the daemon running inside "
4309 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4310 "1014, RFC 1832, RFC 4506)."
4311 msgstr ""
4312
4313 # type: textblock
4314 #. type: textblock
4315 #: ../src/guestfs.pod:1959
4316 msgid ""
4317 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4318 "this file is automatically generated)."
4319 msgstr ""
4320
4321 # type: textblock
4322 #. type: textblock
4323 #: ../src/guestfs.pod:1962
4324 msgid ""
4325 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4326 "and C<FileOut> parameters, which are handled with very simple request/reply "
4327 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4328 "parameters, which use the same request and reply messages, but they may also "
4329 "be followed by files sent using a chunked encoding."
4330 msgstr ""
4331
4332 # type: =head3
4333 #. type: =head3
4334 #: ../src/guestfs.pod:1969
4335 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4336 msgstr ""
4337
4338 # type: textblock
4339 #. type: textblock
4340 #: ../src/guestfs.pod:1971
4341 msgid "For ordinary functions, the request message is:"
4342 msgstr ""
4343
4344 # type: verbatim
4345 #. type: verbatim
4346 #: ../src/guestfs.pod:1973
4347 #, no-wrap
4348 msgid ""
4349 " total length (header + arguments,\n"
4350 "      but not including the length word itself)\n"
4351 " struct guestfs_message_header (encoded as XDR)\n"
4352 " struct guestfs_<foo>_args (encoded as XDR)\n"
4353 "\n"
4354 msgstr ""
4355
4356 # type: textblock
4357 #. type: textblock
4358 #: ../src/guestfs.pod:1978
4359 msgid ""
4360 "The total length field allows the daemon to allocate a fixed size buffer "
4361 "into which it slurps the rest of the message.  As a result, the total length "
4362 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4363 "effective size of any request is limited to somewhere under this size."
4364 msgstr ""
4365
4366 # type: textblock
4367 #. type: textblock
4368 #: ../src/guestfs.pod:1984
4369 msgid ""
4370 "Note also that many functions don't take any arguments, in which case the "
4371 "C<guestfs_I<foo>_args> is completely omitted."
4372 msgstr ""
4373
4374 # type: textblock
4375 #. type: textblock
4376 #: ../src/guestfs.pod:1987
4377 msgid ""
4378 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4379 "receiver knows what type of args structure to expect, or none at all."
4380 msgstr ""
4381
4382 # type: textblock
4383 #. type: textblock
4384 #: ../src/guestfs.pod:1991
4385 msgid ""
4386 "For functions that take optional arguments, the optional arguments are "
4387 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4388 "arguments.  A bitmask in the header indicates which optional arguments are "
4389 "meaningful.  The bitmask is also checked to see if it contains bits set "
4390 "which the daemon does not know about (eg. if more optional arguments were "
4391 "added in a later version of the library), and this causes the call to be "
4392 "rejected."
4393 msgstr ""
4394
4395 # type: textblock
4396 #. type: textblock
4397 #: ../src/guestfs.pod:1999
4398 msgid "The reply message for ordinary functions is:"
4399 msgstr ""
4400
4401 # type: verbatim
4402 #. type: verbatim
4403 #: ../src/guestfs.pod:2001
4404 #, no-wrap
4405 msgid ""
4406 " total length (header + ret,\n"
4407 "      but not including the length word itself)\n"
4408 " struct guestfs_message_header (encoded as XDR)\n"
4409 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4410 "\n"
4411 msgstr ""
4412
4413 # type: textblock
4414 #. type: textblock
4415 #: ../src/guestfs.pod:2006
4416 msgid ""
4417 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4418 "functions that return no formal return values."
4419 msgstr ""
4420
4421 # type: textblock
4422 #. type: textblock
4423 #: ../src/guestfs.pod:2009
4424 msgid ""
4425 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4426 msgstr ""
4427
4428 # type: textblock
4429 #. type: textblock
4430 #: ../src/guestfs.pod:2012
4431 msgid ""
4432 "In the case of an error, a flag is set in the header, and the reply message "
4433 "is slightly changed:"
4434 msgstr ""
4435
4436 # type: verbatim
4437 #. type: verbatim
4438 #: ../src/guestfs.pod:2015
4439 #, no-wrap
4440 msgid ""
4441 " total length (header + error,\n"
4442 "      but not including the length word itself)\n"
4443 " struct guestfs_message_header (encoded as XDR)\n"
4444 " struct guestfs_message_error (encoded as XDR)\n"
4445 "\n"
4446 msgstr ""
4447
4448 # type: textblock
4449 #. type: textblock
4450 #: ../src/guestfs.pod:2020
4451 msgid ""
4452 "The C<guestfs_message_error> structure contains the error message as a "
4453 "string."
4454 msgstr ""
4455
4456 # type: =head3
4457 #. type: =head3
4458 #: ../src/guestfs.pod:2023
4459 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4460 msgstr ""
4461
4462 # type: textblock
4463 #. type: textblock
4464 #: ../src/guestfs.pod:2025
4465 msgid ""
4466 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4467 "The normal request message is sent (see above).  However this is followed by "
4468 "a sequence of file chunks."
4469 msgstr ""
4470
4471 # type: verbatim
4472 #. type: verbatim
4473 #: ../src/guestfs.pod:2029
4474 #, no-wrap
4475 msgid ""
4476 " total length (header + arguments,\n"
4477 "      but not including the length word itself,\n"
4478 "      and not including the chunks)\n"
4479 " struct guestfs_message_header (encoded as XDR)\n"
4480 " struct guestfs_<foo>_args (encoded as XDR)\n"
4481 " sequence of chunks for FileIn param #0\n"
4482 " sequence of chunks for FileIn param #1 etc.\n"
4483 "\n"
4484 msgstr ""
4485
4486 # type: textblock
4487 #. type: textblock
4488 #: ../src/guestfs.pod:2037
4489 msgid "The \"sequence of chunks\" is:"
4490 msgstr ""
4491
4492 # type: verbatim
4493 #. type: verbatim
4494 #: ../src/guestfs.pod:2039
4495 #, no-wrap
4496 msgid ""
4497 " length of chunk (not including length word itself)\n"
4498 " struct guestfs_chunk (encoded as XDR)\n"
4499 " length of chunk\n"
4500 " struct guestfs_chunk (encoded as XDR)\n"
4501 "   ...\n"
4502 " length of chunk\n"
4503 " struct guestfs_chunk (with data.data_len == 0)\n"
4504 "\n"
4505 msgstr ""
4506
4507 # type: textblock
4508 #. type: textblock
4509 #: ../src/guestfs.pod:2047
4510 msgid ""
4511 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4512 "is set in the final chunk to indicate either successful completion or early "
4513 "cancellation."
4514 msgstr ""
4515
4516 # type: textblock
4517 #. type: textblock
4518 #: ../src/guestfs.pod:2051
4519 msgid ""
4520 "At time of writing there are no functions that have more than one FileIn "
4521 "parameter.  However this is (theoretically) supported, by sending the "
4522 "sequence of chunks for each FileIn parameter one after another (from left to "
4523 "right)."
4524 msgstr ""
4525
4526 # type: textblock
4527 #. type: textblock
4528 #: ../src/guestfs.pod:2056
4529 msgid ""
4530 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4531 "transfer.  The library does this by sending a chunk with a special flag set "
4532 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4533 "RPC, does I<not> send any reply, and goes back to reading the next request."
4534 msgstr ""
4535
4536 # type: textblock
4537 #. type: textblock
4538 #: ../src/guestfs.pod:2062
4539 msgid ""
4540 "The daemon may also cancel.  It does this by writing a special word "
4541 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4542 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4543 "cancel chunk).  The special word is chosen so that even if cancellation "
4544 "happens right at the end of the transfer (after the library has finished "
4545 "writing and has started listening for the reply), the \"spurious\" cancel "
4546 "flag will not be confused with the reply message."
4547 msgstr ""
4548
4549 # type: textblock
4550 #. type: textblock
4551 #: ../src/guestfs.pod:2071
4552 msgid ""
4553 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4554 "limit), and also files where the size is not known in advance (eg. from "
4555 "pipes or sockets).  However the chunks are rather small "
4556 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4557 "to keep much in memory."
4558 msgstr ""
4559
4560 # type: =head3
4561 #. type: =head3
4562 #: ../src/guestfs.pod:2077
4563 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4564 msgstr ""
4565
4566 # type: textblock
4567 #. type: textblock
4568 #: ../src/guestfs.pod:2079
4569 msgid ""
4570 "The protocol for FileOut parameters is exactly the same as for FileIn "
4571 "parameters, but with the roles of daemon and library reversed."
4572 msgstr ""
4573
4574 # type: verbatim
4575 #. type: verbatim
4576 #: ../src/guestfs.pod:2082
4577 #, no-wrap
4578 msgid ""
4579 " total length (header + ret,\n"
4580 "      but not including the length word itself,\n"
4581 "      and not including the chunks)\n"
4582 " struct guestfs_message_header (encoded as XDR)\n"
4583 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4584 " sequence of chunks for FileOut param #0\n"
4585 " sequence of chunks for FileOut param #1 etc.\n"
4586 "\n"
4587 msgstr ""
4588
4589 # type: =head3
4590 #. type: =head3
4591 #: ../src/guestfs.pod:2090
4592 msgid "INITIAL MESSAGE"
4593 msgstr ""
4594
4595 # type: textblock
4596 #. type: textblock
4597 #: ../src/guestfs.pod:2092
4598 msgid ""
4599 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4600 "which indicates that the guest and daemon is alive.  This is what L</"
4601 "guestfs_launch> waits for."
4602 msgstr ""
4603
4604 # type: =head3
4605 #. type: =head3
4606 #: ../src/guestfs.pod:2096
4607 msgid "PROGRESS NOTIFICATION MESSAGES"
4608 msgstr ""
4609
4610 # type: textblock
4611 #. type: textblock
4612 #: ../src/guestfs.pod:2098
4613 msgid ""
4614 "The daemon may send progress notification messages at any time.  These are "
4615 "distinguished by the normal length word being replaced by "
4616 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4617 msgstr ""
4618
4619 # type: textblock
4620 #. type: textblock
4621 #: ../src/guestfs.pod:2102
4622 msgid ""
4623 "The library turns them into progress callbacks (see "
4624 "C<guestfs_set_progress_callback>) if there is a callback registered, or "
4625 "discards them if not."
4626 msgstr ""
4627
4628 # type: textblock
4629 #. type: textblock
4630 #: ../src/guestfs.pod:2106
4631 msgid ""
4632 "The daemon self-limits the frequency of progress messages it sends (see "
4633 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
4634 "messages."
4635 msgstr ""
4636
4637 # type: =head1
4638 #. type: =head1
4639 #: ../src/guestfs.pod:2110
4640 msgid "LIBGUESTFS VERSION NUMBERS"
4641 msgstr ""
4642
4643 # type: textblock
4644 #. type: textblock
4645 #: ../src/guestfs.pod:2112
4646 msgid ""
4647 "Since April 2010, libguestfs has started to make separate development and "
4648 "stable releases, along with corresponding branches in our git repository.  "
4649 "These separate releases can be identified by version number:"
4650 msgstr ""
4651
4652 # type: verbatim
4653 #. type: verbatim
4654 #: ../src/guestfs.pod:2117
4655 #, no-wrap
4656 msgid ""
4657 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
4658 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
4659 "       |\n"
4660 "       v\n"
4661 " 1  .  3  .  5\n"
4662 " ^           ^\n"
4663 " |           |\n"
4664 " |           `-------- sub-version\n"
4665 " |\n"
4666 " `------ always '1' because we don't change the ABI\n"
4667 "\n"
4668 msgstr ""
4669
4670 # type: textblock
4671 #. type: textblock
4672 #: ../src/guestfs.pod:2128
4673 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
4674 msgstr ""
4675
4676 # type: textblock
4677 #. type: textblock
4678 #: ../src/guestfs.pod:2130
4679 msgid ""
4680 "As time passes we cherry pick fixes from the development branch and backport "
4681 "those into the stable branch, the effect being that the stable branch should "
4682 "get more stable and less buggy over time.  So the stable releases are ideal "
4683 "for people who don't need new features but would just like the software to "
4684 "work."
4685 msgstr ""
4686
4687 # type: textblock
4688 #. type: textblock
4689 #: ../src/guestfs.pod:2136
4690 msgid "Our criteria for backporting changes are:"
4691 msgstr ""
4692
4693 # type: textblock
4694 #. type: textblock
4695 #: ../src/guestfs.pod:2142
4696 msgid ""
4697 "Documentation changes which don't affect any code are backported unless the "
4698 "documentation refers to a future feature which is not in stable."
4699 msgstr ""
4700
4701 # type: textblock
4702 #. type: textblock
4703 #: ../src/guestfs.pod:2148
4704 msgid ""
4705 "Bug fixes which are not controversial, fix obvious problems, and have been "
4706 "well tested are backported."
4707 msgstr ""
4708
4709 # type: textblock
4710 #. type: textblock
4711 #: ../src/guestfs.pod:2153
4712 msgid ""
4713 "Simple rearrangements of code which shouldn't affect how it works get "
4714 "backported.  This is so that the code in the two branches doesn't get too "
4715 "far out of step, allowing us to backport future fixes more easily."
4716 msgstr ""
4717
4718 # type: textblock
4719 #. type: textblock
4720 #: ../src/guestfs.pod:2159
4721 msgid ""
4722 "We I<don't> backport new features, new APIs, new tools etc, except in one "
4723 "exceptional case: the new feature is required in order to implement an "
4724 "important bug fix."
4725 msgstr ""
4726
4727 # type: textblock
4728 #. type: textblock
4729 #: ../src/guestfs.pod:2165
4730 msgid ""
4731 "A new stable branch starts when we think the new features in development are "
4732 "substantial and compelling enough over the current stable branch to warrant "
4733 "it.  When that happens we create new stable and development versions 1.N.0 "
4734 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
4735 "stable at this point, but by backporting fixes from development, that branch "
4736 "will stabilize over time."
4737 msgstr ""
4738
4739 #. type: =head1
4740 #: ../src/guestfs.pod:2173
4741 msgid "EXTENDING LIBGUESTFS"
4742 msgstr ""
4743
4744 #. type: =head2
4745 #: ../src/guestfs.pod:2175
4746 msgid "ADDING A NEW API ACTION"
4747 msgstr ""
4748
4749 #. type: textblock
4750 #: ../src/guestfs.pod:2177
4751 msgid ""
4752 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
4753 "documentation) are generated, and this makes it easy to extend the "
4754 "libguestfs API."
4755 msgstr ""
4756
4757 #. type: textblock
4758 #: ../src/guestfs.pod:2181
4759 msgid "To add a new API action there are two changes:"
4760 msgstr ""
4761
4762 #. type: textblock
4763 #: ../src/guestfs.pod:2187
4764 msgid ""
4765 "You need to add a description of the call (name, parameters, return type, "
4766 "tests, documentation) to C<generator/generator_actions.ml>."
4767 msgstr ""
4768
4769 #. type: textblock
4770 #: ../src/guestfs.pod:2190
4771 msgid ""
4772 "There are two sorts of API action, depending on whether the call goes "
4773 "through to the daemon in the appliance, or is serviced entirely by the "
4774 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
4775 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
4776 "an example of the latter, since a trace flag is maintained in the handle and "
4777 "all tracing is done on the library side."
4778 msgstr ""
4779
4780 #. type: textblock
4781 #: ../src/guestfs.pod:2198
4782 msgid ""
4783 "Most new actions are of the first type, and get added to the "
4784 "C<daemon_functions> list.  Each function has a unique procedure number used "
4785 "in the RPC protocol which is assigned to that action when we publish "
4786 "libguestfs and cannot be reused.  Take the latest procedure number and "
4787 "increment it."
4788 msgstr ""
4789
4790 #. type: textblock
4791 #: ../src/guestfs.pod:2204
4792 msgid ""
4793 "For library-only actions of the second type, add to the "
4794 "C<non_daemon_functions> list.  Since these functions are serviced by the "
4795 "library and do not travel over the RPC mechanism to the daemon, these "
4796 "functions do not need a procedure number, and so the procedure number is set "
4797 "to C<-1>."
4798 msgstr ""
4799
4800 #. type: textblock
4801 #: ../src/guestfs.pod:2212
4802 msgid "Implement the action (in C):"
4803 msgstr ""
4804
4805 #. type: textblock
4806 #: ../src/guestfs.pod:2214
4807 msgid ""
4808 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
4809 "C<daemon/> directory."
4810 msgstr ""
4811
4812 #. type: textblock
4813 #: ../src/guestfs.pod:2217
4814 msgid ""
4815 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
4816 "(note: double underscore) in the C<src/> directory."
4817 msgstr ""
4818
4819 #. type: textblock
4820 #: ../src/guestfs.pod:2220
4821 msgid "In either case, use another function as an example of what to do."
4822 msgstr ""
4823
4824 #. type: textblock
4825 #: ../src/guestfs.pod:2224
4826 msgid "After making these changes, use C<make> to compile."
4827 msgstr ""
4828
4829 #. type: textblock
4830 #: ../src/guestfs.pod:2226
4831 msgid ""
4832 "Note that you don't need to implement the RPC, language bindings, manual "
4833 "pages or anything else.  It's all automatically generated from the OCaml "
4834 "description."
4835 msgstr ""
4836
4837 #. type: =head2
4838 #: ../src/guestfs.pod:2230
4839 msgid "ADDING TESTS FOR AN API ACTION"
4840 msgstr ""
4841
4842 #. type: textblock
4843 #: ../src/guestfs.pod:2232
4844 msgid ""
4845 "You can supply zero or as many tests as you want per API call.  The tests "
4846 "can either be added as part of the API description (C<generator/"
4847 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
4848 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
4849 "slower, so if possible use the first method."
4850 msgstr ""
4851
4852 #. type: textblock
4853 #: ../src/guestfs.pod:2238
4854 msgid ""
4855 "The following describes the test environment used when you add an API test "
4856 "in C<generator_actions.ml>."
4857 msgstr ""
4858
4859 #. type: textblock
4860 #: ../src/guestfs.pod:2241
4861 msgid "The test environment has 4 block devices:"
4862 msgstr ""
4863
4864 #. type: =item
4865 #: ../src/guestfs.pod:2245
4866 msgid "C</dev/sda> 500MB"
4867 msgstr ""
4868
4869 #. type: textblock
4870 #: ../src/guestfs.pod:2247
4871 msgid "General block device for testing."
4872 msgstr ""
4873
4874 #. type: =item
4875 #: ../src/guestfs.pod:2249
4876 msgid "C</dev/sdb> 50MB"
4877 msgstr ""
4878
4879 #. type: textblock
4880 #: ../src/guestfs.pod:2251
4881 msgid ""
4882 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
4883 "operations."
4884 msgstr ""
4885
4886 #. type: =item
4887 #: ../src/guestfs.pod:2254
4888 msgid "C</dev/sdc> 10MB"
4889 msgstr ""
4890
4891 #. type: textblock
4892 #: ../src/guestfs.pod:2256
4893 msgid "Used in a few tests where two block devices are needed."
4894 msgstr ""
4895
4896 #. type: =item
4897 #: ../src/guestfs.pod:2258
4898 msgid "C</dev/sdd>"
4899 msgstr ""
4900
4901 #. type: textblock
4902 #: ../src/guestfs.pod:2260
4903 msgid "ISO with fixed content (see C<images/test.iso>)."
4904 msgstr ""
4905
4906 #. type: textblock
4907 #: ../src/guestfs.pod:2264
4908 msgid ""
4909 "To be able to run the tests in a reasonable amount of time, the libguestfs "
4910 "appliance and block devices are reused between tests.  So don't try testing "
4911 "L</guestfs_kill_subprocess> :-x"
4912 msgstr ""
4913
4914 #. type: textblock
4915 #: ../src/guestfs.pod:2268
4916 msgid ""
4917 "Each test starts with an initial scenario, selected using one of the "
4918 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
4919 "initialize the disks mentioned above in a particular way as documented in "
4920 "C<generator_types.ml>.  You should not assume anything about the previous "
4921 "contents of other disks that are not initialized."
4922 msgstr ""
4923
4924 #. type: textblock
4925 #: ../src/guestfs.pod:2274
4926 msgid ""
4927 "You can add a prerequisite clause to any individual test.  This is a run-"
4928 "time check, which, if it fails, causes the test to be skipped.  Useful if "
4929 "testing a command which might not work on all variations of libguestfs "
4930 "builds.  A test that has prerequisite of C<Always> means to run "
4931 "unconditionally."
4932 msgstr ""
4933
4934 #. type: textblock
4935 #: ../src/guestfs.pod:2280
4936 msgid ""
4937 "In addition, packagers can skip individual tests by setting environment "
4938 "variables before running C<make check>."
4939 msgstr ""
4940
4941 #. type: verbatim
4942 #: ../src/guestfs.pod:2283
4943 #, no-wrap
4944 msgid ""
4945 " SKIP_TEST_<CMD>_<NUM>=1\n"
4946 "\n"
4947 msgstr ""
4948
4949 #. type: textblock
4950 #: ../src/guestfs.pod:2285
4951 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
4952 msgstr ""
4953
4954 #. type: textblock
4955 #: ../src/guestfs.pod:2287
4956 msgid "or:"
4957 msgstr ""
4958
4959 #. type: verbatim
4960 #: ../src/guestfs.pod:2289
4961 #, no-wrap
4962 msgid ""
4963 " SKIP_TEST_<CMD>=1\n"
4964 "\n"
4965 msgstr ""
4966
4967 #. type: textblock
4968 #: ../src/guestfs.pod:2291
4969 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
4970 msgstr ""
4971
4972 #. type: textblock
4973 #: ../src/guestfs.pod:2293
4974 msgid "Packagers can run only certain tests by setting for example:"
4975 msgstr ""
4976
4977 #. type: verbatim
4978 #: ../src/guestfs.pod:2295
4979 #, no-wrap
4980 msgid ""
4981 " TEST_ONLY=\"vfs_type zerofree\"\n"
4982 "\n"
4983 msgstr ""
4984
4985 #. type: textblock
4986 #: ../src/guestfs.pod:2297
4987 msgid ""
4988 "See C<capitests/tests.c> for more details of how these environment variables "
4989 "work."
4990 msgstr ""
4991
4992 #. type: =head2
4993 #: ../src/guestfs.pod:2300
4994 msgid "DEBUGGING NEW API ACTIONS"
4995 msgstr ""
4996
4997 #. type: textblock
4998 #: ../src/guestfs.pod:2302
4999 msgid "Test new actions work before submitting them."
5000 msgstr ""
5001
5002 #. type: textblock
5003 #: ../src/guestfs.pod:2304
5004 msgid "You can use guestfish to try out new commands."
5005 msgstr ""
5006
5007 #. type: textblock
5008 #: ../src/guestfs.pod:2306
5009 msgid ""
5010 "Debugging the daemon is a problem because it runs inside a minimal "
5011 "environment.  However you can fprintf messages in the daemon to stderr, and "
5012 "they will show up if you use C<guestfish -v>."
5013 msgstr ""
5014
5015 #. type: =head2
5016 #: ../src/guestfs.pod:2310
5017 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
5018 msgstr ""
5019
5020 #. type: textblock
5021 #: ../src/guestfs.pod:2312
5022 msgid ""
5023 "Our C source code generally adheres to some basic code-formatting "
5024 "conventions.  The existing code base is not totally consistent on this "
5025 "front, but we do prefer that contributed code be formatted similarly.  In "
5026 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
5027 "indentation level, and other than that, follow the K&R style."
5028 msgstr ""
5029
5030 #. type: textblock
5031 #: ../src/guestfs.pod:2318
5032 msgid ""
5033 "If you use Emacs, add the following to one of one of your start-up files (e."
5034 "g., ~/.emacs), to help ensure that you get indentation right:"
5035 msgstr ""
5036
5037 #. type: verbatim
5038 #: ../src/guestfs.pod:2321
5039 #, no-wrap
5040 msgid ""
5041 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
5042 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
5043 " (add-hook 'find-file-hook\n"
5044 "     '(lambda () (if (and buffer-file-name\n"
5045 "                          (string-match \"/libguestfs\\\\>\"\n"
5046 "                              (buffer-file-name))\n"
5047 "                          (not (string-equal mode-name \"Change Log\"))\n"
5048 "                          (not (string-equal mode-name \"Makefile\")))\n"
5049 "                     (setq indent-tabs-mode nil))))\n"
5050 " \n"
5051 msgstr ""
5052
5053 #. type: verbatim
5054 #: ../src/guestfs.pod:2331
5055 #, no-wrap
5056 msgid ""
5057 " ;;; When editing C sources in libguestfs, use this style.\n"
5058 " (defun libguestfs-c-mode ()\n"
5059 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
5060 "   (interactive)\n"
5061 "   (c-set-style \"K&R\")\n"
5062 "   (setq c-indent-level 2)\n"
5063 "   (setq c-basic-offset 2))\n"
5064 " (add-hook 'c-mode-hook\n"
5065 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
5066 "                               (buffer-file-name))\n"
5067 "                           (libguestfs-c-mode))))\n"
5068 "\n"
5069 msgstr ""
5070
5071 #. type: textblock
5072 #: ../src/guestfs.pod:2343
5073 msgid "Enable warnings when compiling (and fix any problems this finds):"
5074 msgstr ""
5075
5076 #. type: verbatim
5077 #: ../src/guestfs.pod:2346
5078 #, no-wrap
5079 msgid ""
5080 " ./configure --enable-gcc-warnings\n"
5081 "\n"
5082 msgstr ""
5083
5084 #. type: textblock
5085 #: ../src/guestfs.pod:2348
5086 msgid "Useful targets are:"
5087 msgstr ""
5088
5089 #. type: verbatim
5090 #: ../src/guestfs.pod:2350
5091 #, no-wrap
5092 msgid ""
5093 " make syntax-check  # checks the syntax of the C code\n"
5094 " make check         # runs the test suite\n"
5095 "\n"
5096 msgstr ""
5097
5098 #. type: =head2
5099 #: ../src/guestfs.pod:2353
5100 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
5101 msgstr ""
5102
5103 #. type: textblock
5104 #: ../src/guestfs.pod:2355
5105 msgid ""
5106 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
5107 "which are used to do shell quoting."
5108 msgstr ""
5109
5110 #. type: =item
5111 #: ../src/guestfs.pod:2360
5112 msgid "%Q"
5113 msgstr ""
5114
5115 #. type: textblock
5116 #: ../src/guestfs.pod:2362
5117 msgid ""
5118 "Simple shell quoted string.  Any spaces or other shell characters are "
5119 "escaped for you."
5120 msgstr ""
5121
5122 #. type: =item
5123 #: ../src/guestfs.pod:2365
5124 msgid "%R"
5125 msgstr ""
5126
5127 #. type: textblock
5128 #: ../src/guestfs.pod:2367
5129 msgid ""
5130 "Same as C<%Q> except the string is treated as a path which is prefixed by "
5131 "the sysroot."
5132 msgstr ""
5133
5134 # type: textblock
5135 #. type: textblock
5136 #: ../src/guestfs.pod:2372 ../fish/guestfish.pod:240 ../fish/guestfish.pod:599
5137 msgid "For example:"
5138 msgstr ""
5139
5140 #. type: verbatim
5141 #: ../src/guestfs.pod:2374
5142 #, no-wrap
5143 msgid ""
5144 " asprintf (&cmd, \"cat %R\", path);\n"
5145 "\n"
5146 msgstr ""
5147
5148 #. type: textblock
5149 #: ../src/guestfs.pod:2376
5150 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5151 msgstr ""
5152
5153 #. type: textblock
5154 #: ../src/guestfs.pod:2378
5155 msgid ""
5156 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5157 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5158 "they are not passed via the shell (instead, straight to exec).  You probably "
5159 "want to use the C<sysroot_path()> function however."
5160 msgstr ""
5161
5162 #. type: =head2
5163 #: ../src/guestfs.pod:2384
5164 msgid "SUBMITTING YOUR NEW API ACTIONS"
5165 msgstr ""
5166
5167 #. type: textblock
5168 #: ../src/guestfs.pod:2386
5169 msgid ""
5170 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5171 "libguestfs> and CC to L<rjones@redhat.com>."
5172 msgstr ""
5173
5174 #. type: =head2
5175 #: ../src/guestfs.pod:2390
5176 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5177 msgstr ""
5178
5179 #. type: textblock
5180 #: ../src/guestfs.pod:2392
5181 msgid "We support i18n (gettext anyhow) in the library."
5182 msgstr ""
5183
5184 #. type: textblock
5185 #: ../src/guestfs.pod:2394
5186 msgid ""
5187 "However many messages come from the daemon, and we don't translate those at "
5188 "the moment.  One reason is that the appliance generally has all locale files "
5189 "removed from it, because they take up a lot of space.  So we'd have to readd "
5190 "some of those, as well as copying our PO files into the appliance."
5191 msgstr ""
5192
5193 #. type: textblock
5194 #: ../src/guestfs.pod:2400
5195 msgid ""
5196 "Debugging messages are never translated, since they are intended for the "
5197 "programmers."
5198 msgstr ""
5199
5200 #. type: =head2
5201 #: ../src/guestfs.pod:2403
5202 msgid "SOURCE CODE SUBDIRECTORIES"
5203 msgstr ""
5204
5205 #. type: =item
5206 #: ../src/guestfs.pod:2407 ../src/guestfs-actions.pod:5686
5207 #: ../fish/guestfish-actions.pod:3808
5208 msgid "C<appliance>"
5209 msgstr ""
5210
5211 #. type: textblock
5212 #: ../src/guestfs.pod:2409
5213 msgid "The libguestfs appliance, build scripts and so on."
5214 msgstr ""
5215
5216 #. type: =item
5217 #: ../src/guestfs.pod:2411
5218 msgid "C<capitests>"
5219 msgstr ""
5220
5221 #. type: textblock
5222 #: ../src/guestfs.pod:2413
5223 msgid "Automated tests of the C API."
5224 msgstr ""
5225
5226 #. type: =item
5227 #: ../src/guestfs.pod:2415
5228 msgid "C<cat>"
5229 msgstr ""
5230
5231 #. type: textblock
5232 #: ../src/guestfs.pod:2417
5233 msgid ""
5234 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5235 "documentation."
5236 msgstr ""
5237
5238 #. type: =item
5239 #: ../src/guestfs.pod:2420
5240 msgid "C<contrib>"
5241 msgstr ""
5242
5243 #. type: textblock
5244 #: ../src/guestfs.pod:2422
5245 msgid "Outside contributions, experimental parts."
5246 msgstr ""
5247
5248 #. type: =item
5249 #: ../src/guestfs.pod:2424
5250 msgid "C<daemon>"
5251 msgstr ""
5252
5253 #. type: textblock
5254 #: ../src/guestfs.pod:2426
5255 msgid ""
5256 "The daemon that runs inside the libguestfs appliance and carries out actions."
5257 msgstr ""
5258
5259 #. type: =item
5260 #: ../src/guestfs.pod:2429
5261 msgid "C<df>"
5262 msgstr ""
5263
5264 #. type: textblock
5265 #: ../src/guestfs.pod:2431
5266 msgid "L<virt-df(1)> command and documentation."
5267 msgstr ""
5268
5269 #. type: =item
5270 #: ../src/guestfs.pod:2433
5271 msgid "C<examples>"
5272 msgstr ""
5273
5274 #. type: textblock
5275 #: ../src/guestfs.pod:2435
5276 msgid "C API example code."
5277 msgstr ""
5278
5279 #. type: =item
5280 #: ../src/guestfs.pod:2437
5281 msgid "C<fish>"
5282 msgstr ""
5283
5284 #. type: textblock
5285 #: ../src/guestfs.pod:2439
5286 msgid ""
5287 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5288 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5289 "L<virt-tar-out(1)>."
5290 msgstr ""
5291
5292 #. type: =item
5293 #: ../src/guestfs.pod:2443
5294 msgid "C<fuse>"
5295 msgstr ""
5296
5297 #. type: textblock
5298 #: ../src/guestfs.pod:2445
5299 msgid ""
5300 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5301 msgstr ""
5302
5303 #. type: =item
5304 #: ../src/guestfs.pod:2447
5305 msgid "C<generator>"
5306 msgstr ""
5307
5308 #. type: textblock
5309 #: ../src/guestfs.pod:2449
5310 msgid ""
5311 "The crucially important generator, used to automatically generate large "
5312 "amounts of boilerplate C code for things like RPC and bindings."
5313 msgstr ""
5314
5315 #. type: =item
5316 #: ../src/guestfs.pod:2452
5317 msgid "C<images>"
5318 msgstr ""
5319
5320 #. type: textblock
5321 #: ../src/guestfs.pod:2454
5322 msgid "Files used by the test suite."
5323 msgstr ""
5324
5325 #. type: textblock
5326 #: ../src/guestfs.pod:2456
5327 msgid "Some \"phony\" guest images which we test against."
5328 msgstr ""
5329
5330 #. type: =item
5331 #: ../src/guestfs.pod:2458
5332 msgid "C<inspector>"
5333 msgstr ""
5334
5335 #. type: textblock
5336 #: ../src/guestfs.pod:2460
5337 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5338 msgstr ""
5339
5340 #. type: =item
5341 #: ../src/guestfs.pod:2462
5342 msgid "C<logo>"
5343 msgstr ""
5344
5345 #. type: textblock
5346 #: ../src/guestfs.pod:2464
5347 msgid "Logo used on the website.  The fish is called Arthur by the way."
5348 msgstr ""
5349
5350 #. type: =item
5351 #: ../src/guestfs.pod:2466
5352 msgid "C<m4>"
5353 msgstr ""
5354
5355 #. type: textblock
5356 #: ../src/guestfs.pod:2468
5357 msgid "M4 macros used by autoconf."
5358 msgstr ""
5359
5360 #. type: =item
5361 #: ../src/guestfs.pod:2470
5362 msgid "C<po>"
5363 msgstr ""
5364
5365 #. type: textblock
5366 #: ../src/guestfs.pod:2472
5367 msgid "Translations of simple gettext strings."
5368 msgstr ""
5369
5370 #. type: =item
5371 #: ../src/guestfs.pod:2474
5372 msgid "C<po-docs>"
5373 msgstr ""
5374
5375 #. type: textblock
5376 #: ../src/guestfs.pod:2476
5377 msgid ""
5378 "The build infrastructure and PO files for translations of manpages and POD "
5379 "files.  Eventually this will be combined with the C<po> directory, but that "
5380 "is rather complicated."
5381 msgstr ""
5382
5383 #. type: =item
5384 #: ../src/guestfs.pod:2480
5385 msgid "C<regressions>"
5386 msgstr ""
5387
5388 #. type: textblock
5389 #: ../src/guestfs.pod:2482
5390 msgid "Regression tests."
5391 msgstr ""
5392
5393 #. type: =item
5394 #: ../src/guestfs.pod:2484
5395 msgid "C<rescue>"
5396 msgstr ""
5397
5398 #. type: textblock
5399 #: ../src/guestfs.pod:2486
5400 msgid "L<virt-rescue(1)> command and documentation."
5401 msgstr ""
5402
5403 #. type: =item
5404 #: ../src/guestfs.pod:2488
5405 msgid "C<src>"
5406 msgstr ""
5407
5408 #. type: textblock
5409 #: ../src/guestfs.pod:2490
5410 msgid "Source code to the C library."
5411 msgstr ""
5412
5413 #. type: =item
5414 #: ../src/guestfs.pod:2492
5415 msgid "C<tools>"
5416 msgstr ""
5417
5418 #. type: textblock
5419 #: ../src/guestfs.pod:2494
5420 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5421 msgstr ""
5422
5423 #. type: =item
5424 #: ../src/guestfs.pod:2496
5425 msgid "C<test-tool>"
5426 msgstr ""
5427
5428 #. type: textblock
5429 #: ../src/guestfs.pod:2498
5430 msgid ""
5431 "Test tool for end users to test if their qemu/kernel combination will work "
5432 "with libguestfs."
5433 msgstr ""
5434
5435 #. type: =item
5436 #: ../src/guestfs.pod:2501
5437 msgid "C<csharp>"
5438 msgstr ""
5439
5440 #. type: =item
5441 #: ../src/guestfs.pod:2503
5442 msgid "C<haskell>"
5443 msgstr ""
5444
5445 #. type: =item
5446 #: ../src/guestfs.pod:2505
5447 msgid "C<java>"
5448 msgstr ""
5449
5450 #. type: =item
5451 #: ../src/guestfs.pod:2507
5452 msgid "C<ocaml>"
5453 msgstr ""
5454
5455 #. type: =item
5456 #: ../src/guestfs.pod:2509
5457 msgid "C<php>"
5458 msgstr ""
5459
5460 #. type: =item
5461 #: ../src/guestfs.pod:2511
5462 msgid "C<perl>"
5463 msgstr ""
5464
5465 #. type: =item
5466 #: ../src/guestfs.pod:2513
5467 msgid "C<python>"
5468 msgstr ""
5469
5470 #. type: =item
5471 #: ../src/guestfs.pod:2515
5472 msgid "C<ruby>"
5473 msgstr ""
5474
5475 #. type: textblock
5476 #: ../src/guestfs.pod:2517
5477 msgid "Language bindings."
5478 msgstr ""
5479
5480 # type: =head1
5481 #. type: =head1
5482 #: ../src/guestfs.pod:2521 ../fish/guestfish.pod:996
5483 #: ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:330
5484 msgid "ENVIRONMENT VARIABLES"
5485 msgstr ""
5486
5487 # type: =item
5488 #. type: =item
5489 #: ../src/guestfs.pod:2525 ../fish/guestfish.pod:1022
5490 msgid "LIBGUESTFS_APPEND"
5491 msgstr ""
5492
5493 # type: textblock
5494 #. type: textblock
5495 #: ../src/guestfs.pod:2527 ../fish/guestfish.pod:1024
5496 msgid "Pass additional options to the guest kernel."
5497 msgstr ""
5498
5499 # type: =item
5500 #. type: =item
5501 #: ../src/guestfs.pod:2529 ../fish/guestfish.pod:1026
5502 msgid "LIBGUESTFS_DEBUG"
5503 msgstr ""
5504
5505 # type: textblock
5506 #. type: textblock
5507 #: ../src/guestfs.pod:2531
5508 msgid ""
5509 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
5510 "effect as calling C<guestfs_set_verbose (g, 1)>."
5511 msgstr ""
5512
5513 # type: =item
5514 #. type: =item
5515 #: ../src/guestfs.pod:2534 ../fish/guestfish.pod:1031
5516 msgid "LIBGUESTFS_MEMSIZE"
5517 msgstr ""
5518
5519 # type: textblock
5520 #. type: textblock
5521 #: ../src/guestfs.pod:2536 ../fish/guestfish.pod:1033
5522 msgid ""
5523 "Set the memory allocated to the qemu process, in megabytes.  For example:"
5524 msgstr ""
5525
5526 # type: verbatim
5527 #. type: verbatim
5528 #: ../src/guestfs.pod:2539 ../fish/guestfish.pod:1036
5529 #, no-wrap
5530 msgid ""
5531 " LIBGUESTFS_MEMSIZE=700\n"
5532 "\n"
5533 msgstr ""
5534
5535 # type: =item
5536 #. type: =item
5537 #: ../src/guestfs.pod:2541 ../fish/guestfish.pod:1038
5538 msgid "LIBGUESTFS_PATH"
5539 msgstr ""
5540
5541 # type: textblock
5542 #. type: textblock
5543 #: ../src/guestfs.pod:2543
5544 msgid ""
5545 "Set the path that libguestfs uses to search for kernel and initrd.img.  See "
5546 "the discussion of paths in section PATH above."
5547 msgstr ""
5548
5549 # type: =item
5550 #. type: =item
5551 #: ../src/guestfs.pod:2546 ../fish/guestfish.pod:1043
5552 msgid "LIBGUESTFS_QEMU"
5553 msgstr ""
5554
5555 # type: textblock
5556 #. type: textblock
5557 #: ../src/guestfs.pod:2548 ../fish/guestfish.pod:1045
5558 msgid ""
5559 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
5560 "which was found at compile time by the configure script is used."
5561 msgstr ""
5562
5563 # type: textblock
5564 #. type: textblock
5565 #: ../src/guestfs.pod:2552
5566 msgid "See also L</QEMU WRAPPERS> above."
5567 msgstr ""
5568
5569 # type: =item
5570 #. type: =item
5571 #: ../src/guestfs.pod:2554 ../fish/guestfish.pod:1049
5572 msgid "LIBGUESTFS_TRACE"
5573 msgstr ""
5574
5575 # type: textblock
5576 #. type: textblock
5577 #: ../src/guestfs.pod:2556
5578 msgid ""
5579 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
5580 "effect as calling C<guestfs_set_trace (g, 1)>."
5581 msgstr ""
5582
5583 # type: =item
5584 #. type: =item
5585 #: ../src/guestfs.pod:2559 ../fish/guestfish.pod:1058
5586 msgid "TMPDIR"
5587 msgstr ""
5588
5589 #. type: textblock
5590 #: ../src/guestfs.pod:2561 ../fish/guestfish.pod:1060
5591 msgid ""
5592 "Location of temporary directory, defaults to C</tmp> except for the cached "
5593 "supermin appliance which defaults to C</var/tmp>."
5594 msgstr ""
5595
5596 #. type: textblock
5597 #: ../src/guestfs.pod:2564 ../fish/guestfish.pod:1063
5598 msgid ""
5599 "If libguestfs was compiled to use the supermin appliance then the real "
5600 "appliance is cached in this directory, shared between all handles belonging "
5601 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
5602 "use in case C</var/tmp> is not large enough."
5603 msgstr ""
5604
5605 # type: =head1
5606 #. type: =head1
5607 #: ../src/guestfs.pod:2572 ../fish/guestfish.pod:1121
5608 #: ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:238
5609 #: ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:572
5610 #: ../tools/virt-resize.pl:1483 ../tools/virt-list-filesystems.pl:189
5611 #: ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:534
5612 #: ../tools/virt-list-partitions.pl:257
5613 msgid "SEE ALSO"
5614 msgstr ""
5615
5616 #. type: textblock
5617 #: ../src/guestfs.pod:2574
5618 msgid ""
5619 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-"
5620 "ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-copy-in"
5621 "(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems"
5622 "(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-"
5623 "partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-"
5624 "tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)"
5625 ">, L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
5626 msgstr ""
5627
5628 # type: textblock
5629 #. type: textblock
5630 #: ../src/guestfs.pod:2601
5631 msgid ""
5632 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
5633 "(8)>, L<disktype(1)>."
5634 msgstr ""
5635
5636 # type: =head1
5637 #. type: =head1
5638 #: ../src/guestfs.pod:2608 ../tools/virt-win-reg.pl:587
5639 #: ../tools/virt-make-fs.pl:548
5640 msgid "BUGS"
5641 msgstr ""
5642
5643 # type: textblock
5644 #. type: textblock
5645 #: ../src/guestfs.pod:2610
5646 msgid "To get a list of bugs against libguestfs use this link:"
5647 msgstr ""
5648
5649 # type: textblock
5650 #. type: textblock
5651 #: ../src/guestfs.pod:2612
5652 msgid ""
5653 "L<https://bugzilla.redhat.com/buglist.cgi?"
5654 "component=libguestfs&product=Virtualization+Tools>"
5655 msgstr ""
5656
5657 # type: textblock
5658 #. type: textblock
5659 #: ../src/guestfs.pod:2614
5660 msgid "To report a new bug against libguestfs use this link:"
5661 msgstr ""
5662
5663 # type: textblock
5664 #. type: textblock
5665 #: ../src/guestfs.pod:2616
5666 msgid ""
5667 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5668 "component=libguestfs&product=Virtualization+Tools>"
5669 msgstr ""
5670
5671 # type: textblock
5672 #. type: textblock
5673 #: ../src/guestfs.pod:2618
5674 msgid "When reporting a bug, please check:"
5675 msgstr ""
5676
5677 # type: textblock
5678 #. type: textblock
5679 #: ../src/guestfs.pod:2624
5680 msgid "That the bug hasn't been reported already."
5681 msgstr ""
5682
5683 # type: textblock
5684 #. type: textblock
5685 #: ../src/guestfs.pod:2628
5686 msgid "That you are testing a recent version."
5687 msgstr ""
5688
5689 # type: textblock
5690 #. type: textblock
5691 #: ../src/guestfs.pod:2632
5692 msgid "Describe the bug accurately, and give a way to reproduce it."
5693 msgstr ""
5694
5695 # type: textblock
5696 #. type: textblock
5697 #: ../src/guestfs.pod:2636
5698 msgid ""
5699 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
5700 "bug report."
5701 msgstr ""
5702
5703 # type: =head1
5704 #. type: =head1
5705 #: ../src/guestfs.pod:2641 ../fish/guestfish.pod:1144
5706 #: ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:249
5707 msgid "AUTHORS"
5708 msgstr ""
5709
5710 # type: textblock
5711 #. type: textblock
5712 #: ../src/guestfs.pod:2643 ../fish/guestfish.pod:1146
5713 #: ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:251
5714 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
5715 msgstr ""
5716
5717 # type: =head1
5718 #. type: =head1
5719 #: ../src/guestfs.pod:2645 ../fish/guestfish.pod:1148
5720 #: ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:253
5721 #: ../tools/virt-edit.pl:368 ../tools/virt-win-reg.pl:602
5722 #: ../tools/virt-resize.pl:1508 ../tools/virt-list-filesystems.pl:206
5723 #: ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:563
5724 #: ../tools/virt-list-partitions.pl:273
5725 msgid "COPYRIGHT"
5726 msgstr ""
5727
5728 # type: textblock
5729 #. type: textblock
5730 #: ../src/guestfs.pod:2647 ../fish/guestfish.pod:1150
5731 #: ../fuse/guestmount.pod:255
5732 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
5733 msgstr ""
5734
5735 # type: textblock
5736 #. type: textblock
5737 #: ../src/guestfs.pod:2650
5738 msgid ""
5739 "This library is free software; you can redistribute it and/or modify it "
5740 "under the terms of the GNU Lesser General Public License as published by the "
5741 "Free Software Foundation; either version 2 of the License, or (at your "
5742 "option) any later version."
5743 msgstr ""
5744
5745 # type: textblock
5746 #. type: textblock
5747 #: ../src/guestfs.pod:2655
5748 msgid ""
5749 "This library is distributed in the hope that it will be useful, but WITHOUT "
5750 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
5751 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
5752 "for more details."
5753 msgstr ""
5754
5755 # type: textblock
5756 #. type: textblock
5757 #: ../src/guestfs.pod:2660
5758 msgid ""
5759 "You should have received a copy of the GNU Lesser General Public License "
5760 "along with this library; if not, write to the Free Software Foundation, "
5761 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
5762 msgstr ""
5763
5764 # type: =head2
5765 #. type: =head2
5766 #: ../src/guestfs-actions.pod:1
5767 msgid "guestfs_add_cdrom"
5768 msgstr ""
5769
5770 # type: verbatim
5771 #. type: verbatim
5772 #: ../src/guestfs-actions.pod:3
5773 #, no-wrap
5774 msgid ""
5775 " int\n"
5776 " guestfs_add_cdrom (guestfs_h *g,\n"
5777 "                    const char *filename);\n"
5778 "\n"
5779 msgstr ""
5780
5781 # type: textblock
5782 #. type: textblock
5783 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
5784 msgid "This function adds a virtual CD-ROM disk image to the guest."
5785 msgstr ""
5786
5787 # type: textblock
5788 #. type: textblock
5789 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
5790 msgid "This is equivalent to the qemu parameter C<-cdrom filename>."
5791 msgstr ""
5792
5793 # type: textblock
5794 #. type: textblock
5795 #: ../src/guestfs-actions.pod:17
5796 msgid ""
5797 "This call checks for the existence of C<filename>.  This stops you from "
5798 "specifying other types of drive which are supported by qemu such as C<nbd:> "
5799 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
5800 "instead."
5801 msgstr ""
5802
5803 # type: textblock
5804 #. type: textblock
5805 #: ../src/guestfs-actions.pod:24
5806 msgid ""
5807 "If you just want to add an ISO file (often you use this as an efficient way "
5808 "to transfer large files into the guest), then you should probably use "
5809 "C<guestfs_add_drive_ro> instead."
5810 msgstr ""
5811
5812 # type: textblock
5813 #. type: textblock
5814 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134
5815 #: ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232
5816 #: ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267
5817 #: ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301
5818 #: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:436
5819 #: ../src/guestfs-actions.pod:450 ../src/guestfs-actions.pod:495
5820 #: ../src/guestfs-actions.pod:523 ../src/guestfs-actions.pod:541
5821 #: ../src/guestfs-actions.pod:608 ../src/guestfs-actions.pod:641
5822 #: ../src/guestfs-actions.pod:655 ../src/guestfs-actions.pod:670
5823 #: ../src/guestfs-actions.pod:769 ../src/guestfs-actions.pod:787
5824 #: ../src/guestfs-actions.pod:801 ../src/guestfs-actions.pod:815
5825 #: ../src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:996
5826 #: ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1098
5827 #: ../src/guestfs-actions.pod:1116 ../src/guestfs-actions.pod:1135
5828 #: ../src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1169
5829 #: ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1270
5830 #: ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1332
5831 #: ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1472
5832 #: ../src/guestfs-actions.pod:1690 ../src/guestfs-actions.pod:1712
5833 #: ../src/guestfs-actions.pod:1799 ../src/guestfs-actions.pod:2261
5834 #: ../src/guestfs-actions.pod:2405 ../src/guestfs-actions.pod:2466
5835 #: ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:3336
5836 #: ../src/guestfs-actions.pod:3351 ../src/guestfs-actions.pod:3371
5837 #: ../src/guestfs-actions.pod:3526 ../src/guestfs-actions.pod:3540
5838 #: ../src/guestfs-actions.pod:3553 ../src/guestfs-actions.pod:3567
5839 #: ../src/guestfs-actions.pod:3582 ../src/guestfs-actions.pod:3618
5840 #: ../src/guestfs-actions.pod:3690 ../src/guestfs-actions.pod:3710
5841 #: ../src/guestfs-actions.pod:3727 ../src/guestfs-actions.pod:3750
5842 #: ../src/guestfs-actions.pod:3773 ../src/guestfs-actions.pod:3805
5843 #: ../src/guestfs-actions.pod:3824 ../src/guestfs-actions.pod:3843
5844 #: ../src/guestfs-actions.pod:3878 ../src/guestfs-actions.pod:3890
5845 #: ../src/guestfs-actions.pod:3926 ../src/guestfs-actions.pod:3942
5846 #: ../src/guestfs-actions.pod:3955 ../src/guestfs-actions.pod:3970
5847 #: ../src/guestfs-actions.pod:3987 ../src/guestfs-actions.pod:4080
5848 #: ../src/guestfs-actions.pod:4100 ../src/guestfs-actions.pod:4113
5849 #: ../src/guestfs-actions.pod:4164 ../src/guestfs-actions.pod:4182
5850 #: ../src/guestfs-actions.pod:4200 ../src/guestfs-actions.pod:4216
5851 #: ../src/guestfs-actions.pod:4230 ../src/guestfs-actions.pod:4244
5852 #: ../src/guestfs-actions.pod:4261 ../src/guestfs-actions.pod:4276
5853 #: ../src/guestfs-actions.pod:4296 ../src/guestfs-actions.pod:4354
5854 #: ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4458
5855 #: ../src/guestfs-actions.pod:4477 ../src/guestfs-actions.pod:4496
5856 #: ../src/guestfs-actions.pod:4508 ../src/guestfs-actions.pod:4525
5857 #: ../src/guestfs-actions.pod:4538 ../src/guestfs-actions.pod:4553
5858 #: ../src/guestfs-actions.pod:4568 ../src/guestfs-actions.pod:4603
5859 #: ../src/guestfs-actions.pod:4618 ../src/guestfs-actions.pod:4638
5860 #: ../src/guestfs-actions.pod:4652 ../src/guestfs-actions.pod:4669
5861 #: ../src/guestfs-actions.pod:4718 ../src/guestfs-actions.pod:4755
5862 #: ../src/guestfs-actions.pod:4769 ../src/guestfs-actions.pod:4797
5863 #: ../src/guestfs-actions.pod:4814 ../src/guestfs-actions.pod:4832
5864 #: ../src/guestfs-actions.pod:4966 ../src/guestfs-actions.pod:5023
5865 #: ../src/guestfs-actions.pod:5045 ../src/guestfs-actions.pod:5063
5866 #: ../src/guestfs-actions.pod:5095 ../src/guestfs-actions.pod:5161
5867 #: ../src/guestfs-actions.pod:5178 ../src/guestfs-actions.pod:5191
5868 #: ../src/guestfs-actions.pod:5205 ../src/guestfs-actions.pod:5494
5869 #: ../src/guestfs-actions.pod:5513 ../src/guestfs-actions.pod:5532
5870 #: ../src/guestfs-actions.pod:5544 ../src/guestfs-actions.pod:5556
5871 #: ../src/guestfs-actions.pod:5570 ../src/guestfs-actions.pod:5582
5872 #: ../src/guestfs-actions.pod:5596 ../src/guestfs-actions.pod:5612
5873 #: ../src/guestfs-actions.pod:5633 ../src/guestfs-actions.pod:5652
5874 #: ../src/guestfs-actions.pod:5671 ../src/guestfs-actions.pod:5701
5875 #: ../src/guestfs-actions.pod:5717 ../src/guestfs-actions.pod:5740
5876 #: ../src/guestfs-actions.pod:5758 ../src/guestfs-actions.pod:5777
5877 #: ../src/guestfs-actions.pod:5798 ../src/guestfs-actions.pod:5817
5878 #: ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:5862
5879 #: ../src/guestfs-actions.pod:5886 ../src/guestfs-actions.pod:5905
5880 #: ../src/guestfs-actions.pod:5929 ../src/guestfs-actions.pod:5944
5881 #: ../src/guestfs-actions.pod:5959 ../src/guestfs-actions.pod:5978
5882 #: ../src/guestfs-actions.pod:6015 ../src/guestfs-actions.pod:6038
5883 #: ../src/guestfs-actions.pod:6064 ../src/guestfs-actions.pod:6172
5884 #: ../src/guestfs-actions.pod:6293 ../src/guestfs-actions.pod:6305
5885 #: ../src/guestfs-actions.pod:6318 ../src/guestfs-actions.pod:6331
5886 #: ../src/guestfs-actions.pod:6353 ../src/guestfs-actions.pod:6366
5887 #: ../src/guestfs-actions.pod:6379 ../src/guestfs-actions.pod:6392
5888 #: ../src/guestfs-actions.pod:6407 ../src/guestfs-actions.pod:6466
5889 #: ../src/guestfs-actions.pod:6483 ../src/guestfs-actions.pod:6499
5890 #: ../src/guestfs-actions.pod:6515 ../src/guestfs-actions.pod:6532
5891 #: ../src/guestfs-actions.pod:6545 ../src/guestfs-actions.pod:6565
5892 #: ../src/guestfs-actions.pod:6601 ../src/guestfs-actions.pod:6615
5893 #: ../src/guestfs-actions.pod:6656 ../src/guestfs-actions.pod:6669
5894 #: ../src/guestfs-actions.pod:6687 ../src/guestfs-actions.pod:6721
5895 #: ../src/guestfs-actions.pod:6757 ../src/guestfs-actions.pod:6876
5896 #: ../src/guestfs-actions.pod:6894 ../src/guestfs-actions.pod:6908
5897 #: ../src/guestfs-actions.pod:6963 ../src/guestfs-actions.pod:6976
5898 #: ../src/guestfs-actions.pod:7021 ../src/guestfs-actions.pod:7054
5899 #: ../src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7134
5900 #: ../src/guestfs-actions.pod:7200 ../src/guestfs-actions.pod:7219
5901 #: ../src/guestfs-actions.pod:7248
5902 msgid "This function returns 0 on success or -1 on error."
5903 msgstr ""
5904
5905 # type: textblock
5906 #. type: textblock
5907 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248
5908 #: ../src/guestfs-actions.pod:269 ../fish/guestfish-actions.pod:28
5909 #: ../fish/guestfish-actions.pod:158 ../fish/guestfish-actions.pod:172
5910 msgid ""
5911 "This function is deprecated.  In new code, use the C<add_drive_opts> call "
5912 "instead."
5913 msgstr ""
5914
5915 # type: textblock
5916 #. type: textblock
5917 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251
5918 #: ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1443
5919 #: ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:1960
5920 #: ../src/guestfs-actions.pod:4301 ../src/guestfs-actions.pod:7142
5921 #: ../src/guestfs-actions.pod:7311 ../fish/guestfish-actions.pod:31
5922 #: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175
5923 #: ../fish/guestfish-actions.pod:956 ../fish/guestfish-actions.pod:1319
5924 #: ../fish/guestfish-actions.pod:1333 ../fish/guestfish-actions.pod:2908
5925 #: ../fish/guestfish-actions.pod:4762 ../fish/guestfish-actions.pod:4859
5926 msgid ""
5927 "Deprecated functions will not be removed from the API, but the fact that "
5928 "they are deprecated indicates that there are problems with correct use of "
5929 "these functions."
5930 msgstr ""
5931
5932 # type: textblock
5933 #. type: textblock
5934 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136
5935 #: ../src/guestfs-actions.pod:1100 ../src/guestfs-actions.pod:1911
5936 #: ../src/guestfs-actions.pod:2009 ../src/guestfs-actions.pod:2112
5937 #: ../src/guestfs-actions.pod:3338 ../src/guestfs-actions.pod:3353
5938 #: ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:5719
5939 #: ../src/guestfs-actions.pod:5836 ../src/guestfs-actions.pod:5946
5940 #: ../src/guestfs-actions.pod:6409 ../src/guestfs-actions.pod:6534
5941 #: ../src/guestfs-actions.pod:7056
5942 msgid "(Added in 0.3)"
5943 msgstr ""
5944
5945 # type: =head2
5946 #. type: =head2
5947 #: ../src/guestfs-actions.pod:41
5948 msgid "guestfs_add_domain"
5949 msgstr ""
5950
5951 # type: verbatim
5952 #. type: verbatim
5953 #: ../src/guestfs-actions.pod:43
5954 #, no-wrap
5955 msgid ""
5956 " int\n"
5957 " guestfs_add_domain (guestfs_h *g,\n"
5958 "                     const char *dom,\n"
5959 "                     ...);\n"
5960 "\n"
5961 msgstr ""
5962
5963 # type: textblock
5964 #. type: textblock
5965 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145
5966 #: ../src/guestfs-actions.pod:4315
5967 msgid ""
5968 "You may supply a list of optional arguments to this call.  Use zero or more "
5969 "of the following pairs of parameters, and terminate the list with C<-1> on "
5970 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
5971 msgstr ""
5972
5973 #. type: verbatim
5974 #: ../src/guestfs-actions.pod:53
5975 #, no-wrap
5976 msgid ""
5977 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
5978 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
5979 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
5980 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
5981 "\n"
5982 msgstr ""
5983
5984 # type: textblock
5985 #. type: textblock
5986 #: ../src/guestfs-actions.pod:58
5987 msgid ""
5988 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
5989 "It works by connecting to libvirt, requesting the domain and domain XML from "
5990 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
5991 "one."
5992 msgstr ""
5993
5994 # type: textblock
5995 #. type: textblock
5996 #: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46
5997 msgid ""
5998 "The number of disks added is returned.  This operation is atomic: if an "
5999 "error is returned, then no disks are added."
6000 msgstr ""
6001
6002 # type: textblock
6003 #. type: textblock
6004 #: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49
6005 msgid ""
6006 "This function does some minimal checks to make sure the libvirt domain is "
6007 "not running (unless C<readonly> is true).  In a future version we will try "
6008 "to acquire the libvirt lock on each disk."
6009 msgstr ""
6010
6011 # type: textblock
6012 #. type: textblock
6013 #: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53
6014 msgid ""
6015 "Disks must be accessible locally.  This often means that adding disks from a "
6016 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
6017 "unless those disks are accessible via the same device path locally too."
6018 msgstr ""
6019
6020 #. type: textblock
6021 #: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58
6022 msgid ""
6023 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6024 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
6025 "libvirt URI (or one set through an environment variable, see the libvirt "
6026 "documentation for full details)."
6027 msgstr ""
6028
6029 #. type: textblock
6030 #: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64
6031 msgid ""
6032 "The optional C<live> flag controls whether this call will try to connect to "
6033 "a running virtual machine C<guestfsd> process if it sees a suitable "
6034 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
6035 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
6036 "DAEMONS> for more information."
6037 msgstr ""
6038
6039 # type: textblock
6040 #. type: textblock
6041 #: ../src/guestfs-actions.pod:88
6042 msgid ""
6043 "The other optional parameters are passed directly through to "
6044 "C<guestfs_add_drive_opts>."
6045 msgstr ""
6046
6047 # type: textblock
6048 #. type: textblock
6049 #: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344
6050 #: ../src/guestfs-actions.pod:509 ../src/guestfs-actions.pod:687
6051 #: ../src/guestfs-actions.pod:718 ../src/guestfs-actions.pod:736
6052 #: ../src/guestfs-actions.pod:755 ../src/guestfs-actions.pod:1315
6053 #: ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1872
6054 #: ../src/guestfs-actions.pod:1981 ../src/guestfs-actions.pod:2021
6055 #: ../src/guestfs-actions.pod:2076 ../src/guestfs-actions.pod:2099
6056 #: ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:2719
6057 #: ../src/guestfs-actions.pod:2740 ../src/guestfs-actions.pod:4741
6058 #: ../src/guestfs-actions.pod:4869 ../src/guestfs-actions.pod:5275
6059 #: ../src/guestfs-actions.pod:5301 ../src/guestfs-actions.pod:6642
6060 #: ../src/guestfs-actions.pod:7067 ../src/guestfs-actions.pod:7080
6061 #: ../src/guestfs-actions.pod:7093
6062 msgid "On error this function returns -1."
6063 msgstr ""
6064
6065 # type: textblock
6066 #. type: textblock
6067 #: ../src/guestfs-actions.pod:93
6068 msgid "(Added in 1.7.4)"
6069 msgstr ""
6070
6071 # type: =head2
6072 #. type: =head2
6073 #: ../src/guestfs-actions.pod:95
6074 msgid "guestfs_add_domain_va"
6075 msgstr ""
6076
6077 # type: verbatim
6078 #. type: verbatim
6079 #: ../src/guestfs-actions.pod:97
6080 #, no-wrap
6081 msgid ""
6082 " int\n"
6083 " guestfs_add_domain_va (guestfs_h *g,\n"
6084 "                        const char *dom,\n"
6085 "                        va_list args);\n"
6086 "\n"
6087 msgstr ""
6088
6089 # type: textblock
6090 #. type: textblock
6091 #: ../src/guestfs-actions.pod:102
6092 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
6093 msgstr ""
6094
6095 # type: textblock
6096 #. type: textblock
6097 #: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115
6098 #: ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219
6099 #: ../src/guestfs-actions.pod:4368 ../src/guestfs-actions.pod:4380
6100 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
6101 msgstr ""
6102
6103 # type: =head2
6104 #. type: =head2
6105 #: ../src/guestfs-actions.pod:106
6106 msgid "guestfs_add_domain_argv"
6107 msgstr ""
6108
6109 # type: verbatim
6110 #. type: verbatim
6111 #: ../src/guestfs-actions.pod:108
6112 #, no-wrap
6113 msgid ""
6114 " int\n"
6115 " guestfs_add_domain_argv (guestfs_h *g,\n"
6116 "                          const char *dom,\n"
6117 "                          const struct guestfs_add_domain_argv *optargs);\n"
6118 "\n"
6119 msgstr ""
6120
6121 # type: textblock
6122 #. type: textblock
6123 #: ../src/guestfs-actions.pod:113
6124 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
6125 msgstr ""
6126
6127 # type: =head2
6128 #. type: =head2
6129 #: ../src/guestfs-actions.pod:117
6130 msgid "guestfs_add_drive"
6131 msgstr ""
6132
6133 # type: verbatim
6134 #. type: verbatim
6135 #: ../src/guestfs-actions.pod:119
6136 #, no-wrap
6137 msgid ""
6138 " int\n"
6139 " guestfs_add_drive (guestfs_h *g,\n"
6140 "                    const char *filename);\n"
6141 "\n"
6142 msgstr ""
6143
6144 # type: textblock
6145 #. type: textblock
6146 #: ../src/guestfs-actions.pod:123
6147 msgid ""
6148 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
6149 "optional parameters, so the disk is added writable, with the format being "
6150 "detected automatically."
6151 msgstr ""
6152
6153 # type: textblock
6154 #. type: textblock
6155 #: ../src/guestfs-actions.pod:127
6156 msgid ""
6157 "Automatic detection of the format opens you up to a potential security hole "
6158 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6159 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6160 "you should think about replacing calls to this function with calls to "
6161 "C<guestfs_add_drive_opts>, and specifying the format."
6162 msgstr ""
6163
6164 # type: =head2
6165 #. type: =head2
6166 #: ../src/guestfs-actions.pod:138
6167 msgid "guestfs_add_drive_opts"
6168 msgstr ""
6169
6170 # type: verbatim
6171 #. type: verbatim
6172 #: ../src/guestfs-actions.pod:140
6173 #, no-wrap
6174 msgid ""
6175 " int\n"
6176 " guestfs_add_drive_opts (guestfs_h *g,\n"
6177 "                         const char *filename,\n"
6178 "                         ...);\n"
6179 "\n"
6180 msgstr ""
6181
6182 # type: verbatim
6183 #. type: verbatim
6184 #: ../src/guestfs-actions.pod:150
6185 #, no-wrap
6186 msgid ""
6187 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6188 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6189 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6190 "\n"
6191 msgstr ""
6192
6193 # type: textblock
6194 #. type: textblock
6195 #: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97
6196 msgid ""
6197 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6198 "The first time you call this function, the disk appears as C</dev/sda>, the "
6199 "second time as C</dev/sdb>, and so on."
6200 msgstr ""
6201
6202 # type: textblock
6203 #. type: textblock
6204 #: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102
6205 msgid ""
6206 "You don't necessarily need to be root when using libguestfs.  However you "
6207 "obviously do need sufficient permissions to access the filename for whatever "
6208 "operations you want to perform (ie. read access if you just want to read the "
6209 "image or write access if you want to modify the image)."
6210 msgstr ""
6211
6212 # type: textblock
6213 #. type: textblock
6214 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108
6215 msgid "This call checks that C<filename> exists."
6216 msgstr ""
6217
6218 # type: textblock
6219 #. type: textblock
6220 #: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4326
6221 #: ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:2919
6222 msgid "The optional arguments are:"
6223 msgstr ""
6224
6225 # type: =item
6226 #. type: =item
6227 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114
6228 msgid "C<readonly>"
6229 msgstr ""
6230
6231 # type: textblock
6232 #. type: textblock
6233 #: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116
6234 msgid ""
6235 "If true then the image is treated as read-only.  Writes are still allowed, "
6236 "but they are stored in a temporary snapshot overlay which is discarded at "
6237 "the end.  The disk that you add is not modified."
6238 msgstr ""
6239
6240 # type: =item
6241 #. type: =item
6242 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120
6243 msgid "C<format>"
6244 msgstr ""
6245
6246 # type: textblock
6247 #. type: textblock
6248 #: ../src/guestfs-actions.pod:179
6249 msgid ""
6250 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6251 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6252 "Possible formats include C<raw> and C<qcow2>."
6253 msgstr ""
6254
6255 # type: textblock
6256 #. type: textblock
6257 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126
6258 msgid ""
6259 "Automatic detection of the format opens you up to a potential security hole "
6260 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6261 "RHBZ#642934.  Specifying the format closes this security hole."
6262 msgstr ""
6263
6264 # type: =item
6265 #. type: =item
6266 #: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131
6267 msgid "C<iface>"
6268 msgstr ""
6269
6270 # type: textblock
6271 #. type: textblock
6272 #: ../src/guestfs-actions.pod:190
6273 msgid ""
6274 "This rarely-used option lets you emulate the behaviour of the deprecated "
6275 "C<guestfs_add_drive_with_if> call (q.v.)"
6276 msgstr ""
6277
6278 # type: textblock
6279 #. type: textblock
6280 #: ../src/guestfs-actions.pod:197
6281 msgid "(Added in 1.5.23)"
6282 msgstr ""
6283
6284 # type: =head2
6285 #. type: =head2
6286 #: ../src/guestfs-actions.pod:199
6287 msgid "guestfs_add_drive_opts_va"
6288 msgstr ""
6289
6290 # type: verbatim
6291 #. type: verbatim
6292 #: ../src/guestfs-actions.pod:201
6293 #, no-wrap
6294 msgid ""
6295 " int\n"
6296 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6297 "                            const char *filename,\n"
6298 "                            va_list args);\n"
6299 "\n"
6300 msgstr ""
6301
6302 # type: textblock
6303 #. type: textblock
6304 #: ../src/guestfs-actions.pod:206
6305 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6306 msgstr ""
6307
6308 # type: =head2
6309 #. type: =head2
6310 #: ../src/guestfs-actions.pod:210
6311 msgid "guestfs_add_drive_opts_argv"
6312 msgstr ""
6313
6314 # type: verbatim
6315 #. type: verbatim
6316 #: ../src/guestfs-actions.pod:212
6317 #, no-wrap
6318 msgid ""
6319 " int\n"
6320 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6321 "                              const char *filename,\n"
6322 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6323 "\n"
6324 msgstr ""
6325
6326 # type: textblock
6327 #. type: textblock
6328 #: ../src/guestfs-actions.pod:217
6329 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6330 msgstr ""
6331
6332 # type: =head2
6333 #. type: =head2
6334 #: ../src/guestfs-actions.pod:221
6335 msgid "guestfs_add_drive_ro"
6336 msgstr ""
6337
6338 # type: verbatim
6339 #. type: verbatim
6340 #: ../src/guestfs-actions.pod:223
6341 #, no-wrap
6342 msgid ""
6343 " int\n"
6344 " guestfs_add_drive_ro (guestfs_h *g,\n"
6345 "                       const char *filename);\n"
6346 "\n"
6347 msgstr ""
6348
6349 # type: textblock
6350 #. type: textblock
6351 #: ../src/guestfs-actions.pod:227
6352 msgid ""
6353 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6354 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6355 "disk is added read-only, with the format being detected automatically."
6356 msgstr ""
6357
6358 # type: textblock
6359 #. type: textblock
6360 #: ../src/guestfs-actions.pod:234
6361 msgid "(Added in 1.0.38)"
6362 msgstr ""
6363
6364 # type: =head2
6365 #. type: =head2
6366 #: ../src/guestfs-actions.pod:236
6367 msgid "guestfs_add_drive_ro_with_if"
6368 msgstr ""
6369
6370 # type: verbatim
6371 #. type: verbatim
6372 #: ../src/guestfs-actions.pod:238
6373 #, no-wrap
6374 msgid ""
6375 " int\n"
6376 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6377 "                               const char *filename,\n"
6378 "                               const char *iface);\n"
6379 "\n"
6380 msgstr ""
6381
6382 # type: textblock
6383 #. type: textblock
6384 #: ../src/guestfs-actions.pod:243
6385 msgid ""
6386 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6387 "QEMU interface emulation to use at run time."
6388 msgstr ""
6389
6390 # type: textblock
6391 #. type: textblock
6392 #: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276
6393 #: ../src/guestfs-actions.pod:2351
6394 msgid "(Added in 1.0.84)"
6395 msgstr ""
6396
6397 # type: =head2
6398 #. type: =head2
6399 #: ../src/guestfs-actions.pod:257
6400 msgid "guestfs_add_drive_with_if"
6401 msgstr ""
6402
6403 # type: verbatim
6404 #. type: verbatim
6405 #: ../src/guestfs-actions.pod:259
6406 #, no-wrap
6407 msgid ""
6408 " int\n"
6409 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6410 "                            const char *filename,\n"
6411 "                            const char *iface);\n"
6412 "\n"
6413 msgstr ""
6414
6415 # type: textblock
6416 #. type: textblock
6417 #: ../src/guestfs-actions.pod:264
6418 msgid ""
6419 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
6420 "QEMU interface emulation to use at run time."
6421 msgstr ""
6422
6423 # type: =head2
6424 #. type: =head2
6425 #: ../src/guestfs-actions.pod:278
6426 msgid "guestfs_aug_clear"
6427 msgstr ""
6428
6429 # type: verbatim
6430 #. type: verbatim
6431 #: ../src/guestfs-actions.pod:280
6432 #, no-wrap
6433 msgid ""
6434 " int\n"
6435 " guestfs_aug_clear (guestfs_h *g,\n"
6436 "                    const char *augpath);\n"
6437 "\n"
6438 msgstr ""
6439
6440 # type: textblock
6441 #. type: textblock
6442 #: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183
6443 msgid ""
6444 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
6445 "L<augtool(1)> C<clear> command."
6446 msgstr ""
6447
6448 # type: textblock
6449 #. type: textblock
6450 #: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2101
6451 msgid "(Added in 1.3.4)"
6452 msgstr ""
6453
6454 # type: =head2
6455 #. type: =head2
6456 #: ../src/guestfs-actions.pod:291
6457 msgid "guestfs_aug_close"
6458 msgstr ""
6459
6460 # type: verbatim
6461 #. type: verbatim
6462 #: ../src/guestfs-actions.pod:293
6463 #, no-wrap
6464 msgid ""
6465 " int\n"
6466 " guestfs_aug_close (guestfs_h *g);\n"
6467 "\n"
6468 msgstr ""
6469
6470 # type: textblock
6471 #. type: textblock
6472 #: ../src/guestfs-actions.pod:296
6473 msgid ""
6474 "Close the current Augeas handle and free up any resources used by it.  After "
6475 "calling this, you have to call C<guestfs_aug_init> again before you can use "
6476 "any other Augeas functions."
6477 msgstr ""
6478
6479 # type: textblock
6480 #. type: textblock
6481 #: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328
6482 #: ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360
6483 #: ../src/guestfs-actions.pod:418 ../src/guestfs-actions.pod:438
6484 #: ../src/guestfs-actions.pod:452 ../src/guestfs-actions.pod:483
6485 #: ../src/guestfs-actions.pod:497 ../src/guestfs-actions.pod:511
6486 #: ../src/guestfs-actions.pod:525 ../src/guestfs-actions.pod:543
6487 #: ../src/guestfs-actions.pod:5352
6488 msgid "(Added in 0.7)"
6489 msgstr ""
6490
6491 # type: =head2
6492 #. type: =head2
6493 #: ../src/guestfs-actions.pod:305
6494 msgid "guestfs_aug_defnode"
6495 msgstr ""
6496
6497 # type: verbatim
6498 #. type: verbatim
6499 #: ../src/guestfs-actions.pod:307
6500 #, no-wrap
6501 msgid ""
6502 " struct guestfs_int_bool *\n"
6503 " guestfs_aug_defnode (guestfs_h *g,\n"
6504 "                      const char *name,\n"
6505 "                      const char *expr,\n"
6506 "                      const char *val);\n"
6507 "\n"
6508 msgstr ""
6509
6510 # type: textblock
6511 #. type: textblock
6512 #: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199
6513 msgid ""
6514 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
6515 msgstr ""
6516
6517 # type: textblock
6518 #. type: textblock
6519 #: ../src/guestfs-actions.pod:316
6520 msgid ""
6521 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
6522 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
6523 "containing that single node."
6524 msgstr ""
6525
6526 # type: textblock
6527 #. type: textblock
6528 #: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206
6529 msgid ""
6530 "On success this returns a pair containing the number of nodes in the "
6531 "nodeset, and a boolean flag if a node was created."
6532 msgstr ""
6533
6534 # type: textblock
6535 #. type: textblock
6536 #: ../src/guestfs-actions.pod:324
6537 msgid ""
6538 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
6539 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
6540 msgstr ""
6541
6542 # type: =head2
6543 #. type: =head2
6544 #: ../src/guestfs-actions.pod:330
6545 msgid "guestfs_aug_defvar"
6546 msgstr ""
6547
6548 # type: verbatim
6549 #. type: verbatim
6550 #: ../src/guestfs-actions.pod:332
6551 #, no-wrap
6552 msgid ""
6553 " int\n"
6554 " guestfs_aug_defvar (guestfs_h *g,\n"
6555 "                     const char *name,\n"
6556 "                     const char *expr);\n"
6557 "\n"
6558 msgstr ""
6559
6560 # type: textblock
6561 #. type: textblock
6562 #: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214
6563 msgid ""
6564 "Defines an Augeas variable C<name> whose value is the result of evaluating "
6565 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
6566 msgstr ""
6567
6568 # type: textblock
6569 #. type: textblock
6570 #: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218
6571 msgid ""
6572 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
6573 "evaluates to something which is not a nodeset."
6574 msgstr ""
6575
6576 # type: =head2
6577 #. type: =head2
6578 #: ../src/guestfs-actions.pod:348
6579 msgid "guestfs_aug_get"
6580 msgstr ""
6581
6582 # type: verbatim
6583 #. type: verbatim
6584 #: ../src/guestfs-actions.pod:350
6585 #, no-wrap
6586 msgid ""
6587 " char *\n"
6588 " guestfs_aug_get (guestfs_h *g,\n"
6589 "                  const char *augpath);\n"
6590 "\n"
6591 msgstr ""
6592
6593 # type: textblock
6594 #. type: textblock
6595 #: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225
6596 msgid ""
6597 "Look up the value associated with C<path>.  If C<path> matches exactly one "
6598 "node, the C<value> is returned."
6599 msgstr ""
6600
6601 # type: textblock
6602 #. type: textblock
6603 #: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:857
6604 #: ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:935
6605 #: ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:1054
6606 #: ../src/guestfs-actions.pod:1184 ../src/guestfs-actions.pod:1201
6607 #: ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1349
6608 #: ../src/guestfs-actions.pod:1540 ../src/guestfs-actions.pod:1652
6609 #: ../src/guestfs-actions.pod:1815 ../src/guestfs-actions.pod:1832
6610 #: ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1933
6611 #: ../src/guestfs-actions.pod:1954 ../src/guestfs-actions.pod:2124
6612 #: ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2523
6613 #: ../src/guestfs-actions.pod:2604 ../src/guestfs-actions.pod:2671
6614 #: ../src/guestfs-actions.pod:2691 ../src/guestfs-actions.pod:2805
6615 #: ../src/guestfs-actions.pod:2836 ../src/guestfs-actions.pod:2860
6616 #: ../src/guestfs-actions.pod:2922 ../src/guestfs-actions.pod:2945
6617 #: ../src/guestfs-actions.pod:3512 ../src/guestfs-actions.pod:3862
6618 #: ../src/guestfs-actions.pod:4032 ../src/guestfs-actions.pod:4142
6619 #: ../src/guestfs-actions.pod:4887 ../src/guestfs-actions.pod:5080
6620 #: ../src/guestfs-actions.pod:5250 ../src/guestfs-actions.pod:5428
6621 #: ../src/guestfs-actions.pod:5477 ../src/guestfs-actions.pod:6085
6622 #: ../src/guestfs-actions.pod:6101 ../src/guestfs-actions.pod:6118
6623 #: ../src/guestfs-actions.pod:6142 ../src/guestfs-actions.pod:6816
6624 #: ../src/guestfs-actions.pod:6835 ../src/guestfs-actions.pod:6853
6625 #: ../src/guestfs-actions.pod:7033 ../src/guestfs-actions.pod:7305
6626 msgid ""
6627 "This function returns a string, or NULL on error.  I<The caller must free "
6628 "the returned string after use>."
6629 msgstr ""
6630
6631 # type: =head2
6632 #. type: =head2
6633 #: ../src/guestfs-actions.pod:362
6634 msgid "guestfs_aug_init"
6635 msgstr ""
6636
6637 # type: verbatim
6638 #. type: verbatim
6639 #: ../src/guestfs-actions.pod:364
6640 #, no-wrap
6641 msgid ""
6642 " int\n"
6643 " guestfs_aug_init (guestfs_h *g,\n"
6644 "                   const char *root,\n"
6645 "                   int flags);\n"
6646 "\n"
6647 msgstr ""
6648
6649 # type: textblock
6650 #. type: textblock
6651 #: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232
6652 msgid ""
6653 "Create a new Augeas handle for editing configuration files.  If there was "
6654 "any previous Augeas handle associated with this guestfs session, then it is "
6655 "closed."
6656 msgstr ""
6657
6658 # type: textblock
6659 #. type: textblock
6660 #: ../src/guestfs-actions.pod:373
6661 msgid "You must call this before using any other C<guestfs_aug_*> commands."
6662 msgstr ""
6663
6664 # type: textblock
6665 #. type: textblock
6666 #: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239
6667 msgid ""
6668 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
6669 msgstr ""
6670
6671 # type: textblock
6672 #. type: textblock
6673 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242
6674 msgid ""
6675 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
6676 "logical I<or> of the following integers:"
6677 msgstr ""
6678
6679 # type: =item
6680 #. type: =item
6681 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248
6682 msgid "C<AUG_SAVE_BACKUP> = 1"
6683 msgstr ""
6684
6685 # type: textblock
6686 #. type: textblock
6687 #: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250
6688 msgid "Keep the original file with a C<.augsave> extension."
6689 msgstr ""
6690
6691 # type: =item
6692 #. type: =item
6693 #: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252
6694 msgid "C<AUG_SAVE_NEWFILE> = 2"
6695 msgstr ""
6696
6697 # type: textblock
6698 #. type: textblock
6699 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254
6700 msgid ""
6701 "Save changes into a file with extension C<.augnew>, and do not overwrite "
6702 "original.  Overrides C<AUG_SAVE_BACKUP>."
6703 msgstr ""
6704
6705 # type: =item
6706 #. type: =item
6707 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257
6708 msgid "C<AUG_TYPE_CHECK> = 4"
6709 msgstr ""
6710
6711 # type: textblock
6712 #. type: textblock
6713 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259
6714 msgid "Typecheck lenses (can be expensive)."
6715 msgstr ""
6716
6717 # type: =item
6718 #. type: =item
6719 #: ../src/guestfs-actions.pod:398 ../fish/guestfish-actions.pod:261
6720 msgid "C<AUG_NO_STDINC> = 8"
6721 msgstr ""
6722
6723 # type: textblock
6724 #. type: textblock
6725 #: ../src/guestfs-actions.pod:400 ../fish/guestfish-actions.pod:263
6726 msgid "Do not use standard load path for modules."
6727 msgstr ""
6728
6729 # type: =item
6730 #. type: =item
6731 #: ../src/guestfs-actions.pod:402 ../fish/guestfish-actions.pod:265
6732 msgid "C<AUG_SAVE_NOOP> = 16"
6733 msgstr ""
6734
6735 # type: textblock
6736 #. type: textblock
6737 #: ../src/guestfs-actions.pod:404 ../fish/guestfish-actions.pod:267
6738 msgid "Make save a no-op, just record what would have been changed."
6739 msgstr ""
6740
6741 # type: =item
6742 #. type: =item
6743 #: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:269
6744 msgid "C<AUG_NO_LOAD> = 32"
6745 msgstr ""
6746
6747 # type: textblock
6748 #. type: textblock
6749 #: ../src/guestfs-actions.pod:408
6750 msgid "Do not load the tree in C<guestfs_aug_init>."
6751 msgstr ""
6752
6753 # type: textblock
6754 #. type: textblock
6755 #: ../src/guestfs-actions.pod:412
6756 msgid "To close the handle, you can call C<guestfs_aug_close>."
6757 msgstr ""
6758
6759 # type: textblock
6760 #. type: textblock
6761 #: ../src/guestfs-actions.pod:414 ../fish/guestfish-actions.pod:277
6762 msgid "To find out more about Augeas, see L<http://augeas.net/>."
6763 msgstr ""
6764
6765 # type: =head2
6766 #. type: =head2
6767 #: ../src/guestfs-actions.pod:420
6768 msgid "guestfs_aug_insert"
6769 msgstr ""
6770
6771 # type: verbatim
6772 #. type: verbatim
6773 #: ../src/guestfs-actions.pod:422
6774 #, no-wrap
6775 msgid ""
6776 " int\n"
6777 " guestfs_aug_insert (guestfs_h *g,\n"
6778 "                     const char *augpath,\n"
6779 "                     const char *label,\n"
6780 "                     int before);\n"
6781 "\n"
6782 msgstr ""
6783
6784 # type: textblock
6785 #. type: textblock
6786 #: ../src/guestfs-actions.pod:428 ../fish/guestfish-actions.pod:283
6787 msgid ""
6788 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
6789 "or after C<path> (depending on the boolean flag C<before>)."
6790 msgstr ""
6791
6792 # type: textblock
6793 #. type: textblock
6794 #: ../src/guestfs-actions.pod:432 ../fish/guestfish-actions.pod:287
6795 msgid ""
6796 "C<path> must match exactly one existing node in the tree, and C<label> must "
6797 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
6798 msgstr ""
6799
6800 # type: =head2
6801 #. type: =head2
6802 #: ../src/guestfs-actions.pod:440
6803 msgid "guestfs_aug_load"
6804 msgstr ""
6805
6806 # type: verbatim
6807 #. type: verbatim
6808 #: ../src/guestfs-actions.pod:442
6809 #, no-wrap
6810 msgid ""
6811 " int\n"
6812 " guestfs_aug_load (guestfs_h *g);\n"
6813 "\n"
6814 msgstr ""
6815
6816 # type: textblock
6817 #. type: textblock
6818 #: ../src/guestfs-actions.pod:445 ../fish/guestfish-actions.pod:295
6819 msgid "Load files into the tree."
6820 msgstr ""
6821
6822 # type: textblock
6823 #. type: textblock
6824 #: ../src/guestfs-actions.pod:447 ../fish/guestfish-actions.pod:297
6825 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
6826 msgstr ""
6827
6828 # type: =head2
6829 #. type: =head2
6830 #: ../src/guestfs-actions.pod:454
6831 msgid "guestfs_aug_ls"
6832 msgstr ""
6833
6834 # type: verbatim
6835 #. type: verbatim
6836 #: ../src/guestfs-actions.pod:456
6837 #, no-wrap
6838 msgid ""
6839 " char **\n"
6840 " guestfs_aug_ls (guestfs_h *g,\n"
6841 "                 const char *augpath);\n"
6842 "\n"
6843 msgstr ""
6844
6845 # type: textblock
6846 #. type: textblock
6847 #: ../src/guestfs-actions.pod:460
6848 msgid ""
6849 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
6850 "sorting the resulting nodes into alphabetical order."
6851 msgstr ""
6852
6853 # type: textblock
6854 #. type: textblock
6855 #: ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:479
6856 #: ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:1073
6857 #: ../src/guestfs-actions.pod:1364 ../src/guestfs-actions.pod:1383
6858 #: ../src/guestfs-actions.pod:1486 ../src/guestfs-actions.pod:1505
6859 #: ../src/guestfs-actions.pod:1754 ../src/guestfs-actions.pod:2196
6860 #: ../src/guestfs-actions.pod:2212 ../src/guestfs-actions.pod:2231
6861 #: ../src/guestfs-actions.pod:2274 ../src/guestfs-actions.pod:2298
6862 #: ../src/guestfs-actions.pod:2369 ../src/guestfs-actions.pod:2418
6863 #: ../src/guestfs-actions.pod:2629 ../src/guestfs-actions.pod:2879
6864 #: ../src/guestfs-actions.pod:3147 ../src/guestfs-actions.pod:3432
6865 #: ../src/guestfs-actions.pod:3494 ../src/guestfs-actions.pod:3599
6866 #: ../src/guestfs-actions.pod:4004 ../src/guestfs-actions.pod:4702
6867 #: ../src/guestfs-actions.pod:5222 ../src/guestfs-actions.pod:5348
6868 #: ../src/guestfs-actions.pod:5462 ../src/guestfs-actions.pod:6158
6869 #: ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6274
6870 #: ../src/guestfs-actions.pod:6420 ../src/guestfs-actions.pod:6444
6871 #: ../src/guestfs-actions.pod:6926 ../src/guestfs-actions.pod:6946
6872 #: ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7158
6873 #: ../src/guestfs-actions.pod:7177 ../src/guestfs-actions.pod:7262
6874 #: ../src/guestfs-actions.pod:7281 ../src/guestfs-actions.pod:7327
6875 #: ../src/guestfs-actions.pod:7346
6876 msgid ""
6877 "This function returns a NULL-terminated array of strings (like L<environ(3)"
6878 ">), or NULL if there was an error.  I<The caller must free the strings and "
6879 "the array after use>."
6880 msgstr ""
6881
6882 # type: textblock
6883 #. type: textblock
6884 #: ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:998
6885 #: ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1421
6886 #: ../src/guestfs-actions.pod:3225 ../src/guestfs-actions.pod:3256
6887 #: ../src/guestfs-actions.pod:3845 ../src/guestfs-actions.pod:3895
6888 #: ../src/guestfs-actions.pod:4082 ../src/guestfs-actions.pod:4115
6889 #: ../src/guestfs-actions.pod:4278 ../src/guestfs-actions.pod:4706
6890 #: ../src/guestfs-actions.pod:5163 ../src/guestfs-actions.pod:5558
6891 #: ../src/guestfs-actions.pod:5572 ../src/guestfs-actions.pod:5584
6892 #: ../src/guestfs-actions.pod:6020 ../src/guestfs-actions.pod:6658
6893 #: ../src/guestfs-actions.pod:6671 ../src/guestfs-actions.pod:6910
6894 #: ../src/guestfs-actions.pod:7146
6895 msgid "(Added in 0.8)"
6896 msgstr ""
6897
6898 # type: =head2
6899 #. type: =head2
6900 #: ../src/guestfs-actions.pod:469
6901 msgid "guestfs_aug_match"
6902 msgstr ""
6903
6904 # type: verbatim
6905 #. type: verbatim
6906 #: ../src/guestfs-actions.pod:471
6907 #, no-wrap
6908 msgid ""
6909 " char **\n"
6910 " guestfs_aug_match (guestfs_h *g,\n"
6911 "                    const char *augpath);\n"
6912 "\n"
6913 msgstr ""
6914
6915 # type: textblock
6916 #. type: textblock
6917 #: ../src/guestfs-actions.pod:475 ../fish/guestfish-actions.pod:311
6918 msgid ""
6919 "Returns a list of paths which match the path expression C<path>.  The "
6920 "returned paths are sufficiently qualified so that they match exactly one "
6921 "node in the current tree."
6922 msgstr ""
6923
6924 # type: =head2
6925 #. type: =head2
6926 #: ../src/guestfs-actions.pod:485
6927 msgid "guestfs_aug_mv"
6928 msgstr ""
6929
6930 # type: verbatim
6931 #. type: verbatim
6932 #: ../src/guestfs-actions.pod:487
6933 #, no-wrap
6934 msgid ""
6935 " int\n"
6936 " guestfs_aug_mv (guestfs_h *g,\n"
6937 "                 const char *src,\n"
6938 "                 const char *dest);\n"
6939 "\n"
6940 msgstr ""
6941
6942 # type: textblock
6943 #. type: textblock
6944 #: ../src/guestfs-actions.pod:492 ../fish/guestfish-actions.pod:319
6945 msgid ""
6946 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
6947 "C<dest> is overwritten if it exists."
6948 msgstr ""
6949
6950 # type: =head2
6951 #. type: =head2
6952 #: ../src/guestfs-actions.pod:499
6953 msgid "guestfs_aug_rm"
6954 msgstr ""
6955
6956 # type: verbatim
6957 #. type: verbatim
6958 #: ../src/guestfs-actions.pod:501
6959 #, no-wrap
6960 msgid ""
6961 " int\n"
6962 " guestfs_aug_rm (guestfs_h *g,\n"
6963 "                 const char *augpath);\n"
6964 "\n"
6965 msgstr ""
6966
6967 # type: textblock
6968 #. type: textblock
6969 #: ../src/guestfs-actions.pod:505 ../fish/guestfish-actions.pod:326
6970 msgid "Remove C<path> and all of its children."
6971 msgstr ""
6972
6973 # type: textblock
6974 #. type: textblock
6975 #: ../src/guestfs-actions.pod:507 ../fish/guestfish-actions.pod:328
6976 msgid "On success this returns the number of entries which were removed."
6977 msgstr ""
6978
6979 # type: =head2
6980 #. type: =head2
6981 #: ../src/guestfs-actions.pod:513
6982 msgid "guestfs_aug_save"
6983 msgstr ""
6984
6985 # type: verbatim
6986 #. type: verbatim
6987 #: ../src/guestfs-actions.pod:515
6988 #, no-wrap
6989 msgid ""
6990 " int\n"
6991 " guestfs_aug_save (guestfs_h *g);\n"
6992 "\n"
6993 msgstr ""
6994
6995 # type: textblock
6996 #. type: textblock
6997 #: ../src/guestfs-actions.pod:518 ../fish/guestfish-actions.pod:334
6998 msgid "This writes all pending changes to disk."
6999 msgstr ""
7000
7001 # type: textblock
7002 #. type: textblock
7003 #: ../src/guestfs-actions.pod:520
7004 msgid ""
7005 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
7006 "are saved."
7007 msgstr ""
7008
7009 # type: =head2
7010 #. type: =head2
7011 #: ../src/guestfs-actions.pod:527
7012 msgid "guestfs_aug_set"
7013 msgstr ""
7014
7015 # type: verbatim
7016 #. type: verbatim
7017 #: ../src/guestfs-actions.pod:529
7018 #, no-wrap
7019 msgid ""
7020 " int\n"
7021 " guestfs_aug_set (guestfs_h *g,\n"
7022 "                  const char *augpath,\n"
7023 "                  const char *val);\n"
7024 "\n"
7025 msgstr ""
7026
7027 # type: textblock
7028 #. type: textblock
7029 #: ../src/guestfs-actions.pod:534 ../fish/guestfish-actions.pod:343
7030 msgid "Set the value associated with C<path> to C<val>."
7031 msgstr ""
7032
7033 # type: textblock
7034 #. type: textblock
7035 #: ../src/guestfs-actions.pod:536
7036 msgid ""
7037 "In the Augeas API, it is possible to clear a node by setting the value to "
7038 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
7039 "this call.  Instead you must use the C<guestfs_aug_clear> call."
7040 msgstr ""
7041
7042 # type: =head2
7043 #. type: =head2
7044 #: ../src/guestfs-actions.pod:545
7045 msgid "guestfs_available"
7046 msgstr ""
7047
7048 # type: verbatim
7049 #. type: verbatim
7050 #: ../src/guestfs-actions.pod:547
7051 #, no-wrap
7052 msgid ""
7053 " int\n"
7054 " guestfs_available (guestfs_h *g,\n"
7055 "                    char *const *groups);\n"
7056 "\n"
7057 msgstr ""
7058
7059 # type: textblock
7060 #. type: textblock
7061 #: ../src/guestfs-actions.pod:551 ../fish/guestfish-actions.pod:354
7062 msgid ""
7063 "This command is used to check the availability of some groups of "
7064 "functionality in the appliance, which not all builds of the libguestfs "
7065 "appliance will be able to provide."
7066 msgstr ""
7067
7068 # type: textblock
7069 #. type: textblock
7070 #: ../src/guestfs-actions.pod:555
7071 msgid ""
7072 "The libguestfs groups, and the functions that those groups correspond to, "
7073 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
7074 "runtime by calling C<guestfs_available_all_groups>."
7075 msgstr ""
7076
7077 # type: textblock
7078 #. type: textblock
7079 #: ../src/guestfs-actions.pod:560 ../fish/guestfish-actions.pod:363
7080 msgid ""
7081 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7082 "\"]> would check for the availability of the Linux inotify functions and "
7083 "Augeas (configuration file editing) functions."
7084 msgstr ""
7085
7086 # type: textblock
7087 #. type: textblock
7088 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368
7089 msgid "The command returns no error if I<all> requested groups are available."
7090 msgstr ""
7091
7092 # type: textblock
7093 #. type: textblock
7094 #: ../src/guestfs-actions.pod:567 ../fish/guestfish-actions.pod:370
7095 msgid ""
7096 "It fails with an error if one or more of the requested groups is unavailable "
7097 "in the appliance."
7098 msgstr ""
7099
7100 # type: textblock
7101 #. type: textblock
7102 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373
7103 msgid ""
7104 "If an unknown group name is included in the list of groups then an error is "
7105 "always returned."
7106 msgstr ""
7107
7108 # type: textblock
7109 #. type: textblock
7110 #: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:376
7111 msgid "I<Notes:>"
7112 msgstr ""
7113
7114 # type: textblock
7115 #. type: textblock
7116 #: ../src/guestfs-actions.pod:579
7117 msgid "You must call C<guestfs_launch> before calling this function."
7118 msgstr ""
7119
7120 # type: textblock
7121 #. type: textblock
7122 #: ../src/guestfs-actions.pod:581 ../fish/guestfish-actions.pod:384
7123 msgid ""
7124 "The reason is because we don't know what groups are supported by the "
7125 "appliance/daemon until it is running and can be queried."
7126 msgstr ""
7127
7128 # type: textblock
7129 #. type: textblock
7130 #: ../src/guestfs-actions.pod:587 ../fish/guestfish-actions.pod:390
7131 msgid ""
7132 "If a group of functions is available, this does not necessarily mean that "
7133 "they will work.  You still have to check for errors when calling individual "
7134 "API functions even if they are available."
7135 msgstr ""
7136
7137 # type: textblock
7138 #. type: textblock
7139 #: ../src/guestfs-actions.pod:594 ../fish/guestfish-actions.pod:397
7140 msgid ""
7141 "It is usually the job of distro packagers to build complete functionality "
7142 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
7143 "with all requirements satisfied, will support everything."
7144 msgstr ""
7145
7146 # type: textblock
7147 #. type: textblock
7148 #: ../src/guestfs-actions.pod:601
7149 msgid ""
7150 "This call was added in version C<1.0.80>.  In previous versions of "
7151 "libguestfs all you could do would be to speculatively execute a command to "
7152 "find out if the daemon implemented it.  See also C<guestfs_version>."
7153 msgstr ""
7154
7155 # type: textblock
7156 #. type: textblock
7157 #: ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:1171
7158 msgid "(Added in 1.0.80)"
7159 msgstr ""
7160
7161 # type: =head2
7162 #. type: =head2
7163 #: ../src/guestfs-actions.pod:612
7164 msgid "guestfs_available_all_groups"
7165 msgstr ""
7166
7167 # type: verbatim
7168 #. type: verbatim
7169 #: ../src/guestfs-actions.pod:614
7170 #, no-wrap
7171 msgid ""
7172 " char **\n"
7173 " guestfs_available_all_groups (guestfs_h *g);\n"
7174 "\n"
7175 msgstr ""
7176
7177 # type: textblock
7178 #. type: textblock
7179 #: ../src/guestfs-actions.pod:617
7180 msgid ""
7181 "This command returns a list of all optional groups that this daemon knows "
7182 "about.  Note this returns both supported and unsupported groups.  To find "
7183 "out which ones the daemon can actually support you have to call "
7184 "C<guestfs_available> on each member of the returned list."
7185 msgstr ""
7186
7187 # type: textblock
7188 #. type: textblock
7189 #: ../src/guestfs-actions.pod:623
7190 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7191 msgstr ""
7192
7193 # type: textblock
7194 #. type: textblock
7195 #: ../src/guestfs-actions.pod:629
7196 msgid "(Added in 1.3.15)"
7197 msgstr ""
7198
7199 # type: =head2
7200 #. type: =head2
7201 #: ../src/guestfs-actions.pod:631
7202 msgid "guestfs_base64_in"
7203 msgstr ""
7204
7205 # type: verbatim
7206 #. type: verbatim
7207 #: ../src/guestfs-actions.pod:633
7208 #, no-wrap
7209 msgid ""
7210 " int\n"
7211 " guestfs_base64_in (guestfs_h *g,\n"
7212 "                    const char *base64file,\n"
7213 "                    const char *filename);\n"
7214 "\n"
7215 msgstr ""
7216
7217 # type: textblock
7218 #. type: textblock
7219 #: ../src/guestfs-actions.pod:638 ../fish/guestfish-actions.pod:427
7220 msgid ""
7221 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7222 msgstr ""
7223
7224 # type: textblock
7225 #. type: textblock
7226 #: ../src/guestfs-actions.pod:643 ../src/guestfs-actions.pod:657
7227 msgid "(Added in 1.3.5)"
7228 msgstr ""
7229
7230 # type: =head2
7231 #. type: =head2
7232 #: ../src/guestfs-actions.pod:645
7233 msgid "guestfs_base64_out"
7234 msgstr ""
7235
7236 # type: verbatim
7237 #. type: verbatim
7238 #: ../src/guestfs-actions.pod:647
7239 #, no-wrap
7240 msgid ""
7241 " int\n"
7242 " guestfs_base64_out (guestfs_h *g,\n"
7243 "                     const char *filename,\n"
7244 "                     const char *base64file);\n"
7245 "\n"
7246 msgstr ""
7247
7248 # type: textblock
7249 #. type: textblock
7250 #: ../src/guestfs-actions.pod:652 ../fish/guestfish-actions.pod:436
7251 msgid ""
7252 "This command downloads the contents of C<filename>, writing it out to local "
7253 "file C<base64file> encoded as base64."
7254 msgstr ""
7255
7256 # type: =head2
7257 #. type: =head2
7258 #: ../src/guestfs-actions.pod:659
7259 msgid "guestfs_blockdev_flushbufs"
7260 msgstr ""
7261
7262 # type: verbatim
7263 #. type: verbatim
7264 #: ../src/guestfs-actions.pod:661
7265 #, no-wrap
7266 msgid ""
7267 " int\n"
7268 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7269 "                             const char *device);\n"
7270 "\n"
7271 msgstr ""
7272
7273 # type: textblock
7274 #. type: textblock
7275 #: ../src/guestfs-actions.pod:665 ../fish/guestfish-actions.pod:445
7276 msgid ""
7277 "This tells the kernel to flush internal buffers associated with C<device>."
7278 msgstr ""
7279
7280 # type: textblock
7281 #. type: textblock
7282 #: ../src/guestfs-actions.pod:668 ../src/guestfs-actions.pod:685
7283 #: ../src/guestfs-actions.pod:700 ../src/guestfs-actions.pod:716
7284 #: ../src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:753
7285 #: ../src/guestfs-actions.pod:767 ../src/guestfs-actions.pod:785
7286 #: ../src/guestfs-actions.pod:799 ../src/guestfs-actions.pod:813
7287 #: ../fish/guestfish-actions.pod:448 ../fish/guestfish-actions.pod:459
7288 #: ../fish/guestfish-actions.pod:468 ../fish/guestfish-actions.pod:478
7289 #: ../fish/guestfish-actions.pod:490 ../fish/guestfish-actions.pod:503
7290 #: ../fish/guestfish-actions.pod:511 ../fish/guestfish-actions.pod:522
7291 #: ../fish/guestfish-actions.pod:530 ../fish/guestfish-actions.pod:538
7292 msgid "This uses the L<blockdev(8)> command."
7293 msgstr ""
7294
7295 # type: textblock
7296 #. type: textblock
7297 #: ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:689
7298 #: ../src/guestfs-actions.pod:704 ../src/guestfs-actions.pod:720
7299 #: ../src/guestfs-actions.pod:738 ../src/guestfs-actions.pod:757
7300 #: ../src/guestfs-actions.pod:771 ../src/guestfs-actions.pod:789
7301 #: ../src/guestfs-actions.pod:803 ../src/guestfs-actions.pod:817
7302 msgid "(Added in 0.9.3)"
7303 msgstr ""
7304
7305 # type: =head2
7306 #. type: =head2
7307 #: ../src/guestfs-actions.pod:674
7308 msgid "guestfs_blockdev_getbsz"
7309 msgstr ""
7310
7311 # type: verbatim
7312 #. type: verbatim
7313 #: ../src/guestfs-actions.pod:676
7314 #, no-wrap
7315 msgid ""
7316 " int\n"
7317 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7318 "                          const char *device);\n"
7319 "\n"
7320 msgstr ""
7321
7322 # type: textblock
7323 #. type: textblock
7324 #: ../src/guestfs-actions.pod:680 ../fish/guestfish-actions.pod:454
7325 msgid "This returns the block size of a device."
7326 msgstr ""
7327
7328 # type: textblock
7329 #. type: textblock
7330 #: ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:782
7331 #: ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:519
7332 msgid ""
7333 "(Note this is different from both I<size in blocks> and I<filesystem block "
7334 "size>)."
7335 msgstr ""
7336
7337 # type: =head2
7338 #. type: =head2
7339 #: ../src/guestfs-actions.pod:691
7340 msgid "guestfs_blockdev_getro"
7341 msgstr ""
7342
7343 # type: verbatim
7344 #. type: verbatim
7345 #: ../src/guestfs-actions.pod:693
7346 #, no-wrap
7347 msgid ""
7348 " int\n"
7349 " guestfs_blockdev_getro (guestfs_h *g,\n"
7350 "                         const char *device);\n"
7351 "\n"
7352 msgstr ""
7353
7354 # type: textblock
7355 #. type: textblock
7356 #: ../src/guestfs-actions.pod:697 ../fish/guestfish-actions.pod:465
7357 msgid ""
7358 "Returns a boolean indicating if the block device is read-only (true if read-"
7359 "only, false if not)."
7360 msgstr ""
7361
7362 # type: textblock
7363 #. type: textblock
7364 #: ../src/guestfs-actions.pod:702 ../src/guestfs-actions.pod:1404
7365 #: ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1909
7366 #: ../src/guestfs-actions.pod:1920 ../src/guestfs-actions.pod:1992
7367 #: ../src/guestfs-actions.pod:2047 ../src/guestfs-actions.pod:2062
7368 #: ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2110
7369 #: ../src/guestfs-actions.pod:2965 ../src/guestfs-actions.pod:2982
7370 #: ../src/guestfs-actions.pod:3001 ../src/guestfs-actions.pod:3164
7371 #: ../src/guestfs-actions.pod:3178 ../src/guestfs-actions.pod:3193
7372 #: ../src/guestfs-actions.pod:3207 ../src/guestfs-actions.pod:3223
7373 #: ../src/guestfs-actions.pod:3238 ../src/guestfs-actions.pod:3254
7374 #: ../src/guestfs-actions.pod:3268 ../src/guestfs-actions.pod:3281
7375 #: ../src/guestfs-actions.pod:3295 ../src/guestfs-actions.pod:3310
7376 #: ../src/guestfs-actions.pod:3325 ../src/guestfs-actions.pod:4851
7377 msgid "This function returns a C truth value on success or -1 on error."
7378 msgstr ""
7379
7380 # type: =head2
7381 #. type: =head2
7382 #: ../src/guestfs-actions.pod:706
7383 msgid "guestfs_blockdev_getsize64"
7384 msgstr ""
7385
7386 # type: verbatim
7387 #. type: verbatim
7388 #: ../src/guestfs-actions.pod:708
7389 #, no-wrap
7390 msgid ""
7391 " int64_t\n"
7392 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7393 "                             const char *device);\n"
7394 "\n"
7395 msgstr ""
7396
7397 # type: textblock
7398 #. type: textblock
7399 #: ../src/guestfs-actions.pod:712 ../fish/guestfish-actions.pod:474
7400 msgid "This returns the size of the device in bytes."
7401 msgstr ""
7402
7403 # type: textblock
7404 #. type: textblock
7405 #: ../src/guestfs-actions.pod:714
7406 msgid "See also C<guestfs_blockdev_getsz>."
7407 msgstr ""
7408
7409 # type: =head2
7410 #. type: =head2
7411 #: ../src/guestfs-actions.pod:722
7412 msgid "guestfs_blockdev_getss"
7413 msgstr ""
7414
7415 # type: verbatim
7416 #. type: verbatim
7417 #: ../src/guestfs-actions.pod:724
7418 #, no-wrap
7419 msgid ""
7420 " int\n"
7421 " guestfs_blockdev_getss (guestfs_h *g,\n"
7422 "                         const char *device);\n"
7423 "\n"
7424 msgstr ""
7425
7426 # type: textblock
7427 #. type: textblock
7428 #: ../src/guestfs-actions.pod:728 ../fish/guestfish-actions.pod:484
7429 msgid ""
7430 "This returns the size of sectors on a block device.  Usually 512, but can be "
7431 "larger for modern devices."
7432 msgstr ""
7433
7434 # type: textblock
7435 #. type: textblock
7436 #: ../src/guestfs-actions.pod:731
7437 msgid ""
7438 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
7439 "that)."
7440 msgstr ""
7441
7442 # type: =head2
7443 #. type: =head2
7444 #: ../src/guestfs-actions.pod:740
7445 msgid "guestfs_blockdev_getsz"
7446 msgstr ""
7447
7448 # type: verbatim
7449 #. type: verbatim
7450 #: ../src/guestfs-actions.pod:742
7451 #, no-wrap
7452 msgid ""
7453 " int64_t\n"
7454 " guestfs_blockdev_getsz (guestfs_h *g,\n"
7455 "                         const char *device);\n"
7456 "\n"
7457 msgstr ""
7458
7459 # type: textblock
7460 #. type: textblock
7461 #: ../src/guestfs-actions.pod:746 ../fish/guestfish-actions.pod:496
7462 msgid ""
7463 "This returns the size of the device in units of 512-byte sectors (even if "
7464 "the sectorsize isn't 512 bytes ... weird)."
7465 msgstr ""
7466
7467 # type: textblock
7468 #. type: textblock
7469 #: ../src/guestfs-actions.pod:749
7470 msgid ""
7471 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
7472 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
7473 msgstr ""
7474
7475 # type: =head2
7476 #. type: =head2
7477 #: ../src/guestfs-actions.pod:759
7478 msgid "guestfs_blockdev_rereadpt"
7479 msgstr ""
7480
7481 # type: verbatim
7482 #. type: verbatim
7483 #: ../src/guestfs-actions.pod:761
7484 #, no-wrap
7485 msgid ""
7486 " int\n"
7487 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
7488 "                            const char *device);\n"
7489 "\n"
7490 msgstr ""
7491
7492 # type: textblock
7493 #. type: textblock
7494 #: ../src/guestfs-actions.pod:765 ../fish/guestfish-actions.pod:509
7495 msgid "Reread the partition table on C<device>."
7496 msgstr ""
7497
7498 # type: =head2
7499 #. type: =head2
7500 #: ../src/guestfs-actions.pod:773
7501 msgid "guestfs_blockdev_setbsz"
7502 msgstr ""
7503
7504 # type: verbatim
7505 #. type: verbatim
7506 #: ../src/guestfs-actions.pod:775
7507 #, no-wrap
7508 msgid ""
7509 " int\n"
7510 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
7511 "                          const char *device,\n"
7512 "                          int blocksize);\n"
7513 "\n"
7514 msgstr ""
7515
7516 # type: textblock
7517 #. type: textblock
7518 #: ../src/guestfs-actions.pod:780 ../fish/guestfish-actions.pod:517
7519 msgid "This sets the block size of a device."
7520 msgstr ""
7521
7522 # type: =head2
7523 #. type: =head2
7524 #: ../src/guestfs-actions.pod:791
7525 msgid "guestfs_blockdev_setro"
7526 msgstr ""
7527
7528 # type: verbatim
7529 #. type: verbatim
7530 #: ../src/guestfs-actions.pod:793
7531 #, no-wrap
7532 msgid ""
7533 " int\n"
7534 " guestfs_blockdev_setro (guestfs_h *g,\n"
7535 "                         const char *device);\n"
7536 "\n"
7537 msgstr ""
7538
7539 # type: textblock
7540 #. type: textblock
7541 #: ../src/guestfs-actions.pod:797 ../fish/guestfish-actions.pod:528
7542 msgid "Sets the block device named C<device> to read-only."
7543 msgstr ""
7544
7545 # type: =head2
7546 #. type: =head2
7547 #: ../src/guestfs-actions.pod:805
7548 msgid "guestfs_blockdev_setrw"
7549 msgstr ""
7550
7551 # type: verbatim
7552 #. type: verbatim
7553 #: ../src/guestfs-actions.pod:807
7554 #, no-wrap
7555 msgid ""
7556 " int\n"
7557 " guestfs_blockdev_setrw (guestfs_h *g,\n"
7558 "                         const char *device);\n"
7559 "\n"
7560 msgstr ""
7561
7562 # type: textblock
7563 #. type: textblock
7564 #: ../src/guestfs-actions.pod:811 ../fish/guestfish-actions.pod:536
7565 msgid "Sets the block device named C<device> to read-write."
7566 msgstr ""
7567
7568 # type: =head2
7569 #. type: =head2
7570 #: ../src/guestfs-actions.pod:819
7571 msgid "guestfs_case_sensitive_path"
7572 msgstr ""
7573
7574 # type: verbatim
7575 #. type: verbatim
7576 #: ../src/guestfs-actions.pod:821
7577 #, no-wrap
7578 msgid ""
7579 " char *\n"
7580 " guestfs_case_sensitive_path (guestfs_h *g,\n"
7581 "                              const char *path);\n"
7582 "\n"
7583 msgstr ""
7584
7585 # type: textblock
7586 #. type: textblock
7587 #: ../src/guestfs-actions.pod:825 ../fish/guestfish-actions.pod:544
7588 msgid ""
7589 "This can be used to resolve case insensitive paths on a filesystem which is "
7590 "case sensitive.  The use case is to resolve paths which you have read from "
7591 "Windows configuration files or the Windows Registry, to the true path."
7592 msgstr ""
7593
7594 # type: textblock
7595 #. type: textblock
7596 #: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549
7597 msgid ""
7598 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
7599 "(and probably others), which is that although the underlying filesystem is "
7600 "case-insensitive, the driver exports the filesystem to Linux as case-"
7601 "sensitive."
7602 msgstr ""
7603
7604 # type: textblock
7605 #. type: textblock
7606 #: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554
7607 msgid ""
7608 "One consequence of this is that special directories such as C<c:\\windows> "
7609 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
7610 "precise details of how they were created.  In Windows itself this would not "
7611 "be a problem."
7612 msgstr ""
7613
7614 # type: textblock
7615 #. type: textblock
7616 #: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:560
7617 msgid ""
7618 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
7619 "#posixfilenames1>"
7620 msgstr ""
7621
7622 # type: textblock
7623 #. type: textblock
7624 #: ../src/guestfs-actions.pod:844 ../fish/guestfish-actions.pod:563
7625 msgid ""
7626 "This function resolves the true case of each element in the path and returns "
7627 "the case-sensitive path."
7628 msgstr ""
7629
7630 # type: textblock
7631 #. type: textblock
7632 #: ../src/guestfs-actions.pod:847
7633 msgid ""
7634 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
7635 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
7636 "how the directories were originally created under Windows)."
7637 msgstr ""
7638
7639 # type: textblock
7640 #. type: textblock
7641 #: ../src/guestfs-actions.pod:852 ../fish/guestfish-actions.pod:571
7642 msgid "I<Note>: This function does not handle drive names, backslashes etc."
7643 msgstr ""
7644
7645 # type: textblock
7646 #. type: textblock
7647 #: ../src/guestfs-actions.pod:855
7648 msgid "See also C<guestfs_realpath>."
7649 msgstr ""
7650
7651 # type: textblock
7652 #. type: textblock
7653 #: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:6838
7654 msgid "(Added in 1.0.75)"
7655 msgstr ""
7656
7657 # type: =head2
7658 #. type: =head2
7659 #: ../src/guestfs-actions.pod:862
7660 msgid "guestfs_cat"
7661 msgstr ""
7662
7663 # type: verbatim
7664 #. type: verbatim
7665 #: ../src/guestfs-actions.pod:864
7666 #, no-wrap
7667 msgid ""
7668 " char *\n"
7669 " guestfs_cat (guestfs_h *g,\n"
7670 "              const char *path);\n"
7671 "\n"
7672 msgstr ""
7673
7674 # type: textblock
7675 #. type: textblock
7676 #: ../src/guestfs-actions.pod:868 ../src/guestfs-actions.pod:5338
7677 #: ../fish/guestfish-actions.pod:580 ../fish/guestfish-actions.pod:3567
7678 msgid "Return the contents of the file named C<path>."
7679 msgstr ""
7680
7681 # type: textblock
7682 #. type: textblock
7683 #: ../src/guestfs-actions.pod:870
7684 msgid ""
7685 "Note that this function cannot correctly handle binary files (specifically, "
7686 "files containing C<\\0> character which is treated as end of string).  For "
7687 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
7688 "functions which have a more complex interface."
7689 msgstr ""
7690
7691 # type: textblock
7692 #. type: textblock
7693 #: ../src/guestfs-actions.pod:878 ../src/guestfs-actions.pod:1057
7694 #: ../src/guestfs-actions.pod:1077 ../src/guestfs-actions.pod:1368
7695 #: ../src/guestfs-actions.pod:1387 ../src/guestfs-actions.pod:1490
7696 #: ../src/guestfs-actions.pod:1509 ../src/guestfs-actions.pod:1758
7697 #: ../src/guestfs-actions.pod:2216 ../src/guestfs-actions.pod:2235
7698 #: ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:2302
7699 #: ../src/guestfs-actions.pod:2319 ../src/guestfs-actions.pod:2348
7700 #: ../src/guestfs-actions.pod:5120 ../src/guestfs-actions.pod:5146
7701 #: ../src/guestfs-actions.pod:5277 ../src/guestfs-actions.pod:5303
7702 #: ../src/guestfs-actions.pod:5327 ../src/guestfs-actions.pod:6223
7703 #: ../src/guestfs-actions.pod:6278 ../src/guestfs-actions.pod:6424
7704 #: ../src/guestfs-actions.pod:6448 ../src/guestfs-actions.pod:7110
7705 #: ../src/guestfs-actions.pod:7136 ../src/guestfs-actions.pod:7162
7706 #: ../src/guestfs-actions.pod:7181 ../src/guestfs-actions.pod:7266
7707 #: ../src/guestfs-actions.pod:7285 ../src/guestfs-actions.pod:7331
7708 #: ../src/guestfs-actions.pod:7350 ../fish/guestfish-actions.pod:587
7709 #: ../fish/guestfish-actions.pod:722 ../fish/guestfish-actions.pod:734
7710 #: ../fish/guestfish-actions.pod:910 ../fish/guestfish-actions.pod:920
7711 #: ../fish/guestfish-actions.pod:987 ../fish/guestfish-actions.pod:997
7712 #: ../fish/guestfish-actions.pod:1192 ../fish/guestfish-actions.pod:1493
7713 #: ../fish/guestfish-actions.pod:1503 ../fish/guestfish-actions.pod:1531
7714 #: ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:1556
7715 #: ../fish/guestfish-actions.pod:1575 ../fish/guestfish-actions.pod:3437
7716 #: ../fish/guestfish-actions.pod:3452 ../fish/guestfish-actions.pod:3528
7717 #: ../fish/guestfish-actions.pod:3545 ../fish/guestfish-actions.pod:3560
7718 #: ../fish/guestfish-actions.pod:4182 ../fish/guestfish-actions.pod:4228
7719 #: ../fish/guestfish-actions.pod:4313 ../fish/guestfish-actions.pod:4328
7720 #: ../fish/guestfish-actions.pod:4738 ../fish/guestfish-actions.pod:4756
7721 #: ../fish/guestfish-actions.pod:4773 ../fish/guestfish-actions.pod:4783
7722 #: ../fish/guestfish-actions.pod:4831 ../fish/guestfish-actions.pod:4841
7723 #: ../fish/guestfish-actions.pod:4870 ../fish/guestfish-actions.pod:4880
7724 msgid ""
7725 "Because of the message protocol, there is a transfer limit of somewhere "
7726 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
7727 msgstr ""
7728
7729 # type: textblock
7730 #. type: textblock
7731 #: ../src/guestfs-actions.pod:881 ../src/guestfs-actions.pod:3436
7732 #: ../src/guestfs-actions.pod:3498 ../src/guestfs-actions.pod:3515
7733 #: ../src/guestfs-actions.pod:3603 ../src/guestfs-actions.pod:4008
7734 #: ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:5226
7735 #: ../src/guestfs-actions.pod:5240 ../src/guestfs-actions.pod:6997
7736 #: ../src/guestfs-actions.pod:7011
7737 msgid "(Added in 0.4)"
7738 msgstr ""
7739
7740 # type: =head2
7741 #. type: =head2
7742 #: ../src/guestfs-actions.pod:883
7743 msgid "guestfs_checksum"
7744 msgstr ""
7745
7746 # type: verbatim
7747 #. type: verbatim
7748 #: ../src/guestfs-actions.pod:885
7749 #, no-wrap
7750 msgid ""
7751 " char *\n"
7752 " guestfs_checksum (guestfs_h *g,\n"
7753 "                   const char *csumtype,\n"
7754 "                   const char *path);\n"
7755 "\n"
7756 msgstr ""
7757
7758 # type: textblock
7759 #. type: textblock
7760 #: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:594
7761 msgid ""
7762 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
7763 msgstr ""
7764
7765 # type: textblock
7766 #. type: textblock
7767 #: ../src/guestfs-actions.pod:893 ../fish/guestfish-actions.pod:597
7768 msgid ""
7769 "The type of checksum to compute is given by the C<csumtype> parameter which "
7770 "must have one of the following values:"
7771 msgstr ""
7772
7773 # type: =item
7774 #. type: =item
7775 #: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602
7776 msgid "C<crc>"
7777 msgstr ""
7778
7779 # type: textblock
7780 #. type: textblock
7781 #: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:604
7782 msgid ""
7783 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
7784 "C<cksum> command."
7785 msgstr ""
7786
7787 # type: =item
7788 #. type: =item
7789 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607
7790 msgid "C<md5>"
7791 msgstr ""
7792
7793 # type: textblock
7794 #. type: textblock
7795 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609
7796 msgid "Compute the MD5 hash (using the C<md5sum> program)."
7797 msgstr ""
7798
7799 # type: =item
7800 #. type: =item
7801 #: ../src/guestfs-actions.pod:907 ../fish/guestfish-actions.pod:611
7802 msgid "C<sha1>"
7803 msgstr ""
7804
7805 # type: textblock
7806 #. type: textblock
7807 #: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:613
7808 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
7809 msgstr ""
7810
7811 # type: =item
7812 #. type: =item
7813 #: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:615
7814 msgid "C<sha224>"
7815 msgstr ""
7816
7817 # type: textblock
7818 #. type: textblock
7819 #: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:617
7820 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
7821 msgstr ""
7822
7823 # type: =item
7824 #. type: =item
7825 #: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:619
7826 msgid "C<sha256>"
7827 msgstr ""
7828
7829 # type: textblock
7830 #. type: textblock
7831 #: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:621
7832 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
7833 msgstr ""
7834
7835 # type: =item
7836 #. type: =item
7837 #: ../src/guestfs-actions.pod:919 ../fish/guestfish-actions.pod:623
7838 msgid "C<sha384>"
7839 msgstr ""
7840
7841 # type: textblock
7842 #. type: textblock
7843 #: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:625
7844 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
7845 msgstr ""
7846
7847 # type: =item
7848 #. type: =item
7849 #: ../src/guestfs-actions.pod:923 ../fish/guestfish-actions.pod:627
7850 msgid "C<sha512>"
7851 msgstr ""
7852
7853 # type: textblock
7854 #. type: textblock
7855 #: ../src/guestfs-actions.pod:925 ../fish/guestfish-actions.pod:629
7856 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
7857 msgstr ""
7858
7859 # type: textblock
7860 #. type: textblock
7861 #: ../src/guestfs-actions.pod:929 ../fish/guestfish-actions.pod:633
7862 msgid "The checksum is returned as a printable string."
7863 msgstr ""
7864
7865 # type: textblock
7866 #. type: textblock
7867 #: ../src/guestfs-actions.pod:931
7868 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
7869 msgstr ""
7870
7871 # type: textblock
7872 #. type: textblock
7873 #: ../src/guestfs-actions.pod:933
7874 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
7875 msgstr ""
7876
7877 # type: textblock
7878 #. type: textblock
7879 #: ../src/guestfs-actions.pod:938 ../src/guestfs-actions.pod:1246
7880 #: ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:3180
7881 #: ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3270
7882 #: ../src/guestfs-actions.pod:3297 ../src/guestfs-actions.pod:6694
7883 msgid "(Added in 1.0.2)"
7884 msgstr ""
7885
7886 # type: =head2
7887 #. type: =head2
7888 #: ../src/guestfs-actions.pod:940
7889 msgid "guestfs_checksum_device"
7890 msgstr ""
7891
7892 # type: verbatim
7893 #. type: verbatim
7894 #: ../src/guestfs-actions.pod:942
7895 #, no-wrap
7896 msgid ""
7897 " char *\n"
7898 " guestfs_checksum_device (guestfs_h *g,\n"
7899 "                          const char *csumtype,\n"
7900 "                          const char *device);\n"
7901 "\n"
7902 msgstr ""
7903
7904 # type: textblock
7905 #. type: textblock
7906 #: ../src/guestfs-actions.pod:947
7907 msgid ""
7908 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
7909 "device named C<device>.  For the types of checksums supported see the "
7910 "C<guestfs_checksum> command."
7911 msgstr ""
7912
7913 # type: textblock
7914 #. type: textblock
7915 #: ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:4757
7916 #: ../src/guestfs-actions.pod:4816 ../src/guestfs-actions.pod:4853
7917 #: ../src/guestfs-actions.pod:4871 ../src/guestfs-actions.pod:5047
7918 #: ../src/guestfs-actions.pod:6603 ../src/guestfs-actions.pod:6617
7919 #: ../src/guestfs-actions.pod:7023
7920 msgid "(Added in 1.3.2)"
7921 msgstr ""
7922
7923 # type: =head2
7924 #. type: =head2
7925 #: ../src/guestfs-actions.pod:956
7926 msgid "guestfs_checksums_out"
7927 msgstr ""
7928
7929 # type: verbatim
7930 #. type: verbatim
7931 #: ../src/guestfs-actions.pod:958
7932 #, no-wrap
7933 msgid ""
7934 " int\n"
7935 " guestfs_checksums_out (guestfs_h *g,\n"
7936 "                        const char *csumtype,\n"
7937 "                        const char *directory,\n"
7938 "                        const char *sumsfile);\n"
7939 "\n"
7940 msgstr ""
7941
7942 # type: textblock
7943 #. type: textblock
7944 #: ../src/guestfs-actions.pod:964 ../fish/guestfish-actions.pod:651
7945 msgid ""
7946 "This command computes the checksums of all regular files in C<directory> and "
7947 "then emits a list of those checksums to the local output file C<sumsfile>."
7948 msgstr ""
7949
7950 # type: textblock
7951 #. type: textblock
7952 #: ../src/guestfs-actions.pod:968 ../fish/guestfish-actions.pod:655
7953 msgid ""
7954 "This can be used for verifying the integrity of a virtual machine.  However "
7955 "to be properly secure you should pay attention to the output of the checksum "
7956 "command (it uses the ones from GNU coreutils).  In particular when the "
7957 "filename is not printable, coreutils uses a special backslash syntax.  For "
7958 "more information, see the GNU coreutils info file."
7959 msgstr ""
7960
7961 # type: textblock
7962 #. type: textblock
7963 #: ../src/guestfs-actions.pod:978
7964 msgid "(Added in 1.3.7)"
7965 msgstr ""
7966
7967 # type: =head2
7968 #. type: =head2
7969 #: ../src/guestfs-actions.pod:980
7970 msgid "guestfs_chmod"
7971 msgstr ""
7972
7973 # type: verbatim
7974 #. type: verbatim
7975 #: ../src/guestfs-actions.pod:982
7976 #, no-wrap
7977 msgid ""
7978 " int\n"
7979 " guestfs_chmod (guestfs_h *g,\n"
7980 "                int mode,\n"
7981 "                const char *path);\n"
7982 "\n"
7983 msgstr ""
7984
7985 # type: textblock
7986 #. type: textblock
7987 #: ../src/guestfs-actions.pod:987 ../fish/guestfish-actions.pod:669
7988 msgid ""
7989 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
7990 "supported."
7991 msgstr ""
7992
7993 # type: textblock
7994 #. type: textblock
7995 #: ../src/guestfs-actions.pod:990 ../fish/guestfish-actions.pod:672
7996 msgid ""
7997 "I<Note>: When using this command from guestfish, C<mode> by default would be "
7998 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
7999 "C<700>."
8000 msgstr ""
8001
8002 # type: textblock
8003 #. type: textblock
8004 #: ../src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:4259
8005 #: ../src/guestfs-actions.pod:4456 ../src/guestfs-actions.pod:4475
8006 #: ../src/guestfs-actions.pod:4494 ../fish/guestfish-actions.pod:676
8007 #: ../fish/guestfish-actions.pod:2883 ../fish/guestfish-actions.pod:3012
8008 #: ../fish/guestfish-actions.pod:3022 ../fish/guestfish-actions.pod:3032
8009 msgid "The mode actually set is affected by the umask."
8010 msgstr ""
8011
8012 # type: =head2
8013 #. type: =head2
8014 #: ../src/guestfs-actions.pod:1000
8015 msgid "guestfs_chown"
8016 msgstr ""
8017
8018 # type: verbatim
8019 #. type: verbatim
8020 #: ../src/guestfs-actions.pod:1002
8021 #, no-wrap
8022 msgid ""
8023 " int\n"
8024 " guestfs_chown (guestfs_h *g,\n"
8025 "                int owner,\n"
8026 "                int group,\n"
8027 "                const char *path);\n"
8028 "\n"
8029 msgstr ""
8030
8031 # type: textblock
8032 #. type: textblock
8033 #: ../src/guestfs-actions.pod:1008 ../fish/guestfish-actions.pod:682
8034 msgid "Change the file owner to C<owner> and group to C<group>."
8035 msgstr ""
8036
8037 # type: textblock
8038 #. type: textblock
8039 #: ../src/guestfs-actions.pod:1010 ../src/guestfs-actions.pod:3367
8040 #: ../fish/guestfish-actions.pod:684 ../fish/guestfish-actions.pod:2341
8041 msgid ""
8042 "Only numeric uid and gid are supported.  If you want to use names, you will "
8043 "need to locate and parse the password file yourself (Augeas support makes "
8044 "this relatively easy)."
8045 msgstr ""
8046
8047 # type: =head2
8048 #. type: =head2
8049 #: ../src/guestfs-actions.pod:1018
8050 msgid "guestfs_command"
8051 msgstr ""
8052
8053 # type: verbatim
8054 #. type: verbatim
8055 #: ../src/guestfs-actions.pod:1020
8056 #, no-wrap
8057 msgid ""
8058 " char *\n"
8059 " guestfs_command (guestfs_h *g,\n"
8060 "                  char *const *arguments);\n"
8061 "\n"
8062 msgstr ""
8063
8064 # type: textblock
8065 #. type: textblock
8066 #: ../src/guestfs-actions.pod:1024 ../fish/guestfish-actions.pod:692
8067 msgid ""
8068 "This call runs a command from the guest filesystem.  The filesystem must be "
8069 "mounted, and must contain a compatible operating system (ie. something "
8070 "Linux, with the same or compatible processor architecture)."
8071 msgstr ""
8072
8073 # type: textblock
8074 #. type: textblock
8075 #: ../src/guestfs-actions.pod:1029
8076 msgid ""
8077 "The single parameter is an argv-style list of arguments.  The first element "
8078 "is the name of the program to run.  Subsequent elements are parameters.  The "
8079 "list must be non-empty (ie. must contain a program name).  Note that the "
8080 "command runs directly, and is I<not> invoked via the shell (see "
8081 "C<guestfs_sh>)."
8082 msgstr ""
8083
8084 # type: textblock
8085 #. type: textblock
8086 #: ../src/guestfs-actions.pod:1036 ../fish/guestfish-actions.pod:704
8087 msgid "The return value is anything printed to I<stdout> by the command."
8088 msgstr ""
8089
8090 # type: textblock
8091 #. type: textblock
8092 #: ../src/guestfs-actions.pod:1039 ../fish/guestfish-actions.pod:707
8093 msgid ""
8094 "If the command returns a non-zero exit status, then this function returns an "
8095 "error message.  The error message string is the content of I<stderr> from "
8096 "the command."
8097 msgstr ""
8098
8099 # type: textblock
8100 #. type: textblock
8101 #: ../src/guestfs-actions.pod:1043 ../fish/guestfish-actions.pod:711
8102 msgid ""
8103 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
8104 "bin>.  If you require a program from another location, you should provide "
8105 "the full path in the first parameter."
8106 msgstr ""
8107
8108 # type: textblock
8109 #. type: textblock
8110 #: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716
8111 msgid ""
8112 "Shared libraries and data files required by the program must be available on "
8113 "filesystems which are mounted in the correct places.  It is the caller's "
8114 "responsibility to ensure all filesystems that are needed are mounted at the "
8115 "right locations."
8116 msgstr ""
8117
8118 # type: textblock
8119 #. type: textblock
8120 #: ../src/guestfs-actions.pod:1060 ../src/guestfs-actions.pod:1080
8121 #: ../src/guestfs-actions.pod:1543
8122 msgid "(Added in 0.9.1)"
8123 msgstr ""
8124
8125 # type: =head2
8126 #. type: =head2
8127 #: ../src/guestfs-actions.pod:1062
8128 msgid "guestfs_command_lines"
8129 msgstr ""
8130
8131 # type: verbatim
8132 #. type: verbatim
8133 #: ../src/guestfs-actions.pod:1064
8134 #, no-wrap
8135 msgid ""
8136 " char **\n"
8137 " guestfs_command_lines (guestfs_h *g,\n"
8138 "                        char *const *arguments);\n"
8139 "\n"
8140 msgstr ""
8141
8142 # type: textblock
8143 #. type: textblock
8144 #: ../src/guestfs-actions.pod:1068
8145 msgid ""
8146 "This is the same as C<guestfs_command>, but splits the result into a list of "
8147 "lines."
8148 msgstr ""
8149
8150 # type: textblock
8151 #. type: textblock
8152 #: ../src/guestfs-actions.pod:1071
8153 msgid "See also: C<guestfs_sh_lines>"
8154 msgstr ""
8155
8156 # type: =head2
8157 #. type: =head2
8158 #: ../src/guestfs-actions.pod:1082
8159 msgid "guestfs_config"
8160 msgstr ""
8161
8162 # type: verbatim
8163 #. type: verbatim
8164 #: ../src/guestfs-actions.pod:1084
8165 #, no-wrap
8166 msgid ""
8167 " int\n"
8168 " guestfs_config (guestfs_h *g,\n"
8169 "                 const char *qemuparam,\n"
8170 "                 const char *qemuvalue);\n"
8171 "\n"
8172 msgstr ""
8173
8174 # type: textblock
8175 #. type: textblock
8176 #: ../src/guestfs-actions.pod:1089 ../fish/guestfish-actions.pod:741
8177 msgid ""
8178 "This can be used to add arbitrary qemu command line parameters of the form "
8179 "C<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8180 "setting some parameters which would interfere with parameters that we use."
8181 msgstr ""
8182
8183 # type: textblock
8184 #. type: textblock
8185 #: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746
8186 msgid "The first character of C<param> string must be a C<-> (dash)."
8187 msgstr ""
8188
8189 # type: textblock
8190 #. type: textblock
8191 #: ../src/guestfs-actions.pod:1096 ../fish/guestfish-actions.pod:748
8192 msgid "C<value> can be NULL."
8193 msgstr ""
8194
8195 # type: =head2
8196 #. type: =head2
8197 #: ../src/guestfs-actions.pod:1102
8198 msgid "guestfs_copy_size"
8199 msgstr ""
8200
8201 # type: verbatim
8202 #. type: verbatim
8203 #: ../src/guestfs-actions.pod:1104
8204 #, no-wrap
8205 msgid ""
8206 " int\n"
8207 " guestfs_copy_size (guestfs_h *g,\n"
8208 "                    const char *src,\n"
8209 "                    const char *dest,\n"
8210 "                    int64_t size);\n"
8211 "\n"
8212 msgstr ""
8213
8214 # type: textblock
8215 #. type: textblock
8216 #: ../src/guestfs-actions.pod:1110 ../fish/guestfish-actions.pod:754
8217 msgid ""
8218 "This command copies exactly C<size> bytes from one source device or file "
8219 "C<src> to another destination device or file C<dest>."
8220 msgstr ""
8221
8222 # type: textblock
8223 #. type: textblock
8224 #: ../src/guestfs-actions.pod:1113 ../fish/guestfish-actions.pod:757
8225 msgid ""
8226 "Note this will fail if the source is too short or if the destination is not "
8227 "large enough."
8228 msgstr ""
8229
8230 # type: textblock
8231 #. type: textblock
8232 #: ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:1241
8233 #: ../src/guestfs-actions.pod:1272 ../src/guestfs-actions.pod:1692
8234 #: ../src/guestfs-actions.pod:1714 ../src/guestfs-actions.pod:6689
8235 #: ../src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:7202
8236 #: ../src/guestfs-actions.pod:7221
8237 msgid ""
8238 "This long-running command can generate progress notification messages so "
8239 "that the caller can display a progress bar or indicator.  To receive these "
8240 "messages, the caller must register a progress callback.  See L<guestfs(3)/"
8241 "guestfs_set_progress_callback>."
8242 msgstr ""
8243
8244 # type: textblock
8245 #. type: textblock
8246 #: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:4035
8247 #: ../src/guestfs-actions.pod:5253 ../src/guestfs-actions.pod:6930
8248 #: ../src/guestfs-actions.pod:6950 ../src/guestfs-actions.pod:7036
8249 msgid "(Added in 1.0.87)"
8250 msgstr ""
8251
8252 # type: =head2
8253 #. type: =head2
8254 #: ../src/guestfs-actions.pod:1125
8255 msgid "guestfs_cp"
8256 msgstr ""
8257
8258 # type: verbatim
8259 #. type: verbatim
8260 #: ../src/guestfs-actions.pod:1127
8261 #, no-wrap
8262 msgid ""
8263 " int\n"
8264 " guestfs_cp (guestfs_h *g,\n"
8265 "             const char *src,\n"
8266 "             const char *dest);\n"
8267 "\n"
8268 msgstr ""
8269
8270 # type: textblock
8271 #. type: textblock
8272 #: ../src/guestfs-actions.pod:1132 ../fish/guestfish-actions.pod:764
8273 msgid ""
8274 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8275 "destination filename or destination directory."
8276 msgstr ""
8277
8278 # type: textblock
8279 #. type: textblock
8280 #: ../src/guestfs-actions.pod:1137 ../src/guestfs-actions.pod:1151
8281 #: ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1297
8282 #: ../src/guestfs-actions.pod:1406 ../src/guestfs-actions.pod:4720
8283 #: ../src/guestfs-actions.pod:5097
8284 msgid "(Added in 1.0.18)"
8285 msgstr ""
8286
8287 # type: =head2
8288 #. type: =head2
8289 #: ../src/guestfs-actions.pod:1139
8290 msgid "guestfs_cp_a"
8291 msgstr ""
8292
8293 # type: verbatim
8294 #. type: verbatim
8295 #: ../src/guestfs-actions.pod:1141
8296 #, no-wrap
8297 msgid ""
8298 " int\n"
8299 " guestfs_cp_a (guestfs_h *g,\n"
8300 "               const char *src,\n"
8301 "               const char *dest);\n"
8302 "\n"
8303 msgstr ""
8304
8305 # type: textblock
8306 #. type: textblock
8307 #: ../src/guestfs-actions.pod:1146 ../fish/guestfish-actions.pod:771
8308 msgid ""
8309 "This copies a file or directory from C<src> to C<dest> recursively using the "
8310 "C<cp -a> command."
8311 msgstr ""
8312
8313 # type: =head2
8314 #. type: =head2
8315 #: ../src/guestfs-actions.pod:1153
8316 msgid "guestfs_dd"
8317 msgstr ""
8318
8319 # type: verbatim
8320 #. type: verbatim
8321 #: ../src/guestfs-actions.pod:1155
8322 #, no-wrap
8323 msgid ""
8324 " int\n"
8325 " guestfs_dd (guestfs_h *g,\n"
8326 "             const char *src,\n"
8327 "             const char *dest);\n"
8328 "\n"
8329 msgstr ""
8330
8331 # type: textblock
8332 #. type: textblock
8333 #: ../src/guestfs-actions.pod:1160 ../fish/guestfish-actions.pod:778
8334 msgid ""
8335 "This command copies from one source device or file C<src> to another "
8336 "destination device or file C<dest>.  Normally you would use this to copy to "
8337 "or from a device or partition, for example to duplicate a filesystem."
8338 msgstr ""
8339
8340 # type: textblock
8341 #. type: textblock
8342 #: ../src/guestfs-actions.pod:1165
8343 msgid ""
8344 "If the destination is a device, it must be as large or larger than the "
8345 "source file or device, otherwise the copy will fail.  This command cannot do "
8346 "partial copies (see C<guestfs_copy_size>)."
8347 msgstr ""
8348
8349 # type: =head2
8350 #. type: =head2
8351 #: ../src/guestfs-actions.pod:1173
8352 msgid "guestfs_df"
8353 msgstr ""
8354
8355 # type: verbatim
8356 #. type: verbatim
8357 #: ../src/guestfs-actions.pod:1175
8358 #, no-wrap
8359 msgid ""
8360 " char *\n"
8361 " guestfs_df (guestfs_h *g);\n"
8362 "\n"
8363 msgstr ""
8364
8365 # type: textblock
8366 #. type: textblock
8367 #: ../src/guestfs-actions.pod:1178 ../fish/guestfish-actions.pod:791
8368 msgid "This command runs the C<df> command to report disk space used."
8369 msgstr ""
8370
8371 # type: textblock
8372 #. type: textblock
8373 #: ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1197
8374 msgid ""
8375 "This command is mostly useful for interactive sessions.  It is I<not> "
8376 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8377 "from programs."
8378 msgstr ""
8379
8380 # type: textblock
8381 #. type: textblock
8382 #: ../src/guestfs-actions.pod:1187 ../src/guestfs-actions.pod:1204
8383 #: ../src/guestfs-actions.pod:1317 ../src/guestfs-actions.pod:2281
8384 #: ../src/guestfs-actions.pod:2305 ../src/guestfs-actions.pod:2373
8385 #: ../src/guestfs-actions.pod:4145 ../src/guestfs-actions.pod:4620
8386 #: ../src/guestfs-actions.pod:6427 ../src/guestfs-actions.pod:6451
8387 #: ../src/guestfs-actions.pod:7069 ../src/guestfs-actions.pod:7082
8388 #: ../src/guestfs-actions.pod:7095
8389 msgid "(Added in 1.0.54)"
8390 msgstr ""
8391
8392 # type: =head2
8393 #. type: =head2
8394 #: ../src/guestfs-actions.pod:1189
8395 msgid "guestfs_df_h"
8396 msgstr ""
8397
8398 # type: verbatim
8399 #. type: verbatim
8400 #: ../src/guestfs-actions.pod:1191
8401 #, no-wrap
8402 msgid ""
8403 " char *\n"
8404 " guestfs_df_h (guestfs_h *g);\n"
8405 "\n"
8406 msgstr ""
8407
8408 # type: textblock
8409 #. type: textblock
8410 #: ../src/guestfs-actions.pod:1194 ../fish/guestfish-actions.pod:801
8411 msgid ""
8412 "This command runs the C<df -h> command to report disk space used in human-"
8413 "readable format."
8414 msgstr ""
8415
8416 # type: =head2
8417 #. type: =head2
8418 #: ../src/guestfs-actions.pod:1206
8419 msgid "guestfs_dmesg"
8420 msgstr ""
8421
8422 # type: verbatim
8423 #. type: verbatim
8424 #: ../src/guestfs-actions.pod:1208
8425 #, no-wrap
8426 msgid ""
8427 " char *\n"
8428 " guestfs_dmesg (guestfs_h *g);\n"
8429 "\n"
8430 msgstr ""
8431
8432 # type: textblock
8433 #. type: textblock
8434 #: ../src/guestfs-actions.pod:1211 ../fish/guestfish-actions.pod:812
8435 msgid ""
8436 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
8437 "This is sometimes useful for extended debugging of problems."
8438 msgstr ""
8439
8440 # type: textblock
8441 #. type: textblock
8442 #: ../src/guestfs-actions.pod:1215
8443 msgid ""
8444 "Another way to get the same information is to enable verbose messages with "
8445 "C<guestfs_set_verbose> or by setting the environment variable "
8446 "C<LIBGUESTFS_DEBUG=1> before running the program."
8447 msgstr ""
8448
8449 # type: =head2
8450 #. type: =head2
8451 #: ../src/guestfs-actions.pod:1225
8452 msgid "guestfs_download"
8453 msgstr ""
8454
8455 # type: verbatim
8456 #. type: verbatim
8457 #: ../src/guestfs-actions.pod:1227
8458 #, no-wrap
8459 msgid ""
8460 " int\n"
8461 " guestfs_download (guestfs_h *g,\n"
8462 "                   const char *remotefilename,\n"
8463 "                   const char *filename);\n"
8464 "\n"
8465 msgstr ""
8466
8467 # type: textblock
8468 #. type: textblock
8469 #: ../src/guestfs-actions.pod:1232 ../src/guestfs-actions.pod:1257
8470 #: ../fish/guestfish-actions.pod:825 ../fish/guestfish-actions.pod:838
8471 msgid ""
8472 "Download file C<remotefilename> and save it as C<filename> on the local "
8473 "machine."
8474 msgstr ""
8475
8476 # type: textblock
8477 #. type: textblock
8478 #: ../src/guestfs-actions.pod:1235 ../src/guestfs-actions.pod:6683
8479 #: ../fish/guestfish-actions.pod:828 ../fish/guestfish-actions.pod:4486
8480 msgid "C<filename> can also be a named pipe."
8481 msgstr ""
8482
8483 # type: textblock
8484 #. type: textblock
8485 #: ../src/guestfs-actions.pod:1237
8486 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
8487 msgstr ""
8488
8489 # type: =head2
8490 #. type: =head2
8491 #: ../src/guestfs-actions.pod:1248
8492 msgid "guestfs_download_offset"
8493 msgstr ""
8494
8495 # type: verbatim
8496 #. type: verbatim
8497 #: ../src/guestfs-actions.pod:1250
8498 #, no-wrap
8499 msgid ""
8500 " int\n"
8501 " guestfs_download_offset (guestfs_h *g,\n"
8502 "                          const char *remotefilename,\n"
8503 "                          const char *filename,\n"
8504 "                          int64_t offset,\n"
8505 "                          int64_t size);\n"
8506 "\n"
8507 msgstr ""
8508
8509 # type: textblock
8510 #. type: textblock
8511 #: ../src/guestfs-actions.pod:1260 ../fish/guestfish-actions.pod:841
8512 msgid ""
8513 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8514 "region must be within the file or device)."
8515 msgstr ""
8516
8517 # type: textblock
8518 #. type: textblock
8519 #: ../src/guestfs-actions.pod:1263
8520 msgid ""
8521 "Note that there is no limit on the amount of data that can be downloaded "
8522 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
8523 "full amount unless an error occurs."
8524 msgstr ""
8525
8526 # type: textblock
8527 #. type: textblock
8528 #: ../src/guestfs-actions.pod:1268
8529 msgid "See also C<guestfs_download>, C<guestfs_pread>."
8530 msgstr ""
8531
8532 # type: textblock
8533 #. type: textblock
8534 #: ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:6728
8535 msgid "(Added in 1.5.17)"
8536 msgstr ""
8537
8538 # type: =head2
8539 #. type: =head2
8540 #: ../src/guestfs-actions.pod:1279
8541 msgid "guestfs_drop_caches"
8542 msgstr ""
8543
8544 # type: verbatim
8545 #. type: verbatim
8546 #: ../src/guestfs-actions.pod:1281
8547 #, no-wrap
8548 msgid ""
8549 " int\n"
8550 " guestfs_drop_caches (guestfs_h *g,\n"
8551 "                      int whattodrop);\n"
8552 "\n"
8553 msgstr ""
8554
8555 # type: textblock
8556 #. type: textblock
8557 #: ../src/guestfs-actions.pod:1285 ../fish/guestfish-actions.pod:857
8558 msgid ""
8559 "This instructs the guest kernel to drop its page cache, and/or dentries and "
8560 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
8561 "to drop, see L<http://linux-mm.org/Drop_Caches>"
8562 msgstr ""
8563
8564 # type: textblock
8565 #. type: textblock
8566 #: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862
8567 msgid "Setting C<whattodrop> to 3 should drop everything."
8568 msgstr ""
8569
8570 # type: textblock
8571 #. type: textblock
8572 #: ../src/guestfs-actions.pod:1292 ../fish/guestfish-actions.pod:864
8573 msgid ""
8574 "This automatically calls L<sync(2)> before the operation, so that the "
8575 "maximum guest memory is freed."
8576 msgstr ""
8577
8578 # type: =head2
8579 #. type: =head2
8580 #: ../src/guestfs-actions.pod:1299
8581 msgid "guestfs_du"
8582 msgstr ""
8583
8584 # type: verbatim
8585 #. type: verbatim
8586 #: ../src/guestfs-actions.pod:1301
8587 #, no-wrap
8588 msgid ""
8589 " int64_t\n"
8590 " guestfs_du (guestfs_h *g,\n"
8591 "             const char *path);\n"
8592 "\n"
8593 msgstr ""
8594
8595 # type: textblock
8596 #. type: textblock
8597 #: ../src/guestfs-actions.pod:1305 ../fish/guestfish-actions.pod:871
8598 msgid ""
8599 "This command runs the C<du -s> command to estimate file space usage for "
8600 "C<path>."
8601 msgstr ""
8602
8603 # type: textblock
8604 #. type: textblock
8605 #: ../src/guestfs-actions.pod:1308 ../fish/guestfish-actions.pod:874
8606 msgid ""
8607 "C<path> can be a file or a directory.  If C<path> is a directory then the "
8608 "estimate includes the contents of the directory and all subdirectories "
8609 "(recursively)."
8610 msgstr ""
8611
8612 # type: textblock
8613 #. type: textblock
8614 #: ../src/guestfs-actions.pod:1312 ../fish/guestfish-actions.pod:878
8615 msgid ""
8616 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
8617 msgstr ""
8618
8619 # type: =head2
8620 #. type: =head2
8621 #: ../src/guestfs-actions.pod:1319
8622 msgid "guestfs_e2fsck_f"
8623 msgstr ""
8624
8625 # type: verbatim
8626 #. type: verbatim
8627 #: ../src/guestfs-actions.pod:1321
8628 #, no-wrap
8629 msgid ""
8630 " int\n"
8631 " guestfs_e2fsck_f (guestfs_h *g,\n"
8632 "                   const char *device);\n"
8633 "\n"
8634 msgstr ""
8635
8636 # type: textblock
8637 #. type: textblock
8638 #: ../src/guestfs-actions.pod:1325 ../fish/guestfish-actions.pod:885
8639 msgid ""
8640 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
8641 "on C<device>, noninteractively (C<-p>), even if the filesystem appears to be "
8642 "clean (C<-f>)."
8643 msgstr ""
8644
8645 # type: textblock
8646 #. type: textblock
8647 #: ../src/guestfs-actions.pod:1329
8648 msgid ""
8649 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
8650 "Normally you should use C<guestfs_fsck>."
8651 msgstr ""
8652
8653 # type: textblock
8654 #. type: textblock
8655 #: ../src/guestfs-actions.pod:1334
8656 msgid "(Added in 1.0.29)"
8657 msgstr ""
8658
8659 # type: =head2
8660 #. type: =head2
8661 #: ../src/guestfs-actions.pod:1336
8662 msgid "guestfs_echo_daemon"
8663 msgstr ""
8664
8665 # type: verbatim
8666 #. type: verbatim
8667 #: ../src/guestfs-actions.pod:1338
8668 #, no-wrap
8669 msgid ""
8670 " char *\n"
8671 " guestfs_echo_daemon (guestfs_h *g,\n"
8672 "                      char *const *words);\n"
8673 "\n"
8674 msgstr ""
8675
8676 # type: textblock
8677 #. type: textblock
8678 #: ../src/guestfs-actions.pod:1342 ../fish/guestfish-actions.pod:896
8679 msgid ""
8680 "This command concatenates the list of C<words> passed with single spaces "
8681 "between them and returns the resulting string."
8682 msgstr ""
8683
8684 # type: textblock
8685 #. type: textblock
8686 #: ../src/guestfs-actions.pod:1345 ../fish/guestfish-actions.pod:899
8687 msgid "You can use this command to test the connection through to the daemon."
8688 msgstr ""
8689
8690 # type: textblock
8691 #. type: textblock
8692 #: ../src/guestfs-actions.pod:1347
8693 msgid "See also C<guestfs_ping_daemon>."
8694 msgstr ""
8695
8696 # type: textblock
8697 #. type: textblock
8698 #: ../src/guestfs-actions.pod:1352 ../src/guestfs-actions.pod:2089
8699 #: ../src/guestfs-actions.pod:5931
8700 msgid "(Added in 1.0.69)"
8701 msgstr ""
8702
8703 # type: =head2
8704 #. type: =head2
8705 #: ../src/guestfs-actions.pod:1354
8706 msgid "guestfs_egrep"
8707 msgstr ""
8708
8709 # type: verbatim
8710 #. type: verbatim
8711 #: ../src/guestfs-actions.pod:1356
8712 #, no-wrap
8713 msgid ""
8714 " char **\n"
8715 " guestfs_egrep (guestfs_h *g,\n"
8716 "                const char *regex,\n"
8717 "                const char *path);\n"
8718 "\n"
8719 msgstr ""
8720
8721 # type: textblock
8722 #. type: textblock
8723 #: ../src/guestfs-actions.pod:1361 ../fish/guestfish-actions.pod:907
8724 msgid ""
8725 "This calls the external C<egrep> program and returns the matching lines."
8726 msgstr ""
8727
8728 # type: textblock
8729 #. type: textblock
8730 #: ../src/guestfs-actions.pod:1371 ../src/guestfs-actions.pod:1390
8731 #: ../src/guestfs-actions.pod:1447 ../src/guestfs-actions.pod:1493
8732 #: ../src/guestfs-actions.pod:1512 ../src/guestfs-actions.pod:2219
8733 #: ../src/guestfs-actions.pod:2238 ../src/guestfs-actions.pod:2394
8734 #: ../src/guestfs-actions.pod:2407 ../src/guestfs-actions.pod:2422
8735 #: ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2490
8736 #: ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:3528
8737 #: ../src/guestfs-actions.pod:3542 ../src/guestfs-actions.pod:3555
8738 #: ../src/guestfs-actions.pod:3569 ../src/guestfs-actions.pod:4555
8739 #: ../src/guestfs-actions.pod:5431 ../src/guestfs-actions.pod:5480
8740 #: ../src/guestfs-actions.pod:6295 ../src/guestfs-actions.pod:6307
8741 #: ../src/guestfs-actions.pod:6320 ../src/guestfs-actions.pod:6333
8742 #: ../src/guestfs-actions.pod:6355 ../src/guestfs-actions.pod:6368
8743 #: ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:6394
8744 #: ../src/guestfs-actions.pod:7165 ../src/guestfs-actions.pod:7184
8745 #: ../src/guestfs-actions.pod:7269 ../src/guestfs-actions.pod:7288
8746 #: ../src/guestfs-actions.pod:7334 ../src/guestfs-actions.pod:7353
8747 msgid "(Added in 1.0.66)"
8748 msgstr ""
8749
8750 # type: =head2
8751 #. type: =head2
8752 #: ../src/guestfs-actions.pod:1373
8753 msgid "guestfs_egrepi"
8754 msgstr ""
8755
8756 # type: verbatim
8757 #. type: verbatim
8758 #: ../src/guestfs-actions.pod:1375
8759 #, no-wrap
8760 msgid ""
8761 " char **\n"
8762 " guestfs_egrepi (guestfs_h *g,\n"
8763 "                 const char *regex,\n"
8764 "                 const char *path);\n"
8765 "\n"
8766 msgstr ""
8767
8768 # type: textblock
8769 #. type: textblock
8770 #: ../src/guestfs-actions.pod:1380 ../fish/guestfish-actions.pod:917
8771 msgid ""
8772 "This calls the external C<egrep -i> program and returns the matching lines."
8773 msgstr ""
8774
8775 # type: =head2
8776 #. type: =head2
8777 #: ../src/guestfs-actions.pod:1392
8778 msgid "guestfs_equal"
8779 msgstr ""
8780
8781 # type: verbatim
8782 #. type: verbatim
8783 #: ../src/guestfs-actions.pod:1394
8784 #, no-wrap
8785 msgid ""
8786 " int\n"
8787 " guestfs_equal (guestfs_h *g,\n"
8788 "                const char *file1,\n"
8789 "                const char *file2);\n"
8790 "\n"
8791 msgstr ""
8792
8793 # type: textblock
8794 #. type: textblock
8795 #: ../src/guestfs-actions.pod:1399 ../fish/guestfish-actions.pod:927
8796 msgid ""
8797 "This compares the two files C<file1> and C<file2> and returns true if their "
8798 "content is exactly equal, or false otherwise."
8799 msgstr ""
8800
8801 # type: textblock
8802 #. type: textblock
8803 #: ../src/guestfs-actions.pod:1402 ../fish/guestfish-actions.pod:930
8804 msgid "The external L<cmp(1)> program is used for the comparison."
8805 msgstr ""
8806
8807 # type: =head2
8808 #. type: =head2
8809 #: ../src/guestfs-actions.pod:1408
8810 msgid "guestfs_exists"
8811 msgstr ""
8812
8813 # type: verbatim
8814 #. type: verbatim
8815 #: ../src/guestfs-actions.pod:1410
8816 #, no-wrap
8817 msgid ""
8818 " int\n"
8819 " guestfs_exists (guestfs_h *g,\n"
8820 "                 const char *path);\n"
8821 "\n"
8822 msgstr ""
8823
8824 # type: textblock
8825 #. type: textblock
8826 #: ../src/guestfs-actions.pod:1414 ../fish/guestfish-actions.pod:936
8827 msgid ""
8828 "This returns C<true> if and only if there is a file, directory (or anything) "
8829 "with the given C<path> name."
8830 msgstr ""
8831
8832 # type: textblock
8833 #. type: textblock
8834 #: ../src/guestfs-actions.pod:1417
8835 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
8836 msgstr ""
8837
8838 # type: =head2
8839 #. type: =head2
8840 #: ../src/guestfs-actions.pod:1423
8841 msgid "guestfs_fallocate"
8842 msgstr ""
8843
8844 # type: verbatim
8845 #. type: verbatim
8846 #: ../src/guestfs-actions.pod:1425
8847 #, no-wrap
8848 msgid ""
8849 " int\n"
8850 " guestfs_fallocate (guestfs_h *g,\n"
8851 "                    const char *path,\n"
8852 "                    int len);\n"
8853 "\n"
8854 msgstr ""
8855
8856 # type: textblock
8857 #. type: textblock
8858 #: ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1456
8859 #: ../fish/guestfish-actions.pod:945 ../fish/guestfish-actions.pod:964
8860 msgid ""
8861 "This command preallocates a file (containing zero bytes) named C<path> of "
8862 "size C<len> bytes.  If the file exists already, it is overwritten."
8863 msgstr ""
8864
8865 # type: textblock
8866 #. type: textblock
8867 #: ../src/guestfs-actions.pod:1434 ../fish/guestfish-actions.pod:949
8868 msgid ""
8869 "Do not confuse this with the guestfish-specific C<alloc> command which "
8870 "allocates a file in the host and attaches it as a device."
8871 msgstr ""
8872
8873 # type: textblock
8874 #. type: textblock
8875 #: ../src/guestfs-actions.pod:1440 ../fish/guestfish-actions.pod:953
8876 msgid ""
8877 "This function is deprecated.  In new code, use the C<fallocate64> call "
8878 "instead."
8879 msgstr ""
8880
8881 # type: =head2
8882 #. type: =head2
8883 #: ../src/guestfs-actions.pod:1449
8884 msgid "guestfs_fallocate64"
8885 msgstr ""
8886
8887 # type: verbatim
8888 #. type: verbatim
8889 #: ../src/guestfs-actions.pod:1451
8890 #, no-wrap
8891 msgid ""
8892 " int\n"
8893 " guestfs_fallocate64 (guestfs_h *g,\n"
8894 "                      const char *path,\n"
8895 "                      int64_t len);\n"
8896 "\n"
8897 msgstr ""
8898
8899 # type: textblock
8900 #. type: textblock
8901 #: ../src/guestfs-actions.pod:1460
8902 msgid ""
8903 "Note that this call allocates disk blocks for the file.  To create a sparse "
8904 "file use C<guestfs_truncate_size> instead."
8905 msgstr ""
8906
8907 # type: textblock
8908 #. type: textblock
8909 #: ../src/guestfs-actions.pod:1463
8910 msgid ""
8911 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
8912 "oversight it only allowed 30 bit lengths to be specified, effectively "
8913 "limiting the maximum size of files created through that call to 1GB."
8914 msgstr ""
8915
8916 # type: textblock
8917 #. type: textblock
8918 #: ../src/guestfs-actions.pod:1468 ../fish/guestfish-actions.pod:976
8919 msgid ""
8920 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
8921 "commands which create a file in the host and attach it as a device."
8922 msgstr ""
8923
8924 # type: textblock
8925 #. type: textblock
8926 #: ../src/guestfs-actions.pod:1474
8927 msgid "(Added in 1.3.17)"
8928 msgstr ""
8929
8930 # type: =head2
8931 #. type: =head2
8932 #: ../src/guestfs-actions.pod:1476
8933 msgid "guestfs_fgrep"
8934 msgstr ""
8935
8936 # type: verbatim
8937 #. type: verbatim
8938 #: ../src/guestfs-actions.pod:1478
8939 #, no-wrap
8940 msgid ""
8941 " char **\n"
8942 " guestfs_fgrep (guestfs_h *g,\n"
8943 "                const char *pattern,\n"
8944 "                const char *path);\n"
8945 "\n"
8946 msgstr ""
8947
8948 # type: textblock
8949 #. type: textblock
8950 #: ../src/guestfs-actions.pod:1483 ../fish/guestfish-actions.pod:984
8951 msgid ""
8952 "This calls the external C<fgrep> program and returns the matching lines."
8953 msgstr ""
8954
8955 # type: =head2
8956 #. type: =head2
8957 #: ../src/guestfs-actions.pod:1495
8958 msgid "guestfs_fgrepi"
8959 msgstr ""
8960
8961 # type: verbatim
8962 #. type: verbatim
8963 #: ../src/guestfs-actions.pod:1497
8964 #, no-wrap
8965 msgid ""
8966 " char **\n"
8967 " guestfs_fgrepi (guestfs_h *g,\n"
8968 "                 const char *pattern,\n"
8969 "                 const char *path);\n"
8970 "\n"
8971 msgstr ""
8972
8973 # type: textblock
8974 #. type: textblock
8975 #: ../src/guestfs-actions.pod:1502 ../fish/guestfish-actions.pod:994
8976 msgid ""
8977 "This calls the external C<fgrep -i> program and returns the matching lines."
8978 msgstr ""
8979
8980 # type: =head2
8981 #. type: =head2
8982 #: ../src/guestfs-actions.pod:1514
8983 msgid "guestfs_file"
8984 msgstr ""
8985
8986 # type: verbatim
8987 #. type: verbatim
8988 #: ../src/guestfs-actions.pod:1516
8989 #, no-wrap
8990 msgid ""
8991 " char *\n"
8992 " guestfs_file (guestfs_h *g,\n"
8993 "               const char *path);\n"
8994 "\n"
8995 msgstr ""
8996
8997 # type: textblock
8998 #. type: textblock
8999 #: ../src/guestfs-actions.pod:1520 ../fish/guestfish-actions.pod:1004
9000 msgid ""
9001 "This call uses the standard L<file(1)> command to determine the type or "
9002 "contents of the file."
9003 msgstr ""
9004
9005 # type: textblock
9006 #. type: textblock
9007 #: ../src/guestfs-actions.pod:1523 ../fish/guestfish-actions.pod:1007
9008 msgid ""
9009 "This call will also transparently look inside various types of compressed "
9010 "file."
9011 msgstr ""
9012
9013 # type: textblock
9014 #. type: textblock
9015 #: ../src/guestfs-actions.pod:1526 ../fish/guestfish-actions.pod:1010
9016 msgid ""
9017 "The exact command which runs is C<file -zb path>.  Note in particular that "
9018 "the filename is not prepended to the output (the C<-b> option)."
9019 msgstr ""
9020
9021 # type: textblock
9022 #. type: textblock
9023 #: ../src/guestfs-actions.pod:1530
9024 msgid ""
9025 "This command can also be used on C</dev/> devices (and partitions, LV "
9026 "names).  You can for example use this to determine if a device contains a "
9027 "filesystem, although it's usually better to use C<guestfs_vfs_type>."
9028 msgstr ""
9029
9030 # type: textblock
9031 #. type: textblock
9032 #: ../src/guestfs-actions.pod:1535 ../fish/guestfish-actions.pod:1019
9033 msgid ""
9034 "If the C<path> does not begin with C</dev/> then this command only works for "
9035 "the content of regular files.  For other file types (directory, symbolic "
9036 "link etc) it will just return the string C<directory> etc."
9037 msgstr ""
9038
9039 # type: =head2
9040 #. type: =head2
9041 #: ../src/guestfs-actions.pod:1545
9042 msgid "guestfs_file_architecture"
9043 msgstr ""
9044
9045 # type: verbatim
9046 #. type: verbatim
9047 #: ../src/guestfs-actions.pod:1547
9048 #, no-wrap
9049 msgid ""
9050 " char *\n"
9051 " guestfs_file_architecture (guestfs_h *g,\n"
9052 "                            const char *filename);\n"
9053 "\n"
9054 msgstr ""
9055
9056 # type: textblock
9057 #. type: textblock
9058 #: ../src/guestfs-actions.pod:1551 ../fish/guestfish-actions.pod:1028
9059 msgid ""
9060 "This detects the architecture of the binary C<filename>, and returns it if "
9061 "known."
9062 msgstr ""
9063
9064 # type: textblock
9065 #. type: textblock
9066 #: ../src/guestfs-actions.pod:1554 ../fish/guestfish-actions.pod:1031
9067 msgid "Currently defined architectures are:"
9068 msgstr ""
9069
9070 # type: =item
9071 #. type: =item
9072 #: ../src/guestfs-actions.pod:1558 ../fish/guestfish-actions.pod:1035
9073 msgid "\"i386\""
9074 msgstr ""
9075
9076 # type: textblock
9077 #. type: textblock
9078 #: ../src/guestfs-actions.pod:1560 ../fish/guestfish-actions.pod:1037
9079 msgid ""
9080 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9081 "irrespective of the precise processor requirements of the binary."
9082 msgstr ""
9083
9084 # type: =item
9085 #. type: =item
9086 #: ../src/guestfs-actions.pod:1563 ../fish/guestfish-actions.pod:1040
9087 msgid "\"x86_64\""
9088 msgstr ""
9089
9090 # type: textblock
9091 #. type: textblock
9092 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1042
9093 msgid "64 bit x86-64."
9094 msgstr ""
9095
9096 # type: =item
9097 #. type: =item
9098 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1044
9099 msgid "\"sparc\""
9100 msgstr ""
9101
9102 # type: textblock
9103 #. type: textblock
9104 #: ../src/guestfs-actions.pod:1569 ../fish/guestfish-actions.pod:1046
9105 msgid "32 bit SPARC."
9106 msgstr ""
9107
9108 # type: =item
9109 #. type: =item
9110 #: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1048
9111 msgid "\"sparc64\""
9112 msgstr ""
9113
9114 # type: textblock
9115 #. type: textblock
9116 #: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1050
9117 msgid "64 bit SPARC V9 and above."
9118 msgstr ""
9119
9120 # type: =item
9121 #. type: =item
9122 #: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1052
9123 msgid "\"ia64\""
9124 msgstr ""
9125
9126 # type: textblock
9127 #. type: textblock
9128 #: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1054
9129 msgid "Intel Itanium."
9130 msgstr ""
9131
9132 # type: =item
9133 #. type: =item
9134 #: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1056
9135 msgid "\"ppc\""
9136 msgstr ""
9137
9138 # type: textblock
9139 #. type: textblock
9140 #: ../src/guestfs-actions.pod:1581 ../fish/guestfish-actions.pod:1058
9141 msgid "32 bit Power PC."
9142 msgstr ""
9143
9144 # type: =item
9145 #. type: =item
9146 #: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1060
9147 msgid "\"ppc64\""
9148 msgstr ""
9149
9150 # type: textblock
9151 #. type: textblock
9152 #: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1062
9153 msgid "64 bit Power PC."
9154 msgstr ""
9155
9156 # type: textblock
9157 #. type: textblock
9158 #: ../src/guestfs-actions.pod:1589 ../fish/guestfish-actions.pod:1066
9159 msgid "Libguestfs may return other architecture strings in future."
9160 msgstr ""
9161
9162 # type: textblock
9163 #. type: textblock
9164 #: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1068
9165 msgid "The function works on at least the following types of files:"
9166 msgstr ""
9167
9168 # type: textblock
9169 #. type: textblock
9170 #: ../src/guestfs-actions.pod:1597 ../fish/guestfish-actions.pod:1074
9171 msgid "many types of Un*x and Linux binary"
9172 msgstr ""
9173
9174 # type: textblock
9175 #. type: textblock
9176 #: ../src/guestfs-actions.pod:1601 ../fish/guestfish-actions.pod:1078
9177 msgid "many types of Un*x and Linux shared library"
9178 msgstr ""
9179
9180 # type: textblock
9181 #. type: textblock
9182 #: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1082
9183 msgid "Windows Win32 and Win64 binaries"
9184 msgstr ""
9185
9186 # type: textblock
9187 #. type: textblock
9188 #: ../src/guestfs-actions.pod:1609 ../fish/guestfish-actions.pod:1086
9189 msgid "Windows Win32 and Win64 DLLs"
9190 msgstr ""
9191
9192 # type: textblock
9193 #. type: textblock
9194 #: ../src/guestfs-actions.pod:1611 ../fish/guestfish-actions.pod:1088
9195 msgid "Win32 binaries and DLLs return C<i386>."
9196 msgstr ""
9197
9198 # type: textblock
9199 #. type: textblock
9200 #: ../src/guestfs-actions.pod:1613 ../fish/guestfish-actions.pod:1090
9201 msgid "Win64 binaries and DLLs return C<x86_64>."
9202 msgstr ""
9203
9204 # type: textblock
9205 #. type: textblock
9206 #: ../src/guestfs-actions.pod:1617 ../fish/guestfish-actions.pod:1094
9207 msgid "Linux kernel modules"
9208 msgstr ""
9209
9210 # type: textblock
9211 #. type: textblock
9212 #: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1098
9213 msgid "Linux new-style initrd images"
9214 msgstr ""
9215
9216 # type: textblock
9217 #. type: textblock
9218 #: ../src/guestfs-actions.pod:1625 ../fish/guestfish-actions.pod:1102
9219 msgid "some non-x86 Linux vmlinuz kernels"
9220 msgstr ""
9221
9222 # type: textblock
9223 #. type: textblock
9224 #: ../src/guestfs-actions.pod:1629 ../fish/guestfish-actions.pod:1106
9225 msgid "What it can't do currently:"
9226 msgstr ""
9227
9228 # type: textblock
9229 #. type: textblock
9230 #: ../src/guestfs-actions.pod:1635 ../fish/guestfish-actions.pod:1112
9231 msgid "static libraries (libfoo.a)"
9232 msgstr ""
9233
9234 # type: textblock
9235 #. type: textblock
9236 #: ../src/guestfs-actions.pod:1639 ../fish/guestfish-actions.pod:1116
9237 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9238 msgstr ""
9239
9240 # type: textblock
9241 #. type: textblock
9242 #: ../src/guestfs-actions.pod:1643 ../fish/guestfish-actions.pod:1120
9243 msgid "x86 Linux vmlinuz kernels"
9244 msgstr ""
9245
9246 # type: textblock
9247 #. type: textblock
9248 #: ../src/guestfs-actions.pod:1645 ../fish/guestfish-actions.pod:1122
9249 msgid ""
9250 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9251 "compressed code, and are horribly hard to unpack.  If you want to find the "
9252 "architecture of a kernel, use the architecture of the associated initrd or "
9253 "kernel module(s) instead."
9254 msgstr ""
9255
9256 # type: textblock
9257 #. type: textblock
9258 #: ../src/guestfs-actions.pod:1655 ../src/guestfs-actions.pod:1818
9259 #: ../src/guestfs-actions.pod:1835 ../src/guestfs-actions.pod:2526
9260 #: ../src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2633
9261 #: ../src/guestfs-actions.pod:2721 ../src/guestfs-actions.pod:2742
9262 #: ../src/guestfs-actions.pod:2779 ../src/guestfs-actions.pod:2863
9263 #: ../src/guestfs-actions.pod:2925 ../src/guestfs-actions.pod:3151
9264 #: ../src/guestfs-actions.pod:3283
9265 msgid "(Added in 1.5.3)"
9266 msgstr ""
9267
9268 # type: =head2
9269 #. type: =head2
9270 #: ../src/guestfs-actions.pod:1657
9271 msgid "guestfs_filesize"
9272 msgstr ""
9273
9274 # type: verbatim
9275 #. type: verbatim
9276 #: ../src/guestfs-actions.pod:1659
9277 #, no-wrap
9278 msgid ""
9279 " int64_t\n"
9280 " guestfs_filesize (guestfs_h *g,\n"
9281 "                   const char *file);\n"
9282 "\n"
9283 msgstr ""
9284
9285 # type: textblock
9286 #. type: textblock
9287 #: ../src/guestfs-actions.pod:1663 ../fish/guestfish-actions.pod:1133
9288 msgid "This command returns the size of C<file> in bytes."
9289 msgstr ""
9290
9291 # type: textblock
9292 #. type: textblock
9293 #: ../src/guestfs-actions.pod:1665
9294 msgid ""
9295 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9296 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9297 "devices, use C<guestfs_blockdev_getsize64>."
9298 msgstr ""
9299
9300 # type: textblock
9301 #. type: textblock
9302 #: ../src/guestfs-actions.pod:1671
9303 msgid "(Added in 1.0.82)"
9304 msgstr ""
9305
9306 # type: =head2
9307 #. type: =head2
9308 #: ../src/guestfs-actions.pod:1673
9309 msgid "guestfs_fill"
9310 msgstr ""
9311
9312 # type: verbatim
9313 #. type: verbatim
9314 #: ../src/guestfs-actions.pod:1675
9315 #, no-wrap
9316 msgid ""
9317 " int\n"
9318 " guestfs_fill (guestfs_h *g,\n"
9319 "               int c,\n"
9320 "               int len,\n"
9321 "               const char *path);\n"
9322 "\n"
9323 msgstr ""
9324
9325 # type: textblock
9326 #. type: textblock
9327 #: ../src/guestfs-actions.pod:1681 ../fish/guestfish-actions.pod:1143
9328 msgid ""
9329 "This command creates a new file called C<path>.  The initial content of the "
9330 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9331 "[0..255]>."
9332 msgstr ""
9333
9334 # type: textblock
9335 #. type: textblock
9336 #: ../src/guestfs-actions.pod:1685
9337 msgid ""
9338 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9339 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9340 "bytes use C<guestfs_fill_pattern>."
9341 msgstr ""
9342
9343 # type: textblock
9344 #. type: textblock
9345 #: ../src/guestfs-actions.pod:1697
9346 msgid "(Added in 1.0.79)"
9347 msgstr ""
9348
9349 # type: =head2
9350 #. type: =head2
9351 #: ../src/guestfs-actions.pod:1699
9352 msgid "guestfs_fill_pattern"
9353 msgstr ""
9354
9355 # type: verbatim
9356 #. type: verbatim
9357 #: ../src/guestfs-actions.pod:1701
9358 #, no-wrap
9359 msgid ""
9360 " int\n"
9361 " guestfs_fill_pattern (guestfs_h *g,\n"
9362 "                       const char *pattern,\n"
9363 "                       int len,\n"
9364 "                       const char *path);\n"
9365 "\n"
9366 msgstr ""
9367
9368 # type: textblock
9369 #. type: textblock
9370 #: ../src/guestfs-actions.pod:1707
9371 msgid ""
9372 "This function is like C<guestfs_fill> except that it creates a new file of "
9373 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9374 "pattern is truncated if necessary to ensure the length of the file is "
9375 "exactly C<len> bytes."
9376 msgstr ""
9377
9378 # type: textblock
9379 #. type: textblock
9380 #: ../src/guestfs-actions.pod:1719
9381 msgid "(Added in 1.3.12)"
9382 msgstr ""
9383
9384 # type: =head2
9385 #. type: =head2
9386 #: ../src/guestfs-actions.pod:1721
9387 msgid "guestfs_find"
9388 msgstr ""
9389
9390 # type: verbatim
9391 #. type: verbatim
9392 #: ../src/guestfs-actions.pod:1723
9393 #, no-wrap
9394 msgid ""
9395 " char **\n"
9396 " guestfs_find (guestfs_h *g,\n"
9397 "               const char *directory);\n"
9398 "\n"
9399 msgstr ""
9400
9401 # type: textblock
9402 #. type: textblock
9403 #: ../src/guestfs-actions.pod:1727 ../fish/guestfish-actions.pod:1165
9404 msgid ""
9405 "This command lists out all files and directories, recursively, starting at "
9406 "C<directory>.  It is essentially equivalent to running the shell command "
9407 "C<find directory -print> but some post-processing happens on the output, "
9408 "described below."
9409 msgstr ""
9410
9411 # type: textblock
9412 #. type: textblock
9413 #: ../src/guestfs-actions.pod:1732 ../fish/guestfish-actions.pod:1170
9414 msgid ""
9415 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9416 "structure was:"
9417 msgstr ""
9418
9419 # type: verbatim
9420 #. type: verbatim
9421 #: ../src/guestfs-actions.pod:1735 ../fish/guestfish-actions.pod:1173
9422 #, no-wrap
9423 msgid ""
9424 " /tmp/a\n"
9425 " /tmp/b\n"
9426 " /tmp/c/d\n"
9427 "\n"
9428 msgstr ""
9429
9430 # type: textblock
9431 #. type: textblock
9432 #: ../src/guestfs-actions.pod:1739
9433 msgid ""
9434 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
9435 msgstr ""
9436
9437 # type: verbatim
9438 #. type: verbatim
9439 #: ../src/guestfs-actions.pod:1742 ../fish/guestfish-actions.pod:1180
9440 #, no-wrap
9441 msgid ""
9442 " a\n"
9443 " b\n"
9444 " c\n"
9445 " c/d\n"
9446 "\n"
9447 msgstr ""
9448
9449 # type: textblock
9450 #. type: textblock
9451 #: ../src/guestfs-actions.pod:1747 ../fish/guestfish-actions.pod:1185
9452 msgid "If C<directory> is not a directory, then this command returns an error."
9453 msgstr ""
9454
9455 # type: textblock
9456 #. type: textblock
9457 #: ../src/guestfs-actions.pod:1750 ../fish/guestfish-actions.pod:1188
9458 msgid "The returned list is sorted."
9459 msgstr ""
9460
9461 # type: textblock
9462 #. type: textblock
9463 #: ../src/guestfs-actions.pod:1752
9464 msgid "See also C<guestfs_find0>."
9465 msgstr ""
9466
9467 # type: textblock
9468 #. type: textblock
9469 #: ../src/guestfs-actions.pod:1761 ../src/guestfs-actions.pod:3972
9470 #: ../src/guestfs-actions.pod:5515
9471 msgid "(Added in 1.0.27)"
9472 msgstr ""
9473
9474 # type: =head2
9475 #. type: =head2
9476 #: ../src/guestfs-actions.pod:1763
9477 msgid "guestfs_find0"
9478 msgstr ""
9479
9480 # type: verbatim
9481 #. type: verbatim
9482 #: ../src/guestfs-actions.pod:1765
9483 #, no-wrap
9484 msgid ""
9485 " int\n"
9486 " guestfs_find0 (guestfs_h *g,\n"
9487 "                const char *directory,\n"
9488 "                const char *files);\n"
9489 "\n"
9490 msgstr ""
9491
9492 # type: textblock
9493 #. type: textblock
9494 #: ../src/guestfs-actions.pod:1770 ../fish/guestfish-actions.pod:1199
9495 msgid ""
9496 "This command lists out all files and directories, recursively, starting at "
9497 "C<directory>, placing the resulting list in the external file called "
9498 "C<files>."
9499 msgstr ""
9500
9501 # type: textblock
9502 #. type: textblock
9503 #: ../src/guestfs-actions.pod:1774
9504 msgid ""
9505 "This command works the same way as C<guestfs_find> with the following "
9506 "exceptions:"
9507 msgstr ""
9508
9509 # type: textblock
9510 #. type: textblock
9511 #: ../src/guestfs-actions.pod:1781 ../fish/guestfish-actions.pod:1210
9512 msgid "The resulting list is written to an external file."
9513 msgstr ""
9514
9515 # type: textblock
9516 #. type: textblock
9517 #: ../src/guestfs-actions.pod:1785 ../fish/guestfish-actions.pod:1214
9518 msgid ""
9519 "Items (filenames) in the result are separated by C<\\0> characters.  See "
9520 "L<find(1)> option I<-print0>."
9521 msgstr ""
9522
9523 # type: textblock
9524 #. type: textblock
9525 #: ../src/guestfs-actions.pod:1790 ../fish/guestfish-actions.pod:1219
9526 msgid "This command is not limited in the number of names that it can return."
9527 msgstr ""
9528
9529 # type: textblock
9530 #. type: textblock
9531 #: ../src/guestfs-actions.pod:1795 ../fish/guestfish-actions.pod:1224
9532 msgid "The result list is not sorted."
9533 msgstr ""
9534
9535 # type: textblock
9536 #. type: textblock
9537 #: ../src/guestfs-actions.pod:1801
9538 msgid "(Added in 1.0.74)"
9539 msgstr ""
9540
9541 # type: =head2
9542 #. type: =head2
9543 #: ../src/guestfs-actions.pod:1803
9544 msgid "guestfs_findfs_label"
9545 msgstr ""
9546
9547 # type: verbatim
9548 #. type: verbatim
9549 #: ../src/guestfs-actions.pod:1805
9550 #, no-wrap
9551 msgid ""
9552 " char *\n"
9553 " guestfs_findfs_label (guestfs_h *g,\n"
9554 "                       const char *label);\n"
9555 "\n"
9556 msgstr ""
9557
9558 # type: textblock
9559 #. type: textblock
9560 #: ../src/guestfs-actions.pod:1809 ../fish/guestfish-actions.pod:1234
9561 msgid ""
9562 "This command searches the filesystems and returns the one which has the "
9563 "given label.  An error is returned if no such filesystem can be found."
9564 msgstr ""
9565
9566 # type: textblock
9567 #. type: textblock
9568 #: ../src/guestfs-actions.pod:1813
9569 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
9570 msgstr ""
9571
9572 # type: =head2
9573 #. type: =head2
9574 #: ../src/guestfs-actions.pod:1820
9575 msgid "guestfs_findfs_uuid"
9576 msgstr ""
9577
9578 # type: verbatim
9579 #. type: verbatim
9580 #: ../src/guestfs-actions.pod:1822
9581 #, no-wrap
9582 msgid ""
9583 " char *\n"
9584 " guestfs_findfs_uuid (guestfs_h *g,\n"
9585 "                      const char *uuid);\n"
9586 "\n"
9587 msgstr ""
9588
9589 # type: textblock
9590 #. type: textblock
9591 #: ../src/guestfs-actions.pod:1826 ../fish/guestfish-actions.pod:1244
9592 msgid ""
9593 "This command searches the filesystems and returns the one which has the "
9594 "given UUID.  An error is returned if no such filesystem can be found."
9595 msgstr ""
9596
9597 # type: textblock
9598 #. type: textblock
9599 #: ../src/guestfs-actions.pod:1830
9600 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
9601 msgstr ""
9602
9603 # type: =head2
9604 #. type: =head2
9605 #: ../src/guestfs-actions.pod:1837
9606 msgid "guestfs_fsck"
9607 msgstr ""
9608
9609 # type: verbatim
9610 #. type: verbatim
9611 #: ../src/guestfs-actions.pod:1839
9612 #, no-wrap
9613 msgid ""
9614 " int\n"
9615 " guestfs_fsck (guestfs_h *g,\n"
9616 "               const char *fstype,\n"
9617 "               const char *device);\n"
9618 "\n"
9619 msgstr ""
9620
9621 # type: textblock
9622 #. type: textblock
9623 #: ../src/guestfs-actions.pod:1844 ../fish/guestfish-actions.pod:1254
9624 msgid ""
9625 "This runs the filesystem checker (fsck) on C<device> which should have "
9626 "filesystem type C<fstype>."
9627 msgstr ""
9628
9629 # type: textblock
9630 #. type: textblock
9631 #: ../src/guestfs-actions.pod:1847 ../fish/guestfish-actions.pod:1257
9632 msgid ""
9633 "The returned integer is the status.  See L<fsck(8)> for the list of status "
9634 "codes from C<fsck>."
9635 msgstr ""
9636
9637 # type: textblock
9638 #. type: textblock
9639 #: ../src/guestfs-actions.pod:1856 ../fish/guestfish-actions.pod:1266
9640 msgid "Multiple status codes can be summed together."
9641 msgstr ""
9642
9643 # type: textblock
9644 #. type: textblock
9645 #: ../src/guestfs-actions.pod:1860 ../fish/guestfish-actions.pod:1270
9646 msgid ""
9647 "A non-zero return code can mean \"success\", for example if errors have been "
9648 "corrected on the filesystem."
9649 msgstr ""
9650
9651 # type: textblock
9652 #. type: textblock
9653 #: ../src/guestfs-actions.pod:1865 ../fish/guestfish-actions.pod:1275
9654 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
9655 msgstr ""
9656
9657 # type: textblock
9658 #. type: textblock
9659 #: ../src/guestfs-actions.pod:1870 ../fish/guestfish-actions.pod:1280
9660 msgid ""
9661 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
9662 msgstr ""
9663
9664 # type: textblock
9665 #. type: textblock
9666 #: ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:7207
9667 msgid "(Added in 1.0.16)"
9668 msgstr ""
9669
9670 # type: =head2
9671 #. type: =head2
9672 #: ../src/guestfs-actions.pod:1876
9673 msgid "guestfs_get_append"
9674 msgstr ""
9675
9676 # type: verbatim
9677 #. type: verbatim
9678 #: ../src/guestfs-actions.pod:1878
9679 #, no-wrap
9680 msgid ""
9681 " const char *\n"
9682 " guestfs_get_append (guestfs_h *g);\n"
9683 "\n"
9684 msgstr ""
9685
9686 # type: textblock
9687 #. type: textblock
9688 #: ../src/guestfs-actions.pod:1881 ../fish/guestfish-actions.pod:1286
9689 msgid ""
9690 "Return the additional kernel options which are added to the guest kernel "
9691 "command line."
9692 msgstr ""
9693
9694 # type: textblock
9695 #. type: textblock
9696 #: ../src/guestfs-actions.pod:1884 ../fish/guestfish-actions.pod:1289
9697 msgid "If C<NULL> then no options are added."
9698 msgstr ""
9699
9700 # type: textblock
9701 #. type: textblock
9702 #: ../src/guestfs-actions.pod:1886
9703 msgid ""
9704 "This function returns a string which may be NULL.  There is no way to return "
9705 "an error from this function.  The string is owned by the guest handle and "
9706 "must I<not> be freed."
9707 msgstr ""
9708
9709 # type: textblock
9710 #. type: textblock
9711 #: ../src/guestfs-actions.pod:1890 ../src/guestfs-actions.pod:5193
9712 #: ../src/guestfs-actions.pod:5673 ../src/guestfs-actions.pod:6069
9713 #: ../src/guestfs-actions.pod:6088 ../src/guestfs-actions.pod:6104
9714 #: ../src/guestfs-actions.pod:6121 ../src/guestfs-actions.pod:6878
9715 #: ../src/guestfs-actions.pod:6896 ../src/guestfs-actions.pod:7250
9716 msgid "(Added in 1.0.26)"
9717 msgstr ""
9718
9719 #. type: =head2
9720 #: ../src/guestfs-actions.pod:1892
9721 msgid "guestfs_get_attach_method"
9722 msgstr ""
9723
9724 #. type: verbatim
9725 #: ../src/guestfs-actions.pod:1894
9726 #, no-wrap
9727 msgid ""
9728 " char *\n"
9729 " guestfs_get_attach_method (guestfs_h *g);\n"
9730 "\n"
9731 msgstr ""
9732
9733 #. type: textblock
9734 #: ../src/guestfs-actions.pod:1897
9735 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
9736 msgstr ""
9737
9738 # type: =head2
9739 #. type: =head2
9740 #: ../src/guestfs-actions.pod:1902
9741 msgid "guestfs_get_autosync"
9742 msgstr ""
9743
9744 # type: verbatim
9745 #. type: verbatim
9746 #: ../src/guestfs-actions.pod:1904
9747 #, no-wrap
9748 msgid ""
9749 " int\n"
9750 " guestfs_get_autosync (guestfs_h *g);\n"
9751 "\n"
9752 msgstr ""
9753
9754 # type: textblock
9755 #. type: textblock
9756 #: ../src/guestfs-actions.pod:1907 ../fish/guestfish-actions.pod:1301
9757 msgid "Get the autosync flag."
9758 msgstr ""
9759
9760 # type: =head2
9761 #. type: =head2
9762 #: ../src/guestfs-actions.pod:1913
9763 msgid "guestfs_get_direct"
9764 msgstr ""
9765
9766 # type: verbatim
9767 #. type: verbatim
9768 #: ../src/guestfs-actions.pod:1915
9769 #, no-wrap
9770 msgid ""
9771 " int\n"
9772 " guestfs_get_direct (guestfs_h *g);\n"
9773 "\n"
9774 msgstr ""
9775
9776 # type: textblock
9777 #. type: textblock
9778 #: ../src/guestfs-actions.pod:1918 ../fish/guestfish-actions.pod:1307
9779 msgid "Return the direct appliance mode flag."
9780 msgstr ""
9781
9782 # type: textblock
9783 #. type: textblock
9784 #: ../src/guestfs-actions.pod:1922 ../src/guestfs-actions.pod:5742
9785 msgid "(Added in 1.0.72)"
9786 msgstr ""
9787
9788 # type: =head2
9789 #. type: =head2
9790 #: ../src/guestfs-actions.pod:1924
9791 msgid "guestfs_get_e2label"
9792 msgstr ""
9793
9794 # type: verbatim
9795 #. type: verbatim
9796 #: ../src/guestfs-actions.pod:1926
9797 #, no-wrap
9798 msgid ""
9799 " char *\n"
9800 " guestfs_get_e2label (guestfs_h *g,\n"
9801 "                      const char *device);\n"
9802 "\n"
9803 msgstr ""
9804
9805 # type: textblock
9806 #. type: textblock
9807 #: ../src/guestfs-actions.pod:1930 ../fish/guestfish-actions.pod:1313
9808 msgid ""
9809 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
9810 msgstr ""
9811
9812 # type: textblock
9813 #. type: textblock
9814 #: ../src/guestfs-actions.pod:1936 ../fish/guestfish-actions.pod:1316
9815 msgid ""
9816 "This function is deprecated.  In new code, use the C<vfs_label> call instead."
9817 msgstr ""
9818
9819 # type: textblock
9820 #. type: textblock
9821 #: ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:1964
9822 #: ../src/guestfs-actions.pod:5760 ../src/guestfs-actions.pod:5779
9823 msgid "(Added in 1.0.15)"
9824 msgstr ""
9825
9826 # type: =head2
9827 #. type: =head2
9828 #: ../src/guestfs-actions.pod:1945
9829 msgid "guestfs_get_e2uuid"
9830 msgstr ""
9831
9832 # type: verbatim
9833 #. type: verbatim
9834 #: ../src/guestfs-actions.pod:1947
9835 #, no-wrap
9836 msgid ""
9837 " char *\n"
9838 " guestfs_get_e2uuid (guestfs_h *g,\n"
9839 "                     const char *device);\n"
9840 "\n"
9841 msgstr ""
9842
9843 # type: textblock
9844 #. type: textblock
9845 #: ../src/guestfs-actions.pod:1951 ../fish/guestfish-actions.pod:1327
9846 msgid ""
9847 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
9848 msgstr ""
9849
9850 # type: textblock
9851 #. type: textblock
9852 #: ../src/guestfs-actions.pod:1957 ../fish/guestfish-actions.pod:1330
9853 msgid ""
9854 "This function is deprecated.  In new code, use the C<vfs_uuid> call instead."
9855 msgstr ""
9856
9857 # type: =head2
9858 #. type: =head2
9859 #: ../src/guestfs-actions.pod:1966
9860 msgid "guestfs_get_memsize"
9861 msgstr ""
9862
9863 # type: verbatim
9864 #. type: verbatim
9865 #: ../src/guestfs-actions.pod:1968
9866 #, no-wrap
9867 msgid ""
9868 " int\n"
9869 " guestfs_get_memsize (guestfs_h *g);\n"
9870 "\n"
9871 msgstr ""
9872
9873 # type: textblock
9874 #. type: textblock
9875 #: ../src/guestfs-actions.pod:1971 ../fish/guestfish-actions.pod:1341
9876 msgid ""
9877 "This gets the memory size in megabytes allocated to the qemu subprocess."
9878 msgstr ""
9879
9880 # type: textblock
9881 #. type: textblock
9882 #: ../src/guestfs-actions.pod:1974
9883 msgid ""
9884 "If C<guestfs_set_memsize> was not called on this handle, and if "
9885 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
9886 "value for memsize."
9887 msgstr ""
9888
9889 # type: textblock
9890 #. type: textblock
9891 #: ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:2059
9892 #: ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:5902
9893 #: ../fish/guestfish-actions.pod:1348 ../fish/guestfish-actions.pod:1399
9894 #: ../fish/guestfish-actions.pod:3893 ../fish/guestfish-actions.pod:3980
9895 msgid ""
9896 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
9897 msgstr ""
9898
9899 # type: textblock
9900 #. type: textblock
9901 #: ../src/guestfs-actions.pod:1983 ../src/guestfs-actions.pod:4263
9902 #: ../src/guestfs-actions.pod:4460 ../src/guestfs-actions.pod:4479
9903 #: ../src/guestfs-actions.pod:4498 ../src/guestfs-actions.pod:4510
9904 #: ../src/guestfs-actions.pod:4527 ../src/guestfs-actions.pod:4540
9905 #: ../src/guestfs-actions.pod:5418 ../src/guestfs-actions.pod:5800
9906 #: ../src/guestfs-actions.pod:6043 ../src/guestfs-actions.pod:6644
9907 msgid "(Added in 1.0.55)"
9908 msgstr ""
9909
9910 # type: =head2
9911 #. type: =head2
9912 #: ../src/guestfs-actions.pod:1985
9913 msgid "guestfs_get_network"
9914 msgstr ""
9915
9916 # type: verbatim
9917 #. type: verbatim
9918 #: ../src/guestfs-actions.pod:1987
9919 #, no-wrap
9920 msgid ""
9921 " int\n"
9922 " guestfs_get_network (guestfs_h *g);\n"
9923 "\n"
9924 msgstr ""
9925
9926 # type: textblock
9927 #. type: textblock
9928 #: ../src/guestfs-actions.pod:1990 ../fish/guestfish-actions.pod:1355
9929 msgid "This returns the enable network flag."
9930 msgstr ""
9931
9932 # type: textblock
9933 #. type: textblock
9934 #: ../src/guestfs-actions.pod:1994 ../src/guestfs-actions.pod:5819
9935 msgid "(Added in 1.5.4)"
9936 msgstr ""
9937
9938 # type: =head2
9939 #. type: =head2
9940 #: ../src/guestfs-actions.pod:1996
9941 msgid "guestfs_get_path"
9942 msgstr ""
9943
9944 # type: verbatim
9945 #. type: verbatim
9946 #: ../src/guestfs-actions.pod:1998
9947 #, no-wrap
9948 msgid ""
9949 " const char *\n"
9950 " guestfs_get_path (guestfs_h *g);\n"
9951 "\n"
9952 msgstr ""
9953
9954 # type: textblock
9955 #. type: textblock
9956 #: ../src/guestfs-actions.pod:2001 ../fish/guestfish-actions.pod:1361
9957 msgid "Return the current search path."
9958 msgstr ""
9959
9960 # type: textblock
9961 #. type: textblock
9962 #: ../src/guestfs-actions.pod:2003 ../fish/guestfish-actions.pod:1363
9963 msgid ""
9964 "This is always non-NULL.  If it wasn't set already, then this will return "
9965 "the default path."
9966 msgstr ""
9967
9968 # type: textblock
9969 #. type: textblock
9970 #: ../src/guestfs-actions.pod:2006 ../src/guestfs-actions.pod:2035
9971 msgid ""
9972 "This function returns a string, or NULL on error.  The string is owned by "
9973 "the guest handle and must I<not> be freed."
9974 msgstr ""
9975
9976 # type: =head2
9977 #. type: =head2
9978 #: ../src/guestfs-actions.pod:2011
9979 msgid "guestfs_get_pid"
9980 msgstr ""
9981
9982 # type: verbatim
9983 #. type: verbatim
9984 #: ../src/guestfs-actions.pod:2013
9985 #, no-wrap
9986 msgid ""
9987 " int\n"
9988 " guestfs_get_pid (guestfs_h *g);\n"
9989 "\n"
9990 msgstr ""
9991
9992 # type: textblock
9993 #. type: textblock
9994 #: ../src/guestfs-actions.pod:2016 ../fish/guestfish-actions.pod:1372
9995 msgid ""
9996 "Return the process ID of the qemu subprocess.  If there is no qemu "
9997 "subprocess, then this will return an error."
9998 msgstr ""
9999
10000 # type: textblock
10001 #. type: textblock
10002 #: ../src/guestfs-actions.pod:2019 ../fish/guestfish-actions.pod:1375
10003 msgid "This is an internal call used for debugging and testing."
10004 msgstr ""
10005
10006 # type: textblock
10007 #. type: textblock
10008 #: ../src/guestfs-actions.pod:2023
10009 msgid "(Added in 1.0.56)"
10010 msgstr ""
10011
10012 # type: =head2
10013 #. type: =head2
10014 #: ../src/guestfs-actions.pod:2025
10015 msgid "guestfs_get_qemu"
10016 msgstr ""
10017
10018 # type: verbatim
10019 #. type: verbatim
10020 #: ../src/guestfs-actions.pod:2027
10021 #, no-wrap
10022 msgid ""
10023 " const char *\n"
10024 " guestfs_get_qemu (guestfs_h *g);\n"
10025 "\n"
10026 msgstr ""
10027
10028 # type: textblock
10029 #. type: textblock
10030 #: ../src/guestfs-actions.pod:2030 ../fish/guestfish-actions.pod:1381
10031 msgid "Return the current qemu binary."
10032 msgstr ""
10033
10034 # type: textblock
10035 #. type: textblock
10036 #: ../src/guestfs-actions.pod:2032 ../fish/guestfish-actions.pod:1383
10037 msgid ""
10038 "This is always non-NULL.  If it wasn't set already, then this will return "
10039 "the default qemu binary name."
10040 msgstr ""
10041
10042 # type: textblock
10043 #. type: textblock
10044 #: ../src/guestfs-actions.pod:2038 ../src/guestfs-actions.pod:5864
10045 msgid "(Added in 1.0.6)"
10046 msgstr ""
10047
10048 # type: =head2
10049 #. type: =head2
10050 #: ../src/guestfs-actions.pod:2040
10051 msgid "guestfs_get_recovery_proc"
10052 msgstr ""
10053
10054 # type: verbatim
10055 #. type: verbatim
10056 #: ../src/guestfs-actions.pod:2042
10057 #, no-wrap
10058 msgid ""
10059 " int\n"
10060 " guestfs_get_recovery_proc (guestfs_h *g);\n"
10061 "\n"
10062 msgstr ""
10063
10064 # type: textblock
10065 #. type: textblock
10066 #: ../src/guestfs-actions.pod:2045 ../fish/guestfish-actions.pod:1390
10067 msgid "Return the recovery process enabled flag."
10068 msgstr ""
10069
10070 # type: textblock
10071 #. type: textblock
10072 #: ../src/guestfs-actions.pod:2049 ../src/guestfs-actions.pod:3373
10073 #: ../src/guestfs-actions.pod:3670 ../src/guestfs-actions.pod:4070
10074 #: ../src/guestfs-actions.pod:4102 ../src/guestfs-actions.pod:5123
10075 #: ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5888
10076 #: ../src/guestfs-actions.pod:6547 ../src/guestfs-actions.pod:6567
10077 #: ../src/guestfs-actions.pod:6759
10078 msgid "(Added in 1.0.77)"
10079 msgstr ""
10080
10081 # type: =head2
10082 #. type: =head2
10083 #: ../src/guestfs-actions.pod:2051
10084 msgid "guestfs_get_selinux"
10085 msgstr ""
10086
10087 # type: verbatim
10088 #. type: verbatim
10089 #: ../src/guestfs-actions.pod:2053
10090 #, no-wrap
10091 msgid ""
10092 " int\n"
10093 " guestfs_get_selinux (guestfs_h *g);\n"
10094 "\n"
10095 msgstr ""
10096
10097 # type: textblock
10098 #. type: textblock
10099 #: ../src/guestfs-actions.pod:2056
10100 msgid ""
10101 "This returns the current setting of the selinux flag which is passed to the "
10102 "appliance at boot time.  See C<guestfs_set_selinux>."
10103 msgstr ""
10104
10105 # type: textblock
10106 #. type: textblock
10107 #: ../src/guestfs-actions.pod:2064 ../src/guestfs-actions.pod:2127
10108 #: ../src/guestfs-actions.pod:5907 ../src/guestfs-actions.pod:5961
10109 msgid "(Added in 1.0.67)"
10110 msgstr ""
10111
10112 # type: =head2
10113 #. type: =head2
10114 #: ../src/guestfs-actions.pod:2066
10115 msgid "guestfs_get_state"
10116 msgstr ""
10117
10118 # type: verbatim
10119 #. type: verbatim
10120 #: ../src/guestfs-actions.pod:2068
10121 #, no-wrap
10122 msgid ""
10123 " int\n"
10124 " guestfs_get_state (guestfs_h *g);\n"
10125 "\n"
10126 msgstr ""
10127
10128 # type: textblock
10129 #. type: textblock
10130 #: ../src/guestfs-actions.pod:2071 ../fish/guestfish-actions.pod:1406
10131 msgid ""
10132 "This returns the current state as an opaque integer.  This is only useful "
10133 "for printing debug and internal error messages."
10134 msgstr ""
10135
10136 # type: textblock
10137 #. type: textblock
10138 #: ../src/guestfs-actions.pod:2074 ../src/guestfs-actions.pod:3176
10139 #: ../src/guestfs-actions.pod:3205 ../src/guestfs-actions.pod:3266
10140 #: ../src/guestfs-actions.pod:3293 ../fish/guestfish-actions.pod:1409
10141 #: ../fish/guestfish-actions.pod:2223 ../fish/guestfish-actions.pod:2241
10142 #: ../fish/guestfish-actions.pod:2279 ../fish/guestfish-actions.pod:2295
10143 msgid "For more information on states, see L<guestfs(3)>."
10144 msgstr ""
10145
10146 # type: =head2
10147 #. type: =head2
10148 #: ../src/guestfs-actions.pod:2080
10149 msgid "guestfs_get_trace"
10150 msgstr ""
10151
10152 # type: verbatim
10153 #. type: verbatim
10154 #: ../src/guestfs-actions.pod:2082
10155 #, no-wrap
10156 msgid ""
10157 " int\n"
10158 " guestfs_get_trace (guestfs_h *g);\n"
10159 "\n"
10160 msgstr ""
10161
10162 # type: textblock
10163 #. type: textblock
10164 #: ../src/guestfs-actions.pod:2085 ../fish/guestfish-actions.pod:1415
10165 msgid "Return the command trace flag."
10166 msgstr ""
10167
10168 # type: =head2
10169 #. type: =head2
10170 #: ../src/guestfs-actions.pod:2091
10171 msgid "guestfs_get_umask"
10172 msgstr ""
10173
10174 # type: verbatim
10175 #. type: verbatim
10176 #: ../src/guestfs-actions.pod:2093
10177 #, no-wrap
10178 msgid ""
10179 " int\n"
10180 " guestfs_get_umask (guestfs_h *g);\n"
10181 "\n"
10182 msgstr ""
10183
10184 # type: textblock
10185 #. type: textblock
10186 #: ../src/guestfs-actions.pod:2096
10187 msgid ""
10188 "Return the current umask.  By default the umask is C<022> unless it has been "
10189 "set by calling C<guestfs_umask>."
10190 msgstr ""
10191
10192 # type: =head2
10193 #. type: =head2
10194 #: ../src/guestfs-actions.pod:2103
10195 msgid "guestfs_get_verbose"
10196 msgstr ""
10197
10198 # type: verbatim
10199 #. type: verbatim
10200 #: ../src/guestfs-actions.pod:2105
10201 #, no-wrap
10202 msgid ""
10203 " int\n"
10204 " guestfs_get_verbose (guestfs_h *g);\n"
10205 "\n"
10206 msgstr ""
10207
10208 # type: textblock
10209 #. type: textblock
10210 #: ../src/guestfs-actions.pod:2108 ../fish/guestfish-actions.pod:1428
10211 msgid "This returns the verbose messages flag."
10212 msgstr ""
10213
10214 # type: =head2
10215 #. type: =head2
10216 #: ../src/guestfs-actions.pod:2114
10217 msgid "guestfs_getcon"
10218 msgstr ""
10219
10220 # type: verbatim
10221 #. type: verbatim
10222 #: ../src/guestfs-actions.pod:2116
10223 #, no-wrap
10224 msgid ""
10225 " char *\n"
10226 " guestfs_getcon (guestfs_h *g);\n"
10227 "\n"
10228 msgstr ""
10229
10230 # type: textblock
10231 #. type: textblock
10232 #: ../src/guestfs-actions.pod:2119 ../fish/guestfish-actions.pod:1434
10233 msgid "This gets the SELinux security context of the daemon."
10234 msgstr ""
10235
10236 # type: textblock
10237 #. type: textblock
10238 #: ../src/guestfs-actions.pod:2121
10239 msgid ""
10240 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10241 msgstr ""
10242
10243 # type: =head2
10244 #. type: =head2
10245 #: ../src/guestfs-actions.pod:2129
10246 msgid "guestfs_getxattr"
10247 msgstr ""
10248
10249 # type: verbatim
10250 #. type: verbatim
10251 #: ../src/guestfs-actions.pod:2131
10252 #, no-wrap
10253 msgid ""
10254 " char *\n"
10255 " guestfs_getxattr (guestfs_h *g,\n"
10256 "                   const char *path,\n"
10257 "                   const char *name,\n"
10258 "                   size_t *size_r);\n"
10259 "\n"
10260 msgstr ""
10261
10262 # type: textblock
10263 #. type: textblock
10264 #: ../src/guestfs-actions.pod:2137
10265 msgid ""
10266 "Get a single extended attribute from file C<path> named C<name>.  This call "
10267 "follows symlinks.  If you want to lookup an extended attribute for the "
10268 "symlink itself, use C<guestfs_lgetxattr>."
10269 msgstr ""
10270
10271 # type: textblock
10272 #. type: textblock
10273 #: ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:3387
10274 msgid ""
10275 "Normally it is better to get all extended attributes from a file in one go "
10276 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10277 "implementations are buggy and do not provide a way to list out attributes.  "
10278 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10279 "extended attributes you want in advance and call this function."
10280 msgstr ""
10281
10282 # type: textblock
10283 #. type: textblock
10284 #: ../src/guestfs-actions.pod:2148 ../src/guestfs-actions.pod:3394
10285 #: ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:2360
10286 msgid ""
10287 "Extended attribute values are blobs of binary data.  If there is no extended "
10288 "attribute named C<name>, this returns an error."
10289 msgstr ""
10290
10291 # type: textblock
10292 #. type: textblock
10293 #: ../src/guestfs-actions.pod:2151
10294 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10295 msgstr ""
10296
10297 # type: textblock
10298 #. type: textblock
10299 #: ../src/guestfs-actions.pod:2153 ../src/guestfs-actions.pod:2344
10300 #: ../src/guestfs-actions.pod:3399 ../src/guestfs-actions.pod:5116
10301 #: ../src/guestfs-actions.pod:5142 ../src/guestfs-actions.pod:5323
10302 msgid ""
10303 "This function returns a buffer, or NULL on error.  The size of the returned "
10304 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10305 "after use>."
10306 msgstr ""
10307
10308 #. type: textblock
10309 #: ../src/guestfs-actions.pod:2157 ../src/guestfs-actions.pod:3403
10310 msgid "(Added in 1.7.24)"
10311 msgstr ""
10312
10313 # type: =head2
10314 #. type: =head2
10315 #: ../src/guestfs-actions.pod:2159
10316 msgid "guestfs_getxattrs"
10317 msgstr ""
10318
10319 # type: verbatim
10320 #. type: verbatim
10321 #: ../src/guestfs-actions.pod:2161
10322 #, no-wrap
10323 msgid ""
10324 " struct guestfs_xattr_list *\n"
10325 " guestfs_getxattrs (guestfs_h *g,\n"
10326 "                    const char *path);\n"
10327 "\n"
10328 msgstr ""
10329
10330 # type: textblock
10331 #. type: textblock
10332 #: ../src/guestfs-actions.pod:2165 ../fish/guestfish-actions.pod:1463
10333 msgid ""
10334 "This call lists the extended attributes of the file or directory C<path>."
10335 msgstr ""
10336
10337 # type: textblock
10338 #. type: textblock
10339 #: ../src/guestfs-actions.pod:2168 ../fish/guestfish-actions.pod:1466
10340 msgid ""
10341 "At the system call level, this is a combination of the L<listxattr(2)> and "
10342 "L<getxattr(2)> calls."
10343 msgstr ""
10344
10345 # type: textblock
10346 #. type: textblock
10347 #: ../src/guestfs-actions.pod:2171
10348 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10349 msgstr ""
10350
10351 # type: textblock
10352 #. type: textblock
10353 #: ../src/guestfs-actions.pod:2173 ../src/guestfs-actions.pod:3415
10354 #: ../src/guestfs-actions.pod:4066
10355 msgid ""
10356 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10357 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10358 msgstr ""
10359
10360 # type: textblock
10361 #. type: textblock
10362 #: ../src/guestfs-actions.pod:2177 ../src/guestfs-actions.pod:3419
10363 #: ../src/guestfs-actions.pod:3584 ../src/guestfs-actions.pod:3620
10364 #: ../src/guestfs-actions.pod:5496 ../src/guestfs-actions.pod:5980
10365 #: ../src/guestfs-actions.pod:7315
10366 msgid "(Added in 1.0.59)"
10367 msgstr ""
10368
10369 # type: =head2
10370 #. type: =head2
10371 #: ../src/guestfs-actions.pod:2179
10372 msgid "guestfs_glob_expand"
10373 msgstr ""
10374
10375 # type: verbatim
10376 #. type: verbatim
10377 #: ../src/guestfs-actions.pod:2181
10378 #, no-wrap
10379 msgid ""
10380 " char **\n"
10381 " guestfs_glob_expand (guestfs_h *g,\n"
10382 "                      const char *pattern);\n"
10383 "\n"
10384 msgstr ""
10385
10386 # type: textblock
10387 #. type: textblock
10388 #: ../src/guestfs-actions.pod:2185 ../fish/guestfish-actions.pod:1475
10389 msgid ""
10390 "This command searches for all the pathnames matching C<pattern> according to "
10391 "the wildcard expansion rules used by the shell."
10392 msgstr ""
10393
10394 # type: textblock
10395 #. type: textblock
10396 #: ../src/guestfs-actions.pod:2189 ../fish/guestfish-actions.pod:1479
10397 msgid ""
10398 "If no paths match, then this returns an empty list (note: not an error)."
10399 msgstr ""
10400
10401 # type: textblock
10402 #. type: textblock
10403 #: ../src/guestfs-actions.pod:2192 ../fish/guestfish-actions.pod:1482
10404 msgid ""
10405 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10406 "GLOB_BRACE>.  See that manual page for more details."
10407 msgstr ""
10408
10409 # type: textblock
10410 #. type: textblock
10411 #: ../src/guestfs-actions.pod:2200 ../src/guestfs-actions.pod:6145
10412 #: ../src/guestfs-actions.pod:6162
10413 msgid "(Added in 1.0.50)"
10414 msgstr ""
10415
10416 # type: =head2
10417 #. type: =head2
10418 #: ../src/guestfs-actions.pod:2202
10419 msgid "guestfs_grep"
10420 msgstr ""
10421
10422 # type: verbatim
10423 #. type: verbatim
10424 #: ../src/guestfs-actions.pod:2204
10425 #, no-wrap
10426 msgid ""
10427 " char **\n"
10428 " guestfs_grep (guestfs_h *g,\n"
10429 "               const char *regex,\n"
10430 "               const char *path);\n"
10431 "\n"
10432 msgstr ""
10433
10434 # type: textblock
10435 #. type: textblock
10436 #: ../src/guestfs-actions.pod:2209 ../fish/guestfish-actions.pod:1490
10437 msgid "This calls the external C<grep> program and returns the matching lines."
10438 msgstr ""
10439
10440 # type: =head2
10441 #. type: =head2
10442 #: ../src/guestfs-actions.pod:2221
10443 msgid "guestfs_grepi"
10444 msgstr ""
10445
10446 # type: verbatim
10447 #. type: verbatim
10448 #: ../src/guestfs-actions.pod:2223
10449 #, no-wrap
10450 msgid ""
10451 " char **\n"
10452 " guestfs_grepi (guestfs_h *g,\n"
10453 "                const char *regex,\n"
10454 "                const char *path);\n"
10455 "\n"
10456 msgstr ""
10457
10458 # type: textblock
10459 #. type: textblock
10460 #: ../src/guestfs-actions.pod:2228 ../fish/guestfish-actions.pod:1500
10461 msgid ""
10462 "This calls the external C<grep -i> program and returns the matching lines."
10463 msgstr ""
10464
10465 # type: =head2
10466 #. type: =head2
10467 #: ../src/guestfs-actions.pod:2240
10468 msgid "guestfs_grub_install"
10469 msgstr ""
10470
10471 # type: verbatim
10472 #. type: verbatim
10473 #: ../src/guestfs-actions.pod:2242
10474 #, no-wrap
10475 msgid ""
10476 " int\n"
10477 " guestfs_grub_install (guestfs_h *g,\n"
10478 "                       const char *root,\n"
10479 "                       const char *device);\n"
10480 "\n"
10481 msgstr ""
10482
10483 # type: textblock
10484 #. type: textblock
10485 #: ../src/guestfs-actions.pod:2247 ../fish/guestfish-actions.pod:1510
10486 msgid ""
10487 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
10488 "the root directory being C<root>."
10489 msgstr ""
10490
10491 # type: textblock
10492 #. type: textblock
10493 #: ../src/guestfs-actions.pod:2250 ../fish/guestfish-actions.pod:1513
10494 msgid ""
10495 "Note: If grub-install reports the error \"No suitable drive was found in the "
10496 "generated device map.\" it may be that you need to create a C</boot/grub/"
10497 "device.map> file first that contains the mapping between grub device names "
10498 "and Linux device names.  It is usually sufficient to create a file "
10499 "containing:"
10500 msgstr ""
10501
10502 # type: verbatim
10503 #. type: verbatim
10504 #: ../src/guestfs-actions.pod:2257 ../fish/guestfish-actions.pod:1520
10505 #, no-wrap
10506 msgid ""
10507 " (hd0) /dev/vda\n"
10508 "\n"
10509 msgstr ""
10510
10511 # type: textblock
10512 #. type: textblock
10513 #: ../src/guestfs-actions.pod:2259 ../fish/guestfish-actions.pod:1522
10514 msgid "replacing C</dev/vda> with the name of the installation device."
10515 msgstr ""
10516
10517 # type: textblock
10518 #. type: textblock
10519 #: ../src/guestfs-actions.pod:2263
10520 msgid "(Added in 1.0.17)"
10521 msgstr ""
10522
10523 # type: =head2
10524 #. type: =head2
10525 #: ../src/guestfs-actions.pod:2265
10526 msgid "guestfs_head"
10527 msgstr ""
10528
10529 # type: verbatim
10530 #. type: verbatim
10531 #: ../src/guestfs-actions.pod:2267
10532 #, no-wrap
10533 msgid ""
10534 " char **\n"
10535 " guestfs_head (guestfs_h *g,\n"
10536 "               const char *path);\n"
10537 "\n"
10538 msgstr ""
10539
10540 # type: textblock
10541 #. type: textblock
10542 #: ../src/guestfs-actions.pod:2271 ../fish/guestfish-actions.pod:1528
10543 msgid ""
10544 "This command returns up to the first 10 lines of a file as a list of strings."
10545 msgstr ""
10546
10547 # type: =head2
10548 #. type: =head2
10549 #: ../src/guestfs-actions.pod:2283
10550 msgid "guestfs_head_n"
10551 msgstr ""
10552
10553 # type: verbatim
10554 #. type: verbatim
10555 #: ../src/guestfs-actions.pod:2285
10556 #, no-wrap
10557 msgid ""
10558 " char **\n"
10559 " guestfs_head_n (guestfs_h *g,\n"
10560 "                 int nrlines,\n"
10561 "                 const char *path);\n"
10562 "\n"
10563 msgstr ""
10564
10565 # type: textblock
10566 #. type: textblock
10567 #: ../src/guestfs-actions.pod:2290 ../fish/guestfish-actions.pod:1538
10568 msgid ""
10569 "If the parameter C<nrlines> is a positive number, this returns the first "
10570 "C<nrlines> lines of the file C<path>."
10571 msgstr ""
10572
10573 # type: textblock
10574 #. type: textblock
10575 #: ../src/guestfs-actions.pod:2293 ../fish/guestfish-actions.pod:1541
10576 msgid ""
10577 "If the parameter C<nrlines> is a negative number, this returns lines from "
10578 "the file C<path>, excluding the last C<nrlines> lines."
10579 msgstr ""
10580
10581 # type: textblock
10582 #. type: textblock
10583 #: ../src/guestfs-actions.pod:2296 ../src/guestfs-actions.pod:6442
10584 #: ../fish/guestfish-actions.pod:1544 ../fish/guestfish-actions.pod:4326
10585 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
10586 msgstr ""
10587
10588 # type: =head2
10589 #. type: =head2
10590 #: ../src/guestfs-actions.pod:2307
10591 msgid "guestfs_hexdump"
10592 msgstr ""
10593
10594 # type: verbatim
10595 #. type: verbatim
10596 #: ../src/guestfs-actions.pod:2309
10597 #, no-wrap
10598 msgid ""
10599 " char *\n"
10600 " guestfs_hexdump (guestfs_h *g,\n"
10601 "                  const char *path);\n"
10602 "\n"
10603 msgstr ""
10604
10605 # type: textblock
10606 #. type: textblock
10607 #: ../src/guestfs-actions.pod:2313 ../fish/guestfish-actions.pod:1553
10608 msgid ""
10609 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
10610 "readable, canonical hex dump of the file."
10611 msgstr ""
10612
10613 # type: textblock
10614 #. type: textblock
10615 #: ../src/guestfs-actions.pod:2322 ../src/guestfs-actions.pod:6226
10616 #: ../src/guestfs-actions.pod:6281
10617 msgid "(Added in 1.0.22)"
10618 msgstr ""
10619
10620 # type: =head2
10621 #. type: =head2
10622 #: ../src/guestfs-actions.pod:2324
10623 msgid "guestfs_initrd_cat"
10624 msgstr ""
10625
10626 # type: verbatim
10627 #. type: verbatim
10628 #: ../src/guestfs-actions.pod:2326
10629 #, no-wrap
10630 msgid ""
10631 " char *\n"
10632 " guestfs_initrd_cat (guestfs_h *g,\n"
10633 "                     const char *initrdpath,\n"
10634 "                     const char *filename,\n"
10635 "                     size_t *size_r);\n"
10636 "\n"
10637 msgstr ""
10638
10639 # type: textblock
10640 #. type: textblock
10641 #: ../src/guestfs-actions.pod:2332 ../fish/guestfish-actions.pod:1563
10642 msgid ""
10643 "This command unpacks the file C<filename> from the initrd file called "
10644 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
10645 "character."
10646 msgstr ""
10647
10648 # type: textblock
10649 #. type: textblock
10650 #: ../src/guestfs-actions.pod:2336 ../fish/guestfish-actions.pod:1567
10651 msgid ""
10652 "For example, in guestfish you could use the following command to examine the "
10653 "boot script (usually called C</init>)  contained in a Linux initrd or "
10654 "initramfs image:"
10655 msgstr ""
10656
10657 # type: verbatim
10658 #. type: verbatim
10659 #: ../src/guestfs-actions.pod:2340 ../fish/guestfish-actions.pod:1571
10660 #, no-wrap
10661 msgid ""
10662 " initrd-cat /boot/initrd-<version>.img init\n"
10663 "\n"
10664 msgstr ""
10665
10666 # type: textblock
10667 #. type: textblock
10668 #: ../src/guestfs-actions.pod:2342
10669 msgid "See also C<guestfs_initrd_list>."
10670 msgstr ""
10671
10672 # type: =head2
10673 #. type: =head2
10674 #: ../src/guestfs-actions.pod:2353
10675 msgid "guestfs_initrd_list"
10676 msgstr ""
10677
10678 # type: verbatim
10679 #. type: verbatim
10680 #: ../src/guestfs-actions.pod:2355
10681 #, no-wrap
10682 msgid ""
10683 " char **\n"
10684 " guestfs_initrd_list (guestfs_h *g,\n"
10685 "                      const char *path);\n"
10686 "\n"
10687 msgstr ""
10688
10689 # type: textblock
10690 #. type: textblock
10691 #: ../src/guestfs-actions.pod:2359 ../fish/guestfish-actions.pod:1582
10692 msgid "This command lists out files contained in an initrd."
10693 msgstr ""
10694
10695 # type: textblock
10696 #. type: textblock
10697 #: ../src/guestfs-actions.pod:2361 ../fish/guestfish-actions.pod:1584
10698 msgid ""
10699 "The files are listed without any initial C</> character.  The files are "
10700 "listed in the order they appear (not necessarily alphabetical).  Directory "
10701 "names are listed as separate items."
10702 msgstr ""
10703
10704 # type: textblock
10705 #. type: textblock
10706 #: ../src/guestfs-actions.pod:2365 ../fish/guestfish-actions.pod:1588
10707 msgid ""
10708 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
10709 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
10710 "files)."
10711 msgstr ""
10712
10713 # type: =head2
10714 #. type: =head2
10715 #: ../src/guestfs-actions.pod:2375
10716 msgid "guestfs_inotify_add_watch"
10717 msgstr ""
10718
10719 # type: verbatim
10720 #. type: verbatim
10721 #: ../src/guestfs-actions.pod:2377
10722 #, no-wrap
10723 msgid ""
10724 " int64_t\n"
10725 " guestfs_inotify_add_watch (guestfs_h *g,\n"
10726 "                            const char *path,\n"
10727 "                            int mask);\n"
10728 "\n"
10729 msgstr ""
10730
10731 # type: textblock
10732 #. type: textblock
10733 #: ../src/guestfs-actions.pod:2382 ../fish/guestfish-actions.pod:1596
10734 msgid "Watch C<path> for the events listed in C<mask>."
10735 msgstr ""
10736
10737 # type: textblock
10738 #. type: textblock
10739 #: ../src/guestfs-actions.pod:2384 ../fish/guestfish-actions.pod:1598
10740 msgid ""
10741 "Note that if C<path> is a directory then events within that directory are "
10742 "watched, but this does I<not> happen recursively (in subdirectories)."
10743 msgstr ""
10744
10745 # type: textblock
10746 #. type: textblock
10747 #: ../src/guestfs-actions.pod:2388 ../fish/guestfish-actions.pod:1602
10748 msgid ""
10749 "Note for non-C or non-Linux callers: the inotify events are defined by the "
10750 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
10751 msgstr ""
10752
10753 # type: =head2
10754 #. type: =head2
10755 #: ../src/guestfs-actions.pod:2396
10756 msgid "guestfs_inotify_close"
10757 msgstr ""
10758
10759 # type: verbatim
10760 #. type: verbatim
10761 #: ../src/guestfs-actions.pod:2398
10762 #, no-wrap
10763 msgid ""
10764 " int\n"
10765 " guestfs_inotify_close (guestfs_h *g);\n"
10766 "\n"
10767 msgstr ""
10768
10769 # type: textblock
10770 #. type: textblock
10771 #: ../src/guestfs-actions.pod:2401 ../fish/guestfish-actions.pod:1610
10772 msgid ""
10773 "This closes the inotify handle which was previously opened by inotify_init.  "
10774 "It removes all watches, throws away any pending events, and deallocates all "
10775 "resources."
10776 msgstr ""
10777
10778 # type: =head2
10779 #. type: =head2
10780 #: ../src/guestfs-actions.pod:2409
10781 msgid "guestfs_inotify_files"
10782 msgstr ""
10783
10784 # type: verbatim
10785 #. type: verbatim
10786 #: ../src/guestfs-actions.pod:2411
10787 #, no-wrap
10788 msgid ""
10789 " char **\n"
10790 " guestfs_inotify_files (guestfs_h *g);\n"
10791 "\n"
10792 msgstr ""
10793
10794 # type: textblock
10795 #. type: textblock
10796 #: ../src/guestfs-actions.pod:2414
10797 msgid ""
10798 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
10799 "returns a list of pathnames of objects that were touched.  The returned "
10800 "pathnames are sorted and deduplicated."
10801 msgstr ""
10802
10803 # type: =head2
10804 #. type: =head2
10805 #: ../src/guestfs-actions.pod:2424
10806 msgid "guestfs_inotify_init"
10807 msgstr ""
10808
10809 # type: verbatim
10810 #. type: verbatim
10811 #: ../src/guestfs-actions.pod:2426
10812 #, no-wrap
10813 msgid ""
10814 " int\n"
10815 " guestfs_inotify_init (guestfs_h *g,\n"
10816 "                       int maxevents);\n"
10817 "\n"
10818 msgstr ""
10819
10820 # type: textblock
10821 #. type: textblock
10822 #: ../src/guestfs-actions.pod:2430 ../fish/guestfish-actions.pod:1626
10823 msgid ""
10824 "This command creates a new inotify handle.  The inotify subsystem can be "
10825 "used to notify events which happen to objects in the guest filesystem."
10826 msgstr ""
10827
10828 # type: textblock
10829 #. type: textblock
10830 #: ../src/guestfs-actions.pod:2434
10831 msgid ""
10832 "C<maxevents> is the maximum number of events which will be queued up between "
10833 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
10834 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
10835 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
10836 "throws away events, but records the fact that it threw them away by setting "
10837 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
10838 "C<guestfs_inotify_read>)."
10839 msgstr ""
10840
10841 # type: textblock
10842 #. type: textblock
10843 #: ../src/guestfs-actions.pod:2444
10844 msgid ""
10845 "Before any events are generated, you have to add some watches to the "
10846 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
10847 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
10848 msgstr ""
10849
10850 # type: textblock
10851 #. type: textblock
10852 #: ../src/guestfs-actions.pod:2450
10853 msgid ""
10854 "Queued up events should be read periodically by calling "
10855 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
10856 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
10857 "often enough then you risk the internal queue overflowing."
10858 msgstr ""
10859
10860 # type: textblock
10861 #. type: textblock
10862 #: ../src/guestfs-actions.pod:2457
10863 msgid ""
10864 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
10865 "This also removes any watches automatically."
10866 msgstr ""
10867
10868 # type: textblock
10869 #. type: textblock
10870 #: ../src/guestfs-actions.pod:2461 ../fish/guestfish-actions.pod:1657
10871 msgid ""
10872 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
10873 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
10874 "that there is one global inotify handle per libguestfs instance."
10875 msgstr ""
10876
10877 # type: =head2
10878 #. type: =head2
10879 #: ../src/guestfs-actions.pod:2470
10880 msgid "guestfs_inotify_read"
10881 msgstr ""
10882
10883 # type: verbatim
10884 #. type: verbatim
10885 #: ../src/guestfs-actions.pod:2472
10886 #, no-wrap
10887 msgid ""
10888 " struct guestfs_inotify_event_list *\n"
10889 " guestfs_inotify_read (guestfs_h *g);\n"
10890 "\n"
10891 msgstr ""
10892
10893 # type: textblock
10894 #. type: textblock
10895 #: ../src/guestfs-actions.pod:2475 ../fish/guestfish-actions.pod:1666
10896 msgid ""
10897 "Return the complete queue of events that have happened since the previous "
10898 "read call."
10899 msgstr ""
10900
10901 # type: textblock
10902 #. type: textblock
10903 #: ../src/guestfs-actions.pod:2478 ../fish/guestfish-actions.pod:1669
10904 msgid "If no events have happened, this returns an empty list."
10905 msgstr ""
10906
10907 # type: textblock
10908 #. type: textblock
10909 #: ../src/guestfs-actions.pod:2480 ../fish/guestfish-actions.pod:1671
10910 msgid ""
10911 "I<Note>: In order to make sure that all events have been read, you must call "
10912 "this function repeatedly until it returns an empty list.  The reason is that "
10913 "the call will read events up to the maximum appliance-to-host message size "
10914 "and leave remaining events in the queue."
10915 msgstr ""
10916
10917 # type: textblock
10918 #. type: textblock
10919 #: ../src/guestfs-actions.pod:2486
10920 msgid ""
10921 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
10922 "there was an error.  I<The caller must call "
10923 "C<guestfs_free_inotify_event_list> after use>."
10924 msgstr ""
10925
10926 # type: =head2
10927 #. type: =head2
10928 #: ../src/guestfs-actions.pod:2492
10929 msgid "guestfs_inotify_rm_watch"
10930 msgstr ""
10931
10932 # type: verbatim
10933 #. type: verbatim
10934 #: ../src/guestfs-actions.pod:2494
10935 #, no-wrap
10936 msgid ""
10937 " int\n"
10938 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
10939 "                           int wd);\n"
10940 "\n"
10941 msgstr ""
10942
10943 # type: textblock
10944 #. type: textblock
10945 #: ../src/guestfs-actions.pod:2498
10946 msgid ""
10947 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
10948 msgstr ""
10949
10950 # type: =head2
10951 #. type: =head2
10952 #: ../src/guestfs-actions.pod:2505
10953 msgid "guestfs_inspect_get_arch"
10954 msgstr ""
10955
10956 # type: verbatim
10957 #. type: verbatim
10958 #: ../src/guestfs-actions.pod:2507
10959 #, no-wrap
10960 msgid ""
10961 " char *\n"
10962 " guestfs_inspect_get_arch (guestfs_h *g,\n"
10963 "                           const char *root);\n"
10964 "\n"
10965 msgstr ""
10966
10967 # type: textblock
10968 #. type: textblock
10969 #: ../src/guestfs-actions.pod:2511 ../src/guestfs-actions.pod:2534
10970 #: ../src/guestfs-actions.pod:2615 ../src/guestfs-actions.pod:2641
10971 #: ../src/guestfs-actions.pod:2680 ../src/guestfs-actions.pod:2702
10972 #: ../src/guestfs-actions.pod:2729 ../src/guestfs-actions.pod:2750
10973 #: ../src/guestfs-actions.pod:2787 ../src/guestfs-actions.pod:2816
10974 #: ../src/guestfs-actions.pod:2847 ../src/guestfs-actions.pod:2891
10975 #: ../src/guestfs-actions.pod:2933 ../src/guestfs-actions.pod:2956
10976 #: ../src/guestfs-actions.pod:2973 ../src/guestfs-actions.pod:2990
10977 #: ../src/guestfs-actions.pod:3009
10978 msgid ""
10979 "This function should only be called with a root device string as returned by "
10980 "C<guestfs_inspect_os>."
10981 msgstr ""
10982
10983 # type: textblock
10984 #. type: textblock
10985 #: ../src/guestfs-actions.pod:2514
10986 msgid ""
10987 "This returns the architecture of the inspected operating system.  The "
10988 "possible return values are listed under C<guestfs_file_architecture>."
10989 msgstr ""
10990
10991 # type: textblock
10992 #. type: textblock
10993 #: ../src/guestfs-actions.pod:2518 ../fish/guestfish-actions.pod:1695
10994 msgid ""
10995 "If the architecture could not be determined, then the string C<unknown> is "
10996 "returned."
10997 msgstr ""
10998
10999 # type: textblock
11000 #. type: textblock
11001 #: ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2602
11002 #: ../src/guestfs-actions.pod:2669 ../src/guestfs-actions.pod:2689
11003 #: ../src/guestfs-actions.pod:2717 ../src/guestfs-actions.pod:2803
11004 #: ../src/guestfs-actions.pod:2834 ../src/guestfs-actions.pod:2858
11005 #: ../src/guestfs-actions.pod:2877 ../src/guestfs-actions.pod:2920
11006 #: ../src/guestfs-actions.pod:2943 ../src/guestfs-actions.pod:2963
11007 #: ../src/guestfs-actions.pod:2980 ../src/guestfs-actions.pod:2999
11008 #: ../src/guestfs-actions.pod:3102 ../src/guestfs-actions.pod:3143
11009 #: ../fish/guestfish-actions.pod:1698 ../fish/guestfish-actions.pod:1772
11010 #: ../fish/guestfish-actions.pod:1824 ../fish/guestfish-actions.pod:1839
11011 #: ../fish/guestfish-actions.pod:1860 ../fish/guestfish-actions.pod:1924
11012 #: ../fish/guestfish-actions.pod:1948 ../fish/guestfish-actions.pod:1965
11013 #: ../fish/guestfish-actions.pod:1978 ../fish/guestfish-actions.pod:2013
11014 #: ../fish/guestfish-actions.pod:2029 ../fish/guestfish-actions.pod:2042
11015 #: ../fish/guestfish-actions.pod:2055 ../fish/guestfish-actions.pod:2070
11016 #: ../fish/guestfish-actions.pod:2169 ../fish/guestfish-actions.pod:2203
11017 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
11018 msgstr ""
11019
11020 # type: =head2
11021 #. type: =head2
11022 #: ../src/guestfs-actions.pod:2528
11023 msgid "guestfs_inspect_get_distro"
11024 msgstr ""
11025
11026 # type: verbatim
11027 #. type: verbatim
11028 #: ../src/guestfs-actions.pod:2530
11029 #, no-wrap
11030 msgid ""
11031 " char *\n"
11032 " guestfs_inspect_get_distro (guestfs_h *g,\n"
11033 "                             const char *root);\n"
11034 "\n"
11035 msgstr ""
11036
11037 # type: textblock
11038 #. type: textblock
11039 #: ../src/guestfs-actions.pod:2537 ../fish/guestfish-actions.pod:1707
11040 msgid ""
11041 "This returns the distro (distribution) of the inspected operating system."
11042 msgstr ""
11043
11044 # type: textblock
11045 #. type: textblock
11046 #: ../src/guestfs-actions.pod:2540 ../fish/guestfish-actions.pod:1710
11047 msgid "Currently defined distros are:"
11048 msgstr ""
11049
11050 # type: =item
11051 #. type: =item
11052 #: ../src/guestfs-actions.pod:2544 ../fish/guestfish-actions.pod:1714
11053 msgid "\"archlinux\""
11054 msgstr ""
11055
11056 # type: textblock
11057 #. type: textblock
11058 #: ../src/guestfs-actions.pod:2546 ../fish/guestfish-actions.pod:1716
11059 msgid "Arch Linux."
11060 msgstr ""
11061
11062 # type: =item
11063 #. type: =item
11064 #: ../src/guestfs-actions.pod:2548 ../fish/guestfish-actions.pod:1718
11065 msgid "\"debian\""
11066 msgstr ""
11067
11068 # type: textblock
11069 #. type: textblock
11070 #: ../src/guestfs-actions.pod:2550 ../fish/guestfish-actions.pod:1720
11071 msgid "Debian."
11072 msgstr ""
11073
11074 # type: =item
11075 #. type: =item
11076 #: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1722
11077 msgid "\"fedora\""
11078 msgstr ""
11079
11080 # type: textblock
11081 #. type: textblock
11082 #: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1724
11083 msgid "Fedora."
11084 msgstr ""
11085
11086 # type: =item
11087 #. type: =item
11088 #: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1726
11089 msgid "\"gentoo\""
11090 msgstr ""
11091
11092 # type: textblock
11093 #. type: textblock
11094 #: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1728
11095 msgid "Gentoo."
11096 msgstr ""
11097
11098 # type: =item
11099 #. type: =item
11100 #: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1730
11101 msgid "\"linuxmint\""
11102 msgstr ""
11103
11104 # type: textblock
11105 #. type: textblock
11106 #: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1732
11107 msgid "Linux Mint."
11108 msgstr ""
11109
11110 # type: =item
11111 #. type: =item
11112 #: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1734
11113 msgid "\"mandriva\""
11114 msgstr ""
11115
11116 # type: textblock
11117 #. type: textblock
11118 #: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1736
11119 msgid "Mandriva."
11120 msgstr ""
11121
11122 # type: =item
11123 #. type: =item
11124 #: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1738
11125 msgid "\"meego\""
11126 msgstr ""
11127
11128 # type: textblock
11129 #. type: textblock
11130 #: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1740
11131 msgid "MeeGo."
11132 msgstr ""
11133
11134 # type: =item
11135 #. type: =item
11136 #: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1742
11137 msgid "\"pardus\""
11138 msgstr ""
11139
11140 # type: textblock
11141 #. type: textblock
11142 #: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1744
11143 msgid "Pardus."
11144 msgstr ""
11145
11146 # type: =item
11147 #. type: =item
11148 #: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1746
11149 msgid "\"redhat-based\""
11150 msgstr ""
11151
11152 # type: textblock
11153 #. type: textblock
11154 #: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1748
11155 msgid "Some Red Hat-derived distro."
11156 msgstr ""
11157
11158 # type: =item
11159 #. type: =item
11160 #: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1750
11161 msgid "\"rhel\""
11162 msgstr ""
11163
11164 # type: textblock
11165 #. type: textblock
11166 #: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1752
11167 msgid "Red Hat Enterprise Linux and some derivatives."
11168 msgstr ""
11169
11170 # type: =item
11171 #. type: =item
11172 #: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1754
11173 msgid "\"ubuntu\""
11174 msgstr ""
11175
11176 # type: textblock
11177 #. type: textblock
11178 #: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1756
11179 msgid "Ubuntu."
11180 msgstr ""
11181
11182 # type: =item
11183 #. type: =item
11184 #: ../src/guestfs-actions.pod:2588 ../src/guestfs-actions.pod:2660
11185 #: ../src/guestfs-actions.pod:2911 ../fish/guestfish-actions.pod:1758
11186 #: ../fish/guestfish-actions.pod:1815 ../fish/guestfish-actions.pod:2004
11187 msgid "\"unknown\""
11188 msgstr ""
11189
11190 # type: textblock
11191 #. type: textblock
11192 #: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1760
11193 msgid "The distro could not be determined."
11194 msgstr ""
11195
11196 # type: =item
11197 #. type: =item
11198 #: ../src/guestfs-actions.pod:2592 ../src/guestfs-actions.pod:2903
11199 #: ../fish/guestfish-actions.pod:1762 ../fish/guestfish-actions.pod:1996
11200 msgid "\"windows\""
11201 msgstr ""
11202
11203 # type: textblock
11204 #. type: textblock
11205 #: ../src/guestfs-actions.pod:2594 ../fish/guestfish-actions.pod:1764
11206 msgid ""
11207 "Windows does not have distributions.  This string is returned if the OS type "
11208 "is Windows."
11209 msgstr ""
11210
11211 # type: textblock
11212 #. type: textblock
11213 #: ../src/guestfs-actions.pod:2599 ../src/guestfs-actions.pod:2666
11214 #: ../src/guestfs-actions.pod:2917 ../fish/guestfish-actions.pod:1769
11215 #: ../fish/guestfish-actions.pod:1821 ../fish/guestfish-actions.pod:2010
11216 msgid ""
11217 "Future versions of libguestfs may return other strings here.  The caller "
11218 "should be prepared to handle any string."
11219 msgstr ""
11220
11221 # type: =head2
11222 #. type: =head2
11223 #: ../src/guestfs-actions.pod:2609
11224 msgid "guestfs_inspect_get_filesystems"
11225 msgstr ""
11226
11227 # type: verbatim
11228 #. type: verbatim
11229 #: ../src/guestfs-actions.pod:2611
11230 #, no-wrap
11231 msgid ""
11232 " char **\n"
11233 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11234 "                                  const char *root);\n"
11235 "\n"
11236 msgstr ""
11237
11238 # type: textblock
11239 #. type: textblock
11240 #: ../src/guestfs-actions.pod:2618 ../fish/guestfish-actions.pod:1781
11241 msgid ""
11242 "This returns a list of all the filesystems that we think are associated with "
11243 "this operating system.  This includes the root filesystem, other ordinary "
11244 "filesystems, and non-mounted devices like swap partitions."
11245 msgstr ""
11246
11247 # type: textblock
11248 #. type: textblock
11249 #: ../src/guestfs-actions.pod:2623 ../fish/guestfish-actions.pod:1786
11250 msgid ""
11251 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11252 "to be shared between operating systems."
11253 msgstr ""
11254
11255 # type: textblock
11256 #. type: textblock
11257 #: ../src/guestfs-actions.pod:2626
11258 msgid ""
11259 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11260 "C<guestfs_inspect_get_mountpoints>."
11261 msgstr ""
11262
11263 #. type: =head2
11264 #: ../src/guestfs-actions.pod:2635
11265 msgid "guestfs_inspect_get_format"
11266 msgstr ""
11267
11268 #. type: verbatim
11269 #: ../src/guestfs-actions.pod:2637
11270 #, no-wrap
11271 msgid ""
11272 " char *\n"
11273 " guestfs_inspect_get_format (guestfs_h *g,\n"
11274 "                             const char *root);\n"
11275 "\n"
11276 msgstr ""
11277
11278 #. type: textblock
11279 #: ../src/guestfs-actions.pod:2644 ../fish/guestfish-actions.pod:1799
11280 msgid ""
11281 "This returns the format of the inspected operating system.  You can use it "
11282 "to detect install images, live CDs and similar."
11283 msgstr ""
11284
11285 #. type: textblock
11286 #: ../src/guestfs-actions.pod:2647 ../fish/guestfish-actions.pod:1802
11287 msgid "Currently defined formats are:"
11288 msgstr ""
11289
11290 #. type: =item
11291 #: ../src/guestfs-actions.pod:2651 ../fish/guestfish-actions.pod:1806
11292 msgid "\"installed\""
11293 msgstr ""
11294
11295 #. type: textblock
11296 #: ../src/guestfs-actions.pod:2653 ../fish/guestfish-actions.pod:1808
11297 msgid "This is an installed operating system."
11298 msgstr ""
11299
11300 #. type: =item
11301 #: ../src/guestfs-actions.pod:2655 ../fish/guestfish-actions.pod:1810
11302 msgid "\"installer\""
11303 msgstr ""
11304
11305 #. type: textblock
11306 #: ../src/guestfs-actions.pod:2657 ../fish/guestfish-actions.pod:1812
11307 msgid ""
11308 "The disk image being inspected is not an installed operating system, but a "
11309 "I<bootable> install disk, live CD, or similar."
11310 msgstr ""
11311
11312 #. type: textblock
11313 #: ../src/guestfs-actions.pod:2662 ../fish/guestfish-actions.pod:1817
11314 msgid "The format of this disk image is not known."
11315 msgstr ""
11316
11317 # type: =head2
11318 #. type: =head2
11319 #: ../src/guestfs-actions.pod:2674
11320 msgid "guestfs_inspect_get_hostname"
11321 msgstr ""
11322
11323 # type: verbatim
11324 #. type: verbatim
11325 #: ../src/guestfs-actions.pod:2676
11326 #, no-wrap
11327 msgid ""
11328 " char *\n"
11329 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
11330 "                               const char *root);\n"
11331 "\n"
11332 msgstr ""
11333
11334 # type: textblock
11335 #. type: textblock
11336 #: ../src/guestfs-actions.pod:2683 ../fish/guestfish-actions.pod:1833
11337 msgid ""
11338 "This function returns the hostname of the operating system as found by "
11339 "inspection of the guest's configuration files."
11340 msgstr ""
11341
11342 # type: textblock
11343 #. type: textblock
11344 #: ../src/guestfs-actions.pod:2686 ../fish/guestfish-actions.pod:1836
11345 msgid ""
11346 "If the hostname could not be determined, then the string C<unknown> is "
11347 "returned."
11348 msgstr ""
11349
11350 # type: textblock
11351 #. type: textblock
11352 #: ../src/guestfs-actions.pod:2694
11353 msgid "(Added in 1.7.9)"
11354 msgstr ""
11355
11356 # type: =head2
11357 #. type: =head2
11358 #: ../src/guestfs-actions.pod:2696
11359 msgid "guestfs_inspect_get_major_version"
11360 msgstr ""
11361
11362 # type: verbatim
11363 #. type: verbatim
11364 #: ../src/guestfs-actions.pod:2698
11365 #, no-wrap
11366 msgid ""
11367 " int\n"
11368 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
11369 "                                    const char *root);\n"
11370 "\n"
11371 msgstr ""
11372
11373 # type: textblock
11374 #. type: textblock
11375 #: ../src/guestfs-actions.pod:2705 ../fish/guestfish-actions.pod:1848
11376 msgid ""
11377 "This returns the major version number of the inspected operating system."
11378 msgstr ""
11379
11380 # type: textblock
11381 #. type: textblock
11382 #: ../src/guestfs-actions.pod:2708 ../fish/guestfish-actions.pod:1851
11383 msgid ""
11384 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
11385 "popular public names used by the operating system.  Notably the operating "
11386 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
11387 "1).  You can find out the real versions corresponding to releases of Windows "
11388 "by consulting Wikipedia or MSDN."
11389 msgstr ""
11390
11391 # type: textblock
11392 #. type: textblock
11393 #: ../src/guestfs-actions.pod:2715 ../src/guestfs-actions.pod:2735
11394 #: ../fish/guestfish-actions.pod:1858 ../fish/guestfish-actions.pod:1872
11395 msgid "If the version could not be determined, then C<0> is returned."
11396 msgstr ""
11397
11398 # type: =head2
11399 #. type: =head2
11400 #: ../src/guestfs-actions.pod:2723
11401 msgid "guestfs_inspect_get_minor_version"
11402 msgstr ""
11403
11404 # type: verbatim
11405 #. type: verbatim
11406 #: ../src/guestfs-actions.pod:2725
11407 #, no-wrap
11408 msgid ""
11409 " int\n"
11410 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
11411 "                                    const char *root);\n"
11412 "\n"
11413 msgstr ""
11414
11415 # type: textblock
11416 #. type: textblock
11417 #: ../src/guestfs-actions.pod:2732 ../fish/guestfish-actions.pod:1869
11418 msgid ""
11419 "This returns the minor version number of the inspected operating system."
11420 msgstr ""
11421
11422 # type: textblock
11423 #. type: textblock
11424 #: ../src/guestfs-actions.pod:2737
11425 msgid ""
11426 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11427 "C<guestfs_inspect_get_major_version>."
11428 msgstr ""
11429
11430 # type: =head2
11431 #. type: =head2
11432 #: ../src/guestfs-actions.pod:2744
11433 msgid "guestfs_inspect_get_mountpoints"
11434 msgstr ""
11435
11436 # type: verbatim
11437 #. type: verbatim
11438 #: ../src/guestfs-actions.pod:2746
11439 #, no-wrap
11440 msgid ""
11441 " char **\n"
11442 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
11443 "                                  const char *root);\n"
11444 "\n"
11445 msgstr ""
11446
11447 #. type: textblock
11448 #: ../src/guestfs-actions.pod:2753 ../fish/guestfish-actions.pod:1884
11449 msgid ""
11450 "This returns a hash of where we think the filesystems associated with this "
11451 "operating system should be mounted.  Callers should note that this is at "
11452 "best an educated guess made by reading configuration files such as C</etc/"
11453 "fstab>.  I<In particular note> that this may return filesystems which are "
11454 "non-existent or not mountable and callers should be prepared to handle or "
11455 "ignore failures if they try to mount them."
11456 msgstr ""
11457
11458 # type: textblock
11459 #. type: textblock
11460 #: ../src/guestfs-actions.pod:2762 ../fish/guestfish-actions.pod:1893
11461 msgid ""
11462 "Each element in the returned hashtable has a key which is the path of the "
11463 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
11464 "mounted there (eg. C</dev/sda1>)."
11465 msgstr ""
11466
11467 # type: textblock
11468 #. type: textblock
11469 #: ../src/guestfs-actions.pod:2767 ../fish/guestfish-actions.pod:1898
11470 msgid ""
11471 "Non-mounted devices such as swap devices are I<not> returned in this list."
11472 msgstr ""
11473
11474 # type: textblock
11475 #. type: textblock
11476 #: ../src/guestfs-actions.pod:2770
11477 msgid ""
11478 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11479 "C<guestfs_inspect_get_filesystems>."
11480 msgstr ""
11481
11482 # type: textblock
11483 #. type: textblock
11484 #: ../src/guestfs-actions.pod:2773 ../src/guestfs-actions.pod:3472
11485 #: ../src/guestfs-actions.pod:4682 ../src/guestfs-actions.pod:6583
11486 msgid ""
11487 "This function returns a NULL-terminated array of strings, or NULL if there "
11488 "was an error.  The array of strings will always have length C<2n+1>, where "
11489 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11490 "caller must free the strings and the array after use>."
11491 msgstr ""
11492
11493 # type: =head2
11494 #. type: =head2
11495 #: ../src/guestfs-actions.pod:2781
11496 msgid "guestfs_inspect_get_package_format"
11497 msgstr ""
11498
11499 # type: verbatim
11500 #. type: verbatim
11501 #: ../src/guestfs-actions.pod:2783
11502 #, no-wrap
11503 msgid ""
11504 " char *\n"
11505 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
11506 "                                     const char *root);\n"
11507 "\n"
11508 msgstr ""
11509
11510 # type: textblock
11511 #. type: textblock
11512 #: ../src/guestfs-actions.pod:2790
11513 msgid ""
11514 "This function and C<guestfs_inspect_get_package_management> return the "
11515 "package format and package management tool used by the inspected operating "
11516 "system.  For example for Fedora these functions would return C<rpm> (package "
11517 "format) and C<yum> (package management)."
11518 msgstr ""
11519
11520 # type: textblock
11521 #. type: textblock
11522 #: ../src/guestfs-actions.pod:2796 ../fish/guestfish-actions.pod:1917
11523 msgid ""
11524 "This returns the string C<unknown> if we could not determine the package "
11525 "format I<or> if the operating system does not have a real packaging system "
11526 "(eg. Windows)."
11527 msgstr ""
11528
11529 # type: textblock
11530 #. type: textblock
11531 #: ../src/guestfs-actions.pod:2800 ../fish/guestfish-actions.pod:1921
11532 msgid ""
11533 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
11534 "Future versions of libguestfs may return other strings."
11535 msgstr ""
11536
11537 # type: textblock
11538 #. type: textblock
11539 #: ../src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:2839
11540 msgid "(Added in 1.7.5)"
11541 msgstr ""
11542
11543 # type: =head2
11544 #. type: =head2
11545 #: ../src/guestfs-actions.pod:2810
11546 msgid "guestfs_inspect_get_package_management"
11547 msgstr ""
11548
11549 # type: verbatim
11550 #. type: verbatim
11551 #: ../src/guestfs-actions.pod:2812
11552 #, no-wrap
11553 msgid ""
11554 " char *\n"
11555 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
11556 "                                         const char *root);\n"
11557 "\n"
11558 msgstr ""
11559
11560 # type: textblock
11561 #. type: textblock
11562 #: ../src/guestfs-actions.pod:2819
11563 msgid ""
11564 "C<guestfs_inspect_get_package_format> and this function return the package "
11565 "format and package management tool used by the inspected operating system.  "
11566 "For example for Fedora these functions would return C<rpm> (package format) "
11567 "and C<yum> (package management)."
11568 msgstr ""
11569
11570 # type: textblock
11571 #. type: textblock
11572 #: ../src/guestfs-actions.pod:2825 ../fish/guestfish-actions.pod:1939
11573 msgid ""
11574 "This returns the string C<unknown> if we could not determine the package "
11575 "management tool I<or> if the operating system does not have a real packaging "
11576 "system (eg. Windows)."
11577 msgstr ""
11578
11579 # type: textblock
11580 #. type: textblock
11581 #: ../src/guestfs-actions.pod:2829 ../fish/guestfish-actions.pod:1943
11582 msgid ""
11583 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
11584 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
11585 "libguestfs may return other strings."
11586 msgstr ""
11587
11588 # type: =head2
11589 #. type: =head2
11590 #: ../src/guestfs-actions.pod:2841
11591 msgid "guestfs_inspect_get_product_name"
11592 msgstr ""
11593
11594 # type: verbatim
11595 #. type: verbatim
11596 #: ../src/guestfs-actions.pod:2843
11597 #, no-wrap
11598 msgid ""
11599 " char *\n"
11600 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
11601 "                                   const char *root);\n"
11602 "\n"
11603 msgstr ""
11604
11605 # type: textblock
11606 #. type: textblock
11607 #: ../src/guestfs-actions.pod:2850 ../fish/guestfish-actions.pod:1957
11608 msgid ""
11609 "This returns the product name of the inspected operating system.  The "
11610 "product name is generally some freeform string which can be displayed to the "
11611 "user, but should not be parsed by programs."
11612 msgstr ""
11613
11614 # type: textblock
11615 #. type: textblock
11616 #: ../src/guestfs-actions.pod:2855 ../fish/guestfish-actions.pod:1962
11617 msgid ""
11618 "If the product name could not be determined, then the string C<unknown> is "
11619 "returned."
11620 msgstr ""
11621
11622 # type: =head2
11623 #. type: =head2
11624 #: ../src/guestfs-actions.pod:2865
11625 msgid "guestfs_inspect_get_roots"
11626 msgstr ""
11627
11628 # type: verbatim
11629 #. type: verbatim
11630 #: ../src/guestfs-actions.pod:2867
11631 #, no-wrap
11632 msgid ""
11633 " char **\n"
11634 " guestfs_inspect_get_roots (guestfs_h *g);\n"
11635 "\n"
11636 msgstr ""
11637
11638 # type: textblock
11639 #. type: textblock
11640 #: ../src/guestfs-actions.pod:2870
11641 msgid ""
11642 "This function is a convenient way to get the list of root devices, as "
11643 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
11644 "the whole inspection process."
11645 msgstr ""
11646
11647 # type: textblock
11648 #. type: textblock
11649 #: ../src/guestfs-actions.pod:2874
11650 msgid ""
11651 "This returns an empty list if either no root devices were found or the "
11652 "caller has not called C<guestfs_inspect_os>."
11653 msgstr ""
11654
11655 # type: textblock
11656 #. type: textblock
11657 #: ../src/guestfs-actions.pod:2883
11658 msgid "(Added in 1.7.3)"
11659 msgstr ""
11660
11661 # type: =head2
11662 #. type: =head2
11663 #: ../src/guestfs-actions.pod:2885
11664 msgid "guestfs_inspect_get_type"
11665 msgstr ""
11666
11667 # type: verbatim
11668 #. type: verbatim
11669 #: ../src/guestfs-actions.pod:2887
11670 #, no-wrap
11671 msgid ""
11672 " char *\n"
11673 " guestfs_inspect_get_type (guestfs_h *g,\n"
11674 "                           const char *root);\n"
11675 "\n"
11676 msgstr ""
11677
11678 # type: textblock
11679 #. type: textblock
11680 #: ../src/guestfs-actions.pod:2894 ../fish/guestfish-actions.pod:1987
11681 msgid ""
11682 "This returns the type of the inspected operating system.  Currently defined "
11683 "types are:"
11684 msgstr ""
11685
11686 # type: =item
11687 #. type: =item
11688 #: ../src/guestfs-actions.pod:2899 ../fish/guestfish-actions.pod:1992
11689 msgid "\"linux\""
11690 msgstr ""
11691
11692 # type: textblock
11693 #. type: textblock
11694 #: ../src/guestfs-actions.pod:2901 ../fish/guestfish-actions.pod:1994
11695 msgid "Any Linux-based operating system."
11696 msgstr ""
11697
11698 # type: textblock
11699 #. type: textblock
11700 #: ../src/guestfs-actions.pod:2905 ../fish/guestfish-actions.pod:1998
11701 msgid "Any Microsoft Windows operating system."
11702 msgstr ""
11703
11704 # type: =item
11705 #. type: =item
11706 #: ../src/guestfs-actions.pod:2907 ../fish/guestfish-actions.pod:2000
11707 msgid "\"freebsd\""
11708 msgstr ""
11709
11710 # type: textblock
11711 #. type: textblock
11712 #: ../src/guestfs-actions.pod:2909 ../fish/guestfish-actions.pod:2002
11713 msgid "FreeBSD."
11714 msgstr ""
11715
11716 # type: textblock
11717 #. type: textblock
11718 #: ../src/guestfs-actions.pod:2913 ../fish/guestfish-actions.pod:2006
11719 msgid "The operating system type could not be determined."
11720 msgstr ""
11721
11722 # type: =head2
11723 #. type: =head2
11724 #: ../src/guestfs-actions.pod:2927
11725 msgid "guestfs_inspect_get_windows_systemroot"
11726 msgstr ""
11727
11728 # type: verbatim
11729 #. type: verbatim
11730 #: ../src/guestfs-actions.pod:2929
11731 #, no-wrap
11732 msgid ""
11733 " char *\n"
11734 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
11735 "                                         const char *root);\n"
11736 "\n"
11737 msgstr ""
11738
11739 # type: textblock
11740 #. type: textblock
11741 #: ../src/guestfs-actions.pod:2936 ../fish/guestfish-actions.pod:2022
11742 msgid ""
11743 "This returns the Windows systemroot of the inspected guest.  The systemroot "
11744 "is a directory path such as C</WINDOWS>."
11745 msgstr ""
11746
11747 # type: textblock
11748 #. type: textblock
11749 #: ../src/guestfs-actions.pod:2939 ../fish/guestfish-actions.pod:2025
11750 msgid ""
11751 "This call assumes that the guest is Windows and that the systemroot could be "
11752 "determined by inspection.  If this is not the case then an error is returned."
11753 msgstr ""
11754
11755 # type: textblock
11756 #. type: textblock
11757 #: ../src/guestfs-actions.pod:2948
11758 msgid "(Added in 1.5.25)"
11759 msgstr ""
11760
11761 #. type: =head2
11762 #: ../src/guestfs-actions.pod:2950
11763 msgid "guestfs_inspect_is_live"
11764 msgstr ""
11765
11766 #. type: verbatim
11767 #: ../src/guestfs-actions.pod:2952
11768 #, no-wrap
11769 msgid ""
11770 " int\n"
11771 " guestfs_inspect_is_live (guestfs_h *g,\n"
11772 "                          const char *root);\n"
11773 "\n"
11774 msgstr ""
11775
11776 #. type: textblock
11777 #: ../src/guestfs-actions.pod:2959
11778 msgid ""
11779 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
11780 "disk), then this returns true if a live image was detected on the disk."
11781 msgstr ""
11782
11783 #. type: =head2
11784 #: ../src/guestfs-actions.pod:2967
11785 msgid "guestfs_inspect_is_multipart"
11786 msgstr ""
11787
11788 #. type: verbatim
11789 #: ../src/guestfs-actions.pod:2969
11790 #, no-wrap
11791 msgid ""
11792 " int\n"
11793 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
11794 "                               const char *root);\n"
11795 "\n"
11796 msgstr ""
11797
11798 #. type: textblock
11799 #: ../src/guestfs-actions.pod:2976
11800 msgid ""
11801 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
11802 "disk), then this returns true if the disk is part of a set."
11803 msgstr ""
11804
11805 #. type: =head2
11806 #: ../src/guestfs-actions.pod:2984
11807 msgid "guestfs_inspect_is_netinst"
11808 msgstr ""
11809
11810 #. type: verbatim
11811 #: ../src/guestfs-actions.pod:2986
11812 #, no-wrap
11813 msgid ""
11814 " int\n"
11815 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
11816 "                             const char *root);\n"
11817 "\n"
11818 msgstr ""
11819
11820 #. type: textblock
11821 #: ../src/guestfs-actions.pod:2993
11822 msgid ""
11823 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
11824 "disk), then this returns true if the disk is a network installer, ie. not a "
11825 "self-contained install CD but one which is likely to require network access "
11826 "to complete the install."
11827 msgstr ""
11828
11829 # type: =head2
11830 #. type: =head2
11831 #: ../src/guestfs-actions.pod:3003
11832 msgid "guestfs_inspect_list_applications"
11833 msgstr ""
11834
11835 # type: verbatim
11836 #. type: verbatim
11837 #: ../src/guestfs-actions.pod:3005
11838 #, no-wrap
11839 msgid ""
11840 " struct guestfs_application_list *\n"
11841 " guestfs_inspect_list_applications (guestfs_h *g,\n"
11842 "                                    const char *root);\n"
11843 "\n"
11844 msgstr ""
11845
11846 # type: textblock
11847 #. type: textblock
11848 #: ../src/guestfs-actions.pod:3012 ../fish/guestfish-actions.pod:2079
11849 msgid "Return the list of applications installed in the operating system."
11850 msgstr ""
11851
11852 # type: textblock
11853 #. type: textblock
11854 #: ../src/guestfs-actions.pod:3014
11855 msgid ""
11856 "I<Note:> This call works differently from other parts of the inspection "
11857 "API.  You have to call C<guestfs_inspect_os>, then "
11858 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
11859 "this.  Listing applications is a significantly more difficult operation "
11860 "which requires access to the full filesystem.  Also note that unlike the "
11861 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
11862 "the libguestfs handle, this call actually reads parts of the mounted "
11863 "filesystems during the call."
11864 msgstr ""
11865
11866 # type: textblock
11867 #. type: textblock
11868 #: ../src/guestfs-actions.pod:3024 ../fish/guestfish-actions.pod:2091
11869 msgid ""
11870 "This returns an empty list if the inspection code was not able to determine "
11871 "the list of applications."
11872 msgstr ""
11873
11874 # type: textblock
11875 #. type: textblock
11876 #: ../src/guestfs-actions.pod:3027 ../fish/guestfish-actions.pod:2094
11877 msgid "The application structure contains the following fields:"
11878 msgstr ""
11879
11880 # type: =item
11881 #. type: =item
11882 #: ../src/guestfs-actions.pod:3031 ../fish/guestfish-actions.pod:2098
11883 msgid "C<app_name>"
11884 msgstr ""
11885
11886 # type: textblock
11887 #. type: textblock
11888 #: ../src/guestfs-actions.pod:3033 ../fish/guestfish-actions.pod:2100
11889 msgid ""
11890 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
11891 "guests, this is the package name."
11892 msgstr ""
11893
11894 # type: =item
11895 #. type: =item
11896 #: ../src/guestfs-actions.pod:3036 ../fish/guestfish-actions.pod:2103
11897 msgid "C<app_display_name>"
11898 msgstr ""
11899
11900 # type: textblock
11901 #. type: textblock
11902 #: ../src/guestfs-actions.pod:3038 ../fish/guestfish-actions.pod:2105
11903 msgid ""
11904 "The display name of the application, sometimes localized to the install "
11905 "language of the guest operating system."
11906 msgstr ""
11907
11908 # type: textblock
11909 #. type: textblock
11910 #: ../src/guestfs-actions.pod:3041 ../fish/guestfish-actions.pod:2108
11911 msgid ""
11912 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
11913 "to display something can use C<app_name> instead."
11914 msgstr ""
11915
11916 # type: =item
11917 #. type: =item
11918 #: ../src/guestfs-actions.pod:3044 ../fish/guestfish-actions.pod:2111
11919 msgid "C<app_epoch>"
11920 msgstr ""
11921
11922 # type: textblock
11923 #. type: textblock
11924 #: ../src/guestfs-actions.pod:3046 ../fish/guestfish-actions.pod:2113
11925 msgid ""
11926 "For package managers which use epochs, this contains the epoch of the "
11927 "package (an integer).  If unavailable, this is returned as C<0>."
11928 msgstr ""
11929
11930 # type: =item
11931 #. type: =item
11932 #: ../src/guestfs-actions.pod:3049 ../fish/guestfish-actions.pod:2116
11933 msgid "C<app_version>"
11934 msgstr ""
11935
11936 # type: textblock
11937 #. type: textblock
11938 #: ../src/guestfs-actions.pod:3051 ../fish/guestfish-actions.pod:2118
11939 msgid ""
11940 "The version string of the application or package.  If unavailable this is "
11941 "returned as an empty string C<\"\">."
11942 msgstr ""
11943
11944 # type: =item
11945 #. type: =item
11946 #: ../src/guestfs-actions.pod:3054 ../fish/guestfish-actions.pod:2121
11947 msgid "C<app_release>"
11948 msgstr ""
11949
11950 # type: textblock
11951 #. type: textblock
11952 #: ../src/guestfs-actions.pod:3056 ../fish/guestfish-actions.pod:2123
11953 msgid ""
11954 "The release string of the application or package, for package managers that "
11955 "use this.  If unavailable this is returned as an empty string C<\"\">."
11956 msgstr ""
11957
11958 # type: =item
11959 #. type: =item
11960 #: ../src/guestfs-actions.pod:3060 ../fish/guestfish-actions.pod:2127
11961 msgid "C<app_install_path>"
11962 msgstr ""
11963
11964 # type: textblock
11965 #. type: textblock
11966 #: ../src/guestfs-actions.pod:3062 ../fish/guestfish-actions.pod:2129
11967 msgid ""
11968 "The installation path of the application (on operating systems such as "
11969 "Windows which use installation paths).  This path is in the format used by "
11970 "the guest operating system, it is not a libguestfs path."
11971 msgstr ""
11972
11973 # type: textblock
11974 #. type: textblock
11975 #: ../src/guestfs-actions.pod:3067 ../fish/guestfish-actions.pod:2134
11976 msgid "If unavailable this is returned as an empty string C<\"\">."
11977 msgstr ""
11978
11979 # type: =item
11980 #. type: =item
11981 #: ../src/guestfs-actions.pod:3069 ../fish/guestfish-actions.pod:2136
11982 msgid "C<app_trans_path>"
11983 msgstr ""
11984
11985 # type: textblock
11986 #. type: textblock
11987 #: ../src/guestfs-actions.pod:3071 ../fish/guestfish-actions.pod:2138
11988 msgid ""
11989 "The install path translated into a libguestfs path.  If unavailable this is "
11990 "returned as an empty string C<\"\">."
11991 msgstr ""
11992
11993 # type: =item
11994 #. type: =item
11995 #: ../src/guestfs-actions.pod:3074 ../fish/guestfish-actions.pod:2141
11996 msgid "C<app_publisher>"
11997 msgstr ""
11998
11999 # type: textblock
12000 #. type: textblock
12001 #: ../src/guestfs-actions.pod:3076 ../fish/guestfish-actions.pod:2143
12002 msgid ""
12003 "The name of the publisher of the application, for package managers that use "
12004 "this.  If unavailable this is returned as an empty string C<\"\">."
12005 msgstr ""
12006
12007 # type: =item
12008 #. type: =item
12009 #: ../src/guestfs-actions.pod:3080 ../fish/guestfish-actions.pod:2147
12010 msgid "C<app_url>"
12011 msgstr ""
12012
12013 # type: textblock
12014 #. type: textblock
12015 #: ../src/guestfs-actions.pod:3082 ../fish/guestfish-actions.pod:2149
12016 msgid ""
12017 "The URL (eg. upstream URL) of the application.  If unavailable this is "
12018 "returned as an empty string C<\"\">."
12019 msgstr ""
12020
12021 # type: =item
12022 #. type: =item
12023 #: ../src/guestfs-actions.pod:3085 ../fish/guestfish-actions.pod:2152
12024 msgid "C<app_source_package>"
12025 msgstr ""
12026
12027 # type: textblock
12028 #. type: textblock
12029 #: ../src/guestfs-actions.pod:3087 ../fish/guestfish-actions.pod:2154
12030 msgid ""
12031 "For packaging systems which support this, the name of the source package.  "
12032 "If unavailable this is returned as an empty string C<\"\">."
12033 msgstr ""
12034
12035 # type: =item
12036 #. type: =item
12037 #: ../src/guestfs-actions.pod:3090 ../fish/guestfish-actions.pod:2157
12038 msgid "C<app_summary>"
12039 msgstr ""
12040
12041 # type: textblock
12042 #. type: textblock
12043 #: ../src/guestfs-actions.pod:3092 ../fish/guestfish-actions.pod:2159
12044 msgid ""
12045 "A short (usually one line) description of the application or package.  If "
12046 "unavailable this is returned as an empty string C<\"\">."
12047 msgstr ""
12048
12049 # type: =item
12050 #. type: =item
12051 #: ../src/guestfs-actions.pod:3095 ../fish/guestfish-actions.pod:2162
12052 msgid "C<app_description>"
12053 msgstr ""
12054
12055 # type: textblock
12056 #. type: textblock
12057 #: ../src/guestfs-actions.pod:3097 ../fish/guestfish-actions.pod:2164
12058 msgid ""
12059 "A longer description of the application or package.  If unavailable this is "
12060 "returned as an empty string C<\"\">."
12061 msgstr ""
12062
12063 # type: textblock
12064 #. type: textblock
12065 #: ../src/guestfs-actions.pod:3104
12066 msgid ""
12067 "This function returns a C<struct guestfs_application_list *>, or NULL if "
12068 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
12069 "after use>."
12070 msgstr ""
12071
12072 # type: textblock
12073 #. type: textblock
12074 #: ../src/guestfs-actions.pod:3108
12075 msgid "(Added in 1.7.8)"
12076 msgstr ""
12077
12078 # type: =head2
12079 #. type: =head2
12080 #: ../src/guestfs-actions.pod:3110
12081 msgid "guestfs_inspect_os"
12082 msgstr ""
12083
12084 # type: verbatim
12085 #. type: verbatim
12086 #: ../src/guestfs-actions.pod:3112
12087 #, no-wrap
12088 msgid ""
12089 " char **\n"
12090 " guestfs_inspect_os (guestfs_h *g);\n"
12091 "\n"
12092 msgstr ""
12093
12094 # type: textblock
12095 #. type: textblock
12096 #: ../src/guestfs-actions.pod:3115 ../fish/guestfish-actions.pod:2175
12097 msgid ""
12098 "This function uses other libguestfs functions and certain heuristics to "
12099 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
12100 "for operating systems."
12101 msgstr ""
12102
12103 # type: textblock
12104 #. type: textblock
12105 #: ../src/guestfs-actions.pod:3119 ../fish/guestfish-actions.pod:2179
12106 msgid "The list returned is empty if no operating systems were found."
12107 msgstr ""
12108
12109 # type: textblock
12110 #. type: textblock
12111 #: ../src/guestfs-actions.pod:3121 ../fish/guestfish-actions.pod:2181
12112 msgid ""
12113 "If one operating system was found, then this returns a list with a single "
12114 "element, which is the name of the root filesystem of this operating system.  "
12115 "It is also possible for this function to return a list containing more than "
12116 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
12117 "element being the root filesystem of one of the operating systems."
12118 msgstr ""
12119
12120 # type: textblock
12121 #. type: textblock
12122 #: ../src/guestfs-actions.pod:3128
12123 msgid ""
12124 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
12125 "functions in order to query further information about each operating system, "
12126 "such as the name and version."
12127 msgstr ""
12128
12129 # type: textblock
12130 #. type: textblock
12131 #: ../src/guestfs-actions.pod:3133
12132 msgid ""
12133 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
12134 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
12135 "the contents.  This should be called with no disks currently mounted.  The "
12136 "function may also use Augeas, so any existing Augeas handle will be closed."
12137 msgstr ""
12138
12139 # type: textblock
12140 #. type: textblock
12141 #: ../src/guestfs-actions.pod:3139 ../fish/guestfish-actions.pod:2199
12142 msgid ""
12143 "This function cannot decrypt encrypted disks.  The caller must do that first "
12144 "(supplying the necessary keys) if the disk is encrypted."
12145 msgstr ""
12146
12147 # type: textblock
12148 #. type: textblock
12149 #: ../src/guestfs-actions.pod:3145 ../src/guestfs-actions.pod:3430
12150 #: ../src/guestfs-actions.pod:3492
12151 msgid "See also C<guestfs_list_filesystems>."
12152 msgstr ""
12153
12154 # type: =head2
12155 #. type: =head2
12156 #: ../src/guestfs-actions.pod:3153
12157 msgid "guestfs_is_blockdev"
12158 msgstr ""
12159
12160 # type: verbatim
12161 #. type: verbatim
12162 #: ../src/guestfs-actions.pod:3155
12163 #, no-wrap
12164 msgid ""
12165 " int\n"
12166 " guestfs_is_blockdev (guestfs_h *g,\n"
12167 "                      const char *path);\n"
12168 "\n"
12169 msgstr ""
12170
12171 # type: textblock
12172 #. type: textblock
12173 #: ../src/guestfs-actions.pod:3159 ../fish/guestfish-actions.pod:2211
12174 msgid ""
12175 "This returns C<true> if and only if there is a block device with the given "
12176 "C<path> name."
12177 msgstr ""
12178
12179 # type: textblock
12180 #. type: textblock
12181 #: ../src/guestfs-actions.pod:3162 ../src/guestfs-actions.pod:3191
12182 #: ../src/guestfs-actions.pod:3221 ../src/guestfs-actions.pod:3236
12183 #: ../src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3308
12184 #: ../src/guestfs-actions.pod:3323
12185 msgid "See also C<guestfs_stat>."
12186 msgstr ""
12187
12188 # type: textblock
12189 #. type: textblock
12190 #: ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3195
12191 #: ../src/guestfs-actions.pod:3240 ../src/guestfs-actions.pod:3312
12192 #: ../src/guestfs-actions.pod:3327
12193 msgid "(Added in 1.5.10)"
12194 msgstr ""
12195
12196 # type: =head2
12197 #. type: =head2
12198 #: ../src/guestfs-actions.pod:3168
12199 msgid "guestfs_is_busy"
12200 msgstr ""
12201
12202 # type: verbatim
12203 #. type: verbatim
12204 #: ../src/guestfs-actions.pod:3170
12205 #, no-wrap
12206 msgid ""
12207 " int\n"
12208 " guestfs_is_busy (guestfs_h *g);\n"
12209 "\n"
12210 msgstr ""
12211
12212 # type: textblock
12213 #. type: textblock
12214 #: ../src/guestfs-actions.pod:3173 ../fish/guestfish-actions.pod:2220
12215 msgid ""
12216 "This returns true iff this handle is busy processing a command (in the "
12217 "C<BUSY> state)."
12218 msgstr ""
12219
12220 # type: =head2
12221 #. type: =head2
12222 #: ../src/guestfs-actions.pod:3182
12223 msgid "guestfs_is_chardev"
12224 msgstr ""
12225
12226 # type: verbatim
12227 #. type: verbatim
12228 #: ../src/guestfs-actions.pod:3184
12229 #, no-wrap
12230 msgid ""
12231 " int\n"
12232 " guestfs_is_chardev (guestfs_h *g,\n"
12233 "                     const char *path);\n"
12234 "\n"
12235 msgstr ""
12236
12237 # type: textblock
12238 #. type: textblock
12239 #: ../src/guestfs-actions.pod:3188 ../fish/guestfish-actions.pod:2229
12240 msgid ""
12241 "This returns C<true> if and only if there is a character device with the "
12242 "given C<path> name."
12243 msgstr ""
12244
12245 # type: =head2
12246 #. type: =head2
12247 #: ../src/guestfs-actions.pod:3197
12248 msgid "guestfs_is_config"
12249 msgstr ""
12250
12251 # type: verbatim
12252 #. type: verbatim
12253 #: ../src/guestfs-actions.pod:3199
12254 #, no-wrap
12255 msgid ""
12256 " int\n"
12257 " guestfs_is_config (guestfs_h *g);\n"
12258 "\n"
12259 msgstr ""
12260
12261 # type: textblock
12262 #. type: textblock
12263 #: ../src/guestfs-actions.pod:3202 ../fish/guestfish-actions.pod:2238
12264 msgid ""
12265 "This returns true iff this handle is being configured (in the C<CONFIG> "
12266 "state)."
12267 msgstr ""
12268
12269 # type: =head2
12270 #. type: =head2
12271 #: ../src/guestfs-actions.pod:3211
12272 msgid "guestfs_is_dir"
12273 msgstr ""
12274
12275 # type: verbatim
12276 #. type: verbatim
12277 #: ../src/guestfs-actions.pod:3213
12278 #, no-wrap
12279 msgid ""
12280 " int\n"
12281 " guestfs_is_dir (guestfs_h *g,\n"
12282 "                 const char *path);\n"
12283 "\n"
12284 msgstr ""
12285
12286 # type: textblock
12287 #. type: textblock
12288 #: ../src/guestfs-actions.pod:3217 ../fish/guestfish-actions.pod:2247
12289 msgid ""
12290 "This returns C<true> if and only if there is a directory with the given "
12291 "C<path> name.  Note that it returns false for other objects like files."
12292 msgstr ""
12293
12294 # type: =head2
12295 #. type: =head2
12296 #: ../src/guestfs-actions.pod:3227
12297 msgid "guestfs_is_fifo"
12298 msgstr ""
12299
12300 # type: verbatim
12301 #. type: verbatim
12302 #: ../src/guestfs-actions.pod:3229
12303 #, no-wrap
12304 msgid ""
12305 " int\n"
12306 " guestfs_is_fifo (guestfs_h *g,\n"
12307 "                  const char *path);\n"
12308 "\n"
12309 msgstr ""
12310
12311 # type: textblock
12312 #. type: textblock
12313 #: ../src/guestfs-actions.pod:3233 ../fish/guestfish-actions.pod:2257
12314 msgid ""
12315 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
12316 "given C<path> name."
12317 msgstr ""
12318
12319 # type: =head2
12320 #. type: =head2
12321 #: ../src/guestfs-actions.pod:3242
12322 msgid "guestfs_is_file"
12323 msgstr ""
12324
12325 # type: verbatim
12326 #. type: verbatim
12327 #: ../src/guestfs-actions.pod:3244
12328 #, no-wrap
12329 msgid ""
12330 " int\n"
12331 " guestfs_is_file (guestfs_h *g,\n"
12332 "                  const char *path);\n"
12333 "\n"
12334 msgstr ""
12335
12336 # type: textblock
12337 #. type: textblock
12338 #: ../src/guestfs-actions.pod:3248 ../fish/guestfish-actions.pod:2266
12339 msgid ""
12340 "This returns C<true> if and only if there is a regular file with the given "
12341 "C<path> name.  Note that it returns false for other objects like directories."
12342 msgstr ""
12343
12344 # type: =head2
12345 #. type: =head2
12346 #: ../src/guestfs-actions.pod:3258
12347 msgid "guestfs_is_launching"
12348 msgstr ""
12349
12350 # type: verbatim
12351 #. type: verbatim
12352 #: ../src/guestfs-actions.pod:3260
12353 #, no-wrap
12354 msgid ""
12355 " int\n"
12356 " guestfs_is_launching (guestfs_h *g);\n"
12357 "\n"
12358 msgstr ""
12359
12360 # type: textblock
12361 #. type: textblock
12362 #: ../src/guestfs-actions.pod:3263 ../fish/guestfish-actions.pod:2276
12363 msgid ""
12364 "This returns true iff this handle is launching the subprocess (in the "
12365 "C<LAUNCHING> state)."
12366 msgstr ""
12367
12368 # type: =head2
12369 #. type: =head2
12370 #: ../src/guestfs-actions.pod:3272
12371 msgid "guestfs_is_lv"
12372 msgstr ""
12373
12374 # type: verbatim
12375 #. type: verbatim
12376 #: ../src/guestfs-actions.pod:3274
12377 #, no-wrap
12378 msgid ""
12379 " int\n"
12380 " guestfs_is_lv (guestfs_h *g,\n"
12381 "                const char *device);\n"
12382 "\n"
12383 msgstr ""
12384
12385 # type: textblock
12386 #. type: textblock
12387 #: ../src/guestfs-actions.pod:3278 ../fish/guestfish-actions.pod:2285
12388 msgid ""
12389 "This command tests whether C<device> is a logical volume, and returns true "
12390 "iff this is the case."
12391 msgstr ""
12392
12393 # type: =head2
12394 #. type: =head2
12395 #: ../src/guestfs-actions.pod:3285
12396 msgid "guestfs_is_ready"
12397 msgstr ""
12398
12399 # type: verbatim
12400 #. type: verbatim
12401 #: ../src/guestfs-actions.pod:3287
12402 #, no-wrap
12403 msgid ""
12404 " int\n"
12405 " guestfs_is_ready (guestfs_h *g);\n"
12406 "\n"
12407 msgstr ""
12408
12409 # type: textblock
12410 #. type: textblock
12411 #: ../src/guestfs-actions.pod:3290 ../fish/guestfish-actions.pod:2292
12412 msgid ""
12413 "This returns true iff this handle is ready to accept commands (in the "
12414 "C<READY> state)."
12415 msgstr ""
12416
12417 # type: =head2
12418 #. type: =head2
12419 #: ../src/guestfs-actions.pod:3299
12420 msgid "guestfs_is_socket"
12421 msgstr ""
12422
12423 # type: verbatim
12424 #. type: verbatim
12425 #: ../src/guestfs-actions.pod:3301
12426 #, no-wrap
12427 msgid ""
12428 " int\n"
12429 " guestfs_is_socket (guestfs_h *g,\n"
12430 "                    const char *path);\n"
12431 "\n"
12432 msgstr ""
12433
12434 # type: textblock
12435 #. type: textblock
12436 #: ../src/guestfs-actions.pod:3305 ../fish/guestfish-actions.pod:2301
12437 msgid ""
12438 "This returns C<true> if and only if there is a Unix domain socket with the "
12439 "given C<path> name."
12440 msgstr ""
12441
12442 # type: =head2
12443 #. type: =head2
12444 #: ../src/guestfs-actions.pod:3314
12445 msgid "guestfs_is_symlink"
12446 msgstr ""
12447
12448 # type: verbatim
12449 #. type: verbatim
12450 #: ../src/guestfs-actions.pod:3316
12451 #, no-wrap
12452 msgid ""
12453 " int\n"
12454 " guestfs_is_symlink (guestfs_h *g,\n"
12455 "                     const char *path);\n"
12456 "\n"
12457 msgstr ""
12458
12459 # type: textblock
12460 #. type: textblock
12461 #: ../src/guestfs-actions.pod:3320 ../fish/guestfish-actions.pod:2310
12462 msgid ""
12463 "This returns C<true> if and only if there is a symbolic link with the given "
12464 "C<path> name."
12465 msgstr ""
12466
12467 # type: =head2
12468 #. type: =head2
12469 #: ../src/guestfs-actions.pod:3329
12470 msgid "guestfs_kill_subprocess"
12471 msgstr ""
12472
12473 # type: verbatim
12474 #. type: verbatim
12475 #: ../src/guestfs-actions.pod:3331
12476 #, no-wrap
12477 msgid ""
12478 " int\n"
12479 " guestfs_kill_subprocess (guestfs_h *g);\n"
12480 "\n"
12481 msgstr ""
12482
12483 # type: textblock
12484 #. type: textblock
12485 #: ../src/guestfs-actions.pod:3334 ../fish/guestfish-actions.pod:2319
12486 msgid "This kills the qemu subprocess.  You should never need to call this."
12487 msgstr ""
12488
12489 # type: =head2
12490 #. type: =head2
12491 #: ../src/guestfs-actions.pod:3340
12492 msgid "guestfs_launch"
12493 msgstr ""
12494
12495 # type: verbatim
12496 #. type: verbatim
12497 #: ../src/guestfs-actions.pod:3342
12498 #, no-wrap
12499 msgid ""
12500 " int\n"
12501 " guestfs_launch (guestfs_h *g);\n"
12502 "\n"
12503 msgstr ""
12504
12505 # type: textblock
12506 #. type: textblock
12507 #: ../src/guestfs-actions.pod:3345 ../fish/guestfish-actions.pod:2327
12508 msgid ""
12509 "Internally libguestfs is implemented by running a virtual machine using "
12510 "L<qemu(1)>."
12511 msgstr ""
12512
12513 # type: textblock
12514 #. type: textblock
12515 #: ../src/guestfs-actions.pod:3348 ../fish/guestfish-actions.pod:2330
12516 msgid ""
12517 "You should call this after configuring the handle (eg. adding drives) but "
12518 "before performing any actions."
12519 msgstr ""
12520
12521 # type: =head2
12522 #. type: =head2
12523 #: ../src/guestfs-actions.pod:3355
12524 msgid "guestfs_lchown"
12525 msgstr ""
12526
12527 # type: verbatim
12528 #. type: verbatim
12529 #: ../src/guestfs-actions.pod:3357
12530 #, no-wrap
12531 msgid ""
12532 " int\n"
12533 " guestfs_lchown (guestfs_h *g,\n"
12534 "                 int owner,\n"
12535 "                 int group,\n"
12536 "                 const char *path);\n"
12537 "\n"
12538 msgstr ""
12539
12540 # type: textblock
12541 #. type: textblock
12542 #: ../src/guestfs-actions.pod:3363
12543 msgid ""
12544 "Change the file owner to C<owner> and group to C<group>.  This is like "
12545 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
12546 "changed, not the target."
12547 msgstr ""
12548
12549 # type: =head2
12550 #. type: =head2
12551 #: ../src/guestfs-actions.pod:3375
12552 msgid "guestfs_lgetxattr"
12553 msgstr ""
12554
12555 # type: verbatim
12556 #. type: verbatim
12557 #: ../src/guestfs-actions.pod:3377
12558 #, no-wrap
12559 msgid ""
12560 " char *\n"
12561 " guestfs_lgetxattr (guestfs_h *g,\n"
12562 "                    const char *path,\n"
12563 "                    const char *name,\n"
12564 "                    size_t *size_r);\n"
12565 "\n"
12566 msgstr ""
12567
12568 # type: textblock
12569 #. type: textblock
12570 #: ../src/guestfs-actions.pod:3383 ../fish/guestfish-actions.pod:2349
12571 msgid ""
12572 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
12573 "is a symlink, then this call returns an extended attribute from the symlink."
12574 msgstr ""
12575
12576 # type: textblock
12577 #. type: textblock
12578 #: ../src/guestfs-actions.pod:3397
12579 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
12580 msgstr ""
12581
12582 # type: =head2
12583 #. type: =head2
12584 #: ../src/guestfs-actions.pod:3405
12585 msgid "guestfs_lgetxattrs"
12586 msgstr ""
12587
12588 # type: verbatim
12589 #. type: verbatim
12590 #: ../src/guestfs-actions.pod:3407
12591 #, no-wrap
12592 msgid ""
12593 " struct guestfs_xattr_list *\n"
12594 " guestfs_lgetxattrs (guestfs_h *g,\n"
12595 "                     const char *path);\n"
12596 "\n"
12597 msgstr ""
12598
12599 # type: textblock
12600 #. type: textblock
12601 #: ../src/guestfs-actions.pod:3411
12602 msgid ""
12603 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
12604 "then it returns the extended attributes of the link itself."
12605 msgstr ""
12606
12607 # type: =head2
12608 #. type: =head2
12609 #: ../src/guestfs-actions.pod:3421
12610 msgid "guestfs_list_devices"
12611 msgstr ""
12612
12613 # type: verbatim
12614 #. type: verbatim
12615 #: ../src/guestfs-actions.pod:3423
12616 #, no-wrap
12617 msgid ""
12618 " char **\n"
12619 " guestfs_list_devices (guestfs_h *g);\n"
12620 "\n"
12621 msgstr ""
12622
12623 # type: textblock
12624 #. type: textblock
12625 #: ../src/guestfs-actions.pod:3426 ../fish/guestfish-actions.pod:2377
12626 msgid "List all the block devices."
12627 msgstr ""
12628
12629 # type: textblock
12630 #. type: textblock
12631 #: ../src/guestfs-actions.pod:3428 ../fish/guestfish-actions.pod:2379
12632 msgid "The full block device names are returned, eg. C</dev/sda>."
12633 msgstr ""
12634
12635 # type: =head2
12636 #. type: =head2
12637 #: ../src/guestfs-actions.pod:3438
12638 msgid "guestfs_list_filesystems"
12639 msgstr ""
12640
12641 # type: verbatim
12642 #. type: verbatim
12643 #: ../src/guestfs-actions.pod:3440
12644 #, no-wrap
12645 msgid ""
12646 " char **\n"
12647 " guestfs_list_filesystems (guestfs_h *g);\n"
12648 "\n"
12649 msgstr ""
12650
12651 # type: textblock
12652 #. type: textblock
12653 #: ../src/guestfs-actions.pod:3443 ../fish/guestfish-actions.pod:2387
12654 msgid ""
12655 "This inspection command looks for filesystems on partitions, block devices "
12656 "and logical volumes, returning a list of devices containing filesystems and "
12657 "their type."
12658 msgstr ""
12659
12660 # type: textblock
12661 #. type: textblock
12662 #: ../src/guestfs-actions.pod:3447 ../fish/guestfish-actions.pod:2391
12663 msgid ""
12664 "The return value is a hash, where the keys are the devices containing "
12665 "filesystems, and the values are the filesystem types.  For example:"
12666 msgstr ""
12667
12668 # type: verbatim
12669 #. type: verbatim
12670 #: ../src/guestfs-actions.pod:3451 ../fish/guestfish-actions.pod:2395
12671 #, no-wrap
12672 msgid ""
12673 " \"/dev/sda1\" => \"ntfs\"\n"
12674 " \"/dev/sda2\" => \"ext2\"\n"
12675 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
12676 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
12677 "\n"
12678 msgstr ""
12679
12680 # type: textblock
12681 #. type: textblock
12682 #: ../src/guestfs-actions.pod:3456 ../fish/guestfish-actions.pod:2400
12683 msgid ""
12684 "The value can have the special value \"unknown\", meaning the content of the "
12685 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
12686 msgstr ""
12687
12688 # type: textblock
12689 #. type: textblock
12690 #: ../src/guestfs-actions.pod:3460
12691 msgid ""
12692 "This command runs other libguestfs commands, which might include "
12693 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
12694 "soon after launch and only when nothing is mounted."
12695 msgstr ""
12696
12697 # type: textblock
12698 #. type: textblock
12699 #: ../src/guestfs-actions.pod:3464
12700 msgid ""
12701 "Not all of the filesystems returned will be mountable.  In particular, swap "
12702 "partitions are returned in the list.  Also this command does not check that "
12703 "each filesystem found is valid and mountable, and some filesystems might be "
12704 "mountable but require special options.  Filesystems may not all belong to a "
12705 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
12706 msgstr ""
12707
12708 # type: textblock
12709 #. type: textblock
12710 #: ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:5083
12711 msgid "(Added in 1.5.15)"
12712 msgstr ""
12713
12714 # type: =head2
12715 #. type: =head2
12716 #: ../src/guestfs-actions.pod:3480
12717 msgid "guestfs_list_partitions"
12718 msgstr ""
12719
12720 # type: verbatim
12721 #. type: verbatim
12722 #: ../src/guestfs-actions.pod:3482
12723 #, no-wrap
12724 msgid ""
12725 " char **\n"
12726 " guestfs_list_partitions (guestfs_h *g);\n"
12727 "\n"
12728 msgstr ""
12729
12730 # type: textblock
12731 #. type: textblock
12732 #: ../src/guestfs-actions.pod:3485 ../fish/guestfish-actions.pod:2420
12733 msgid "List all the partitions detected on all block devices."
12734 msgstr ""
12735
12736 # type: textblock
12737 #. type: textblock
12738 #: ../src/guestfs-actions.pod:3487 ../fish/guestfish-actions.pod:2422
12739 msgid "The full partition device names are returned, eg. C</dev/sda1>"
12740 msgstr ""
12741
12742 # type: textblock
12743 #. type: textblock
12744 #: ../src/guestfs-actions.pod:3489
12745 msgid ""
12746 "This does not return logical volumes.  For that you will need to call "
12747 "C<guestfs_lvs>."
12748 msgstr ""
12749
12750 # type: =head2
12751 #. type: =head2
12752 #: ../src/guestfs-actions.pod:3500
12753 msgid "guestfs_ll"
12754 msgstr ""
12755
12756 # type: verbatim
12757 #. type: verbatim
12758 #: ../src/guestfs-actions.pod:3502
12759 #, no-wrap
12760 msgid ""
12761 " char *\n"
12762 " guestfs_ll (guestfs_h *g,\n"
12763 "             const char *directory);\n"
12764 "\n"
12765 msgstr ""
12766
12767 # type: textblock
12768 #. type: textblock
12769 #: ../src/guestfs-actions.pod:3506 ../fish/guestfish-actions.pod:2433
12770 msgid ""
12771 "List the files in C<directory> (relative to the root directory, there is no "
12772 "cwd) in the format of 'ls -la'."
12773 msgstr ""
12774
12775 # type: textblock
12776 #. type: textblock
12777 #: ../src/guestfs-actions.pod:3509 ../fish/guestfish-actions.pod:2436
12778 msgid ""
12779 "This command is mostly useful for interactive sessions.  It is I<not> "
12780 "intended that you try to parse the output string."
12781 msgstr ""
12782
12783 # type: =head2
12784 #. type: =head2
12785 #: ../src/guestfs-actions.pod:3517
12786 msgid "guestfs_ln"
12787 msgstr ""
12788
12789 # type: verbatim
12790 #. type: verbatim
12791 #: ../src/guestfs-actions.pod:3519
12792 #, no-wrap
12793 msgid ""
12794 " int\n"
12795 " guestfs_ln (guestfs_h *g,\n"
12796 "             const char *target,\n"
12797 "             const char *linkname);\n"
12798 "\n"
12799 msgstr ""
12800
12801 # type: textblock
12802 #. type: textblock
12803 #: ../src/guestfs-actions.pod:3524 ../fish/guestfish-actions.pod:2443
12804 msgid "This command creates a hard link using the C<ln> command."
12805 msgstr ""
12806
12807 # type: =head2
12808 #. type: =head2
12809 #: ../src/guestfs-actions.pod:3530
12810 msgid "guestfs_ln_f"
12811 msgstr ""
12812
12813 # type: verbatim
12814 #. type: verbatim
12815 #: ../src/guestfs-actions.pod:3532
12816 #, no-wrap
12817 msgid ""
12818 " int\n"
12819 " guestfs_ln_f (guestfs_h *g,\n"
12820 "               const char *target,\n"
12821 "               const char *linkname);\n"
12822 "\n"
12823 msgstr ""
12824
12825 # type: textblock
12826 #. type: textblock
12827 #: ../src/guestfs-actions.pod:3537 ../fish/guestfish-actions.pod:2449
12828 msgid ""
12829 "This command creates a hard link using the C<ln -f> command.  The C<-f> "
12830 "option removes the link (C<linkname>) if it exists already."
12831 msgstr ""
12832
12833 # type: =head2
12834 #. type: =head2
12835 #: ../src/guestfs-actions.pod:3544
12836 msgid "guestfs_ln_s"
12837 msgstr ""
12838
12839 # type: verbatim
12840 #. type: verbatim
12841 #: ../src/guestfs-actions.pod:3546
12842 #, no-wrap
12843 msgid ""
12844 " int\n"
12845 " guestfs_ln_s (guestfs_h *g,\n"
12846 "               const char *target,\n"
12847 "               const char *linkname);\n"
12848 "\n"
12849 msgstr ""
12850
12851 # type: textblock
12852 #. type: textblock
12853 #: ../src/guestfs-actions.pod:3551 ../fish/guestfish-actions.pod:2456
12854 msgid "This command creates a symbolic link using the C<ln -s> command."
12855 msgstr ""
12856
12857 # type: =head2
12858 #. type: =head2
12859 #: ../src/guestfs-actions.pod:3557
12860 msgid "guestfs_ln_sf"
12861 msgstr ""
12862
12863 # type: verbatim
12864 #. type: verbatim
12865 #: ../src/guestfs-actions.pod:3559
12866 #, no-wrap
12867 msgid ""
12868 " int\n"
12869 " guestfs_ln_sf (guestfs_h *g,\n"
12870 "                const char *target,\n"
12871 "                const char *linkname);\n"
12872 "\n"
12873 msgstr ""
12874
12875 # type: textblock
12876 #. type: textblock
12877 #: ../src/guestfs-actions.pod:3564 ../fish/guestfish-actions.pod:2462
12878 msgid ""
12879 "This command creates a symbolic link using the C<ln -sf> command, The C<-f> "
12880 "option removes the link (C<linkname>) if it exists already."
12881 msgstr ""
12882
12883 # type: =head2
12884 #. type: =head2
12885 #: ../src/guestfs-actions.pod:3571
12886 msgid "guestfs_lremovexattr"
12887 msgstr ""
12888
12889 # type: verbatim
12890 #. type: verbatim
12891 #: ../src/guestfs-actions.pod:3573
12892 #, no-wrap
12893 msgid ""
12894 " int\n"
12895 " guestfs_lremovexattr (guestfs_h *g,\n"
12896 "                       const char *xattr,\n"
12897 "                       const char *path);\n"
12898 "\n"
12899 msgstr ""
12900
12901 # type: textblock
12902 #. type: textblock
12903 #: ../src/guestfs-actions.pod:3578
12904 msgid ""
12905 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
12906 "link, then it removes an extended attribute of the link itself."
12907 msgstr ""
12908
12909 # type: =head2
12910 #. type: =head2
12911 #: ../src/guestfs-actions.pod:3586
12912 msgid "guestfs_ls"
12913 msgstr ""
12914
12915 # type: verbatim
12916 #. type: verbatim
12917 #: ../src/guestfs-actions.pod:3588
12918 #, no-wrap
12919 msgid ""
12920 " char **\n"
12921 " guestfs_ls (guestfs_h *g,\n"
12922 "             const char *directory);\n"
12923 "\n"
12924 msgstr ""
12925
12926 # type: textblock
12927 #. type: textblock
12928 #: ../src/guestfs-actions.pod:3592 ../fish/guestfish-actions.pod:2477
12929 msgid ""
12930 "List the files in C<directory> (relative to the root directory, there is no "
12931 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
12932 msgstr ""
12933
12934 # type: textblock
12935 #. type: textblock
12936 #: ../src/guestfs-actions.pod:3596
12937 msgid ""
12938 "This command is mostly useful for interactive sessions.  Programs should "
12939 "probably use C<guestfs_readdir> instead."
12940 msgstr ""
12941
12942 # type: =head2
12943 #. type: =head2
12944 #: ../src/guestfs-actions.pod:3605
12945 msgid "guestfs_lsetxattr"
12946 msgstr ""
12947
12948 # type: verbatim
12949 #. type: verbatim
12950 #: ../src/guestfs-actions.pod:3607
12951 #, no-wrap
12952 msgid ""
12953 " int\n"
12954 " guestfs_lsetxattr (guestfs_h *g,\n"
12955 "                    const char *xattr,\n"
12956 "                    const char *val,\n"
12957 "                    int vallen,\n"
12958 "                    const char *path);\n"
12959 "\n"
12960 msgstr ""
12961
12962 # type: textblock
12963 #. type: textblock
12964 #: ../src/guestfs-actions.pod:3614
12965 msgid ""
12966 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
12967 "then it sets an extended attribute of the link itself."
12968 msgstr ""
12969
12970 # type: =head2
12971 #. type: =head2
12972 #: ../src/guestfs-actions.pod:3622
12973 msgid "guestfs_lstat"
12974 msgstr ""
12975
12976 # type: verbatim
12977 #. type: verbatim
12978 #: ../src/guestfs-actions.pod:3624
12979 #, no-wrap
12980 msgid ""
12981 " struct guestfs_stat *\n"
12982 " guestfs_lstat (guestfs_h *g,\n"
12983 "                const char *path);\n"
12984 "\n"
12985 msgstr ""
12986
12987 # type: textblock
12988 #. type: textblock
12989 #: ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:6182
12990 #: ../fish/guestfish-actions.pod:2496 ../fish/guestfish-actions.pod:4161
12991 msgid "Returns file information for the given C<path>."
12992 msgstr ""
12993
12994 # type: textblock
12995 #. type: textblock
12996 #: ../src/guestfs-actions.pod:3630
12997 msgid ""
12998 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
12999 "link, then the link is stat-ed, not the file it refers to."
13000 msgstr ""
13001
13002 # type: textblock
13003 #. type: textblock
13004 #: ../src/guestfs-actions.pod:3634 ../fish/guestfish-actions.pod:2502
13005 msgid "This is the same as the C<lstat(2)> system call."
13006 msgstr ""
13007
13008 # type: textblock
13009 #. type: textblock
13010 #: ../src/guestfs-actions.pod:3636 ../src/guestfs-actions.pod:6186
13011 msgid ""
13012 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
13013 "error.  I<The caller must call C<guestfs_free_stat> after use>."
13014 msgstr ""
13015
13016 # type: textblock
13017 #. type: textblock
13018 #: ../src/guestfs-actions.pod:3640 ../src/guestfs-actions.pod:6190
13019 #: ../src/guestfs-actions.pod:6208 ../src/guestfs-actions.pod:6589
13020 msgid "(Added in 0.9.2)"
13021 msgstr ""
13022
13023 # type: =head2
13024 #. type: =head2
13025 #: ../src/guestfs-actions.pod:3642
13026 msgid "guestfs_lstatlist"
13027 msgstr ""
13028
13029 # type: verbatim
13030 #. type: verbatim
13031 #: ../src/guestfs-actions.pod:3644
13032 #, no-wrap
13033 msgid ""
13034 " struct guestfs_stat_list *\n"
13035 " guestfs_lstatlist (guestfs_h *g,\n"
13036 "                    const char *path,\n"
13037 "                    char *const *names);\n"
13038 "\n"
13039 msgstr ""
13040
13041 # type: textblock
13042 #. type: textblock
13043 #: ../src/guestfs-actions.pod:3649
13044 msgid ""
13045 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
13046 "files, where all files are in the directory C<path>.  C<names> is the list "
13047 "of files from this directory."
13048 msgstr ""
13049
13050 # type: textblock
13051 #. type: textblock
13052 #: ../src/guestfs-actions.pod:3653 ../fish/guestfish-actions.pod:2512
13053 msgid ""
13054 "On return you get a list of stat structs, with a one-to-one correspondence "
13055 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
13056 "then the C<ino> field of that structure is set to C<-1>."
13057 msgstr ""
13058
13059 # type: textblock
13060 #. type: textblock
13061 #: ../src/guestfs-actions.pod:3658
13062 msgid ""
13063 "This call is intended for programs that want to efficiently list a directory "
13064 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
13065 "for a similarly efficient call for getting extended attributes.  Very long "
13066 "directory listings might cause the protocol message size to be exceeded, "
13067 "causing this call to fail.  The caller must split up such requests into "
13068 "smaller groups of names."
13069 msgstr ""
13070
13071 # type: textblock
13072 #. type: textblock
13073 #: ../src/guestfs-actions.pod:3666
13074 msgid ""
13075 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
13076 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
13077 msgstr ""
13078
13079 # type: =head2
13080 #. type: =head2
13081 #: ../src/guestfs-actions.pod:3672
13082 msgid "guestfs_luks_add_key"
13083 msgstr ""
13084
13085 # type: verbatim
13086 #. type: verbatim
13087 #: ../src/guestfs-actions.pod:3674
13088 #, no-wrap
13089 msgid ""
13090 " int\n"
13091 " guestfs_luks_add_key (guestfs_h *g,\n"
13092 "                       const char *device,\n"
13093 "                       const char *key,\n"
13094 "                       const char *newkey,\n"
13095 "                       int keyslot);\n"
13096 "\n"
13097 msgstr ""
13098
13099 # type: textblock
13100 #. type: textblock
13101 #: ../src/guestfs-actions.pod:3681 ../fish/guestfish-actions.pod:2529
13102 msgid ""
13103 "This command adds a new key on LUKS device C<device>.  C<key> is any "
13104 "existing key, and is used to access the device.  C<newkey> is the new key to "
13105 "add.  C<keyslot> is the key slot that will be replaced."
13106 msgstr ""
13107
13108 # type: textblock
13109 #. type: textblock
13110 #: ../src/guestfs-actions.pod:3686
13111 msgid ""
13112 "Note that if C<keyslot> already contains a key, then this command will "
13113 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
13114 msgstr ""
13115
13116 # type: textblock
13117 #. type: textblock
13118 #: ../src/guestfs-actions.pod:3692 ../src/guestfs-actions.pod:3732
13119 #: ../src/guestfs-actions.pod:3755 ../src/guestfs-actions.pod:3775
13120 #: ../src/guestfs-actions.pod:3807 ../src/guestfs-actions.pod:3826
13121 msgid ""
13122 "This function takes a key or passphrase parameter which could contain "
13123 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
13124 "information."
13125 msgstr ""
13126
13127 # type: textblock
13128 #. type: textblock
13129 #: ../src/guestfs-actions.pod:3696 ../src/guestfs-actions.pod:3736
13130 #: ../src/guestfs-actions.pod:3759 ../src/guestfs-actions.pod:3779
13131 msgid "(Added in 1.5.2)"
13132 msgstr ""
13133
13134 # type: =head2
13135 #. type: =head2
13136 #: ../src/guestfs-actions.pod:3698
13137 msgid "guestfs_luks_close"
13138 msgstr ""
13139
13140 # type: verbatim
13141 #. type: verbatim
13142 #: ../src/guestfs-actions.pod:3700
13143 #, no-wrap
13144 msgid ""
13145 " int\n"
13146 " guestfs_luks_close (guestfs_h *g,\n"
13147 "                     const char *device);\n"
13148 "\n"
13149 msgstr ""
13150
13151 # type: textblock
13152 #. type: textblock
13153 #: ../src/guestfs-actions.pod:3704
13154 msgid ""
13155 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
13156 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
13157 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
13158 "underlying block device."
13159 msgstr ""
13160
13161 # type: textblock
13162 #. type: textblock
13163 #: ../src/guestfs-actions.pod:3712 ../src/guestfs-actions.pod:3811
13164 #: ../src/guestfs-actions.pod:3830 ../src/guestfs-actions.pod:3880
13165 #: ../src/guestfs-actions.pod:3928
13166 msgid "(Added in 1.5.1)"
13167 msgstr ""
13168
13169 # type: =head2
13170 #. type: =head2
13171 #: ../src/guestfs-actions.pod:3714
13172 msgid "guestfs_luks_format"
13173 msgstr ""
13174
13175 # type: verbatim
13176 #. type: verbatim
13177 #: ../src/guestfs-actions.pod:3716
13178 #, no-wrap
13179 msgid ""
13180 " int\n"
13181 " guestfs_luks_format (guestfs_h *g,\n"
13182 "                      const char *device,\n"
13183 "                      const char *key,\n"
13184 "                      int keyslot);\n"
13185 "\n"
13186 msgstr ""
13187
13188 # type: textblock
13189 #. type: textblock
13190 #: ../src/guestfs-actions.pod:3722 ../fish/guestfish-actions.pod:2555
13191 msgid ""
13192 "This command erases existing data on C<device> and formats the device as a "
13193 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
13194 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
13195 msgstr ""
13196
13197 # type: textblock
13198 #. type: textblock
13199 #: ../src/guestfs-actions.pod:3729 ../src/guestfs-actions.pod:3752
13200 #: ../src/guestfs-actions.pod:3892 ../src/guestfs-actions.pod:4834
13201 #: ../src/guestfs-actions.pod:5614 ../src/guestfs-actions.pod:6017
13202 #: ../src/guestfs-actions.pod:6040 ../src/guestfs-actions.pod:6066
13203 #: ../src/guestfs-actions.pod:7226 ../fish/guestfish-actions.pod:2563
13204 #: ../fish/guestfish-actions.pod:2576 ../fish/guestfish-actions.pod:2660
13205 #: ../fish/guestfish-actions.pod:3234 ../fish/guestfish-actions.pod:3754
13206 #: ../fish/guestfish-actions.pod:4060 ../fish/guestfish-actions.pod:4076
13207 #: ../fish/guestfish-actions.pod:4091 ../fish/guestfish-actions.pod:4806
13208 msgid ""
13209 "B<This command is dangerous.  Without careful use you can easily destroy all "
13210 "your data>."
13211 msgstr ""
13212
13213 # type: =head2
13214 #. type: =head2
13215 #: ../src/guestfs-actions.pod:3738
13216 msgid "guestfs_luks_format_cipher"
13217 msgstr ""
13218
13219 # type: verbatim
13220 #. type: verbatim
13221 #: ../src/guestfs-actions.pod:3740
13222 #, no-wrap
13223 msgid ""
13224 " int\n"
13225 " guestfs_luks_format_cipher (guestfs_h *g,\n"
13226 "                             const char *device,\n"
13227 "                             const char *key,\n"
13228 "                             int keyslot,\n"
13229 "                             const char *cipher);\n"
13230 "\n"
13231 msgstr ""
13232
13233 # type: textblock
13234 #. type: textblock
13235 #: ../src/guestfs-actions.pod:3747
13236 msgid ""
13237 "This command is the same as C<guestfs_luks_format> but it also allows you to "
13238 "set the C<cipher> used."
13239 msgstr ""
13240
13241 # type: =head2
13242 #. type: =head2
13243 #: ../src/guestfs-actions.pod:3761
13244 msgid "guestfs_luks_kill_slot"
13245 msgstr ""
13246
13247 # type: verbatim
13248 #. type: verbatim
13249 #: ../src/guestfs-actions.pod:3763
13250 #, no-wrap
13251 msgid ""
13252 " int\n"
13253 " guestfs_luks_kill_slot (guestfs_h *g,\n"
13254 "                         const char *device,\n"
13255 "                         const char *key,\n"
13256 "                         int keyslot);\n"
13257 "\n"
13258 msgstr ""
13259
13260 # type: textblock
13261 #. type: textblock
13262 #: ../src/guestfs-actions.pod:3769 ../fish/guestfish-actions.pod:2583
13263 msgid ""
13264 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
13265 "device C<device>.  C<key> must be one of the I<other> keys."
13266 msgstr ""
13267
13268 # type: =head2
13269 #. type: =head2
13270 #: ../src/guestfs-actions.pod:3781
13271 msgid "guestfs_luks_open"
13272 msgstr ""
13273
13274 # type: verbatim
13275 #. type: verbatim
13276 #: ../src/guestfs-actions.pod:3783
13277 #, no-wrap
13278 msgid ""
13279 " int\n"
13280 " guestfs_luks_open (guestfs_h *g,\n"
13281 "                    const char *device,\n"
13282 "                    const char *key,\n"
13283 "                    const char *mapname);\n"
13284 "\n"
13285 msgstr ""
13286
13287 # type: textblock
13288 #. type: textblock
13289 #: ../src/guestfs-actions.pod:3789 ../fish/guestfish-actions.pod:2594
13290 msgid ""
13291 "This command opens a block device which has been encrypted according to the "
13292 "Linux Unified Key Setup (LUKS) standard."
13293 msgstr ""
13294
13295 # type: textblock
13296 #. type: textblock
13297 #: ../src/guestfs-actions.pod:3792 ../fish/guestfish-actions.pod:2597
13298 msgid "C<device> is the encrypted block device or partition."
13299 msgstr ""
13300
13301 # type: textblock
13302 #. type: textblock
13303 #: ../src/guestfs-actions.pod:3794 ../fish/guestfish-actions.pod:2599
13304 msgid ""
13305 "The caller must supply one of the keys associated with the LUKS block "
13306 "device, in the C<key> parameter."
13307 msgstr ""
13308
13309 # type: textblock
13310 #. type: textblock
13311 #: ../src/guestfs-actions.pod:3797 ../fish/guestfish-actions.pod:2602
13312 msgid ""
13313 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
13314 "writes to this block device are decrypted from and encrypted to the "
13315 "underlying C<device> respectively."
13316 msgstr ""
13317
13318 # type: textblock
13319 #. type: textblock
13320 #: ../src/guestfs-actions.pod:3801
13321 msgid ""
13322 "If this block device contains LVM volume groups, then calling "
13323 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
13324 "visible."
13325 msgstr ""
13326
13327 # type: =head2
13328 #. type: =head2
13329 #: ../src/guestfs-actions.pod:3813
13330 msgid "guestfs_luks_open_ro"
13331 msgstr ""
13332
13333 # type: verbatim
13334 #. type: verbatim
13335 #: ../src/guestfs-actions.pod:3815
13336 #, no-wrap
13337 msgid ""
13338 " int\n"
13339 " guestfs_luks_open_ro (guestfs_h *g,\n"
13340 "                       const char *device,\n"
13341 "                       const char *key,\n"
13342 "                       const char *mapname);\n"
13343 "\n"
13344 msgstr ""
13345
13346 # type: textblock
13347 #. type: textblock
13348 #: ../src/guestfs-actions.pod:3821
13349 msgid ""
13350 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
13351 "created."
13352 msgstr ""
13353
13354 # type: =head2
13355 #. type: =head2
13356 #: ../src/guestfs-actions.pod:3832
13357 msgid "guestfs_lvcreate"
13358 msgstr ""
13359
13360 # type: verbatim
13361 #. type: verbatim
13362 #: ../src/guestfs-actions.pod:3834
13363 #, no-wrap
13364 msgid ""
13365 " int\n"
13366 " guestfs_lvcreate (guestfs_h *g,\n"
13367 "                   const char *logvol,\n"
13368 "                   const char *volgroup,\n"
13369 "                   int mbytes);\n"
13370 "\n"
13371 msgstr ""
13372
13373 # type: textblock
13374 #. type: textblock
13375 #: ../src/guestfs-actions.pod:3840 ../fish/guestfish-actions.pod:2627
13376 msgid ""
13377 "This creates an LVM logical volume called C<logvol> on the volume group "
13378 "C<volgroup>, with C<size> megabytes."
13379 msgstr ""
13380
13381 # type: =head2
13382 #. type: =head2
13383 #: ../src/guestfs-actions.pod:3847
13384 msgid "guestfs_lvm_canonical_lv_name"
13385 msgstr ""
13386
13387 # type: verbatim
13388 #. type: verbatim
13389 #: ../src/guestfs-actions.pod:3849
13390 #, no-wrap
13391 msgid ""
13392 " char *\n"
13393 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
13394 "                                const char *lvname);\n"
13395 "\n"
13396 msgstr ""
13397
13398 # type: textblock
13399 #. type: textblock
13400 #: ../src/guestfs-actions.pod:3853 ../fish/guestfish-actions.pod:2634
13401 msgid ""
13402 "This converts alternative naming schemes for LVs that you might find to the "
13403 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
13404 "LV>."
13405 msgstr ""
13406
13407 # type: textblock
13408 #. type: textblock
13409 #: ../src/guestfs-actions.pod:3857 ../fish/guestfish-actions.pod:2638
13410 msgid ""
13411 "This command returns an error if the C<lvname> parameter does not refer to a "
13412 "logical volume."
13413 msgstr ""
13414
13415 # type: textblock
13416 #. type: textblock
13417 #: ../src/guestfs-actions.pod:3860
13418 msgid "See also C<guestfs_is_lv>."
13419 msgstr ""
13420
13421 # type: textblock
13422 #. type: textblock
13423 #: ../src/guestfs-actions.pod:3865
13424 msgid "(Added in 1.5.24)"
13425 msgstr ""
13426
13427 # type: =head2
13428 #. type: =head2
13429 #: ../src/guestfs-actions.pod:3867
13430 msgid "guestfs_lvm_clear_filter"
13431 msgstr ""
13432
13433 # type: verbatim
13434 #. type: verbatim
13435 #: ../src/guestfs-actions.pod:3869
13436 #, no-wrap
13437 msgid ""
13438 " int\n"
13439 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
13440 "\n"
13441 msgstr ""
13442
13443 # type: textblock
13444 #. type: textblock
13445 #: ../src/guestfs-actions.pod:3872
13446 msgid ""
13447 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
13448 "see every block device."
13449 msgstr ""
13450
13451 # type: textblock
13452 #. type: textblock
13453 #: ../src/guestfs-actions.pod:3875 ../src/guestfs-actions.pod:3917
13454 #: ../fish/guestfish-actions.pod:2650 ../fish/guestfish-actions.pod:2681
13455 msgid ""
13456 "This command also clears the LVM cache and performs a volume group scan."
13457 msgstr ""
13458
13459 # type: =head2
13460 #. type: =head2
13461 #: ../src/guestfs-actions.pod:3882
13462 msgid "guestfs_lvm_remove_all"
13463 msgstr ""
13464
13465 # type: verbatim
13466 #. type: verbatim
13467 #: ../src/guestfs-actions.pod:3884
13468 #, no-wrap
13469 msgid ""
13470 " int\n"
13471 " guestfs_lvm_remove_all (guestfs_h *g);\n"
13472 "\n"
13473 msgstr ""
13474
13475 # type: textblock
13476 #. type: textblock
13477 #: ../src/guestfs-actions.pod:3887 ../fish/guestfish-actions.pod:2657
13478 msgid ""
13479 "This command removes all LVM logical volumes, volume groups and physical "
13480 "volumes."
13481 msgstr ""
13482
13483 # type: =head2
13484 #. type: =head2
13485 #: ../src/guestfs-actions.pod:3897
13486 msgid "guestfs_lvm_set_filter"
13487 msgstr ""
13488
13489 # type: verbatim
13490 #. type: verbatim
13491 #: ../src/guestfs-actions.pod:3899
13492 #, no-wrap
13493 msgid ""
13494 " int\n"
13495 " guestfs_lvm_set_filter (guestfs_h *g,\n"
13496 "                         char *const *devices);\n"
13497 "\n"
13498 msgstr ""
13499
13500 # type: textblock
13501 #. type: textblock
13502 #: ../src/guestfs-actions.pod:3903 ../fish/guestfish-actions.pod:2667
13503 msgid ""
13504 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
13505 "block devices in the list C<devices>, and will ignore all other attached "
13506 "block devices."
13507 msgstr ""
13508
13509 # type: textblock
13510 #. type: textblock
13511 #: ../src/guestfs-actions.pod:3907 ../fish/guestfish-actions.pod:2671
13512 msgid ""
13513 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
13514 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
13515 "there are two types of duplication possible: either cloned PVs/VGs which "
13516 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
13517 "same name.  In normal operation you cannot create this situation, but you "
13518 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
13519 "inside the LVM metadata."
13520 msgstr ""
13521
13522 # type: textblock
13523 #. type: textblock
13524 #: ../src/guestfs-actions.pod:3920 ../fish/guestfish-actions.pod:2684
13525 msgid "You can filter whole block devices or individual partitions."
13526 msgstr ""
13527
13528 # type: textblock
13529 #. type: textblock
13530 #: ../src/guestfs-actions.pod:3922 ../fish/guestfish-actions.pod:2686
13531 msgid ""
13532 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
13533 "filesystem), even if you are not filtering out that VG."
13534 msgstr ""
13535
13536 # type: =head2
13537 #. type: =head2
13538 #: ../src/guestfs-actions.pod:3930
13539 msgid "guestfs_lvremove"
13540 msgstr ""
13541
13542 # type: verbatim
13543 #. type: verbatim
13544 #: ../src/guestfs-actions.pod:3932
13545 #, no-wrap
13546 msgid ""
13547 " int\n"
13548 " guestfs_lvremove (guestfs_h *g,\n"
13549 "                   const char *device);\n"
13550 "\n"
13551 msgstr ""
13552
13553 # type: textblock
13554 #. type: textblock
13555 #: ../src/guestfs-actions.pod:3936 ../fish/guestfish-actions.pod:2694
13556 msgid ""
13557 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
13558 "LV, such as C</dev/VG/LV>."
13559 msgstr ""
13560
13561 # type: textblock
13562 #. type: textblock
13563 #: ../src/guestfs-actions.pod:3939 ../fish/guestfish-actions.pod:2697
13564 msgid ""
13565 "You can also remove all LVs in a volume group by specifying the VG name, C</"
13566 "dev/VG>."
13567 msgstr ""
13568
13569 # type: textblock
13570 #. type: textblock
13571 #: ../src/guestfs-actions.pod:3944 ../src/guestfs-actions.pod:5180
13572 #: ../src/guestfs-actions.pod:6965
13573 msgid "(Added in 1.0.13)"
13574 msgstr ""
13575
13576 # type: =head2
13577 #. type: =head2
13578 #: ../src/guestfs-actions.pod:3946
13579 msgid "guestfs_lvrename"
13580 msgstr ""
13581
13582 # type: verbatim
13583 #. type: verbatim
13584 #: ../src/guestfs-actions.pod:3948
13585 #, no-wrap
13586 msgid ""
13587 " int\n"
13588 " guestfs_lvrename (guestfs_h *g,\n"
13589 "                   const char *logvol,\n"
13590 "                   const char *newlogvol);\n"
13591 "\n"
13592 msgstr ""
13593
13594 # type: textblock
13595 #. type: textblock
13596 #: ../src/guestfs-actions.pod:3953 ../fish/guestfish-actions.pod:2704
13597 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
13598 msgstr ""
13599
13600 # type: textblock
13601 #. type: textblock
13602 #: ../src/guestfs-actions.pod:3957 ../src/guestfs-actions.pod:6978
13603 msgid "(Added in 1.0.83)"
13604 msgstr ""
13605
13606 # type: =head2
13607 #. type: =head2
13608 #: ../src/guestfs-actions.pod:3959
13609 msgid "guestfs_lvresize"
13610 msgstr ""
13611
13612 # type: verbatim
13613 #. type: verbatim
13614 #: ../src/guestfs-actions.pod:3961
13615 #, no-wrap
13616 msgid ""
13617 " int\n"
13618 " guestfs_lvresize (guestfs_h *g,\n"
13619 "                   const char *device,\n"
13620 "                   int mbytes);\n"
13621 "\n"
13622 msgstr ""
13623
13624 # type: textblock
13625 #. type: textblock
13626 #: ../src/guestfs-actions.pod:3966 ../fish/guestfish-actions.pod:2710
13627 msgid ""
13628 "This resizes (expands or shrinks) an existing LVM logical volume to "
13629 "C<mbytes>.  When reducing, data in the reduced part is lost."
13630 msgstr ""
13631
13632 # type: =head2
13633 #. type: =head2
13634 #: ../src/guestfs-actions.pod:3974
13635 msgid "guestfs_lvresize_free"
13636 msgstr ""
13637
13638 # type: verbatim
13639 #. type: verbatim
13640 #: ../src/guestfs-actions.pod:3976
13641 #, no-wrap
13642 msgid ""
13643 " int\n"
13644 " guestfs_lvresize_free (guestfs_h *g,\n"
13645 "                        const char *lv,\n"
13646 "                        int percent);\n"
13647 "\n"
13648 msgstr ""
13649
13650 # type: textblock
13651 #. type: textblock
13652 #: ../src/guestfs-actions.pod:3981 ../fish/guestfish-actions.pod:2718
13653 msgid ""
13654 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
13655 "remaining free space in the volume group.  Commonly you would call this with "
13656 "pc = 100 which expands the logical volume as much as possible, using all "
13657 "remaining free space in the volume group."
13658 msgstr ""
13659
13660 # type: textblock
13661 #. type: textblock
13662 #: ../src/guestfs-actions.pod:3989
13663 msgid "(Added in 1.3.3)"
13664 msgstr ""
13665
13666 # type: =head2
13667 #. type: =head2
13668 #: ../src/guestfs-actions.pod:3991
13669 msgid "guestfs_lvs"
13670 msgstr ""
13671
13672 # type: verbatim
13673 #. type: verbatim
13674 #: ../src/guestfs-actions.pod:3993
13675 #, no-wrap
13676 msgid ""
13677 " char **\n"
13678 " guestfs_lvs (guestfs_h *g);\n"
13679 "\n"
13680 msgstr ""
13681
13682 # type: textblock
13683 #. type: textblock
13684 #: ../src/guestfs-actions.pod:3996 ../fish/guestfish-actions.pod:2728
13685 msgid ""
13686 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13687 "(8)> command."
13688 msgstr ""
13689
13690 # type: textblock
13691 #. type: textblock
13692 #: ../src/guestfs-actions.pod:3999 ../fish/guestfish-actions.pod:2731
13693 msgid ""
13694 "This returns a list of the logical volume device names (eg. C</dev/"
13695 "VolGroup00/LogVol00>)."
13696 msgstr ""
13697
13698 # type: textblock
13699 #. type: textblock
13700 #: ../src/guestfs-actions.pod:4002
13701 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
13702 msgstr ""
13703
13704 # type: =head2
13705 #. type: =head2
13706 #: ../src/guestfs-actions.pod:4010
13707 msgid "guestfs_lvs_full"
13708 msgstr ""
13709
13710 # type: verbatim
13711 #. type: verbatim
13712 #: ../src/guestfs-actions.pod:4012
13713 #, no-wrap
13714 msgid ""
13715 " struct guestfs_lvm_lv_list *\n"
13716 " guestfs_lvs_full (guestfs_h *g);\n"
13717 "\n"
13718 msgstr ""
13719
13720 # type: textblock
13721 #. type: textblock
13722 #: ../src/guestfs-actions.pod:4015 ../fish/guestfish-actions.pod:2740
13723 msgid ""
13724 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13725 "(8)> command.  The \"full\" version includes all fields."
13726 msgstr ""
13727
13728 # type: textblock
13729 #. type: textblock
13730 #: ../src/guestfs-actions.pod:4018
13731 msgid ""
13732 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
13733 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
13734 msgstr ""
13735
13736 # type: =head2
13737 #. type: =head2
13738 #: ../src/guestfs-actions.pod:4024
13739 msgid "guestfs_lvuuid"
13740 msgstr ""
13741
13742 # type: verbatim
13743 #. type: verbatim
13744 #: ../src/guestfs-actions.pod:4026
13745 #, no-wrap
13746 msgid ""
13747 " char *\n"
13748 " guestfs_lvuuid (guestfs_h *g,\n"
13749 "                 const char *device);\n"
13750 "\n"
13751 msgstr ""
13752
13753 # type: textblock
13754 #. type: textblock
13755 #: ../src/guestfs-actions.pod:4030 ../fish/guestfish-actions.pod:2747
13756 msgid "This command returns the UUID of the LVM LV C<device>."
13757 msgstr ""
13758
13759 # type: =head2
13760 #. type: =head2
13761 #: ../src/guestfs-actions.pod:4037
13762 msgid "guestfs_lxattrlist"
13763 msgstr ""
13764
13765 # type: verbatim
13766 #. type: verbatim
13767 #: ../src/guestfs-actions.pod:4039
13768 #, no-wrap
13769 msgid ""
13770 " struct guestfs_xattr_list *\n"
13771 " guestfs_lxattrlist (guestfs_h *g,\n"
13772 "                     const char *path,\n"
13773 "                     char *const *names);\n"
13774 "\n"
13775 msgstr ""
13776
13777 # type: textblock
13778 #. type: textblock
13779 #: ../src/guestfs-actions.pod:4044 ../fish/guestfish-actions.pod:2753
13780 msgid ""
13781 "This call allows you to get the extended attributes of multiple files, where "
13782 "all files are in the directory C<path>.  C<names> is the list of files from "
13783 "this directory."
13784 msgstr ""
13785
13786 # type: textblock
13787 #. type: textblock
13788 #: ../src/guestfs-actions.pod:4048 ../fish/guestfish-actions.pod:2757
13789 msgid ""
13790 "On return you get a flat list of xattr structs which must be interpreted "
13791 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
13792 "C<attrval> in this struct is zero-length to indicate there was an error "
13793 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
13794 "number (the number of following attributes for this file, which could be C<"
13795 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
13796 "for the first named file.  This repeats for the second and subsequent files."
13797 msgstr ""
13798
13799 # type: textblock
13800 #. type: textblock
13801 #: ../src/guestfs-actions.pod:4058
13802 msgid ""
13803 "This call is intended for programs that want to efficiently list a directory "
13804 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
13805 "a similarly efficient call for getting standard stats.  Very long directory "
13806 "listings might cause the protocol message size to be exceeded, causing this "
13807 "call to fail.  The caller must split up such requests into smaller groups of "
13808 "names."
13809 msgstr ""
13810
13811 # type: =head2
13812 #. type: =head2
13813 #: ../src/guestfs-actions.pod:4072
13814 msgid "guestfs_mkdir"
13815 msgstr ""
13816
13817 # type: verbatim
13818 #. type: verbatim
13819 #: ../src/guestfs-actions.pod:4074
13820 #, no-wrap
13821 msgid ""
13822 " int\n"
13823 " guestfs_mkdir (guestfs_h *g,\n"
13824 "                const char *path);\n"
13825 "\n"
13826 msgstr ""
13827
13828 # type: textblock
13829 #. type: textblock
13830 #: ../src/guestfs-actions.pod:4078 ../fish/guestfish-actions.pod:2779
13831 msgid "Create a directory named C<path>."
13832 msgstr ""
13833
13834 # type: =head2
13835 #. type: =head2
13836 #: ../src/guestfs-actions.pod:4084
13837 msgid "guestfs_mkdir_mode"
13838 msgstr ""
13839
13840 # type: verbatim
13841 #. type: verbatim
13842 #: ../src/guestfs-actions.pod:4086
13843 #, no-wrap
13844 msgid ""
13845 " int\n"
13846 " guestfs_mkdir_mode (guestfs_h *g,\n"
13847 "                     const char *path,\n"
13848 "                     int mode);\n"
13849 "\n"
13850 msgstr ""
13851
13852 # type: textblock
13853 #. type: textblock
13854 #: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2785
13855 msgid ""
13856 "This command creates a directory, setting the initial permissions of the "
13857 "directory to C<mode>."
13858 msgstr ""
13859
13860 # type: textblock
13861 #. type: textblock
13862 #: ../src/guestfs-actions.pod:4094 ../fish/guestfish-actions.pod:2788
13863 msgid ""
13864 "For common Linux filesystems, the actual mode which is set will be C<mode & "
13865 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
13866 "other ways."
13867 msgstr ""
13868
13869 # type: textblock
13870 #. type: textblock
13871 #: ../src/guestfs-actions.pod:4098
13872 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
13873 msgstr ""
13874
13875 # type: =head2
13876 #. type: =head2
13877 #: ../src/guestfs-actions.pod:4104
13878 msgid "guestfs_mkdir_p"
13879 msgstr ""
13880
13881 # type: verbatim
13882 #. type: verbatim
13883 #: ../src/guestfs-actions.pod:4106
13884 #, no-wrap
13885 msgid ""
13886 " int\n"
13887 " guestfs_mkdir_p (guestfs_h *g,\n"
13888 "                  const char *path);\n"
13889 "\n"
13890 msgstr ""
13891
13892 # type: textblock
13893 #. type: textblock
13894 #: ../src/guestfs-actions.pod:4110 ../fish/guestfish-actions.pod:2798
13895 msgid ""
13896 "Create a directory named C<path>, creating any parent directories as "
13897 "necessary.  This is like the C<mkdir -p> shell command."
13898 msgstr ""
13899
13900 # type: =head2
13901 #. type: =head2
13902 #: ../src/guestfs-actions.pod:4117
13903 msgid "guestfs_mkdtemp"
13904 msgstr ""
13905
13906 # type: verbatim
13907 #. type: verbatim
13908 #: ../src/guestfs-actions.pod:4119
13909 #, no-wrap
13910 msgid ""
13911 " char *\n"
13912 " guestfs_mkdtemp (guestfs_h *g,\n"
13913 "                  const char *template);\n"
13914 "\n"
13915 msgstr ""
13916
13917 # type: textblock
13918 #. type: textblock
13919 #: ../src/guestfs-actions.pod:4123 ../fish/guestfish-actions.pod:2805
13920 msgid ""
13921 "This command creates a temporary directory.  The C<template> parameter "
13922 "should be a full pathname for the temporary directory name with the final "
13923 "six characters being \"XXXXXX\"."
13924 msgstr ""
13925
13926 # type: textblock
13927 #. type: textblock
13928 #: ../src/guestfs-actions.pod:4128 ../fish/guestfish-actions.pod:2810
13929 msgid ""
13930 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
13931 "being suitable for Windows filesystems."
13932 msgstr ""
13933
13934 # type: textblock
13935 #. type: textblock
13936 #: ../src/guestfs-actions.pod:4131 ../fish/guestfish-actions.pod:2813
13937 msgid "The name of the temporary directory that was created is returned."
13938 msgstr ""
13939
13940 # type: textblock
13941 #. type: textblock
13942 #: ../src/guestfs-actions.pod:4134 ../fish/guestfish-actions.pod:2816
13943 msgid "The temporary directory is created with mode 0700 and is owned by root."
13944 msgstr ""
13945
13946 # type: textblock
13947 #. type: textblock
13948 #: ../src/guestfs-actions.pod:4137 ../fish/guestfish-actions.pod:2819
13949 msgid ""
13950 "The caller is responsible for deleting the temporary directory and its "
13951 "contents after use."
13952 msgstr ""
13953
13954 # type: textblock
13955 #. type: textblock
13956 #: ../src/guestfs-actions.pod:4140 ../fish/guestfish-actions.pod:2822
13957 msgid "See also: L<mkdtemp(3)>"
13958 msgstr ""
13959
13960 # type: =head2
13961 #. type: =head2
13962 #: ../src/guestfs-actions.pod:4147
13963 msgid "guestfs_mke2fs_J"
13964 msgstr ""
13965
13966 # type: verbatim
13967 #. type: verbatim
13968 #: ../src/guestfs-actions.pod:4149
13969 #, no-wrap
13970 msgid ""
13971 " int\n"
13972 " guestfs_mke2fs_J (guestfs_h *g,\n"
13973 "                   const char *fstype,\n"
13974 "                   int blocksize,\n"
13975 "                   const char *device,\n"
13976 "                   const char *journal);\n"
13977 "\n"
13978 msgstr ""
13979
13980 # type: textblock
13981 #. type: textblock
13982 #: ../src/guestfs-actions.pod:4156 ../fish/guestfish-actions.pod:2828
13983 msgid ""
13984 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13985 "C<journal>.  It is equivalent to the command:"
13986 msgstr ""
13987
13988 # type: verbatim
13989 #. type: verbatim
13990 #: ../src/guestfs-actions.pod:4160 ../fish/guestfish-actions.pod:2832
13991 #, no-wrap
13992 msgid ""
13993 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
13994 "\n"
13995 msgstr ""
13996
13997 # type: textblock
13998 #. type: textblock
13999 #: ../src/guestfs-actions.pod:4162
14000 msgid "See also C<guestfs_mke2journal>."
14001 msgstr ""
14002
14003 # type: textblock
14004 #. type: textblock
14005 #: ../src/guestfs-actions.pod:4166 ../src/guestfs-actions.pod:4184
14006 #: ../src/guestfs-actions.pod:4202 ../src/guestfs-actions.pod:4218
14007 #: ../src/guestfs-actions.pod:4232 ../src/guestfs-actions.pod:4246
14008 #: ../src/guestfs-actions.pod:4305 ../src/guestfs-actions.pod:4570
14009 msgid "(Added in 1.0.68)"
14010 msgstr ""
14011
14012 # type: =head2
14013 #. type: =head2
14014 #: ../src/guestfs-actions.pod:4168
14015 msgid "guestfs_mke2fs_JL"
14016 msgstr ""
14017
14018 # type: verbatim
14019 #. type: verbatim
14020 #: ../src/guestfs-actions.pod:4170
14021 #, no-wrap
14022 msgid ""
14023 " int\n"
14024 " guestfs_mke2fs_JL (guestfs_h *g,\n"
14025 "                    const char *fstype,\n"
14026 "                    int blocksize,\n"
14027 "                    const char *device,\n"
14028 "                    const char *label);\n"
14029 "\n"
14030 msgstr ""
14031
14032 # type: textblock
14033 #. type: textblock
14034 #: ../src/guestfs-actions.pod:4177 ../fish/guestfish-actions.pod:2840
14035 msgid ""
14036 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14037 "the journal labeled C<label>."
14038 msgstr ""
14039
14040 # type: textblock
14041 #. type: textblock
14042 #: ../src/guestfs-actions.pod:4180
14043 msgid "See also C<guestfs_mke2journal_L>."
14044 msgstr ""
14045
14046 # type: =head2
14047 #. type: =head2
14048 #: ../src/guestfs-actions.pod:4186
14049 msgid "guestfs_mke2fs_JU"
14050 msgstr ""
14051
14052 # type: verbatim
14053 #. type: verbatim
14054 #: ../src/guestfs-actions.pod:4188
14055 #, no-wrap
14056 msgid ""
14057 " int\n"
14058 " guestfs_mke2fs_JU (guestfs_h *g,\n"
14059 "                    const char *fstype,\n"
14060 "                    int blocksize,\n"
14061 "                    const char *device,\n"
14062 "                    const char *uuid);\n"
14063 "\n"
14064 msgstr ""
14065
14066 # type: textblock
14067 #. type: textblock
14068 #: ../src/guestfs-actions.pod:4195 ../fish/guestfish-actions.pod:2849
14069 msgid ""
14070 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14071 "the journal with UUID C<uuid>."
14072 msgstr ""
14073
14074 # type: textblock
14075 #. type: textblock
14076 #: ../src/guestfs-actions.pod:4198
14077 msgid "See also C<guestfs_mke2journal_U>."
14078 msgstr ""
14079
14080 # type: =head2
14081 #. type: =head2
14082 #: ../src/guestfs-actions.pod:4204
14083 msgid "guestfs_mke2journal"
14084 msgstr ""
14085
14086 # type: verbatim
14087 #. type: verbatim
14088 #: ../src/guestfs-actions.pod:4206
14089 #, no-wrap
14090 msgid ""
14091 " int\n"
14092 " guestfs_mke2journal (guestfs_h *g,\n"
14093 "                      int blocksize,\n"
14094 "                      const char *device);\n"
14095 "\n"
14096 msgstr ""
14097
14098 # type: textblock
14099 #. type: textblock
14100 #: ../src/guestfs-actions.pod:4211 ../fish/guestfish-actions.pod:2858
14101 msgid ""
14102 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
14103 "command:"
14104 msgstr ""
14105
14106 # type: verbatim
14107 #. type: verbatim
14108 #: ../src/guestfs-actions.pod:4214 ../fish/guestfish-actions.pod:2861
14109 #, no-wrap
14110 msgid ""
14111 " mke2fs -O journal_dev -b blocksize device\n"
14112 "\n"
14113 msgstr ""
14114
14115 # type: =head2
14116 #. type: =head2
14117 #: ../src/guestfs-actions.pod:4220
14118 msgid "guestfs_mke2journal_L"
14119 msgstr ""
14120
14121 # type: verbatim
14122 #. type: verbatim
14123 #: ../src/guestfs-actions.pod:4222
14124 #, no-wrap
14125 msgid ""
14126 " int\n"
14127 " guestfs_mke2journal_L (guestfs_h *g,\n"
14128 "                        int blocksize,\n"
14129 "                        const char *label,\n"
14130 "                        const char *device);\n"
14131 "\n"
14132 msgstr ""
14133
14134 # type: textblock
14135 #. type: textblock
14136 #: ../src/guestfs-actions.pod:4228 ../fish/guestfish-actions.pod:2867
14137 msgid "This creates an ext2 external journal on C<device> with label C<label>."
14138 msgstr ""
14139
14140 # type: =head2
14141 #. type: =head2
14142 #: ../src/guestfs-actions.pod:4234
14143 msgid "guestfs_mke2journal_U"
14144 msgstr ""
14145
14146 # type: verbatim
14147 #. type: verbatim
14148 #: ../src/guestfs-actions.pod:4236
14149 #, no-wrap
14150 msgid ""
14151 " int\n"
14152 " guestfs_mke2journal_U (guestfs_h *g,\n"
14153 "                        int blocksize,\n"
14154 "                        const char *uuid,\n"
14155 "                        const char *device);\n"
14156 "\n"
14157 msgstr ""
14158
14159 # type: textblock
14160 #. type: textblock
14161 #: ../src/guestfs-actions.pod:4242 ../fish/guestfish-actions.pod:2873
14162 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
14163 msgstr ""
14164
14165 # type: =head2
14166 #. type: =head2
14167 #: ../src/guestfs-actions.pod:4248
14168 msgid "guestfs_mkfifo"
14169 msgstr ""
14170
14171 # type: verbatim
14172 #. type: verbatim
14173 #: ../src/guestfs-actions.pod:4250
14174 #, no-wrap
14175 msgid ""
14176 " int\n"
14177 " guestfs_mkfifo (guestfs_h *g,\n"
14178 "                 int mode,\n"
14179 "                 const char *path);\n"
14180 "\n"
14181 msgstr ""
14182
14183 # type: textblock
14184 #. type: textblock
14185 #: ../src/guestfs-actions.pod:4255
14186 msgid ""
14187 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
14188 "is just a convenient wrapper around C<guestfs_mknod>."
14189 msgstr ""
14190
14191 # type: =head2
14192 #. type: =head2
14193 #: ../src/guestfs-actions.pod:4265
14194 msgid "guestfs_mkfs"
14195 msgstr ""
14196
14197 # type: verbatim
14198 #. type: verbatim
14199 #: ../src/guestfs-actions.pod:4267
14200 #, no-wrap
14201 msgid ""
14202 " int\n"
14203 " guestfs_mkfs (guestfs_h *g,\n"
14204 "               const char *fstype,\n"
14205 "               const char *device);\n"
14206 "\n"
14207 msgstr ""
14208
14209 # type: textblock
14210 #. type: textblock
14211 #: ../src/guestfs-actions.pod:4272 ../fish/guestfish-actions.pod:2889
14212 msgid ""
14213 "This creates a filesystem on C<device> (usually a partition or LVM logical "
14214 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
14215 msgstr ""
14216
14217 # type: =head2
14218 #. type: =head2
14219 #: ../src/guestfs-actions.pod:4280
14220 msgid "guestfs_mkfs_b"
14221 msgstr ""
14222
14223 # type: verbatim
14224 #. type: verbatim
14225 #: ../src/guestfs-actions.pod:4282
14226 #, no-wrap
14227 msgid ""
14228 " int\n"
14229 " guestfs_mkfs_b (guestfs_h *g,\n"
14230 "                 const char *fstype,\n"
14231 "                 int blocksize,\n"
14232 "                 const char *device);\n"
14233 "\n"
14234 msgstr ""
14235
14236 # type: textblock
14237 #. type: textblock
14238 #: ../src/guestfs-actions.pod:4288
14239 msgid ""
14240 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
14241 "block size of the resulting filesystem.  Supported block sizes depend on the "
14242 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
14243 msgstr ""
14244
14245 # type: textblock
14246 #. type: textblock
14247 #: ../src/guestfs-actions.pod:4293 ../src/guestfs-actions.pod:4336
14248 #: ../fish/guestfish-actions.pod:2902 ../fish/guestfish-actions.pod:2929
14249 msgid ""
14250 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
14251 "cluster size."
14252 msgstr ""
14253
14254 # type: textblock
14255 #. type: textblock
14256 #: ../src/guestfs-actions.pod:4298 ../fish/guestfish-actions.pod:2905
14257 msgid ""
14258 "This function is deprecated.  In new code, use the C<mkfs_opts> call instead."
14259 msgstr ""
14260
14261 # type: =head2
14262 #. type: =head2
14263 #: ../src/guestfs-actions.pod:4307
14264 msgid "guestfs_mkfs_opts"
14265 msgstr ""
14266
14267 # type: verbatim
14268 #. type: verbatim
14269 #: ../src/guestfs-actions.pod:4309
14270 #, no-wrap
14271 msgid ""
14272 " int\n"
14273 " guestfs_mkfs_opts (guestfs_h *g,\n"
14274 "                    const char *fstype,\n"
14275 "                    const char *device,\n"
14276 "                    ...);\n"
14277 "\n"
14278 msgstr ""
14279
14280 #. type: verbatim
14281 #: ../src/guestfs-actions.pod:4320
14282 #, no-wrap
14283 msgid ""
14284 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
14285 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
14286 "\n"
14287 msgstr ""
14288
14289 # type: textblock
14290 #. type: textblock
14291 #: ../src/guestfs-actions.pod:4323 ../fish/guestfish-actions.pod:2916
14292 msgid ""
14293 "This function creates a filesystem on C<device>.  The filesystem type is "
14294 "C<fstype>, for example C<ext3>."
14295 msgstr ""
14296
14297 # type: =item
14298 #. type: =item
14299 #: ../src/guestfs-actions.pod:4330 ../fish/guestfish-actions.pod:2923
14300 msgid "C<blocksize>"
14301 msgstr ""
14302
14303 # type: textblock
14304 #. type: textblock
14305 #: ../src/guestfs-actions.pod:4332 ../fish/guestfish-actions.pod:2925
14306 msgid ""
14307 "The filesystem block size.  Supported block sizes depend on the filesystem "
14308 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
14309 "filesystems."
14310 msgstr ""
14311
14312 #. type: textblock
14313 #: ../src/guestfs-actions.pod:4339 ../fish/guestfish-actions.pod:2932
14314 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
14315 msgstr ""
14316
14317 #. type: =item
14318 #: ../src/guestfs-actions.pod:4341 ../fish/guestfish-actions.pod:2934
14319 msgid "C<features>"
14320 msgstr ""
14321
14322 #. type: textblock
14323 #: ../src/guestfs-actions.pod:4343 ../fish/guestfish-actions.pod:2936
14324 msgid "This passes the C<-O> parameter to the external mkfs program."
14325 msgstr ""
14326
14327 #. type: textblock
14328 #: ../src/guestfs-actions.pod:4345 ../fish/guestfish-actions.pod:2938
14329 msgid ""
14330 "For certain filesystem types, this allows extra filesystem features to be "
14331 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
14332 msgstr ""
14333
14334 #. type: textblock
14335 #: ../src/guestfs-actions.pod:4349 ../fish/guestfish-actions.pod:2942
14336 msgid ""
14337 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
14338 "type."
14339 msgstr ""
14340
14341 #. type: textblock
14342 #: ../src/guestfs-actions.pod:4356
14343 msgid "(Added in 1.7.19)"
14344 msgstr ""
14345
14346 # type: =head2
14347 #. type: =head2
14348 #: ../src/guestfs-actions.pod:4358
14349 msgid "guestfs_mkfs_opts_va"
14350 msgstr ""
14351
14352 # type: verbatim
14353 #. type: verbatim
14354 #: ../src/guestfs-actions.pod:4360
14355 #, no-wrap
14356 msgid ""
14357 " int\n"
14358 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
14359 "                       const char *fstype,\n"
14360 "                       const char *device,\n"
14361 "                       va_list args);\n"
14362 "\n"
14363 msgstr ""
14364
14365 # type: textblock
14366 #. type: textblock
14367 #: ../src/guestfs-actions.pod:4366
14368 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
14369 msgstr ""
14370
14371 # type: =head2
14372 #. type: =head2
14373 #: ../src/guestfs-actions.pod:4370
14374 msgid "guestfs_mkfs_opts_argv"
14375 msgstr ""
14376
14377 # type: verbatim
14378 #. type: verbatim
14379 #: ../src/guestfs-actions.pod:4372
14380 #, no-wrap
14381 msgid ""
14382 " int\n"
14383 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
14384 "                         const char *fstype,\n"
14385 "                         const char *device,\n"
14386 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
14387 "\n"
14388 msgstr ""
14389
14390 # type: textblock
14391 #. type: textblock
14392 #: ../src/guestfs-actions.pod:4378
14393 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
14394 msgstr ""
14395
14396 # type: =head2
14397 #. type: =head2
14398 #: ../src/guestfs-actions.pod:4382
14399 msgid "guestfs_mkmountpoint"
14400 msgstr ""
14401
14402 # type: verbatim
14403 #. type: verbatim
14404 #: ../src/guestfs-actions.pod:4384
14405 #, no-wrap
14406 msgid ""
14407 " int\n"
14408 " guestfs_mkmountpoint (guestfs_h *g,\n"
14409 "                       const char *exemptpath);\n"
14410 "\n"
14411 msgstr ""
14412
14413 # type: textblock
14414 #. type: textblock
14415 #: ../src/guestfs-actions.pod:4388
14416 msgid ""
14417 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
14418 "that can be used to create extra mountpoints before mounting the first "
14419 "filesystem."
14420 msgstr ""
14421
14422 # type: textblock
14423 #. type: textblock
14424 #: ../src/guestfs-actions.pod:4392 ../fish/guestfish-actions.pod:2957
14425 msgid ""
14426 "These calls are I<only> necessary in some very limited circumstances, mainly "
14427 "the case where you want to mount a mix of unrelated and/or read-only "
14428 "filesystems together."
14429 msgstr ""
14430
14431 # type: textblock
14432 #. type: textblock
14433 #: ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:2961
14434 msgid ""
14435 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
14436 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
14437 "inside that.  You can unpack this as follows in guestfish:"
14438 msgstr ""
14439
14440 # type: verbatim
14441 #. type: verbatim
14442 #: ../src/guestfs-actions.pod:4401 ../fish/guestfish-actions.pod:2966
14443 #, no-wrap
14444 msgid ""
14445 " add-ro Fedora-11-i686-Live.iso\n"
14446 " run\n"
14447 " mkmountpoint /cd\n"
14448 " mkmountpoint /sqsh\n"
14449 " mkmountpoint /ext3fs\n"
14450 " mount /dev/sda /cd\n"
14451 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
14452 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
14453 "\n"
14454 msgstr ""
14455
14456 # type: textblock
14457 #. type: textblock
14458 #: ../src/guestfs-actions.pod:4410 ../fish/guestfish-actions.pod:2975
14459 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
14460 msgstr ""
14461
14462 # type: textblock
14463 #. type: textblock
14464 #: ../src/guestfs-actions.pod:4412
14465 msgid ""
14466 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
14467 "may get unexpected errors if you try to mix these calls.  It is safest to "
14468 "manually unmount filesystems and remove mountpoints after use."
14469 msgstr ""
14470
14471 # type: textblock
14472 #. type: textblock
14473 #: ../src/guestfs-actions.pod:4416
14474 msgid ""
14475 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
14476 "first, so for this to work for manual mountpoints, you must ensure that the "
14477 "innermost mountpoints have the longest pathnames, as in the example code "
14478 "above."
14479 msgstr ""
14480
14481 # type: textblock
14482 #. type: textblock
14483 #: ../src/guestfs-actions.pod:4421 ../fish/guestfish-actions.pod:2986
14484 msgid ""
14485 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
14486 msgstr ""
14487
14488 #. type: textblock
14489 #: ../src/guestfs-actions.pod:4423
14490 msgid ""
14491 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
14492 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
14493 "can also trigger these issues."
14494 msgstr ""
14495
14496 # type: textblock
14497 #. type: textblock
14498 #: ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:4688
14499 #: ../src/guestfs-actions.pod:5598
14500 msgid "(Added in 1.0.62)"
14501 msgstr ""
14502
14503 # type: =head2
14504 #. type: =head2
14505 #: ../src/guestfs-actions.pod:4431
14506 msgid "guestfs_mknod"
14507 msgstr ""
14508
14509 # type: verbatim
14510 #. type: verbatim
14511 #: ../src/guestfs-actions.pod:4433
14512 #, no-wrap
14513 msgid ""
14514 " int\n"
14515 " guestfs_mknod (guestfs_h *g,\n"
14516 "                int mode,\n"
14517 "                int devmajor,\n"
14518 "                int devminor,\n"
14519 "                const char *path);\n"
14520 "\n"
14521 msgstr ""
14522
14523 # type: textblock
14524 #. type: textblock
14525 #: ../src/guestfs-actions.pod:4440 ../fish/guestfish-actions.pod:2996
14526 msgid ""
14527 "This call creates block or character special devices, or named pipes (FIFOs)."
14528 msgstr ""
14529
14530 # type: textblock
14531 #. type: textblock
14532 #: ../src/guestfs-actions.pod:4443 ../fish/guestfish-actions.pod:2999
14533 msgid ""
14534 "The C<mode> parameter should be the mode, using the standard constants.  "
14535 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
14536 "used when creating block and character special devices."
14537 msgstr ""
14538
14539 # type: textblock
14540 #. type: textblock
14541 #: ../src/guestfs-actions.pod:4448
14542 msgid ""
14543 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
14544 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
14545 "regular file).  These constants are available in the standard Linux header "
14546 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
14547 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
14548 "the appropriate constant for you."
14549 msgstr ""
14550
14551 # type: =head2
14552 #. type: =head2
14553 #: ../src/guestfs-actions.pod:4462
14554 msgid "guestfs_mknod_b"
14555 msgstr ""
14556
14557 # type: verbatim
14558 #. type: verbatim
14559 #: ../src/guestfs-actions.pod:4464
14560 #, no-wrap
14561 msgid ""
14562 " int\n"
14563 " guestfs_mknod_b (guestfs_h *g,\n"
14564 "                  int mode,\n"
14565 "                  int devmajor,\n"
14566 "                  int devminor,\n"
14567 "                  const char *path);\n"
14568 "\n"
14569 msgstr ""
14570
14571 # type: textblock
14572 #. type: textblock
14573 #: ../src/guestfs-actions.pod:4471
14574 msgid ""
14575 "This call creates a block device node called C<path> with mode C<mode> and "
14576 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
14577 "wrapper around C<guestfs_mknod>."
14578 msgstr ""
14579
14580 # type: =head2
14581 #. type: =head2
14582 #: ../src/guestfs-actions.pod:4481
14583 msgid "guestfs_mknod_c"
14584 msgstr ""
14585
14586 # type: verbatim
14587 #. type: verbatim
14588 #: ../src/guestfs-actions.pod:4483
14589 #, no-wrap
14590 msgid ""
14591 " int\n"
14592 " guestfs_mknod_c (guestfs_h *g,\n"
14593 "                  int mode,\n"
14594 "                  int devmajor,\n"
14595 "                  int devminor,\n"
14596 "                  const char *path);\n"
14597 "\n"
14598 msgstr ""
14599
14600 # type: textblock
14601 #. type: textblock
14602 #: ../src/guestfs-actions.pod:4490
14603 msgid ""
14604 "This call creates a char device node called C<path> with mode C<mode> and "
14605 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
14606 "wrapper around C<guestfs_mknod>."
14607 msgstr ""
14608
14609 # type: =head2
14610 #. type: =head2
14611 #: ../src/guestfs-actions.pod:4500
14612 msgid "guestfs_mkswap"
14613 msgstr ""
14614
14615 # type: verbatim
14616 #. type: verbatim
14617 #: ../src/guestfs-actions.pod:4502
14618 #, no-wrap
14619 msgid ""
14620 " int\n"
14621 " guestfs_mkswap (guestfs_h *g,\n"
14622 "                 const char *device);\n"
14623 "\n"
14624 msgstr ""
14625
14626 # type: textblock
14627 #. type: textblock
14628 #: ../src/guestfs-actions.pod:4506 ../fish/guestfish-actions.pod:3038
14629 msgid "Create a swap partition on C<device>."
14630 msgstr ""
14631
14632 # type: =head2
14633 #. type: =head2
14634 #: ../src/guestfs-actions.pod:4512
14635 msgid "guestfs_mkswap_L"
14636 msgstr ""
14637
14638 # type: verbatim
14639 #. type: verbatim
14640 #: ../src/guestfs-actions.pod:4514
14641 #, no-wrap
14642 msgid ""
14643 " int\n"
14644 " guestfs_mkswap_L (guestfs_h *g,\n"
14645 "                   const char *label,\n"
14646 "                   const char *device);\n"
14647 "\n"
14648 msgstr ""
14649
14650 # type: textblock
14651 #. type: textblock
14652 #: ../src/guestfs-actions.pod:4519 ../fish/guestfish-actions.pod:3044
14653 msgid "Create a swap partition on C<device> with label C<label>."
14654 msgstr ""
14655
14656 # type: textblock
14657 #. type: textblock
14658 #: ../src/guestfs-actions.pod:4521 ../fish/guestfish-actions.pod:3046
14659 msgid ""
14660 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
14661 "sda>), just to a partition.  This appears to be a limitation of the kernel "
14662 "or swap tools."
14663 msgstr ""
14664
14665 # type: =head2
14666 #. type: =head2
14667 #: ../src/guestfs-actions.pod:4529
14668 msgid "guestfs_mkswap_U"
14669 msgstr ""
14670
14671 # type: verbatim
14672 #. type: verbatim
14673 #: ../src/guestfs-actions.pod:4531
14674 #, no-wrap
14675 msgid ""
14676 " int\n"
14677 " guestfs_mkswap_U (guestfs_h *g,\n"
14678 "                   const char *uuid,\n"
14679 "                   const char *device);\n"
14680 "\n"
14681 msgstr ""
14682
14683 # type: textblock
14684 #. type: textblock
14685 #: ../src/guestfs-actions.pod:4536 ../fish/guestfish-actions.pod:3054
14686 msgid "Create a swap partition on C<device> with UUID C<uuid>."
14687 msgstr ""
14688
14689 # type: =head2
14690 #. type: =head2
14691 #: ../src/guestfs-actions.pod:4542
14692 msgid "guestfs_mkswap_file"
14693 msgstr ""
14694
14695 # type: verbatim
14696 #. type: verbatim
14697 #: ../src/guestfs-actions.pod:4544
14698 #, no-wrap
14699 msgid ""
14700 " int\n"
14701 " guestfs_mkswap_file (guestfs_h *g,\n"
14702 "                      const char *path);\n"
14703 "\n"
14704 msgstr ""
14705
14706 # type: textblock
14707 #. type: textblock
14708 #: ../src/guestfs-actions.pod:4548 ../fish/guestfish-actions.pod:3060
14709 msgid "Create a swap file."
14710 msgstr ""
14711
14712 # type: textblock
14713 #. type: textblock
14714 #: ../src/guestfs-actions.pod:4550
14715 msgid ""
14716 "This command just writes a swap file signature to an existing file.  To "
14717 "create the file itself, use something like C<guestfs_fallocate>."
14718 msgstr ""
14719
14720 # type: =head2
14721 #. type: =head2
14722 #: ../src/guestfs-actions.pod:4557
14723 msgid "guestfs_modprobe"
14724 msgstr ""
14725
14726 # type: verbatim
14727 #. type: verbatim
14728 #: ../src/guestfs-actions.pod:4559
14729 #, no-wrap
14730 msgid ""
14731 " int\n"
14732 " guestfs_modprobe (guestfs_h *g,\n"
14733 "                   const char *modulename);\n"
14734 "\n"
14735 msgstr ""
14736
14737 # type: textblock
14738 #. type: textblock
14739 #: ../src/guestfs-actions.pod:4563 ../fish/guestfish-actions.pod:3069
14740 msgid "This loads a kernel module in the appliance."
14741 msgstr ""
14742
14743 # type: textblock
14744 #. type: textblock
14745 #: ../src/guestfs-actions.pod:4565 ../fish/guestfish-actions.pod:3071
14746 msgid ""
14747 "The kernel module must have been whitelisted when libguestfs was built (see "
14748 "C<appliance/kmod.whitelist.in> in the source)."
14749 msgstr ""
14750
14751 # type: =head2
14752 #. type: =head2
14753 #: ../src/guestfs-actions.pod:4572
14754 msgid "guestfs_mount"
14755 msgstr ""
14756
14757 # type: verbatim
14758 #. type: verbatim
14759 #: ../src/guestfs-actions.pod:4574
14760 #, no-wrap
14761 msgid ""
14762 " int\n"
14763 " guestfs_mount (guestfs_h *g,\n"
14764 "                const char *device,\n"
14765 "                const char *mountpoint);\n"
14766 "\n"
14767 msgstr ""
14768
14769 # type: textblock
14770 #. type: textblock
14771 #: ../src/guestfs-actions.pod:4579 ../fish/guestfish-actions.pod:3078
14772 msgid ""
14773 "Mount a guest disk at a position in the filesystem.  Block devices are named "
14774 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
14775 "those block devices contain partitions, they will have the usual names (eg. "
14776 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
14777 msgstr ""
14778
14779 # type: textblock
14780 #. type: textblock
14781 #: ../src/guestfs-actions.pod:4585 ../fish/guestfish-actions.pod:3084
14782 msgid ""
14783 "The rules are the same as for L<mount(2)>: A filesystem must first be "
14784 "mounted on C</> before others can be mounted.  Other filesystems can only be "
14785 "mounted on directories which already exist."
14786 msgstr ""
14787
14788 # type: textblock
14789 #. type: textblock
14790 #: ../src/guestfs-actions.pod:4590 ../fish/guestfish-actions.pod:3089
14791 msgid ""
14792 "The mounted filesystem is writable, if we have sufficient permissions on the "
14793 "underlying device."
14794 msgstr ""
14795
14796 # type: textblock
14797 #. type: textblock
14798 #: ../src/guestfs-actions.pod:4593
14799 msgid ""
14800 "B<Important note:> When you use this call, the filesystem options C<sync> "
14801 "and C<noatime> are set implicitly.  This was originally done because we "
14802 "thought it would improve reliability, but it turns out that I<-o sync> has a "
14803 "very large negative performance impact and negligible effect on "
14804 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
14805 "in any code that needs performance, and instead use C<guestfs_mount_options> "
14806 "(use an empty string for the first parameter if you don't want any options)."
14807 msgstr ""
14808
14809 # type: =head2
14810 #. type: =head2
14811 #: ../src/guestfs-actions.pod:4607
14812 msgid "guestfs_mount_loop"
14813 msgstr ""
14814
14815 # type: verbatim
14816 #. type: verbatim
14817 #: ../src/guestfs-actions.pod:4609
14818 #, no-wrap
14819 msgid ""
14820 " int\n"
14821 " guestfs_mount_loop (guestfs_h *g,\n"
14822 "                     const char *file,\n"
14823 "                     const char *mountpoint);\n"
14824 "\n"
14825 msgstr ""
14826
14827 # type: textblock
14828 #. type: textblock
14829 #: ../src/guestfs-actions.pod:4614 ../fish/guestfish-actions.pod:3106
14830 msgid ""
14831 "This command lets you mount C<file> (a filesystem image in a file) on a "
14832 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
14833 "mountpoint>."
14834 msgstr ""
14835
14836 # type: =head2
14837 #. type: =head2
14838 #: ../src/guestfs-actions.pod:4622
14839 msgid "guestfs_mount_options"
14840 msgstr ""
14841
14842 # type: verbatim
14843 #. type: verbatim
14844 #: ../src/guestfs-actions.pod:4624
14845 #, no-wrap
14846 msgid ""
14847 " int\n"
14848 " guestfs_mount_options (guestfs_h *g,\n"
14849 "                        const char *options,\n"
14850 "                        const char *device,\n"
14851 "                        const char *mountpoint);\n"
14852 "\n"
14853 msgstr ""
14854
14855 # type: textblock
14856 #. type: textblock
14857 #: ../src/guestfs-actions.pod:4630
14858 msgid ""
14859 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14860 "the mount options as for the L<mount(8)> I<-o> flag."
14861 msgstr ""
14862
14863 # type: textblock
14864 #. type: textblock
14865 #: ../src/guestfs-actions.pod:4634 ../fish/guestfish-actions.pod:3118
14866 msgid ""
14867 "If the C<options> parameter is an empty string, then no options are passed "
14868 "(all options default to whatever the filesystem uses)."
14869 msgstr ""
14870
14871 # type: textblock
14872 #. type: textblock
14873 #: ../src/guestfs-actions.pod:4640 ../src/guestfs-actions.pod:4654
14874 #: ../src/guestfs-actions.pod:4671
14875 msgid "(Added in 1.0.10)"
14876 msgstr ""
14877
14878 # type: =head2
14879 #. type: =head2
14880 #: ../src/guestfs-actions.pod:4642
14881 msgid "guestfs_mount_ro"
14882 msgstr ""
14883
14884 # type: verbatim
14885 #. type: verbatim
14886 #: ../src/guestfs-actions.pod:4644
14887 #, no-wrap
14888 msgid ""
14889 " int\n"
14890 " guestfs_mount_ro (guestfs_h *g,\n"
14891 "                   const char *device,\n"
14892 "                   const char *mountpoint);\n"
14893 "\n"
14894 msgstr ""
14895
14896 # type: textblock
14897 #. type: textblock
14898 #: ../src/guestfs-actions.pod:4649
14899 msgid ""
14900 "This is the same as the C<guestfs_mount> command, but it mounts the "
14901 "filesystem with the read-only (I<-o ro>) flag."
14902 msgstr ""
14903
14904 # type: =head2
14905 #. type: =head2
14906 #: ../src/guestfs-actions.pod:4656
14907 msgid "guestfs_mount_vfs"
14908 msgstr ""
14909
14910 # type: verbatim
14911 #. type: verbatim
14912 #: ../src/guestfs-actions.pod:4658
14913 #, no-wrap
14914 msgid ""
14915 " int\n"
14916 " guestfs_mount_vfs (guestfs_h *g,\n"
14917 "                    const char *options,\n"
14918 "                    const char *vfstype,\n"
14919 "                    const char *device,\n"
14920 "                    const char *mountpoint);\n"
14921 "\n"
14922 msgstr ""
14923
14924 # type: textblock
14925 #. type: textblock
14926 #: ../src/guestfs-actions.pod:4665
14927 msgid ""
14928 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14929 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
14930 "t> flags."
14931 msgstr ""
14932
14933 # type: =head2
14934 #. type: =head2
14935 #: ../src/guestfs-actions.pod:4673
14936 msgid "guestfs_mountpoints"
14937 msgstr ""
14938
14939 # type: verbatim
14940 #. type: verbatim
14941 #: ../src/guestfs-actions.pod:4675
14942 #, no-wrap
14943 msgid ""
14944 " char **\n"
14945 " guestfs_mountpoints (guestfs_h *g);\n"
14946 "\n"
14947 msgstr ""
14948
14949 # type: textblock
14950 #. type: textblock
14951 #: ../src/guestfs-actions.pod:4678
14952 msgid ""
14953 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
14954 "devices.  This one returns a hash table (map) of device name to directory "
14955 "where the device is mounted."
14956 msgstr ""
14957
14958 # type: =head2
14959 #. type: =head2
14960 #: ../src/guestfs-actions.pod:4690
14961 msgid "guestfs_mounts"
14962 msgstr ""
14963
14964 # type: verbatim
14965 #. type: verbatim
14966 #: ../src/guestfs-actions.pod:4692
14967 #, no-wrap
14968 msgid ""
14969 " char **\n"
14970 " guestfs_mounts (guestfs_h *g);\n"
14971 "\n"
14972 msgstr ""
14973
14974 # type: textblock
14975 #. type: textblock
14976 #: ../src/guestfs-actions.pod:4695 ../fish/guestfish-actions.pod:3149
14977 msgid ""
14978 "This returns the list of currently mounted filesystems.  It returns the list "
14979 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
14980 msgstr ""
14981
14982 # type: textblock
14983 #. type: textblock
14984 #: ../src/guestfs-actions.pod:4698 ../fish/guestfish-actions.pod:3152
14985 msgid "Some internal mounts are not shown."
14986 msgstr ""
14987
14988 # type: textblock
14989 #. type: textblock
14990 #: ../src/guestfs-actions.pod:4700
14991 msgid "See also: C<guestfs_mountpoints>"
14992 msgstr ""
14993
14994 # type: =head2
14995 #. type: =head2
14996 #: ../src/guestfs-actions.pod:4708
14997 msgid "guestfs_mv"
14998 msgstr ""
14999
15000 # type: verbatim
15001 #. type: verbatim
15002 #: ../src/guestfs-actions.pod:4710
15003 #, no-wrap
15004 msgid ""
15005 " int\n"
15006 " guestfs_mv (guestfs_h *g,\n"
15007 "             const char *src,\n"
15008 "             const char *dest);\n"
15009 "\n"
15010 msgstr ""
15011
15012 # type: textblock
15013 #. type: textblock
15014 #: ../src/guestfs-actions.pod:4715 ../fish/guestfish-actions.pod:3160
15015 msgid ""
15016 "This moves a file from C<src> to C<dest> where C<dest> is either a "
15017 "destination filename or destination directory."
15018 msgstr ""
15019
15020 # type: =head2
15021 #. type: =head2
15022 #: ../src/guestfs-actions.pod:4722
15023 msgid "guestfs_ntfs_3g_probe"
15024 msgstr ""
15025
15026 # type: verbatim
15027 #. type: verbatim
15028 #: ../src/guestfs-actions.pod:4724
15029 #, no-wrap
15030 msgid ""
15031 " int\n"
15032 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
15033 "                        int rw,\n"
15034 "                        const char *device);\n"
15035 "\n"
15036 msgstr ""
15037
15038 # type: textblock
15039 #. type: textblock
15040 #: ../src/guestfs-actions.pod:4729 ../fish/guestfish-actions.pod:3167
15041 msgid ""
15042 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
15043 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
15044 "write, and some cannot be mounted at all)."
15045 msgstr ""
15046
15047 # type: textblock
15048 #. type: textblock
15049 #: ../src/guestfs-actions.pod:4733 ../fish/guestfish-actions.pod:3171
15050 msgid ""
15051 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
15052 "can be mounted read-write.  Set it to false if you want to test if the "
15053 "volume can be mounted read-only."
15054 msgstr ""
15055
15056 # type: textblock
15057 #. type: textblock
15058 #: ../src/guestfs-actions.pod:4737 ../fish/guestfish-actions.pod:3175
15059 msgid ""
15060 "The return value is an integer which C<0> if the operation would succeed, or "
15061 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
15062 msgstr ""
15063
15064 # type: textblock
15065 #. type: textblock
15066 #: ../src/guestfs-actions.pod:4743
15067 msgid "(Added in 1.0.43)"
15068 msgstr ""
15069
15070 # type: =head2
15071 #. type: =head2
15072 #: ../src/guestfs-actions.pod:4745
15073 msgid "guestfs_ntfsresize"
15074 msgstr ""
15075
15076 # type: verbatim
15077 #. type: verbatim
15078 #: ../src/guestfs-actions.pod:4747
15079 #, no-wrap
15080 msgid ""
15081 " int\n"
15082 " guestfs_ntfsresize (guestfs_h *g,\n"
15083 "                     const char *device);\n"
15084 "\n"
15085 msgstr ""
15086
15087 # type: textblock
15088 #. type: textblock
15089 #: ../src/guestfs-actions.pod:4751 ../fish/guestfish-actions.pod:3183
15090 msgid ""
15091 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
15092 "size of the underlying device.  See also L<ntfsresize(8)>."
15093 msgstr ""
15094
15095 # type: =head2
15096 #. type: =head2
15097 #: ../src/guestfs-actions.pod:4759
15098 msgid "guestfs_ntfsresize_size"
15099 msgstr ""
15100
15101 # type: verbatim
15102 #. type: verbatim
15103 #: ../src/guestfs-actions.pod:4761
15104 #, no-wrap
15105 msgid ""
15106 " int\n"
15107 " guestfs_ntfsresize_size (guestfs_h *g,\n"
15108 "                          const char *device,\n"
15109 "                          int64_t size);\n"
15110 "\n"
15111 msgstr ""
15112
15113 # type: textblock
15114 #. type: textblock
15115 #: ../src/guestfs-actions.pod:4766
15116 msgid ""
15117 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
15118 "to specify the new size (in bytes) explicitly."
15119 msgstr ""
15120
15121 # type: textblock
15122 #. type: textblock
15123 #: ../src/guestfs-actions.pod:4771 ../src/guestfs-actions.pod:5207
15124 #: ../src/guestfs-actions.pod:5280 ../src/guestfs-actions.pod:5546
15125 #: ../src/guestfs-actions.pod:7113
15126 msgid "(Added in 1.3.14)"
15127 msgstr ""
15128
15129 # type: =head2
15130 #. type: =head2
15131 #: ../src/guestfs-actions.pod:4773
15132 msgid "guestfs_part_add"
15133 msgstr ""
15134
15135 # type: verbatim
15136 #. type: verbatim
15137 #: ../src/guestfs-actions.pod:4775
15138 #, no-wrap
15139 msgid ""
15140 " int\n"
15141 " guestfs_part_add (guestfs_h *g,\n"
15142 "                   const char *device,\n"
15143 "                   const char *prlogex,\n"
15144 "                   int64_t startsect,\n"
15145 "                   int64_t endsect);\n"
15146 "\n"
15147 msgstr ""
15148
15149 # type: textblock
15150 #. type: textblock
15151 #: ../src/guestfs-actions.pod:4782
15152 msgid ""
15153 "This command adds a partition to C<device>.  If there is no partition table "
15154 "on the device, call C<guestfs_part_init> first."
15155 msgstr ""
15156
15157 # type: textblock
15158 #. type: textblock
15159 #: ../src/guestfs-actions.pod:4785 ../fish/guestfish-actions.pod:3201
15160 msgid ""
15161 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
15162 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
15163 "C<logical>) and C<e> (or C<extended>) partition types."
15164 msgstr ""
15165
15166 # type: textblock
15167 #. type: textblock
15168 #: ../src/guestfs-actions.pod:4790 ../fish/guestfish-actions.pod:3206
15169 msgid ""
15170 "C<startsect> and C<endsect> are the start and end of the partition in "
15171 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
15172 "from the end of the disk (C<-1> is the last sector)."
15173 msgstr ""
15174
15175 # type: textblock
15176 #. type: textblock
15177 #: ../src/guestfs-actions.pod:4794
15178 msgid ""
15179 "Creating a partition which covers the whole disk is not so easy.  Use "
15180 "C<guestfs_part_disk> to do that."
15181 msgstr ""
15182
15183 # type: textblock
15184 #. type: textblock
15185 #: ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:4837
15186 #: ../src/guestfs-actions.pod:4890 ../src/guestfs-actions.pod:4968
15187 #: ../src/guestfs-actions.pod:5006 ../src/guestfs-actions.pod:5025
15188 #: ../src/guestfs-actions.pod:5065
15189 msgid "(Added in 1.0.78)"
15190 msgstr ""
15191
15192 # type: =head2
15193 #. type: =head2
15194 #: ../src/guestfs-actions.pod:4801
15195 msgid "guestfs_part_del"
15196 msgstr ""
15197
15198 # type: verbatim
15199 #. type: verbatim
15200 #: ../src/guestfs-actions.pod:4803
15201 #, no-wrap
15202 msgid ""
15203 " int\n"
15204 " guestfs_part_del (guestfs_h *g,\n"
15205 "                   const char *device,\n"
15206 "                   int partnum);\n"
15207 "\n"
15208 msgstr ""
15209
15210 # type: textblock
15211 #. type: textblock
15212 #: ../src/guestfs-actions.pod:4808 ../fish/guestfish-actions.pod:3217
15213 msgid "This command deletes the partition numbered C<partnum> on C<device>."
15214 msgstr ""
15215
15216 # type: textblock
15217 #. type: textblock
15218 #: ../src/guestfs-actions.pod:4810 ../fish/guestfish-actions.pod:3219
15219 msgid ""
15220 "Note that in the case of MBR partitioning, deleting an extended partition "
15221 "also deletes any logical partitions it contains."
15222 msgstr ""
15223
15224 # type: =head2
15225 #. type: =head2
15226 #: ../src/guestfs-actions.pod:4818
15227 msgid "guestfs_part_disk"
15228 msgstr ""
15229
15230 # type: verbatim
15231 #. type: verbatim
15232 #: ../src/guestfs-actions.pod:4820
15233 #, no-wrap
15234 msgid ""
15235 " int\n"
15236 " guestfs_part_disk (guestfs_h *g,\n"
15237 "                    const char *device,\n"
15238 "                    const char *parttype);\n"
15239 "\n"
15240 msgstr ""
15241
15242 # type: textblock
15243 #. type: textblock
15244 #: ../src/guestfs-actions.pod:4825
15245 msgid ""
15246 "This command is simply a combination of C<guestfs_part_init> followed by "
15247 "C<guestfs_part_add> to create a single primary partition covering the whole "
15248 "disk."
15249 msgstr ""
15250
15251 # type: textblock
15252 #. type: textblock
15253 #: ../src/guestfs-actions.pod:4829
15254 msgid ""
15255 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
15256 "possible values are described in C<guestfs_part_init>."
15257 msgstr ""
15258
15259 # type: =head2
15260 #. type: =head2
15261 #: ../src/guestfs-actions.pod:4839
15262 msgid "guestfs_part_get_bootable"
15263 msgstr ""
15264
15265 # type: verbatim
15266 #. type: verbatim
15267 #: ../src/guestfs-actions.pod:4841
15268 #, no-wrap
15269 msgid ""
15270 " int\n"
15271 " guestfs_part_get_bootable (guestfs_h *g,\n"
15272 "                            const char *device,\n"
15273 "                            int partnum);\n"
15274 "\n"
15275 msgstr ""
15276
15277 # type: textblock
15278 #. type: textblock
15279 #: ../src/guestfs-actions.pod:4846 ../fish/guestfish-actions.pod:3241
15280 msgid ""
15281 "This command returns true if the partition C<partnum> on C<device> has the "
15282 "bootable flag set."
15283 msgstr ""
15284
15285 # type: textblock
15286 #. type: textblock
15287 #: ../src/guestfs-actions.pod:4849
15288 msgid "See also C<guestfs_part_set_bootable>."
15289 msgstr ""
15290
15291 # type: =head2
15292 #. type: =head2
15293 #: ../src/guestfs-actions.pod:4855
15294 msgid "guestfs_part_get_mbr_id"
15295 msgstr ""
15296
15297 # type: verbatim
15298 #. type: verbatim
15299 #: ../src/guestfs-actions.pod:4857
15300 #, no-wrap
15301 msgid ""
15302 " int\n"
15303 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
15304 "                          const char *device,\n"
15305 "                          int partnum);\n"
15306 "\n"
15307 msgstr ""
15308
15309 # type: textblock
15310 #. type: textblock
15311 #: ../src/guestfs-actions.pod:4862 ../fish/guestfish-actions.pod:3250
15312 msgid ""
15313 "Returns the MBR type byte (also known as the ID byte) from the numbered "
15314 "partition C<partnum>."
15315 msgstr ""
15316
15317 # type: textblock
15318 #. type: textblock
15319 #: ../src/guestfs-actions.pod:4865 ../src/guestfs-actions.pod:5041
15320 msgid ""
15321 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
15322 "undefined results for other partition table types (see "
15323 "C<guestfs_part_get_parttype>)."
15324 msgstr ""
15325
15326 # type: =head2
15327 #. type: =head2
15328 #: ../src/guestfs-actions.pod:4873
15329 msgid "guestfs_part_get_parttype"
15330 msgstr ""
15331
15332 # type: verbatim
15333 #. type: verbatim
15334 #: ../src/guestfs-actions.pod:4875
15335 #, no-wrap
15336 msgid ""
15337 " char *\n"
15338 " guestfs_part_get_parttype (guestfs_h *g,\n"
15339 "                            const char *device);\n"
15340 "\n"
15341 msgstr ""
15342
15343 # type: textblock
15344 #. type: textblock
15345 #: ../src/guestfs-actions.pod:4879 ../fish/guestfish-actions.pod:3261
15346 msgid ""
15347 "This command examines the partition table on C<device> and returns the "
15348 "partition table type (format) being used."
15349 msgstr ""
15350
15351 # type: textblock
15352 #. type: textblock
15353 #: ../src/guestfs-actions.pod:4882
15354 msgid ""
15355 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
15356 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
15357 "possible, although unusual.  See C<guestfs_part_init> for a full list."
15358 msgstr ""
15359
15360 # type: =head2
15361 #. type: =head2
15362 #: ../src/guestfs-actions.pod:4892
15363 msgid "guestfs_part_init"
15364 msgstr ""
15365
15366 # type: verbatim
15367 #. type: verbatim
15368 #: ../src/guestfs-actions.pod:4894
15369 #, no-wrap
15370 msgid ""
15371 " int\n"
15372 " guestfs_part_init (guestfs_h *g,\n"
15373 "                    const char *device,\n"
15374 "                    const char *parttype);\n"
15375 "\n"
15376 msgstr ""
15377
15378 # type: textblock
15379 #. type: textblock
15380 #: ../src/guestfs-actions.pod:4899 ../fish/guestfish-actions.pod:3273
15381 msgid ""
15382 "This creates an empty partition table on C<device> of one of the partition "
15383 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
15384 "(for large disks)."
15385 msgstr ""
15386
15387 # type: textblock
15388 #. type: textblock
15389 #: ../src/guestfs-actions.pod:4903
15390 msgid ""
15391 "Initially there are no partitions.  Following this, you should call "
15392 "C<guestfs_part_add> for each partition required."
15393 msgstr ""
15394
15395 # type: textblock
15396 #. type: textblock
15397 #: ../src/guestfs-actions.pod:4906 ../fish/guestfish-actions.pod:3280
15398 msgid "Possible values for C<parttype> are:"
15399 msgstr ""
15400
15401 # type: =item
15402 #. type: =item
15403 #: ../src/guestfs-actions.pod:4910 ../fish/guestfish-actions.pod:3284
15404 msgid "B<efi> | B<gpt>"
15405 msgstr ""
15406
15407 # type: textblock
15408 #. type: textblock
15409 #: ../src/guestfs-actions.pod:4912 ../fish/guestfish-actions.pod:3286
15410 msgid "Intel EFI / GPT partition table."
15411 msgstr ""
15412
15413 # type: textblock
15414 #. type: textblock
15415 #: ../src/guestfs-actions.pod:4914 ../fish/guestfish-actions.pod:3288
15416 msgid ""
15417 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
15418 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
15419 "the C<mbr> format."
15420 msgstr ""
15421
15422 # type: =item
15423 #. type: =item
15424 #: ../src/guestfs-actions.pod:4918 ../fish/guestfish-actions.pod:3292
15425 msgid "B<mbr> | B<msdos>"
15426 msgstr ""
15427
15428 # type: textblock
15429 #. type: textblock
15430 #: ../src/guestfs-actions.pod:4920 ../fish/guestfish-actions.pod:3294
15431 msgid ""
15432 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
15433 "Windows.  This partition type will B<only> work for device sizes up to 2 "
15434 "TB.  For large disks we recommend using C<gpt>."
15435 msgstr ""
15436
15437 # type: textblock
15438 #. type: textblock
15439 #: ../src/guestfs-actions.pod:4927 ../fish/guestfish-actions.pod:3301
15440 msgid ""
15441 "Other partition table types that may work but are not supported include:"
15442 msgstr ""
15443
15444 # type: =item
15445 #. type: =item
15446 #: ../src/guestfs-actions.pod:4932 ../fish/guestfish-actions.pod:3306
15447 msgid "B<aix>"
15448 msgstr ""
15449
15450 # type: textblock
15451 #. type: textblock
15452 #: ../src/guestfs-actions.pod:4934 ../fish/guestfish-actions.pod:3308
15453 msgid "AIX disk labels."
15454 msgstr ""
15455
15456 # type: =item
15457 #. type: =item
15458 #: ../src/guestfs-actions.pod:4936 ../fish/guestfish-actions.pod:3310
15459 msgid "B<amiga> | B<rdb>"
15460 msgstr ""
15461
15462 # type: textblock
15463 #. type: textblock
15464 #: ../src/guestfs-actions.pod:4938 ../fish/guestfish-actions.pod:3312
15465 msgid "Amiga \"Rigid Disk Block\" format."
15466 msgstr ""
15467
15468 # type: =item
15469 #. type: =item
15470 #: ../src/guestfs-actions.pod:4940 ../fish/guestfish-actions.pod:3314
15471 msgid "B<bsd>"
15472 msgstr ""
15473
15474 # type: textblock
15475 #. type: textblock
15476 #: ../src/guestfs-actions.pod:4942 ../fish/guestfish-actions.pod:3316
15477 msgid "BSD disk labels."
15478 msgstr ""
15479
15480 # type: =item
15481 #. type: =item
15482 #: ../src/guestfs-actions.pod:4944 ../fish/guestfish-actions.pod:3318
15483 msgid "B<dasd>"
15484 msgstr ""
15485
15486 # type: textblock
15487 #. type: textblock
15488 #: ../src/guestfs-actions.pod:4946 ../fish/guestfish-actions.pod:3320
15489 msgid "DASD, used on IBM mainframes."
15490 msgstr ""
15491
15492 # type: =item
15493 #. type: =item
15494 #: ../src/guestfs-actions.pod:4948 ../fish/guestfish-actions.pod:3322
15495 msgid "B<dvh>"
15496 msgstr ""
15497
15498 # type: textblock
15499 #. type: textblock
15500 #: ../src/guestfs-actions.pod:4950 ../fish/guestfish-actions.pod:3324
15501 msgid "MIPS/SGI volumes."
15502 msgstr ""
15503
15504 # type: =item
15505 #. type: =item
15506 #: ../src/guestfs-actions.pod:4952 ../fish/guestfish-actions.pod:3326
15507 msgid "B<mac>"
15508 msgstr ""
15509
15510 # type: textblock
15511 #. type: textblock
15512 #: ../src/guestfs-actions.pod:4954 ../fish/guestfish-actions.pod:3328
15513 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
15514 msgstr ""
15515
15516 # type: =item
15517 #. type: =item
15518 #: ../src/guestfs-actions.pod:4956 ../fish/guestfish-actions.pod:3330
15519 msgid "B<pc98>"
15520 msgstr ""
15521
15522 # type: textblock
15523 #. type: textblock
15524 #: ../src/guestfs-actions.pod:4958 ../fish/guestfish-actions.pod:3332
15525 msgid "NEC PC-98 format, common in Japan apparently."
15526 msgstr ""
15527
15528 # type: =item
15529 #. type: =item
15530 #: ../src/guestfs-actions.pod:4960 ../fish/guestfish-actions.pod:3334
15531 msgid "B<sun>"
15532 msgstr ""
15533
15534 # type: textblock
15535 #. type: textblock
15536 #: ../src/guestfs-actions.pod:4962 ../fish/guestfish-actions.pod:3336
15537 msgid "Sun disk labels."
15538 msgstr ""
15539
15540 # type: =head2
15541 #. type: =head2
15542 #: ../src/guestfs-actions.pod:4970
15543 msgid "guestfs_part_list"
15544 msgstr ""
15545
15546 # type: verbatim
15547 #. type: verbatim
15548 #: ../src/guestfs-actions.pod:4972
15549 #, no-wrap
15550 msgid ""
15551 " struct guestfs_partition_list *\n"
15552 " guestfs_part_list (guestfs_h *g,\n"
15553 "                    const char *device);\n"
15554 "\n"
15555 msgstr ""
15556
15557 # type: textblock
15558 #. type: textblock
15559 #: ../src/guestfs-actions.pod:4976 ../fish/guestfish-actions.pod:3344
15560 msgid ""
15561 "This command parses the partition table on C<device> and returns the list of "
15562 "partitions found."
15563 msgstr ""
15564
15565 # type: textblock
15566 #. type: textblock
15567 #: ../src/guestfs-actions.pod:4979 ../fish/guestfish-actions.pod:3347
15568 msgid "The fields in the returned structure are:"
15569 msgstr ""
15570
15571 # type: =item
15572 #. type: =item
15573 #: ../src/guestfs-actions.pod:4983 ../fish/guestfish-actions.pod:3351
15574 msgid "B<part_num>"
15575 msgstr ""
15576
15577 # type: textblock
15578 #. type: textblock
15579 #: ../src/guestfs-actions.pod:4985 ../fish/guestfish-actions.pod:3353
15580 msgid "Partition number, counting from 1."
15581 msgstr ""
15582
15583 # type: =item
15584 #. type: =item
15585 #: ../src/guestfs-actions.pod:4987 ../fish/guestfish-actions.pod:3355
15586 msgid "B<part_start>"
15587 msgstr ""
15588
15589 # type: textblock
15590 #. type: textblock
15591 #: ../src/guestfs-actions.pod:4989
15592 msgid ""
15593 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
15594 "the device's sector size, see C<guestfs_blockdev_getss>."
15595 msgstr ""
15596
15597 # type: =item
15598 #. type: =item
15599 #: ../src/guestfs-actions.pod:4992 ../fish/guestfish-actions.pod:3360
15600 msgid "B<part_end>"
15601 msgstr ""
15602
15603 # type: textblock
15604 #. type: textblock
15605 #: ../src/guestfs-actions.pod:4994 ../fish/guestfish-actions.pod:3362
15606 msgid "End of the partition in bytes."
15607 msgstr ""
15608
15609 # type: =item
15610 #. type: =item
15611 #: ../src/guestfs-actions.pod:4996 ../fish/guestfish-actions.pod:3364
15612 msgid "B<part_size>"
15613 msgstr ""
15614
15615 # type: textblock
15616 #. type: textblock
15617 #: ../src/guestfs-actions.pod:4998 ../fish/guestfish-actions.pod:3366
15618 msgid "Size of the partition in bytes."
15619 msgstr ""
15620
15621 # type: textblock
15622 #. type: textblock
15623 #: ../src/guestfs-actions.pod:5002
15624 msgid ""
15625 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
15626 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
15627 "use>."
15628 msgstr ""
15629
15630 # type: =head2
15631 #. type: =head2
15632 #: ../src/guestfs-actions.pod:5008
15633 msgid "guestfs_part_set_bootable"
15634 msgstr ""
15635
15636 # type: verbatim
15637 #. type: verbatim
15638 #: ../src/guestfs-actions.pod:5010
15639 #, no-wrap
15640 msgid ""
15641 " int\n"
15642 " guestfs_part_set_bootable (guestfs_h *g,\n"
15643 "                            const char *device,\n"
15644 "                            int partnum,\n"
15645 "                            int bootable);\n"
15646 "\n"
15647 msgstr ""
15648
15649 # type: textblock
15650 #. type: textblock
15651 #: ../src/guestfs-actions.pod:5016 ../fish/guestfish-actions.pod:3374
15652 msgid ""
15653 "This sets the bootable flag on partition numbered C<partnum> on device "
15654 "C<device>.  Note that partitions are numbered from 1."
15655 msgstr ""
15656
15657 # type: textblock
15658 #. type: textblock
15659 #: ../src/guestfs-actions.pod:5019 ../fish/guestfish-actions.pod:3377
15660 msgid ""
15661 "The bootable flag is used by some operating systems (notably Windows) to "
15662 "determine which partition to boot from.  It is by no means universally "
15663 "recognized."
15664 msgstr ""
15665
15666 # type: =head2
15667 #. type: =head2
15668 #: ../src/guestfs-actions.pod:5027
15669 msgid "guestfs_part_set_mbr_id"
15670 msgstr ""
15671
15672 # type: verbatim
15673 #. type: verbatim
15674 #: ../src/guestfs-actions.pod:5029
15675 #, no-wrap
15676 msgid ""
15677 " int\n"
15678 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
15679 "                          const char *device,\n"
15680 "                          int partnum,\n"
15681 "                          int idbyte);\n"
15682 "\n"
15683 msgstr ""
15684
15685 # type: textblock
15686 #. type: textblock
15687 #: ../src/guestfs-actions.pod:5035 ../fish/guestfish-actions.pod:3385
15688 msgid ""
15689 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
15690 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
15691 "documentation are in fact hexadecimal numbers, but usually documented "
15692 "without any leading \"0x\" which might be confusing."
15693 msgstr ""
15694
15695 # type: =head2
15696 #. type: =head2
15697 #: ../src/guestfs-actions.pod:5049
15698 msgid "guestfs_part_set_name"
15699 msgstr ""
15700
15701 # type: verbatim
15702 #. type: verbatim
15703 #: ../src/guestfs-actions.pod:5051
15704 #, no-wrap
15705 msgid ""
15706 " int\n"
15707 " guestfs_part_set_name (guestfs_h *g,\n"
15708 "                        const char *device,\n"
15709 "                        int partnum,\n"
15710 "                        const char *name);\n"
15711 "\n"
15712 msgstr ""
15713
15714 # type: textblock
15715 #. type: textblock
15716 #: ../src/guestfs-actions.pod:5057 ../fish/guestfish-actions.pod:3399
15717 msgid ""
15718 "This sets the partition name on partition numbered C<partnum> on device "
15719 "C<device>.  Note that partitions are numbered from 1."
15720 msgstr ""
15721
15722 # type: textblock
15723 #. type: textblock
15724 #: ../src/guestfs-actions.pod:5060 ../fish/guestfish-actions.pod:3402
15725 msgid ""
15726 "The partition name can only be set on certain types of partition table.  "
15727 "This works on C<gpt> but not on C<mbr> partitions."
15728 msgstr ""
15729
15730 # type: =head2
15731 #. type: =head2
15732 #: ../src/guestfs-actions.pod:5067
15733 msgid "guestfs_part_to_dev"
15734 msgstr ""
15735
15736 # type: verbatim
15737 #. type: verbatim
15738 #: ../src/guestfs-actions.pod:5069
15739 #, no-wrap
15740 msgid ""
15741 " char *\n"
15742 " guestfs_part_to_dev (guestfs_h *g,\n"
15743 "                      const char *partition);\n"
15744 "\n"
15745 msgstr ""
15746
15747 # type: textblock
15748 #. type: textblock
15749 #: ../src/guestfs-actions.pod:5073 ../fish/guestfish-actions.pod:3409
15750 msgid ""
15751 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
15752 "partition number, returning the device name (eg. \"/dev/sdb\")."
15753 msgstr ""
15754
15755 # type: textblock
15756 #. type: textblock
15757 #: ../src/guestfs-actions.pod:5077
15758 msgid ""
15759 "The named partition must exist, for example as a string returned from "
15760 "C<guestfs_list_partitions>."
15761 msgstr ""
15762
15763 # type: =head2
15764 #. type: =head2
15765 #: ../src/guestfs-actions.pod:5085
15766 msgid "guestfs_ping_daemon"
15767 msgstr ""
15768
15769 # type: verbatim
15770 #. type: verbatim
15771 #: ../src/guestfs-actions.pod:5087
15772 #, no-wrap
15773 msgid ""
15774 " int\n"
15775 " guestfs_ping_daemon (guestfs_h *g);\n"
15776 "\n"
15777 msgstr ""
15778
15779 # type: textblock
15780 #. type: textblock
15781 #: ../src/guestfs-actions.pod:5090 ../fish/guestfish-actions.pod:3420
15782 msgid ""
15783 "This is a test probe into the guestfs daemon running inside the qemu "
15784 "subprocess.  Calling this function checks that the daemon responds to the "
15785 "ping message, without affecting the daemon or attached block device(s) in "
15786 "any other way."
15787 msgstr ""
15788
15789 # type: =head2
15790 #. type: =head2
15791 #: ../src/guestfs-actions.pod:5099
15792 msgid "guestfs_pread"
15793 msgstr ""
15794
15795 # type: verbatim
15796 #. type: verbatim
15797 #: ../src/guestfs-actions.pod:5101
15798 #, no-wrap
15799 msgid ""
15800 " char *\n"
15801 " guestfs_pread (guestfs_h *g,\n"
15802 "                const char *path,\n"
15803 "                int count,\n"
15804 "                int64_t offset,\n"
15805 "                size_t *size_r);\n"
15806 "\n"
15807 msgstr ""
15808
15809 # type: textblock
15810 #. type: textblock
15811 #: ../src/guestfs-actions.pod:5108 ../fish/guestfish-actions.pod:3429
15812 msgid ""
15813 "This command lets you read part of a file.  It reads C<count> bytes of the "
15814 "file, starting at C<offset>, from file C<path>."
15815 msgstr ""
15816
15817 # type: textblock
15818 #. type: textblock
15819 #: ../src/guestfs-actions.pod:5111 ../src/guestfs-actions.pod:5137
15820 #: ../fish/guestfish-actions.pod:3432 ../fish/guestfish-actions.pod:3447
15821 msgid ""
15822 "This may read fewer bytes than requested.  For further details see the "
15823 "L<pread(2)> system call."
15824 msgstr ""
15825
15826 # type: textblock
15827 #. type: textblock
15828 #: ../src/guestfs-actions.pod:5114
15829 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
15830 msgstr ""
15831
15832 # type: =head2
15833 #. type: =head2
15834 #: ../src/guestfs-actions.pod:5125
15835 msgid "guestfs_pread_device"
15836 msgstr ""
15837
15838 # type: verbatim
15839 #. type: verbatim
15840 #: ../src/guestfs-actions.pod:5127
15841 #, no-wrap
15842 msgid ""
15843 " char *\n"
15844 " guestfs_pread_device (guestfs_h *g,\n"
15845 "                       const char *device,\n"
15846 "                       int count,\n"
15847 "                       int64_t offset,\n"
15848 "                       size_t *size_r);\n"
15849 "\n"
15850 msgstr ""
15851
15852 # type: textblock
15853 #. type: textblock
15854 #: ../src/guestfs-actions.pod:5134 ../fish/guestfish-actions.pod:3444
15855 msgid ""
15856 "This command lets you read part of a file.  It reads C<count> bytes of "
15857 "C<device>, starting at C<offset>."
15858 msgstr ""
15859
15860 # type: textblock
15861 #. type: textblock
15862 #: ../src/guestfs-actions.pod:5140
15863 msgid "See also C<guestfs_pread>."
15864 msgstr ""
15865
15866 # type: textblock
15867 #. type: textblock
15868 #: ../src/guestfs-actions.pod:5149
15869 msgid "(Added in 1.5.21)"
15870 msgstr ""
15871
15872 # type: =head2
15873 #. type: =head2
15874 #: ../src/guestfs-actions.pod:5151
15875 msgid "guestfs_pvcreate"
15876 msgstr ""
15877
15878 # type: verbatim
15879 #. type: verbatim
15880 #: ../src/guestfs-actions.pod:5153
15881 #, no-wrap
15882 msgid ""
15883 " int\n"
15884 " guestfs_pvcreate (guestfs_h *g,\n"
15885 "                   const char *device);\n"
15886 "\n"
15887 msgstr ""
15888
15889 # type: textblock
15890 #. type: textblock
15891 #: ../src/guestfs-actions.pod:5157 ../fish/guestfish-actions.pod:3459
15892 msgid ""
15893 "This creates an LVM physical volume on the named C<device>, where C<device> "
15894 "should usually be a partition name such as C</dev/sda1>."
15895 msgstr ""
15896
15897 # type: =head2
15898 #. type: =head2
15899 #: ../src/guestfs-actions.pod:5165
15900 msgid "guestfs_pvremove"
15901 msgstr ""
15902
15903 # type: verbatim
15904 #. type: verbatim
15905 #: ../src/guestfs-actions.pod:5167
15906 #, no-wrap
15907 msgid ""
15908 " int\n"
15909 " guestfs_pvremove (guestfs_h *g,\n"
15910 "                   const char *device);\n"
15911 "\n"
15912 msgstr ""
15913
15914 # type: textblock
15915 #. type: textblock
15916 #: ../src/guestfs-actions.pod:5171 ../fish/guestfish-actions.pod:3467
15917 msgid ""
15918 "This wipes a physical volume C<device> so that LVM will no longer recognise "
15919 "it."
15920 msgstr ""
15921
15922 # type: textblock
15923 #. type: textblock
15924 #: ../src/guestfs-actions.pod:5174 ../fish/guestfish-actions.pod:3470
15925 msgid ""
15926 "The implementation uses the C<pvremove> command which refuses to wipe "
15927 "physical volumes that contain any volume groups, so you have to remove those "
15928 "first."
15929 msgstr ""
15930
15931 # type: =head2
15932 #. type: =head2
15933 #: ../src/guestfs-actions.pod:5182
15934 msgid "guestfs_pvresize"
15935 msgstr ""
15936
15937 # type: verbatim
15938 #. type: verbatim
15939 #: ../src/guestfs-actions.pod:5184
15940 #, no-wrap
15941 msgid ""
15942 " int\n"
15943 " guestfs_pvresize (guestfs_h *g,\n"
15944 "                   const char *device);\n"
15945 "\n"
15946 msgstr ""
15947
15948 # type: textblock
15949 #. type: textblock
15950 #: ../src/guestfs-actions.pod:5188 ../fish/guestfish-actions.pod:3478
15951 msgid ""
15952 "This resizes (expands or shrinks) an existing LVM physical volume to match "
15953 "the new size of the underlying device."
15954 msgstr ""
15955
15956 # type: =head2
15957 #. type: =head2
15958 #: ../src/guestfs-actions.pod:5195
15959 msgid "guestfs_pvresize_size"
15960 msgstr ""
15961
15962 # type: verbatim
15963 #. type: verbatim
15964 #: ../src/guestfs-actions.pod:5197
15965 #, no-wrap
15966 msgid ""
15967 " int\n"
15968 " guestfs_pvresize_size (guestfs_h *g,\n"
15969 "                        const char *device,\n"
15970 "                        int64_t size);\n"
15971 "\n"
15972 msgstr ""
15973
15974 # type: textblock
15975 #. type: textblock
15976 #: ../src/guestfs-actions.pod:5202
15977 msgid ""
15978 "This command is the same as C<guestfs_pvresize> except that it allows you to "
15979 "specify the new size (in bytes) explicitly."
15980 msgstr ""
15981
15982 # type: =head2
15983 #. type: =head2
15984 #: ../src/guestfs-actions.pod:5209
15985 msgid "guestfs_pvs"
15986 msgstr ""
15987
15988 # type: verbatim
15989 #. type: verbatim
15990 #: ../src/guestfs-actions.pod:5211
15991 #, no-wrap
15992 msgid ""
15993 " char **\n"
15994 " guestfs_pvs (guestfs_h *g);\n"
15995 "\n"
15996 msgstr ""
15997
15998 # type: textblock
15999 #. type: textblock
16000 #: ../src/guestfs-actions.pod:5214 ../fish/guestfish-actions.pod:3492
16001 msgid ""
16002 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16003 "(8)> command."
16004 msgstr ""
16005
16006 # type: textblock
16007 #. type: textblock
16008 #: ../src/guestfs-actions.pod:5217 ../fish/guestfish-actions.pod:3495
16009 msgid ""
16010 "This returns a list of just the device names that contain PVs (eg. C</dev/"
16011 "sda2>)."
16012 msgstr ""
16013
16014 # type: textblock
16015 #. type: textblock
16016 #: ../src/guestfs-actions.pod:5220
16017 msgid "See also C<guestfs_pvs_full>."
16018 msgstr ""
16019
16020 # type: =head2
16021 #. type: =head2
16022 #: ../src/guestfs-actions.pod:5228
16023 msgid "guestfs_pvs_full"
16024 msgstr ""
16025
16026 # type: verbatim
16027 #. type: verbatim
16028 #: ../src/guestfs-actions.pod:5230
16029 #, no-wrap
16030 msgid ""
16031 " struct guestfs_lvm_pv_list *\n"
16032 " guestfs_pvs_full (guestfs_h *g);\n"
16033 "\n"
16034 msgstr ""
16035
16036 # type: textblock
16037 #. type: textblock
16038 #: ../src/guestfs-actions.pod:5233 ../fish/guestfish-actions.pod:3504
16039 msgid ""
16040 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16041 "(8)> command.  The \"full\" version includes all fields."
16042 msgstr ""
16043
16044 # type: textblock
16045 #. type: textblock
16046 #: ../src/guestfs-actions.pod:5236
16047 msgid ""
16048 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
16049 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
16050 msgstr ""
16051
16052 # type: =head2
16053 #. type: =head2
16054 #: ../src/guestfs-actions.pod:5242
16055 msgid "guestfs_pvuuid"
16056 msgstr ""
16057
16058 # type: verbatim
16059 #. type: verbatim
16060 #: ../src/guestfs-actions.pod:5244
16061 #, no-wrap
16062 msgid ""
16063 " char *\n"
16064 " guestfs_pvuuid (guestfs_h *g,\n"
16065 "                 const char *device);\n"
16066 "\n"
16067 msgstr ""
16068
16069 # type: textblock
16070 #. type: textblock
16071 #: ../src/guestfs-actions.pod:5248 ../fish/guestfish-actions.pod:3511
16072 msgid "This command returns the UUID of the LVM PV C<device>."
16073 msgstr ""
16074
16075 # type: =head2
16076 #. type: =head2
16077 #: ../src/guestfs-actions.pod:5255
16078 msgid "guestfs_pwrite"
16079 msgstr ""
16080
16081 # type: verbatim
16082 #. type: verbatim
16083 #: ../src/guestfs-actions.pod:5257
16084 #, no-wrap
16085 msgid ""
16086 " int\n"
16087 " guestfs_pwrite (guestfs_h *g,\n"
16088 "                 const char *path,\n"
16089 "                 const char *content,\n"
16090 "                 size_t content_size,\n"
16091 "                 int64_t offset);\n"
16092 "\n"
16093 msgstr ""
16094
16095 # type: textblock
16096 #. type: textblock
16097 #: ../src/guestfs-actions.pod:5264 ../fish/guestfish-actions.pod:3517
16098 msgid ""
16099 "This command writes to part of a file.  It writes the data buffer C<content> "
16100 "to the file C<path> starting at offset C<offset>."
16101 msgstr ""
16102
16103 # type: textblock
16104 #. type: textblock
16105 #: ../src/guestfs-actions.pod:5267 ../fish/guestfish-actions.pod:3520
16106 msgid ""
16107 "This command implements the L<pwrite(2)> system call, and like that system "
16108 "call it may not write the full data requested.  The return value is the "
16109 "number of bytes that were actually written to the file.  This could even be "
16110 "0, although short writes are unlikely for regular files in ordinary "
16111 "circumstances."
16112 msgstr ""
16113
16114 # type: textblock
16115 #. type: textblock
16116 #: ../src/guestfs-actions.pod:5273
16117 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
16118 msgstr ""
16119
16120 # type: =head2
16121 #. type: =head2
16122 #: ../src/guestfs-actions.pod:5282
16123 msgid "guestfs_pwrite_device"
16124 msgstr ""
16125
16126 # type: verbatim
16127 #. type: verbatim
16128 #: ../src/guestfs-actions.pod:5284
16129 #, no-wrap
16130 msgid ""
16131 " int\n"
16132 " guestfs_pwrite_device (guestfs_h *g,\n"
16133 "                        const char *device,\n"
16134 "                        const char *content,\n"
16135 "                        size_t content_size,\n"
16136 "                        int64_t offset);\n"
16137 "\n"
16138 msgstr ""
16139
16140 # type: textblock
16141 #. type: textblock
16142 #: ../src/guestfs-actions.pod:5291 ../fish/guestfish-actions.pod:3535
16143 msgid ""
16144 "This command writes to part of a device.  It writes the data buffer "
16145 "C<content> to C<device> starting at offset C<offset>."
16146 msgstr ""
16147
16148 # type: textblock
16149 #. type: textblock
16150 #: ../src/guestfs-actions.pod:5294 ../fish/guestfish-actions.pod:3538
16151 msgid ""
16152 "This command implements the L<pwrite(2)> system call, and like that system "
16153 "call it may not write the full data requested (although short writes to disk "
16154 "devices and partitions are probably impossible with standard Linux kernels)."
16155 msgstr ""
16156
16157 # type: textblock
16158 #. type: textblock
16159 #: ../src/guestfs-actions.pod:5299
16160 msgid "See also C<guestfs_pwrite>."
16161 msgstr ""
16162
16163 # type: textblock
16164 #. type: textblock
16165 #: ../src/guestfs-actions.pod:5306
16166 msgid "(Added in 1.5.20)"
16167 msgstr ""
16168
16169 # type: =head2
16170 #. type: =head2
16171 #: ../src/guestfs-actions.pod:5308
16172 msgid "guestfs_read_file"
16173 msgstr ""
16174
16175 # type: verbatim
16176 #. type: verbatim
16177 #: ../src/guestfs-actions.pod:5310
16178 #, no-wrap
16179 msgid ""
16180 " char *\n"
16181 " guestfs_read_file (guestfs_h *g,\n"
16182 "                    const char *path,\n"
16183 "                    size_t *size_r);\n"
16184 "\n"
16185 msgstr ""
16186
16187 # type: textblock
16188 #. type: textblock
16189 #: ../src/guestfs-actions.pod:5315 ../fish/guestfish-actions.pod:3552
16190 msgid "This calls returns the contents of the file C<path> as a buffer."
16191 msgstr ""
16192
16193 # type: textblock
16194 #. type: textblock
16195 #: ../src/guestfs-actions.pod:5318
16196 msgid ""
16197 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
16198 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
16199 "function is limited in the total size of file that can be handled."
16200 msgstr ""
16201
16202 # type: textblock
16203 #. type: textblock
16204 #: ../src/guestfs-actions.pod:5330
16205 msgid "(Added in 1.0.63)"
16206 msgstr ""
16207
16208 # type: =head2
16209 #. type: =head2
16210 #: ../src/guestfs-actions.pod:5332
16211 msgid "guestfs_read_lines"
16212 msgstr ""
16213
16214 # type: verbatim
16215 #. type: verbatim
16216 #: ../src/guestfs-actions.pod:5334
16217 #, no-wrap
16218 msgid ""
16219 " char **\n"
16220 " guestfs_read_lines (guestfs_h *g,\n"
16221 "                     const char *path);\n"
16222 "\n"
16223 msgstr ""
16224
16225 # type: textblock
16226 #. type: textblock
16227 #: ../src/guestfs-actions.pod:5340 ../fish/guestfish-actions.pod:3569
16228 msgid ""
16229 "The file contents are returned as a list of lines.  Trailing C<LF> and "
16230 "C<CRLF> character sequences are I<not> returned."
16231 msgstr ""
16232
16233 # type: textblock
16234 #. type: textblock
16235 #: ../src/guestfs-actions.pod:5343
16236 msgid ""
16237 "Note that this function cannot correctly handle binary files (specifically, "
16238 "files containing C<\\0> character which is treated as end of line).  For "
16239 "those you need to use the C<guestfs_read_file> function which has a more "
16240 "complex interface."
16241 msgstr ""
16242
16243 # type: =head2
16244 #. type: =head2
16245 #: ../src/guestfs-actions.pod:5354
16246 msgid "guestfs_readdir"
16247 msgstr ""
16248
16249 # type: verbatim
16250 #. type: verbatim
16251 #: ../src/guestfs-actions.pod:5356
16252 #, no-wrap
16253 msgid ""
16254 " struct guestfs_dirent_list *\n"
16255 " guestfs_readdir (guestfs_h *g,\n"
16256 "                  const char *dir);\n"
16257 "\n"
16258 msgstr ""
16259
16260 # type: textblock
16261 #. type: textblock
16262 #: ../src/guestfs-actions.pod:5360 ../fish/guestfish-actions.pod:3581
16263 msgid "This returns the list of directory entries in directory C<dir>."
16264 msgstr ""
16265
16266 # type: textblock
16267 #. type: textblock
16268 #: ../src/guestfs-actions.pod:5362 ../fish/guestfish-actions.pod:3583
16269 msgid ""
16270 "All entries in the directory are returned, including C<.> and C<..>.  The "
16271 "entries are I<not> sorted, but returned in the same order as the underlying "
16272 "filesystem."
16273 msgstr ""
16274
16275 # type: textblock
16276 #. type: textblock
16277 #: ../src/guestfs-actions.pod:5366 ../fish/guestfish-actions.pod:3587
16278 msgid ""
16279 "Also this call returns basic file type information about each file.  The "
16280 "C<ftyp> field will contain one of the following characters:"
16281 msgstr ""
16282
16283 # type: =item
16284 #. type: =item
16285 #: ../src/guestfs-actions.pod:5371 ../fish/guestfish-actions.pod:3592
16286 msgid "'b'"
16287 msgstr ""
16288
16289 # type: textblock
16290 #. type: textblock
16291 #: ../src/guestfs-actions.pod:5373 ../fish/guestfish-actions.pod:3594
16292 msgid "Block special"
16293 msgstr ""
16294
16295 # type: =item
16296 #. type: =item
16297 #: ../src/guestfs-actions.pod:5375 ../fish/guestfish-actions.pod:3596
16298 msgid "'c'"
16299 msgstr ""
16300
16301 # type: textblock
16302 #. type: textblock
16303 #: ../src/guestfs-actions.pod:5377 ../fish/guestfish-actions.pod:3598
16304 msgid "Char special"
16305 msgstr ""
16306
16307 # type: =item
16308 #. type: =item
16309 #: ../src/guestfs-actions.pod:5379 ../fish/guestfish-actions.pod:3600
16310 msgid "'d'"
16311 msgstr ""
16312
16313 # type: textblock
16314 #. type: textblock
16315 #: ../src/guestfs-actions.pod:5381 ../fish/guestfish-actions.pod:3602
16316 msgid "Directory"
16317 msgstr ""
16318
16319 # type: =item
16320 #. type: =item
16321 #: ../src/guestfs-actions.pod:5383 ../fish/guestfish-actions.pod:3604
16322 msgid "'f'"
16323 msgstr ""
16324
16325 # type: textblock
16326 #. type: textblock
16327 #: ../src/guestfs-actions.pod:5385 ../fish/guestfish-actions.pod:3606
16328 msgid "FIFO (named pipe)"
16329 msgstr ""
16330
16331 # type: =item
16332 #. type: =item
16333 #: ../src/guestfs-actions.pod:5387 ../fish/guestfish-actions.pod:3608
16334 msgid "'l'"
16335 msgstr ""
16336
16337 # type: textblock
16338 #. type: textblock
16339 #: ../src/guestfs-actions.pod:5389 ../fish/guestfish-actions.pod:3610
16340 msgid "Symbolic link"
16341 msgstr ""
16342
16343 # type: =item
16344 #. type: =item
16345 #: ../src/guestfs-actions.pod:5391 ../fish/guestfish-actions.pod:3612
16346 msgid "'r'"
16347 msgstr ""
16348
16349 # type: textblock
16350 #. type: textblock
16351 #: ../src/guestfs-actions.pod:5393 ../fish/guestfish-actions.pod:3614
16352 msgid "Regular file"
16353 msgstr ""
16354
16355 # type: =item
16356 #. type: =item
16357 #: ../src/guestfs-actions.pod:5395 ../fish/guestfish-actions.pod:3616
16358 msgid "'s'"
16359 msgstr ""
16360
16361 # type: textblock
16362 #. type: textblock
16363 #: ../src/guestfs-actions.pod:5397 ../fish/guestfish-actions.pod:3618
16364 msgid "Socket"
16365 msgstr ""
16366
16367 # type: =item
16368 #. type: =item
16369 #: ../src/guestfs-actions.pod:5399 ../fish/guestfish-actions.pod:3620
16370 msgid "'u'"
16371 msgstr ""
16372
16373 # type: textblock
16374 #. type: textblock
16375 #: ../src/guestfs-actions.pod:5401 ../fish/guestfish-actions.pod:3622
16376 msgid "Unknown file type"
16377 msgstr ""
16378
16379 # type: =item
16380 #. type: =item
16381 #: ../src/guestfs-actions.pod:5403 ../fish/guestfish-actions.pod:3624
16382 msgid "'?'"
16383 msgstr ""
16384
16385 # type: textblock
16386 #. type: textblock
16387 #: ../src/guestfs-actions.pod:5405 ../fish/guestfish-actions.pod:3626
16388 msgid ""
16389 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
16390 msgstr ""
16391
16392 # type: textblock
16393 #. type: textblock
16394 #: ../src/guestfs-actions.pod:5410
16395 msgid ""
16396 "This function is primarily intended for use by programs.  To get a simple "
16397 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
16398 "consumption, use C<guestfs_ll>."
16399 msgstr ""
16400
16401 # type: textblock
16402 #. type: textblock
16403 #: ../src/guestfs-actions.pod:5414
16404 msgid ""
16405 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
16406 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
16407 msgstr ""
16408
16409 # type: =head2
16410 #. type: =head2
16411 #: ../src/guestfs-actions.pod:5420
16412 msgid "guestfs_readlink"
16413 msgstr ""
16414
16415 # type: verbatim
16416 #. type: verbatim
16417 #: ../src/guestfs-actions.pod:5422
16418 #, no-wrap
16419 msgid ""
16420 " char *\n"
16421 " guestfs_readlink (guestfs_h *g,\n"
16422 "                   const char *path);\n"
16423 "\n"
16424 msgstr ""
16425
16426 # type: textblock
16427 #. type: textblock
16428 #: ../src/guestfs-actions.pod:5426 ../fish/guestfish-actions.pod:3639
16429 msgid "This command reads the target of a symbolic link."
16430 msgstr ""
16431
16432 # type: =head2
16433 #. type: =head2
16434 #: ../src/guestfs-actions.pod:5433
16435 msgid "guestfs_readlinklist"
16436 msgstr ""
16437
16438 # type: verbatim
16439 #. type: verbatim
16440 #: ../src/guestfs-actions.pod:5435
16441 #, no-wrap
16442 msgid ""
16443 " char **\n"
16444 " guestfs_readlinklist (guestfs_h *g,\n"
16445 "                       const char *path,\n"
16446 "                       char *const *names);\n"
16447 "\n"
16448 msgstr ""
16449
16450 # type: textblock
16451 #. type: textblock
16452 #: ../src/guestfs-actions.pod:5440 ../fish/guestfish-actions.pod:3645
16453 msgid ""
16454 "This call allows you to do a C<readlink> operation on multiple files, where "
16455 "all files are in the directory C<path>.  C<names> is the list of files from "
16456 "this directory."
16457 msgstr ""
16458
16459 # type: textblock
16460 #. type: textblock
16461 #: ../src/guestfs-actions.pod:5444 ../fish/guestfish-actions.pod:3649
16462 msgid ""
16463 "On return you get a list of strings, with a one-to-one correspondence to the "
16464 "C<names> list.  Each string is the value of the symbolic link."
16465 msgstr ""
16466
16467 # type: textblock
16468 #. type: textblock
16469 #: ../src/guestfs-actions.pod:5448 ../fish/guestfish-actions.pod:3653
16470 msgid ""
16471 "If the C<readlink(2)> operation fails on any name, then the corresponding "
16472 "result string is the empty string C<\"\">.  However the whole operation is "
16473 "completed even if there were C<readlink(2)> errors, and so you can call this "
16474 "function with names where you don't know if they are symbolic links already "
16475 "(albeit slightly less efficient)."
16476 msgstr ""
16477
16478 # type: textblock
16479 #. type: textblock
16480 #: ../src/guestfs-actions.pod:5455 ../fish/guestfish-actions.pod:3660
16481 msgid ""
16482 "This call is intended for programs that want to efficiently list a directory "
16483 "contents without making many round-trips.  Very long directory listings "
16484 "might cause the protocol message size to be exceeded, causing this call to "
16485 "fail.  The caller must split up such requests into smaller groups of names."
16486 msgstr ""
16487
16488 # type: =head2
16489 #. type: =head2
16490 #: ../src/guestfs-actions.pod:5468
16491 msgid "guestfs_realpath"
16492 msgstr ""
16493
16494 # type: verbatim
16495 #. type: verbatim
16496 #: ../src/guestfs-actions.pod:5470
16497 #, no-wrap
16498 msgid ""
16499 " char *\n"
16500 " guestfs_realpath (guestfs_h *g,\n"
16501 "                   const char *path);\n"
16502 "\n"
16503 msgstr ""
16504
16505 # type: textblock
16506 #. type: textblock
16507 #: ../src/guestfs-actions.pod:5474 ../fish/guestfish-actions.pod:3671
16508 msgid ""
16509 "Return the canonicalized absolute pathname of C<path>.  The returned path "
16510 "has no C<.>, C<..> or symbolic link path elements."
16511 msgstr ""
16512
16513 # type: =head2
16514 #. type: =head2
16515 #: ../src/guestfs-actions.pod:5482
16516 msgid "guestfs_removexattr"
16517 msgstr ""
16518
16519 # type: verbatim
16520 #. type: verbatim
16521 #: ../src/guestfs-actions.pod:5484
16522 #, no-wrap
16523 msgid ""
16524 " int\n"
16525 " guestfs_removexattr (guestfs_h *g,\n"
16526 "                      const char *xattr,\n"
16527 "                      const char *path);\n"
16528 "\n"
16529 msgstr ""
16530
16531 # type: textblock
16532 #. type: textblock
16533 #: ../src/guestfs-actions.pod:5489 ../fish/guestfish-actions.pod:3678
16534 msgid ""
16535 "This call removes the extended attribute named C<xattr> of the file C<path>."
16536 msgstr ""
16537
16538 # type: textblock
16539 #. type: textblock
16540 #: ../src/guestfs-actions.pod:5492
16541 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
16542 msgstr ""
16543
16544 # type: =head2
16545 #. type: =head2
16546 #: ../src/guestfs-actions.pod:5498
16547 msgid "guestfs_resize2fs"
16548 msgstr ""
16549
16550 # type: verbatim
16551 #. type: verbatim
16552 #: ../src/guestfs-actions.pod:5500
16553 #, no-wrap
16554 msgid ""
16555 " int\n"
16556 " guestfs_resize2fs (guestfs_h *g,\n"
16557 "                    const char *device);\n"
16558 "\n"
16559 msgstr ""
16560
16561 # type: textblock
16562 #. type: textblock
16563 #: ../src/guestfs-actions.pod:5504 ../fish/guestfish-actions.pod:3687
16564 msgid ""
16565 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
16566 "underlying device."
16567 msgstr ""
16568
16569 # type: textblock
16570 #. type: textblock
16571 #: ../src/guestfs-actions.pod:5507
16572 msgid ""
16573 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
16574 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
16575 "sometimes gives an error about this and sometimes not.  In any case, it is "
16576 "always safe to call C<guestfs_e2fsck_f> before calling this function."
16577 msgstr ""
16578
16579 #. type: =head2
16580 #: ../src/guestfs-actions.pod:5517
16581 msgid "guestfs_resize2fs_M"
16582 msgstr ""
16583
16584 #. type: verbatim
16585 #: ../src/guestfs-actions.pod:5519
16586 #, no-wrap
16587 msgid ""
16588 " int\n"
16589 " guestfs_resize2fs_M (guestfs_h *g,\n"
16590 "                      const char *device);\n"
16591 "\n"
16592 msgstr ""
16593
16594 #. type: textblock
16595 #: ../src/guestfs-actions.pod:5523
16596 msgid ""
16597 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
16598 "resized to its minimum size.  This works like the C<-M> option to the "
16599 "C<resize2fs> command."
16600 msgstr ""
16601
16602 #. type: textblock
16603 #: ../src/guestfs-actions.pod:5527
16604 msgid ""
16605 "To get the resulting size of the filesystem you should call "
16606 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
16607 "These two numbers, multiplied together, give the resulting size of the "
16608 "minimal filesystem in bytes."
16609 msgstr ""
16610
16611 # type: =head2
16612 #. type: =head2
16613 #: ../src/guestfs-actions.pod:5534
16614 msgid "guestfs_resize2fs_size"
16615 msgstr ""
16616
16617 # type: verbatim
16618 #. type: verbatim
16619 #: ../src/guestfs-actions.pod:5536
16620 #, no-wrap
16621 msgid ""
16622 " int\n"
16623 " guestfs_resize2fs_size (guestfs_h *g,\n"
16624 "                         const char *device,\n"
16625 "                         int64_t size);\n"
16626 "\n"
16627 msgstr ""
16628
16629 # type: textblock
16630 #. type: textblock
16631 #: ../src/guestfs-actions.pod:5541
16632 msgid ""
16633 "This command is the same as C<guestfs_resize2fs> except that it allows you "
16634 "to specify the new size (in bytes) explicitly."
16635 msgstr ""
16636
16637 # type: =head2
16638 #. type: =head2
16639 #: ../src/guestfs-actions.pod:5548
16640 msgid "guestfs_rm"
16641 msgstr ""
16642
16643 # type: verbatim
16644 #. type: verbatim
16645 #: ../src/guestfs-actions.pod:5550
16646 #, no-wrap
16647 msgid ""
16648 " int\n"
16649 " guestfs_rm (guestfs_h *g,\n"
16650 "             const char *path);\n"
16651 "\n"
16652 msgstr ""
16653
16654 # type: textblock
16655 #. type: textblock
16656 #: ../src/guestfs-actions.pod:5554 ../fish/guestfish-actions.pod:3720
16657 msgid "Remove the single file C<path>."
16658 msgstr ""
16659
16660 # type: =head2
16661 #. type: =head2
16662 #: ../src/guestfs-actions.pod:5560
16663 msgid "guestfs_rm_rf"
16664 msgstr ""
16665
16666 # type: verbatim
16667 #. type: verbatim
16668 #: ../src/guestfs-actions.pod:5562
16669 #, no-wrap
16670 msgid ""
16671 " int\n"
16672 " guestfs_rm_rf (guestfs_h *g,\n"
16673 "                const char *path);\n"
16674 "\n"
16675 msgstr ""
16676
16677 # type: textblock
16678 #. type: textblock
16679 #: ../src/guestfs-actions.pod:5566 ../fish/guestfish-actions.pod:3726
16680 msgid ""
16681 "Remove the file or directory C<path>, recursively removing the contents if "
16682 "its a directory.  This is like the C<rm -rf> shell command."
16683 msgstr ""
16684
16685 # type: =head2
16686 #. type: =head2
16687 #: ../src/guestfs-actions.pod:5574
16688 msgid "guestfs_rmdir"
16689 msgstr ""
16690
16691 # type: verbatim
16692 #. type: verbatim
16693 #: ../src/guestfs-actions.pod:5576
16694 #, no-wrap
16695 msgid ""
16696 " int\n"
16697 " guestfs_rmdir (guestfs_h *g,\n"
16698 "                const char *path);\n"
16699 "\n"
16700 msgstr ""
16701
16702 # type: textblock
16703 #. type: textblock
16704 #: ../src/guestfs-actions.pod:5580 ../fish/guestfish-actions.pod:3734
16705 msgid "Remove the single directory C<path>."
16706 msgstr ""
16707
16708 # type: =head2
16709 #. type: =head2
16710 #: ../src/guestfs-actions.pod:5586
16711 msgid "guestfs_rmmountpoint"
16712 msgstr ""
16713
16714 # type: verbatim
16715 #. type: verbatim
16716 #: ../src/guestfs-actions.pod:5588
16717 #, no-wrap
16718 msgid ""
16719 " int\n"
16720 " guestfs_rmmountpoint (guestfs_h *g,\n"
16721 "                       const char *exemptpath);\n"
16722 "\n"
16723 msgstr ""
16724
16725 # type: textblock
16726 #. type: textblock
16727 #: ../src/guestfs-actions.pod:5592
16728 msgid ""
16729 "This calls removes a mountpoint that was previously created with "
16730 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
16731 msgstr ""
16732
16733 # type: =head2
16734 #. type: =head2
16735 #: ../src/guestfs-actions.pod:5600
16736 msgid "guestfs_scrub_device"
16737 msgstr ""
16738
16739 # type: verbatim
16740 #. type: verbatim
16741 #: ../src/guestfs-actions.pod:5602
16742 #, no-wrap
16743 msgid ""
16744 " int\n"
16745 " guestfs_scrub_device (guestfs_h *g,\n"
16746 "                       const char *device);\n"
16747 "\n"
16748 msgstr ""
16749
16750 # type: textblock
16751 #. type: textblock
16752 #: ../src/guestfs-actions.pod:5606 ../fish/guestfish-actions.pod:3748
16753 msgid ""
16754 "This command writes patterns over C<device> to make data retrieval more "
16755 "difficult."
16756 msgstr ""
16757
16758 # type: textblock
16759 #. type: textblock
16760 #: ../src/guestfs-actions.pod:5609 ../src/guestfs-actions.pod:5630
16761 #: ../src/guestfs-actions.pod:5649 ../fish/guestfish-actions.pod:3751
16762 #: ../fish/guestfish-actions.pod:3766 ../fish/guestfish-actions.pod:3779
16763 msgid ""
16764 "It is an interface to the L<scrub(1)> program.  See that manual page for "
16765 "more details."
16766 msgstr ""
16767
16768 # type: textblock
16769 #. type: textblock
16770 #: ../src/guestfs-actions.pod:5617 ../src/guestfs-actions.pod:5635
16771 #: ../src/guestfs-actions.pod:5654
16772 msgid "(Added in 1.0.52)"
16773 msgstr ""
16774
16775 # type: =head2
16776 #. type: =head2
16777 #: ../src/guestfs-actions.pod:5619
16778 msgid "guestfs_scrub_file"
16779 msgstr ""
16780
16781 # type: verbatim
16782 #. type: verbatim
16783 #: ../src/guestfs-actions.pod:5621
16784 #, no-wrap
16785 msgid ""
16786 " int\n"
16787 " guestfs_scrub_file (guestfs_h *g,\n"
16788 "                     const char *file);\n"
16789 "\n"
16790 msgstr ""
16791
16792 # type: textblock
16793 #. type: textblock
16794 #: ../src/guestfs-actions.pod:5625 ../fish/guestfish-actions.pod:3761
16795 msgid ""
16796 "This command writes patterns over a file to make data retrieval more "
16797 "difficult."
16798 msgstr ""
16799
16800 # type: textblock
16801 #. type: textblock
16802 #: ../src/guestfs-actions.pod:5628 ../fish/guestfish-actions.pod:3764
16803 msgid "The file is I<removed> after scrubbing."
16804 msgstr ""
16805
16806 # type: =head2
16807 #. type: =head2
16808 #: ../src/guestfs-actions.pod:5637
16809 msgid "guestfs_scrub_freespace"
16810 msgstr ""
16811
16812 # type: verbatim
16813 #. type: verbatim
16814 #: ../src/guestfs-actions.pod:5639
16815 #, no-wrap
16816 msgid ""
16817 " int\n"
16818 " guestfs_scrub_freespace (guestfs_h *g,\n"
16819 "                          const char *dir);\n"
16820 "\n"
16821 msgstr ""
16822
16823 # type: textblock
16824 #. type: textblock
16825 #: ../src/guestfs-actions.pod:5643
16826 msgid ""
16827 "This command creates the directory C<dir> and then fills it with files until "
16828 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
16829 "and deletes them.  The intention is to scrub any free space on the partition "
16830 "containing C<dir>."
16831 msgstr ""
16832
16833 # type: =head2
16834 #. type: =head2
16835 #: ../src/guestfs-actions.pod:5656
16836 msgid "guestfs_set_append"
16837 msgstr ""
16838
16839 # type: verbatim
16840 #. type: verbatim
16841 #: ../src/guestfs-actions.pod:5658
16842 #, no-wrap
16843 msgid ""
16844 " int\n"
16845 " guestfs_set_append (guestfs_h *g,\n"
16846 "                     const char *append);\n"
16847 "\n"
16848 msgstr ""
16849
16850 # type: textblock
16851 #. type: textblock
16852 #: ../src/guestfs-actions.pod:5662 ../fish/guestfish-actions.pod:3788
16853 msgid ""
16854 "This function is used to add additional options to the guest kernel command "
16855 "line."
16856 msgstr ""
16857
16858 # type: textblock
16859 #. type: textblock
16860 #: ../src/guestfs-actions.pod:5665 ../fish/guestfish-actions.pod:3791
16861 msgid ""
16862 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
16863 "environment variable."
16864 msgstr ""
16865
16866 # type: textblock
16867 #. type: textblock
16868 #: ../src/guestfs-actions.pod:5668 ../fish/guestfish-actions.pod:3794
16869 msgid ""
16870 "Setting C<append> to C<NULL> means I<no> additional options are passed "
16871 "(libguestfs always adds a few of its own)."
16872 msgstr ""
16873
16874 #. type: =head2
16875 #: ../src/guestfs-actions.pod:5675
16876 msgid "guestfs_set_attach_method"
16877 msgstr ""
16878
16879 #. type: verbatim
16880 #: ../src/guestfs-actions.pod:5677
16881 #, no-wrap
16882 msgid ""
16883 " int\n"
16884 " guestfs_set_attach_method (guestfs_h *g,\n"
16885 "                            const char *attachmethod);\n"
16886 "\n"
16887 msgstr ""
16888
16889 #. type: textblock
16890 #: ../src/guestfs-actions.pod:5681 ../fish/guestfish-actions.pod:3803
16891 msgid ""
16892 "Set the method that libguestfs uses to connect to the back end guestfsd "
16893 "daemon.  Possible methods are:"
16894 msgstr ""
16895
16896 #. type: textblock
16897 #: ../src/guestfs-actions.pod:5688 ../fish/guestfish-actions.pod:3810
16898 msgid ""
16899 "Launch an appliance and connect to it.  This is the ordinary method and the "
16900 "default."
16901 msgstr ""
16902
16903 #. type: =item
16904 #: ../src/guestfs-actions.pod:5691 ../fish/guestfish-actions.pod:3813
16905 msgid "C<unix:I<path>>"
16906 msgstr ""
16907
16908 #. type: textblock
16909 #: ../src/guestfs-actions.pod:5693 ../fish/guestfish-actions.pod:3815
16910 msgid "Connect to the Unix domain socket I<path>."
16911 msgstr ""
16912
16913 #. type: textblock
16914 #: ../src/guestfs-actions.pod:5695 ../fish/guestfish-actions.pod:3817
16915 msgid ""
16916 "This method lets you connect to an existing daemon or (using virtio-serial) "
16917 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
16918 "RUNNING DAEMONS>."
16919 msgstr ""
16920
16921 # type: =head2
16922 #. type: =head2
16923 #: ../src/guestfs-actions.pod:5703
16924 msgid "guestfs_set_autosync"
16925 msgstr ""
16926
16927 # type: verbatim
16928 #. type: verbatim
16929 #: ../src/guestfs-actions.pod:5705
16930 #, no-wrap
16931 msgid ""
16932 " int\n"
16933 " guestfs_set_autosync (guestfs_h *g,\n"
16934 "                       int autosync);\n"
16935 "\n"
16936 msgstr ""
16937
16938 #. type: textblock
16939 #: ../src/guestfs-actions.pod:5709 ../fish/guestfish-actions.pod:3829
16940 msgid ""
16941 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
16942 "effort attempt to make filesystems consistent and synchronized when the "
16943 "handle is closed (also if the program exits without closing handles)."
16944 msgstr ""
16945
16946 # type: textblock
16947 #. type: textblock
16948 #: ../src/guestfs-actions.pod:5714 ../fish/guestfish-actions.pod:3834
16949 msgid ""
16950 "This is enabled by default (since libguestfs 1.5.24, previously it was "
16951 "disabled by default)."
16952 msgstr ""
16953
16954 # type: =head2
16955 #. type: =head2
16956 #: ../src/guestfs-actions.pod:5721
16957 msgid "guestfs_set_direct"
16958 msgstr ""
16959
16960 # type: verbatim
16961 #. type: verbatim
16962 #: ../src/guestfs-actions.pod:5723
16963 #, no-wrap
16964 msgid ""
16965 " int\n"
16966 " guestfs_set_direct (guestfs_h *g,\n"
16967 "                     int direct);\n"
16968 "\n"
16969 msgstr ""
16970
16971 # type: textblock
16972 #. type: textblock
16973 #: ../src/guestfs-actions.pod:5727 ../fish/guestfish-actions.pod:3843
16974 msgid ""
16975 "If the direct appliance mode flag is enabled, then stdin and stdout are "
16976 "passed directly through to the appliance once it is launched."
16977 msgstr ""
16978
16979 # type: textblock
16980 #. type: textblock
16981 #: ../src/guestfs-actions.pod:5731
16982 msgid ""
16983 "One consequence of this is that log messages aren't caught by the library "
16984 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
16985 "stdout."
16986 msgstr ""
16987
16988 # type: textblock
16989 #. type: textblock
16990 #: ../src/guestfs-actions.pod:5735 ../fish/guestfish-actions.pod:3851
16991 msgid "You probably don't want to use this unless you know what you are doing."
16992 msgstr ""
16993
16994 # type: textblock
16995 #. type: textblock
16996 #: ../src/guestfs-actions.pod:5738 ../fish/guestfish-actions.pod:3854
16997 msgid "The default is disabled."
16998 msgstr ""
16999
17000 # type: =head2
17001 #. type: =head2
17002 #: ../src/guestfs-actions.pod:5744
17003 msgid "guestfs_set_e2label"
17004 msgstr ""
17005
17006 # type: verbatim
17007 #. type: verbatim
17008 #: ../src/guestfs-actions.pod:5746
17009 #, no-wrap
17010 msgid ""
17011 " int\n"
17012 " guestfs_set_e2label (guestfs_h *g,\n"
17013 "                      const char *device,\n"
17014 "                      const char *label);\n"
17015 "\n"
17016 msgstr ""
17017
17018 # type: textblock
17019 #. type: textblock
17020 #: ../src/guestfs-actions.pod:5751 ../fish/guestfish-actions.pod:3860
17021 msgid ""
17022 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
17023 "C<label>.  Filesystem labels are limited to 16 characters."
17024 msgstr ""
17025
17026 # type: textblock
17027 #. type: textblock
17028 #: ../src/guestfs-actions.pod:5755
17029 msgid ""
17030 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
17031 "the existing label on a filesystem."
17032 msgstr ""
17033
17034 # type: =head2
17035 #. type: =head2
17036 #: ../src/guestfs-actions.pod:5762
17037 msgid "guestfs_set_e2uuid"
17038 msgstr ""
17039
17040 # type: verbatim
17041 #. type: verbatim
17042 #: ../src/guestfs-actions.pod:5764
17043 #, no-wrap
17044 msgid ""
17045 " int\n"
17046 " guestfs_set_e2uuid (guestfs_h *g,\n"
17047 "                     const char *device,\n"
17048 "                     const char *uuid);\n"
17049 "\n"
17050 msgstr ""
17051
17052 # type: textblock
17053 #. type: textblock
17054 #: ../src/guestfs-actions.pod:5769 ../fish/guestfish-actions.pod:3871
17055 msgid ""
17056 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
17057 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
17058 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
17059 msgstr ""
17060
17061 # type: textblock
17062 #. type: textblock
17063 #: ../src/guestfs-actions.pod:5774
17064 msgid ""
17065 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
17066 "the existing UUID of a filesystem."
17067 msgstr ""
17068
17069 # type: =head2
17070 #. type: =head2
17071 #: ../src/guestfs-actions.pod:5781
17072 msgid "guestfs_set_memsize"
17073 msgstr ""
17074
17075 # type: verbatim
17076 #. type: verbatim
17077 #: ../src/guestfs-actions.pod:5783
17078 #, no-wrap
17079 msgid ""
17080 " int\n"
17081 " guestfs_set_memsize (guestfs_h *g,\n"
17082 "                      int memsize);\n"
17083 "\n"
17084 msgstr ""
17085
17086 # type: textblock
17087 #. type: textblock
17088 #: ../src/guestfs-actions.pod:5787
17089 msgid ""
17090 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
17091 "This only has any effect if called before C<guestfs_launch>."
17092 msgstr ""
17093
17094 # type: textblock
17095 #. type: textblock
17096 #: ../src/guestfs-actions.pod:5791 ../fish/guestfish-actions.pod:3889
17097 msgid ""
17098 "You can also change this by setting the environment variable "
17099 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
17100 msgstr ""
17101
17102 # type: =head2
17103 #. type: =head2
17104 #: ../src/guestfs-actions.pod:5802
17105 msgid "guestfs_set_network"
17106 msgstr ""
17107
17108 # type: verbatim
17109 #. type: verbatim
17110 #: ../src/guestfs-actions.pod:5804
17111 #, no-wrap
17112 msgid ""
17113 " int\n"
17114 " guestfs_set_network (guestfs_h *g,\n"
17115 "                      int network);\n"
17116 "\n"
17117 msgstr ""
17118
17119 # type: textblock
17120 #. type: textblock
17121 #: ../src/guestfs-actions.pod:5808 ../fish/guestfish-actions.pod:3902
17122 msgid ""
17123 "If C<network> is true, then the network is enabled in the libguestfs "
17124 "appliance.  The default is false."
17125 msgstr ""
17126
17127 # type: textblock
17128 #. type: textblock
17129 #: ../src/guestfs-actions.pod:5811 ../fish/guestfish-actions.pod:3905
17130 msgid ""
17131 "This affects whether commands are able to access the network (see L<guestfs"
17132 "(3)/RUNNING COMMANDS>)."
17133 msgstr ""
17134
17135 # type: textblock
17136 #. type: textblock
17137 #: ../src/guestfs-actions.pod:5814
17138 msgid ""
17139 "You must call this before calling C<guestfs_launch>, otherwise it has no "
17140 "effect."
17141 msgstr ""
17142
17143 # type: =head2
17144 #. type: =head2
17145 #: ../src/guestfs-actions.pod:5821
17146 msgid "guestfs_set_path"
17147 msgstr ""
17148
17149 # type: verbatim
17150 #. type: verbatim
17151 #: ../src/guestfs-actions.pod:5823
17152 #, no-wrap
17153 msgid ""
17154 " int\n"
17155 " guestfs_set_path (guestfs_h *g,\n"
17156 "                   const char *searchpath);\n"
17157 "\n"
17158 msgstr ""
17159
17160 # type: textblock
17161 #. type: textblock
17162 #: ../src/guestfs-actions.pod:5827 ../fish/guestfish-actions.pod:3917
17163 msgid "Set the path that libguestfs searches for kernel and initrd.img."
17164 msgstr ""
17165
17166 # type: textblock
17167 #. type: textblock
17168 #: ../src/guestfs-actions.pod:5829 ../fish/guestfish-actions.pod:3919
17169 msgid ""
17170 "The default is C<$libdir/guestfs> unless overridden by setting "
17171 "C<LIBGUESTFS_PATH> environment variable."
17172 msgstr ""
17173
17174 # type: textblock
17175 #. type: textblock
17176 #: ../src/guestfs-actions.pod:5832 ../fish/guestfish-actions.pod:3922
17177 msgid "Setting C<path> to C<NULL> restores the default path."
17178 msgstr ""
17179
17180 # type: =head2
17181 #. type: =head2
17182 #: ../src/guestfs-actions.pod:5838
17183 msgid "guestfs_set_qemu"
17184 msgstr ""
17185
17186 # type: verbatim
17187 #. type: verbatim
17188 #: ../src/guestfs-actions.pod:5840
17189 #, no-wrap
17190 msgid ""
17191 " int\n"
17192 " guestfs_set_qemu (guestfs_h *g,\n"
17193 "                   const char *qemu);\n"
17194 "\n"
17195 msgstr ""
17196
17197 # type: textblock
17198 #. type: textblock
17199 #: ../src/guestfs-actions.pod:5844 ../fish/guestfish-actions.pod:3930
17200 msgid "Set the qemu binary that we will use."
17201 msgstr ""
17202
17203 # type: textblock
17204 #. type: textblock
17205 #: ../src/guestfs-actions.pod:5846 ../fish/guestfish-actions.pod:3932
17206 msgid ""
17207 "The default is chosen when the library was compiled by the configure script."
17208 msgstr ""
17209
17210 # type: textblock
17211 #. type: textblock
17212 #: ../src/guestfs-actions.pod:5849 ../fish/guestfish-actions.pod:3935
17213 msgid ""
17214 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
17215 "variable."
17216 msgstr ""
17217
17218 # type: textblock
17219 #. type: textblock
17220 #: ../src/guestfs-actions.pod:5852 ../fish/guestfish-actions.pod:3938
17221 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
17222 msgstr ""
17223
17224 # type: textblock
17225 #. type: textblock
17226 #: ../src/guestfs-actions.pod:5854 ../fish/guestfish-actions.pod:3940
17227 msgid ""
17228 "Note that you should call this function as early as possible after creating "
17229 "the handle.  This is because some pre-launch operations depend on testing "
17230 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
17231 "don't retest features, and so you might see inconsistent results.  Using the "
17232 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
17233 "the qemu binary at the same time as the handle is created."
17234 msgstr ""
17235
17236 # type: =head2
17237 #. type: =head2
17238 #: ../src/guestfs-actions.pod:5866
17239 msgid "guestfs_set_recovery_proc"
17240 msgstr ""
17241
17242 # type: verbatim
17243 #. type: verbatim
17244 #: ../src/guestfs-actions.pod:5868
17245 #, no-wrap
17246 msgid ""
17247 " int\n"
17248 " guestfs_set_recovery_proc (guestfs_h *g,\n"
17249 "                            int recoveryproc);\n"
17250 "\n"
17251 msgstr ""
17252
17253 # type: textblock
17254 #. type: textblock
17255 #: ../src/guestfs-actions.pod:5872
17256 msgid ""
17257 "If this is called with the parameter C<false> then C<guestfs_launch> does "
17258 "not create a recovery process.  The purpose of the recovery process is to "
17259 "stop runaway qemu processes in the case where the main program aborts "
17260 "abruptly."
17261 msgstr ""
17262
17263 # type: textblock
17264 #. type: textblock
17265 #: ../src/guestfs-actions.pod:5877
17266 msgid ""
17267 "This only has any effect if called before C<guestfs_launch>, and the default "
17268 "is true."
17269 msgstr ""
17270
17271 # type: textblock
17272 #. type: textblock
17273 #: ../src/guestfs-actions.pod:5880 ../fish/guestfish-actions.pod:3962
17274 msgid ""
17275 "About the only time when you would want to disable this is if the main "
17276 "process will fork itself into the background (\"daemonize\" itself).  In "
17277 "this case the recovery process thinks that the main program has disappeared "
17278 "and so kills qemu, which is not very helpful."
17279 msgstr ""
17280
17281 # type: =head2
17282 #. type: =head2
17283 #: ../src/guestfs-actions.pod:5890
17284 msgid "guestfs_set_selinux"
17285 msgstr ""
17286
17287 # type: verbatim
17288 #. type: verbatim
17289 #: ../src/guestfs-actions.pod:5892
17290 #, no-wrap
17291 msgid ""
17292 " int\n"
17293 " guestfs_set_selinux (guestfs_h *g,\n"
17294 "                      int selinux);\n"
17295 "\n"
17296 msgstr ""
17297
17298 # type: textblock
17299 #. type: textblock
17300 #: ../src/guestfs-actions.pod:5896 ../fish/guestfish-actions.pod:3974
17301 msgid ""
17302 "This sets the selinux flag that is passed to the appliance at boot time.  "
17303 "The default is C<selinux=0> (disabled)."
17304 msgstr ""
17305
17306 # type: textblock
17307 #. type: textblock
17308 #: ../src/guestfs-actions.pod:5899 ../fish/guestfish-actions.pod:3977
17309 msgid ""
17310 "Note that if SELinux is enabled, it is always in Permissive mode "
17311 "(C<enforcing=0>)."
17312 msgstr ""
17313
17314 # type: =head2
17315 #. type: =head2
17316 #: ../src/guestfs-actions.pod:5909
17317 msgid "guestfs_set_trace"
17318 msgstr ""
17319
17320 # type: verbatim
17321 #. type: verbatim
17322 #: ../src/guestfs-actions.pod:5911
17323 #, no-wrap
17324 msgid ""
17325 " int\n"
17326 " guestfs_set_trace (guestfs_h *g,\n"
17327 "                    int trace);\n"
17328 "\n"
17329 msgstr ""
17330
17331 # type: textblock
17332 #. type: textblock
17333 #: ../src/guestfs-actions.pod:5915 ../fish/guestfish-actions.pod:3989
17334 msgid ""
17335 "If the command trace flag is set to 1, then commands are printed on stderr "
17336 "before they are executed in a format which is very similar to the one used "
17337 "by guestfish.  In other words, you can run a program with this enabled, and "
17338 "you will get out a script which you can feed to guestfish to perform the "
17339 "same set of actions."
17340 msgstr ""
17341
17342 # type: textblock
17343 #. type: textblock
17344 #: ../src/guestfs-actions.pod:5922 ../fish/guestfish-actions.pod:3996
17345 msgid ""
17346 "If you want to trace C API calls into libguestfs (and other libraries) then "
17347 "possibly a better way is to use the external ltrace(1) command."
17348 msgstr ""
17349
17350 # type: textblock
17351 #. type: textblock
17352 #: ../src/guestfs-actions.pod:5926 ../fish/guestfish-actions.pod:4000
17353 msgid ""
17354 "Command traces are disabled unless the environment variable "
17355 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
17356 msgstr ""
17357
17358 # type: =head2
17359 #. type: =head2
17360 #: ../src/guestfs-actions.pod:5933
17361 msgid "guestfs_set_verbose"
17362 msgstr ""
17363
17364 # type: verbatim
17365 #. type: verbatim
17366 #: ../src/guestfs-actions.pod:5935
17367 #, no-wrap
17368 msgid ""
17369 " int\n"
17370 " guestfs_set_verbose (guestfs_h *g,\n"
17371 "                      int verbose);\n"
17372 "\n"
17373 msgstr ""
17374
17375 # type: textblock
17376 #. type: textblock
17377 #: ../src/guestfs-actions.pod:5939 ../fish/guestfish-actions.pod:4009
17378 msgid "If C<verbose> is true, this turns on verbose messages (to C<stderr>)."
17379 msgstr ""
17380
17381 # type: textblock
17382 #. type: textblock
17383 #: ../src/guestfs-actions.pod:5941 ../fish/guestfish-actions.pod:4011
17384 msgid ""
17385 "Verbose messages are disabled unless the environment variable "
17386 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
17387 msgstr ""
17388
17389 # type: =head2
17390 #. type: =head2
17391 #: ../src/guestfs-actions.pod:5948
17392 msgid "guestfs_setcon"
17393 msgstr ""
17394
17395 # type: verbatim
17396 #. type: verbatim
17397 #: ../src/guestfs-actions.pod:5950
17398 #, no-wrap
17399 msgid ""
17400 " int\n"
17401 " guestfs_setcon (guestfs_h *g,\n"
17402 "                 const char *context);\n"
17403 "\n"
17404 msgstr ""
17405
17406 # type: textblock
17407 #. type: textblock
17408 #: ../src/guestfs-actions.pod:5954 ../fish/guestfish-actions.pod:4018
17409 msgid ""
17410 "This sets the SELinux security context of the daemon to the string "
17411 "C<context>."
17412 msgstr ""
17413
17414 # type: textblock
17415 #. type: textblock
17416 #: ../src/guestfs-actions.pod:5957 ../fish/guestfish-actions.pod:4021
17417 msgid "See the documentation about SELINUX in L<guestfs(3)>."
17418 msgstr ""
17419
17420 # type: =head2
17421 #. type: =head2
17422 #: ../src/guestfs-actions.pod:5963
17423 msgid "guestfs_setxattr"
17424 msgstr ""
17425
17426 # type: verbatim
17427 #. type: verbatim
17428 #: ../src/guestfs-actions.pod:5965
17429 #, no-wrap
17430 msgid ""
17431 " int\n"
17432 " guestfs_setxattr (guestfs_h *g,\n"
17433 "                   const char *xattr,\n"
17434 "                   const char *val,\n"
17435 "                   int vallen,\n"
17436 "                   const char *path);\n"
17437 "\n"
17438 msgstr ""
17439
17440 # type: textblock
17441 #. type: textblock
17442 #: ../src/guestfs-actions.pod:5972 ../fish/guestfish-actions.pod:4027
17443 msgid ""
17444 "This call sets the extended attribute named C<xattr> of the file C<path> to "
17445 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
17446 msgstr ""
17447
17448 # type: textblock
17449 #. type: textblock
17450 #: ../src/guestfs-actions.pod:5976
17451 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
17452 msgstr ""
17453
17454 # type: =head2
17455 #. type: =head2
17456 #: ../src/guestfs-actions.pod:5982
17457 msgid "guestfs_sfdisk"
17458 msgstr ""
17459
17460 # type: verbatim
17461 #. type: verbatim
17462 #: ../src/guestfs-actions.pod:5984
17463 #, no-wrap
17464 msgid ""
17465 " int\n"
17466 " guestfs_sfdisk (guestfs_h *g,\n"
17467 "                 const char *device,\n"
17468 "                 int cyls,\n"
17469 "                 int heads,\n"
17470 "                 int sectors,\n"
17471 "                 char *const *lines);\n"
17472 "\n"
17473 msgstr ""
17474
17475 # type: textblock
17476 #. type: textblock
17477 #: ../src/guestfs-actions.pod:5992 ../fish/guestfish-actions.pod:4037
17478 msgid ""
17479 "This is a direct interface to the L<sfdisk(8)> program for creating "
17480 "partitions on block devices."
17481 msgstr ""
17482
17483 # type: textblock
17484 #. type: textblock
17485 #: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4040
17486 msgid "C<device> should be a block device, for example C</dev/sda>."
17487 msgstr ""
17488
17489 # type: textblock
17490 #. type: textblock
17491 #: ../src/guestfs-actions.pod:5997 ../fish/guestfish-actions.pod:4042
17492 msgid ""
17493 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
17494 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
17495 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
17496 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
17497 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
17498 "the kernel) cannot work out the right geometry and you will need to tell it."
17499 msgstr ""
17500
17501 # type: textblock
17502 #. type: textblock
17503 #: ../src/guestfs-actions.pod:6005 ../fish/guestfish-actions.pod:4050
17504 msgid ""
17505 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
17506 "refer to the L<sfdisk(8)> manpage."
17507 msgstr ""
17508
17509 # type: textblock
17510 #. type: textblock
17511 #: ../src/guestfs-actions.pod:6008 ../fish/guestfish-actions.pod:4053
17512 msgid ""
17513 "To create a single partition occupying the whole disk, you would pass "
17514 "C<lines> as a single element list, when the single element being the string "
17515 "C<,> (comma)."
17516 msgstr ""
17517
17518 # type: textblock
17519 #. type: textblock
17520 #: ../src/guestfs-actions.pod:6012
17521 msgid ""
17522 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
17523 msgstr ""
17524
17525 # type: =head2
17526 #. type: =head2
17527 #: ../src/guestfs-actions.pod:6022
17528 msgid "guestfs_sfdiskM"
17529 msgstr ""
17530
17531 # type: verbatim
17532 #. type: verbatim
17533 #: ../src/guestfs-actions.pod:6024
17534 #, no-wrap
17535 msgid ""
17536 " int\n"
17537 " guestfs_sfdiskM (guestfs_h *g,\n"
17538 "                  const char *device,\n"
17539 "                  char *const *lines);\n"
17540 "\n"
17541 msgstr ""
17542
17543 # type: textblock
17544 #. type: textblock
17545 #: ../src/guestfs-actions.pod:6029
17546 msgid ""
17547 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
17548 "partition sizes are specified in megabytes only (rounded to the nearest "
17549 "cylinder) and you don't need to specify the cyls, heads and sectors "
17550 "parameters which were rarely if ever used anyway."
17551 msgstr ""
17552
17553 # type: textblock
17554 #. type: textblock
17555 #: ../src/guestfs-actions.pod:6035
17556 msgid ""
17557 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
17558 "C<guestfs_part_disk>"
17559 msgstr ""
17560
17561 # type: =head2
17562 #. type: =head2
17563 #: ../src/guestfs-actions.pod:6045
17564 msgid "guestfs_sfdisk_N"
17565 msgstr ""
17566
17567 # type: verbatim
17568 #. type: verbatim
17569 #: ../src/guestfs-actions.pod:6047
17570 #, no-wrap
17571 msgid ""
17572 " int\n"
17573 " guestfs_sfdisk_N (guestfs_h *g,\n"
17574 "                   const char *device,\n"
17575 "                   int partnum,\n"
17576 "                   int cyls,\n"
17577 "                   int heads,\n"
17578 "                   int sectors,\n"
17579 "                   const char *line);\n"
17580 "\n"
17581 msgstr ""
17582
17583 # type: textblock
17584 #. type: textblock
17585 #: ../src/guestfs-actions.pod:6056 ../fish/guestfish-actions.pod:4083
17586 msgid ""
17587 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
17588 "(note: C<n> counts from 1)."
17589 msgstr ""
17590
17591 # type: textblock
17592 #. type: textblock
17593 #: ../src/guestfs-actions.pod:6059
17594 msgid ""
17595 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
17596 "for the cyls/heads/sectors parameters."
17597 msgstr ""
17598
17599 # type: textblock
17600 #. type: textblock
17601 #: ../src/guestfs-actions.pod:6062
17602 msgid "See also: C<guestfs_part_add>"
17603 msgstr ""
17604
17605 # type: =head2
17606 #. type: =head2
17607 #: ../src/guestfs-actions.pod:6071
17608 msgid "guestfs_sfdisk_disk_geometry"
17609 msgstr ""
17610
17611 # type: verbatim
17612 #. type: verbatim
17613 #: ../src/guestfs-actions.pod:6073
17614 #, no-wrap
17615 msgid ""
17616 " char *\n"
17617 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
17618 "                               const char *device);\n"
17619 "\n"
17620 msgstr ""
17621
17622 # type: textblock
17623 #. type: textblock
17624 #: ../src/guestfs-actions.pod:6077
17625 msgid ""
17626 "This displays the disk geometry of C<device> read from the partition table.  "
17627 "Especially in the case where the underlying block device has been resized, "
17628 "this can be different from the kernel's idea of the geometry (see "
17629 "C<guestfs_sfdisk_kernel_geometry>)."
17630 msgstr ""
17631
17632 # type: textblock
17633 #. type: textblock
17634 #: ../src/guestfs-actions.pod:6082 ../src/guestfs-actions.pod:6098
17635 #: ../fish/guestfish-actions.pod:4103 ../fish/guestfish-actions.pod:4112
17636 msgid "The result is in human-readable format, and not designed to be parsed."
17637 msgstr ""
17638
17639 # type: =head2
17640 #. type: =head2
17641 #: ../src/guestfs-actions.pod:6090
17642 msgid "guestfs_sfdisk_kernel_geometry"
17643 msgstr ""
17644
17645 # type: verbatim
17646 #. type: verbatim
17647 #: ../src/guestfs-actions.pod:6092
17648 #, no-wrap
17649 msgid ""
17650 " char *\n"
17651 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
17652 "                                 const char *device);\n"
17653 "\n"
17654 msgstr ""
17655
17656 # type: textblock
17657 #. type: textblock
17658 #: ../src/guestfs-actions.pod:6096 ../fish/guestfish-actions.pod:4110
17659 msgid "This displays the kernel's idea of the geometry of C<device>."
17660 msgstr ""
17661
17662 # type: =head2
17663 #. type: =head2
17664 #: ../src/guestfs-actions.pod:6106
17665 msgid "guestfs_sfdisk_l"
17666 msgstr ""
17667
17668 # type: verbatim
17669 #. type: verbatim
17670 #: ../src/guestfs-actions.pod:6108
17671 #, no-wrap
17672 msgid ""
17673 " char *\n"
17674 " guestfs_sfdisk_l (guestfs_h *g,\n"
17675 "                   const char *device);\n"
17676 "\n"
17677 msgstr ""
17678
17679 # type: textblock
17680 #. type: textblock
17681 #: ../src/guestfs-actions.pod:6112 ../fish/guestfish-actions.pod:4119
17682 msgid ""
17683 "This displays the partition table on C<device>, in the human-readable output "
17684 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
17685 msgstr ""
17686
17687 # type: textblock
17688 #. type: textblock
17689 #: ../src/guestfs-actions.pod:6116
17690 msgid "See also: C<guestfs_part_list>"
17691 msgstr ""
17692
17693 # type: =head2
17694 #. type: =head2
17695 #: ../src/guestfs-actions.pod:6123
17696 msgid "guestfs_sh"
17697 msgstr ""
17698
17699 # type: verbatim
17700 #. type: verbatim
17701 #: ../src/guestfs-actions.pod:6125
17702 #, no-wrap
17703 msgid ""
17704 " char *\n"
17705 " guestfs_sh (guestfs_h *g,\n"
17706 "             const char *command);\n"
17707 "\n"
17708 msgstr ""
17709
17710 # type: textblock
17711 #. type: textblock
17712 #: ../src/guestfs-actions.pod:6129 ../fish/guestfish-actions.pod:4129
17713 msgid ""
17714 "This call runs a command from the guest filesystem via the guest's C</bin/"
17715 "sh>."
17716 msgstr ""
17717
17718 # type: textblock
17719 #. type: textblock
17720 #: ../src/guestfs-actions.pod:6132
17721 msgid "This is like C<guestfs_command>, but passes the command to:"
17722 msgstr ""
17723
17724 # type: verbatim
17725 #. type: verbatim
17726 #: ../src/guestfs-actions.pod:6134 ../fish/guestfish-actions.pod:4134
17727 #, no-wrap
17728 msgid ""
17729 " /bin/sh -c \"command\"\n"
17730 "\n"
17731 msgstr ""
17732
17733 # type: textblock
17734 #. type: textblock
17735 #: ../src/guestfs-actions.pod:6136 ../fish/guestfish-actions.pod:4136
17736 msgid ""
17737 "Depending on the guest's shell, this usually results in wildcards being "
17738 "expanded, shell expressions being interpolated and so on."
17739 msgstr ""
17740
17741 # type: textblock
17742 #. type: textblock
17743 #: ../src/guestfs-actions.pod:6140
17744 msgid "All the provisos about C<guestfs_command> apply to this call."
17745 msgstr ""
17746
17747 # type: =head2
17748 #. type: =head2
17749 #: ../src/guestfs-actions.pod:6147
17750 msgid "guestfs_sh_lines"
17751 msgstr ""
17752
17753 # type: verbatim
17754 #. type: verbatim
17755 #: ../src/guestfs-actions.pod:6149
17756 #, no-wrap
17757 msgid ""
17758 " char **\n"
17759 " guestfs_sh_lines (guestfs_h *g,\n"
17760 "                   const char *command);\n"
17761 "\n"
17762 msgstr ""
17763
17764 # type: textblock
17765 #. type: textblock
17766 #: ../src/guestfs-actions.pod:6153
17767 msgid ""
17768 "This is the same as C<guestfs_sh>, but splits the result into a list of "
17769 "lines."
17770 msgstr ""
17771
17772 # type: textblock
17773 #. type: textblock
17774 #: ../src/guestfs-actions.pod:6156
17775 msgid "See also: C<guestfs_command_lines>"
17776 msgstr ""
17777
17778 # type: =head2
17779 #. type: =head2
17780 #: ../src/guestfs-actions.pod:6164
17781 msgid "guestfs_sleep"
17782 msgstr ""
17783
17784 # type: verbatim
17785 #. type: verbatim
17786 #: ../src/guestfs-actions.pod:6166
17787 #, no-wrap
17788 msgid ""
17789 " int\n"
17790 " guestfs_sleep (guestfs_h *g,\n"
17791 "                int secs);\n"
17792 "\n"
17793 msgstr ""
17794
17795 # type: textblock
17796 #. type: textblock
17797 #: ../src/guestfs-actions.pod:6170 ../fish/guestfish-actions.pod:4155
17798 msgid "Sleep for C<secs> seconds."
17799 msgstr ""
17800
17801 # type: textblock
17802 #. type: textblock
17803 #: ../src/guestfs-actions.pod:6174
17804 msgid "(Added in 1.0.41)"
17805 msgstr ""
17806
17807 # type: =head2
17808 #. type: =head2
17809 #: ../src/guestfs-actions.pod:6176 ../src/guestfs-structs.pod:109
17810 msgid "guestfs_stat"
17811 msgstr ""
17812
17813 # type: verbatim
17814 #. type: verbatim
17815 #: ../src/guestfs-actions.pod:6178
17816 #, no-wrap
17817 msgid ""
17818 " struct guestfs_stat *\n"
17819 " guestfs_stat (guestfs_h *g,\n"
17820 "               const char *path);\n"
17821 "\n"
17822 msgstr ""
17823
17824 # type: textblock
17825 #. type: textblock
17826 #: ../src/guestfs-actions.pod:6184 ../fish/guestfish-actions.pod:4163
17827 msgid "This is the same as the C<stat(2)> system call."
17828 msgstr ""
17829
17830 # type: =head2
17831 #. type: =head2
17832 #: ../src/guestfs-actions.pod:6192 ../src/guestfs-structs.pod:135
17833 msgid "guestfs_statvfs"
17834 msgstr ""
17835
17836 # type: verbatim
17837 #. type: verbatim
17838 #: ../src/guestfs-actions.pod:6194
17839 #, no-wrap
17840 msgid ""
17841 " struct guestfs_statvfs *\n"
17842 " guestfs_statvfs (guestfs_h *g,\n"
17843 "                  const char *path);\n"
17844 "\n"
17845 msgstr ""
17846
17847 # type: textblock
17848 #. type: textblock
17849 #: ../src/guestfs-actions.pod:6198 ../fish/guestfish-actions.pod:4169
17850 msgid ""
17851 "Returns file system statistics for any mounted file system.  C<path> should "
17852 "be a file or directory in the mounted file system (typically it is the mount "
17853 "point itself, but it doesn't need to be)."
17854 msgstr ""
17855
17856 # type: textblock
17857 #. type: textblock
17858 #: ../src/guestfs-actions.pod:6202 ../fish/guestfish-actions.pod:4173
17859 msgid "This is the same as the C<statvfs(2)> system call."
17860 msgstr ""
17861
17862 # type: textblock
17863 #. type: textblock
17864 #: ../src/guestfs-actions.pod:6204
17865 msgid ""
17866 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
17867 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
17868 msgstr ""
17869
17870 # type: =head2
17871 #. type: =head2
17872 #: ../src/guestfs-actions.pod:6210
17873 msgid "guestfs_strings"
17874 msgstr ""
17875
17876 # type: verbatim
17877 #. type: verbatim
17878 #: ../src/guestfs-actions.pod:6212
17879 #, no-wrap
17880 msgid ""
17881 " char **\n"
17882 " guestfs_strings (guestfs_h *g,\n"
17883 "                  const char *path);\n"
17884 "\n"
17885 msgstr ""
17886
17887 # type: textblock
17888 #. type: textblock
17889 #: ../src/guestfs-actions.pod:6216 ../fish/guestfish-actions.pod:4179
17890 msgid ""
17891 "This runs the L<strings(1)> command on a file and returns the list of "
17892 "printable strings found."
17893 msgstr ""
17894
17895 # type: =head2
17896 #. type: =head2
17897 #: ../src/guestfs-actions.pod:6228
17898 msgid "guestfs_strings_e"
17899 msgstr ""
17900
17901 # type: verbatim
17902 #. type: verbatim
17903 #: ../src/guestfs-actions.pod:6230
17904 #, no-wrap
17905 msgid ""
17906 " char **\n"
17907 " guestfs_strings_e (guestfs_h *g,\n"
17908 "                    const char *encoding,\n"
17909 "                    const char *path);\n"
17910 "\n"
17911 msgstr ""
17912
17913 # type: textblock
17914 #. type: textblock
17915 #: ../src/guestfs-actions.pod:6235
17916 msgid ""
17917 "This is like the C<guestfs_strings> command, but allows you to specify the "
17918 "encoding of strings that are looked for in the source file C<path>."
17919 msgstr ""
17920
17921 # type: textblock
17922 #. type: textblock
17923 #: ../src/guestfs-actions.pod:6239 ../fish/guestfish-actions.pod:4193
17924 msgid "Allowed encodings are:"
17925 msgstr ""
17926
17927 # type: =item
17928 #. type: =item
17929 #: ../src/guestfs-actions.pod:6243 ../fish/guestfish-actions.pod:4197
17930 msgid "s"
17931 msgstr ""
17932
17933 # type: textblock
17934 #. type: textblock
17935 #: ../src/guestfs-actions.pod:6245
17936 msgid ""
17937 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
17938 "ISO-8859-X (this is what C<guestfs_strings> uses)."
17939 msgstr ""
17940
17941 # type: =item
17942 #. type: =item
17943 #: ../src/guestfs-actions.pod:6248 ../fish/guestfish-actions.pod:4202
17944 msgid "S"
17945 msgstr ""
17946
17947 # type: textblock
17948 #. type: textblock
17949 #: ../src/guestfs-actions.pod:6250 ../fish/guestfish-actions.pod:4204
17950 msgid "Single 8-bit-byte characters."
17951 msgstr ""
17952
17953 # type: =item
17954 #. type: =item
17955 #: ../src/guestfs-actions.pod:6252 ../fish/guestfish-actions.pod:4206
17956 msgid "b"
17957 msgstr ""
17958
17959 # type: textblock
17960 #. type: textblock
17961 #: ../src/guestfs-actions.pod:6254 ../fish/guestfish-actions.pod:4208
17962 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
17963 msgstr ""
17964
17965 # type: =item
17966 #. type: =item
17967 #: ../src/guestfs-actions.pod:6257 ../fish/guestfish-actions.pod:4211
17968 msgid "l (lower case letter L)"
17969 msgstr ""
17970
17971 # type: textblock
17972 #. type: textblock
17973 #: ../src/guestfs-actions.pod:6259 ../fish/guestfish-actions.pod:4213
17974 msgid ""
17975 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
17976 "examining binaries in Windows guests."
17977 msgstr ""
17978
17979 # type: =item
17980 #. type: =item
17981 #: ../src/guestfs-actions.pod:6262 ../fish/guestfish-actions.pod:4216
17982 msgid "B"
17983 msgstr ""
17984
17985 # type: textblock
17986 #. type: textblock
17987 #: ../src/guestfs-actions.pod:6264 ../fish/guestfish-actions.pod:4218
17988 msgid "32-bit big endian such as UCS-4BE."
17989 msgstr ""
17990
17991 # type: =item
17992 #. type: =item
17993 #: ../src/guestfs-actions.pod:6266 ../fish/guestfish-actions.pod:4220
17994 msgid "L"
17995 msgstr ""
17996
17997 # type: textblock
17998 #. type: textblock
17999 #: ../src/guestfs-actions.pod:6268 ../fish/guestfish-actions.pod:4222
18000 msgid "32-bit little endian such as UCS-4LE."
18001 msgstr ""
18002
18003 # type: textblock
18004 #. type: textblock
18005 #: ../src/guestfs-actions.pod:6272 ../fish/guestfish-actions.pod:4226
18006 msgid "The returned strings are transcoded to UTF-8."
18007 msgstr ""
18008
18009 # type: =head2
18010 #. type: =head2
18011 #: ../src/guestfs-actions.pod:6283
18012 msgid "guestfs_swapoff_device"
18013 msgstr ""
18014
18015 # type: verbatim
18016 #. type: verbatim
18017 #: ../src/guestfs-actions.pod:6285
18018 #, no-wrap
18019 msgid ""
18020 " int\n"
18021 " guestfs_swapoff_device (guestfs_h *g,\n"
18022 "                         const char *device);\n"
18023 "\n"
18024 msgstr ""
18025
18026 # type: textblock
18027 #. type: textblock
18028 #: ../src/guestfs-actions.pod:6289
18029 msgid ""
18030 "This command disables the libguestfs appliance swap device or partition "
18031 "named C<device>.  See C<guestfs_swapon_device>."
18032 msgstr ""
18033
18034 # type: =head2
18035 #. type: =head2
18036 #: ../src/guestfs-actions.pod:6297
18037 msgid "guestfs_swapoff_file"
18038 msgstr ""
18039
18040 # type: verbatim
18041 #. type: verbatim
18042 #: ../src/guestfs-actions.pod:6299
18043 #, no-wrap
18044 msgid ""
18045 " int\n"
18046 " guestfs_swapoff_file (guestfs_h *g,\n"
18047 "                       const char *file);\n"
18048 "\n"
18049 msgstr ""
18050
18051 # type: textblock
18052 #. type: textblock
18053 #: ../src/guestfs-actions.pod:6303 ../fish/guestfish-actions.pod:4243
18054 msgid "This command disables the libguestfs appliance swap on file."
18055 msgstr ""
18056
18057 # type: =head2
18058 #. type: =head2
18059 #: ../src/guestfs-actions.pod:6309
18060 msgid "guestfs_swapoff_label"
18061 msgstr ""
18062
18063 # type: verbatim
18064 #. type: verbatim
18065 #: ../src/guestfs-actions.pod:6311
18066 #, no-wrap
18067 msgid ""
18068 " int\n"
18069 " guestfs_swapoff_label (guestfs_h *g,\n"
18070 "                        const char *label);\n"
18071 "\n"
18072 msgstr ""
18073
18074 # type: textblock
18075 #. type: textblock
18076 #: ../src/guestfs-actions.pod:6315 ../fish/guestfish-actions.pod:4249
18077 msgid ""
18078 "This command disables the libguestfs appliance swap on labeled swap "
18079 "partition."
18080 msgstr ""
18081
18082 # type: =head2
18083 #. type: =head2
18084 #: ../src/guestfs-actions.pod:6322
18085 msgid "guestfs_swapoff_uuid"
18086 msgstr ""
18087
18088 # type: verbatim
18089 #. type: verbatim
18090 #: ../src/guestfs-actions.pod:6324
18091 #, no-wrap
18092 msgid ""
18093 " int\n"
18094 " guestfs_swapoff_uuid (guestfs_h *g,\n"
18095 "                       const char *uuid);\n"
18096 "\n"
18097 msgstr ""
18098
18099 # type: textblock
18100 #. type: textblock
18101 #: ../src/guestfs-actions.pod:6328 ../fish/guestfish-actions.pod:4256
18102 msgid ""
18103 "This command disables the libguestfs appliance swap partition with the given "
18104 "UUID."
18105 msgstr ""
18106
18107 # type: =head2
18108 #. type: =head2
18109 #: ../src/guestfs-actions.pod:6335
18110 msgid "guestfs_swapon_device"
18111 msgstr ""
18112
18113 # type: verbatim
18114 #. type: verbatim
18115 #: ../src/guestfs-actions.pod:6337
18116 #, no-wrap
18117 msgid ""
18118 " int\n"
18119 " guestfs_swapon_device (guestfs_h *g,\n"
18120 "                        const char *device);\n"
18121 "\n"
18122 msgstr ""
18123
18124 # type: textblock
18125 #. type: textblock
18126 #: ../src/guestfs-actions.pod:6341
18127 msgid ""
18128 "This command enables the libguestfs appliance to use the swap device or "
18129 "partition named C<device>.  The increased memory is made available for all "
18130 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
18131 msgstr ""
18132
18133 # type: textblock
18134 #. type: textblock
18135 #: ../src/guestfs-actions.pod:6346 ../fish/guestfish-actions.pod:4268
18136 msgid ""
18137 "Note that you should not swap to existing guest swap partitions unless you "
18138 "know what you are doing.  They may contain hibernation information, or other "
18139 "information that the guest doesn't want you to trash.  You also risk leaking "
18140 "information about the host to the guest this way.  Instead, attach a new "
18141 "host device to the guest and swap on that."
18142 msgstr ""
18143
18144 # type: =head2
18145 #. type: =head2
18146 #: ../src/guestfs-actions.pod:6357
18147 msgid "guestfs_swapon_file"
18148 msgstr ""
18149
18150 # type: verbatim
18151 #. type: verbatim
18152 #: ../src/guestfs-actions.pod:6359
18153 #, no-wrap
18154 msgid ""
18155 " int\n"
18156 " guestfs_swapon_file (guestfs_h *g,\n"
18157 "                      const char *file);\n"
18158 "\n"
18159 msgstr ""
18160
18161 # type: textblock
18162 #. type: textblock
18163 #: ../src/guestfs-actions.pod:6363
18164 msgid ""
18165 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
18166 "notes."
18167 msgstr ""
18168
18169 # type: =head2
18170 #. type: =head2
18171 #: ../src/guestfs-actions.pod:6370
18172 msgid "guestfs_swapon_label"
18173 msgstr ""
18174
18175 # type: verbatim
18176 #. type: verbatim
18177 #: ../src/guestfs-actions.pod:6372
18178 #, no-wrap
18179 msgid ""
18180 " int\n"
18181 " guestfs_swapon_label (guestfs_h *g,\n"
18182 "                       const char *label);\n"
18183 "\n"
18184 msgstr ""
18185
18186 # type: textblock
18187 #. type: textblock
18188 #: ../src/guestfs-actions.pod:6376
18189 msgid ""
18190 "This command enables swap to a labeled swap partition.  See "
18191 "C<guestfs_swapon_device> for other notes."
18192 msgstr ""
18193
18194 # type: =head2
18195 #. type: =head2
18196 #: ../src/guestfs-actions.pod:6383
18197 msgid "guestfs_swapon_uuid"
18198 msgstr ""
18199
18200 # type: verbatim
18201 #. type: verbatim
18202 #: ../src/guestfs-actions.pod:6385
18203 #, no-wrap
18204 msgid ""
18205 " int\n"
18206 " guestfs_swapon_uuid (guestfs_h *g,\n"
18207 "                      const char *uuid);\n"
18208 "\n"
18209 msgstr ""
18210
18211 # type: textblock
18212 #. type: textblock
18213 #: ../src/guestfs-actions.pod:6389
18214 msgid ""
18215 "This command enables swap to a swap partition with the given UUID.  See "
18216 "C<guestfs_swapon_device> for other notes."
18217 msgstr ""
18218
18219 # type: =head2
18220 #. type: =head2
18221 #: ../src/guestfs-actions.pod:6396
18222 msgid "guestfs_sync"
18223 msgstr ""
18224
18225 # type: verbatim
18226 #. type: verbatim
18227 #: ../src/guestfs-actions.pod:6398
18228 #, no-wrap
18229 msgid ""
18230 " int\n"
18231 " guestfs_sync (guestfs_h *g);\n"
18232 "\n"
18233 msgstr ""
18234
18235 # type: textblock
18236 #. type: textblock
18237 #: ../src/guestfs-actions.pod:6401 ../fish/guestfish-actions.pod:4300
18238 msgid ""
18239 "This syncs the disk, so that any writes are flushed through to the "
18240 "underlying disk image."
18241 msgstr ""
18242
18243 # type: textblock
18244 #. type: textblock
18245 #: ../src/guestfs-actions.pod:6404 ../fish/guestfish-actions.pod:4303
18246 msgid ""
18247 "You should always call this if you have modified a disk image, before "
18248 "closing the handle."
18249 msgstr ""
18250
18251 # type: =head2
18252 #. type: =head2
18253 #: ../src/guestfs-actions.pod:6411
18254 msgid "guestfs_tail"
18255 msgstr ""
18256
18257 # type: verbatim
18258 #. type: verbatim
18259 #: ../src/guestfs-actions.pod:6413
18260 #, no-wrap
18261 msgid ""
18262 " char **\n"
18263 " guestfs_tail (guestfs_h *g,\n"
18264 "               const char *path);\n"
18265 "\n"
18266 msgstr ""
18267
18268 # type: textblock
18269 #. type: textblock
18270 #: ../src/guestfs-actions.pod:6417 ../fish/guestfish-actions.pod:4310
18271 msgid ""
18272 "This command returns up to the last 10 lines of a file as a list of strings."
18273 msgstr ""
18274
18275 # type: =head2
18276 #. type: =head2
18277 #: ../src/guestfs-actions.pod:6429
18278 msgid "guestfs_tail_n"
18279 msgstr ""
18280
18281 # type: verbatim
18282 #. type: verbatim
18283 #: ../src/guestfs-actions.pod:6431
18284 #, no-wrap
18285 msgid ""
18286 " char **\n"
18287 " guestfs_tail_n (guestfs_h *g,\n"
18288 "                 int nrlines,\n"
18289 "                 const char *path);\n"
18290 "\n"
18291 msgstr ""
18292
18293 # type: textblock
18294 #. type: textblock
18295 #: ../src/guestfs-actions.pod:6436 ../fish/guestfish-actions.pod:4320
18296 msgid ""
18297 "If the parameter C<nrlines> is a positive number, this returns the last "
18298 "C<nrlines> lines of the file C<path>."
18299 msgstr ""
18300
18301 # type: textblock
18302 #. type: textblock
18303 #: ../src/guestfs-actions.pod:6439 ../fish/guestfish-actions.pod:4323
18304 msgid ""
18305 "If the parameter C<nrlines> is a negative number, this returns lines from "
18306 "the file C<path>, starting with the C<-nrlines>th line."
18307 msgstr ""
18308
18309 # type: =head2
18310 #. type: =head2
18311 #: ../src/guestfs-actions.pod:6453
18312 msgid "guestfs_tar_in"
18313 msgstr ""
18314
18315 # type: verbatim
18316 #. type: verbatim
18317 #: ../src/guestfs-actions.pod:6455
18318 #, no-wrap
18319 msgid ""
18320 " int\n"
18321 " guestfs_tar_in (guestfs_h *g,\n"
18322 "                 const char *tarfile,\n"
18323 "                 const char *directory);\n"
18324 "\n"
18325 msgstr ""
18326
18327 # type: textblock
18328 #. type: textblock
18329 #: ../src/guestfs-actions.pod:6460 ../fish/guestfish-actions.pod:4335
18330 msgid ""
18331 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
18332 "tar file) into C<directory>."
18333 msgstr ""
18334
18335 # type: textblock
18336 #. type: textblock
18337 #: ../src/guestfs-actions.pod:6463
18338 msgid ""
18339 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
18340 msgstr ""
18341
18342 # type: textblock
18343 #. type: textblock
18344 #: ../src/guestfs-actions.pod:6468 ../src/guestfs-actions.pod:6485
18345 #: ../src/guestfs-actions.pod:6501 ../src/guestfs-actions.pod:6517
18346 msgid "(Added in 1.0.3)"
18347 msgstr ""
18348
18349 # type: =head2
18350 #. type: =head2
18351 #: ../src/guestfs-actions.pod:6470
18352 msgid "guestfs_tar_out"
18353 msgstr ""
18354
18355 # type: verbatim
18356 #. type: verbatim
18357 #: ../src/guestfs-actions.pod:6472
18358 #, no-wrap
18359 msgid ""
18360 " int\n"
18361 " guestfs_tar_out (guestfs_h *g,\n"
18362 "                  const char *directory,\n"
18363 "                  const char *tarfile);\n"
18364 "\n"
18365 msgstr ""
18366
18367 # type: textblock
18368 #. type: textblock
18369 #: ../src/guestfs-actions.pod:6477 ../fish/guestfish-actions.pod:4347
18370 msgid ""
18371 "This command packs the contents of C<directory> and downloads it to local "
18372 "file C<tarfile>."
18373 msgstr ""
18374
18375 # type: textblock
18376 #. type: textblock
18377 #: ../src/guestfs-actions.pod:6480
18378 msgid ""
18379 "To download a compressed tarball, use C<guestfs_tgz_out> or "
18380 "C<guestfs_txz_out>."
18381 msgstr ""
18382
18383 # type: =head2
18384 #. type: =head2
18385 #: ../src/guestfs-actions.pod:6487
18386 msgid "guestfs_tgz_in"
18387 msgstr ""
18388
18389 # type: verbatim
18390 #. type: verbatim
18391 #: ../src/guestfs-actions.pod:6489
18392 #, no-wrap
18393 msgid ""
18394 " int\n"
18395 " guestfs_tgz_in (guestfs_h *g,\n"
18396 "                 const char *tarball,\n"
18397 "                 const char *directory);\n"
18398 "\n"
18399 msgstr ""
18400
18401 # type: textblock
18402 #. type: textblock
18403 #: ../src/guestfs-actions.pod:6494 ../fish/guestfish-actions.pod:4359
18404 msgid ""
18405 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
18406 "tar file) into C<directory>."
18407 msgstr ""
18408
18409 # type: textblock
18410 #. type: textblock
18411 #: ../src/guestfs-actions.pod:6497
18412 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
18413 msgstr ""
18414
18415 # type: =head2
18416 #. type: =head2
18417 #: ../src/guestfs-actions.pod:6503
18418 msgid "guestfs_tgz_out"
18419 msgstr ""
18420
18421 # type: verbatim
18422 #. type: verbatim
18423 #: ../src/guestfs-actions.pod:6505
18424 #, no-wrap
18425 msgid ""
18426 " int\n"
18427 " guestfs_tgz_out (guestfs_h *g,\n"
18428 "                  const char *directory,\n"
18429 "                  const char *tarball);\n"
18430 "\n"
18431 msgstr ""
18432
18433 # type: textblock
18434 #. type: textblock
18435 #: ../src/guestfs-actions.pod:6510 ../fish/guestfish-actions.pod:4370
18436 msgid ""
18437 "This command packs the contents of C<directory> and downloads it to local "
18438 "file C<tarball>."
18439 msgstr ""
18440
18441 # type: textblock
18442 #. type: textblock
18443 #: ../src/guestfs-actions.pod:6513
18444 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
18445 msgstr ""
18446
18447 # type: =head2
18448 #. type: =head2
18449 #: ../src/guestfs-actions.pod:6519
18450 msgid "guestfs_touch"
18451 msgstr ""
18452
18453 # type: verbatim
18454 #. type: verbatim
18455 #: ../src/guestfs-actions.pod:6521
18456 #, no-wrap
18457 msgid ""
18458 " int\n"
18459 " guestfs_touch (guestfs_h *g,\n"
18460 "                const char *path);\n"
18461 "\n"
18462 msgstr ""
18463
18464 # type: textblock
18465 #. type: textblock
18466 #: ../src/guestfs-actions.pod:6525 ../fish/guestfish-actions.pod:4381
18467 msgid ""
18468 "Touch acts like the L<touch(1)> command.  It can be used to update the "
18469 "timestamps on a file, or, if the file does not exist, to create a new zero-"
18470 "length file."
18471 msgstr ""
18472
18473 # type: textblock
18474 #. type: textblock
18475 #: ../src/guestfs-actions.pod:6529 ../fish/guestfish-actions.pod:4385
18476 msgid ""
18477 "This command only works on regular files, and will fail on other file types "
18478 "such as directories, symbolic links, block special etc."
18479 msgstr ""
18480
18481 # type: =head2
18482 #. type: =head2
18483 #: ../src/guestfs-actions.pod:6536
18484 msgid "guestfs_truncate"
18485 msgstr ""
18486
18487 # type: verbatim
18488 #. type: verbatim
18489 #: ../src/guestfs-actions.pod:6538
18490 #, no-wrap
18491 msgid ""
18492 " int\n"
18493 " guestfs_truncate (guestfs_h *g,\n"
18494 "                   const char *path);\n"
18495 "\n"
18496 msgstr ""
18497
18498 # type: textblock
18499 #. type: textblock
18500 #: ../src/guestfs-actions.pod:6542 ../fish/guestfish-actions.pod:4392
18501 msgid ""
18502 "This command truncates C<path> to a zero-length file.  The file must exist "
18503 "already."
18504 msgstr ""
18505
18506 # type: =head2
18507 #. type: =head2
18508 #: ../src/guestfs-actions.pod:6549
18509 msgid "guestfs_truncate_size"
18510 msgstr ""
18511
18512 # type: verbatim
18513 #. type: verbatim
18514 #: ../src/guestfs-actions.pod:6551
18515 #, no-wrap
18516 msgid ""
18517 " int\n"
18518 " guestfs_truncate_size (guestfs_h *g,\n"
18519 "                        const char *path,\n"
18520 "                        int64_t size);\n"
18521 "\n"
18522 msgstr ""
18523
18524 # type: textblock
18525 #. type: textblock
18526 #: ../src/guestfs-actions.pod:6556 ../fish/guestfish-actions.pod:4399
18527 msgid ""
18528 "This command truncates C<path> to size C<size> bytes.  The file must exist "
18529 "already."
18530 msgstr ""
18531
18532 # type: textblock
18533 #. type: textblock
18534 #: ../src/guestfs-actions.pod:6559
18535 msgid ""
18536 "If the current file size is less than C<size> then the file is extended to "
18537 "the required size with zero bytes.  This creates a sparse file (ie. disk "
18538 "blocks are not allocated for the file until you write to it).  To create a "
18539 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
18540 msgstr ""
18541
18542 # type: =head2
18543 #. type: =head2
18544 #: ../src/guestfs-actions.pod:6569
18545 msgid "guestfs_tune2fs_l"
18546 msgstr ""
18547
18548 # type: verbatim
18549 #. type: verbatim
18550 #: ../src/guestfs-actions.pod:6571
18551 #, no-wrap
18552 msgid ""
18553 " char **\n"
18554 " guestfs_tune2fs_l (guestfs_h *g,\n"
18555 "                    const char *device);\n"
18556 "\n"
18557 msgstr ""
18558
18559 # type: textblock
18560 #. type: textblock
18561 #: ../src/guestfs-actions.pod:6575 ../fish/guestfish-actions.pod:4412
18562 msgid ""
18563 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
18564 "C<device>."
18565 msgstr ""
18566
18567 # type: textblock
18568 #. type: textblock
18569 #: ../src/guestfs-actions.pod:6578 ../fish/guestfish-actions.pod:4415
18570 msgid ""
18571 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
18572 "for more details.  The list of fields returned isn't clearly defined, and "
18573 "depends on both the version of C<tune2fs> that libguestfs was built against, "
18574 "and the filesystem itself."
18575 msgstr ""
18576
18577 # type: =head2
18578 #. type: =head2
18579 #: ../src/guestfs-actions.pod:6591
18580 msgid "guestfs_txz_in"
18581 msgstr ""
18582
18583 # type: verbatim
18584 #. type: verbatim
18585 #: ../src/guestfs-actions.pod:6593
18586 #, no-wrap
18587 msgid ""
18588 " int\n"
18589 " guestfs_txz_in (guestfs_h *g,\n"
18590 "                 const char *tarball,\n"
18591 "                 const char *directory);\n"
18592 "\n"
18593 msgstr ""
18594
18595 # type: textblock
18596 #. type: textblock
18597 #: ../src/guestfs-actions.pod:6598 ../fish/guestfish-actions.pod:4424
18598 msgid ""
18599 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
18600 "tar file) into C<directory>."
18601 msgstr ""
18602
18603 # type: =head2
18604 #. type: =head2
18605 #: ../src/guestfs-actions.pod:6605
18606 msgid "guestfs_txz_out"
18607 msgstr ""
18608
18609 # type: verbatim
18610 #. type: verbatim
18611 #: ../src/guestfs-actions.pod:6607
18612 #, no-wrap
18613 msgid ""
18614 " int\n"
18615 " guestfs_txz_out (guestfs_h *g,\n"
18616 "                  const char *directory,\n"
18617 "                  const char *tarball);\n"
18618 "\n"
18619 msgstr ""
18620
18621 # type: textblock
18622 #. type: textblock
18623 #: ../src/guestfs-actions.pod:6612 ../fish/guestfish-actions.pod:4433
18624 msgid ""
18625 "This command packs the contents of C<directory> and downloads it to local "
18626 "file C<tarball> (as an xz compressed tar archive)."
18627 msgstr ""
18628
18629 # type: =head2
18630 #. type: =head2
18631 #: ../src/guestfs-actions.pod:6619
18632 msgid "guestfs_umask"
18633 msgstr ""
18634
18635 # type: verbatim
18636 #. type: verbatim
18637 #: ../src/guestfs-actions.pod:6621
18638 #, no-wrap
18639 msgid ""
18640 " int\n"
18641 " guestfs_umask (guestfs_h *g,\n"
18642 "                int mask);\n"
18643 "\n"
18644 msgstr ""
18645
18646 # type: textblock
18647 #. type: textblock
18648 #: ../src/guestfs-actions.pod:6625 ../fish/guestfish-actions.pod:4442
18649 msgid ""
18650 "This function sets the mask used for creating new files and device nodes to "
18651 "C<mask & 0777>."
18652 msgstr ""
18653
18654 # type: textblock
18655 #. type: textblock
18656 #: ../src/guestfs-actions.pod:6628 ../fish/guestfish-actions.pod:4445
18657 msgid ""
18658 "Typical umask values would be C<022> which creates new files with "
18659 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
18660 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
18661 msgstr ""
18662
18663 # type: textblock
18664 #. type: textblock
18665 #: ../src/guestfs-actions.pod:6633 ../fish/guestfish-actions.pod:4450
18666 msgid ""
18667 "The default umask is C<022>.  This is important because it means that "
18668 "directories and device nodes will be created with C<0644> or C<0755> mode "
18669 "even if you specify C<0777>."
18670 msgstr ""
18671
18672 # type: textblock
18673 #. type: textblock
18674 #: ../src/guestfs-actions.pod:6637
18675 msgid ""
18676 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
18677 "C<guestfs_mkdir>."
18678 msgstr ""
18679
18680 # type: textblock
18681 #. type: textblock
18682 #: ../src/guestfs-actions.pod:6640 ../fish/guestfish-actions.pod:4457
18683 msgid "This call returns the previous umask."
18684 msgstr ""
18685
18686 # type: =head2
18687 #. type: =head2
18688 #: ../src/guestfs-actions.pod:6646
18689 msgid "guestfs_umount"
18690 msgstr ""
18691
18692 # type: verbatim
18693 #. type: verbatim
18694 #: ../src/guestfs-actions.pod:6648
18695 #, no-wrap
18696 msgid ""
18697 " int\n"
18698 " guestfs_umount (guestfs_h *g,\n"
18699 "                 const char *pathordevice);\n"
18700 "\n"
18701 msgstr ""
18702
18703 # type: textblock
18704 #. type: textblock
18705 #: ../src/guestfs-actions.pod:6652 ../fish/guestfish-actions.pod:4465
18706 msgid ""
18707 "This unmounts the given filesystem.  The filesystem may be specified either "
18708 "by its mountpoint (path) or the device which contains the filesystem."
18709 msgstr ""
18710
18711 # type: =head2
18712 #. type: =head2
18713 #: ../src/guestfs-actions.pod:6660
18714 msgid "guestfs_umount_all"
18715 msgstr ""
18716
18717 # type: verbatim
18718 #. type: verbatim
18719 #: ../src/guestfs-actions.pod:6662
18720 #, no-wrap
18721 msgid ""
18722 " int\n"
18723 " guestfs_umount_all (guestfs_h *g);\n"
18724 "\n"
18725 msgstr ""
18726
18727 # type: textblock
18728 #. type: textblock
18729 #: ../src/guestfs-actions.pod:6665 ../fish/guestfish-actions.pod:4475
18730 msgid "This unmounts all mounted filesystems."
18731 msgstr ""
18732
18733 # type: textblock
18734 #. type: textblock
18735 #: ../src/guestfs-actions.pod:6667 ../fish/guestfish-actions.pod:4477
18736 msgid "Some internal mounts are not unmounted by this call."
18737 msgstr ""
18738
18739 # type: =head2
18740 #. type: =head2
18741 #: ../src/guestfs-actions.pod:6673
18742 msgid "guestfs_upload"
18743 msgstr ""
18744
18745 # type: verbatim
18746 #. type: verbatim
18747 #: ../src/guestfs-actions.pod:6675
18748 #, no-wrap
18749 msgid ""
18750 " int\n"
18751 " guestfs_upload (guestfs_h *g,\n"
18752 "                 const char *filename,\n"
18753 "                 const char *remotefilename);\n"
18754 "\n"
18755 msgstr ""
18756
18757 # type: textblock
18758 #. type: textblock
18759 #: ../src/guestfs-actions.pod:6680 ../src/guestfs-actions.pod:6704
18760 #: ../fish/guestfish-actions.pod:4483 ../fish/guestfish-actions.pod:4496
18761 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
18762 msgstr ""
18763
18764 # type: textblock
18765 #. type: textblock
18766 #: ../src/guestfs-actions.pod:6685
18767 msgid "See also C<guestfs_download>."
18768 msgstr ""
18769
18770 # type: =head2
18771 #. type: =head2
18772 #: ../src/guestfs-actions.pod:6696
18773 msgid "guestfs_upload_offset"
18774 msgstr ""
18775
18776 # type: verbatim
18777 #. type: verbatim
18778 #: ../src/guestfs-actions.pod:6698
18779 #, no-wrap
18780 msgid ""
18781 " int\n"
18782 " guestfs_upload_offset (guestfs_h *g,\n"
18783 "                        const char *filename,\n"
18784 "                        const char *remotefilename,\n"
18785 "                        int64_t offset);\n"
18786 "\n"
18787 msgstr ""
18788
18789 # type: textblock
18790 #. type: textblock
18791 #: ../src/guestfs-actions.pod:6707 ../fish/guestfish-actions.pod:4499
18792 msgid ""
18793 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
18794 "The intention is to overwrite parts of existing files or devices, although "
18795 "if a non-existant file is specified then it is created with a \"hole\" "
18796 "before C<offset>.  The size of the data written is implicit in the size of "
18797 "the source C<filename>."
18798 msgstr ""
18799
18800 # type: textblock
18801 #. type: textblock
18802 #: ../src/guestfs-actions.pod:6714
18803 msgid ""
18804 "Note that there is no limit on the amount of data that can be uploaded with "
18805 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
18806 "full amount unless an error occurs."
18807 msgstr ""
18808
18809 # type: textblock
18810 #. type: textblock
18811 #: ../src/guestfs-actions.pod:6719
18812 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
18813 msgstr ""
18814
18815 # type: =head2
18816 #. type: =head2
18817 #: ../src/guestfs-actions.pod:6730
18818 msgid "guestfs_utimens"
18819 msgstr ""
18820
18821 # type: verbatim
18822 #. type: verbatim
18823 #: ../src/guestfs-actions.pod:6732
18824 #, no-wrap
18825 msgid ""
18826 " int\n"
18827 " guestfs_utimens (guestfs_h *g,\n"
18828 "                  const char *path,\n"
18829 "                  int64_t atsecs,\n"
18830 "                  int64_t atnsecs,\n"
18831 "                  int64_t mtsecs,\n"
18832 "                  int64_t mtnsecs);\n"
18833 "\n"
18834 msgstr ""
18835
18836 # type: textblock
18837 #. type: textblock
18838 #: ../src/guestfs-actions.pod:6740 ../fish/guestfish-actions.pod:4519
18839 msgid "This command sets the timestamps of a file with nanosecond precision."
18840 msgstr ""
18841
18842 # type: textblock
18843 #. type: textblock
18844 #: ../src/guestfs-actions.pod:6743 ../fish/guestfish-actions.pod:4522
18845 msgid ""
18846 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
18847 "from the epoch."
18848 msgstr ""
18849
18850 # type: textblock
18851 #. type: textblock
18852 #: ../src/guestfs-actions.pod:6746 ../fish/guestfish-actions.pod:4525
18853 msgid ""
18854 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
18855 "nanoseconds from the epoch."
18856 msgstr ""
18857
18858 # type: textblock
18859 #. type: textblock
18860 #: ../src/guestfs-actions.pod:6749 ../fish/guestfish-actions.pod:4528
18861 msgid ""
18862 "If the C<*nsecs> field contains the special value C<-1> then the "
18863 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
18864 "ignored in this case)."
18865 msgstr ""
18866
18867 # type: textblock
18868 #. type: textblock
18869 #: ../src/guestfs-actions.pod:6753 ../fish/guestfish-actions.pod:4532
18870 msgid ""
18871 "If the C<*nsecs> field contains the special value C<-2> then the "
18872 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
18873 "in this case)."
18874 msgstr ""
18875
18876 # type: =head2
18877 #. type: =head2
18878 #: ../src/guestfs-actions.pod:6761 ../src/guestfs-structs.pod:175
18879 msgid "guestfs_version"
18880 msgstr ""
18881
18882 # type: verbatim
18883 #. type: verbatim
18884 #: ../src/guestfs-actions.pod:6763
18885 #, no-wrap
18886 msgid ""
18887 " struct guestfs_version *\n"
18888 " guestfs_version (guestfs_h *g);\n"
18889 "\n"
18890 msgstr ""
18891
18892 # type: textblock
18893 #. type: textblock
18894 #: ../src/guestfs-actions.pod:6766 ../fish/guestfish-actions.pod:4540
18895 msgid ""
18896 "Return the libguestfs version number that the program is linked against."
18897 msgstr ""
18898
18899 # type: textblock
18900 #. type: textblock
18901 #: ../src/guestfs-actions.pod:6769 ../fish/guestfish-actions.pod:4543
18902 msgid ""
18903 "Note that because of dynamic linking this is not necessarily the version of "
18904 "libguestfs that you compiled against.  You can compile the program, and then "
18905 "at runtime dynamically link against a completely different C<libguestfs.so> "
18906 "library."
18907 msgstr ""
18908
18909 # type: textblock
18910 #. type: textblock
18911 #: ../src/guestfs-actions.pod:6774 ../fish/guestfish-actions.pod:4548
18912 msgid ""
18913 "This call was added in version C<1.0.58>.  In previous versions of "
18914 "libguestfs there was no way to get the version number.  From C code you can "
18915 "use dynamic linker functions to find out if this symbol exists (if it "
18916 "doesn't, then it's an earlier version)."
18917 msgstr ""
18918
18919 # type: textblock
18920 #. type: textblock
18921 #: ../src/guestfs-actions.pod:6780 ../fish/guestfish-actions.pod:4554
18922 msgid ""
18923 "The call returns a structure with four elements.  The first three (C<major>, "
18924 "C<minor> and C<release>) are numbers and correspond to the usual version "
18925 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
18926 "but may be used for distro-specific information."
18927 msgstr ""
18928
18929 # type: textblock
18930 #. type: textblock
18931 #: ../src/guestfs-actions.pod:6786 ../fish/guestfish-actions.pod:4560
18932 msgid ""
18933 "To construct the original version string: C<$major.$minor.$release$extra>"
18934 msgstr ""
18935
18936 # type: textblock
18937 #. type: textblock
18938 #: ../src/guestfs-actions.pod:6789 ../fish/guestfish-actions.pod:4563
18939 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
18940 msgstr ""
18941
18942 # type: textblock
18943 #. type: textblock
18944 #: ../src/guestfs-actions.pod:6791
18945 msgid ""
18946 "I<Note:> Don't use this call to test for availability of features.  In "
18947 "enterprise distributions we backport features from later versions into "
18948 "earlier versions, making this an unreliable way to test for features.  Use "
18949 "C<guestfs_available> instead."
18950 msgstr ""
18951
18952 # type: textblock
18953 #. type: textblock
18954 #: ../src/guestfs-actions.pod:6797
18955 msgid ""
18956 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
18957 "error.  I<The caller must call C<guestfs_free_version> after use>."
18958 msgstr ""
18959
18960 # type: textblock
18961 #. type: textblock
18962 #: ../src/guestfs-actions.pod:6801
18963 msgid "(Added in 1.0.58)"
18964 msgstr ""
18965
18966 # type: =head2
18967 #. type: =head2
18968 #: ../src/guestfs-actions.pod:6803
18969 msgid "guestfs_vfs_label"
18970 msgstr ""
18971
18972 # type: verbatim
18973 #. type: verbatim
18974 #: ../src/guestfs-actions.pod:6805
18975 #, no-wrap
18976 msgid ""
18977 " char *\n"
18978 " guestfs_vfs_label (guestfs_h *g,\n"
18979 "                    const char *device);\n"
18980 "\n"
18981 msgstr ""
18982
18983 # type: textblock
18984 #. type: textblock
18985 #: ../src/guestfs-actions.pod:6809 ../fish/guestfish-actions.pod:4575
18986 msgid "This returns the filesystem label of the filesystem on C<device>."
18987 msgstr ""
18988
18989 # type: textblock
18990 #. type: textblock
18991 #: ../src/guestfs-actions.pod:6812 ../fish/guestfish-actions.pod:4578
18992 msgid "If the filesystem is unlabeled, this returns the empty string."
18993 msgstr ""
18994
18995 # type: textblock
18996 #. type: textblock
18997 #: ../src/guestfs-actions.pod:6814
18998 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
18999 msgstr ""
19000
19001 # type: textblock
19002 #. type: textblock
19003 #: ../src/guestfs-actions.pod:6819 ../src/guestfs-actions.pod:6856
19004 msgid "(Added in 1.3.18)"
19005 msgstr ""
19006
19007 # type: =head2
19008 #. type: =head2
19009 #: ../src/guestfs-actions.pod:6821
19010 msgid "guestfs_vfs_type"
19011 msgstr ""
19012
19013 # type: verbatim
19014 #. type: verbatim
19015 #: ../src/guestfs-actions.pod:6823
19016 #, no-wrap
19017 msgid ""
19018 " char *\n"
19019 " guestfs_vfs_type (guestfs_h *g,\n"
19020 "                   const char *device);\n"
19021 "\n"
19022 msgstr ""
19023
19024 # type: textblock
19025 #. type: textblock
19026 #: ../src/guestfs-actions.pod:6827 ../fish/guestfish-actions.pod:4586
19027 msgid ""
19028 "This command gets the filesystem type corresponding to the filesystem on "
19029 "C<device>."
19030 msgstr ""
19031
19032 # type: textblock
19033 #. type: textblock
19034 #: ../src/guestfs-actions.pod:6830 ../fish/guestfish-actions.pod:4589
19035 msgid ""
19036 "For most filesystems, the result is the name of the Linux VFS module which "
19037 "would be used to mount this filesystem if you mounted it without specifying "
19038 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
19039 msgstr ""
19040
19041 # type: =head2
19042 #. type: =head2
19043 #: ../src/guestfs-actions.pod:6840
19044 msgid "guestfs_vfs_uuid"
19045 msgstr ""
19046
19047 # type: verbatim
19048 #. type: verbatim
19049 #: ../src/guestfs-actions.pod:6842
19050 #, no-wrap
19051 msgid ""
19052 " char *\n"
19053 " guestfs_vfs_uuid (guestfs_h *g,\n"
19054 "                   const char *device);\n"
19055 "\n"
19056 msgstr ""
19057
19058 # type: textblock
19059 #. type: textblock
19060 #: ../src/guestfs-actions.pod:6846 ../fish/guestfish-actions.pod:4598
19061 msgid "This returns the filesystem UUID of the filesystem on C<device>."
19062 msgstr ""
19063
19064 # type: textblock
19065 #. type: textblock
19066 #: ../src/guestfs-actions.pod:6849 ../fish/guestfish-actions.pod:4601
19067 msgid "If the filesystem does not have a UUID, this returns the empty string."
19068 msgstr ""
19069
19070 # type: textblock
19071 #. type: textblock
19072 #: ../src/guestfs-actions.pod:6851
19073 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
19074 msgstr ""
19075
19076 # type: =head2
19077 #. type: =head2
19078 #: ../src/guestfs-actions.pod:6858
19079 msgid "guestfs_vg_activate"
19080 msgstr ""
19081
19082 # type: verbatim
19083 #. type: verbatim
19084 #: ../src/guestfs-actions.pod:6860
19085 #, no-wrap
19086 msgid ""
19087 " int\n"
19088 " guestfs_vg_activate (guestfs_h *g,\n"
19089 "                      int activate,\n"
19090 "                      char *const *volgroups);\n"
19091 "\n"
19092 msgstr ""
19093
19094 # type: textblock
19095 #. type: textblock
19096 #: ../src/guestfs-actions.pod:6865 ../fish/guestfish-actions.pod:4609
19097 msgid ""
19098 "This command activates or (if C<activate> is false) deactivates all logical "
19099 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
19100 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
19101 "deactivated, then those devices disappear."
19102 msgstr ""
19103
19104 # type: textblock
19105 #. type: textblock
19106 #: ../src/guestfs-actions.pod:6871 ../fish/guestfish-actions.pod:4615
19107 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
19108 msgstr ""
19109
19110 # type: textblock
19111 #. type: textblock
19112 #: ../src/guestfs-actions.pod:6873 ../fish/guestfish-actions.pod:4617
19113 msgid ""
19114 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
19115 "activated or deactivated."
19116 msgstr ""
19117
19118 # type: =head2
19119 #. type: =head2
19120 #: ../src/guestfs-actions.pod:6880
19121 msgid "guestfs_vg_activate_all"
19122 msgstr ""
19123
19124 # type: verbatim
19125 #. type: verbatim
19126 #: ../src/guestfs-actions.pod:6882
19127 #, no-wrap
19128 msgid ""
19129 " int\n"
19130 " guestfs_vg_activate_all (guestfs_h *g,\n"
19131 "                          int activate);\n"
19132 "\n"
19133 msgstr ""
19134
19135 # type: textblock
19136 #. type: textblock
19137 #: ../src/guestfs-actions.pod:6886 ../fish/guestfish-actions.pod:4624
19138 msgid ""
19139 "This command activates or (if C<activate> is false) deactivates all logical "
19140 "volumes in all volume groups.  If activated, then they are made known to the "
19141 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
19142 "those devices disappear."
19143 msgstr ""
19144
19145 # type: textblock
19146 #. type: textblock
19147 #: ../src/guestfs-actions.pod:6892 ../fish/guestfish-actions.pod:4630
19148 msgid "This command is the same as running C<vgchange -a y|n>"
19149 msgstr ""
19150
19151 # type: =head2
19152 #. type: =head2
19153 #: ../src/guestfs-actions.pod:6898
19154 msgid "guestfs_vgcreate"
19155 msgstr ""
19156
19157 # type: verbatim
19158 #. type: verbatim
19159 #: ../src/guestfs-actions.pod:6900
19160 #, no-wrap
19161 msgid ""
19162 " int\n"
19163 " guestfs_vgcreate (guestfs_h *g,\n"
19164 "                   const char *volgroup,\n"
19165 "                   char *const *physvols);\n"
19166 "\n"
19167 msgstr ""
19168
19169 # type: textblock
19170 #. type: textblock
19171 #: ../src/guestfs-actions.pod:6905 ../fish/guestfish-actions.pod:4636
19172 msgid ""
19173 "This creates an LVM volume group called C<volgroup> from the non-empty list "
19174 "of physical volumes C<physvols>."
19175 msgstr ""
19176
19177 # type: =head2
19178 #. type: =head2
19179 #: ../src/guestfs-actions.pod:6912
19180 msgid "guestfs_vglvuuids"
19181 msgstr ""
19182
19183 # type: verbatim
19184 #. type: verbatim
19185 #: ../src/guestfs-actions.pod:6914
19186 #, no-wrap
19187 msgid ""
19188 " char **\n"
19189 " guestfs_vglvuuids (guestfs_h *g,\n"
19190 "                    const char *vgname);\n"
19191 "\n"
19192 msgstr ""
19193
19194 # type: textblock
19195 #. type: textblock
19196 #: ../src/guestfs-actions.pod:6918 ../fish/guestfish-actions.pod:4643
19197 msgid ""
19198 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
19199 "volumes created in this volume group."
19200 msgstr ""
19201
19202 # type: textblock
19203 #. type: textblock
19204 #: ../src/guestfs-actions.pod:6921
19205 msgid ""
19206 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
19207 "associate logical volumes and volume groups."
19208 msgstr ""
19209
19210 # type: textblock
19211 #. type: textblock
19212 #: ../src/guestfs-actions.pod:6924
19213 msgid "See also C<guestfs_vgpvuuids>."
19214 msgstr ""
19215
19216 # type: =head2
19217 #. type: =head2
19218 #: ../src/guestfs-actions.pod:6932
19219 msgid "guestfs_vgpvuuids"
19220 msgstr ""
19221
19222 # type: verbatim
19223 #. type: verbatim
19224 #: ../src/guestfs-actions.pod:6934
19225 #, no-wrap
19226 msgid ""
19227 " char **\n"
19228 " guestfs_vgpvuuids (guestfs_h *g,\n"
19229 "                    const char *vgname);\n"
19230 "\n"
19231 msgstr ""
19232
19233 # type: textblock
19234 #. type: textblock
19235 #: ../src/guestfs-actions.pod:6938 ../fish/guestfish-actions.pod:4655
19236 msgid ""
19237 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
19238 "volumes that this volume group resides on."
19239 msgstr ""
19240
19241 # type: textblock
19242 #. type: textblock
19243 #: ../src/guestfs-actions.pod:6941
19244 msgid ""
19245 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
19246 "associate physical volumes and volume groups."
19247 msgstr ""
19248
19249 # type: textblock
19250 #. type: textblock
19251 #: ../src/guestfs-actions.pod:6944
19252 msgid "See also C<guestfs_vglvuuids>."
19253 msgstr ""
19254
19255 # type: =head2
19256 #. type: =head2
19257 #: ../src/guestfs-actions.pod:6952
19258 msgid "guestfs_vgremove"
19259 msgstr ""
19260
19261 # type: verbatim
19262 #. type: verbatim
19263 #: ../src/guestfs-actions.pod:6954
19264 #, no-wrap
19265 msgid ""
19266 " int\n"
19267 " guestfs_vgremove (guestfs_h *g,\n"
19268 "                   const char *vgname);\n"
19269 "\n"
19270 msgstr ""
19271
19272 # type: textblock
19273 #. type: textblock
19274 #: ../src/guestfs-actions.pod:6958 ../fish/guestfish-actions.pod:4667
19275 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
19276 msgstr ""
19277
19278 # type: textblock
19279 #. type: textblock
19280 #: ../src/guestfs-actions.pod:6960 ../fish/guestfish-actions.pod:4669
19281 msgid ""
19282 "This also forcibly removes all logical volumes in the volume group (if any)."
19283 msgstr ""
19284
19285 # type: =head2
19286 #. type: =head2
19287 #: ../src/guestfs-actions.pod:6967
19288 msgid "guestfs_vgrename"
19289 msgstr ""
19290
19291 # type: verbatim
19292 #. type: verbatim
19293 #: ../src/guestfs-actions.pod:6969
19294 #, no-wrap
19295 msgid ""
19296 " int\n"
19297 " guestfs_vgrename (guestfs_h *g,\n"
19298 "                   const char *volgroup,\n"
19299 "                   const char *newvolgroup);\n"
19300 "\n"
19301 msgstr ""
19302
19303 # type: textblock
19304 #. type: textblock
19305 #: ../src/guestfs-actions.pod:6974 ../fish/guestfish-actions.pod:4676
19306 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
19307 msgstr ""
19308
19309 # type: =head2
19310 #. type: =head2
19311 #: ../src/guestfs-actions.pod:6980
19312 msgid "guestfs_vgs"
19313 msgstr ""
19314
19315 # type: verbatim
19316 #. type: verbatim
19317 #: ../src/guestfs-actions.pod:6982
19318 #, no-wrap
19319 msgid ""
19320 " char **\n"
19321 " guestfs_vgs (guestfs_h *g);\n"
19322 "\n"
19323 msgstr ""
19324
19325 # type: textblock
19326 #. type: textblock
19327 #: ../src/guestfs-actions.pod:6985 ../fish/guestfish-actions.pod:4682
19328 msgid ""
19329 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
19330 "> command."
19331 msgstr ""
19332
19333 # type: textblock
19334 #. type: textblock
19335 #: ../src/guestfs-actions.pod:6988 ../fish/guestfish-actions.pod:4685
19336 msgid ""
19337 "This returns a list of just the volume group names that were detected (eg. "
19338 "C<VolGroup00>)."
19339 msgstr ""
19340
19341 # type: textblock
19342 #. type: textblock
19343 #: ../src/guestfs-actions.pod:6991
19344 msgid "See also C<guestfs_vgs_full>."
19345 msgstr ""
19346
19347 # type: =head2
19348 #. type: =head2
19349 #: ../src/guestfs-actions.pod:6999
19350 msgid "guestfs_vgs_full"
19351 msgstr ""
19352
19353 # type: verbatim
19354 #. type: verbatim
19355 #: ../src/guestfs-actions.pod:7001
19356 #, no-wrap
19357 msgid ""
19358 " struct guestfs_lvm_vg_list *\n"
19359 " guestfs_vgs_full (guestfs_h *g);\n"
19360 "\n"
19361 msgstr ""
19362
19363 # type: textblock
19364 #. type: textblock
19365 #: ../src/guestfs-actions.pod:7004 ../fish/guestfish-actions.pod:4694
19366 msgid ""
19367 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
19368 "> command.  The \"full\" version includes all fields."
19369 msgstr ""
19370
19371 # type: textblock
19372 #. type: textblock
19373 #: ../src/guestfs-actions.pod:7007
19374 msgid ""
19375 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
19376 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
19377 msgstr ""
19378
19379 # type: =head2
19380 #. type: =head2
19381 #: ../src/guestfs-actions.pod:7013
19382 msgid "guestfs_vgscan"
19383 msgstr ""
19384
19385 # type: verbatim
19386 #. type: verbatim
19387 #: ../src/guestfs-actions.pod:7015
19388 #, no-wrap
19389 msgid ""
19390 " int\n"
19391 " guestfs_vgscan (guestfs_h *g);\n"
19392 "\n"
19393 msgstr ""
19394
19395 # type: textblock
19396 #. type: textblock
19397 #: ../src/guestfs-actions.pod:7018 ../fish/guestfish-actions.pod:4701
19398 msgid ""
19399 "This rescans all block devices and rebuilds the list of LVM physical "
19400 "volumes, volume groups and logical volumes."
19401 msgstr ""
19402
19403 # type: =head2
19404 #. type: =head2
19405 #: ../src/guestfs-actions.pod:7025
19406 msgid "guestfs_vguuid"
19407 msgstr ""
19408
19409 # type: verbatim
19410 #. type: verbatim
19411 #: ../src/guestfs-actions.pod:7027
19412 #, no-wrap
19413 msgid ""
19414 " char *\n"
19415 " guestfs_vguuid (guestfs_h *g,\n"
19416 "                 const char *vgname);\n"
19417 "\n"
19418 msgstr ""
19419
19420 # type: textblock
19421 #. type: textblock
19422 #: ../src/guestfs-actions.pod:7031 ../fish/guestfish-actions.pod:4708
19423 msgid "This command returns the UUID of the LVM VG named C<vgname>."
19424 msgstr ""
19425
19426 # type: =head2
19427 #. type: =head2
19428 #: ../src/guestfs-actions.pod:7038
19429 msgid "guestfs_wait_ready"
19430 msgstr ""
19431
19432 # type: verbatim
19433 #. type: verbatim
19434 #: ../src/guestfs-actions.pod:7040
19435 #, no-wrap
19436 msgid ""
19437 " int\n"
19438 " guestfs_wait_ready (guestfs_h *g);\n"
19439 "\n"
19440 msgstr ""
19441
19442 # type: textblock
19443 #. type: textblock
19444 #: ../src/guestfs-actions.pod:7043
19445 msgid "This function is a no op."
19446 msgstr ""
19447
19448 # type: textblock
19449 #. type: textblock
19450 #: ../src/guestfs-actions.pod:7045
19451 msgid ""
19452 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
19453 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
19454 "is no longer necessary because C<guestfs_launch> now does the waiting."
19455 msgstr ""
19456
19457 # type: textblock
19458 #. type: textblock
19459 #: ../src/guestfs-actions.pod:7050
19460 msgid ""
19461 "If you see any calls to this function in code then you can just remove them, "
19462 "unless you want to retain compatibility with older versions of the API."
19463 msgstr ""
19464
19465 # type: =head2
19466 #. type: =head2
19467 #: ../src/guestfs-actions.pod:7058
19468 msgid "guestfs_wc_c"
19469 msgstr ""
19470
19471 # type: verbatim
19472 #. type: verbatim
19473 #: ../src/guestfs-actions.pod:7060
19474 #, no-wrap
19475 msgid ""
19476 " int\n"
19477 " guestfs_wc_c (guestfs_h *g,\n"
19478 "               const char *path);\n"
19479 "\n"
19480 msgstr ""
19481
19482 # type: textblock
19483 #. type: textblock
19484 #: ../src/guestfs-actions.pod:7064 ../fish/guestfish-actions.pod:4714
19485 msgid ""
19486 "This command counts the characters in a file, using the C<wc -c> external "
19487 "command."
19488 msgstr ""
19489
19490 # type: =head2
19491 #. type: =head2
19492 #: ../src/guestfs-actions.pod:7071
19493 msgid "guestfs_wc_l"
19494 msgstr ""
19495
19496 # type: verbatim
19497 #. type: verbatim
19498 #: ../src/guestfs-actions.pod:7073
19499 #, no-wrap
19500 msgid ""
19501 " int\n"
19502 " guestfs_wc_l (guestfs_h *g,\n"
19503 "               const char *path);\n"
19504 "\n"
19505 msgstr ""
19506
19507 # type: textblock
19508 #. type: textblock
19509 #: ../src/guestfs-actions.pod:7077 ../fish/guestfish-actions.pod:4721
19510 msgid ""
19511 "This command counts the lines in a file, using the C<wc -l> external command."
19512 msgstr ""
19513
19514 # type: =head2
19515 #. type: =head2
19516 #: ../src/guestfs-actions.pod:7084
19517 msgid "guestfs_wc_w"
19518 msgstr ""
19519
19520 # type: verbatim
19521 #. type: verbatim
19522 #: ../src/guestfs-actions.pod:7086
19523 #, no-wrap
19524 msgid ""
19525 " int\n"
19526 " guestfs_wc_w (guestfs_h *g,\n"
19527 "               const char *path);\n"
19528 "\n"
19529 msgstr ""
19530
19531 # type: textblock
19532 #. type: textblock
19533 #: ../src/guestfs-actions.pod:7090 ../fish/guestfish-actions.pod:4728
19534 msgid ""
19535 "This command counts the words in a file, using the C<wc -w> external command."
19536 msgstr ""
19537
19538 # type: =head2
19539 #. type: =head2
19540 #: ../src/guestfs-actions.pod:7097
19541 msgid "guestfs_write"
19542 msgstr ""
19543
19544 # type: verbatim
19545 #. type: verbatim
19546 #: ../src/guestfs-actions.pod:7099
19547 #, no-wrap
19548 msgid ""
19549 " int\n"
19550 " guestfs_write (guestfs_h *g,\n"
19551 "                const char *path,\n"
19552 "                const char *content,\n"
19553 "                size_t content_size);\n"
19554 "\n"
19555 msgstr ""
19556
19557 # type: textblock
19558 #. type: textblock
19559 #: ../src/guestfs-actions.pod:7105 ../fish/guestfish-actions.pod:4735
19560 msgid ""
19561 "This call creates a file called C<path>.  The content of the file is the "
19562 "string C<content> (which can contain any 8 bit data)."
19563 msgstr ""
19564
19565 # type: =head2
19566 #. type: =head2
19567 #: ../src/guestfs-actions.pod:7115
19568 msgid "guestfs_write_file"
19569 msgstr ""
19570
19571 # type: verbatim
19572 #. type: verbatim
19573 #: ../src/guestfs-actions.pod:7117
19574 #, no-wrap
19575 msgid ""
19576 " int\n"
19577 " guestfs_write_file (guestfs_h *g,\n"
19578 "                     const char *path,\n"
19579 "                     const char *content,\n"
19580 "                     int size);\n"
19581 "\n"
19582 msgstr ""
19583
19584 # type: textblock
19585 #. type: textblock
19586 #: ../src/guestfs-actions.pod:7123 ../fish/guestfish-actions.pod:4745
19587 msgid ""
19588 "This call creates a file called C<path>.  The contents of the file is the "
19589 "string C<content> (which can contain any 8 bit data), with length C<size>."
19590 msgstr ""
19591
19592 # type: textblock
19593 #. type: textblock
19594 #: ../src/guestfs-actions.pod:7127 ../fish/guestfish-actions.pod:4749
19595 msgid ""
19596 "As a special case, if C<size> is C<0> then the length is calculated using "
19597 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
19598 msgstr ""
19599
19600 # type: textblock
19601 #. type: textblock
19602 #: ../src/guestfs-actions.pod:7131 ../fish/guestfish-actions.pod:4753
19603 msgid ""
19604 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
19605 "I<not> work, even if the length is specified."
19606 msgstr ""
19607
19608 # type: textblock
19609 #. type: textblock
19610 #: ../src/guestfs-actions.pod:7139 ../fish/guestfish-actions.pod:4759
19611 msgid ""
19612 "This function is deprecated.  In new code, use the C<write> call instead."
19613 msgstr ""
19614
19615 # type: =head2
19616 #. type: =head2
19617 #: ../src/guestfs-actions.pod:7148
19618 msgid "guestfs_zegrep"
19619 msgstr ""
19620
19621 # type: verbatim
19622 #. type: verbatim
19623 #: ../src/guestfs-actions.pod:7150
19624 #, no-wrap
19625 msgid ""
19626 " char **\n"
19627 " guestfs_zegrep (guestfs_h *g,\n"
19628 "                 const char *regex,\n"
19629 "                 const char *path);\n"
19630 "\n"
19631 msgstr ""
19632
19633 # type: textblock
19634 #. type: textblock
19635 #: ../src/guestfs-actions.pod:7155 ../fish/guestfish-actions.pod:4770
19636 msgid ""
19637 "This calls the external C<zegrep> program and returns the matching lines."
19638 msgstr ""
19639
19640 # type: =head2
19641 #. type: =head2
19642 #: ../src/guestfs-actions.pod:7167
19643 msgid "guestfs_zegrepi"
19644 msgstr ""
19645
19646 # type: verbatim
19647 #. type: verbatim
19648 #: ../src/guestfs-actions.pod:7169
19649 #, no-wrap
19650 msgid ""
19651 " char **\n"
19652 " guestfs_zegrepi (guestfs_h *g,\n"
19653 "                  const char *regex,\n"
19654 "                  const char *path);\n"
19655 "\n"
19656 msgstr ""
19657
19658 # type: textblock
19659 #. type: textblock
19660 #: ../src/guestfs-actions.pod:7174 ../fish/guestfish-actions.pod:4780
19661 msgid ""
19662 "This calls the external C<zegrep -i> program and returns the matching lines."
19663 msgstr ""
19664
19665 # type: =head2
19666 #. type: =head2
19667 #: ../src/guestfs-actions.pod:7186
19668 msgid "guestfs_zero"
19669 msgstr ""
19670
19671 # type: verbatim
19672 #. type: verbatim
19673 #: ../src/guestfs-actions.pod:7188
19674 #, no-wrap
19675 msgid ""
19676 " int\n"
19677 " guestfs_zero (guestfs_h *g,\n"
19678 "               const char *device);\n"
19679 "\n"
19680 msgstr ""
19681
19682 # type: textblock
19683 #. type: textblock
19684 #: ../src/guestfs-actions.pod:7192 ../fish/guestfish-actions.pod:4790
19685 msgid "This command writes zeroes over the first few blocks of C<device>."
19686 msgstr ""
19687
19688 # type: textblock
19689 #. type: textblock
19690 #: ../src/guestfs-actions.pod:7194 ../fish/guestfish-actions.pod:4792
19691 msgid ""
19692 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
19693 "securely wipe the device).  It should be sufficient to remove any partition "
19694 "tables, filesystem superblocks and so on."
19695 msgstr ""
19696
19697 # type: textblock
19698 #. type: textblock
19699 #: ../src/guestfs-actions.pod:7198
19700 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
19701 msgstr ""
19702
19703 # type: =head2
19704 #. type: =head2
19705 #: ../src/guestfs-actions.pod:7209
19706 msgid "guestfs_zero_device"
19707 msgstr ""
19708
19709 # type: verbatim
19710 #. type: verbatim
19711 #: ../src/guestfs-actions.pod:7211
19712 #, no-wrap
19713 msgid ""
19714 " int\n"
19715 " guestfs_zero_device (guestfs_h *g,\n"
19716 "                      const char *device);\n"
19717 "\n"
19718 msgstr ""
19719
19720 # type: textblock
19721 #. type: textblock
19722 #: ../src/guestfs-actions.pod:7215
19723 msgid ""
19724 "This command writes zeroes over the entire C<device>.  Compare with "
19725 "C<guestfs_zero> which just zeroes the first few blocks of a device."
19726 msgstr ""
19727
19728 # type: textblock
19729 #. type: textblock
19730 #: ../src/guestfs-actions.pod:7229
19731 msgid "(Added in 1.3.1)"
19732 msgstr ""
19733
19734 # type: =head2
19735 #. type: =head2
19736 #: ../src/guestfs-actions.pod:7231
19737 msgid "guestfs_zerofree"
19738 msgstr ""
19739
19740 # type: verbatim
19741 #. type: verbatim
19742 #: ../src/guestfs-actions.pod:7233
19743 #, no-wrap
19744 msgid ""
19745 " int\n"
19746 " guestfs_zerofree (guestfs_h *g,\n"
19747 "                   const char *device);\n"
19748 "\n"
19749 msgstr ""
19750
19751 # type: textblock
19752 #. type: textblock
19753 #: ../src/guestfs-actions.pod:7237 ../fish/guestfish-actions.pod:4813
19754 msgid ""
19755 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
19756 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
19757 "possible to compress the filesystem more effectively."
19758 msgstr ""
19759
19760 # type: textblock
19761 #. type: textblock
19762 #: ../src/guestfs-actions.pod:7242 ../fish/guestfish-actions.pod:4818
19763 msgid "You should B<not> run this program if the filesystem is mounted."
19764 msgstr ""
19765
19766 # type: textblock
19767 #. type: textblock
19768 #: ../src/guestfs-actions.pod:7245 ../fish/guestfish-actions.pod:4821
19769 msgid ""
19770 "It is possible that using this program can damage the filesystem or data on "
19771 "the filesystem."
19772 msgstr ""
19773
19774 # type: =head2
19775 #. type: =head2
19776 #: ../src/guestfs-actions.pod:7252
19777 msgid "guestfs_zfgrep"
19778 msgstr ""
19779
19780 # type: verbatim
19781 #. type: verbatim
19782 #: ../src/guestfs-actions.pod:7254
19783 #, no-wrap
19784 msgid ""
19785 " char **\n"
19786 " guestfs_zfgrep (guestfs_h *g,\n"
19787 "                 const char *pattern,\n"
19788 "                 const char *path);\n"
19789 "\n"
19790 msgstr ""
19791
19792 # type: textblock
19793 #. type: textblock
19794 #: ../src/guestfs-actions.pod:7259 ../fish/guestfish-actions.pod:4828
19795 msgid ""
19796 "This calls the external C<zfgrep> program and returns the matching lines."
19797 msgstr ""
19798
19799 # type: =head2
19800 #. type: =head2
19801 #: ../src/guestfs-actions.pod:7271
19802 msgid "guestfs_zfgrepi"
19803 msgstr ""
19804
19805 # type: verbatim
19806 #. type: verbatim
19807 #: ../src/guestfs-actions.pod:7273
19808 #, no-wrap
19809 msgid ""
19810 " char **\n"
19811 " guestfs_zfgrepi (guestfs_h *g,\n"
19812 "                  const char *pattern,\n"
19813 "                  const char *path);\n"
19814 "\n"
19815 msgstr ""
19816
19817 # type: textblock
19818 #. type: textblock
19819 #: ../src/guestfs-actions.pod:7278 ../fish/guestfish-actions.pod:4838
19820 msgid ""
19821 "This calls the external C<zfgrep -i> program and returns the matching lines."
19822 msgstr ""
19823
19824 # type: =head2
19825 #. type: =head2
19826 #: ../src/guestfs-actions.pod:7290
19827 msgid "guestfs_zfile"
19828 msgstr ""
19829
19830 # type: verbatim
19831 #. type: verbatim
19832 #: ../src/guestfs-actions.pod:7292
19833 #, no-wrap
19834 msgid ""
19835 " char *\n"
19836 " guestfs_zfile (guestfs_h *g,\n"
19837 "                const char *meth,\n"
19838 "                const char *path);\n"
19839 "\n"
19840 msgstr ""
19841
19842 # type: textblock
19843 #. type: textblock
19844 #: ../src/guestfs-actions.pod:7297 ../fish/guestfish-actions.pod:4848
19845 msgid ""
19846 "This command runs C<file> after first decompressing C<path> using C<method>."
19847 msgstr ""
19848
19849 # type: textblock
19850 #. type: textblock
19851 #: ../src/guestfs-actions.pod:7300 ../fish/guestfish-actions.pod:4851
19852 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
19853 msgstr ""
19854
19855 # type: textblock
19856 #. type: textblock
19857 #: ../src/guestfs-actions.pod:7302
19858 msgid ""
19859 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
19860 "files."
19861 msgstr ""
19862
19863 # type: textblock
19864 #. type: textblock
19865 #: ../src/guestfs-actions.pod:7308 ../fish/guestfish-actions.pod:4856
19866 msgid ""
19867 "This function is deprecated.  In new code, use the C<file> call instead."
19868 msgstr ""
19869
19870 # type: =head2
19871 #. type: =head2
19872 #: ../src/guestfs-actions.pod:7317
19873 msgid "guestfs_zgrep"
19874 msgstr ""
19875
19876 # type: verbatim
19877 #. type: verbatim
19878 #: ../src/guestfs-actions.pod:7319
19879 #, no-wrap
19880 msgid ""
19881 " char **\n"
19882 " guestfs_zgrep (guestfs_h *g,\n"
19883 "                const char *regex,\n"
19884 "                const char *path);\n"
19885 "\n"
19886 msgstr ""
19887
19888 # type: textblock
19889 #. type: textblock
19890 #: ../src/guestfs-actions.pod:7324 ../fish/guestfish-actions.pod:4867
19891 msgid ""
19892 "This calls the external C<zgrep> program and returns the matching lines."
19893 msgstr ""
19894
19895 # type: =head2
19896 #. type: =head2
19897 #: ../src/guestfs-actions.pod:7336
19898 msgid "guestfs_zgrepi"
19899 msgstr ""
19900
19901 # type: verbatim
19902 #. type: verbatim
19903 #: ../src/guestfs-actions.pod:7338
19904 #, no-wrap
19905 msgid ""
19906 " char **\n"
19907 " guestfs_zgrepi (guestfs_h *g,\n"
19908 "                 const char *regex,\n"
19909 "                 const char *path);\n"
19910 "\n"
19911 msgstr ""
19912
19913 # type: textblock
19914 #. type: textblock
19915 #: ../src/guestfs-actions.pod:7343 ../fish/guestfish-actions.pod:4877
19916 msgid ""
19917 "This calls the external C<zgrep -i> program and returns the matching lines."
19918 msgstr ""
19919
19920 # type: =item
19921 #. type: =item
19922 #: ../src/guestfs-availability.pod:3
19923 msgid "B<augeas>"
19924 msgstr ""
19925
19926 # type: textblock
19927 #. type: textblock
19928 #: ../src/guestfs-availability.pod:5
19929 msgid ""
19930 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
19931 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
19932 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
19933 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
19934 "L</guestfs_aug_save> L</guestfs_aug_set>"
19935 msgstr ""
19936
19937 # type: =item
19938 #. type: =item
19939 #: ../src/guestfs-availability.pod:21
19940 msgid "B<inotify>"
19941 msgstr ""
19942
19943 # type: textblock
19944 #. type: textblock
19945 #: ../src/guestfs-availability.pod:23
19946 msgid ""
19947 "The following functions: L</guestfs_inotify_add_watch> L</"
19948 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
19949 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
19950 msgstr ""
19951
19952 # type: =item
19953 #. type: =item
19954 #: ../src/guestfs-availability.pod:31
19955 msgid "B<linuxfsuuid>"
19956 msgstr ""
19957
19958 # type: textblock
19959 #. type: textblock
19960 #: ../src/guestfs-availability.pod:33
19961 msgid ""
19962 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
19963 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
19964 msgstr ""
19965
19966 # type: =item
19967 #. type: =item
19968 #: ../src/guestfs-availability.pod:40
19969 msgid "B<linuxmodules>"
19970 msgstr ""
19971
19972 # type: textblock
19973 #. type: textblock
19974 #: ../src/guestfs-availability.pod:42
19975 msgid "The following functions: L</guestfs_modprobe>"
19976 msgstr ""
19977
19978 # type: =item
19979 #. type: =item
19980 #: ../src/guestfs-availability.pod:45
19981 msgid "B<linuxxattrs>"
19982 msgstr ""
19983
19984 # type: textblock
19985 #. type: textblock
19986 #: ../src/guestfs-availability.pod:47
19987 msgid ""
19988 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
19989 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
19990 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
19991 "guestfs_setxattr>"
19992 msgstr ""
19993
19994 # type: =item
19995 #. type: =item
19996 #: ../src/guestfs-availability.pod:58
19997 msgid "B<luks>"
19998 msgstr ""
19999
20000 # type: textblock
20001 #. type: textblock
20002 #: ../src/guestfs-availability.pod:60
20003 msgid ""
20004 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
20005 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
20006 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
20007 msgstr ""
20008
20009 # type: =item
20010 #. type: =item
20011 #: ../src/guestfs-availability.pod:69
20012 msgid "B<lvm2>"
20013 msgstr ""
20014
20015 # type: textblock
20016 #. type: textblock
20017 #: ../src/guestfs-availability.pod:71
20018 msgid ""
20019 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
20020 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
20021 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
20022 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
20023 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
20024 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
20025 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
20026 msgstr ""
20027
20028 # type: =item
20029 #. type: =item
20030 #: ../src/guestfs-availability.pod:94
20031 msgid "B<mknod>"
20032 msgstr ""
20033
20034 # type: textblock
20035 #. type: textblock
20036 #: ../src/guestfs-availability.pod:96
20037 msgid ""
20038 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
20039 "guestfs_mknod_b> L</guestfs_mknod_c>"
20040 msgstr ""
20041
20042 # type: =item
20043 #. type: =item
20044 #: ../src/guestfs-availability.pod:102
20045 msgid "B<ntfs3g>"
20046 msgstr ""
20047
20048 # type: textblock
20049 #. type: textblock
20050 #: ../src/guestfs-availability.pod:104
20051 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
20052 msgstr ""
20053
20054 # type: =item
20055 #. type: =item
20056 #: ../src/guestfs-availability.pod:107
20057 msgid "B<ntfsprogs>"
20058 msgstr ""
20059
20060 # type: textblock
20061 #. type: textblock
20062 #: ../src/guestfs-availability.pod:109
20063 msgid ""
20064 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
20065 msgstr ""
20066
20067 # type: =item
20068 #. type: =item
20069 #: ../src/guestfs-availability.pod:113
20070 msgid "B<realpath>"
20071 msgstr ""
20072
20073 # type: textblock
20074 #. type: textblock
20075 #: ../src/guestfs-availability.pod:115
20076 msgid "The following functions: L</guestfs_realpath>"
20077 msgstr ""
20078
20079 # type: =item
20080 #. type: =item
20081 #: ../src/guestfs-availability.pod:118
20082 msgid "B<scrub>"
20083 msgstr ""
20084
20085 # type: textblock
20086 #. type: textblock
20087 #: ../src/guestfs-availability.pod:120
20088 msgid ""
20089 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
20090 "guestfs_scrub_freespace>"
20091 msgstr ""
20092
20093 # type: =item
20094 #. type: =item
20095 #: ../src/guestfs-availability.pod:125
20096 msgid "B<selinux>"
20097 msgstr ""
20098
20099 # type: textblock
20100 #. type: textblock
20101 #: ../src/guestfs-availability.pod:127
20102 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
20103 msgstr ""
20104
20105 # type: =item
20106 #. type: =item
20107 #: ../src/guestfs-availability.pod:131
20108 msgid "B<xz>"
20109 msgstr ""
20110
20111 # type: textblock
20112 #. type: textblock
20113 #: ../src/guestfs-availability.pod:133
20114 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
20115 msgstr ""
20116
20117 # type: =item
20118 #. type: =item
20119 #: ../src/guestfs-availability.pod:137
20120 msgid "B<zerofree>"
20121 msgstr ""
20122
20123 # type: textblock
20124 #. type: textblock
20125 #: ../src/guestfs-availability.pod:139
20126 msgid "The following functions: L</guestfs_zerofree>"
20127 msgstr ""
20128
20129 # type: =head2
20130 #. type: =head2
20131 #: ../src/guestfs-structs.pod:1
20132 msgid "guestfs_int_bool"
20133 msgstr ""
20134
20135 # type: verbatim
20136 #. type: verbatim
20137 #: ../src/guestfs-structs.pod:3
20138 #, no-wrap
20139 msgid ""
20140 " struct guestfs_int_bool {\n"
20141 "   int32_t i;\n"
20142 "   int32_t b;\n"
20143 " };\n"
20144 " \n"
20145 msgstr ""
20146
20147 # type: verbatim
20148 #. type: verbatim
20149 #: ../src/guestfs-structs.pod:8
20150 #, no-wrap
20151 msgid ""
20152 " struct guestfs_int_bool_list {\n"
20153 "   uint32_t len; /* Number of elements in list. */\n"
20154 "   struct guestfs_int_bool *val; /* Elements. */\n"
20155 " };\n"
20156 " \n"
20157 msgstr ""
20158
20159 # type: verbatim
20160 #. type: verbatim
20161 #: ../src/guestfs-structs.pod:13
20162 #, no-wrap
20163 msgid ""
20164 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
20165 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
20166 "\n"
20167 msgstr ""
20168
20169 # type: =head2
20170 #. type: =head2
20171 #: ../src/guestfs-structs.pod:16
20172 msgid "guestfs_lvm_pv"
20173 msgstr ""
20174
20175 # type: verbatim
20176 #. type: verbatim
20177 #: ../src/guestfs-structs.pod:18
20178 #, no-wrap
20179 msgid ""
20180 " struct guestfs_lvm_pv {\n"
20181 "   char *pv_name;\n"
20182 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20183 "   char pv_uuid[32];\n"
20184 "   char *pv_fmt;\n"
20185 "   uint64_t pv_size;\n"
20186 "   uint64_t dev_size;\n"
20187 "   uint64_t pv_free;\n"
20188 "   uint64_t pv_used;\n"
20189 "   char *pv_attr;\n"
20190 "   int64_t pv_pe_count;\n"
20191 "   int64_t pv_pe_alloc_count;\n"
20192 "   char *pv_tags;\n"
20193 "   uint64_t pe_start;\n"
20194 "   int64_t pv_mda_count;\n"
20195 "   uint64_t pv_mda_free;\n"
20196 " };\n"
20197 " \n"
20198 msgstr ""
20199
20200 # type: verbatim
20201 #. type: verbatim
20202 #: ../src/guestfs-structs.pod:36
20203 #, no-wrap
20204 msgid ""
20205 " struct guestfs_lvm_pv_list {\n"
20206 "   uint32_t len; /* Number of elements in list. */\n"
20207 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
20208 " };\n"
20209 " \n"
20210 msgstr ""
20211
20212 # type: verbatim
20213 #. type: verbatim
20214 #: ../src/guestfs-structs.pod:41
20215 #, no-wrap
20216 msgid ""
20217 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
20218 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
20219 "\n"
20220 msgstr ""
20221
20222 # type: =head2
20223 #. type: =head2
20224 #: ../src/guestfs-structs.pod:44
20225 msgid "guestfs_lvm_vg"
20226 msgstr ""
20227
20228 # type: verbatim
20229 #. type: verbatim
20230 #: ../src/guestfs-structs.pod:46
20231 #, no-wrap
20232 msgid ""
20233 " struct guestfs_lvm_vg {\n"
20234 "   char *vg_name;\n"
20235 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20236 "   char vg_uuid[32];\n"
20237 "   char *vg_fmt;\n"
20238 "   char *vg_attr;\n"
20239 "   uint64_t vg_size;\n"
20240 "   uint64_t vg_free;\n"
20241 "   char *vg_sysid;\n"
20242 "   uint64_t vg_extent_size;\n"
20243 "   int64_t vg_extent_count;\n"
20244 "   int64_t vg_free_count;\n"
20245 "   int64_t max_lv;\n"
20246 "   int64_t max_pv;\n"
20247 "   int64_t pv_count;\n"
20248 "   int64_t lv_count;\n"
20249 "   int64_t snap_count;\n"
20250 "   int64_t vg_seqno;\n"
20251 "   char *vg_tags;\n"
20252 "   int64_t vg_mda_count;\n"
20253 "   uint64_t vg_mda_free;\n"
20254 " };\n"
20255 " \n"
20256 msgstr ""
20257
20258 # type: verbatim
20259 #. type: verbatim
20260 #: ../src/guestfs-structs.pod:69
20261 #, no-wrap
20262 msgid ""
20263 " struct guestfs_lvm_vg_list {\n"
20264 "   uint32_t len; /* Number of elements in list. */\n"
20265 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
20266 " };\n"
20267 " \n"
20268 msgstr ""
20269
20270 # type: verbatim
20271 #. type: verbatim
20272 #: ../src/guestfs-structs.pod:74
20273 #, no-wrap
20274 msgid ""
20275 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
20276 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
20277 "\n"
20278 msgstr ""
20279
20280 # type: =head2
20281 #. type: =head2
20282 #: ../src/guestfs-structs.pod:77
20283 msgid "guestfs_lvm_lv"
20284 msgstr ""
20285
20286 # type: verbatim
20287 #. type: verbatim
20288 #: ../src/guestfs-structs.pod:79
20289 #, no-wrap
20290 msgid ""
20291 " struct guestfs_lvm_lv {\n"
20292 "   char *lv_name;\n"
20293 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20294 "   char lv_uuid[32];\n"
20295 "   char *lv_attr;\n"
20296 "   int64_t lv_major;\n"
20297 "   int64_t lv_minor;\n"
20298 "   int64_t lv_kernel_major;\n"
20299 "   int64_t lv_kernel_minor;\n"
20300 "   uint64_t lv_size;\n"
20301 "   int64_t seg_count;\n"
20302 "   char *origin;\n"
20303 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
20304 "   float snap_percent;\n"
20305 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
20306 "   float copy_percent;\n"
20307 "   char *move_pv;\n"
20308 "   char *lv_tags;\n"
20309 "   char *mirror_log;\n"
20310 "   char *modules;\n"
20311 " };\n"
20312 " \n"
20313 msgstr ""
20314
20315 # type: verbatim
20316 #. type: verbatim
20317 #: ../src/guestfs-structs.pod:101
20318 #, no-wrap
20319 msgid ""
20320 " struct guestfs_lvm_lv_list {\n"
20321 "   uint32_t len; /* Number of elements in list. */\n"
20322 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
20323 " };\n"
20324 " \n"
20325 msgstr ""
20326
20327 # type: verbatim
20328 #. type: verbatim
20329 #: ../src/guestfs-structs.pod:106
20330 #, no-wrap
20331 msgid ""
20332 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
20333 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
20334 "\n"
20335 msgstr ""
20336
20337 # type: verbatim
20338 #. type: verbatim
20339 #: ../src/guestfs-structs.pod:111
20340 #, no-wrap
20341 msgid ""
20342 " struct guestfs_stat {\n"
20343 "   int64_t dev;\n"
20344 "   int64_t ino;\n"
20345 "   int64_t mode;\n"
20346 "   int64_t nlink;\n"
20347 "   int64_t uid;\n"
20348 "   int64_t gid;\n"
20349 "   int64_t rdev;\n"
20350 "   int64_t size;\n"
20351 "   int64_t blksize;\n"
20352 "   int64_t blocks;\n"
20353 "   int64_t atime;\n"
20354 "   int64_t mtime;\n"
20355 "   int64_t ctime;\n"
20356 " };\n"
20357 " \n"
20358 msgstr ""
20359
20360 # type: verbatim
20361 #. type: verbatim
20362 #: ../src/guestfs-structs.pod:127
20363 #, no-wrap
20364 msgid ""
20365 " struct guestfs_stat_list {\n"
20366 "   uint32_t len; /* Number of elements in list. */\n"
20367 "   struct guestfs_stat *val; /* Elements. */\n"
20368 " };\n"
20369 " \n"
20370 msgstr ""
20371
20372 # type: verbatim
20373 #. type: verbatim
20374 #: ../src/guestfs-structs.pod:132
20375 #, no-wrap
20376 msgid ""
20377 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
20378 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
20379 "\n"
20380 msgstr ""
20381
20382 # type: verbatim
20383 #. type: verbatim
20384 #: ../src/guestfs-structs.pod:137
20385 #, no-wrap
20386 msgid ""
20387 " struct guestfs_statvfs {\n"
20388 "   int64_t bsize;\n"
20389 "   int64_t frsize;\n"
20390 "   int64_t blocks;\n"
20391 "   int64_t bfree;\n"
20392 "   int64_t bavail;\n"
20393 "   int64_t files;\n"
20394 "   int64_t ffree;\n"
20395 "   int64_t favail;\n"
20396 "   int64_t fsid;\n"
20397 "   int64_t flag;\n"
20398 "   int64_t namemax;\n"
20399 " };\n"
20400 " \n"
20401 msgstr ""
20402
20403 # type: verbatim
20404 #. type: verbatim
20405 #: ../src/guestfs-structs.pod:151
20406 #, no-wrap
20407 msgid ""
20408 " struct guestfs_statvfs_list {\n"
20409 "   uint32_t len; /* Number of elements in list. */\n"
20410 "   struct guestfs_statvfs *val; /* Elements. */\n"
20411 " };\n"
20412 " \n"
20413 msgstr ""
20414
20415 # type: verbatim
20416 #. type: verbatim
20417 #: ../src/guestfs-structs.pod:156
20418 #, no-wrap
20419 msgid ""
20420 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
20421 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
20422 "\n"
20423 msgstr ""
20424
20425 # type: =head2
20426 #. type: =head2
20427 #: ../src/guestfs-structs.pod:159
20428 msgid "guestfs_dirent"
20429 msgstr ""
20430
20431 # type: verbatim
20432 #. type: verbatim
20433 #: ../src/guestfs-structs.pod:161
20434 #, no-wrap
20435 msgid ""
20436 " struct guestfs_dirent {\n"
20437 "   int64_t ino;\n"
20438 "   char ftyp;\n"
20439 "   char *name;\n"
20440 " };\n"
20441 " \n"
20442 msgstr ""
20443
20444 # type: verbatim
20445 #. type: verbatim
20446 #: ../src/guestfs-structs.pod:167
20447 #, no-wrap
20448 msgid ""
20449 " struct guestfs_dirent_list {\n"
20450 "   uint32_t len; /* Number of elements in list. */\n"
20451 "   struct guestfs_dirent *val; /* Elements. */\n"
20452 " };\n"
20453 " \n"
20454 msgstr ""
20455
20456 # type: verbatim
20457 #. type: verbatim
20458 #: ../src/guestfs-structs.pod:172
20459 #, no-wrap
20460 msgid ""
20461 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
20462 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
20463 "\n"
20464 msgstr ""
20465
20466 # type: verbatim
20467 #. type: verbatim
20468 #: ../src/guestfs-structs.pod:177
20469 #, no-wrap
20470 msgid ""
20471 " struct guestfs_version {\n"
20472 "   int64_t major;\n"
20473 "   int64_t minor;\n"
20474 "   int64_t release;\n"
20475 "   char *extra;\n"
20476 " };\n"
20477 " \n"
20478 msgstr ""
20479
20480 # type: verbatim
20481 #. type: verbatim
20482 #: ../src/guestfs-structs.pod:184
20483 #, no-wrap
20484 msgid ""
20485 " struct guestfs_version_list {\n"
20486 "   uint32_t len; /* Number of elements in list. */\n"
20487 "   struct guestfs_version *val; /* Elements. */\n"
20488 " };\n"
20489 " \n"
20490 msgstr ""
20491
20492 # type: verbatim
20493 #. type: verbatim
20494 #: ../src/guestfs-structs.pod:189
20495 #, no-wrap
20496 msgid ""
20497 " void guestfs_free_version (struct guestfs_free_version *);\n"
20498 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
20499 "\n"
20500 msgstr ""
20501
20502 # type: =head2
20503 #. type: =head2
20504 #: ../src/guestfs-structs.pod:192
20505 msgid "guestfs_xattr"
20506 msgstr ""
20507
20508 # type: verbatim
20509 #. type: verbatim
20510 #: ../src/guestfs-structs.pod:194
20511 #, no-wrap
20512 msgid ""
20513 " struct guestfs_xattr {\n"
20514 "   char *attrname;\n"
20515 "   /* The next two fields describe a byte array. */\n"
20516 "   uint32_t attrval_len;\n"
20517 "   char *attrval;\n"
20518 " };\n"
20519 " \n"
20520 msgstr ""
20521
20522 # type: verbatim
20523 #. type: verbatim
20524 #: ../src/guestfs-structs.pod:201
20525 #, no-wrap
20526 msgid ""
20527 " struct guestfs_xattr_list {\n"
20528 "   uint32_t len; /* Number of elements in list. */\n"
20529 "   struct guestfs_xattr *val; /* Elements. */\n"
20530 " };\n"
20531 " \n"
20532 msgstr ""
20533
20534 # type: verbatim
20535 #. type: verbatim
20536 #: ../src/guestfs-structs.pod:206
20537 #, no-wrap
20538 msgid ""
20539 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
20540 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
20541 "\n"
20542 msgstr ""
20543
20544 # type: =head2
20545 #. type: =head2
20546 #: ../src/guestfs-structs.pod:209
20547 msgid "guestfs_inotify_event"
20548 msgstr ""
20549
20550 # type: verbatim
20551 #. type: verbatim
20552 #: ../src/guestfs-structs.pod:211
20553 #, no-wrap
20554 msgid ""
20555 " struct guestfs_inotify_event {\n"
20556 "   int64_t in_wd;\n"
20557 "   uint32_t in_mask;\n"
20558 "   uint32_t in_cookie;\n"
20559 "   char *in_name;\n"
20560 " };\n"
20561 " \n"
20562 msgstr ""
20563
20564 # type: verbatim
20565 #. type: verbatim
20566 #: ../src/guestfs-structs.pod:218
20567 #, no-wrap
20568 msgid ""
20569 " struct guestfs_inotify_event_list {\n"
20570 "   uint32_t len; /* Number of elements in list. */\n"
20571 "   struct guestfs_inotify_event *val; /* Elements. */\n"
20572 " };\n"
20573 " \n"
20574 msgstr ""
20575
20576 # type: verbatim
20577 #. type: verbatim
20578 #: ../src/guestfs-structs.pod:223
20579 #, no-wrap
20580 msgid ""
20581 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
20582 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
20583 "\n"
20584 msgstr ""
20585
20586 # type: =head2
20587 #. type: =head2
20588 #: ../src/guestfs-structs.pod:226
20589 msgid "guestfs_partition"
20590 msgstr ""
20591
20592 # type: verbatim
20593 #. type: verbatim
20594 #: ../src/guestfs-structs.pod:228
20595 #, no-wrap
20596 msgid ""
20597 " struct guestfs_partition {\n"
20598 "   int32_t part_num;\n"
20599 "   uint64_t part_start;\n"
20600 "   uint64_t part_end;\n"
20601 "   uint64_t part_size;\n"
20602 " };\n"
20603 " \n"
20604 msgstr ""
20605
20606 # type: verbatim
20607 #. type: verbatim
20608 #: ../src/guestfs-structs.pod:235
20609 #, no-wrap
20610 msgid ""
20611 " struct guestfs_partition_list {\n"
20612 "   uint32_t len; /* Number of elements in list. */\n"
20613 "   struct guestfs_partition *val; /* Elements. */\n"
20614 " };\n"
20615 " \n"
20616 msgstr ""
20617
20618 # type: verbatim
20619 #. type: verbatim
20620 #: ../src/guestfs-structs.pod:240
20621 #, no-wrap
20622 msgid ""
20623 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
20624 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
20625 "\n"
20626 msgstr ""
20627
20628 # type: =head2
20629 #. type: =head2
20630 #: ../src/guestfs-structs.pod:243
20631 msgid "guestfs_application"
20632 msgstr ""
20633
20634 # type: verbatim
20635 #. type: verbatim
20636 #: ../src/guestfs-structs.pod:245
20637 #, no-wrap
20638 msgid ""
20639 " struct guestfs_application {\n"
20640 "   char *app_name;\n"
20641 "   char *app_display_name;\n"
20642 "   int32_t app_epoch;\n"
20643 "   char *app_version;\n"
20644 "   char *app_release;\n"
20645 "   char *app_install_path;\n"
20646 "   char *app_trans_path;\n"
20647 "   char *app_publisher;\n"
20648 "   char *app_url;\n"
20649 "   char *app_source_package;\n"
20650 "   char *app_summary;\n"
20651 "   char *app_description;\n"
20652 " };\n"
20653 " \n"
20654 msgstr ""
20655
20656 # type: verbatim
20657 #. type: verbatim
20658 #: ../src/guestfs-structs.pod:260
20659 #, no-wrap
20660 msgid ""
20661 " struct guestfs_application_list {\n"
20662 "   uint32_t len; /* Number of elements in list. */\n"
20663 "   struct guestfs_application *val; /* Elements. */\n"
20664 " };\n"
20665 " \n"
20666 msgstr ""
20667
20668 # type: verbatim
20669 #. type: verbatim
20670 #: ../src/guestfs-structs.pod:265
20671 #, no-wrap
20672 msgid ""
20673 " void guestfs_free_application (struct guestfs_free_application *);\n"
20674 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
20675 "\n"
20676 msgstr ""
20677
20678 # type: textblock
20679 #. type: textblock
20680 #: ../fish/guestfish.pod:5
20681 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
20682 msgstr ""
20683
20684 # type: verbatim
20685 #. type: verbatim
20686 #: ../fish/guestfish.pod:9
20687 #, no-wrap
20688 msgid ""
20689 " guestfish [--options] [commands]\n"
20690 "\n"
20691 msgstr ""
20692
20693 # type: verbatim
20694 #. type: verbatim
20695 #: ../fish/guestfish.pod:11
20696 #, no-wrap
20697 msgid ""
20698 " guestfish\n"
20699 "\n"
20700 msgstr ""
20701
20702 # type: verbatim
20703 #. type: verbatim
20704 #: ../fish/guestfish.pod:13
20705 #, no-wrap
20706 msgid ""
20707 " guestfish [--ro|--rw] -a disk.img\n"
20708 "\n"
20709 msgstr ""
20710
20711 # type: verbatim
20712 #. type: verbatim
20713 #: ../fish/guestfish.pod:15
20714 #, no-wrap
20715 msgid ""
20716 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
20717 "\n"
20718 msgstr ""
20719
20720 # type: verbatim
20721 #. type: verbatim
20722 #: ../fish/guestfish.pod:17
20723 #, no-wrap
20724 msgid ""
20725 " guestfish -d libvirt-domain\n"
20726 "\n"
20727 msgstr ""
20728
20729 # type: verbatim
20730 #. type: verbatim
20731 #: ../fish/guestfish.pod:19
20732 #, no-wrap
20733 msgid ""
20734 " guestfish [--ro|--rw] -a disk.img -i\n"
20735 "\n"
20736 msgstr ""
20737
20738 # type: verbatim
20739 #. type: verbatim
20740 #: ../fish/guestfish.pod:21
20741 #, no-wrap
20742 msgid ""
20743 " guestfish -d libvirt-domain -i\n"
20744 "\n"
20745 msgstr ""
20746
20747 # type: =head1
20748 #. type: =head1
20749 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
20750 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
20751 msgid "WARNING"
20752 msgstr ""
20753
20754 # type: textblock
20755 #. type: textblock
20756 #: ../fish/guestfish.pod:25
20757 msgid ""
20758 "Using guestfish in read/write mode on live virtual machines can be "
20759 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
20760 "option to use guestfish safely if the disk image or virtual machine might be "
20761 "live."
20762 msgstr ""
20763
20764 # type: textblock
20765 #. type: textblock
20766 #: ../fish/guestfish.pod:32
20767 msgid ""
20768 "Guestfish is a shell and command-line tool for examining and modifying "
20769 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
20770 "functionality of the guestfs API, see L<guestfs(3)>."
20771 msgstr ""
20772
20773 # type: textblock
20774 #. type: textblock
20775 #: ../fish/guestfish.pod:36
20776 msgid ""
20777 "Guestfish gives you structured access to the libguestfs API, from shell "
20778 "scripts or the command line or interactively.  If you want to rescue a "
20779 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
20780 "command."
20781 msgstr ""
20782
20783 # type: =head1
20784 #. type: =head1
20785 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:928
20786 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:58
20787 #: ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:50
20788 msgid "EXAMPLES"
20789 msgstr ""
20790
20791 # type: =head2
20792 #. type: =head2
20793 #: ../fish/guestfish.pod:43
20794 msgid "As an interactive shell"
20795 msgstr ""
20796
20797 # type: verbatim
20798 #. type: verbatim
20799 #: ../fish/guestfish.pod:45
20800 #, no-wrap
20801 msgid ""
20802 " $ guestfish\n"
20803 " \n"
20804 msgstr ""
20805
20806 # type: verbatim
20807 #. type: verbatim
20808 #: ../fish/guestfish.pod:47
20809 #, no-wrap
20810 msgid ""
20811 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
20812 " editing virtual machine filesystems.\n"
20813 " \n"
20814 msgstr ""
20815
20816 # type: verbatim
20817 #. type: verbatim
20818 #: ../fish/guestfish.pod:50
20819 #, no-wrap
20820 msgid ""
20821 " Type: 'help' for a list of commands\n"
20822 "       'man' to read the manual\n"
20823 "       'quit' to quit the shell\n"
20824 " \n"
20825 msgstr ""
20826
20827 # type: verbatim
20828 #. type: verbatim
20829 #: ../fish/guestfish.pod:54
20830 #, no-wrap
20831 msgid ""
20832 " ><fs> add-ro disk.img\n"
20833 " ><fs> run\n"
20834 " ><fs> list-filesystems\n"
20835 " /dev/sda1: ext4\n"
20836 " /dev/vg_guest/lv_root: ext4\n"
20837 " /dev/vg_guest/lv_swap: swap\n"
20838 " ><fs> mount /dev/vg_guest/lv_root /\n"
20839 " ><fs> cat /etc/fstab\n"
20840 " # /etc/fstab\n"
20841 " # Created by anaconda\n"
20842 " [...]\n"
20843 " ><fs> exit\n"
20844 "\n"
20845 msgstr ""
20846
20847 # type: =head2
20848 #. type: =head2
20849 #: ../fish/guestfish.pod:67
20850 msgid "From shell scripts"
20851 msgstr ""
20852
20853 # type: textblock
20854 #. type: textblock
20855 #: ../fish/guestfish.pod:69
20856 msgid "Create a new C</etc/motd> file in a guest or disk image:"
20857 msgstr ""
20858
20859 # type: verbatim
20860 #. type: verbatim
20861 #: ../fish/guestfish.pod:71
20862 #, no-wrap
20863 msgid ""
20864 " guestfish <<_EOF_\n"
20865 " add disk.img\n"
20866 " run\n"
20867 " mount /dev/vg_guest/lv_root /\n"
20868 " write /etc/motd \"Welcome, new users\"\n"
20869 " _EOF_\n"
20870 "\n"
20871 msgstr ""
20872
20873 # type: textblock
20874 #. type: textblock
20875 #: ../fish/guestfish.pod:78
20876 msgid "List the LVM logical volumes in a disk image:"
20877 msgstr ""
20878
20879 # type: verbatim
20880 #. type: verbatim
20881 #: ../fish/guestfish.pod:80
20882 #, no-wrap
20883 msgid ""
20884 " guestfish -a disk.img --ro <<_EOF_\n"
20885 " run\n"
20886 " lvs\n"
20887 " _EOF_\n"
20888 "\n"
20889 msgstr ""
20890
20891 # type: textblock
20892 #. type: textblock
20893 #: ../fish/guestfish.pod:85
20894 msgid "List all the filesystems in a disk image:"
20895 msgstr ""
20896
20897 # type: verbatim
20898 #. type: verbatim
20899 #: ../fish/guestfish.pod:87
20900 #, no-wrap
20901 msgid ""
20902 " guestfish -a disk.img --ro <<_EOF_\n"
20903 " run\n"
20904 " list-filesystems\n"
20905 " _EOF_\n"
20906 "\n"
20907 msgstr ""
20908
20909 # type: =head2
20910 #. type: =head2
20911 #: ../fish/guestfish.pod:92
20912 msgid "On one command line"
20913 msgstr ""
20914
20915 # type: textblock
20916 #. type: textblock
20917 #: ../fish/guestfish.pod:94
20918 msgid "Update C</etc/resolv.conf> in a guest:"
20919 msgstr ""
20920
20921 # type: verbatim
20922 #. type: verbatim
20923 #: ../fish/guestfish.pod:96
20924 #, no-wrap
20925 msgid ""
20926 " guestfish \\\n"
20927 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
20928 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
20929 "\n"
20930 msgstr ""
20931
20932 # type: textblock
20933 #. type: textblock
20934 #: ../fish/guestfish.pod:100
20935 msgid "Edit C</boot/grub/grub.conf> interactively:"
20936 msgstr ""
20937
20938 # type: verbatim
20939 #. type: verbatim
20940 #: ../fish/guestfish.pod:102
20941 #, no-wrap
20942 msgid ""
20943 " guestfish --rw --add disk.img \\\n"
20944 "   --mount /dev/vg_guest/lv_root \\\n"
20945 "   --mount /dev/sda1:/boot \\\n"
20946 "   edit /boot/grub/grub.conf\n"
20947 "\n"
20948 msgstr ""
20949
20950 # type: =head2
20951 #. type: =head2
20952 #: ../fish/guestfish.pod:107
20953 msgid "Mount disks automatically"
20954 msgstr ""
20955
20956 # type: textblock
20957 #. type: textblock
20958 #: ../fish/guestfish.pod:109
20959 msgid ""
20960 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
20961 msgstr ""
20962
20963 # type: verbatim
20964 #. type: verbatim
20965 #: ../fish/guestfish.pod:112
20966 #, no-wrap
20967 msgid ""
20968 " guestfish --ro -a disk.img -i cat /etc/group\n"
20969 "\n"
20970 msgstr ""
20971
20972 # type: verbatim
20973 #. type: verbatim
20974 #: ../fish/guestfish.pod:114
20975 #, no-wrap
20976 msgid ""
20977 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
20978 "\n"
20979 msgstr ""
20980
20981 # type: textblock
20982 #. type: textblock
20983 #: ../fish/guestfish.pod:116
20984 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
20985 msgstr ""
20986
20987 # type: verbatim
20988 #. type: verbatim
20989 #: ../fish/guestfish.pod:118
20990 #, no-wrap
20991 msgid ""
20992 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
20993 "\n"
20994 msgstr ""
20995
20996 # type: =head2
20997 #. type: =head2
20998 #: ../fish/guestfish.pod:120
20999 msgid "As a script interpreter"
21000 msgstr ""
21001
21002 # type: textblock
21003 #. type: textblock
21004 #: ../fish/guestfish.pod:122
21005 msgid "Create a 100MB disk containing an ext2-formatted partition:"
21006 msgstr ""
21007
21008 # type: verbatim
21009 #. type: verbatim
21010 #: ../fish/guestfish.pod:124
21011 #, no-wrap
21012 msgid ""
21013 " #!/usr/bin/guestfish -f\n"
21014 " sparse test1.img 100M\n"
21015 " run\n"
21016 " part-disk /dev/sda mbr\n"
21017 " mkfs ext2 /dev/sda1\n"
21018 "\n"
21019 msgstr ""
21020
21021 # type: =head2
21022 #. type: =head2
21023 #: ../fish/guestfish.pod:130
21024 msgid "Start with a prepared disk"
21025 msgstr ""
21026
21027 # type: textblock
21028 #. type: textblock
21029 #: ../fish/guestfish.pod:132
21030 msgid ""
21031 "An alternate way to create a 100MB disk called C<test1.img> containing a "
21032 "single ext2-formatted partition:"
21033 msgstr ""
21034
21035 # type: verbatim
21036 #. type: verbatim
21037 #: ../fish/guestfish.pod:135
21038 #, no-wrap
21039 msgid ""
21040 " guestfish -N fs\n"
21041 "\n"
21042 msgstr ""
21043
21044 # type: textblock
21045 #. type: textblock
21046 #: ../fish/guestfish.pod:137
21047 msgid "To list what is available do:"
21048 msgstr ""
21049
21050 # type: verbatim
21051 #. type: verbatim
21052 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:919
21053 #, no-wrap
21054 msgid ""
21055 " guestfish -N help | less\n"
21056 "\n"
21057 msgstr ""
21058
21059 # type: =head2
21060 #. type: =head2
21061 #: ../fish/guestfish.pod:141
21062 msgid "Remote control"
21063 msgstr ""
21064
21065 # type: verbatim
21066 #. type: verbatim
21067 #: ../fish/guestfish.pod:143
21068 #, no-wrap
21069 msgid ""
21070 " eval \"`guestfish --listen`\"\n"
21071 " guestfish --remote add-ro disk.img\n"
21072 " guestfish --remote run\n"
21073 " guestfish --remote lvs\n"
21074 "\n"
21075 msgstr ""
21076
21077 # type: =head1
21078 #. type: =head1
21079 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
21080 #: ../fuse/guestmount.pod:73 ../tools/virt-edit.pl:72
21081 #: ../tools/virt-win-reg.pl:96 ../tools/virt-resize.pl:254
21082 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:103
21083 #: ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
21084 msgid "OPTIONS"
21085 msgstr ""
21086
21087 # type: =item
21088 #. type: =item
21089 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:131
21090 #: ../tools/virt-edit.pl:80 ../tools/virt-win-reg.pl:104
21091 #: ../tools/virt-resize.pl:262 ../tools/virt-list-filesystems.pl:61
21092 #: ../tools/virt-tar.pl:111 ../tools/virt-make-fs.pl:161
21093 #: ../tools/virt-list-partitions.pl:62
21094 msgid "B<--help>"
21095 msgstr ""
21096
21097 # type: textblock
21098 #. type: textblock
21099 #: ../fish/guestfish.pod:154
21100 msgid "Displays general help on options."
21101 msgstr ""
21102
21103 # type: =item
21104 #. type: =item
21105 #: ../fish/guestfish.pod:156
21106 msgid "B<-h>"
21107 msgstr ""
21108
21109 # type: =item
21110 #. type: =item
21111 #: ../fish/guestfish.pod:158
21112 msgid "B<--cmd-help>"
21113 msgstr ""
21114
21115 # type: textblock
21116 #. type: textblock
21117 #: ../fish/guestfish.pod:160
21118 msgid "Lists all available guestfish commands."
21119 msgstr ""
21120
21121 # type: =item
21122 #. type: =item
21123 #: ../fish/guestfish.pod:162
21124 msgid "B<-h cmd>"
21125 msgstr ""
21126
21127 # type: =item
21128 #. type: =item
21129 #: ../fish/guestfish.pod:164
21130 msgid "B<--cmd-help cmd>"
21131 msgstr ""
21132
21133 # type: textblock
21134 #. type: textblock
21135 #: ../fish/guestfish.pod:166
21136 msgid "Displays detailed help on a single command C<cmd>."
21137 msgstr ""
21138
21139 # type: =item
21140 #. type: =item
21141 #: ../fish/guestfish.pod:168
21142 msgid "B<-a image>"
21143 msgstr ""
21144
21145 # type: =item
21146 #. type: =item
21147 #: ../fish/guestfish.pod:170
21148 msgid "B<--add image>"
21149 msgstr ""
21150
21151 # type: textblock
21152 #. type: textblock
21153 #: ../fish/guestfish.pod:172
21154 msgid "Add a block device or virtual machine image to the shell."
21155 msgstr ""
21156
21157 # type: textblock
21158 #. type: textblock
21159 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:81
21160 msgid ""
21161 "The format of the disk image is auto-detected.  To override this and force a "
21162 "particular format use the I<--format=..> option."
21163 msgstr ""
21164
21165 # type: textblock
21166 #. type: textblock
21167 #: ../fish/guestfish.pod:177
21168 msgid ""
21169 "Using this flag is mostly equivalent to using the C<add> command, with "
21170 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
21171 "the I<--format:...> flag was given."
21172 msgstr ""
21173
21174 # type: =item
21175 #. type: =item
21176 #: ../fish/guestfish.pod:181
21177 msgid "B<-c URI>"
21178 msgstr ""
21179
21180 # type: =item
21181 #. type: =item
21182 #: ../fish/guestfish.pod:183
21183 msgid "B<--connect URI>"
21184 msgstr ""
21185
21186 # type: textblock
21187 #. type: textblock
21188 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:86
21189 msgid ""
21190 "When used in conjunction with the I<-d> option, this specifies the libvirt "
21191 "URI to use.  The default is to use the default libvirt connection."
21192 msgstr ""
21193
21194 # type: =item
21195 #. type: =item
21196 #: ../fish/guestfish.pod:189
21197 msgid "B<--csh>"
21198 msgstr ""
21199
21200 # type: textblock
21201 #. type: textblock
21202 #: ../fish/guestfish.pod:191
21203 msgid ""
21204 "If using the I<--listen> option and a csh-like shell, use this option.  See "
21205 "section L</REMOTE CONTROL AND CSH> below."
21206 msgstr ""
21207
21208 # type: =item
21209 #. type: =item
21210 #: ../fish/guestfish.pod:194
21211 msgid "B<-d libvirt-domain>"
21212 msgstr ""
21213
21214 # type: =item
21215 #. type: =item
21216 #: ../fish/guestfish.pod:196
21217 msgid "B<--domain libvirt-domain>"
21218 msgstr ""
21219
21220 # type: textblock
21221 #. type: textblock
21222 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:92
21223 msgid ""
21224 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
21225 "used, then any libvirt domain can be used.  However in write mode, only "
21226 "libvirt domains which are shut down can be named here."
21227 msgstr ""
21228
21229 # type: textblock
21230 #. type: textblock
21231 #: ../fish/guestfish.pod:202
21232 msgid ""
21233 "Using this flag is mostly equivalent to using the C<add-domain> command, "
21234 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
21235 "if the I<--format:...> flag was given."
21236 msgstr ""
21237
21238 # type: =item
21239 #. type: =item
21240 #: ../fish/guestfish.pod:206
21241 msgid "B<-D>"
21242 msgstr ""
21243
21244 # type: =item
21245 #. type: =item
21246 #: ../fish/guestfish.pod:208
21247 msgid "B<--no-dest-paths>"
21248 msgstr ""
21249
21250 # type: textblock
21251 #. type: textblock
21252 #: ../fish/guestfish.pod:210
21253 msgid ""
21254 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
21255 "to hit the tab key to complete paths on the guest filesystem, but this "
21256 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
21257 "allow this feature to be disabled."
21258 msgstr ""
21259
21260 # type: =item
21261 #. type: =item
21262 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:108
21263 msgid "B<--echo-keys>"
21264 msgstr ""
21265
21266 # type: textblock
21267 #. type: textblock
21268 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:110
21269 msgid ""
21270 "When prompting for keys and passphrases, guestfish normally turns echoing "
21271 "off so you cannot see what you are typing.  If you are not worried about "
21272 "Tempest attacks and there is no one else in the room you can specify this "
21273 "flag to see what you are typing."
21274 msgstr ""
21275
21276 # type: =item
21277 #. type: =item
21278 #: ../fish/guestfish.pod:222
21279 msgid "B<-f file>"
21280 msgstr ""
21281
21282 # type: =item
21283 #. type: =item
21284 #: ../fish/guestfish.pod:224
21285 msgid "B<--file file>"
21286 msgstr ""
21287
21288 # type: textblock
21289 #. type: textblock
21290 #: ../fish/guestfish.pod:226
21291 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
21292 msgstr ""
21293
21294 # type: verbatim
21295 #. type: verbatim
21296 #: ../fish/guestfish.pod:229
21297 #, no-wrap
21298 msgid ""
21299 " #!/usr/bin/guestfish -f\n"
21300 "\n"
21301 msgstr ""
21302
21303 # type: =item
21304 #. type: =item
21305 #: ../fish/guestfish.pod:231
21306 msgid "B<--format=raw|qcow2|..>"
21307 msgstr ""
21308
21309 # type: =item
21310 #. type: =item
21311 #: ../fish/guestfish.pod:233
21312 msgid "B<--format>"
21313 msgstr ""
21314
21315 # type: textblock
21316 #. type: textblock
21317 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:117
21318 msgid ""
21319 "The default for the I<-a> option is to auto-detect the format of the disk "
21320 "image.  Using this forces the disk format for I<-a> options which follow on "
21321 "the command line.  Using I<--format> with no argument switches back to auto-"
21322 "detection for subsequent I<-a> options."
21323 msgstr ""
21324
21325 # type: verbatim
21326 #. type: verbatim
21327 #: ../fish/guestfish.pod:242
21328 #, no-wrap
21329 msgid ""
21330 " guestfish --format=raw -a disk.img\n"
21331 "\n"
21332 msgstr ""
21333
21334 # type: textblock
21335 #. type: textblock
21336 #: ../fish/guestfish.pod:244
21337 msgid "forces raw format (no auto-detection) for C<disk.img>."
21338 msgstr ""
21339
21340 # type: verbatim
21341 #. type: verbatim
21342 #: ../fish/guestfish.pod:246
21343 #, no-wrap
21344 msgid ""
21345 " guestfish --format=raw -a disk.img --format -a another.img\n"
21346 "\n"
21347 msgstr ""
21348
21349 # type: textblock
21350 #. type: textblock
21351 #: ../fish/guestfish.pod:248
21352 msgid ""
21353 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
21354 "detection for C<another.img>."
21355 msgstr ""
21356
21357 # type: textblock
21358 #. type: textblock
21359 #: ../fish/guestfish.pod:251
21360 msgid ""
21361 "If you have untrusted raw-format guest disk images, you should use this "
21362 "option to specify the disk format.  This avoids a possible security problem "
21363 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
21364 msgstr ""
21365
21366 # type: =item
21367 #. type: =item
21368 #: ../fish/guestfish.pod:256
21369 msgid "B<-i>"
21370 msgstr ""
21371
21372 # type: =item
21373 #. type: =item
21374 #: ../fish/guestfish.pod:258
21375 msgid "B<--inspector>"
21376 msgstr ""
21377
21378 # type: textblock
21379 #. type: textblock
21380 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:137
21381 msgid ""
21382 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
21383 "system and mount filesystems as they would be mounted on the real virtual "
21384 "machine."
21385 msgstr ""
21386
21387 # type: textblock
21388 #. type: textblock
21389 #: ../fish/guestfish.pod:264
21390 msgid "Typical usage is either:"
21391 msgstr ""
21392
21393 # type: verbatim
21394 #. type: verbatim
21395 #: ../fish/guestfish.pod:266
21396 #, no-wrap
21397 msgid ""
21398 " guestfish -d myguest -i\n"
21399 "\n"
21400 msgstr ""
21401
21402 # type: textblock
21403 #. type: textblock
21404 #: ../fish/guestfish.pod:268
21405 msgid "(for an inactive libvirt domain called I<myguest>), or:"
21406 msgstr ""
21407
21408 # type: verbatim
21409 #. type: verbatim
21410 #: ../fish/guestfish.pod:270
21411 #, no-wrap
21412 msgid ""
21413 " guestfish --ro -d myguest -i\n"
21414 "\n"
21415 msgstr ""
21416
21417 # type: textblock
21418 #. type: textblock
21419 #: ../fish/guestfish.pod:272
21420 msgid "(for active domains, readonly), or specify the block device directly:"
21421 msgstr ""
21422
21423 # type: verbatim
21424 #. type: verbatim
21425 #: ../fish/guestfish.pod:274
21426 #, no-wrap
21427 msgid ""
21428 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
21429 "\n"
21430 msgstr ""
21431
21432 # type: textblock
21433 #. type: textblock
21434 #: ../fish/guestfish.pod:276
21435 msgid ""
21436 "Note that the command line syntax changed slightly over older versions of "
21437 "guestfish.  You can still use the old syntax:"
21438 msgstr ""
21439
21440 # type: verbatim
21441 #. type: verbatim
21442 #: ../fish/guestfish.pod:279
21443 #, no-wrap
21444 msgid ""
21445 " guestfish [--ro] -i disk.img\n"
21446 "\n"
21447 msgstr ""
21448
21449 # type: verbatim
21450 #. type: verbatim
21451 #: ../fish/guestfish.pod:281
21452 #, no-wrap
21453 msgid ""
21454 " guestfish [--ro] -i libvirt-domain\n"
21455 "\n"
21456 msgstr ""
21457
21458 # type: textblock
21459 #. type: textblock
21460 #: ../fish/guestfish.pod:283
21461 msgid ""
21462 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
21463 "then using other commands to mount the filesystems that were found."
21464 msgstr ""
21465
21466 # type: =item
21467 #. type: =item
21468 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:141
21469 msgid "B<--keys-from-stdin>"
21470 msgstr ""
21471
21472 # type: textblock
21473 #. type: textblock
21474 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:143
21475 msgid ""
21476 "Read key or passphrase parameters from stdin.  The default is to try to read "
21477 "passphrases from the user by opening C</dev/tty>."
21478 msgstr ""
21479
21480 # type: =item
21481 #. type: =item
21482 #: ../fish/guestfish.pod:292
21483 msgid "B<--listen>"
21484 msgstr ""
21485
21486 # type: textblock
21487 #. type: textblock
21488 #: ../fish/guestfish.pod:294
21489 msgid ""
21490 "Fork into the background and listen for remote commands.  See section L</"
21491 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
21492 msgstr ""
21493
21494 #. type: =item
21495 #: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:146
21496 msgid "B<--live>"
21497 msgstr ""
21498
21499 #. type: textblock
21500 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:148
21501 msgid ""
21502 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
21503 "ATTACHING TO RUNNING DAEMONS>)."
21504 msgstr ""
21505
21506 # type: =item
21507 #. type: =item
21508 #: ../fish/guestfish.pod:302
21509 msgid "B<-m dev[:mountpoint]>"
21510 msgstr ""
21511
21512 # type: =item
21513 #. type: =item
21514 #: ../fish/guestfish.pod:304
21515 msgid "B<--mount dev[:mountpoint]>"
21516 msgstr ""
21517
21518 # type: textblock
21519 #. type: textblock
21520 #: ../fish/guestfish.pod:306
21521 msgid "Mount the named partition or logical volume on the given mountpoint."
21522 msgstr ""
21523
21524 # type: textblock
21525 #. type: textblock
21526 #: ../fish/guestfish.pod:308
21527 msgid "If the mountpoint is omitted, it defaults to C</>."
21528 msgstr ""
21529
21530 # type: textblock
21531 #. type: textblock
21532 #: ../fish/guestfish.pod:310
21533 msgid "You have to mount something on C</> before most commands will work."
21534 msgstr ""
21535
21536 # type: textblock
21537 #. type: textblock
21538 #: ../fish/guestfish.pod:312
21539 msgid ""
21540 "If any I<-m> or I<--mount> options are given, the guest is automatically "
21541 "launched."
21542 msgstr ""
21543
21544 # type: textblock
21545 #. type: textblock
21546 #: ../fish/guestfish.pod:315
21547 msgid ""
21548 "If you don't know what filesystems a disk image contains, you can either run "
21549 "guestfish without this option, then list the partitions, filesystems and LVs "
21550 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
21551 "commands), or you can use the L<virt-filesystems(1)> program."
21552 msgstr ""
21553
21554 # type: textblock
21555 #. type: textblock
21556 #: ../fish/guestfish.pod:321
21557 msgid ""
21558 "Using this flag is mostly equivalent to using the C<mount-options> command "
21559 "or the C<mount-ro> command if the I<--ro> flag was given."
21560 msgstr ""
21561
21562 # type: =item
21563 #. type: =item
21564 #: ../fish/guestfish.pod:324
21565 msgid "B<-n>"
21566 msgstr ""
21567
21568 # type: =item
21569 #. type: =item
21570 #: ../fish/guestfish.pod:326
21571 msgid "B<--no-sync>"
21572 msgstr ""
21573
21574 # type: textblock
21575 #. type: textblock
21576 #: ../fish/guestfish.pod:328
21577 msgid ""
21578 "Disable autosync.  This is enabled by default.  See the discussion of "
21579 "autosync in the L<guestfs(3)> manpage."
21580 msgstr ""
21581
21582 # type: =item
21583 #. type: =item
21584 #: ../fish/guestfish.pod:331
21585 msgid "B<-N type>"
21586 msgstr ""
21587
21588 # type: =item
21589 #. type: =item
21590 #: ../fish/guestfish.pod:333
21591 msgid "B<--new type>"
21592 msgstr ""
21593
21594 # type: =item
21595 #. type: =item
21596 #: ../fish/guestfish.pod:335
21597 msgid "B<-N help>"
21598 msgstr ""
21599
21600 # type: textblock
21601 #. type: textblock
21602 #: ../fish/guestfish.pod:337
21603 msgid ""
21604 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
21605 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
21606 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
21607 "IMAGES> below."
21608 msgstr ""
21609
21610 # type: =item
21611 #. type: =item
21612 #: ../fish/guestfish.pod:342
21613 msgid "B<--progress-bars>"
21614 msgstr ""
21615
21616 # type: textblock
21617 #. type: textblock
21618 #: ../fish/guestfish.pod:344
21619 msgid "Enable progress bars, even when guestfish is used non-interactively."
21620 msgstr ""
21621
21622 # type: textblock
21623 #. type: textblock
21624 #: ../fish/guestfish.pod:346
21625 msgid ""
21626 "Progress bars are enabled by default when guestfish is used as an "
21627 "interactive shell."
21628 msgstr ""
21629
21630 # type: =item
21631 #. type: =item
21632 #: ../fish/guestfish.pod:349
21633 msgid "B<--no-progress-bars>"
21634 msgstr ""
21635
21636 # type: textblock
21637 #. type: textblock
21638 #: ../fish/guestfish.pod:351
21639 msgid "Disable progress bars."
21640 msgstr ""
21641
21642 # type: =item
21643 #. type: =item
21644 #: ../fish/guestfish.pod:353
21645 msgid "B<--remote[=pid]>"
21646 msgstr ""
21647
21648 # type: textblock
21649 #. type: textblock
21650 #: ../fish/guestfish.pod:355
21651 msgid ""
21652 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
21653 "CONTROL GUESTFISH OVER A SOCKET> below."
21654 msgstr ""
21655
21656 # type: =item
21657 #. type: =item
21658 #: ../fish/guestfish.pod:358
21659 msgid "B<-r>"
21660 msgstr ""
21661
21662 # type: =item
21663 #. type: =item
21664 #: ../fish/guestfish.pod:360
21665 msgid "B<--ro>"
21666 msgstr ""
21667
21668 # type: textblock
21669 #. type: textblock
21670 #: ../fish/guestfish.pod:362
21671 msgid ""
21672 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
21673 "mounts are done read-only."
21674 msgstr ""
21675
21676 # type: textblock
21677 #. type: textblock
21678 #: ../fish/guestfish.pod:365
21679 msgid ""
21680 "The option must always be used if the disk image or virtual machine might be "
21681 "running, and is generally recommended in cases where you don't need write "
21682 "access to the disk."
21683 msgstr ""
21684
21685 # type: textblock
21686 #. type: textblock
21687 #: ../fish/guestfish.pod:369
21688 msgid ""
21689 "Note that prepared disk images created with I<-N> are not affected by this "
21690 "option.  Also commands like C<add> are not affected - you have to specify "
21691 "the C<readonly:true> option explicitly if you need it."
21692 msgstr ""
21693
21694 # type: textblock
21695 #. type: textblock
21696 #: ../fish/guestfish.pod:373
21697 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
21698 msgstr ""
21699
21700 # type: =item
21701 #. type: =item
21702 #: ../fish/guestfish.pod:375 ../fuse/guestmount.pod:213
21703 msgid "B<--selinux>"
21704 msgstr ""
21705
21706 # type: textblock
21707 #. type: textblock
21708 #: ../fish/guestfish.pod:377
21709 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
21710 msgstr ""
21711
21712 # type: =item
21713 #. type: =item
21714 #: ../fish/guestfish.pod:379
21715 msgid "B<-v>"
21716 msgstr ""
21717
21718 # type: =item
21719 #. type: =item
21720 #: ../fish/guestfish.pod:381
21721 msgid "B<--verbose>"
21722 msgstr ""
21723
21724 # type: textblock
21725 #. type: textblock
21726 #: ../fish/guestfish.pod:383
21727 msgid ""
21728 "Enable very verbose messages.  This is particularly useful if you find a bug."
21729 msgstr ""
21730
21731 # type: =item
21732 #. type: =item
21733 #: ../fish/guestfish.pod:386
21734 msgid "B<-V>"
21735 msgstr ""
21736
21737 # type: =item
21738 #. type: =item
21739 #: ../fish/guestfish.pod:388 ../tools/virt-edit.pl:88
21740 #: ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270
21741 #: ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:119
21742 #: ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
21743 msgid "B<--version>"
21744 msgstr ""
21745
21746 # type: textblock
21747 #. type: textblock
21748 #: ../fish/guestfish.pod:390
21749 msgid "Display the guestfish / libguestfs version number and exit."
21750 msgstr ""
21751
21752 # type: =item
21753 #. type: =item
21754 #: ../fish/guestfish.pod:392
21755 msgid "B<-w>"
21756 msgstr ""
21757
21758 # type: =item
21759 #. type: =item
21760 #: ../fish/guestfish.pod:394
21761 msgid "B<--rw>"
21762 msgstr ""
21763
21764 # type: textblock
21765 #. type: textblock
21766 #: ../fish/guestfish.pod:396
21767 msgid ""
21768 "This option does nothing at the moment.  See L</OPENING DISKS FOR READ AND "
21769 "WRITE> below."
21770 msgstr ""
21771
21772 # type: =item
21773 #. type: =item
21774 #: ../fish/guestfish.pod:399
21775 msgid "B<-x>"
21776 msgstr ""
21777
21778 # type: textblock
21779 #. type: textblock
21780 #: ../fish/guestfish.pod:401
21781 msgid "Echo each command before executing it."
21782 msgstr ""
21783
21784 # type: =head1
21785 #. type: =head1
21786 #: ../fish/guestfish.pod:405
21787 msgid "COMMANDS ON COMMAND LINE"
21788 msgstr ""
21789
21790 # type: textblock
21791 #. type: textblock
21792 #: ../fish/guestfish.pod:407
21793 msgid ""
21794 "Any additional (non-option) arguments are treated as commands to execute."
21795 msgstr ""
21796
21797 # type: textblock
21798 #. type: textblock
21799 #: ../fish/guestfish.pod:410
21800 msgid ""
21801 "Commands to execute should be separated by a colon (C<:>), where the colon "
21802 "is a separate parameter.  Thus:"
21803 msgstr ""
21804
21805 # type: verbatim
21806 #. type: verbatim
21807 #: ../fish/guestfish.pod:413
21808 #, no-wrap
21809 msgid ""
21810 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
21811 "\n"
21812 msgstr ""
21813
21814 # type: textblock
21815 #. type: textblock
21816 #: ../fish/guestfish.pod:415
21817 msgid ""
21818 "If there are no additional arguments, then we enter a shell, either an "
21819 "interactive shell with a prompt (if the input is a terminal) or a non-"
21820 "interactive shell."
21821 msgstr ""
21822
21823 # type: textblock
21824 #. type: textblock
21825 #: ../fish/guestfish.pod:419
21826 msgid ""
21827 "In either command line mode or non-interactive shell, the first command that "
21828 "gives an error causes the whole shell to exit.  In interactive mode (with a "
21829 "prompt) if a command fails, you can continue to enter commands."
21830 msgstr ""
21831
21832 # type: =head1
21833 #. type: =head1
21834 #: ../fish/guestfish.pod:424
21835 msgid "USING launch (OR run)"
21836 msgstr ""
21837
21838 # type: textblock
21839 #. type: textblock
21840 #: ../fish/guestfish.pod:426
21841 msgid ""
21842 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
21843 "then launch it, then mount any disks you need, and finally issue actions/"
21844 "commands.  So the general order of the day is:"
21845 msgstr ""
21846
21847 # type: textblock
21848 #. type: textblock
21849 #: ../fish/guestfish.pod:434
21850 msgid "add or -a/--add"
21851 msgstr ""
21852
21853 # type: textblock
21854 #. type: textblock
21855 #: ../fish/guestfish.pod:438
21856 msgid "launch (aka run)"
21857 msgstr ""
21858
21859 # type: textblock
21860 #. type: textblock
21861 #: ../fish/guestfish.pod:442
21862 msgid "mount or -m/--mount"
21863 msgstr ""
21864
21865 # type: textblock
21866 #. type: textblock
21867 #: ../fish/guestfish.pod:446
21868 msgid "any other commands"
21869 msgstr ""
21870
21871 # type: textblock
21872 #. type: textblock
21873 #: ../fish/guestfish.pod:450
21874 msgid ""
21875 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
21876 "guest before mounting or performing any other commands."
21877 msgstr ""
21878
21879 # type: textblock
21880 #. type: textblock
21881 #: ../fish/guestfish.pod:453
21882 msgid ""
21883 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
21884 "I<--new> options were given then C<run> is done automatically, simply "
21885 "because guestfish can't perform the action you asked for without doing this."
21886 msgstr ""
21887
21888 # type: =head1
21889 #. type: =head1
21890 #: ../fish/guestfish.pod:458
21891 msgid "OPENING DISKS FOR READ AND WRITE"
21892 msgstr ""
21893
21894 # type: textblock
21895 #. type: textblock
21896 #: ../fish/guestfish.pod:460
21897 msgid ""
21898 "The guestfish (and L<guestmount(1)>) options I<--ro> and I<--rw> affect "
21899 "whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> "
21900 "open disk images read-only or for writing."
21901 msgstr ""
21902
21903 # type: textblock
21904 #. type: textblock
21905 #: ../fish/guestfish.pod:464
21906 msgid ""
21907 "In libguestfs E<lt> 1.6.2, guestfish and guestmount defaulted to opening "
21908 "disk images supplied on the command line for write.  To open a disk image "
21909 "read-only you have to do I<-a image --ro>."
21910 msgstr ""
21911
21912 # type: textblock
21913 #. type: textblock
21914 #: ../fish/guestfish.pod:468
21915 msgid ""
21916 "This matters: If you accidentally open a live VM disk image writable then "
21917 "you will cause irreversible disk corruption."
21918 msgstr ""
21919
21920 #. type: textblock
21921 #: ../fish/guestfish.pod:471
21922 msgid ""
21923 "By libguestfs 1.10 we intend to change the default the other way.  Disk "
21924 "images will be opened read-only.  You will have to either specify "
21925 "I<guestfish --rw> or change a configuration file in order to get write "
21926 "access for disk images specified by those other command line options."
21927 msgstr ""
21928
21929 # type: textblock
21930 #. type: textblock
21931 #: ../fish/guestfish.pod:476
21932 msgid ""
21933 "This version of guestfish has a I<--rw> option which does nothing (it is "
21934 "already the default).  However it is highly recommended that you use this "
21935 "option to indicate that guestfish needs write access, and to prepare your "
21936 "scripts for the day when this option will be required for write access."
21937 msgstr ""
21938
21939 # type: textblock
21940 #. type: textblock
21941 #: ../fish/guestfish.pod:482
21942 msgid ""
21943 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
21944 "other libguestfs program apart from guestfish and guestmount."
21945 msgstr ""
21946
21947 # type: =head1
21948 #. type: =head1
21949 #: ../fish/guestfish.pod:485
21950 msgid "QUOTING"
21951 msgstr ""
21952
21953 # type: textblock
21954 #. type: textblock
21955 #: ../fish/guestfish.pod:487
21956 msgid ""
21957 "You can quote ordinary parameters using either single or double quotes.  For "
21958 "example:"
21959 msgstr ""
21960
21961 # type: verbatim
21962 #. type: verbatim
21963 #: ../fish/guestfish.pod:490
21964 #, no-wrap
21965 msgid ""
21966 " add \"file with a space.img\"\n"
21967 "\n"
21968 msgstr ""
21969
21970 # type: verbatim
21971 #. type: verbatim
21972 #: ../fish/guestfish.pod:492
21973 #, no-wrap
21974 msgid ""
21975 " rm '/file name'\n"
21976 "\n"
21977 msgstr ""
21978
21979 # type: verbatim
21980 #. type: verbatim
21981 #: ../fish/guestfish.pod:494
21982 #, no-wrap
21983 msgid ""
21984 " rm '/\"'\n"
21985 "\n"
21986 msgstr ""
21987
21988 # type: textblock
21989 #. type: textblock
21990 #: ../fish/guestfish.pod:496
21991 msgid ""
21992 "A few commands require a list of strings to be passed.  For these, use a "
21993 "whitespace-separated list, enclosed in quotes.  Strings containing "
21994 "whitespace to be passed through must be enclosed in single quotes.  A "
21995 "literal single quote must be escaped with a backslash."
21996 msgstr ""
21997
21998 # type: verbatim
21999 #. type: verbatim
22000 #: ../fish/guestfish.pod:501
22001 #, no-wrap
22002 msgid ""
22003 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
22004 " command \"/bin/echo 'foo      bar'\"\n"
22005 " command \"/bin/echo \\'foo\\'\"\n"
22006 "\n"
22007 msgstr ""
22008
22009 # type: =head1
22010 #. type: =head1
22011 #: ../fish/guestfish.pod:505
22012 msgid "OPTIONAL ARGUMENTS"
22013 msgstr ""
22014
22015 # type: textblock
22016 #. type: textblock
22017 #: ../fish/guestfish.pod:507
22018 msgid ""
22019 "Some commands take optional arguments.  These arguments appear in this "
22020 "documentation as C<[argname:..]>.  You can use them as in these examples:"
22021 msgstr ""
22022
22023 # type: verbatim
22024 #. type: verbatim
22025 #: ../fish/guestfish.pod:511
22026 #, no-wrap
22027 msgid ""
22028 " add-drive-opts filename\n"
22029 "\n"
22030 msgstr ""
22031
22032 # type: verbatim
22033 #. type: verbatim
22034 #: ../fish/guestfish.pod:513
22035 #, no-wrap
22036 msgid ""
22037 " add-drive-opts filename readonly:true\n"
22038 "\n"
22039 msgstr ""
22040
22041 # type: verbatim
22042 #. type: verbatim
22043 #: ../fish/guestfish.pod:515
22044 #, no-wrap
22045 msgid ""
22046 " add-drive-opts filename format:qcow2 readonly:false\n"
22047 "\n"
22048 msgstr ""
22049
22050 # type: textblock
22051 #. type: textblock
22052 #: ../fish/guestfish.pod:517
22053 msgid ""
22054 "Each optional argument can appear at most once.  All optional arguments must "
22055 "appear after the required ones."
22056 msgstr ""
22057
22058 # type: =head1
22059 #. type: =head1
22060 #: ../fish/guestfish.pod:520
22061 msgid "NUMBERS"
22062 msgstr ""
22063
22064 # type: textblock
22065 #. type: textblock
22066 #: ../fish/guestfish.pod:522
22067 msgid ""
22068 "This section applies to all commands which can take integers as parameters."
22069 msgstr ""
22070
22071 # type: =head2
22072 #. type: =head2
22073 #: ../fish/guestfish.pod:525
22074 msgid "SIZE SUFFIX"
22075 msgstr ""
22076
22077 # type: textblock
22078 #. type: textblock
22079 #: ../fish/guestfish.pod:527
22080 msgid ""
22081 "When the command takes a parameter measured in bytes, you can use one of the "
22082 "following suffixes to specify kilobytes, megabytes and larger sizes:"
22083 msgstr ""
22084
22085 # type: =item
22086 #. type: =item
22087 #: ../fish/guestfish.pod:533
22088 msgid "B<k> or B<K> or B<KiB>"
22089 msgstr ""
22090
22091 # type: textblock
22092 #. type: textblock
22093 #: ../fish/guestfish.pod:535
22094 msgid "The size in kilobytes (multiplied by 1024)."
22095 msgstr ""
22096
22097 # type: =item
22098 #. type: =item
22099 #: ../fish/guestfish.pod:537
22100 msgid "B<KB>"
22101 msgstr ""
22102
22103 # type: textblock
22104 #. type: textblock
22105 #: ../fish/guestfish.pod:539
22106 msgid "The size in SI 1000 byte units."
22107 msgstr ""
22108
22109 # type: =item
22110 #. type: =item
22111 #: ../fish/guestfish.pod:541
22112 msgid "B<M> or B<MiB>"
22113 msgstr ""
22114
22115 # type: textblock
22116 #. type: textblock
22117 #: ../fish/guestfish.pod:543
22118 msgid "The size in megabytes (multiplied by 1048576)."
22119 msgstr ""
22120
22121 # type: =item
22122 #. type: =item
22123 #: ../fish/guestfish.pod:545
22124 msgid "B<MB>"
22125 msgstr ""
22126
22127 # type: textblock
22128 #. type: textblock
22129 #: ../fish/guestfish.pod:547
22130 msgid "The size in SI 1000000 byte units."
22131 msgstr ""
22132
22133 # type: =item
22134 #. type: =item
22135 #: ../fish/guestfish.pod:549
22136 msgid "B<G> or B<GiB>"
22137 msgstr ""
22138
22139 # type: textblock
22140 #. type: textblock
22141 #: ../fish/guestfish.pod:551
22142 msgid "The size in gigabytes (multiplied by 2**30)."
22143 msgstr ""
22144
22145 # type: =item
22146 #. type: =item
22147 #: ../fish/guestfish.pod:553
22148 msgid "B<GB>"
22149 msgstr ""
22150
22151 # type: textblock
22152 #. type: textblock
22153 #: ../fish/guestfish.pod:555
22154 msgid "The size in SI 10**9 byte units."
22155 msgstr ""
22156
22157 # type: =item
22158 #. type: =item
22159 #: ../fish/guestfish.pod:557
22160 msgid "B<T> or B<TiB>"
22161 msgstr ""
22162
22163 # type: textblock
22164 #. type: textblock
22165 #: ../fish/guestfish.pod:559
22166 msgid "The size in terabytes (multiplied by 2**40)."
22167 msgstr ""
22168
22169 # type: =item
22170 #. type: =item
22171 #: ../fish/guestfish.pod:561
22172 msgid "B<TB>"
22173 msgstr ""
22174
22175 # type: textblock
22176 #. type: textblock
22177 #: ../fish/guestfish.pod:563
22178 msgid "The size in SI 10**12 byte units."
22179 msgstr ""
22180
22181 # type: =item
22182 #. type: =item
22183 #: ../fish/guestfish.pod:565
22184 msgid "B<P> or B<PiB>"
22185 msgstr ""
22186
22187 # type: textblock
22188 #. type: textblock
22189 #: ../fish/guestfish.pod:567
22190 msgid "The size in petabytes (multiplied by 2**50)."
22191 msgstr ""
22192
22193 # type: =item
22194 #. type: =item
22195 #: ../fish/guestfish.pod:569
22196 msgid "B<PB>"
22197 msgstr ""
22198
22199 # type: textblock
22200 #. type: textblock
22201 #: ../fish/guestfish.pod:571
22202 msgid "The size in SI 10**15 byte units."
22203 msgstr ""
22204
22205 # type: =item
22206 #. type: =item
22207 #: ../fish/guestfish.pod:573
22208 msgid "B<E> or B<EiB>"
22209 msgstr ""
22210
22211 # type: textblock
22212 #. type: textblock
22213 #: ../fish/guestfish.pod:575
22214 msgid "The size in exabytes (multiplied by 2**60)."
22215 msgstr ""
22216
22217 # type: =item
22218 #. type: =item
22219 #: ../fish/guestfish.pod:577
22220 msgid "B<EB>"
22221 msgstr ""
22222
22223 # type: textblock
22224 #. type: textblock
22225 #: ../fish/guestfish.pod:579
22226 msgid "The size in SI 10**18 byte units."
22227 msgstr ""
22228
22229 # type: =item
22230 #. type: =item
22231 #: ../fish/guestfish.pod:581
22232 msgid "B<Z> or B<ZiB>"
22233 msgstr ""
22234
22235 # type: textblock
22236 #. type: textblock
22237 #: ../fish/guestfish.pod:583
22238 msgid "The size in zettabytes (multiplied by 2**70)."
22239 msgstr ""
22240
22241 # type: =item
22242 #. type: =item
22243 #: ../fish/guestfish.pod:585
22244 msgid "B<ZB>"
22245 msgstr ""
22246
22247 # type: textblock
22248 #. type: textblock
22249 #: ../fish/guestfish.pod:587
22250 msgid "The size in SI 10**21 byte units."
22251 msgstr ""
22252
22253 # type: =item
22254 #. type: =item
22255 #: ../fish/guestfish.pod:589
22256 msgid "B<Y> or B<YiB>"
22257 msgstr ""
22258
22259 # type: textblock
22260 #. type: textblock
22261 #: ../fish/guestfish.pod:591
22262 msgid "The size in yottabytes (multiplied by 2**80)."
22263 msgstr ""
22264
22265 # type: =item
22266 #. type: =item
22267 #: ../fish/guestfish.pod:593
22268 msgid "B<YB>"
22269 msgstr ""
22270
22271 # type: textblock
22272 #. type: textblock
22273 #: ../fish/guestfish.pod:595
22274 msgid "The size in SI 10**24 byte units."
22275 msgstr ""
22276
22277 # type: verbatim
22278 #. type: verbatim
22279 #: ../fish/guestfish.pod:601
22280 #, no-wrap
22281 msgid ""
22282 " truncate-size /file 1G\n"
22283 "\n"
22284 msgstr ""
22285
22286 # type: textblock
22287 #. type: textblock
22288 #: ../fish/guestfish.pod:603
22289 msgid "would truncate the file to 1 gigabyte."
22290 msgstr ""
22291
22292 # type: textblock
22293 #. type: textblock
22294 #: ../fish/guestfish.pod:605
22295 msgid ""
22296 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
22297 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
22298 "suffix will probably not do what you expect."
22299 msgstr ""
22300
22301 # type: =head2
22302 #. type: =head2
22303 #: ../fish/guestfish.pod:609
22304 msgid "OCTAL AND HEXADECIMAL NUMBERS"
22305 msgstr ""
22306
22307 # type: textblock
22308 #. type: textblock
22309 #: ../fish/guestfish.pod:611
22310 msgid ""
22311 "For specifying the radix (base) use the C convention: C<0> to prefix an "
22312 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
22313 msgstr ""
22314
22315 # type: verbatim
22316 #. type: verbatim
22317 #: ../fish/guestfish.pod:614
22318 #, no-wrap
22319 msgid ""
22320 " 1234      decimal number 1234\n"
22321 " 02322     octal number, equivalent to decimal 1234\n"
22322 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
22323 "\n"
22324 msgstr ""
22325
22326 # type: textblock
22327 #. type: textblock
22328 #: ../fish/guestfish.pod:618
22329 msgid ""
22330 "When using the C<chmod> command, you almost always want to specify an octal "
22331 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
22332 "L<chmod(1)> program):"
22333 msgstr ""
22334
22335 # type: verbatim
22336 #. type: verbatim
22337 #: ../fish/guestfish.pod:622
22338 #, no-wrap
22339 msgid ""
22340 " chmod 0777 /public  # OK\n"
22341 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
22342 "\n"
22343 msgstr ""
22344
22345 # type: textblock
22346 #. type: textblock
22347 #: ../fish/guestfish.pod:625
22348 msgid ""
22349 "Commands that return numbers usually print them in decimal, but some "
22350 "commands print numbers in other radices (eg. C<umask> prints the mode in "
22351 "octal, preceeded by C<0>)."
22352 msgstr ""
22353
22354 # type: =head1
22355 #. type: =head1
22356 #: ../fish/guestfish.pod:629
22357 msgid "WILDCARDS AND GLOBBING"
22358 msgstr ""
22359
22360 # type: textblock
22361 #. type: textblock
22362 #: ../fish/guestfish.pod:631
22363 msgid ""
22364 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
22365 "(globbing) by default.  So for example the following will not do what you "
22366 "expect:"
22367 msgstr ""
22368
22369 # type: verbatim
22370 #. type: verbatim
22371 #: ../fish/guestfish.pod:635
22372 #, no-wrap
22373 msgid ""
22374 " rm-rf /home/*\n"
22375 "\n"
22376 msgstr ""
22377
22378 # type: textblock
22379 #. type: textblock
22380 #: ../fish/guestfish.pod:637
22381 msgid ""
22382 "Assuming you don't have a directory called literally C</home/*> then the "
22383 "above command will return an error."
22384 msgstr ""
22385
22386 # type: textblock
22387 #. type: textblock
22388 #: ../fish/guestfish.pod:640
22389 msgid "To perform wildcard expansion, use the C<glob> command."
22390 msgstr ""
22391
22392 # type: verbatim
22393 #. type: verbatim
22394 #: ../fish/guestfish.pod:642
22395 #, no-wrap
22396 msgid ""
22397 " glob rm-rf /home/*\n"
22398 "\n"
22399 msgstr ""
22400
22401 # type: textblock
22402 #. type: textblock
22403 #: ../fish/guestfish.pod:644
22404 msgid ""
22405 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
22406 "many times), equivalent to:"
22407 msgstr ""
22408
22409 # type: verbatim
22410 #. type: verbatim
22411 #: ../fish/guestfish.pod:647
22412 #, no-wrap
22413 msgid ""
22414 " rm-rf /home/jim\n"
22415 " rm-rf /home/joe\n"
22416 " rm-rf /home/mary\n"
22417 "\n"
22418 msgstr ""
22419
22420 # type: textblock
22421 #. type: textblock
22422 #: ../fish/guestfish.pod:651
22423 msgid "C<glob> only works on simple guest paths and not on device names."
22424 msgstr ""
22425
22426 # type: textblock
22427 #. type: textblock
22428 #: ../fish/guestfish.pod:653
22429 msgid ""
22430 "If you have several parameters, each containing a wildcard, then glob will "
22431 "perform a Cartesian product."
22432 msgstr ""
22433
22434 # type: =head1
22435 #. type: =head1
22436 #: ../fish/guestfish.pod:656
22437 msgid "COMMENTS"
22438 msgstr ""
22439
22440 # type: textblock
22441 #. type: textblock
22442 #: ../fish/guestfish.pod:658
22443 msgid ""
22444 "Any line which starts with a I<#> character is treated as a comment and "
22445 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
22446 "a command.  For example:"
22447 msgstr ""
22448
22449 # type: verbatim
22450 #. type: verbatim
22451 #: ../fish/guestfish.pod:662
22452 #, no-wrap
22453 msgid ""
22454 " # this is a comment\n"
22455 "         # this is a comment\n"
22456 " foo # NOT a comment\n"
22457 "\n"
22458 msgstr ""
22459
22460 # type: textblock
22461 #. type: textblock
22462 #: ../fish/guestfish.pod:666
22463 msgid "Blank lines are also ignored."
22464 msgstr ""
22465
22466 # type: =head1
22467 #. type: =head1
22468 #: ../fish/guestfish.pod:668
22469 msgid "RUNNING COMMANDS LOCALLY"
22470 msgstr ""
22471
22472 # type: textblock
22473 #. type: textblock
22474 #: ../fish/guestfish.pod:670
22475 msgid ""
22476 "Any line which starts with a I<!> character is treated as a command sent to "
22477 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
22478 msgstr ""
22479
22480 # type: verbatim
22481 #. type: verbatim
22482 #: ../fish/guestfish.pod:674
22483 #, no-wrap
22484 msgid ""
22485 " !mkdir local\n"
22486 " tgz-out /remote local/remote-data.tar.gz\n"
22487 "\n"
22488 msgstr ""
22489
22490 # type: textblock
22491 #. type: textblock
22492 #: ../fish/guestfish.pod:677
22493 msgid ""
22494 "will create a directory C<local> on the host, and then export the contents "
22495 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
22496 "(See C<tgz-out>)."
22497 msgstr ""
22498
22499 # type: textblock
22500 #. type: textblock
22501 #: ../fish/guestfish.pod:681
22502 msgid ""
22503 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
22504 "effect, due to the way that subprocesses work in Unix."
22505 msgstr ""
22506
22507 #. type: =head2
22508 #: ../fish/guestfish.pod:684
22509 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
22510 msgstr ""
22511
22512 #. type: textblock
22513 #: ../fish/guestfish.pod:686
22514 msgid ""
22515 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
22516 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
22517 "and executed as guestfish commands."
22518 msgstr ""
22519
22520 #. type: textblock
22521 #: ../fish/guestfish.pod:690
22522 msgid ""
22523 "Thus you can use shell script to construct arbitrary guestfish commands "
22524 "which are then parsed by guestfish."
22525 msgstr ""
22526
22527 #. type: textblock
22528 #: ../fish/guestfish.pod:693
22529 msgid ""
22530 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
22531 "through C</foo.100>) using guestfish commands alone.  However this is simple "
22532 "if we use a shell script to create the guestfish commands for us:"
22533 msgstr ""
22534
22535 #. type: verbatim
22536 #: ../fish/guestfish.pod:698
22537 #, no-wrap
22538 msgid ""
22539 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
22540 "\n"
22541 msgstr ""
22542
22543 #. type: textblock
22544 #: ../fish/guestfish.pod:700
22545 msgid "or with names like C</foo.001>:"
22546 msgstr ""
22547
22548 #. type: verbatim
22549 #: ../fish/guestfish.pod:702
22550 #, no-wrap
22551 msgid ""
22552 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
22553 "\n"
22554 msgstr ""
22555
22556 #. type: textblock
22557 #: ../fish/guestfish.pod:704
22558 msgid ""
22559 "When using guestfish interactively it can be helpful to just run the shell "
22560 "script first (ie. remove the initial C<E<lt>> character so it is just an "
22561 "ordinary I<!> local command), see what guestfish commands it would run, and "
22562 "when you are happy with those prepend the C<E<lt>> character to run the "
22563 "guestfish commands for real."
22564 msgstr ""
22565
22566 # type: =head1
22567 #. type: =head1
22568 #: ../fish/guestfish.pod:710
22569 msgid "PIPES"
22570 msgstr ""
22571
22572 # type: textblock
22573 #. type: textblock
22574 #: ../fish/guestfish.pod:712
22575 msgid ""
22576 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
22577 "command (a guestfish command) to the second command (any host command).  For "
22578 "example:"
22579 msgstr ""
22580
22581 # type: verbatim
22582 #. type: verbatim
22583 #: ../fish/guestfish.pod:716
22584 #, no-wrap
22585 msgid ""
22586 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
22587 "\n"
22588 msgstr ""
22589
22590 # type: textblock
22591 #. type: textblock
22592 #: ../fish/guestfish.pod:718
22593 msgid ""
22594 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
22595 "program).  The above command would list all accounts in the guest filesystem "
22596 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
22597 msgstr ""
22598
22599 # type: verbatim
22600 #. type: verbatim
22601 #: ../fish/guestfish.pod:723
22602 #, no-wrap
22603 msgid ""
22604 " hexdump /bin/ls | head\n"
22605 " list-devices | tail -1\n"
22606 " tgz-out / - | tar ztf -\n"
22607 "\n"
22608 msgstr ""
22609
22610 # type: textblock
22611 #. type: textblock
22612 #: ../fish/guestfish.pod:727
22613 msgid ""
22614 "The space before the pipe symbol is required, any space after the pipe "
22615 "symbol is optional.  Everything after the pipe symbol is just passed "
22616 "straight to the host shell, so it can contain redirections, globs and "
22617 "anything else that makes sense on the host side."
22618 msgstr ""
22619
22620 # type: textblock
22621 #. type: textblock
22622 #: ../fish/guestfish.pod:732
22623 msgid ""
22624 "To use a literal argument which begins with a pipe symbol, you have to quote "
22625 "it, eg:"
22626 msgstr ""
22627
22628 # type: verbatim
22629 #. type: verbatim
22630 #: ../fish/guestfish.pod:735
22631 #, no-wrap
22632 msgid ""
22633 " echo \"|\"\n"
22634 "\n"
22635 msgstr ""
22636
22637 # type: =head1
22638 #. type: =head1
22639 #: ../fish/guestfish.pod:737
22640 msgid "HOME DIRECTORIES"
22641 msgstr ""
22642
22643 # type: textblock
22644 #. type: textblock
22645 #: ../fish/guestfish.pod:739
22646 msgid ""
22647 "If a parameter starts with the character C<~> then the tilde may be expanded "
22648 "as a home directory path (either C<~> for the current user's home directory, "
22649 "or C<~user> for another user)."
22650 msgstr ""
22651
22652 # type: textblock
22653 #. type: textblock
22654 #: ../fish/guestfish.pod:743
22655 msgid ""
22656 "Note that home directory expansion happens for users known I<on the host>, "
22657 "not in the guest filesystem."
22658 msgstr ""
22659
22660 # type: textblock
22661 #. type: textblock
22662 #: ../fish/guestfish.pod:746
22663 msgid ""
22664 "To use a literal argument which begins with a tilde, you have to quote it, "
22665 "eg:"
22666 msgstr ""
22667
22668 # type: verbatim
22669 #. type: verbatim
22670 #: ../fish/guestfish.pod:749
22671 #, no-wrap
22672 msgid ""
22673 " echo \"~\"\n"
22674 "\n"
22675 msgstr ""
22676
22677 # type: textblock
22678 #. type: textblock
22679 #: ../fish/guestfish.pod:753
22680 msgid ""
22681 "Libguestfs has some support for Linux guests encrypted according to the "
22682 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
22683 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
22684 "LUKS is supported."
22685 msgstr ""
22686
22687 # type: textblock
22688 #. type: textblock
22689 #: ../fish/guestfish.pod:758
22690 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
22691 msgstr ""
22692
22693 # type: verbatim
22694 #. type: verbatim
22695 #: ../fish/guestfish.pod:760
22696 #, no-wrap
22697 msgid ""
22698 " ><fs> vfs-type /dev/sda2\n"
22699 " crypto_LUKS\n"
22700 "\n"
22701 msgstr ""
22702
22703 # type: textblock
22704 #. type: textblock
22705 #: ../fish/guestfish.pod:763
22706 msgid ""
22707 "Then open those devices using L</luks-open>.  This creates a device-mapper "
22708 "device called C</dev/mapper/luksdev>."
22709 msgstr ""
22710
22711 # type: verbatim
22712 #. type: verbatim
22713 #: ../fish/guestfish.pod:766
22714 #, no-wrap
22715 msgid ""
22716 " ><fs> luks-open /dev/sda2 luksdev\n"
22717 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
22718 "\n"
22719 msgstr ""
22720
22721 # type: textblock
22722 #. type: textblock
22723 #: ../fish/guestfish.pod:769
22724 msgid ""
22725 "Finally you have to tell LVM to scan for volume groups on the newly created "
22726 "mapper device:"
22727 msgstr ""
22728
22729 # type: verbatim
22730 #. type: verbatim
22731 #: ../fish/guestfish.pod:772
22732 #, no-wrap
22733 msgid ""
22734 " vgscan\n"
22735 " vg-activate-all true\n"
22736 "\n"
22737 msgstr ""
22738
22739 # type: textblock
22740 #. type: textblock
22741 #: ../fish/guestfish.pod:775
22742 msgid "The logical volume(s) can now be mounted in the usual way."
22743 msgstr ""
22744
22745 # type: textblock
22746 #. type: textblock
22747 #: ../fish/guestfish.pod:777
22748 msgid ""
22749 "Before closing a LUKS device you must unmount any logical volumes on it and "
22750 "deactivate the volume groups by calling C<vg-activate false VG> on each "
22751 "one.  Then you can close the mapper device:"
22752 msgstr ""
22753
22754 # type: verbatim
22755 #. type: verbatim
22756 #: ../fish/guestfish.pod:781
22757 #, no-wrap
22758 msgid ""
22759 " vg-activate false /dev/VG\n"
22760 " luks-close /dev/mapper/luksdev\n"
22761 "\n"
22762 msgstr ""
22763
22764 # type: =head1
22765 #. type: =head1
22766 #: ../fish/guestfish.pod:784
22767 msgid "WINDOWS PATHS"
22768 msgstr ""
22769
22770 # type: textblock
22771 #. type: textblock
22772 #: ../fish/guestfish.pod:786
22773 msgid ""
22774 "If a path is prefixed with C<win:> then you can use Windows-style paths "
22775 "(with some limitations).  The following commands are equivalent:"
22776 msgstr ""
22777
22778 # type: verbatim
22779 #. type: verbatim
22780 #: ../fish/guestfish.pod:789
22781 #, no-wrap
22782 msgid ""
22783 " file /WINDOWS/system32/config/system.LOG\n"
22784 "\n"
22785 msgstr ""
22786
22787 # type: verbatim
22788 #. type: verbatim
22789 #: ../fish/guestfish.pod:791
22790 #, no-wrap
22791 msgid ""
22792 " file win:/windows/system32/config/system.log\n"
22793 "\n"
22794 msgstr ""
22795
22796 # type: verbatim
22797 #. type: verbatim
22798 #: ../fish/guestfish.pod:793
22799 #, no-wrap
22800 msgid ""
22801 " file win:\\windows\\system32\\config\\system.log\n"
22802 "\n"
22803 msgstr ""
22804
22805 # type: verbatim
22806 #. type: verbatim
22807 #: ../fish/guestfish.pod:795
22808 #, no-wrap
22809 msgid ""
22810 " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n"
22811 "\n"
22812 msgstr ""
22813
22814 # type: textblock
22815 #. type: textblock
22816 #: ../fish/guestfish.pod:797
22817 msgid ""
22818 "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also "
22819 "handles case insensitivity like Windows would.  This only works in argument "
22820 "positions that expect a path."
22821 msgstr ""
22822
22823 # type: =head1
22824 #. type: =head1
22825 #: ../fish/guestfish.pod:801
22826 msgid "UPLOADING AND DOWNLOADING FILES"
22827 msgstr ""
22828
22829 # type: textblock
22830 #. type: textblock
22831 #: ../fish/guestfish.pod:803
22832 msgid ""
22833 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
22834 "others which upload from or download to a local file, you can use the "
22835 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
22836 msgstr ""
22837
22838 # type: verbatim
22839 #. type: verbatim
22840 #: ../fish/guestfish.pod:807
22841 #, no-wrap
22842 msgid ""
22843 " upload - /foo\n"
22844 "\n"
22845 msgstr ""
22846
22847 # type: textblock
22848 #. type: textblock
22849 #: ../fish/guestfish.pod:809
22850 msgid ""
22851 "reads stdin and creates from that a file C</foo> in the disk image, and:"
22852 msgstr ""
22853
22854 # type: verbatim
22855 #. type: verbatim
22856 #: ../fish/guestfish.pod:812
22857 #, no-wrap
22858 msgid ""
22859 " tar-out /etc - | tar tf -\n"
22860 "\n"
22861 msgstr ""
22862
22863 # type: textblock
22864 #. type: textblock
22865 #: ../fish/guestfish.pod:814
22866 msgid ""
22867 "writes the tarball to stdout and then pipes that into the external \"tar\" "
22868 "command (see L</PIPES>)."
22869 msgstr ""
22870
22871 # type: textblock
22872 #. type: textblock
22873 #: ../fish/guestfish.pod:817
22874 msgid ""
22875 "When using C<-> to read from stdin, the input is read up to the end of "
22876 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
22877 "some arbitrary end marker:"
22878 msgstr ""
22879
22880 # type: verbatim
22881 #. type: verbatim
22882 #: ../fish/guestfish.pod:821
22883 #, no-wrap
22884 msgid ""
22885 " upload -<<END /foo\n"
22886 " input line 1\n"
22887 " input line 2\n"
22888 " input line 3\n"
22889 " END\n"
22890 "\n"
22891 msgstr ""
22892
22893 # type: textblock
22894 #. type: textblock
22895 #: ../fish/guestfish.pod:827
22896 msgid ""
22897 "Any string of characters can be used instead of C<END>.  The end marker must "
22898 "appear on a line of its own, without any preceeding or following characters "
22899 "(not even spaces)."
22900 msgstr ""
22901
22902 # type: textblock
22903 #. type: textblock
22904 #: ../fish/guestfish.pod:831
22905 msgid ""
22906 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
22907 "upload local files (so-called \"FileIn\" parameters in the generator)."
22908 msgstr ""
22909
22910 # type: =head1
22911 #. type: =head1
22912 #: ../fish/guestfish.pod:834
22913 msgid "EXIT ON ERROR BEHAVIOUR"
22914 msgstr ""
22915
22916 # type: textblock
22917 #. type: textblock
22918 #: ../fish/guestfish.pod:836
22919 msgid ""
22920 "By default, guestfish will ignore any errors when in interactive mode (ie. "
22921 "taking commands from a human over a tty), and will exit on the first error "
22922 "in non-interactive mode (scripts, commands given on the command line)."
22923 msgstr ""
22924
22925 # type: textblock
22926 #. type: textblock
22927 #: ../fish/guestfish.pod:841
22928 msgid ""
22929 "If you prefix a command with a I<-> character, then that command will not "
22930 "cause guestfish to exit, even if that (one) command returns an error."
22931 msgstr ""
22932
22933 # type: =head1
22934 #. type: =head1
22935 #: ../fish/guestfish.pod:845
22936 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
22937 msgstr ""
22938
22939 # type: textblock
22940 #. type: textblock
22941 #: ../fish/guestfish.pod:847
22942 msgid ""
22943 "Guestfish can be remote-controlled over a socket.  This is useful "
22944 "particularly in shell scripts where you want to make several different "
22945 "changes to a filesystem, but you don't want the overhead of starting up a "
22946 "guestfish process each time."
22947 msgstr ""
22948
22949 # type: textblock
22950 #. type: textblock
22951 #: ../fish/guestfish.pod:852
22952 msgid "Start a guestfish server process using:"
22953 msgstr ""
22954
22955 # type: verbatim
22956 #. type: verbatim
22957 #: ../fish/guestfish.pod:854
22958 #, no-wrap
22959 msgid ""
22960 " eval \"`guestfish --listen`\"\n"
22961 "\n"
22962 msgstr ""
22963
22964 # type: textblock
22965 #. type: textblock
22966 #: ../fish/guestfish.pod:856
22967 msgid "and then send it commands by doing:"
22968 msgstr ""
22969
22970 # type: verbatim
22971 #. type: verbatim
22972 #: ../fish/guestfish.pod:858
22973 #, no-wrap
22974 msgid ""
22975 " guestfish --remote cmd [...]\n"
22976 "\n"
22977 msgstr ""
22978
22979 # type: textblock
22980 #. type: textblock
22981 #: ../fish/guestfish.pod:860
22982 msgid "To cause the server to exit, send it the exit command:"
22983 msgstr ""
22984
22985 # type: verbatim
22986 #. type: verbatim
22987 #: ../fish/guestfish.pod:862
22988 #, no-wrap
22989 msgid ""
22990 " guestfish --remote exit\n"
22991 "\n"
22992 msgstr ""
22993
22994 # type: textblock
22995 #. type: textblock
22996 #: ../fish/guestfish.pod:864
22997 msgid ""
22998 "Note that the server will normally exit if there is an error in a command.  "
22999 "You can change this in the usual way.  See section L</EXIT ON ERROR "
23000 "BEHAVIOUR>."
23001 msgstr ""
23002
23003 # type: =head2
23004 #. type: =head2
23005 #: ../fish/guestfish.pod:868
23006 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
23007 msgstr ""
23008
23009 # type: textblock
23010 #. type: textblock
23011 #: ../fish/guestfish.pod:870
23012 msgid ""
23013 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
23014 "is how the I<--remote> option knows where to send the commands.  You can "
23015 "have several guestfish listener processes running using:"
23016 msgstr ""
23017
23018 # type: verbatim
23019 #. type: verbatim
23020 #: ../fish/guestfish.pod:874
23021 #, no-wrap
23022 msgid ""
23023 " eval \"`guestfish --listen`\"\n"
23024 " pid1=$GUESTFISH_PID\n"
23025 " eval \"`guestfish --listen`\"\n"
23026 " pid2=$GUESTFISH_PID\n"
23027 " ...\n"
23028 " guestfish --remote=$pid1 cmd\n"
23029 " guestfish --remote=$pid2 cmd\n"
23030 "\n"
23031 msgstr ""
23032
23033 # type: =head2
23034 #. type: =head2
23035 #: ../fish/guestfish.pod:882
23036 msgid "REMOTE CONTROL AND CSH"
23037 msgstr ""
23038
23039 # type: textblock
23040 #. type: textblock
23041 #: ../fish/guestfish.pod:884
23042 msgid ""
23043 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
23044 "option:"
23045 msgstr ""
23046
23047 # type: verbatim
23048 #. type: verbatim
23049 #: ../fish/guestfish.pod:887
23050 #, no-wrap
23051 msgid ""
23052 " eval \"`guestfish --listen --csh`\"\n"
23053 "\n"
23054 msgstr ""
23055
23056 # type: =head2
23057 #. type: =head2
23058 #: ../fish/guestfish.pod:889
23059 msgid "REMOTE CONTROL DETAILS"
23060 msgstr ""
23061
23062 # type: textblock
23063 #. type: textblock
23064 #: ../fish/guestfish.pod:891
23065 msgid ""
23066 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
23067 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
23068 "and C<$PID> is the process ID of the server."
23069 msgstr ""
23070
23071 # type: textblock
23072 #. type: textblock
23073 #: ../fish/guestfish.pod:895
23074 msgid "Guestfish client and server versions must match exactly."
23075 msgstr ""
23076
23077 # type: =head1
23078 #. type: =head1
23079 #: ../fish/guestfish.pod:897
23080 msgid "PREPARED DISK IMAGES"
23081 msgstr ""
23082
23083 # type: textblock
23084 #. type: textblock
23085 #: ../fish/guestfish.pod:899
23086 msgid ""
23087 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
23088 "preformatted disk images that guestfish can make for you to save typing.  "
23089 "This is particularly useful for testing purposes.  This option is used "
23090 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
23091 "can be mixed with I<-a>)."
23092 msgstr ""
23093
23094 # type: textblock
23095 #. type: textblock
23096 #: ../fish/guestfish.pod:905
23097 msgid ""
23098 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
23099 "the second and so on.  Existing files in the current directory are "
23100 "I<overwritten>."
23101 msgstr ""
23102
23103 # type: textblock
23104 #. type: textblock
23105 #: ../fish/guestfish.pod:909
23106 msgid ""
23107 "The type briefly describes how the disk should be sized, partitioned, how "
23108 "filesystem(s) should be created, and how content should be added.  "
23109 "Optionally the type can be followed by extra parameters, separated by C<:> "
23110 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
23111 "allocated disk, containing a single partition, with the partition formatted "
23112 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
23113 "disk instead."
23114 msgstr ""
23115
23116 # type: textblock
23117 #. type: textblock
23118 #: ../fish/guestfish.pod:917
23119 msgid "To list the available types and any extra parameters they take, run:"
23120 msgstr ""
23121
23122 # type: textblock
23123 #. type: textblock
23124 #: ../fish/guestfish.pod:921
23125 msgid ""
23126 "Note that the prepared filesystem is not mounted.  You would usually have to "
23127 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
23128 msgstr ""
23129
23130 # type: textblock
23131 #. type: textblock
23132 #: ../fish/guestfish.pod:925
23133 msgid ""
23134 "If any I<-N> or I<--new> options are given, the guest is automatically "
23135 "launched."
23136 msgstr ""
23137
23138 # type: textblock
23139 #. type: textblock
23140 #: ../fish/guestfish.pod:930
23141 msgid "Create a 100MB disk with an ext4-formatted partition:"
23142 msgstr ""
23143
23144 # type: verbatim
23145 #. type: verbatim
23146 #: ../fish/guestfish.pod:932
23147 #, no-wrap
23148 msgid ""
23149 " guestfish -N fs:ext4\n"
23150 "\n"
23151 msgstr ""
23152
23153 # type: textblock
23154 #. type: textblock
23155 #: ../fish/guestfish.pod:934
23156 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
23157 msgstr ""
23158
23159 # type: verbatim
23160 #. type: verbatim
23161 #: ../fish/guestfish.pod:936
23162 #, no-wrap
23163 msgid ""
23164 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
23165 "\n"
23166 msgstr ""
23167
23168 # type: textblock
23169 #. type: textblock
23170 #: ../fish/guestfish.pod:938
23171 msgid "Create a blank 200MB disk:"
23172 msgstr ""
23173
23174 # type: verbatim
23175 #. type: verbatim
23176 #: ../fish/guestfish.pod:940
23177 #, no-wrap
23178 msgid ""
23179 " guestfish -N disk:200M\n"
23180 "\n"
23181 msgstr ""
23182
23183 # type: =head1
23184 #. type: =head1
23185 #: ../fish/guestfish.pod:942
23186 msgid "PROGRESS BARS"
23187 msgstr ""
23188
23189 # type: textblock
23190 #. type: textblock
23191 #: ../fish/guestfish.pod:944
23192 msgid ""
23193 "Some (not all) long-running commands send progress notification messages as "
23194 "they are running.  Guestfish turns these messages into progress bars."
23195 msgstr ""
23196
23197 # type: textblock
23198 #. type: textblock
23199 #: ../fish/guestfish.pod:948
23200 msgid ""
23201 "When a command that supports progress bars takes longer than two seconds to "
23202 "run, and if progress bars are enabled, then you will see one appearing below "
23203 "the command:"
23204 msgstr ""
23205
23206 # type: verbatim
23207 #. type: verbatim
23208 #: ../fish/guestfish.pod:952
23209 #, no-wrap
23210 msgid ""
23211 " ><fs> copy-size /large-file /another-file 2048M\n"
23212 " / 10% [#####-----------------------------------------] 00:30\n"
23213 "\n"
23214 msgstr ""
23215
23216 # type: textblock
23217 #. type: textblock
23218 #: ../fish/guestfish.pod:955
23219 msgid ""
23220 "The spinner on the left hand side moves round once for every progress "
23221 "notification received from the backend.  This is a (reasonably) golden "
23222 "assurance that the command is \"doing something\" even if the progress bar "
23223 "is not moving, because the command is able to send the progress "
23224 "notifications.  When the bar reaches 100% and the command finishes, the "
23225 "spinner disappears."
23226 msgstr ""
23227
23228 # type: textblock
23229 #. type: textblock
23230 #: ../fish/guestfish.pod:962
23231 msgid ""
23232 "Progress bars are enabled by default when guestfish is used interactively.  "
23233 "You can enable them even for non-interactive modes using I<--progress-bars>, "
23234 "and you can disable them completely using I<--no-progress-bars>."
23235 msgstr ""
23236
23237 # type: =head1
23238 #. type: =head1
23239 #: ../fish/guestfish.pod:967
23240 msgid "GUESTFISH COMMANDS"
23241 msgstr ""
23242
23243 # type: textblock
23244 #. type: textblock
23245 #: ../fish/guestfish.pod:969
23246 msgid ""
23247 "The commands in this section are guestfish convenience commands, in other "
23248 "words, they are not part of the L<guestfs(3)> API."
23249 msgstr ""
23250
23251 # type: =head2
23252 #. type: =head2
23253 #: ../fish/guestfish.pod:972
23254 msgid "help"
23255 msgstr ""
23256
23257 # type: verbatim
23258 #. type: verbatim
23259 #: ../fish/guestfish.pod:974
23260 #, no-wrap
23261 msgid ""
23262 " help\n"
23263 " help cmd\n"
23264 "\n"
23265 msgstr ""
23266
23267 # type: textblock
23268 #. type: textblock
23269 #: ../fish/guestfish.pod:977
23270 msgid "Without any parameter, this provides general help."
23271 msgstr ""
23272
23273 # type: textblock
23274 #. type: textblock
23275 #: ../fish/guestfish.pod:979
23276 msgid "With a C<cmd> parameter, this displays detailed help for that command."
23277 msgstr ""
23278
23279 # type: =head2
23280 #. type: =head2
23281 #: ../fish/guestfish.pod:981
23282 msgid "quit | exit"
23283 msgstr ""
23284
23285 # type: textblock
23286 #. type: textblock
23287 #: ../fish/guestfish.pod:983
23288 msgid "This exits guestfish.  You can also use C<^D> key."
23289 msgstr ""
23290
23291 # type: textblock
23292 #. type: textblock
23293 #: ../fish/guestfish.pod:985
23294 msgid "@FISH_COMMANDS@"
23295 msgstr ""
23296
23297 # type: =head1
23298 #. type: =head1
23299 #: ../fish/guestfish.pod:987
23300 msgid "COMMANDS"
23301 msgstr ""
23302
23303 # type: =head1
23304 #. type: =head1
23305 #: ../fish/guestfish.pod:991 ../test-tool/libguestfs-test-tool.pod:83
23306 msgid "EXIT CODE"
23307 msgstr ""
23308
23309 # type: textblock
23310 #. type: textblock
23311 #: ../fish/guestfish.pod:993
23312 msgid ""
23313 "guestfish returns 0 if the commands completed without error, or 1 if there "
23314 "was an error."
23315 msgstr ""
23316
23317 # type: =item
23318 #. type: =item
23319 #: ../fish/guestfish.pod:1000
23320 msgid "EDITOR"
23321 msgstr ""
23322
23323 # type: textblock
23324 #. type: textblock
23325 #: ../fish/guestfish.pod:1002
23326 msgid ""
23327 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
23328 "C<vi>."
23329 msgstr ""
23330
23331 # type: =item
23332 #. type: =item
23333 #: ../fish/guestfish.pod:1005
23334 msgid "GUESTFISH_PID"
23335 msgstr ""
23336
23337 # type: textblock
23338 #. type: textblock
23339 #: ../fish/guestfish.pod:1007
23340 msgid ""
23341 "Used with the I<--remote> option to specify the remote guestfish process to "
23342 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
23343 msgstr ""
23344
23345 # type: =item
23346 #. type: =item
23347 #: ../fish/guestfish.pod:1011
23348 msgid "HEXEDITOR"
23349 msgstr ""
23350
23351 # type: textblock
23352 #. type: textblock
23353 #: ../fish/guestfish.pod:1013
23354 msgid ""
23355 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
23356 "not specified, the external L<hexedit(1)> program is used."
23357 msgstr ""
23358
23359 # type: =item
23360 #. type: =item
23361 #: ../fish/guestfish.pod:1017
23362 msgid "HOME"
23363 msgstr ""
23364
23365 # type: textblock
23366 #. type: textblock
23367 #: ../fish/guestfish.pod:1019
23368 msgid ""
23369 "If compiled with GNU readline support, various files in the home directory "
23370 "can be used.  See L</FILES>."
23371 msgstr ""
23372
23373 # type: textblock
23374 #. type: textblock
23375 #: ../fish/guestfish.pod:1028
23376 msgid ""
23377 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
23378 "effect as using the B<-v> option."
23379 msgstr ""
23380
23381 # type: textblock
23382 #. type: textblock
23383 #: ../fish/guestfish.pod:1040
23384 msgid ""
23385 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
23386 "the discussion of paths in L<guestfs(3)>."
23387 msgstr ""
23388
23389 # type: textblock
23390 #. type: textblock
23391 #: ../fish/guestfish.pod:1051
23392 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
23393 msgstr ""
23394
23395 # type: =item
23396 #. type: =item
23397 #: ../fish/guestfish.pod:1053
23398 msgid "PAGER"
23399 msgstr ""
23400
23401 # type: textblock
23402 #. type: textblock
23403 #: ../fish/guestfish.pod:1055
23404 msgid ""
23405 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
23406 "C<more>."
23407 msgstr ""
23408
23409 # type: =head1
23410 #. type: =head1
23411 #: ../fish/guestfish.pod:1071 ../test-tool/libguestfs-test-tool.pod:88
23412 msgid "FILES"
23413 msgstr ""
23414
23415 # type: =item
23416 #. type: =item
23417 #: ../fish/guestfish.pod:1075
23418 msgid "$HOME/.guestfish"
23419 msgstr ""
23420
23421 # type: textblock
23422 #. type: textblock
23423 #: ../fish/guestfish.pod:1077
23424 msgid ""
23425 "If compiled with GNU readline support, then the command history is saved in "
23426 "this file."
23427 msgstr ""
23428
23429 # type: =item
23430 #. type: =item
23431 #: ../fish/guestfish.pod:1080
23432 msgid "$HOME/.inputrc"
23433 msgstr ""
23434
23435 # type: =item
23436 #. type: =item
23437 #: ../fish/guestfish.pod:1082
23438 msgid "/etc/inputrc"
23439 msgstr ""
23440
23441 # type: textblock
23442 #. type: textblock
23443 #: ../fish/guestfish.pod:1084
23444 msgid ""
23445 "If compiled with GNU readline support, then these files can be used to "
23446 "configure readline.  For further information, please see L<readline(3)/"
23447 "INITIALIZATION FILE>."
23448 msgstr ""
23449
23450 # type: textblock
23451 #. type: textblock
23452 #: ../fish/guestfish.pod:1088
23453 msgid "To write rules which only apply to guestfish, use:"
23454 msgstr ""
23455
23456 # type: verbatim
23457 #. type: verbatim
23458 #: ../fish/guestfish.pod:1090
23459 #, no-wrap
23460 msgid ""
23461 " $if guestfish\n"
23462 " ...\n"
23463 " $endif\n"
23464 "\n"
23465 msgstr ""
23466
23467 # type: textblock
23468 #. type: textblock
23469 #: ../fish/guestfish.pod:1094
23470 msgid ""
23471 "Variables that you can set in inputrc that change the behaviour of guestfish "
23472 "in useful ways include:"
23473 msgstr ""
23474
23475 # type: =item
23476 #. type: =item
23477 #: ../fish/guestfish.pod:1099
23478 msgid "completion-ignore-case (default: on)"
23479 msgstr ""
23480
23481 # type: textblock
23482 #. type: textblock
23483 #: ../fish/guestfish.pod:1101
23484 msgid ""
23485 "By default, guestfish will ignore case when tab-completing paths on the "
23486 "disk.  Use:"
23487 msgstr ""
23488
23489 # type: verbatim
23490 #. type: verbatim
23491 #: ../fish/guestfish.pod:1104
23492 #, no-wrap
23493 msgid ""
23494 " set completion-ignore-case off\n"
23495 "\n"
23496 msgstr ""
23497
23498 # type: textblock
23499 #. type: textblock
23500 #: ../fish/guestfish.pod:1106
23501 msgid "to make guestfish case sensitive."
23502 msgstr ""
23503
23504 # type: =item
23505 #. type: =item
23506 #: ../fish/guestfish.pod:1110
23507 msgid "test1.img"
23508 msgstr ""
23509
23510 # type: =item
23511 #. type: =item
23512 #: ../fish/guestfish.pod:1112
23513 msgid "test2.img (etc)"
23514 msgstr ""
23515
23516 # type: textblock
23517 #. type: textblock
23518 #: ../fish/guestfish.pod:1114
23519 msgid ""
23520 "When using the C<-N> or C<--new> option, the prepared disk or filesystem "
23521 "will be created in the file C<test1.img> in the current directory.  The "
23522 "second use of C<-N> will use C<test2.img> and so on.  Any existing file with "
23523 "the same name will be overwritten."
23524 msgstr ""
23525
23526 #. type: textblock
23527 #: ../fish/guestfish.pod:1123
23528 msgid ""
23529 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
23530 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
23531 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
23532 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
23533 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
23534 ">, L<hexedit(1)>."
23535 msgstr ""
23536
23537 # type: textblock
23538 #. type: textblock
23539 #: ../fish/guestfish.pod:1153 ../test-tool/libguestfs-test-tool.pod:124
23540 #: ../fuse/guestmount.pod:258 ../tools/virt-edit.pl:372
23541 #: ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1512
23542 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309
23543 #: ../tools/virt-make-fs.pl:567 ../tools/virt-list-partitions.pl:277
23544 msgid ""
23545 "This program is free software; you can redistribute it and/or modify it "
23546 "under the terms of the GNU General Public License as published by the Free "
23547 "Software Foundation; either version 2 of the License, or (at your option) "
23548 "any later version."
23549 msgstr ""
23550
23551 # type: textblock
23552 #. type: textblock
23553 #: ../fish/guestfish.pod:1158 ../test-tool/libguestfs-test-tool.pod:129
23554 #: ../fuse/guestmount.pod:263 ../tools/virt-edit.pl:377
23555 #: ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1517
23556 #: ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314
23557 #: ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:282
23558 msgid ""
23559 "This program is distributed in the hope that it will be useful, but WITHOUT "
23560 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
23561 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
23562 "more details."
23563 msgstr ""
23564
23565 # type: textblock
23566 #. type: textblock
23567 #: ../fish/guestfish.pod:1163 ../test-tool/libguestfs-test-tool.pod:134
23568 #: ../fuse/guestmount.pod:268 ../tools/virt-edit.pl:382
23569 #: ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1522
23570 #: ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319
23571 #: ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:287
23572 msgid ""
23573 "You should have received a copy of the GNU General Public License along with "
23574 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
23575 "Ave, Cambridge, MA 02139, USA."
23576 msgstr ""
23577
23578 # type: =head2
23579 #. type: =head2
23580 #: ../fish/guestfish-actions.pod:1
23581 msgid "add-cdrom"
23582 msgstr ""
23583
23584 # type: verbatim
23585 #. type: verbatim
23586 #: ../fish/guestfish-actions.pod:3
23587 #, no-wrap
23588 msgid ""
23589 " add-cdrom filename\n"
23590 "\n"
23591 msgstr ""
23592
23593 # type: textblock
23594 #. type: textblock
23595 #: ../fish/guestfish-actions.pod:15
23596 msgid ""
23597 "This call checks for the existence of C<filename>.  This stops you from "
23598 "specifying other types of drive which are supported by qemu such as C<nbd:> "
23599 "and C<http:> URLs.  To specify those, use the general L</config> call "
23600 "instead."
23601 msgstr ""
23602
23603 # type: textblock
23604 #. type: textblock
23605 #: ../fish/guestfish-actions.pod:22
23606 msgid ""
23607 "If you just want to add an ISO file (often you use this as an efficient way "
23608 "to transfer large files into the guest), then you should probably use L</add-"
23609 "drive-ro> instead."
23610 msgstr ""
23611
23612 # type: =head2
23613 #. type: =head2
23614 #: ../fish/guestfish-actions.pod:35
23615 msgid "add-domain"
23616 msgstr ""
23617
23618 # type: =head2
23619 #. type: =head2
23620 #: ../fish/guestfish-actions.pod:37
23621 msgid "domain"
23622 msgstr ""
23623
23624 #. type: verbatim
23625 #: ../fish/guestfish-actions.pod:39
23626 #, no-wrap
23627 msgid ""
23628 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n"
23629 "\n"
23630 msgstr ""
23631
23632 # type: textblock
23633 #. type: textblock
23634 #: ../fish/guestfish-actions.pod:41
23635 msgid ""
23636 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
23637 "It works by connecting to libvirt, requesting the domain and domain XML from "
23638 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
23639 msgstr ""
23640
23641 # type: textblock
23642 #. type: textblock
23643 #: ../fish/guestfish-actions.pod:71
23644 msgid ""
23645 "The other optional parameters are passed directly through to L</add-drive-"
23646 "opts>."
23647 msgstr ""
23648
23649 # type: textblock
23650 #. type: textblock
23651 #: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138
23652 #: ../fish/guestfish-actions.pod:2947
23653 msgid ""
23654 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
23655 msgstr ""
23656
23657 # type: =head2
23658 #. type: =head2
23659 #: ../fish/guestfish-actions.pod:76
23660 msgid "add-drive"
23661 msgstr ""
23662
23663 # type: verbatim
23664 #. type: verbatim
23665 #: ../fish/guestfish-actions.pod:78
23666 #, no-wrap
23667 msgid ""
23668 " add-drive filename\n"
23669 "\n"
23670 msgstr ""
23671
23672 # type: textblock
23673 #. type: textblock
23674 #: ../fish/guestfish-actions.pod:80
23675 msgid ""
23676 "This function is the equivalent of calling L</add-drive-opts> with no "
23677 "optional parameters, so the disk is added writable, with the format being "
23678 "detected automatically."
23679 msgstr ""
23680
23681 # type: textblock
23682 #. type: textblock
23683 #: ../fish/guestfish-actions.pod:84
23684 msgid ""
23685 "Automatic detection of the format opens you up to a potential security hole "
23686 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
23687 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
23688 "you should think about replacing calls to this function with calls to L</add-"
23689 "drive-opts>, and specifying the format."
23690 msgstr ""
23691
23692 # type: =head2
23693 #. type: =head2
23694 #: ../fish/guestfish-actions.pod:91
23695 msgid "add-drive-opts"
23696 msgstr ""
23697
23698 # type: =head2
23699 #. type: =head2
23700 #: ../fish/guestfish-actions.pod:93
23701 msgid "add"
23702 msgstr ""
23703
23704 # type: verbatim
23705 #. type: verbatim
23706 #: ../fish/guestfish-actions.pod:95
23707 #, no-wrap
23708 msgid ""
23709 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
23710 "\n"
23711 msgstr ""
23712
23713 # type: textblock
23714 #. type: textblock
23715 #: ../fish/guestfish-actions.pod:122
23716 msgid ""
23717 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
23718 "add-drive-ro>) then the format is automatically detected.  Possible formats "
23719 "include C<raw> and C<qcow2>."
23720 msgstr ""
23721
23722 # type: textblock
23723 #. type: textblock
23724 #: ../fish/guestfish-actions.pod:133
23725 msgid ""
23726 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
23727 "add-drive-with-if> call (q.v.)"
23728 msgstr ""
23729
23730 # type: =head2
23731 #. type: =head2
23732 #: ../fish/guestfish-actions.pod:140
23733 msgid "add-drive-ro"
23734 msgstr ""
23735
23736 # type: =head2
23737 #. type: =head2
23738 #: ../fish/guestfish-actions.pod:142
23739 msgid "add-ro"
23740 msgstr ""
23741
23742 # type: verbatim
23743 #. type: verbatim
23744 #: ../fish/guestfish-actions.pod:144
23745 #, no-wrap
23746 msgid ""
23747 " add-drive-ro filename\n"
23748 "\n"
23749 msgstr ""
23750
23751 # type: textblock
23752 #. type: textblock
23753 #: ../fish/guestfish-actions.pod:146
23754 msgid ""
23755 "This function is the equivalent of calling L</add-drive-opts> with the "
23756 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
23757 "is added read-only, with the format being detected automatically."
23758 msgstr ""
23759
23760 # type: =head2
23761 #. type: =head2
23762 #: ../fish/guestfish-actions.pod:151
23763 msgid "add-drive-ro-with-if"
23764 msgstr ""
23765
23766 # type: verbatim
23767 #. type: verbatim
23768 #: ../fish/guestfish-actions.pod:153
23769 #, no-wrap
23770 msgid ""
23771 " add-drive-ro-with-if filename iface\n"
23772 "\n"
23773 msgstr ""
23774
23775 # type: textblock
23776 #. type: textblock
23777 #: ../fish/guestfish-actions.pod:155
23778 msgid ""
23779 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
23780 "interface emulation to use at run time."
23781 msgstr ""
23782
23783 # type: =head2
23784 #. type: =head2
23785 #: ../fish/guestfish-actions.pod:165
23786 msgid "add-drive-with-if"
23787 msgstr ""
23788
23789 # type: verbatim
23790 #. type: verbatim
23791 #: ../fish/guestfish-actions.pod:167
23792 #, no-wrap
23793 msgid ""
23794 " add-drive-with-if filename iface\n"
23795 "\n"
23796 msgstr ""
23797
23798 # type: textblock
23799 #. type: textblock
23800 #: ../fish/guestfish-actions.pod:169
23801 msgid ""
23802 "This is the same as L</add-drive> but it allows you to specify the QEMU "
23803 "interface emulation to use at run time."
23804 msgstr ""
23805
23806 # type: =head2
23807 #. type: =head2
23808 #: ../fish/guestfish-actions.pod:179
23809 msgid "aug-clear"
23810 msgstr ""
23811
23812 # type: verbatim
23813 #. type: verbatim
23814 #: ../fish/guestfish-actions.pod:181
23815 #, no-wrap
23816 msgid ""
23817 " aug-clear augpath\n"
23818 "\n"
23819 msgstr ""
23820
23821 # type: =head2
23822 #. type: =head2
23823 #: ../fish/guestfish-actions.pod:186
23824 msgid "aug-close"
23825 msgstr ""
23826
23827 # type: verbatim
23828 #. type: verbatim
23829 #: ../fish/guestfish-actions.pod:188
23830 #, no-wrap
23831 msgid ""
23832 " aug-close\n"
23833 "\n"
23834 msgstr ""
23835
23836 # type: textblock
23837 #. type: textblock
23838 #: ../fish/guestfish-actions.pod:190
23839 msgid ""
23840 "Close the current Augeas handle and free up any resources used by it.  After "
23841 "calling this, you have to call L</aug-init> again before you can use any "
23842 "other Augeas functions."
23843 msgstr ""
23844
23845 # type: =head2
23846 #. type: =head2
23847 #: ../fish/guestfish-actions.pod:195
23848 msgid "aug-defnode"
23849 msgstr ""
23850
23851 # type: verbatim
23852 #. type: verbatim
23853 #: ../fish/guestfish-actions.pod:197
23854 #, no-wrap
23855 msgid ""
23856 " aug-defnode name expr val\n"
23857 "\n"
23858 msgstr ""
23859
23860 # type: textblock
23861 #. type: textblock
23862 #: ../fish/guestfish-actions.pod:202
23863 msgid ""
23864 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
23865 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
23866 "containing that single node."
23867 msgstr ""
23868
23869 # type: =head2
23870 #. type: =head2
23871 #: ../fish/guestfish-actions.pod:210
23872 msgid "aug-defvar"
23873 msgstr ""
23874
23875 # type: verbatim
23876 #. type: verbatim
23877 #: ../fish/guestfish-actions.pod:212
23878 #, no-wrap
23879 msgid ""
23880 " aug-defvar name expr\n"
23881 "\n"
23882 msgstr ""
23883
23884 # type: =head2
23885 #. type: =head2
23886 #: ../fish/guestfish-actions.pod:221
23887 msgid "aug-get"
23888 msgstr ""
23889
23890 # type: verbatim
23891 #. type: verbatim
23892 #: ../fish/guestfish-actions.pod:223
23893 #, no-wrap
23894 msgid ""
23895 " aug-get augpath\n"
23896 "\n"
23897 msgstr ""
23898
23899 # type: =head2
23900 #. type: =head2
23901 #: ../fish/guestfish-actions.pod:228
23902 msgid "aug-init"
23903 msgstr ""
23904
23905 # type: verbatim
23906 #. type: verbatim
23907 #: ../fish/guestfish-actions.pod:230
23908 #, no-wrap
23909 msgid ""
23910 " aug-init root flags\n"
23911 "\n"
23912 msgstr ""
23913
23914 # type: textblock
23915 #. type: textblock
23916 #: ../fish/guestfish-actions.pod:236
23917 msgid "You must call this before using any other L</aug-*> commands."
23918 msgstr ""
23919
23920 # type: textblock
23921 #. type: textblock
23922 #: ../fish/guestfish-actions.pod:271
23923 msgid "Do not load the tree in L</aug-init>."
23924 msgstr ""
23925
23926 # type: textblock
23927 #. type: textblock
23928 #: ../fish/guestfish-actions.pod:275
23929 msgid "To close the handle, you can call L</aug-close>."
23930 msgstr ""
23931
23932 # type: =head2
23933 #. type: =head2
23934 #: ../fish/guestfish-actions.pod:279
23935 msgid "aug-insert"
23936 msgstr ""
23937
23938 # type: verbatim
23939 #. type: verbatim
23940 #: ../fish/guestfish-actions.pod:281
23941 #, no-wrap
23942 msgid ""
23943 " aug-insert augpath label true|false\n"
23944 "\n"
23945 msgstr ""
23946
23947 # type: =head2
23948 #. type: =head2
23949 #: ../fish/guestfish-actions.pod:291
23950 msgid "aug-load"
23951 msgstr ""
23952
23953 # type: verbatim
23954 #. type: verbatim
23955 #: ../fish/guestfish-actions.pod:293
23956 #, no-wrap
23957 msgid ""
23958 " aug-load\n"
23959 "\n"
23960 msgstr ""
23961
23962 # type: =head2
23963 #. type: =head2
23964 #: ../fish/guestfish-actions.pod:300
23965 msgid "aug-ls"
23966 msgstr ""
23967
23968 # type: verbatim
23969 #. type: verbatim
23970 #: ../fish/guestfish-actions.pod:302
23971 #, no-wrap
23972 msgid ""
23973 " aug-ls augpath\n"
23974 "\n"
23975 msgstr ""
23976
23977 # type: textblock
23978 #. type: textblock
23979 #: ../fish/guestfish-actions.pod:304
23980 msgid ""
23981 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
23982 "resulting nodes into alphabetical order."
23983 msgstr ""
23984
23985 # type: =head2
23986 #. type: =head2
23987 #: ../fish/guestfish-actions.pod:307
23988 msgid "aug-match"
23989 msgstr ""
23990
23991 # type: verbatim
23992 #. type: verbatim
23993 #: ../fish/guestfish-actions.pod:309
23994 #, no-wrap
23995 msgid ""
23996 " aug-match augpath\n"
23997 "\n"
23998 msgstr ""
23999
24000 # type: =head2
24001 #. type: =head2
24002 #: ../fish/guestfish-actions.pod:315
24003 msgid "aug-mv"
24004 msgstr ""
24005
24006 # type: verbatim
24007 #. type: verbatim
24008 #: ../fish/guestfish-actions.pod:317
24009 #, no-wrap
24010 msgid ""
24011 " aug-mv src dest\n"
24012 "\n"
24013 msgstr ""
24014
24015 # type: =head2
24016 #. type: =head2
24017 #: ../fish/guestfish-actions.pod:322
24018 msgid "aug-rm"
24019 msgstr ""
24020
24021 # type: verbatim
24022 #. type: verbatim
24023 #: ../fish/guestfish-actions.pod:324
24024 #, no-wrap
24025 msgid ""
24026 " aug-rm augpath\n"
24027 "\n"
24028 msgstr ""
24029
24030 # type: =head2
24031 #. type: =head2
24032 #: ../fish/guestfish-actions.pod:330
24033 msgid "aug-save"
24034 msgstr ""
24035
24036 # type: verbatim
24037 #. type: verbatim
24038 #: ../fish/guestfish-actions.pod:332
24039 #, no-wrap
24040 msgid ""
24041 " aug-save\n"
24042 "\n"
24043 msgstr ""
24044
24045 # type: textblock
24046 #. type: textblock
24047 #: ../fish/guestfish-actions.pod:336
24048 msgid ""
24049 "The flags which were passed to L</aug-init> affect exactly how files are "
24050 "saved."
24051 msgstr ""
24052
24053 # type: =head2
24054 #. type: =head2
24055 #: ../fish/guestfish-actions.pod:339
24056 msgid "aug-set"
24057 msgstr ""
24058
24059 # type: verbatim
24060 #. type: verbatim
24061 #: ../fish/guestfish-actions.pod:341
24062 #, no-wrap
24063 msgid ""
24064 " aug-set augpath val\n"
24065 "\n"
24066 msgstr ""
24067
24068 # type: textblock
24069 #. type: textblock
24070 #: ../fish/guestfish-actions.pod:345
24071 msgid ""
24072 "In the Augeas API, it is possible to clear a node by setting the value to "
24073 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
24074 "this call.  Instead you must use the L</aug-clear> call."
24075 msgstr ""
24076
24077 # type: =head2
24078 #. type: =head2
24079 #: ../fish/guestfish-actions.pod:350
24080 msgid "available"
24081 msgstr ""
24082
24083 # type: verbatim
24084 #. type: verbatim
24085 #: ../fish/guestfish-actions.pod:352
24086 #, no-wrap
24087 msgid ""
24088 " available 'groups ...'\n"
24089 "\n"
24090 msgstr ""
24091
24092 # type: textblock
24093 #. type: textblock
24094 #: ../fish/guestfish-actions.pod:358
24095 msgid ""
24096 "The libguestfs groups, and the functions that those groups correspond to, "
24097 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
24098 "runtime by calling L</available-all-groups>."
24099 msgstr ""
24100
24101 # type: textblock
24102 #. type: textblock
24103 #: ../fish/guestfish-actions.pod:382
24104 msgid "You must call L</launch> before calling this function."
24105 msgstr ""
24106
24107 # type: textblock
24108 #. type: textblock
24109 #: ../fish/guestfish-actions.pod:404
24110 msgid ""
24111 "This call was added in version C<1.0.80>.  In previous versions of "
24112 "libguestfs all you could do would be to speculatively execute a command to "
24113 "find out if the daemon implemented it.  See also L</version>."
24114 msgstr ""
24115
24116 # type: =head2
24117 #. type: =head2
24118 #: ../fish/guestfish-actions.pod:411
24119 msgid "available-all-groups"
24120 msgstr ""
24121
24122 # type: verbatim
24123 #. type: verbatim
24124 #: ../fish/guestfish-actions.pod:413
24125 #, no-wrap
24126 msgid ""
24127 " available-all-groups\n"
24128 "\n"
24129 msgstr ""
24130
24131 # type: textblock
24132 #. type: textblock
24133 #: ../fish/guestfish-actions.pod:415
24134 msgid ""
24135 "This command returns a list of all optional groups that this daemon knows "
24136 "about.  Note this returns both supported and unsupported groups.  To find "
24137 "out which ones the daemon can actually support you have to call L</"
24138 "available> on each member of the returned list."
24139 msgstr ""
24140
24141 # type: textblock
24142 #. type: textblock
24143 #: ../fish/guestfish-actions.pod:421
24144 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
24145 msgstr ""
24146
24147 # type: =head2
24148 #. type: =head2
24149 #: ../fish/guestfish-actions.pod:423
24150 msgid "base64-in"
24151 msgstr ""
24152
24153 # type: verbatim
24154 #. type: verbatim
24155 #: ../fish/guestfish-actions.pod:425
24156 #, no-wrap
24157 msgid ""
24158 " base64-in (base64file|-) filename\n"
24159 "\n"
24160 msgstr ""
24161
24162 # type: textblock
24163 #. type: textblock
24164 #: ../fish/guestfish-actions.pod:430 ../fish/guestfish-actions.pod:439
24165 #: ../fish/guestfish-actions.pod:663 ../fish/guestfish-actions.pod:832
24166 #: ../fish/guestfish-actions.pod:851 ../fish/guestfish-actions.pod:1228
24167 #: ../fish/guestfish-actions.pod:4341 ../fish/guestfish-actions.pod:4353
24168 #: ../fish/guestfish-actions.pod:4364 ../fish/guestfish-actions.pod:4375
24169 #: ../fish/guestfish-actions.pod:4427 ../fish/guestfish-actions.pod:4436
24170 #: ../fish/guestfish-actions.pod:4490 ../fish/guestfish-actions.pod:4513
24171 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
24172 msgstr ""
24173
24174 # type: =head2
24175 #. type: =head2
24176 #: ../fish/guestfish-actions.pod:432
24177 msgid "base64-out"
24178 msgstr ""
24179
24180 # type: verbatim
24181 #. type: verbatim
24182 #: ../fish/guestfish-actions.pod:434
24183 #, no-wrap
24184 msgid ""
24185 " base64-out filename (base64file|-)\n"
24186 "\n"
24187 msgstr ""
24188
24189 # type: =head2
24190 #. type: =head2
24191 #: ../fish/guestfish-actions.pod:441
24192 msgid "blockdev-flushbufs"
24193 msgstr ""
24194
24195 # type: verbatim
24196 #. type: verbatim
24197 #: ../fish/guestfish-actions.pod:443
24198 #, no-wrap
24199 msgid ""
24200 " blockdev-flushbufs device\n"
24201 "\n"
24202 msgstr ""
24203
24204 # type: =head2
24205 #. type: =head2
24206 #: ../fish/guestfish-actions.pod:450
24207 msgid "blockdev-getbsz"
24208 msgstr ""
24209
24210 # type: verbatim
24211 #. type: verbatim
24212 #: ../fish/guestfish-actions.pod:452
24213 #, no-wrap
24214 msgid ""
24215 " blockdev-getbsz device\n"
24216 "\n"
24217 msgstr ""
24218
24219 # type: =head2
24220 #. type: =head2
24221 #: ../fish/guestfish-actions.pod:461
24222 msgid "blockdev-getro"
24223 msgstr ""
24224
24225 # type: verbatim
24226 #. type: verbatim
24227 #: ../fish/guestfish-actions.pod:463
24228 #, no-wrap
24229 msgid ""
24230 " blockdev-getro device\n"
24231 "\n"
24232 msgstr ""
24233
24234 # type: =head2
24235 #. type: =head2
24236 #: ../fish/guestfish-actions.pod:470
24237 msgid "blockdev-getsize64"
24238 msgstr ""
24239
24240 # type: verbatim
24241 #. type: verbatim
24242 #: ../fish/guestfish-actions.pod:472
24243 #, no-wrap
24244 msgid ""
24245 " blockdev-getsize64 device\n"
24246 "\n"
24247 msgstr ""
24248
24249 # type: textblock
24250 #. type: textblock
24251 #: ../fish/guestfish-actions.pod:476
24252 msgid "See also L</blockdev-getsz>."
24253 msgstr ""
24254
24255 # type: =head2
24256 #. type: =head2
24257 #: ../fish/guestfish-actions.pod:480
24258 msgid "blockdev-getss"
24259 msgstr ""
24260
24261 # type: verbatim
24262 #. type: verbatim
24263 #: ../fish/guestfish-actions.pod:482
24264 #, no-wrap
24265 msgid ""
24266 " blockdev-getss device\n"
24267 "\n"
24268 msgstr ""
24269
24270 # type: textblock
24271 #. type: textblock
24272 #: ../fish/guestfish-actions.pod:487
24273 msgid ""
24274 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
24275 msgstr ""
24276
24277 # type: =head2
24278 #. type: =head2
24279 #: ../fish/guestfish-actions.pod:492
24280 msgid "blockdev-getsz"
24281 msgstr ""
24282
24283 # type: verbatim
24284 #. type: verbatim
24285 #: ../fish/guestfish-actions.pod:494
24286 #, no-wrap
24287 msgid ""
24288 " blockdev-getsz device\n"
24289 "\n"
24290 msgstr ""
24291
24292 # type: textblock
24293 #. type: textblock
24294 #: ../fish/guestfish-actions.pod:499
24295 msgid ""
24296 "See also L</blockdev-getss> for the real sector size of the device, and L</"
24297 "blockdev-getsize64> for the more useful I<size in bytes>."
24298 msgstr ""
24299
24300 # type: =head2
24301 #. type: =head2
24302 #: ../fish/guestfish-actions.pod:505
24303 msgid "blockdev-rereadpt"
24304 msgstr ""
24305
24306 # type: verbatim
24307 #. type: verbatim
24308 #: ../fish/guestfish-actions.pod:507
24309 #, no-wrap
24310 msgid ""
24311 " blockdev-rereadpt device\n"
24312 "\n"
24313 msgstr ""
24314
24315 # type: =head2
24316 #. type: =head2
24317 #: ../fish/guestfish-actions.pod:513
24318 msgid "blockdev-setbsz"
24319 msgstr ""
24320
24321 # type: verbatim
24322 #. type: verbatim
24323 #: ../fish/guestfish-actions.pod:515
24324 #, no-wrap
24325 msgid ""
24326 " blockdev-setbsz device blocksize\n"
24327 "\n"
24328 msgstr ""
24329
24330 # type: =head2
24331 #. type: =head2
24332 #: ../fish/guestfish-actions.pod:524
24333 msgid "blockdev-setro"
24334 msgstr ""
24335
24336 # type: verbatim
24337 #. type: verbatim
24338 #: ../fish/guestfish-actions.pod:526
24339 #, no-wrap
24340 msgid ""
24341 " blockdev-setro device\n"
24342 "\n"
24343 msgstr ""
24344
24345 # type: =head2
24346 #. type: =head2
24347 #: ../fish/guestfish-actions.pod:532
24348 msgid "blockdev-setrw"
24349 msgstr ""
24350
24351 # type: verbatim
24352 #. type: verbatim
24353 #: ../fish/guestfish-actions.pod:534
24354 #, no-wrap
24355 msgid ""
24356 " blockdev-setrw device\n"
24357 "\n"
24358 msgstr ""
24359
24360 # type: =head2
24361 #. type: =head2
24362 #: ../fish/guestfish-actions.pod:540
24363 msgid "case-sensitive-path"
24364 msgstr ""
24365
24366 # type: verbatim
24367 #. type: verbatim
24368 #: ../fish/guestfish-actions.pod:542
24369 #, no-wrap
24370 msgid ""
24371 " case-sensitive-path path\n"
24372 "\n"
24373 msgstr ""
24374
24375 # type: textblock
24376 #. type: textblock
24377 #: ../fish/guestfish-actions.pod:566
24378 msgid ""
24379 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
24380 "WINDOWS/system32\"> (the exact return value would depend on details of how "
24381 "the directories were originally created under Windows)."
24382 msgstr ""
24383
24384 # type: textblock
24385 #. type: textblock
24386 #: ../fish/guestfish-actions.pod:574
24387 msgid "See also L</realpath>."
24388 msgstr ""
24389
24390 # type: =head2
24391 #. type: =head2
24392 #: ../fish/guestfish-actions.pod:576
24393 msgid "cat"
24394 msgstr ""
24395
24396 # type: verbatim
24397 #. type: verbatim
24398 #: ../fish/guestfish-actions.pod:578
24399 #, no-wrap
24400 msgid ""
24401 " cat path\n"
24402 "\n"
24403 msgstr ""
24404
24405 # type: textblock
24406 #. type: textblock
24407 #: ../fish/guestfish-actions.pod:582
24408 msgid ""
24409 "Note that this function cannot correctly handle binary files (specifically, "
24410 "files containing C<\\0> character which is treated as end of string).  For "
24411 "those you need to use the L</read-file> or L</download> functions which have "
24412 "a more complex interface."
24413 msgstr ""
24414
24415 # type: =head2
24416 #. type: =head2
24417 #: ../fish/guestfish-actions.pod:590
24418 msgid "checksum"
24419 msgstr ""
24420
24421 # type: verbatim
24422 #. type: verbatim
24423 #: ../fish/guestfish-actions.pod:592
24424 #, no-wrap
24425 msgid ""
24426 " checksum csumtype path\n"
24427 "\n"
24428 msgstr ""
24429
24430 # type: textblock
24431 #. type: textblock
24432 #: ../fish/guestfish-actions.pod:635
24433 msgid "To get the checksum for a device, use L</checksum-device>."
24434 msgstr ""
24435
24436 # type: textblock
24437 #. type: textblock
24438 #: ../fish/guestfish-actions.pod:637
24439 msgid "To get the checksums for many files, use L</checksums-out>."
24440 msgstr ""
24441
24442 # type: =head2
24443 #. type: =head2
24444 #: ../fish/guestfish-actions.pod:639
24445 msgid "checksum-device"
24446 msgstr ""
24447
24448 # type: verbatim
24449 #. type: verbatim
24450 #: ../fish/guestfish-actions.pod:641
24451 #, no-wrap
24452 msgid ""
24453 " checksum-device csumtype device\n"
24454 "\n"
24455 msgstr ""
24456
24457 # type: textblock
24458 #. type: textblock
24459 #: ../fish/guestfish-actions.pod:643
24460 msgid ""
24461 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
24462 "device named C<device>.  For the types of checksums supported see the L</"
24463 "checksum> command."
24464 msgstr ""
24465
24466 # type: =head2
24467 #. type: =head2
24468 #: ../fish/guestfish-actions.pod:647
24469 msgid "checksums-out"
24470 msgstr ""
24471
24472 # type: verbatim
24473 #. type: verbatim
24474 #: ../fish/guestfish-actions.pod:649
24475 #, no-wrap
24476 msgid ""
24477 " checksums-out csumtype directory (sumsfile|-)\n"
24478 "\n"
24479 msgstr ""
24480
24481 # type: =head2
24482 #. type: =head2
24483 #: ../fish/guestfish-actions.pod:665
24484 msgid "chmod"
24485 msgstr ""
24486
24487 # type: verbatim
24488 #. type: verbatim
24489 #: ../fish/guestfish-actions.pod:667
24490 #, no-wrap
24491 msgid ""
24492 " chmod mode path\n"
24493 "\n"
24494 msgstr ""
24495
24496 # type: =head2
24497 #. type: =head2
24498 #: ../fish/guestfish-actions.pod:678
24499 msgid "chown"
24500 msgstr ""
24501
24502 # type: verbatim
24503 #. type: verbatim
24504 #: ../fish/guestfish-actions.pod:680
24505 #, no-wrap
24506 msgid ""
24507 " chown owner group path\n"
24508 "\n"
24509 msgstr ""
24510
24511 # type: =head2
24512 #. type: =head2
24513 #: ../fish/guestfish-actions.pod:688
24514 msgid "command"
24515 msgstr ""
24516
24517 # type: verbatim
24518 #. type: verbatim
24519 #: ../fish/guestfish-actions.pod:690
24520 #, no-wrap
24521 msgid ""
24522 " command 'arguments ...'\n"
24523 "\n"
24524 msgstr ""
24525
24526 # type: textblock
24527 #. type: textblock
24528 #: ../fish/guestfish-actions.pod:697
24529 msgid ""
24530 "The single parameter is an argv-style list of arguments.  The first element "
24531 "is the name of the program to run.  Subsequent elements are parameters.  The "
24532 "list must be non-empty (ie. must contain a program name).  Note that the "
24533 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
24534 msgstr ""
24535
24536 # type: =head2
24537 #. type: =head2
24538 #: ../fish/guestfish-actions.pod:725
24539 msgid "command-lines"
24540 msgstr ""
24541
24542 # type: verbatim
24543 #. type: verbatim
24544 #: ../fish/guestfish-actions.pod:727
24545 #, no-wrap
24546 msgid ""
24547 " command-lines 'arguments ...'\n"
24548 "\n"
24549 msgstr ""
24550
24551 # type: textblock
24552 #. type: textblock
24553 #: ../fish/guestfish-actions.pod:729
24554 msgid ""
24555 "This is the same as L</command>, but splits the result into a list of lines."
24556 msgstr ""
24557
24558 # type: textblock
24559 #. type: textblock
24560 #: ../fish/guestfish-actions.pod:732
24561 msgid "See also: L</sh-lines>"
24562 msgstr ""
24563
24564 # type: =head2
24565 #. type: =head2
24566 #: ../fish/guestfish-actions.pod:737
24567 msgid "config"
24568 msgstr ""
24569
24570 # type: verbatim
24571 #. type: verbatim
24572 #: ../fish/guestfish-actions.pod:739
24573 #, no-wrap
24574 msgid ""
24575 " config qemuparam qemuvalue\n"
24576 "\n"
24577 msgstr ""
24578
24579 # type: =head2
24580 #. type: =head2
24581 #: ../fish/guestfish-actions.pod:750
24582 msgid "copy-size"
24583 msgstr ""
24584
24585 # type: verbatim
24586 #. type: verbatim
24587 #: ../fish/guestfish-actions.pod:752
24588 #, no-wrap
24589 msgid ""
24590 " copy-size src dest size\n"
24591 "\n"
24592 msgstr ""
24593
24594 # type: =head2
24595 #. type: =head2
24596 #: ../fish/guestfish-actions.pod:760
24597 msgid "cp"
24598 msgstr ""
24599
24600 # type: verbatim
24601 #. type: verbatim
24602 #: ../fish/guestfish-actions.pod:762
24603 #, no-wrap
24604 msgid ""
24605 " cp src dest\n"
24606 "\n"
24607 msgstr ""
24608
24609 # type: =head2
24610 #. type: =head2
24611 #: ../fish/guestfish-actions.pod:767
24612 msgid "cp-a"
24613 msgstr ""
24614
24615 # type: verbatim
24616 #. type: verbatim
24617 #: ../fish/guestfish-actions.pod:769
24618 #, no-wrap
24619 msgid ""
24620 " cp-a src dest\n"
24621 "\n"
24622 msgstr ""
24623
24624 # type: =head2
24625 #. type: =head2
24626 #: ../fish/guestfish-actions.pod:774
24627 msgid "dd"
24628 msgstr ""
24629
24630 # type: verbatim
24631 #. type: verbatim
24632 #: ../fish/guestfish-actions.pod:776
24633 #, no-wrap
24634 msgid ""
24635 " dd src dest\n"
24636 "\n"
24637 msgstr ""
24638
24639 # type: textblock
24640 #. type: textblock
24641 #: ../fish/guestfish-actions.pod:783
24642 msgid ""
24643 "If the destination is a device, it must be as large or larger than the "
24644 "source file or device, otherwise the copy will fail.  This command cannot do "
24645 "partial copies (see L</copy-size>)."
24646 msgstr ""
24647
24648 # type: =head2
24649 #. type: =head2
24650 #: ../fish/guestfish-actions.pod:787
24651 msgid "df"
24652 msgstr ""
24653
24654 # type: verbatim
24655 #. type: verbatim
24656 #: ../fish/guestfish-actions.pod:789
24657 #, no-wrap
24658 msgid ""
24659 " df\n"
24660 "\n"
24661 msgstr ""
24662
24663 # type: textblock
24664 #. type: textblock
24665 #: ../fish/guestfish-actions.pod:793 ../fish/guestfish-actions.pod:804
24666 msgid ""
24667 "This command is mostly useful for interactive sessions.  It is I<not> "
24668 "intended that you try to parse the output string.  Use L</statvfs> from "
24669 "programs."
24670 msgstr ""
24671
24672 # type: =head2
24673 #. type: =head2
24674 #: ../fish/guestfish-actions.pod:797
24675 msgid "df-h"
24676 msgstr ""
24677
24678 # type: verbatim
24679 #. type: verbatim
24680 #: ../fish/guestfish-actions.pod:799
24681 #, no-wrap
24682 msgid ""
24683 " df-h\n"
24684 "\n"
24685 msgstr ""
24686
24687 # type: =head2
24688 #. type: =head2
24689 #: ../fish/guestfish-actions.pod:808
24690 msgid "dmesg"
24691 msgstr ""
24692
24693 # type: verbatim
24694 #. type: verbatim
24695 #: ../fish/guestfish-actions.pod:810
24696 #, no-wrap
24697 msgid ""
24698 " dmesg\n"
24699 "\n"
24700 msgstr ""
24701
24702 # type: textblock
24703 #. type: textblock
24704 #: ../fish/guestfish-actions.pod:816
24705 msgid ""
24706 "Another way to get the same information is to enable verbose messages with "
24707 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
24708 "before running the program."
24709 msgstr ""
24710
24711 # type: =head2
24712 #. type: =head2
24713 #: ../fish/guestfish-actions.pod:821
24714 msgid "download"
24715 msgstr ""
24716
24717 # type: verbatim
24718 #. type: verbatim
24719 #: ../fish/guestfish-actions.pod:823
24720 #, no-wrap
24721 msgid ""
24722 " download remotefilename (filename|-)\n"
24723 "\n"
24724 msgstr ""
24725
24726 # type: textblock
24727 #. type: textblock
24728 #: ../fish/guestfish-actions.pod:830
24729 msgid "See also L</upload>, L</cat>."
24730 msgstr ""
24731
24732 # type: =head2
24733 #. type: =head2
24734 #: ../fish/guestfish-actions.pod:834
24735 msgid "download-offset"
24736 msgstr ""
24737
24738 # type: verbatim
24739 #. type: verbatim
24740 #: ../fish/guestfish-actions.pod:836
24741 #, no-wrap
24742 msgid ""
24743 " download-offset remotefilename (filename|-) offset size\n"
24744 "\n"
24745 msgstr ""
24746
24747 # type: textblock
24748 #. type: textblock
24749 #: ../fish/guestfish-actions.pod:844
24750 msgid ""
24751 "Note that there is no limit on the amount of data that can be downloaded "
24752 "with this call, unlike with L</pread>, and this call always reads the full "
24753 "amount unless an error occurs."
24754 msgstr ""
24755
24756 # type: textblock
24757 #. type: textblock
24758 #: ../fish/guestfish-actions.pod:849
24759 msgid "See also L</download>, L</pread>."
24760 msgstr ""
24761
24762 # type: =head2
24763 #. type: =head2
24764 #: ../fish/guestfish-actions.pod:853
24765 msgid "drop-caches"
24766 msgstr ""
24767
24768 # type: verbatim
24769 #. type: verbatim
24770 #: ../fish/guestfish-actions.pod:855
24771 #, no-wrap
24772 msgid ""
24773 " drop-caches whattodrop\n"
24774 "\n"
24775 msgstr ""
24776
24777 # type: =head2
24778 #. type: =head2
24779 #: ../fish/guestfish-actions.pod:867
24780 msgid "du"
24781 msgstr ""
24782
24783 # type: verbatim
24784 #. type: verbatim
24785 #: ../fish/guestfish-actions.pod:869
24786 #, no-wrap
24787 msgid ""
24788 " du path\n"
24789 "\n"
24790 msgstr ""
24791
24792 # type: =head2
24793 #. type: =head2
24794 #: ../fish/guestfish-actions.pod:881
24795 msgid "e2fsck-f"
24796 msgstr ""
24797
24798 # type: verbatim
24799 #. type: verbatim
24800 #: ../fish/guestfish-actions.pod:883
24801 #, no-wrap
24802 msgid ""
24803 " e2fsck-f device\n"
24804 "\n"
24805 msgstr ""
24806
24807 # type: textblock
24808 #. type: textblock
24809 #: ../fish/guestfish-actions.pod:889
24810 msgid ""
24811 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
24812 "should use L</fsck>."
24813 msgstr ""
24814
24815 # type: =head2
24816 #. type: =head2
24817 #: ../fish/guestfish-actions.pod:892
24818 msgid "echo-daemon"
24819 msgstr ""
24820
24821 # type: verbatim
24822 #. type: verbatim
24823 #: ../fish/guestfish-actions.pod:894
24824 #, no-wrap
24825 msgid ""
24826 " echo-daemon 'words ...'\n"
24827 "\n"
24828 msgstr ""
24829
24830 # type: textblock
24831 #. type: textblock
24832 #: ../fish/guestfish-actions.pod:901
24833 msgid "See also L</ping-daemon>."
24834 msgstr ""
24835
24836 # type: =head2
24837 #. type: =head2
24838 #: ../fish/guestfish-actions.pod:903
24839 msgid "egrep"
24840 msgstr ""
24841
24842 # type: verbatim
24843 #. type: verbatim
24844 #: ../fish/guestfish-actions.pod:905
24845 #, no-wrap
24846 msgid ""
24847 " egrep regex path\n"
24848 "\n"
24849 msgstr ""
24850
24851 # type: =head2
24852 #. type: =head2
24853 #: ../fish/guestfish-actions.pod:913
24854 msgid "egrepi"
24855 msgstr ""
24856
24857 # type: verbatim
24858 #. type: verbatim
24859 #: ../fish/guestfish-actions.pod:915
24860 #, no-wrap
24861 msgid ""
24862 " egrepi regex path\n"
24863 "\n"
24864 msgstr ""
24865
24866 # type: =head2
24867 #. type: =head2
24868 #: ../fish/guestfish-actions.pod:923
24869 msgid "equal"
24870 msgstr ""
24871
24872 # type: verbatim
24873 #. type: verbatim
24874 #: ../fish/guestfish-actions.pod:925
24875 #, no-wrap
24876 msgid ""
24877 " equal file1 file2\n"
24878 "\n"
24879 msgstr ""
24880
24881 # type: =head2
24882 #. type: =head2
24883 #: ../fish/guestfish-actions.pod:932
24884 msgid "exists"
24885 msgstr ""
24886
24887 # type: verbatim
24888 #. type: verbatim
24889 #: ../fish/guestfish-actions.pod:934
24890 #, no-wrap
24891 msgid ""
24892 " exists path\n"
24893 "\n"
24894 msgstr ""
24895
24896 # type: textblock
24897 #. type: textblock
24898 #: ../fish/guestfish-actions.pod:939
24899 msgid "See also L</is-file>, L</is-dir>, L</stat>."
24900 msgstr ""
24901
24902 # type: =head2
24903 #. type: =head2
24904 #: ../fish/guestfish-actions.pod:941
24905 msgid "fallocate"
24906 msgstr ""
24907
24908 # type: verbatim
24909 #. type: verbatim
24910 #: ../fish/guestfish-actions.pod:943
24911 #, no-wrap
24912 msgid ""
24913 " fallocate path len\n"
24914 "\n"
24915 msgstr ""
24916
24917 # type: =head2
24918 #. type: =head2
24919 #: ../fish/guestfish-actions.pod:960
24920 msgid "fallocate64"
24921 msgstr ""
24922
24923 # type: verbatim
24924 #. type: verbatim
24925 #: ../fish/guestfish-actions.pod:962
24926 #, no-wrap
24927 msgid ""
24928 " fallocate64 path len\n"
24929 "\n"
24930 msgstr ""
24931
24932 # type: textblock
24933 #. type: textblock
24934 #: ../fish/guestfish-actions.pod:968
24935 msgid ""
24936 "Note that this call allocates disk blocks for the file.  To create a sparse "
24937 "file use L</truncate-size> instead."
24938 msgstr ""
24939
24940 # type: textblock
24941 #. type: textblock
24942 #: ../fish/guestfish-actions.pod:971
24943 msgid ""
24944 "The deprecated call L</fallocate> does the same, but owing to an oversight "
24945 "it only allowed 30 bit lengths to be specified, effectively limiting the "
24946 "maximum size of files created through that call to 1GB."
24947 msgstr ""
24948
24949 # type: =head2
24950 #. type: =head2
24951 #: ../fish/guestfish-actions.pod:980
24952 msgid "fgrep"
24953 msgstr ""
24954
24955 # type: verbatim
24956 #. type: verbatim
24957 #: ../fish/guestfish-actions.pod:982
24958 #, no-wrap
24959 msgid ""
24960 " fgrep pattern path\n"
24961 "\n"
24962 msgstr ""
24963
24964 # type: =head2
24965 #. type: =head2
24966 #: ../fish/guestfish-actions.pod:990
24967 msgid "fgrepi"
24968 msgstr ""
24969
24970 # type: verbatim
24971 #. type: verbatim
24972 #: ../fish/guestfish-actions.pod:992
24973 #, no-wrap
24974 msgid ""
24975 " fgrepi pattern path\n"
24976 "\n"
24977 msgstr ""
24978
24979 # type: =head2
24980 #. type: =head2
24981 #: ../fish/guestfish-actions.pod:1000
24982 msgid "file"
24983 msgstr ""
24984
24985 # type: verbatim
24986 #. type: verbatim
24987 #: ../fish/guestfish-actions.pod:1002
24988 #, no-wrap
24989 msgid ""
24990 " file path\n"
24991 "\n"
24992 msgstr ""
24993
24994 # type: textblock
24995 #. type: textblock
24996 #: ../fish/guestfish-actions.pod:1014
24997 msgid ""
24998 "This command can also be used on C</dev/> devices (and partitions, LV "
24999 "names).  You can for example use this to determine if a device contains a "
25000 "filesystem, although it's usually better to use L</vfs-type>."
25001 msgstr ""
25002
25003 # type: =head2
25004 #. type: =head2
25005 #: ../fish/guestfish-actions.pod:1024
25006 msgid "file-architecture"
25007 msgstr ""
25008
25009 # type: verbatim
25010 #. type: verbatim
25011 #: ../fish/guestfish-actions.pod:1026
25012 #, no-wrap
25013 msgid ""
25014 " file-architecture filename\n"
25015 "\n"
25016 msgstr ""
25017
25018 # type: =head2
25019 #. type: =head2
25020 #: ../fish/guestfish-actions.pod:1129
25021 msgid "filesize"
25022 msgstr ""
25023
25024 # type: verbatim
25025 #. type: verbatim
25026 #: ../fish/guestfish-actions.pod:1131
25027 #, no-wrap
25028 msgid ""
25029 " filesize file\n"
25030 "\n"
25031 msgstr ""
25032
25033 # type: textblock
25034 #. type: textblock
25035 #: ../fish/guestfish-actions.pod:1135
25036 msgid ""
25037 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
25038 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
25039 msgstr ""
25040
25041 # type: =head2
25042 #. type: =head2
25043 #: ../fish/guestfish-actions.pod:1139
25044 msgid "fill"
25045 msgstr ""
25046
25047 # type: verbatim
25048 #. type: verbatim
25049 #: ../fish/guestfish-actions.pod:1141
25050 #, no-wrap
25051 msgid ""
25052 " fill c len path\n"
25053 "\n"
25054 msgstr ""
25055
25056 # type: textblock
25057 #. type: textblock
25058 #: ../fish/guestfish-actions.pod:1147
25059 msgid ""
25060 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
25061 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
25062 "L</fill-pattern>."
25063 msgstr ""
25064
25065 # type: =head2
25066 #. type: =head2
25067 #: ../fish/guestfish-actions.pod:1152
25068 msgid "fill-pattern"
25069 msgstr ""
25070
25071 # type: verbatim
25072 #. type: verbatim
25073 #: ../fish/guestfish-actions.pod:1154
25074 #, no-wrap
25075 msgid ""
25076 " fill-pattern pattern len path\n"
25077 "\n"
25078 msgstr ""
25079
25080 # type: textblock
25081 #. type: textblock
25082 #: ../fish/guestfish-actions.pod:1156
25083 msgid ""
25084 "This function is like L</fill> except that it creates a new file of length "
25085 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
25086 "is truncated if necessary to ensure the length of the file is exactly C<len> "
25087 "bytes."
25088 msgstr ""
25089
25090 # type: =head2
25091 #. type: =head2
25092 #: ../fish/guestfish-actions.pod:1161
25093 msgid "find"
25094 msgstr ""
25095
25096 # type: verbatim
25097 #. type: verbatim
25098 #: ../fish/guestfish-actions.pod:1163
25099 #, no-wrap
25100 msgid ""
25101 " find directory\n"
25102 "\n"
25103 msgstr ""
25104
25105 # type: textblock
25106 #. type: textblock
25107 #: ../fish/guestfish-actions.pod:1177
25108 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
25109 msgstr ""
25110
25111 # type: textblock
25112 #. type: textblock
25113 #: ../fish/guestfish-actions.pod:1190
25114 msgid "See also L</find0>."
25115 msgstr ""
25116
25117 # type: =head2
25118 #. type: =head2
25119 #: ../fish/guestfish-actions.pod:1195
25120 msgid "find0"
25121 msgstr ""
25122
25123 # type: verbatim
25124 #. type: verbatim
25125 #: ../fish/guestfish-actions.pod:1197
25126 #, no-wrap
25127 msgid ""
25128 " find0 directory (files|-)\n"
25129 "\n"
25130 msgstr ""
25131
25132 # type: textblock
25133 #. type: textblock
25134 #: ../fish/guestfish-actions.pod:1203
25135 msgid ""
25136 "This command works the same way as L</find> with the following exceptions:"
25137 msgstr ""
25138
25139 # type: =head2
25140 #. type: =head2
25141 #: ../fish/guestfish-actions.pod:1230
25142 msgid "findfs-label"
25143 msgstr ""
25144
25145 # type: verbatim
25146 #. type: verbatim
25147 #: ../fish/guestfish-actions.pod:1232
25148 #, no-wrap
25149 msgid ""
25150 " findfs-label label\n"
25151 "\n"
25152 msgstr ""
25153
25154 # type: textblock
25155 #. type: textblock
25156 #: ../fish/guestfish-actions.pod:1238
25157 msgid "To find the label of a filesystem, use L</vfs-label>."
25158 msgstr ""
25159
25160 # type: =head2
25161 #. type: =head2
25162 #: ../fish/guestfish-actions.pod:1240
25163 msgid "findfs-uuid"
25164 msgstr ""
25165
25166 # type: verbatim
25167 #. type: verbatim
25168 #: ../fish/guestfish-actions.pod:1242
25169 #, no-wrap
25170 msgid ""
25171 " findfs-uuid uuid\n"
25172 "\n"
25173 msgstr ""
25174
25175 # type: textblock
25176 #. type: textblock
25177 #: ../fish/guestfish-actions.pod:1248
25178 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
25179 msgstr ""
25180
25181 # type: =head2
25182 #. type: =head2
25183 #: ../fish/guestfish-actions.pod:1250
25184 msgid "fsck"
25185 msgstr ""
25186
25187 # type: verbatim
25188 #. type: verbatim
25189 #: ../fish/guestfish-actions.pod:1252
25190 #, no-wrap
25191 msgid ""
25192 " fsck fstype device\n"
25193 "\n"
25194 msgstr ""
25195
25196 # type: =head2
25197 #. type: =head2
25198 #: ../fish/guestfish-actions.pod:1282
25199 msgid "get-append"
25200 msgstr ""
25201
25202 # type: verbatim
25203 #. type: verbatim
25204 #: ../fish/guestfish-actions.pod:1284
25205 #, no-wrap
25206 msgid ""
25207 " get-append\n"
25208 "\n"
25209 msgstr ""
25210
25211 #. type: =head2
25212 #: ../fish/guestfish-actions.pod:1291
25213 msgid "get-attach-method"
25214 msgstr ""
25215
25216 #. type: verbatim
25217 #: ../fish/guestfish-actions.pod:1293
25218 #, no-wrap
25219 msgid ""
25220 " get-attach-method\n"
25221 "\n"
25222 msgstr ""
25223
25224 #. type: textblock
25225 #: ../fish/guestfish-actions.pod:1295
25226 msgid "Return the current attach method.  See L</set-attach-method>."
25227 msgstr ""
25228
25229 # type: =head2
25230 #. type: =head2
25231 #: ../fish/guestfish-actions.pod:1297
25232 msgid "get-autosync"
25233 msgstr ""
25234
25235 # type: verbatim
25236 #. type: verbatim
25237 #: ../fish/guestfish-actions.pod:1299
25238 #, no-wrap
25239 msgid ""
25240 " get-autosync\n"
25241 "\n"
25242 msgstr ""
25243
25244 # type: =head2
25245 #. type: =head2
25246 #: ../fish/guestfish-actions.pod:1303
25247 msgid "get-direct"
25248 msgstr ""
25249
25250 # type: verbatim
25251 #. type: verbatim
25252 #: ../fish/guestfish-actions.pod:1305
25253 #, no-wrap
25254 msgid ""
25255 " get-direct\n"
25256 "\n"
25257 msgstr ""
25258
25259 # type: =head2
25260 #. type: =head2
25261 #: ../fish/guestfish-actions.pod:1309
25262 msgid "get-e2label"
25263 msgstr ""
25264
25265 # type: verbatim
25266 #. type: verbatim
25267 #: ../fish/guestfish-actions.pod:1311
25268 #, no-wrap
25269 msgid ""
25270 " get-e2label device\n"
25271 "\n"
25272 msgstr ""
25273
25274 # type: =head2
25275 #. type: =head2
25276 #: ../fish/guestfish-actions.pod:1323
25277 msgid "get-e2uuid"
25278 msgstr ""
25279
25280 # type: verbatim
25281 #. type: verbatim
25282 #: ../fish/guestfish-actions.pod:1325
25283 #, no-wrap
25284 msgid ""
25285 " get-e2uuid device\n"
25286 "\n"
25287 msgstr ""
25288
25289 # type: =head2
25290 #. type: =head2
25291 #: ../fish/guestfish-actions.pod:1337
25292 msgid "get-memsize"
25293 msgstr ""
25294
25295 # type: verbatim
25296 #. type: verbatim
25297 #: ../fish/guestfish-actions.pod:1339
25298 #, no-wrap
25299 msgid ""
25300 " get-memsize\n"
25301 "\n"
25302 msgstr ""
25303
25304 # type: textblock
25305 #. type: textblock
25306 #: ../fish/guestfish-actions.pod:1344
25307 msgid ""
25308 "If L</set-memsize> was not called on this handle, and if "
25309 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
25310 "value for memsize."
25311 msgstr ""
25312
25313 # type: =head2
25314 #. type: =head2
25315 #: ../fish/guestfish-actions.pod:1351
25316 msgid "get-network"
25317 msgstr ""
25318
25319 # type: verbatim
25320 #. type: verbatim
25321 #: ../fish/guestfish-actions.pod:1353
25322 #, no-wrap
25323 msgid ""
25324 " get-network\n"
25325 "\n"
25326 msgstr ""
25327
25328 # type: =head2
25329 #. type: =head2
25330 #: ../fish/guestfish-actions.pod:1357
25331 msgid "get-path"
25332 msgstr ""
25333
25334 # type: verbatim
25335 #. type: verbatim
25336 #: ../fish/guestfish-actions.pod:1359
25337 #, no-wrap
25338 msgid ""
25339 " get-path\n"
25340 "\n"
25341 msgstr ""
25342
25343 # type: =head2
25344 #. type: =head2
25345 #: ../fish/guestfish-actions.pod:1366
25346 msgid "get-pid"
25347 msgstr ""
25348
25349 # type: =head2
25350 #. type: =head2
25351 #: ../fish/guestfish-actions.pod:1368
25352 msgid "pid"
25353 msgstr ""
25354
25355 # type: verbatim
25356 #. type: verbatim
25357 #: ../fish/guestfish-actions.pod:1370
25358 #, no-wrap
25359 msgid ""
25360 " get-pid\n"
25361 "\n"
25362 msgstr ""
25363
25364 # type: =head2
25365 #. type: =head2
25366 #: ../fish/guestfish-actions.pod:1377
25367 msgid "get-qemu"
25368 msgstr ""
25369
25370 # type: verbatim
25371 #. type: verbatim
25372 #: ../fish/guestfish-actions.pod:1379
25373 #, no-wrap
25374 msgid ""
25375 " get-qemu\n"
25376 "\n"
25377 msgstr ""
25378
25379 # type: =head2
25380 #. type: =head2
25381 #: ../fish/guestfish-actions.pod:1386
25382 msgid "get-recovery-proc"
25383 msgstr ""
25384
25385 # type: verbatim
25386 #. type: verbatim
25387 #: ../fish/guestfish-actions.pod:1388
25388 #, no-wrap
25389 msgid ""
25390 " get-recovery-proc\n"
25391 "\n"
25392 msgstr ""
25393
25394 # type: =head2
25395 #. type: =head2
25396 #: ../fish/guestfish-actions.pod:1392
25397 msgid "get-selinux"
25398 msgstr ""
25399
25400 # type: verbatim
25401 #. type: verbatim
25402 #: ../fish/guestfish-actions.pod:1394
25403 #, no-wrap
25404 msgid ""
25405 " get-selinux\n"
25406 "\n"
25407 msgstr ""
25408
25409 # type: textblock
25410 #. type: textblock
25411 #: ../fish/guestfish-actions.pod:1396
25412 msgid ""
25413 "This returns the current setting of the selinux flag which is passed to the "
25414 "appliance at boot time.  See L</set-selinux>."
25415 msgstr ""
25416
25417 # type: =head2
25418 #. type: =head2
25419 #: ../fish/guestfish-actions.pod:1402
25420 msgid "get-state"
25421 msgstr ""
25422
25423 # type: verbatim
25424 #. type: verbatim
25425 #: ../fish/guestfish-actions.pod:1404
25426 #, no-wrap
25427 msgid ""
25428 " get-state\n"
25429 "\n"
25430 msgstr ""
25431
25432 # type: =head2
25433 #. type: =head2
25434 #: ../fish/guestfish-actions.pod:1411
25435 msgid "get-trace"
25436 msgstr ""
25437
25438 # type: verbatim
25439 #. type: verbatim
25440 #: ../fish/guestfish-actions.pod:1413
25441 #, no-wrap
25442 msgid ""
25443 " get-trace\n"
25444 "\n"
25445 msgstr ""
25446
25447 # type: =head2
25448 #. type: =head2
25449 #: ../fish/guestfish-actions.pod:1417
25450 msgid "get-umask"
25451 msgstr ""
25452
25453 # type: verbatim
25454 #. type: verbatim
25455 #: ../fish/guestfish-actions.pod:1419
25456 #, no-wrap
25457 msgid ""
25458 " get-umask\n"
25459 "\n"
25460 msgstr ""
25461
25462 # type: textblock
25463 #. type: textblock
25464 #: ../fish/guestfish-actions.pod:1421
25465 msgid ""
25466 "Return the current umask.  By default the umask is C<022> unless it has been "
25467 "set by calling L</umask>."
25468 msgstr ""
25469
25470 # type: =head2
25471 #. type: =head2
25472 #: ../fish/guestfish-actions.pod:1424
25473 msgid "get-verbose"
25474 msgstr ""
25475
25476 # type: verbatim
25477 #. type: verbatim
25478 #: ../fish/guestfish-actions.pod:1426
25479 #, no-wrap
25480 msgid ""
25481 " get-verbose\n"
25482 "\n"
25483 msgstr ""
25484
25485 # type: =head2
25486 #. type: =head2
25487 #: ../fish/guestfish-actions.pod:1430
25488 msgid "getcon"
25489 msgstr ""
25490
25491 # type: verbatim
25492 #. type: verbatim
25493 #: ../fish/guestfish-actions.pod:1432
25494 #, no-wrap
25495 msgid ""
25496 " getcon\n"
25497 "\n"
25498 msgstr ""
25499
25500 # type: textblock
25501 #. type: textblock
25502 #: ../fish/guestfish-actions.pod:1436
25503 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
25504 msgstr ""
25505
25506 # type: =head2
25507 #. type: =head2
25508 #: ../fish/guestfish-actions.pod:1439
25509 msgid "getxattr"
25510 msgstr ""
25511
25512 # type: verbatim
25513 #. type: verbatim
25514 #: ../fish/guestfish-actions.pod:1441
25515 #, no-wrap
25516 msgid ""
25517 " getxattr path name\n"
25518 "\n"
25519 msgstr ""
25520
25521 # type: textblock
25522 #. type: textblock
25523 #: ../fish/guestfish-actions.pod:1443
25524 msgid ""
25525 "Get a single extended attribute from file C<path> named C<name>.  This call "
25526 "follows symlinks.  If you want to lookup an extended attribute for the "
25527 "symlink itself, use L</lgetxattr>."
25528 msgstr ""
25529
25530 # type: textblock
25531 #. type: textblock
25532 #: ../fish/guestfish-actions.pod:1447 ../fish/guestfish-actions.pod:2353
25533 msgid ""
25534 "Normally it is better to get all extended attributes from a file in one go "
25535 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
25536 "buggy and do not provide a way to list out attributes.  For these "
25537 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
25538 "attributes you want in advance and call this function."
25539 msgstr ""
25540
25541 # type: textblock
25542 #. type: textblock
25543 #: ../fish/guestfish-actions.pod:1457
25544 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
25545 msgstr ""
25546
25547 # type: =head2
25548 #. type: =head2
25549 #: ../fish/guestfish-actions.pod:1459
25550 msgid "getxattrs"
25551 msgstr ""
25552
25553 # type: verbatim
25554 #. type: verbatim
25555 #: ../fish/guestfish-actions.pod:1461
25556 #, no-wrap
25557 msgid ""
25558 " getxattrs path\n"
25559 "\n"
25560 msgstr ""
25561
25562 # type: textblock
25563 #. type: textblock
25564 #: ../fish/guestfish-actions.pod:1469
25565 msgid "See also: L</lgetxattrs>, L<attr(5)>."
25566 msgstr ""
25567
25568 # type: =head2
25569 #. type: =head2
25570 #: ../fish/guestfish-actions.pod:1471
25571 msgid "glob-expand"
25572 msgstr ""
25573
25574 # type: verbatim
25575 #. type: verbatim
25576 #: ../fish/guestfish-actions.pod:1473
25577 #, no-wrap
25578 msgid ""
25579 " glob-expand pattern\n"
25580 "\n"
25581 msgstr ""
25582
25583 # type: =head2
25584 #. type: =head2
25585 #: ../fish/guestfish-actions.pod:1486
25586 msgid "grep"
25587 msgstr ""
25588
25589 # type: verbatim
25590 #. type: verbatim
25591 #: ../fish/guestfish-actions.pod:1488
25592 #, no-wrap
25593 msgid ""
25594 " grep regex path\n"
25595 "\n"
25596 msgstr ""
25597
25598 # type: =head2
25599 #. type: =head2
25600 #: ../fish/guestfish-actions.pod:1496
25601 msgid "grepi"
25602 msgstr ""
25603
25604 # type: verbatim
25605 #. type: verbatim
25606 #: ../fish/guestfish-actions.pod:1498
25607 #, no-wrap
25608 msgid ""
25609 " grepi regex path\n"
25610 "\n"
25611 msgstr ""
25612
25613 # type: =head2
25614 #. type: =head2
25615 #: ../fish/guestfish-actions.pod:1506
25616 msgid "grub-install"
25617 msgstr ""
25618
25619 # type: verbatim
25620 #. type: verbatim
25621 #: ../fish/guestfish-actions.pod:1508
25622 #, no-wrap
25623 msgid ""
25624 " grub-install root device\n"
25625 "\n"
25626 msgstr ""
25627
25628 # type: =head2
25629 #. type: =head2
25630 #: ../fish/guestfish-actions.pod:1524
25631 msgid "head"
25632 msgstr ""
25633
25634 # type: verbatim
25635 #. type: verbatim
25636 #: ../fish/guestfish-actions.pod:1526
25637 #, no-wrap
25638 msgid ""
25639 " head path\n"
25640 "\n"
25641 msgstr ""
25642
25643 # type: =head2
25644 #. type: =head2
25645 #: ../fish/guestfish-actions.pod:1534
25646 msgid "head-n"
25647 msgstr ""
25648
25649 # type: verbatim
25650 #. type: verbatim
25651 #: ../fish/guestfish-actions.pod:1536
25652 #, no-wrap
25653 msgid ""
25654 " head-n nrlines path\n"
25655 "\n"
25656 msgstr ""
25657
25658 # type: =head2
25659 #. type: =head2
25660 #: ../fish/guestfish-actions.pod:1549
25661 msgid "hexdump"
25662 msgstr ""
25663
25664 # type: verbatim
25665 #. type: verbatim
25666 #: ../fish/guestfish-actions.pod:1551
25667 #, no-wrap
25668 msgid ""
25669 " hexdump path\n"
25670 "\n"
25671 msgstr ""
25672
25673 # type: =head2
25674 #. type: =head2
25675 #: ../fish/guestfish-actions.pod:1559
25676 msgid "initrd-cat"
25677 msgstr ""
25678
25679 # type: verbatim
25680 #. type: verbatim
25681 #: ../fish/guestfish-actions.pod:1561
25682 #, no-wrap
25683 msgid ""
25684 " initrd-cat initrdpath filename\n"
25685 "\n"
25686 msgstr ""
25687
25688 # type: textblock
25689 #. type: textblock
25690 #: ../fish/guestfish-actions.pod:1573
25691 msgid "See also L</initrd-list>."
25692 msgstr ""
25693
25694 # type: =head2
25695 #. type: =head2
25696 #: ../fish/guestfish-actions.pod:1578
25697 msgid "initrd-list"
25698 msgstr ""
25699
25700 # type: verbatim
25701 #. type: verbatim
25702 #: ../fish/guestfish-actions.pod:1580
25703 #, no-wrap
25704 msgid ""
25705 " initrd-list path\n"
25706 "\n"
25707 msgstr ""
25708
25709 # type: =head2
25710 #. type: =head2
25711 #: ../fish/guestfish-actions.pod:1592
25712 msgid "inotify-add-watch"
25713 msgstr ""
25714
25715 # type: verbatim
25716 #. type: verbatim
25717 #: ../fish/guestfish-actions.pod:1594
25718 #, no-wrap
25719 msgid ""
25720 " inotify-add-watch path mask\n"
25721 "\n"
25722 msgstr ""
25723
25724 # type: =head2
25725 #. type: =head2
25726 #: ../fish/guestfish-actions.pod:1606
25727 msgid "inotify-close"
25728 msgstr ""
25729
25730 # type: verbatim
25731 #. type: verbatim
25732 #: ../fish/guestfish-actions.pod:1608
25733 #, no-wrap
25734 msgid ""
25735 " inotify-close\n"
25736 "\n"
25737 msgstr ""
25738
25739 # type: =head2
25740 #. type: =head2
25741 #: ../fish/guestfish-actions.pod:1614
25742 msgid "inotify-files"
25743 msgstr ""
25744
25745 # type: verbatim
25746 #. type: verbatim
25747 #: ../fish/guestfish-actions.pod:1616
25748 #, no-wrap
25749 msgid ""
25750 " inotify-files\n"
25751 "\n"
25752 msgstr ""
25753
25754 # type: textblock
25755 #. type: textblock
25756 #: ../fish/guestfish-actions.pod:1618
25757 msgid ""
25758 "This function is a helpful wrapper around L</inotify-read> which just "
25759 "returns a list of pathnames of objects that were touched.  The returned "
25760 "pathnames are sorted and deduplicated."
25761 msgstr ""
25762
25763 # type: =head2
25764 #. type: =head2
25765 #: ../fish/guestfish-actions.pod:1622
25766 msgid "inotify-init"
25767 msgstr ""
25768
25769 # type: verbatim
25770 #. type: verbatim
25771 #: ../fish/guestfish-actions.pod:1624
25772 #, no-wrap
25773 msgid ""
25774 " inotify-init maxevents\n"
25775 "\n"
25776 msgstr ""
25777
25778 # type: textblock
25779 #. type: textblock
25780 #: ../fish/guestfish-actions.pod:1630
25781 msgid ""
25782 "C<maxevents> is the maximum number of events which will be queued up between "
25783 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
25784 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
25785 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
25786 "but records the fact that it threw them away by setting a flag "
25787 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
25788 msgstr ""
25789
25790 # type: textblock
25791 #. type: textblock
25792 #: ../fish/guestfish-actions.pod:1640
25793 msgid ""
25794 "Before any events are generated, you have to add some watches to the "
25795 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
25796 "L</inotify-watch-all>."
25797 msgstr ""
25798
25799 # type: textblock
25800 #. type: textblock
25801 #: ../fish/guestfish-actions.pod:1646
25802 msgid ""
25803 "Queued up events should be read periodically by calling L</inotify-read> (or "
25804 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
25805 "If you don't read the events out often enough then you risk the internal "
25806 "queue overflowing."
25807 msgstr ""
25808
25809 # type: textblock
25810 #. type: textblock
25811 #: ../fish/guestfish-actions.pod:1653
25812 msgid ""
25813 "The handle should be closed after use by calling L</inotify-close>.  This "
25814 "also removes any watches automatically."
25815 msgstr ""
25816
25817 # type: =head2
25818 #. type: =head2
25819 #: ../fish/guestfish-actions.pod:1662
25820 msgid "inotify-read"
25821 msgstr ""
25822
25823 # type: verbatim
25824 #. type: verbatim
25825 #: ../fish/guestfish-actions.pod:1664
25826 #, no-wrap
25827 msgid ""
25828 " inotify-read\n"
25829 "\n"
25830 msgstr ""
25831
25832 # type: =head2
25833 #. type: =head2
25834 #: ../fish/guestfish-actions.pod:1677
25835 msgid "inotify-rm-watch"
25836 msgstr ""
25837
25838 # type: verbatim
25839 #. type: verbatim
25840 #: ../fish/guestfish-actions.pod:1679
25841 #, no-wrap
25842 msgid ""
25843 " inotify-rm-watch wd\n"
25844 "\n"
25845 msgstr ""
25846
25847 # type: textblock
25848 #. type: textblock
25849 #: ../fish/guestfish-actions.pod:1681
25850 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
25851 msgstr ""
25852
25853 # type: =head2
25854 #. type: =head2
25855 #: ../fish/guestfish-actions.pod:1684
25856 msgid "inspect-get-arch"
25857 msgstr ""
25858
25859 # type: verbatim
25860 #. type: verbatim
25861 #: ../fish/guestfish-actions.pod:1686
25862 #, no-wrap
25863 msgid ""
25864 " inspect-get-arch root\n"
25865 "\n"
25866 msgstr ""
25867
25868 # type: textblock
25869 #. type: textblock
25870 #: ../fish/guestfish-actions.pod:1688 ../fish/guestfish-actions.pod:1704
25871 #: ../fish/guestfish-actions.pod:1778 ../fish/guestfish-actions.pod:1796
25872 #: ../fish/guestfish-actions.pod:1830 ../fish/guestfish-actions.pod:1845
25873 #: ../fish/guestfish-actions.pod:1866 ../fish/guestfish-actions.pod:1881
25874 #: ../fish/guestfish-actions.pod:1908 ../fish/guestfish-actions.pod:1930
25875 #: ../fish/guestfish-actions.pod:1954 ../fish/guestfish-actions.pod:1984
25876 #: ../fish/guestfish-actions.pod:2019 ../fish/guestfish-actions.pod:2035
25877 #: ../fish/guestfish-actions.pod:2048 ../fish/guestfish-actions.pod:2061
25878 #: ../fish/guestfish-actions.pod:2076
25879 msgid ""
25880 "This function should only be called with a root device string as returned by "
25881 "L</inspect-os>."
25882 msgstr ""
25883
25884 # type: textblock
25885 #. type: textblock
25886 #: ../fish/guestfish-actions.pod:1691
25887 msgid ""
25888 "This returns the architecture of the inspected operating system.  The "
25889 "possible return values are listed under L</file-architecture>."
25890 msgstr ""
25891
25892 # type: =head2
25893 #. type: =head2
25894 #: ../fish/guestfish-actions.pod:1700
25895 msgid "inspect-get-distro"
25896 msgstr ""
25897
25898 # type: verbatim
25899 #. type: verbatim
25900 #: ../fish/guestfish-actions.pod:1702
25901 #, no-wrap
25902 msgid ""
25903 " inspect-get-distro root\n"
25904 "\n"
25905 msgstr ""
25906
25907 # type: =head2
25908 #. type: =head2
25909 #: ../fish/guestfish-actions.pod:1774
25910 msgid "inspect-get-filesystems"
25911 msgstr ""
25912
25913 # type: verbatim
25914 #. type: verbatim
25915 #: ../fish/guestfish-actions.pod:1776
25916 #, no-wrap
25917 msgid ""
25918 " inspect-get-filesystems root\n"
25919 "\n"
25920 msgstr ""
25921
25922 # type: textblock
25923 #. type: textblock
25924 #: ../fish/guestfish-actions.pod:1789
25925 msgid ""
25926 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25927 "get-mountpoints>."
25928 msgstr ""
25929
25930 #. type: =head2
25931 #: ../fish/guestfish-actions.pod:1792
25932 msgid "inspect-get-format"
25933 msgstr ""
25934
25935 #. type: verbatim
25936 #: ../fish/guestfish-actions.pod:1794
25937 #, no-wrap
25938 msgid ""
25939 " inspect-get-format root\n"
25940 "\n"
25941 msgstr ""
25942
25943 # type: =head2
25944 #. type: =head2
25945 #: ../fish/guestfish-actions.pod:1826
25946 msgid "inspect-get-hostname"
25947 msgstr ""
25948
25949 # type: verbatim
25950 #. type: verbatim
25951 #: ../fish/guestfish-actions.pod:1828
25952 #, no-wrap
25953 msgid ""
25954 " inspect-get-hostname root\n"
25955 "\n"
25956 msgstr ""
25957
25958 # type: =head2
25959 #. type: =head2
25960 #: ../fish/guestfish-actions.pod:1841
25961 msgid "inspect-get-major-version"
25962 msgstr ""
25963
25964 # type: verbatim
25965 #. type: verbatim
25966 #: ../fish/guestfish-actions.pod:1843
25967 #, no-wrap
25968 msgid ""
25969 " inspect-get-major-version root\n"
25970 "\n"
25971 msgstr ""
25972
25973 # type: =head2
25974 #. type: =head2
25975 #: ../fish/guestfish-actions.pod:1862
25976 msgid "inspect-get-minor-version"
25977 msgstr ""
25978
25979 # type: verbatim
25980 #. type: verbatim
25981 #: ../fish/guestfish-actions.pod:1864
25982 #, no-wrap
25983 msgid ""
25984 " inspect-get-minor-version root\n"
25985 "\n"
25986 msgstr ""
25987
25988 # type: textblock
25989 #. type: textblock
25990 #: ../fish/guestfish-actions.pod:1874
25991 msgid ""
25992 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25993 "get-major-version>."
25994 msgstr ""
25995
25996 # type: =head2
25997 #. type: =head2
25998 #: ../fish/guestfish-actions.pod:1877
25999 msgid "inspect-get-mountpoints"
26000 msgstr ""
26001
26002 # type: verbatim
26003 #. type: verbatim
26004 #: ../fish/guestfish-actions.pod:1879
26005 #, no-wrap
26006 msgid ""
26007 " inspect-get-mountpoints root\n"
26008 "\n"
26009 msgstr ""
26010
26011 # type: textblock
26012 #. type: textblock
26013 #: ../fish/guestfish-actions.pod:1901
26014 msgid ""
26015 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26016 "get-filesystems>."
26017 msgstr ""
26018
26019 # type: =head2
26020 #. type: =head2
26021 #: ../fish/guestfish-actions.pod:1904
26022 msgid "inspect-get-package-format"
26023 msgstr ""
26024
26025 # type: verbatim
26026 #. type: verbatim
26027 #: ../fish/guestfish-actions.pod:1906
26028 #, no-wrap
26029 msgid ""
26030 " inspect-get-package-format root\n"
26031 "\n"
26032 msgstr ""
26033
26034 # type: textblock
26035 #. type: textblock
26036 #: ../fish/guestfish-actions.pod:1911
26037 msgid ""
26038 "This function and L</inspect-get-package-management> return the package "
26039 "format and package management tool used by the inspected operating system.  "
26040 "For example for Fedora these functions would return C<rpm> (package format) "
26041 "and C<yum> (package management)."
26042 msgstr ""
26043
26044 # type: =head2
26045 #. type: =head2
26046 #: ../fish/guestfish-actions.pod:1926
26047 msgid "inspect-get-package-management"
26048 msgstr ""
26049
26050 # type: verbatim
26051 #. type: verbatim
26052 #: ../fish/guestfish-actions.pod:1928
26053 #, no-wrap
26054 msgid ""
26055 " inspect-get-package-management root\n"
26056 "\n"
26057 msgstr ""
26058
26059 # type: textblock
26060 #. type: textblock
26061 #: ../fish/guestfish-actions.pod:1933
26062 msgid ""
26063 "L</inspect-get-package-format> and this function return the package format "
26064 "and package management tool used by the inspected operating system.  For "
26065 "example for Fedora these functions would return C<rpm> (package format) and "
26066 "C<yum> (package management)."
26067 msgstr ""
26068
26069 # type: =head2
26070 #. type: =head2
26071 #: ../fish/guestfish-actions.pod:1950
26072 msgid "inspect-get-product-name"
26073 msgstr ""
26074
26075 # type: verbatim
26076 #. type: verbatim
26077 #: ../fish/guestfish-actions.pod:1952
26078 #, no-wrap
26079 msgid ""
26080 " inspect-get-product-name root\n"
26081 "\n"
26082 msgstr ""
26083
26084 # type: =head2
26085 #. type: =head2
26086 #: ../fish/guestfish-actions.pod:1967
26087 msgid "inspect-get-roots"
26088 msgstr ""
26089
26090 # type: verbatim
26091 #. type: verbatim
26092 #: ../fish/guestfish-actions.pod:1969
26093 #, no-wrap
26094 msgid ""
26095 " inspect-get-roots\n"
26096 "\n"
26097 msgstr ""
26098
26099 # type: textblock
26100 #. type: textblock
26101 #: ../fish/guestfish-actions.pod:1971
26102 msgid ""
26103 "This function is a convenient way to get the list of root devices, as "
26104 "returned from a previous call to L</inspect-os>, but without redoing the "
26105 "whole inspection process."
26106 msgstr ""
26107
26108 # type: textblock
26109 #. type: textblock
26110 #: ../fish/guestfish-actions.pod:1975
26111 msgid ""
26112 "This returns an empty list if either no root devices were found or the "
26113 "caller has not called L</inspect-os>."
26114 msgstr ""
26115
26116 # type: =head2
26117 #. type: =head2
26118 #: ../fish/guestfish-actions.pod:1980
26119 msgid "inspect-get-type"
26120 msgstr ""
26121
26122 # type: verbatim
26123 #. type: verbatim
26124 #: ../fish/guestfish-actions.pod:1982
26125 #, no-wrap
26126 msgid ""
26127 " inspect-get-type root\n"
26128 "\n"
26129 msgstr ""
26130
26131 # type: =head2
26132 #. type: =head2
26133 #: ../fish/guestfish-actions.pod:2015
26134 msgid "inspect-get-windows-systemroot"
26135 msgstr ""
26136
26137 # type: verbatim
26138 #. type: verbatim
26139 #: ../fish/guestfish-actions.pod:2017
26140 #, no-wrap
26141 msgid ""
26142 " inspect-get-windows-systemroot root\n"
26143 "\n"
26144 msgstr ""
26145
26146 #. type: =head2
26147 #: ../fish/guestfish-actions.pod:2031
26148 msgid "inspect-is-live"
26149 msgstr ""
26150
26151 #. type: verbatim
26152 #: ../fish/guestfish-actions.pod:2033
26153 #, no-wrap
26154 msgid ""
26155 " inspect-is-live root\n"
26156 "\n"
26157 msgstr ""
26158
26159 #. type: textblock
26160 #: ../fish/guestfish-actions.pod:2038
26161 msgid ""
26162 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26163 "then this returns true if a live image was detected on the disk."
26164 msgstr ""
26165
26166 #. type: =head2
26167 #: ../fish/guestfish-actions.pod:2044
26168 msgid "inspect-is-multipart"
26169 msgstr ""
26170
26171 #. type: verbatim
26172 #: ../fish/guestfish-actions.pod:2046
26173 #, no-wrap
26174 msgid ""
26175 " inspect-is-multipart root\n"
26176 "\n"
26177 msgstr ""
26178
26179 #. type: textblock
26180 #: ../fish/guestfish-actions.pod:2051
26181 msgid ""
26182 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26183 "then this returns true if the disk is part of a set."
26184 msgstr ""
26185
26186 #. type: =head2
26187 #: ../fish/guestfish-actions.pod:2057
26188 msgid "inspect-is-netinst"
26189 msgstr ""
26190
26191 #. type: verbatim
26192 #: ../fish/guestfish-actions.pod:2059
26193 #, no-wrap
26194 msgid ""
26195 " inspect-is-netinst root\n"
26196 "\n"
26197 msgstr ""
26198
26199 #. type: textblock
26200 #: ../fish/guestfish-actions.pod:2064
26201 msgid ""
26202 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26203 "then this returns true if the disk is a network installer, ie. not a self-"
26204 "contained install CD but one which is likely to require network access to "
26205 "complete the install."
26206 msgstr ""
26207
26208 # type: =head2
26209 #. type: =head2
26210 #: ../fish/guestfish-actions.pod:2072
26211 msgid "inspect-list-applications"
26212 msgstr ""
26213
26214 # type: verbatim
26215 #. type: verbatim
26216 #: ../fish/guestfish-actions.pod:2074
26217 #, no-wrap
26218 msgid ""
26219 " inspect-list-applications root\n"
26220 "\n"
26221 msgstr ""
26222
26223 # type: textblock
26224 #. type: textblock
26225 #: ../fish/guestfish-actions.pod:2081
26226 msgid ""
26227 "I<Note:> This call works differently from other parts of the inspection "
26228 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
26229 "then mount up the disks, before calling this.  Listing applications is a "
26230 "significantly more difficult operation which requires access to the full "
26231 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
26232 "are just returning data cached in the libguestfs handle, this call actually "
26233 "reads parts of the mounted filesystems during the call."
26234 msgstr ""
26235
26236 # type: =head2
26237 #. type: =head2
26238 #: ../fish/guestfish-actions.pod:2171
26239 msgid "inspect-os"
26240 msgstr ""
26241
26242 # type: verbatim
26243 #. type: verbatim
26244 #: ../fish/guestfish-actions.pod:2173
26245 #, no-wrap
26246 msgid ""
26247 " inspect-os\n"
26248 "\n"
26249 msgstr ""
26250
26251 # type: textblock
26252 #. type: textblock
26253 #: ../fish/guestfish-actions.pod:2188
26254 msgid ""
26255 "You can pass the root string(s) returned to other L</inspect-get-*> "
26256 "functions in order to query further information about each operating system, "
26257 "such as the name and version."
26258 msgstr ""
26259
26260 # type: textblock
26261 #. type: textblock
26262 #: ../fish/guestfish-actions.pod:2193
26263 msgid ""
26264 "This function uses other libguestfs features such as L</mount-ro> and L</"
26265 "umount-all> in order to mount and unmount filesystems and look at the "
26266 "contents.  This should be called with no disks currently mounted.  The "
26267 "function may also use Augeas, so any existing Augeas handle will be closed."
26268 msgstr ""
26269
26270 # type: textblock
26271 #. type: textblock
26272 #: ../fish/guestfish-actions.pod:2205 ../fish/guestfish-actions.pod:2381
26273 #: ../fish/guestfish-actions.pod:2427
26274 msgid "See also L</list-filesystems>."
26275 msgstr ""
26276
26277 # type: =head2
26278 #. type: =head2
26279 #: ../fish/guestfish-actions.pod:2207
26280 msgid "is-blockdev"
26281 msgstr ""
26282
26283 # type: verbatim
26284 #. type: verbatim
26285 #: ../fish/guestfish-actions.pod:2209
26286 #, no-wrap
26287 msgid ""
26288 " is-blockdev path\n"
26289 "\n"
26290 msgstr ""
26291
26292 # type: textblock
26293 #. type: textblock
26294 #: ../fish/guestfish-actions.pod:2214 ../fish/guestfish-actions.pod:2232
26295 #: ../fish/guestfish-actions.pod:2251 ../fish/guestfish-actions.pod:2260
26296 #: ../fish/guestfish-actions.pod:2270 ../fish/guestfish-actions.pod:2304
26297 #: ../fish/guestfish-actions.pod:2313
26298 msgid "See also L</stat>."
26299 msgstr ""
26300
26301 # type: =head2
26302 #. type: =head2
26303 #: ../fish/guestfish-actions.pod:2216
26304 msgid "is-busy"
26305 msgstr ""
26306
26307 # type: verbatim
26308 #. type: verbatim
26309 #: ../fish/guestfish-actions.pod:2218
26310 #, no-wrap
26311 msgid ""
26312 " is-busy\n"
26313 "\n"
26314 msgstr ""
26315
26316 # type: =head2
26317 #. type: =head2
26318 #: ../fish/guestfish-actions.pod:2225
26319 msgid "is-chardev"
26320 msgstr ""
26321
26322 # type: verbatim
26323 #. type: verbatim
26324 #: ../fish/guestfish-actions.pod:2227
26325 #, no-wrap
26326 msgid ""
26327 " is-chardev path\n"
26328 "\n"
26329 msgstr ""
26330
26331 # type: =head2
26332 #. type: =head2
26333 #: ../fish/guestfish-actions.pod:2234
26334 msgid "is-config"
26335 msgstr ""
26336
26337 # type: verbatim
26338 #. type: verbatim
26339 #: ../fish/guestfish-actions.pod:2236
26340 #, no-wrap
26341 msgid ""
26342 " is-config\n"
26343 "\n"
26344 msgstr ""
26345
26346 # type: =head2
26347 #. type: =head2
26348 #: ../fish/guestfish-actions.pod:2243
26349 msgid "is-dir"
26350 msgstr ""
26351
26352 # type: verbatim
26353 #. type: verbatim
26354 #: ../fish/guestfish-actions.pod:2245
26355 #, no-wrap
26356 msgid ""
26357 " is-dir path\n"
26358 "\n"
26359 msgstr ""
26360
26361 # type: =head2
26362 #. type: =head2
26363 #: ../fish/guestfish-actions.pod:2253
26364 msgid "is-fifo"
26365 msgstr ""
26366
26367 # type: verbatim
26368 #. type: verbatim
26369 #: ../fish/guestfish-actions.pod:2255
26370 #, no-wrap
26371 msgid ""
26372 " is-fifo path\n"
26373 "\n"
26374 msgstr ""
26375
26376 # type: =head2
26377 #. type: =head2
26378 #: ../fish/guestfish-actions.pod:2262
26379 msgid "is-file"
26380 msgstr ""
26381
26382 # type: verbatim
26383 #. type: verbatim
26384 #: ../fish/guestfish-actions.pod:2264
26385 #, no-wrap
26386 msgid ""
26387 " is-file path\n"
26388 "\n"
26389 msgstr ""
26390
26391 # type: =head2
26392 #. type: =head2
26393 #: ../fish/guestfish-actions.pod:2272
26394 msgid "is-launching"
26395 msgstr ""
26396
26397 # type: verbatim
26398 #. type: verbatim
26399 #: ../fish/guestfish-actions.pod:2274
26400 #, no-wrap
26401 msgid ""
26402 " is-launching\n"
26403 "\n"
26404 msgstr ""
26405
26406 # type: =head2
26407 #. type: =head2
26408 #: ../fish/guestfish-actions.pod:2281
26409 msgid "is-lv"
26410 msgstr ""
26411
26412 # type: verbatim
26413 #. type: verbatim
26414 #: ../fish/guestfish-actions.pod:2283
26415 #, no-wrap
26416 msgid ""
26417 " is-lv device\n"
26418 "\n"
26419 msgstr ""
26420
26421 # type: =head2
26422 #. type: =head2
26423 #: ../fish/guestfish-actions.pod:2288
26424 msgid "is-ready"
26425 msgstr ""
26426
26427 # type: verbatim
26428 #. type: verbatim
26429 #: ../fish/guestfish-actions.pod:2290
26430 #, no-wrap
26431 msgid ""
26432 " is-ready\n"
26433 "\n"
26434 msgstr ""
26435
26436 # type: =head2
26437 #. type: =head2
26438 #: ../fish/guestfish-actions.pod:2297
26439 msgid "is-socket"
26440 msgstr ""
26441
26442 # type: verbatim
26443 #. type: verbatim
26444 #: ../fish/guestfish-actions.pod:2299
26445 #, no-wrap
26446 msgid ""
26447 " is-socket path\n"
26448 "\n"
26449 msgstr ""
26450
26451 # type: =head2
26452 #. type: =head2
26453 #: ../fish/guestfish-actions.pod:2306
26454 msgid "is-symlink"
26455 msgstr ""
26456
26457 # type: verbatim
26458 #. type: verbatim
26459 #: ../fish/guestfish-actions.pod:2308
26460 #, no-wrap
26461 msgid ""
26462 " is-symlink path\n"
26463 "\n"
26464 msgstr ""
26465
26466 # type: =head2
26467 #. type: =head2
26468 #: ../fish/guestfish-actions.pod:2315
26469 msgid "kill-subprocess"
26470 msgstr ""
26471
26472 # type: verbatim
26473 #. type: verbatim
26474 #: ../fish/guestfish-actions.pod:2317
26475 #, no-wrap
26476 msgid ""
26477 " kill-subprocess\n"
26478 "\n"
26479 msgstr ""
26480
26481 # type: =head2
26482 #. type: =head2
26483 #: ../fish/guestfish-actions.pod:2321
26484 msgid "launch"
26485 msgstr ""
26486
26487 # type: =head2
26488 #. type: =head2
26489 #: ../fish/guestfish-actions.pod:2323
26490 msgid "run"
26491 msgstr ""
26492
26493 # type: verbatim
26494 #. type: verbatim
26495 #: ../fish/guestfish-actions.pod:2325
26496 #, no-wrap
26497 msgid ""
26498 " launch\n"
26499 "\n"
26500 msgstr ""
26501
26502 # type: =head2
26503 #. type: =head2
26504 #: ../fish/guestfish-actions.pod:2333
26505 msgid "lchown"
26506 msgstr ""
26507
26508 # type: verbatim
26509 #. type: verbatim
26510 #: ../fish/guestfish-actions.pod:2335
26511 #, no-wrap
26512 msgid ""
26513 " lchown owner group path\n"
26514 "\n"
26515 msgstr ""
26516
26517 # type: textblock
26518 #. type: textblock
26519 #: ../fish/guestfish-actions.pod:2337
26520 msgid ""
26521 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
26522 "chown> but if C<path> is a symlink then the link itself is changed, not the "
26523 "target."
26524 msgstr ""
26525
26526 # type: =head2
26527 #. type: =head2
26528 #: ../fish/guestfish-actions.pod:2345
26529 msgid "lgetxattr"
26530 msgstr ""
26531
26532 # type: verbatim
26533 #. type: verbatim
26534 #: ../fish/guestfish-actions.pod:2347
26535 #, no-wrap
26536 msgid ""
26537 " lgetxattr path name\n"
26538 "\n"
26539 msgstr ""
26540
26541 # type: textblock
26542 #. type: textblock
26543 #: ../fish/guestfish-actions.pod:2363
26544 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
26545 msgstr ""
26546
26547 # type: =head2
26548 #. type: =head2
26549 #: ../fish/guestfish-actions.pod:2365
26550 msgid "lgetxattrs"
26551 msgstr ""
26552
26553 # type: verbatim
26554 #. type: verbatim
26555 #: ../fish/guestfish-actions.pod:2367
26556 #, no-wrap
26557 msgid ""
26558 " lgetxattrs path\n"
26559 "\n"
26560 msgstr ""
26561
26562 # type: textblock
26563 #. type: textblock
26564 #: ../fish/guestfish-actions.pod:2369
26565 msgid ""
26566 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
26567 "it returns the extended attributes of the link itself."
26568 msgstr ""
26569
26570 # type: =head2
26571 #. type: =head2
26572 #: ../fish/guestfish-actions.pod:2373
26573 msgid "list-devices"
26574 msgstr ""
26575
26576 # type: verbatim
26577 #. type: verbatim
26578 #: ../fish/guestfish-actions.pod:2375
26579 #, no-wrap
26580 msgid ""
26581 " list-devices\n"
26582 "\n"
26583 msgstr ""
26584
26585 # type: =head2
26586 #. type: =head2
26587 #: ../fish/guestfish-actions.pod:2383
26588 msgid "list-filesystems"
26589 msgstr ""
26590
26591 # type: verbatim
26592 #. type: verbatim
26593 #: ../fish/guestfish-actions.pod:2385
26594 #, no-wrap
26595 msgid ""
26596 " list-filesystems\n"
26597 "\n"
26598 msgstr ""
26599
26600 # type: textblock
26601 #. type: textblock
26602 #: ../fish/guestfish-actions.pod:2404
26603 msgid ""
26604 "This command runs other libguestfs commands, which might include L</mount> "
26605 "and L</umount>, and therefore you should use this soon after launch and only "
26606 "when nothing is mounted."
26607 msgstr ""
26608
26609 # type: textblock
26610 #. type: textblock
26611 #: ../fish/guestfish-actions.pod:2408
26612 msgid ""
26613 "Not all of the filesystems returned will be mountable.  In particular, swap "
26614 "partitions are returned in the list.  Also this command does not check that "
26615 "each filesystem found is valid and mountable, and some filesystems might be "
26616 "mountable but require special options.  Filesystems may not all belong to a "
26617 "single logical operating system (use L</inspect-os> to look for OSes)."
26618 msgstr ""
26619
26620 # type: =head2
26621 #. type: =head2
26622 #: ../fish/guestfish-actions.pod:2416
26623 msgid "list-partitions"
26624 msgstr ""
26625
26626 # type: verbatim
26627 #. type: verbatim
26628 #: ../fish/guestfish-actions.pod:2418
26629 #, no-wrap
26630 msgid ""
26631 " list-partitions\n"
26632 "\n"
26633 msgstr ""
26634
26635 # type: textblock
26636 #. type: textblock
26637 #: ../fish/guestfish-actions.pod:2424
26638 msgid ""
26639 "This does not return logical volumes.  For that you will need to call L</"
26640 "lvs>."
26641 msgstr ""
26642
26643 # type: =head2
26644 #. type: =head2
26645 #: ../fish/guestfish-actions.pod:2429
26646 msgid "ll"
26647 msgstr ""
26648
26649 # type: verbatim
26650 #. type: verbatim
26651 #: ../fish/guestfish-actions.pod:2431
26652 #, no-wrap
26653 msgid ""
26654 " ll directory\n"
26655 "\n"
26656 msgstr ""
26657
26658 # type: =head2
26659 #. type: =head2
26660 #: ../fish/guestfish-actions.pod:2439
26661 msgid "ln"
26662 msgstr ""
26663
26664 # type: verbatim
26665 #. type: verbatim
26666 #: ../fish/guestfish-actions.pod:2441
26667 #, no-wrap
26668 msgid ""
26669 " ln target linkname\n"
26670 "\n"
26671 msgstr ""
26672
26673 # type: =head2
26674 #. type: =head2
26675 #: ../fish/guestfish-actions.pod:2445
26676 msgid "ln-f"
26677 msgstr ""
26678
26679 # type: verbatim
26680 #. type: verbatim
26681 #: ../fish/guestfish-actions.pod:2447
26682 #, no-wrap
26683 msgid ""
26684 " ln-f target linkname\n"
26685 "\n"
26686 msgstr ""
26687
26688 # type: =head2
26689 #. type: =head2
26690 #: ../fish/guestfish-actions.pod:2452
26691 msgid "ln-s"
26692 msgstr ""
26693
26694 # type: verbatim
26695 #. type: verbatim
26696 #: ../fish/guestfish-actions.pod:2454
26697 #, no-wrap
26698 msgid ""
26699 " ln-s target linkname\n"
26700 "\n"
26701 msgstr ""
26702
26703 # type: =head2
26704 #. type: =head2
26705 #: ../fish/guestfish-actions.pod:2458
26706 msgid "ln-sf"
26707 msgstr ""
26708
26709 # type: verbatim
26710 #. type: verbatim
26711 #: ../fish/guestfish-actions.pod:2460
26712 #, no-wrap
26713 msgid ""
26714 " ln-sf target linkname\n"
26715 "\n"
26716 msgstr ""
26717
26718 # type: =head2
26719 #. type: =head2
26720 #: ../fish/guestfish-actions.pod:2465
26721 msgid "lremovexattr"
26722 msgstr ""
26723
26724 # type: verbatim
26725 #. type: verbatim
26726 #: ../fish/guestfish-actions.pod:2467
26727 #, no-wrap
26728 msgid ""
26729 " lremovexattr xattr path\n"
26730 "\n"
26731 msgstr ""
26732
26733 # type: textblock
26734 #. type: textblock
26735 #: ../fish/guestfish-actions.pod:2469
26736 msgid ""
26737 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
26738 "it removes an extended attribute of the link itself."
26739 msgstr ""
26740
26741 # type: =head2
26742 #. type: =head2
26743 #: ../fish/guestfish-actions.pod:2473
26744 msgid "ls"
26745 msgstr ""
26746
26747 # type: verbatim
26748 #. type: verbatim
26749 #: ../fish/guestfish-actions.pod:2475
26750 #, no-wrap
26751 msgid ""
26752 " ls directory\n"
26753 "\n"
26754 msgstr ""
26755
26756 # type: textblock
26757 #. type: textblock
26758 #: ../fish/guestfish-actions.pod:2481
26759 msgid ""
26760 "This command is mostly useful for interactive sessions.  Programs should "
26761 "probably use L</readdir> instead."
26762 msgstr ""
26763
26764 # type: =head2
26765 #. type: =head2
26766 #: ../fish/guestfish-actions.pod:2484
26767 msgid "lsetxattr"
26768 msgstr ""
26769
26770 # type: verbatim
26771 #. type: verbatim
26772 #: ../fish/guestfish-actions.pod:2486
26773 #, no-wrap
26774 msgid ""
26775 " lsetxattr xattr val vallen path\n"
26776 "\n"
26777 msgstr ""
26778
26779 # type: textblock
26780 #. type: textblock
26781 #: ../fish/guestfish-actions.pod:2488
26782 msgid ""
26783 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
26784 "sets an extended attribute of the link itself."
26785 msgstr ""
26786
26787 # type: =head2
26788 #. type: =head2
26789 #: ../fish/guestfish-actions.pod:2492
26790 msgid "lstat"
26791 msgstr ""
26792
26793 # type: verbatim
26794 #. type: verbatim
26795 #: ../fish/guestfish-actions.pod:2494
26796 #, no-wrap
26797 msgid ""
26798 " lstat path\n"
26799 "\n"
26800 msgstr ""
26801
26802 # type: textblock
26803 #. type: textblock
26804 #: ../fish/guestfish-actions.pod:2498
26805 msgid ""
26806 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
26807 "the link is stat-ed, not the file it refers to."
26808 msgstr ""
26809
26810 # type: =head2
26811 #. type: =head2
26812 #: ../fish/guestfish-actions.pod:2504
26813 msgid "lstatlist"
26814 msgstr ""
26815
26816 # type: verbatim
26817 #. type: verbatim
26818 #: ../fish/guestfish-actions.pod:2506
26819 #, no-wrap
26820 msgid ""
26821 " lstatlist path 'names ...'\n"
26822 "\n"
26823 msgstr ""
26824
26825 # type: textblock
26826 #. type: textblock
26827 #: ../fish/guestfish-actions.pod:2508
26828 msgid ""
26829 "This call allows you to perform the L</lstat> operation on multiple files, "
26830 "where all files are in the directory C<path>.  C<names> is the list of files "
26831 "from this directory."
26832 msgstr ""
26833
26834 # type: textblock
26835 #. type: textblock
26836 #: ../fish/guestfish-actions.pod:2517
26837 msgid ""
26838 "This call is intended for programs that want to efficiently list a directory "
26839 "contents without making many round-trips.  See also L</lxattrlist> for a "
26840 "similarly efficient call for getting extended attributes.  Very long "
26841 "directory listings might cause the protocol message size to be exceeded, "
26842 "causing this call to fail.  The caller must split up such requests into "
26843 "smaller groups of names."
26844 msgstr ""
26845
26846 # type: =head2
26847 #. type: =head2
26848 #: ../fish/guestfish-actions.pod:2525
26849 msgid "luks-add-key"
26850 msgstr ""
26851
26852 # type: verbatim
26853 #. type: verbatim
26854 #: ../fish/guestfish-actions.pod:2527
26855 #, no-wrap
26856 msgid ""
26857 " luks-add-key device keyslot\n"
26858 "\n"
26859 msgstr ""
26860
26861 # type: textblock
26862 #. type: textblock
26863 #: ../fish/guestfish-actions.pod:2534
26864 msgid ""
26865 "Note that if C<keyslot> already contains a key, then this command will "
26866 "fail.  You have to use L</luks-kill-slot> first to remove that key."
26867 msgstr ""
26868
26869 # type: textblock
26870 #. type: textblock
26871 #: ../fish/guestfish-actions.pod:2538 ../fish/guestfish-actions.pod:2560
26872 #: ../fish/guestfish-actions.pod:2573 ../fish/guestfish-actions.pod:2587
26873 #: ../fish/guestfish-actions.pod:2610 ../fish/guestfish-actions.pod:2620
26874 msgid ""
26875 "This command has one or more key or passphrase parameters.  Guestfish will "
26876 "prompt for these separately."
26877 msgstr ""
26878
26879 # type: =head2
26880 #. type: =head2
26881 #: ../fish/guestfish-actions.pod:2541
26882 msgid "luks-close"
26883 msgstr ""
26884
26885 # type: verbatim
26886 #. type: verbatim
26887 #: ../fish/guestfish-actions.pod:2543
26888 #, no-wrap
26889 msgid ""
26890 " luks-close device\n"
26891 "\n"
26892 msgstr ""
26893
26894 # type: textblock
26895 #. type: textblock
26896 #: ../fish/guestfish-actions.pod:2545
26897 msgid ""
26898 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
26899 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
26900 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
26901 "block device."
26902 msgstr ""
26903
26904 # type: =head2
26905 #. type: =head2
26906 #: ../fish/guestfish-actions.pod:2551
26907 msgid "luks-format"
26908 msgstr ""
26909
26910 # type: verbatim
26911 #. type: verbatim
26912 #: ../fish/guestfish-actions.pod:2553
26913 #, no-wrap
26914 msgid ""
26915 " luks-format device keyslot\n"
26916 "\n"
26917 msgstr ""
26918
26919 # type: =head2
26920 #. type: =head2
26921 #: ../fish/guestfish-actions.pod:2566
26922 msgid "luks-format-cipher"
26923 msgstr ""
26924
26925 # type: verbatim
26926 #. type: verbatim
26927 #: ../fish/guestfish-actions.pod:2568
26928 #, no-wrap
26929 msgid ""
26930 " luks-format-cipher device keyslot cipher\n"
26931 "\n"
26932 msgstr ""
26933
26934 # type: textblock
26935 #. type: textblock
26936 #: ../fish/guestfish-actions.pod:2570
26937 msgid ""
26938 "This command is the same as L</luks-format> but it also allows you to set "
26939 "the C<cipher> used."
26940 msgstr ""
26941
26942 # type: =head2
26943 #. type: =head2
26944 #: ../fish/guestfish-actions.pod:2579
26945 msgid "luks-kill-slot"
26946 msgstr ""
26947
26948 # type: verbatim
26949 #. type: verbatim
26950 #: ../fish/guestfish-actions.pod:2581
26951 #, no-wrap
26952 msgid ""
26953 " luks-kill-slot device keyslot\n"
26954 "\n"
26955 msgstr ""
26956
26957 # type: =head2
26958 #. type: =head2
26959 #: ../fish/guestfish-actions.pod:2590
26960 msgid "luks-open"
26961 msgstr ""
26962
26963 # type: verbatim
26964 #. type: verbatim
26965 #: ../fish/guestfish-actions.pod:2592
26966 #, no-wrap
26967 msgid ""
26968 " luks-open device mapname\n"
26969 "\n"
26970 msgstr ""
26971
26972 # type: textblock
26973 #. type: textblock
26974 #: ../fish/guestfish-actions.pod:2606
26975 msgid ""
26976 "If this block device contains LVM volume groups, then calling L</vgscan> "
26977 "followed by L</vg-activate-all> will make them visible."
26978 msgstr ""
26979
26980 # type: =head2
26981 #. type: =head2
26982 #: ../fish/guestfish-actions.pod:2613
26983 msgid "luks-open-ro"
26984 msgstr ""
26985
26986 # type: verbatim
26987 #. type: verbatim
26988 #: ../fish/guestfish-actions.pod:2615
26989 #, no-wrap
26990 msgid ""
26991 " luks-open-ro device mapname\n"
26992 "\n"
26993 msgstr ""
26994
26995 # type: textblock
26996 #. type: textblock
26997 #: ../fish/guestfish-actions.pod:2617
26998 msgid ""
26999 "This is the same as L</luks-open> except that a read-only mapping is created."
27000 msgstr ""
27001
27002 # type: =head2
27003 #. type: =head2
27004 #: ../fish/guestfish-actions.pod:2623
27005 msgid "lvcreate"
27006 msgstr ""
27007
27008 # type: verbatim
27009 #. type: verbatim
27010 #: ../fish/guestfish-actions.pod:2625
27011 #, no-wrap
27012 msgid ""
27013 " lvcreate logvol volgroup mbytes\n"
27014 "\n"
27015 msgstr ""
27016
27017 # type: =head2
27018 #. type: =head2
27019 #: ../fish/guestfish-actions.pod:2630
27020 msgid "lvm-canonical-lv-name"
27021 msgstr ""
27022
27023 # type: verbatim
27024 #. type: verbatim
27025 #: ../fish/guestfish-actions.pod:2632
27026 #, no-wrap
27027 msgid ""
27028 " lvm-canonical-lv-name lvname\n"
27029 "\n"
27030 msgstr ""
27031
27032 # type: textblock
27033 #. type: textblock
27034 #: ../fish/guestfish-actions.pod:2641
27035 msgid "See also L</is-lv>."
27036 msgstr ""
27037
27038 # type: =head2
27039 #. type: =head2
27040 #: ../fish/guestfish-actions.pod:2643
27041 msgid "lvm-clear-filter"
27042 msgstr ""
27043
27044 # type: verbatim
27045 #. type: verbatim
27046 #: ../fish/guestfish-actions.pod:2645
27047 #, no-wrap
27048 msgid ""
27049 " lvm-clear-filter\n"
27050 "\n"
27051 msgstr ""
27052
27053 # type: textblock
27054 #. type: textblock
27055 #: ../fish/guestfish-actions.pod:2647
27056 msgid ""
27057 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
27058 "block device."
27059 msgstr ""
27060
27061 # type: =head2
27062 #. type: =head2
27063 #: ../fish/guestfish-actions.pod:2653
27064 msgid "lvm-remove-all"
27065 msgstr ""
27066
27067 # type: verbatim
27068 #. type: verbatim
27069 #: ../fish/guestfish-actions.pod:2655
27070 #, no-wrap
27071 msgid ""
27072 " lvm-remove-all\n"
27073 "\n"
27074 msgstr ""
27075
27076 # type: =head2
27077 #. type: =head2
27078 #: ../fish/guestfish-actions.pod:2663
27079 msgid "lvm-set-filter"
27080 msgstr ""
27081
27082 # type: verbatim
27083 #. type: verbatim
27084 #: ../fish/guestfish-actions.pod:2665
27085 #, no-wrap
27086 msgid ""
27087 " lvm-set-filter 'devices ...'\n"
27088 "\n"
27089 msgstr ""
27090
27091 # type: =head2
27092 #. type: =head2
27093 #: ../fish/guestfish-actions.pod:2690
27094 msgid "lvremove"
27095 msgstr ""
27096
27097 # type: verbatim
27098 #. type: verbatim
27099 #: ../fish/guestfish-actions.pod:2692
27100 #, no-wrap
27101 msgid ""
27102 " lvremove device\n"
27103 "\n"
27104 msgstr ""
27105
27106 # type: =head2
27107 #. type: =head2
27108 #: ../fish/guestfish-actions.pod:2700
27109 msgid "lvrename"
27110 msgstr ""
27111
27112 # type: verbatim
27113 #. type: verbatim
27114 #: ../fish/guestfish-actions.pod:2702
27115 #, no-wrap
27116 msgid ""
27117 " lvrename logvol newlogvol\n"
27118 "\n"
27119 msgstr ""
27120
27121 # type: =head2
27122 #. type: =head2
27123 #: ../fish/guestfish-actions.pod:2706
27124 msgid "lvresize"
27125 msgstr ""
27126
27127 # type: verbatim
27128 #. type: verbatim
27129 #: ../fish/guestfish-actions.pod:2708
27130 #, no-wrap
27131 msgid ""
27132 " lvresize device mbytes\n"
27133 "\n"
27134 msgstr ""
27135
27136 # type: =head2
27137 #. type: =head2
27138 #: ../fish/guestfish-actions.pod:2714
27139 msgid "lvresize-free"
27140 msgstr ""
27141
27142 # type: verbatim
27143 #. type: verbatim
27144 #: ../fish/guestfish-actions.pod:2716
27145 #, no-wrap
27146 msgid ""
27147 " lvresize-free lv percent\n"
27148 "\n"
27149 msgstr ""
27150
27151 # type: =head2
27152 #. type: =head2
27153 #: ../fish/guestfish-actions.pod:2724
27154 msgid "lvs"
27155 msgstr ""
27156
27157 # type: verbatim
27158 #. type: verbatim
27159 #: ../fish/guestfish-actions.pod:2726
27160 #, no-wrap
27161 msgid ""
27162 " lvs\n"
27163 "\n"
27164 msgstr ""
27165
27166 # type: textblock
27167 #. type: textblock
27168 #: ../fish/guestfish-actions.pod:2734
27169 msgid "See also L</lvs-full>, L</list-filesystems>."
27170 msgstr ""
27171
27172 # type: =head2
27173 #. type: =head2
27174 #: ../fish/guestfish-actions.pod:2736
27175 msgid "lvs-full"
27176 msgstr ""
27177
27178 # type: verbatim
27179 #. type: verbatim
27180 #: ../fish/guestfish-actions.pod:2738
27181 #, no-wrap
27182 msgid ""
27183 " lvs-full\n"
27184 "\n"
27185 msgstr ""
27186
27187 # type: =head2
27188 #. type: =head2
27189 #: ../fish/guestfish-actions.pod:2743
27190 msgid "lvuuid"
27191 msgstr ""
27192
27193 # type: verbatim
27194 #. type: verbatim
27195 #: ../fish/guestfish-actions.pod:2745
27196 #, no-wrap
27197 msgid ""
27198 " lvuuid device\n"
27199 "\n"
27200 msgstr ""
27201
27202 # type: =head2
27203 #. type: =head2
27204 #: ../fish/guestfish-actions.pod:2749
27205 msgid "lxattrlist"
27206 msgstr ""
27207
27208 # type: verbatim
27209 #. type: verbatim
27210 #: ../fish/guestfish-actions.pod:2751
27211 #, no-wrap
27212 msgid ""
27213 " lxattrlist path 'names ...'\n"
27214 "\n"
27215 msgstr ""
27216
27217 # type: textblock
27218 #. type: textblock
27219 #: ../fish/guestfish-actions.pod:2767
27220 msgid ""
27221 "This call is intended for programs that want to efficiently list a directory "
27222 "contents without making many round-trips.  See also L</lstatlist> for a "
27223 "similarly efficient call for getting standard stats.  Very long directory "
27224 "listings might cause the protocol message size to be exceeded, causing this "
27225 "call to fail.  The caller must split up such requests into smaller groups of "
27226 "names."
27227 msgstr ""
27228
27229 # type: =head2
27230 #. type: =head2
27231 #: ../fish/guestfish-actions.pod:2775
27232 msgid "mkdir"
27233 msgstr ""
27234
27235 # type: verbatim
27236 #. type: verbatim
27237 #: ../fish/guestfish-actions.pod:2777
27238 #, no-wrap
27239 msgid ""
27240 " mkdir path\n"
27241 "\n"
27242 msgstr ""
27243
27244 # type: =head2
27245 #. type: =head2
27246 #: ../fish/guestfish-actions.pod:2781
27247 msgid "mkdir-mode"
27248 msgstr ""
27249
27250 # type: verbatim
27251 #. type: verbatim
27252 #: ../fish/guestfish-actions.pod:2783
27253 #, no-wrap
27254 msgid ""
27255 " mkdir-mode path mode\n"
27256 "\n"
27257 msgstr ""
27258
27259 # type: textblock
27260 #. type: textblock
27261 #: ../fish/guestfish-actions.pod:2792
27262 msgid "See also L</mkdir>, L</umask>"
27263 msgstr ""
27264
27265 # type: =head2
27266 #. type: =head2
27267 #: ../fish/guestfish-actions.pod:2794
27268 msgid "mkdir-p"
27269 msgstr ""
27270
27271 # type: verbatim
27272 #. type: verbatim
27273 #: ../fish/guestfish-actions.pod:2796
27274 #, no-wrap
27275 msgid ""
27276 " mkdir-p path\n"
27277 "\n"
27278 msgstr ""
27279
27280 # type: =head2
27281 #. type: =head2
27282 #: ../fish/guestfish-actions.pod:2801
27283 msgid "mkdtemp"
27284 msgstr ""
27285
27286 # type: verbatim
27287 #. type: verbatim
27288 #: ../fish/guestfish-actions.pod:2803
27289 #, no-wrap
27290 msgid ""
27291 " mkdtemp template\n"
27292 "\n"
27293 msgstr ""
27294
27295 # type: =head2
27296 #. type: =head2
27297 #: ../fish/guestfish-actions.pod:2824
27298 msgid "mke2fs-J"
27299 msgstr ""
27300
27301 # type: verbatim
27302 #. type: verbatim
27303 #: ../fish/guestfish-actions.pod:2826
27304 #, no-wrap
27305 msgid ""
27306 " mke2fs-J fstype blocksize device journal\n"
27307 "\n"
27308 msgstr ""
27309
27310 # type: textblock
27311 #. type: textblock
27312 #: ../fish/guestfish-actions.pod:2834
27313 msgid "See also L</mke2journal>."
27314 msgstr ""
27315
27316 # type: =head2
27317 #. type: =head2
27318 #: ../fish/guestfish-actions.pod:2836
27319 msgid "mke2fs-JL"
27320 msgstr ""
27321
27322 # type: verbatim
27323 #. type: verbatim
27324 #: ../fish/guestfish-actions.pod:2838
27325 #, no-wrap
27326 msgid ""
27327 " mke2fs-JL fstype blocksize device label\n"
27328 "\n"
27329 msgstr ""
27330
27331 # type: textblock
27332 #. type: textblock
27333 #: ../fish/guestfish-actions.pod:2843
27334 msgid "See also L</mke2journal-L>."
27335 msgstr ""
27336
27337 # type: =head2
27338 #. type: =head2
27339 #: ../fish/guestfish-actions.pod:2845
27340 msgid "mke2fs-JU"
27341 msgstr ""
27342
27343 # type: verbatim
27344 #. type: verbatim
27345 #: ../fish/guestfish-actions.pod:2847
27346 #, no-wrap
27347 msgid ""
27348 " mke2fs-JU fstype blocksize device uuid\n"
27349 "\n"
27350 msgstr ""
27351
27352 # type: textblock
27353 #. type: textblock
27354 #: ../fish/guestfish-actions.pod:2852
27355 msgid "See also L</mke2journal-U>."
27356 msgstr ""
27357
27358 # type: =head2
27359 #. type: =head2
27360 #: ../fish/guestfish-actions.pod:2854
27361 msgid "mke2journal"
27362 msgstr ""
27363
27364 # type: verbatim
27365 #. type: verbatim
27366 #: ../fish/guestfish-actions.pod:2856
27367 #, no-wrap
27368 msgid ""
27369 " mke2journal blocksize device\n"
27370 "\n"
27371 msgstr ""
27372
27373 # type: =head2
27374 #. type: =head2
27375 #: ../fish/guestfish-actions.pod:2863
27376 msgid "mke2journal-L"
27377 msgstr ""
27378
27379 # type: verbatim
27380 #. type: verbatim
27381 #: ../fish/guestfish-actions.pod:2865
27382 #, no-wrap
27383 msgid ""
27384 " mke2journal-L blocksize label device\n"
27385 "\n"
27386 msgstr ""
27387
27388 # type: =head2
27389 #. type: =head2
27390 #: ../fish/guestfish-actions.pod:2869
27391 msgid "mke2journal-U"
27392 msgstr ""
27393
27394 # type: verbatim
27395 #. type: verbatim
27396 #: ../fish/guestfish-actions.pod:2871
27397 #, no-wrap
27398 msgid ""
27399 " mke2journal-U blocksize uuid device\n"
27400 "\n"
27401 msgstr ""
27402
27403 # type: =head2
27404 #. type: =head2
27405 #: ../fish/guestfish-actions.pod:2875
27406 msgid "mkfifo"
27407 msgstr ""
27408
27409 # type: verbatim
27410 #. type: verbatim
27411 #: ../fish/guestfish-actions.pod:2877
27412 #, no-wrap
27413 msgid ""
27414 " mkfifo mode path\n"
27415 "\n"
27416 msgstr ""
27417
27418 # type: textblock
27419 #. type: textblock
27420 #: ../fish/guestfish-actions.pod:2879
27421 msgid ""
27422 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
27423 "is just a convenient wrapper around L</mknod>."
27424 msgstr ""
27425
27426 # type: =head2
27427 #. type: =head2
27428 #: ../fish/guestfish-actions.pod:2885
27429 msgid "mkfs"
27430 msgstr ""
27431
27432 # type: verbatim
27433 #. type: verbatim
27434 #: ../fish/guestfish-actions.pod:2887
27435 #, no-wrap
27436 msgid ""
27437 " mkfs fstype device\n"
27438 "\n"
27439 msgstr ""
27440
27441 # type: =head2
27442 #. type: =head2
27443 #: ../fish/guestfish-actions.pod:2893
27444 msgid "mkfs-b"
27445 msgstr ""
27446
27447 # type: verbatim
27448 #. type: verbatim
27449 #: ../fish/guestfish-actions.pod:2895
27450 #, no-wrap
27451 msgid ""
27452 " mkfs-b fstype blocksize device\n"
27453 "\n"
27454 msgstr ""
27455
27456 # type: textblock
27457 #. type: textblock
27458 #: ../fish/guestfish-actions.pod:2897
27459 msgid ""
27460 "This call is similar to L</mkfs>, but it allows you to control the block "
27461 "size of the resulting filesystem.  Supported block sizes depend on the "
27462 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
27463 msgstr ""
27464
27465 # type: =head2
27466 #. type: =head2
27467 #: ../fish/guestfish-actions.pod:2912
27468 msgid "mkfs-opts"
27469 msgstr ""
27470
27471 #. type: verbatim
27472 #: ../fish/guestfish-actions.pod:2914
27473 #, no-wrap
27474 msgid ""
27475 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
27476 "\n"
27477 msgstr ""
27478
27479 # type: =head2
27480 #. type: =head2
27481 #: ../fish/guestfish-actions.pod:2949
27482 msgid "mkmountpoint"
27483 msgstr ""
27484
27485 # type: verbatim
27486 #. type: verbatim
27487 #: ../fish/guestfish-actions.pod:2951
27488 #, no-wrap
27489 msgid ""
27490 " mkmountpoint exemptpath\n"
27491 "\n"
27492 msgstr ""
27493
27494 # type: textblock
27495 #. type: textblock
27496 #: ../fish/guestfish-actions.pod:2953
27497 msgid ""
27498 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
27499 "to create extra mountpoints before mounting the first filesystem."
27500 msgstr ""
27501
27502 # type: textblock
27503 #. type: textblock
27504 #: ../fish/guestfish-actions.pod:2977
27505 msgid ""
27506 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
27507 "unexpected errors if you try to mix these calls.  It is safest to manually "
27508 "unmount filesystems and remove mountpoints after use."
27509 msgstr ""
27510
27511 # type: textblock
27512 #. type: textblock
27513 #: ../fish/guestfish-actions.pod:2981
27514 msgid ""
27515 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
27516 "for this to work for manual mountpoints, you must ensure that the innermost "
27517 "mountpoints have the longest pathnames, as in the example code above."
27518 msgstr ""
27519
27520 #. type: textblock
27521 #: ../fish/guestfish-actions.pod:2988
27522 msgid ""
27523 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
27524 "L</umount-all> to be called when the handle is closed which can also trigger "
27525 "these issues."
27526 msgstr ""
27527
27528 # type: =head2
27529 #. type: =head2
27530 #: ../fish/guestfish-actions.pod:2992
27531 msgid "mknod"
27532 msgstr ""
27533
27534 # type: verbatim
27535 #. type: verbatim
27536 #: ../fish/guestfish-actions.pod:2994
27537 #, no-wrap
27538 msgid ""
27539 " mknod mode devmajor devminor path\n"
27540 "\n"
27541 msgstr ""
27542
27543 # type: textblock
27544 #. type: textblock
27545 #: ../fish/guestfish-actions.pod:3004
27546 msgid ""
27547 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
27548 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
27549 "regular file).  These constants are available in the standard Linux header "
27550 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
27551 "wrappers around this command which bitwise OR in the appropriate constant "
27552 "for you."
27553 msgstr ""
27554
27555 # type: =head2
27556 #. type: =head2
27557 #: ../fish/guestfish-actions.pod:3014
27558 msgid "mknod-b"
27559 msgstr ""
27560
27561 # type: verbatim
27562 #. type: verbatim
27563 #: ../fish/guestfish-actions.pod:3016
27564 #, no-wrap
27565 msgid ""
27566 " mknod-b mode devmajor devminor path\n"
27567 "\n"
27568 msgstr ""
27569
27570 # type: textblock
27571 #. type: textblock
27572 #: ../fish/guestfish-actions.pod:3018
27573 msgid ""
27574 "This call creates a block device node called C<path> with mode C<mode> and "
27575 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
27576 "wrapper around L</mknod>."
27577 msgstr ""
27578
27579 # type: =head2
27580 #. type: =head2
27581 #: ../fish/guestfish-actions.pod:3024
27582 msgid "mknod-c"
27583 msgstr ""
27584
27585 # type: verbatim
27586 #. type: verbatim
27587 #: ../fish/guestfish-actions.pod:3026
27588 #, no-wrap
27589 msgid ""
27590 " mknod-c mode devmajor devminor path\n"
27591 "\n"
27592 msgstr ""
27593
27594 # type: textblock
27595 #. type: textblock
27596 #: ../fish/guestfish-actions.pod:3028
27597 msgid ""
27598 "This call creates a char device node called C<path> with mode C<mode> and "
27599 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
27600 "wrapper around L</mknod>."
27601 msgstr ""
27602
27603 # type: =head2
27604 #. type: =head2
27605 #: ../fish/guestfish-actions.pod:3034
27606 msgid "mkswap"
27607 msgstr ""
27608
27609 # type: verbatim
27610 #. type: verbatim
27611 #: ../fish/guestfish-actions.pod:3036
27612 #, no-wrap
27613 msgid ""
27614 " mkswap device\n"
27615 "\n"
27616 msgstr ""
27617
27618 # type: =head2
27619 #. type: =head2
27620 #: ../fish/guestfish-actions.pod:3040
27621 msgid "mkswap-L"
27622 msgstr ""
27623
27624 # type: verbatim
27625 #. type: verbatim
27626 #: ../fish/guestfish-actions.pod:3042
27627 #, no-wrap
27628 msgid ""
27629 " mkswap-L label device\n"
27630 "\n"
27631 msgstr ""
27632
27633 # type: =head2
27634 #. type: =head2
27635 #: ../fish/guestfish-actions.pod:3050
27636 msgid "mkswap-U"
27637 msgstr ""
27638
27639 # type: verbatim
27640 #. type: verbatim
27641 #: ../fish/guestfish-actions.pod:3052
27642 #, no-wrap
27643 msgid ""
27644 " mkswap-U uuid device\n"
27645 "\n"
27646 msgstr ""
27647
27648 # type: =head2
27649 #. type: =head2
27650 #: ../fish/guestfish-actions.pod:3056
27651 msgid "mkswap-file"
27652 msgstr ""
27653
27654 # type: verbatim
27655 #. type: verbatim
27656 #: ../fish/guestfish-actions.pod:3058
27657 #, no-wrap
27658 msgid ""
27659 " mkswap-file path\n"
27660 "\n"
27661 msgstr ""
27662
27663 # type: textblock
27664 #. type: textblock
27665 #: ../fish/guestfish-actions.pod:3062
27666 msgid ""
27667 "This command just writes a swap file signature to an existing file.  To "
27668 "create the file itself, use something like L</fallocate>."
27669 msgstr ""
27670
27671 # type: =head2
27672 #. type: =head2
27673 #: ../fish/guestfish-actions.pod:3065
27674 msgid "modprobe"
27675 msgstr ""
27676
27677 # type: verbatim
27678 #. type: verbatim
27679 #: ../fish/guestfish-actions.pod:3067
27680 #, no-wrap
27681 msgid ""
27682 " modprobe modulename\n"
27683 "\n"
27684 msgstr ""
27685
27686 # type: =head2
27687 #. type: =head2
27688 #: ../fish/guestfish-actions.pod:3074
27689 msgid "mount"
27690 msgstr ""
27691
27692 # type: verbatim
27693 #. type: verbatim
27694 #: ../fish/guestfish-actions.pod:3076
27695 #, no-wrap
27696 msgid ""
27697 " mount device mountpoint\n"
27698 "\n"
27699 msgstr ""
27700
27701 # type: textblock
27702 #. type: textblock
27703 #: ../fish/guestfish-actions.pod:3092
27704 msgid ""
27705 "B<Important note:> When you use this call, the filesystem options C<sync> "
27706 "and C<noatime> are set implicitly.  This was originally done because we "
27707 "thought it would improve reliability, but it turns out that I<-o sync> has a "
27708 "very large negative performance impact and negligible effect on "
27709 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
27710 "code that needs performance, and instead use L</mount-options> (use an empty "
27711 "string for the first parameter if you don't want any options)."
27712 msgstr ""
27713
27714 # type: =head2
27715 #. type: =head2
27716 #: ../fish/guestfish-actions.pod:3102
27717 msgid "mount-loop"
27718 msgstr ""
27719
27720 # type: verbatim
27721 #. type: verbatim
27722 #: ../fish/guestfish-actions.pod:3104
27723 #, no-wrap
27724 msgid ""
27725 " mount-loop file mountpoint\n"
27726 "\n"
27727 msgstr ""
27728
27729 # type: =head2
27730 #. type: =head2
27731 #: ../fish/guestfish-actions.pod:3110
27732 msgid "mount-options"
27733 msgstr ""
27734
27735 # type: verbatim
27736 #. type: verbatim
27737 #: ../fish/guestfish-actions.pod:3112
27738 #, no-wrap
27739 msgid ""
27740 " mount-options options device mountpoint\n"
27741 "\n"
27742 msgstr ""
27743
27744 # type: textblock
27745 #. type: textblock
27746 #: ../fish/guestfish-actions.pod:3114
27747 msgid ""
27748 "This is the same as the L</mount> command, but it allows you to set the "
27749 "mount options as for the L<mount(8)> I<-o> flag."
27750 msgstr ""
27751
27752 # type: =head2
27753 #. type: =head2
27754 #: ../fish/guestfish-actions.pod:3122
27755 msgid "mount-ro"
27756 msgstr ""
27757
27758 # type: verbatim
27759 #. type: verbatim
27760 #: ../fish/guestfish-actions.pod:3124
27761 #, no-wrap
27762 msgid ""
27763 " mount-ro device mountpoint\n"
27764 "\n"
27765 msgstr ""
27766
27767 # type: textblock
27768 #. type: textblock
27769 #: ../fish/guestfish-actions.pod:3126
27770 msgid ""
27771 "This is the same as the L</mount> command, but it mounts the filesystem with "
27772 "the read-only (I<-o ro>) flag."
27773 msgstr ""
27774
27775 # type: =head2
27776 #. type: =head2
27777 #: ../fish/guestfish-actions.pod:3129
27778 msgid "mount-vfs"
27779 msgstr ""
27780
27781 # type: verbatim
27782 #. type: verbatim
27783 #: ../fish/guestfish-actions.pod:3131
27784 #, no-wrap
27785 msgid ""
27786 " mount-vfs options vfstype device mountpoint\n"
27787 "\n"
27788 msgstr ""
27789
27790 # type: textblock
27791 #. type: textblock
27792 #: ../fish/guestfish-actions.pod:3133
27793 msgid ""
27794 "This is the same as the L</mount> command, but it allows you to set both the "
27795 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
27796 msgstr ""
27797
27798 # type: =head2
27799 #. type: =head2
27800 #: ../fish/guestfish-actions.pod:3137
27801 msgid "mountpoints"
27802 msgstr ""
27803
27804 # type: verbatim
27805 #. type: verbatim
27806 #: ../fish/guestfish-actions.pod:3139
27807 #, no-wrap
27808 msgid ""
27809 " mountpoints\n"
27810 "\n"
27811 msgstr ""
27812
27813 # type: textblock
27814 #. type: textblock
27815 #: ../fish/guestfish-actions.pod:3141
27816 msgid ""
27817 "This call is similar to L</mounts>.  That call returns a list of devices.  "
27818 "This one returns a hash table (map) of device name to directory where the "
27819 "device is mounted."
27820 msgstr ""
27821
27822 # type: =head2
27823 #. type: =head2
27824 #: ../fish/guestfish-actions.pod:3145
27825 msgid "mounts"
27826 msgstr ""
27827
27828 # type: verbatim
27829 #. type: verbatim
27830 #: ../fish/guestfish-actions.pod:3147
27831 #, no-wrap
27832 msgid ""
27833 " mounts\n"
27834 "\n"
27835 msgstr ""
27836
27837 # type: textblock
27838 #. type: textblock
27839 #: ../fish/guestfish-actions.pod:3154
27840 msgid "See also: L</mountpoints>"
27841 msgstr ""
27842
27843 # type: =head2
27844 #. type: =head2
27845 #: ../fish/guestfish-actions.pod:3156
27846 msgid "mv"
27847 msgstr ""
27848
27849 # type: verbatim
27850 #. type: verbatim
27851 #: ../fish/guestfish-actions.pod:3158
27852 #, no-wrap
27853 msgid ""
27854 " mv src dest\n"
27855 "\n"
27856 msgstr ""
27857
27858 # type: =head2
27859 #. type: =head2
27860 #: ../fish/guestfish-actions.pod:3163
27861 msgid "ntfs-3g-probe"
27862 msgstr ""
27863
27864 # type: verbatim
27865 #. type: verbatim
27866 #: ../fish/guestfish-actions.pod:3165
27867 #, no-wrap
27868 msgid ""
27869 " ntfs-3g-probe true|false device\n"
27870 "\n"
27871 msgstr ""
27872
27873 # type: =head2
27874 #. type: =head2
27875 #: ../fish/guestfish-actions.pod:3179
27876 msgid "ntfsresize"
27877 msgstr ""
27878
27879 # type: verbatim
27880 #. type: verbatim
27881 #: ../fish/guestfish-actions.pod:3181
27882 #, no-wrap
27883 msgid ""
27884 " ntfsresize device\n"
27885 "\n"
27886 msgstr ""
27887
27888 # type: =head2
27889 #. type: =head2
27890 #: ../fish/guestfish-actions.pod:3187
27891 msgid "ntfsresize-size"
27892 msgstr ""
27893
27894 # type: verbatim
27895 #. type: verbatim
27896 #: ../fish/guestfish-actions.pod:3189
27897 #, no-wrap
27898 msgid ""
27899 " ntfsresize-size device size\n"
27900 "\n"
27901 msgstr ""
27902
27903 # type: textblock
27904 #. type: textblock
27905 #: ../fish/guestfish-actions.pod:3191
27906 msgid ""
27907 "This command is the same as L</ntfsresize> except that it allows you to "
27908 "specify the new size (in bytes) explicitly."
27909 msgstr ""
27910
27911 # type: =head2
27912 #. type: =head2
27913 #: ../fish/guestfish-actions.pod:3194
27914 msgid "part-add"
27915 msgstr ""
27916
27917 # type: verbatim
27918 #. type: verbatim
27919 #: ../fish/guestfish-actions.pod:3196
27920 #, no-wrap
27921 msgid ""
27922 " part-add device prlogex startsect endsect\n"
27923 "\n"
27924 msgstr ""
27925
27926 # type: textblock
27927 #. type: textblock
27928 #: ../fish/guestfish-actions.pod:3198
27929 msgid ""
27930 "This command adds a partition to C<device>.  If there is no partition table "
27931 "on the device, call L</part-init> first."
27932 msgstr ""
27933
27934 # type: textblock
27935 #. type: textblock
27936 #: ../fish/guestfish-actions.pod:3210
27937 msgid ""
27938 "Creating a partition which covers the whole disk is not so easy.  Use L</"
27939 "part-disk> to do that."
27940 msgstr ""
27941
27942 # type: =head2
27943 #. type: =head2
27944 #: ../fish/guestfish-actions.pod:3213
27945 msgid "part-del"
27946 msgstr ""
27947
27948 # type: verbatim
27949 #. type: verbatim
27950 #: ../fish/guestfish-actions.pod:3215
27951 #, no-wrap
27952 msgid ""
27953 " part-del device partnum\n"
27954 "\n"
27955 msgstr ""
27956
27957 # type: =head2
27958 #. type: =head2
27959 #: ../fish/guestfish-actions.pod:3223
27960 msgid "part-disk"
27961 msgstr ""
27962
27963 # type: verbatim
27964 #. type: verbatim
27965 #: ../fish/guestfish-actions.pod:3225
27966 #, no-wrap
27967 msgid ""
27968 " part-disk device parttype\n"
27969 "\n"
27970 msgstr ""
27971
27972 # type: textblock
27973 #. type: textblock
27974 #: ../fish/guestfish-actions.pod:3227
27975 msgid ""
27976 "This command is simply a combination of L</part-init> followed by L</part-"
27977 "add> to create a single primary partition covering the whole disk."
27978 msgstr ""
27979
27980 # type: textblock
27981 #. type: textblock
27982 #: ../fish/guestfish-actions.pod:3231
27983 msgid ""
27984 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
27985 "possible values are described in L</part-init>."
27986 msgstr ""
27987
27988 # type: =head2
27989 #. type: =head2
27990 #: ../fish/guestfish-actions.pod:3237
27991 msgid "part-get-bootable"
27992 msgstr ""
27993
27994 # type: verbatim
27995 #. type: verbatim
27996 #: ../fish/guestfish-actions.pod:3239
27997 #, no-wrap
27998 msgid ""
27999 " part-get-bootable device partnum\n"
28000 "\n"
28001 msgstr ""
28002
28003 # type: textblock
28004 #. type: textblock
28005 #: ../fish/guestfish-actions.pod:3244
28006 msgid "See also L</part-set-bootable>."
28007 msgstr ""
28008
28009 # type: =head2
28010 #. type: =head2
28011 #: ../fish/guestfish-actions.pod:3246
28012 msgid "part-get-mbr-id"
28013 msgstr ""
28014
28015 # type: verbatim
28016 #. type: verbatim
28017 #: ../fish/guestfish-actions.pod:3248
28018 #, no-wrap
28019 msgid ""
28020 " part-get-mbr-id device partnum\n"
28021 "\n"
28022 msgstr ""
28023
28024 # type: textblock
28025 #. type: textblock
28026 #: ../fish/guestfish-actions.pod:3253 ../fish/guestfish-actions.pod:3391
28027 msgid ""
28028 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
28029 "undefined results for other partition table types (see L</part-get-"
28030 "parttype>)."
28031 msgstr ""
28032
28033 # type: =head2
28034 #. type: =head2
28035 #: ../fish/guestfish-actions.pod:3257
28036 msgid "part-get-parttype"
28037 msgstr ""
28038
28039 # type: verbatim
28040 #. type: verbatim
28041 #: ../fish/guestfish-actions.pod:3259
28042 #, no-wrap
28043 msgid ""
28044 " part-get-parttype device\n"
28045 "\n"
28046 msgstr ""
28047
28048 # type: textblock
28049 #. type: textblock
28050 #: ../fish/guestfish-actions.pod:3264
28051 msgid ""
28052 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
28053 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
28054 "possible, although unusual.  See L</part-init> for a full list."
28055 msgstr ""
28056
28057 # type: =head2
28058 #. type: =head2
28059 #: ../fish/guestfish-actions.pod:3269
28060 msgid "part-init"
28061 msgstr ""
28062
28063 # type: verbatim
28064 #. type: verbatim
28065 #: ../fish/guestfish-actions.pod:3271
28066 #, no-wrap
28067 msgid ""
28068 " part-init device parttype\n"
28069 "\n"
28070 msgstr ""
28071
28072 # type: textblock
28073 #. type: textblock
28074 #: ../fish/guestfish-actions.pod:3277
28075 msgid ""
28076 "Initially there are no partitions.  Following this, you should call L</part-"
28077 "add> for each partition required."
28078 msgstr ""
28079
28080 # type: =head2
28081 #. type: =head2
28082 #: ../fish/guestfish-actions.pod:3340
28083 msgid "part-list"
28084 msgstr ""
28085
28086 # type: verbatim
28087 #. type: verbatim
28088 #: ../fish/guestfish-actions.pod:3342
28089 #, no-wrap
28090 msgid ""
28091 " part-list device\n"
28092 "\n"
28093 msgstr ""
28094
28095 # type: textblock
28096 #. type: textblock
28097 #: ../fish/guestfish-actions.pod:3357
28098 msgid ""
28099 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
28100 "the device's sector size, see L</blockdev-getss>."
28101 msgstr ""
28102
28103 # type: =head2
28104 #. type: =head2
28105 #: ../fish/guestfish-actions.pod:3370
28106 msgid "part-set-bootable"
28107 msgstr ""
28108
28109 # type: verbatim
28110 #. type: verbatim
28111 #: ../fish/guestfish-actions.pod:3372
28112 #, no-wrap
28113 msgid ""
28114 " part-set-bootable device partnum true|false\n"
28115 "\n"
28116 msgstr ""
28117
28118 # type: =head2
28119 #. type: =head2
28120 #: ../fish/guestfish-actions.pod:3381
28121 msgid "part-set-mbr-id"
28122 msgstr ""
28123
28124 # type: verbatim
28125 #. type: verbatim
28126 #: ../fish/guestfish-actions.pod:3383
28127 #, no-wrap
28128 msgid ""
28129 " part-set-mbr-id device partnum idbyte\n"
28130 "\n"
28131 msgstr ""
28132
28133 # type: =head2
28134 #. type: =head2
28135 #: ../fish/guestfish-actions.pod:3395
28136 msgid "part-set-name"
28137 msgstr ""
28138
28139 # type: verbatim
28140 #. type: verbatim
28141 #: ../fish/guestfish-actions.pod:3397
28142 #, no-wrap
28143 msgid ""
28144 " part-set-name device partnum name\n"
28145 "\n"
28146 msgstr ""
28147
28148 # type: =head2
28149 #. type: =head2
28150 #: ../fish/guestfish-actions.pod:3405
28151 msgid "part-to-dev"
28152 msgstr ""
28153
28154 # type: verbatim
28155 #. type: verbatim
28156 #: ../fish/guestfish-actions.pod:3407
28157 #, no-wrap
28158 msgid ""
28159 " part-to-dev partition\n"
28160 "\n"
28161 msgstr ""
28162
28163 # type: textblock
28164 #. type: textblock
28165 #: ../fish/guestfish-actions.pod:3413
28166 msgid ""
28167 "The named partition must exist, for example as a string returned from L</"
28168 "list-partitions>."
28169 msgstr ""
28170
28171 # type: =head2
28172 #. type: =head2
28173 #: ../fish/guestfish-actions.pod:3416
28174 msgid "ping-daemon"
28175 msgstr ""
28176
28177 # type: verbatim
28178 #. type: verbatim
28179 #: ../fish/guestfish-actions.pod:3418
28180 #, no-wrap
28181 msgid ""
28182 " ping-daemon\n"
28183 "\n"
28184 msgstr ""
28185
28186 # type: =head2
28187 #. type: =head2
28188 #: ../fish/guestfish-actions.pod:3425
28189 msgid "pread"
28190 msgstr ""
28191
28192 # type: verbatim
28193 #. type: verbatim
28194 #: ../fish/guestfish-actions.pod:3427
28195 #, no-wrap
28196 msgid ""
28197 " pread path count offset\n"
28198 "\n"
28199 msgstr ""
28200
28201 # type: textblock
28202 #. type: textblock
28203 #: ../fish/guestfish-actions.pod:3435
28204 msgid "See also L</pwrite>, L</pread-device>."
28205 msgstr ""
28206
28207 # type: =head2
28208 #. type: =head2
28209 #: ../fish/guestfish-actions.pod:3440
28210 msgid "pread-device"
28211 msgstr ""
28212
28213 # type: verbatim
28214 #. type: verbatim
28215 #: ../fish/guestfish-actions.pod:3442
28216 #, no-wrap
28217 msgid ""
28218 " pread-device device count offset\n"
28219 "\n"
28220 msgstr ""
28221
28222 # type: textblock
28223 #. type: textblock
28224 #: ../fish/guestfish-actions.pod:3450
28225 msgid "See also L</pread>."
28226 msgstr ""
28227
28228 # type: =head2
28229 #. type: =head2
28230 #: ../fish/guestfish-actions.pod:3455
28231 msgid "pvcreate"
28232 msgstr ""
28233
28234 # type: verbatim
28235 #. type: verbatim
28236 #: ../fish/guestfish-actions.pod:3457
28237 #, no-wrap
28238 msgid ""
28239 " pvcreate device\n"
28240 "\n"
28241 msgstr ""
28242
28243 # type: =head2
28244 #. type: =head2
28245 #: ../fish/guestfish-actions.pod:3463
28246 msgid "pvremove"
28247 msgstr ""
28248
28249 # type: verbatim
28250 #. type: verbatim
28251 #: ../fish/guestfish-actions.pod:3465
28252 #, no-wrap
28253 msgid ""
28254 " pvremove device\n"
28255 "\n"
28256 msgstr ""
28257
28258 # type: =head2
28259 #. type: =head2
28260 #: ../fish/guestfish-actions.pod:3474
28261 msgid "pvresize"
28262 msgstr ""
28263
28264 # type: verbatim
28265 #. type: verbatim
28266 #: ../fish/guestfish-actions.pod:3476
28267 #, no-wrap
28268 msgid ""
28269 " pvresize device\n"
28270 "\n"
28271 msgstr ""
28272
28273 # type: =head2
28274 #. type: =head2
28275 #: ../fish/guestfish-actions.pod:3481
28276 msgid "pvresize-size"
28277 msgstr ""
28278
28279 # type: verbatim
28280 #. type: verbatim
28281 #: ../fish/guestfish-actions.pod:3483
28282 #, no-wrap
28283 msgid ""
28284 " pvresize-size device size\n"
28285 "\n"
28286 msgstr ""
28287
28288 # type: textblock
28289 #. type: textblock
28290 #: ../fish/guestfish-actions.pod:3485
28291 msgid ""
28292 "This command is the same as L</pvresize> except that it allows you to "
28293 "specify the new size (in bytes) explicitly."
28294 msgstr ""
28295
28296 # type: =head2
28297 #. type: =head2
28298 #: ../fish/guestfish-actions.pod:3488
28299 msgid "pvs"
28300 msgstr ""
28301
28302 # type: verbatim
28303 #. type: verbatim
28304 #: ../fish/guestfish-actions.pod:3490
28305 #, no-wrap
28306 msgid ""
28307 " pvs\n"
28308 "\n"
28309 msgstr ""
28310
28311 # type: textblock
28312 #. type: textblock
28313 #: ../fish/guestfish-actions.pod:3498
28314 msgid "See also L</pvs-full>."
28315 msgstr ""
28316
28317 # type: =head2
28318 #. type: =head2
28319 #: ../fish/guestfish-actions.pod:3500
28320 msgid "pvs-full"
28321 msgstr ""
28322
28323 # type: verbatim
28324 #. type: verbatim
28325 #: ../fish/guestfish-actions.pod:3502
28326 #, no-wrap
28327 msgid ""
28328 " pvs-full\n"
28329 "\n"
28330 msgstr ""
28331
28332 # type: =head2
28333 #. type: =head2
28334 #: ../fish/guestfish-actions.pod:3507
28335 msgid "pvuuid"
28336 msgstr ""
28337
28338 # type: verbatim
28339 #. type: verbatim
28340 #: ../fish/guestfish-actions.pod:3509
28341 #, no-wrap
28342 msgid ""
28343 " pvuuid device\n"
28344 "\n"
28345 msgstr ""
28346
28347 # type: =head2
28348 #. type: =head2
28349 #: ../fish/guestfish-actions.pod:3513
28350 msgid "pwrite"
28351 msgstr ""
28352
28353 # type: verbatim
28354 #. type: verbatim
28355 #: ../fish/guestfish-actions.pod:3515
28356 #, no-wrap
28357 msgid ""
28358 " pwrite path content offset\n"
28359 "\n"
28360 msgstr ""
28361
28362 # type: textblock
28363 #. type: textblock
28364 #: ../fish/guestfish-actions.pod:3526
28365 msgid "See also L</pread>, L</pwrite-device>."
28366 msgstr ""
28367
28368 # type: =head2
28369 #. type: =head2
28370 #: ../fish/guestfish-actions.pod:3531
28371 msgid "pwrite-device"
28372 msgstr ""
28373
28374 # type: verbatim
28375 #. type: verbatim
28376 #: ../fish/guestfish-actions.pod:3533
28377 #, no-wrap
28378 msgid ""
28379 " pwrite-device device content offset\n"
28380 "\n"
28381 msgstr ""
28382
28383 # type: textblock
28384 #. type: textblock
28385 #: ../fish/guestfish-actions.pod:3543
28386 msgid "See also L</pwrite>."
28387 msgstr ""
28388
28389 # type: =head2
28390 #. type: =head2
28391 #: ../fish/guestfish-actions.pod:3548
28392 msgid "read-file"
28393 msgstr ""
28394
28395 # type: verbatim
28396 #. type: verbatim
28397 #: ../fish/guestfish-actions.pod:3550
28398 #, no-wrap
28399 msgid ""
28400 " read-file path\n"
28401 "\n"
28402 msgstr ""
28403
28404 # type: textblock
28405 #. type: textblock
28406 #: ../fish/guestfish-actions.pod:3555
28407 msgid ""
28408 "Unlike L</cat>, this function can correctly handle files that contain "
28409 "embedded ASCII NUL characters.  However unlike L</download>, this function "
28410 "is limited in the total size of file that can be handled."
28411 msgstr ""
28412
28413 # type: =head2
28414 #. type: =head2
28415 #: ../fish/guestfish-actions.pod:3563
28416 msgid "read-lines"
28417 msgstr ""
28418
28419 # type: verbatim
28420 #. type: verbatim
28421 #: ../fish/guestfish-actions.pod:3565
28422 #, no-wrap
28423 msgid ""
28424 " read-lines path\n"
28425 "\n"
28426 msgstr ""
28427
28428 # type: textblock
28429 #. type: textblock
28430 #: ../fish/guestfish-actions.pod:3572
28431 msgid ""
28432 "Note that this function cannot correctly handle binary files (specifically, "
28433 "files containing C<\\0> character which is treated as end of line).  For "
28434 "those you need to use the L</read-file> function which has a more complex "
28435 "interface."
28436 msgstr ""
28437
28438 # type: =head2
28439 #. type: =head2
28440 #: ../fish/guestfish-actions.pod:3577
28441 msgid "readdir"
28442 msgstr ""
28443
28444 # type: verbatim
28445 #. type: verbatim
28446 #: ../fish/guestfish-actions.pod:3579
28447 #, no-wrap
28448 msgid ""
28449 " readdir dir\n"
28450 "\n"
28451 msgstr ""
28452
28453 # type: textblock
28454 #. type: textblock
28455 #: ../fish/guestfish-actions.pod:3631
28456 msgid ""
28457 "This function is primarily intended for use by programs.  To get a simple "
28458 "list of names, use L</ls>.  To get a printable directory for human "
28459 "consumption, use L</ll>."
28460 msgstr ""
28461
28462 # type: =head2
28463 #. type: =head2
28464 #: ../fish/guestfish-actions.pod:3635
28465 msgid "readlink"
28466 msgstr ""
28467
28468 # type: verbatim
28469 #. type: verbatim
28470 #: ../fish/guestfish-actions.pod:3637
28471 #, no-wrap
28472 msgid ""
28473 " readlink path\n"
28474 "\n"
28475 msgstr ""
28476
28477 # type: =head2
28478 #. type: =head2
28479 #: ../fish/guestfish-actions.pod:3641
28480 msgid "readlinklist"
28481 msgstr ""
28482
28483 # type: verbatim
28484 #. type: verbatim
28485 #: ../fish/guestfish-actions.pod:3643
28486 #, no-wrap
28487 msgid ""
28488 " readlinklist path 'names ...'\n"
28489 "\n"
28490 msgstr ""
28491
28492 # type: =head2
28493 #. type: =head2
28494 #: ../fish/guestfish-actions.pod:3667
28495 msgid "realpath"
28496 msgstr ""
28497
28498 # type: verbatim
28499 #. type: verbatim
28500 #: ../fish/guestfish-actions.pod:3669
28501 #, no-wrap
28502 msgid ""
28503 " realpath path\n"
28504 "\n"
28505 msgstr ""
28506
28507 # type: =head2
28508 #. type: =head2
28509 #: ../fish/guestfish-actions.pod:3674
28510 msgid "removexattr"
28511 msgstr ""
28512
28513 # type: verbatim
28514 #. type: verbatim
28515 #: ../fish/guestfish-actions.pod:3676
28516 #, no-wrap
28517 msgid ""
28518 " removexattr xattr path\n"
28519 "\n"
28520 msgstr ""
28521
28522 # type: textblock
28523 #. type: textblock
28524 #: ../fish/guestfish-actions.pod:3681
28525 msgid "See also: L</lremovexattr>, L<attr(5)>."
28526 msgstr ""
28527
28528 # type: =head2
28529 #. type: =head2
28530 #: ../fish/guestfish-actions.pod:3683
28531 msgid "resize2fs"
28532 msgstr ""
28533
28534 # type: verbatim
28535 #. type: verbatim
28536 #: ../fish/guestfish-actions.pod:3685
28537 #, no-wrap
28538 msgid ""
28539 " resize2fs device\n"
28540 "\n"
28541 msgstr ""
28542
28543 # type: textblock
28544 #. type: textblock
28545 #: ../fish/guestfish-actions.pod:3690
28546 msgid ""
28547 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
28548 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
28549 "gives an error about this and sometimes not.  In any case, it is always safe "
28550 "to call L</e2fsck-f> before calling this function."
28551 msgstr ""
28552
28553 #. type: =head2
28554 #: ../fish/guestfish-actions.pod:3696
28555 msgid "resize2fs-M"
28556 msgstr ""
28557
28558 #. type: verbatim
28559 #: ../fish/guestfish-actions.pod:3698
28560 #, no-wrap
28561 msgid ""
28562 " resize2fs-M device\n"
28563 "\n"
28564 msgstr ""
28565
28566 #. type: textblock
28567 #: ../fish/guestfish-actions.pod:3700
28568 msgid ""
28569 "This command is the same as L</resize2fs>, but the filesystem is resized to "
28570 "its minimum size.  This works like the C<-M> option to the C<resize2fs> "
28571 "command."
28572 msgstr ""
28573
28574 #. type: textblock
28575 #: ../fish/guestfish-actions.pod:3704
28576 msgid ""
28577 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
28578 "and read the C<Block size> and C<Block count> values.  These two numbers, "
28579 "multiplied together, give the resulting size of the minimal filesystem in "
28580 "bytes."
28581 msgstr ""
28582
28583 # type: =head2
28584 #. type: =head2
28585 #: ../fish/guestfish-actions.pod:3709
28586 msgid "resize2fs-size"
28587 msgstr ""
28588
28589 # type: verbatim
28590 #. type: verbatim
28591 #: ../fish/guestfish-actions.pod:3711
28592 #, no-wrap
28593 msgid ""
28594 " resize2fs-size device size\n"
28595 "\n"
28596 msgstr ""
28597
28598 # type: textblock
28599 #. type: textblock
28600 #: ../fish/guestfish-actions.pod:3713
28601 msgid ""
28602 "This command is the same as L</resize2fs> except that it allows you to "
28603 "specify the new size (in bytes) explicitly."
28604 msgstr ""
28605
28606 # type: =head2
28607 #. type: =head2
28608 #: ../fish/guestfish-actions.pod:3716
28609 msgid "rm"
28610 msgstr ""
28611
28612 # type: verbatim
28613 #. type: verbatim
28614 #: ../fish/guestfish-actions.pod:3718
28615 #, no-wrap
28616 msgid ""
28617 " rm path\n"
28618 "\n"
28619 msgstr ""
28620
28621 # type: =head2
28622 #. type: =head2
28623 #: ../fish/guestfish-actions.pod:3722
28624 msgid "rm-rf"
28625 msgstr ""
28626
28627 # type: verbatim
28628 #. type: verbatim
28629 #: ../fish/guestfish-actions.pod:3724
28630 #, no-wrap
28631 msgid ""
28632 " rm-rf path\n"
28633 "\n"
28634 msgstr ""
28635
28636 # type: =head2
28637 #. type: =head2
28638 #: ../fish/guestfish-actions.pod:3730
28639 msgid "rmdir"
28640 msgstr ""
28641
28642 # type: verbatim
28643 #. type: verbatim
28644 #: ../fish/guestfish-actions.pod:3732
28645 #, no-wrap
28646 msgid ""
28647 " rmdir path\n"
28648 "\n"
28649 msgstr ""
28650
28651 # type: =head2
28652 #. type: =head2
28653 #: ../fish/guestfish-actions.pod:3736
28654 msgid "rmmountpoint"
28655 msgstr ""
28656
28657 # type: verbatim
28658 #. type: verbatim
28659 #: ../fish/guestfish-actions.pod:3738
28660 #, no-wrap
28661 msgid ""
28662 " rmmountpoint exemptpath\n"
28663 "\n"
28664 msgstr ""
28665
28666 # type: textblock
28667 #. type: textblock
28668 #: ../fish/guestfish-actions.pod:3740
28669 msgid ""
28670 "This calls removes a mountpoint that was previously created with L</"
28671 "mkmountpoint>.  See L</mkmountpoint> for full details."
28672 msgstr ""
28673
28674 # type: =head2
28675 #. type: =head2
28676 #: ../fish/guestfish-actions.pod:3744
28677 msgid "scrub-device"
28678 msgstr ""
28679
28680 # type: verbatim
28681 #. type: verbatim
28682 #: ../fish/guestfish-actions.pod:3746
28683 #, no-wrap
28684 msgid ""
28685 " scrub-device device\n"
28686 "\n"
28687 msgstr ""
28688
28689 # type: =head2
28690 #. type: =head2
28691 #: ../fish/guestfish-actions.pod:3757
28692 msgid "scrub-file"
28693 msgstr ""
28694
28695 # type: verbatim
28696 #. type: verbatim
28697 #: ../fish/guestfish-actions.pod:3759
28698 #, no-wrap
28699 msgid ""
28700 " scrub-file file\n"
28701 "\n"
28702 msgstr ""
28703
28704 # type: =head2
28705 #. type: =head2
28706 #: ../fish/guestfish-actions.pod:3769
28707 msgid "scrub-freespace"
28708 msgstr ""
28709
28710 # type: verbatim
28711 #. type: verbatim
28712 #: ../fish/guestfish-actions.pod:3771
28713 #, no-wrap
28714 msgid ""
28715 " scrub-freespace dir\n"
28716 "\n"
28717 msgstr ""
28718
28719 # type: textblock
28720 #. type: textblock
28721 #: ../fish/guestfish-actions.pod:3773
28722 msgid ""
28723 "This command creates the directory C<dir> and then fills it with files until "
28724 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
28725 "deletes them.  The intention is to scrub any free space on the partition "
28726 "containing C<dir>."
28727 msgstr ""
28728
28729 # type: =head2
28730 #. type: =head2
28731 #: ../fish/guestfish-actions.pod:3782
28732 msgid "set-append"
28733 msgstr ""
28734
28735 # type: =head2
28736 #. type: =head2
28737 #: ../fish/guestfish-actions.pod:3784
28738 msgid "append"
28739 msgstr ""
28740
28741 # type: verbatim
28742 #. type: verbatim
28743 #: ../fish/guestfish-actions.pod:3786
28744 #, no-wrap
28745 msgid ""
28746 " set-append append\n"
28747 "\n"
28748 msgstr ""
28749
28750 #. type: =head2
28751 #: ../fish/guestfish-actions.pod:3797
28752 msgid "set-attach-method"
28753 msgstr ""
28754
28755 #. type: =head2
28756 #: ../fish/guestfish-actions.pod:3799
28757 msgid "attach-method"
28758 msgstr ""
28759
28760 #. type: verbatim
28761 #: ../fish/guestfish-actions.pod:3801
28762 #, no-wrap
28763 msgid ""
28764 " set-attach-method attachmethod\n"
28765 "\n"
28766 msgstr ""
28767
28768 # type: =head2
28769 #. type: =head2
28770 #: ../fish/guestfish-actions.pod:3823
28771 msgid "set-autosync"
28772 msgstr ""
28773
28774 # type: =head2
28775 #. type: =head2
28776 #: ../fish/guestfish-actions.pod:3825
28777 msgid "autosync"
28778 msgstr ""
28779
28780 # type: verbatim
28781 #. type: verbatim
28782 #: ../fish/guestfish-actions.pod:3827
28783 #, no-wrap
28784 msgid ""
28785 " set-autosync true|false\n"
28786 "\n"
28787 msgstr ""
28788
28789 # type: =head2
28790 #. type: =head2
28791 #: ../fish/guestfish-actions.pod:3837
28792 msgid "set-direct"
28793 msgstr ""
28794
28795 # type: =head2
28796 #. type: =head2
28797 #: ../fish/guestfish-actions.pod:3839
28798 msgid "direct"
28799 msgstr ""
28800
28801 # type: verbatim
28802 #. type: verbatim
28803 #: ../fish/guestfish-actions.pod:3841
28804 #, no-wrap
28805 msgid ""
28806 " set-direct true|false\n"
28807 "\n"
28808 msgstr ""
28809
28810 # type: textblock
28811 #. type: textblock
28812 #: ../fish/guestfish-actions.pod:3847
28813 msgid ""
28814 "One consequence of this is that log messages aren't caught by the library "
28815 "and handled by L</set-log-message-callback>, but go straight to stdout."
28816 msgstr ""
28817
28818 # type: =head2
28819 #. type: =head2
28820 #: ../fish/guestfish-actions.pod:3856
28821 msgid "set-e2label"
28822 msgstr ""
28823
28824 # type: verbatim
28825 #. type: verbatim
28826 #: ../fish/guestfish-actions.pod:3858
28827 #, no-wrap
28828 msgid ""
28829 " set-e2label device label\n"
28830 "\n"
28831 msgstr ""
28832
28833 # type: textblock
28834 #. type: textblock
28835 #: ../fish/guestfish-actions.pod:3864
28836 msgid ""
28837 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
28838 "label on a filesystem."
28839 msgstr ""
28840
28841 # type: =head2
28842 #. type: =head2
28843 #: ../fish/guestfish-actions.pod:3867
28844 msgid "set-e2uuid"
28845 msgstr ""
28846
28847 # type: verbatim
28848 #. type: verbatim
28849 #: ../fish/guestfish-actions.pod:3869
28850 #, no-wrap
28851 msgid ""
28852 " set-e2uuid device uuid\n"
28853 "\n"
28854 msgstr ""
28855
28856 # type: textblock
28857 #. type: textblock
28858 #: ../fish/guestfish-actions.pod:3876
28859 msgid ""
28860 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
28861 "UUID of a filesystem."
28862 msgstr ""
28863
28864 # type: =head2
28865 #. type: =head2
28866 #: ../fish/guestfish-actions.pod:3879
28867 msgid "set-memsize"
28868 msgstr ""
28869
28870 # type: =head2
28871 #. type: =head2
28872 #: ../fish/guestfish-actions.pod:3881
28873 msgid "memsize"
28874 msgstr ""
28875
28876 # type: verbatim
28877 #. type: verbatim
28878 #: ../fish/guestfish-actions.pod:3883
28879 #, no-wrap
28880 msgid ""
28881 " set-memsize memsize\n"
28882 "\n"
28883 msgstr ""
28884
28885 # type: textblock
28886 #. type: textblock
28887 #: ../fish/guestfish-actions.pod:3885
28888 msgid ""
28889 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
28890 "This only has any effect if called before L</launch>."
28891 msgstr ""
28892
28893 # type: =head2
28894 #. type: =head2
28895 #: ../fish/guestfish-actions.pod:3896
28896 msgid "set-network"
28897 msgstr ""
28898
28899 # type: =head2
28900 #. type: =head2
28901 #: ../fish/guestfish-actions.pod:3898
28902 msgid "network"
28903 msgstr ""
28904
28905 # type: verbatim
28906 #. type: verbatim
28907 #: ../fish/guestfish-actions.pod:3900
28908 #, no-wrap
28909 msgid ""
28910 " set-network true|false\n"
28911 "\n"
28912 msgstr ""
28913
28914 # type: textblock
28915 #. type: textblock
28916 #: ../fish/guestfish-actions.pod:3908
28917 msgid ""
28918 "You must call this before calling L</launch>, otherwise it has no effect."
28919 msgstr ""
28920
28921 # type: =head2
28922 #. type: =head2
28923 #: ../fish/guestfish-actions.pod:3911
28924 msgid "set-path"
28925 msgstr ""
28926
28927 # type: =head2
28928 #. type: =head2
28929 #: ../fish/guestfish-actions.pod:3913
28930 msgid "path"
28931 msgstr ""
28932
28933 # type: verbatim
28934 #. type: verbatim
28935 #: ../fish/guestfish-actions.pod:3915
28936 #, no-wrap
28937 msgid ""
28938 " set-path searchpath\n"
28939 "\n"
28940 msgstr ""
28941
28942 # type: =head2
28943 #. type: =head2
28944 #: ../fish/guestfish-actions.pod:3924
28945 msgid "set-qemu"
28946 msgstr ""
28947
28948 # type: =head2
28949 #. type: =head2
28950 #: ../fish/guestfish-actions.pod:3926
28951 msgid "qemu"
28952 msgstr ""
28953
28954 # type: verbatim
28955 #. type: verbatim
28956 #: ../fish/guestfish-actions.pod:3928
28957 #, no-wrap
28958 msgid ""
28959 " set-qemu qemu\n"
28960 "\n"
28961 msgstr ""
28962
28963 # type: =head2
28964 #. type: =head2
28965 #: ../fish/guestfish-actions.pod:3948
28966 msgid "set-recovery-proc"
28967 msgstr ""
28968
28969 # type: =head2
28970 #. type: =head2
28971 #: ../fish/guestfish-actions.pod:3950
28972 msgid "recovery-proc"
28973 msgstr ""
28974
28975 # type: verbatim
28976 #. type: verbatim
28977 #: ../fish/guestfish-actions.pod:3952
28978 #, no-wrap
28979 msgid ""
28980 " set-recovery-proc true|false\n"
28981 "\n"
28982 msgstr ""
28983
28984 # type: textblock
28985 #. type: textblock
28986 #: ../fish/guestfish-actions.pod:3954
28987 msgid ""
28988 "If this is called with the parameter C<false> then L</launch> does not "
28989 "create a recovery process.  The purpose of the recovery process is to stop "
28990 "runaway qemu processes in the case where the main program aborts abruptly."
28991 msgstr ""
28992
28993 # type: textblock
28994 #. type: textblock
28995 #: ../fish/guestfish-actions.pod:3959
28996 msgid ""
28997 "This only has any effect if called before L</launch>, and the default is "
28998 "true."
28999 msgstr ""
29000
29001 # type: =head2
29002 #. type: =head2
29003 #: ../fish/guestfish-actions.pod:3968
29004 msgid "set-selinux"
29005 msgstr ""
29006
29007 # type: =head2
29008 #. type: =head2
29009 #: ../fish/guestfish-actions.pod:3970
29010 msgid "selinux"
29011 msgstr ""
29012
29013 # type: verbatim
29014 #. type: verbatim
29015 #: ../fish/guestfish-actions.pod:3972
29016 #, no-wrap
29017 msgid ""
29018 " set-selinux true|false\n"
29019 "\n"
29020 msgstr ""
29021
29022 # type: =head2
29023 #. type: =head2
29024 #: ../fish/guestfish-actions.pod:3983
29025 msgid "set-trace"
29026 msgstr ""
29027
29028 # type: =head2
29029 #. type: =head2
29030 #: ../fish/guestfish-actions.pod:3985
29031 msgid "trace"
29032 msgstr ""
29033
29034 # type: verbatim
29035 #. type: verbatim
29036 #: ../fish/guestfish-actions.pod:3987
29037 #, no-wrap
29038 msgid ""
29039 " set-trace true|false\n"
29040 "\n"
29041 msgstr ""
29042
29043 # type: =head2
29044 #. type: =head2
29045 #: ../fish/guestfish-actions.pod:4003
29046 msgid "set-verbose"
29047 msgstr ""
29048
29049 # type: =head2
29050 #. type: =head2
29051 #: ../fish/guestfish-actions.pod:4005
29052 msgid "verbose"
29053 msgstr ""
29054
29055 # type: verbatim
29056 #. type: verbatim
29057 #: ../fish/guestfish-actions.pod:4007
29058 #, no-wrap
29059 msgid ""
29060 " set-verbose true|false\n"
29061 "\n"
29062 msgstr ""
29063
29064 # type: =head2
29065 #. type: =head2
29066 #: ../fish/guestfish-actions.pod:4014
29067 msgid "setcon"
29068 msgstr ""
29069
29070 # type: verbatim
29071 #. type: verbatim
29072 #: ../fish/guestfish-actions.pod:4016
29073 #, no-wrap
29074 msgid ""
29075 " setcon context\n"
29076 "\n"
29077 msgstr ""
29078
29079 # type: =head2
29080 #. type: =head2
29081 #: ../fish/guestfish-actions.pod:4023
29082 msgid "setxattr"
29083 msgstr ""
29084
29085 # type: verbatim
29086 #. type: verbatim
29087 #: ../fish/guestfish-actions.pod:4025
29088 #, no-wrap
29089 msgid ""
29090 " setxattr xattr val vallen path\n"
29091 "\n"
29092 msgstr ""
29093
29094 # type: textblock
29095 #. type: textblock
29096 #: ../fish/guestfish-actions.pod:4031
29097 msgid "See also: L</lsetxattr>, L<attr(5)>."
29098 msgstr ""
29099
29100 # type: =head2
29101 #. type: =head2
29102 #: ../fish/guestfish-actions.pod:4033
29103 msgid "sfdisk"
29104 msgstr ""
29105
29106 # type: verbatim
29107 #. type: verbatim
29108 #: ../fish/guestfish-actions.pod:4035
29109 #, no-wrap
29110 msgid ""
29111 " sfdisk device cyls heads sectors 'lines ...'\n"
29112 "\n"
29113 msgstr ""
29114
29115 # type: textblock
29116 #. type: textblock
29117 #: ../fish/guestfish-actions.pod:4057
29118 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
29119 msgstr ""
29120
29121 # type: =head2
29122 #. type: =head2
29123 #: ../fish/guestfish-actions.pod:4063
29124 msgid "sfdiskM"
29125 msgstr ""
29126
29127 # type: verbatim
29128 #. type: verbatim
29129 #: ../fish/guestfish-actions.pod:4065
29130 #, no-wrap
29131 msgid ""
29132 " sfdiskM device 'lines ...'\n"
29133 "\n"
29134 msgstr ""
29135
29136 # type: textblock
29137 #. type: textblock
29138 #: ../fish/guestfish-actions.pod:4067
29139 msgid ""
29140 "This is a simplified interface to the L</sfdisk> command, where partition "
29141 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
29142 "you don't need to specify the cyls, heads and sectors parameters which were "
29143 "rarely if ever used anyway."
29144 msgstr ""
29145
29146 # type: textblock
29147 #. type: textblock
29148 #: ../fish/guestfish-actions.pod:4073
29149 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
29150 msgstr ""
29151
29152 # type: =head2
29153 #. type: =head2
29154 #: ../fish/guestfish-actions.pod:4079
29155 msgid "sfdisk-N"
29156 msgstr ""
29157
29158 # type: verbatim
29159 #. type: verbatim
29160 #: ../fish/guestfish-actions.pod:4081
29161 #, no-wrap
29162 msgid ""
29163 " sfdisk-N device partnum cyls heads sectors line\n"
29164 "\n"
29165 msgstr ""
29166
29167 # type: textblock
29168 #. type: textblock
29169 #: ../fish/guestfish-actions.pod:4086
29170 msgid ""
29171 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
29172 "cyls/heads/sectors parameters."
29173 msgstr ""
29174
29175 # type: textblock
29176 #. type: textblock
29177 #: ../fish/guestfish-actions.pod:4089
29178 msgid "See also: L</part-add>"
29179 msgstr ""
29180
29181 # type: =head2
29182 #. type: =head2
29183 #: ../fish/guestfish-actions.pod:4094
29184 msgid "sfdisk-disk-geometry"
29185 msgstr ""
29186
29187 # type: verbatim
29188 #. type: verbatim
29189 #: ../fish/guestfish-actions.pod:4096
29190 #, no-wrap
29191 msgid ""
29192 " sfdisk-disk-geometry device\n"
29193 "\n"
29194 msgstr ""
29195
29196 # type: textblock
29197 #. type: textblock
29198 #: ../fish/guestfish-actions.pod:4098
29199 msgid ""
29200 "This displays the disk geometry of C<device> read from the partition table.  "
29201 "Especially in the case where the underlying block device has been resized, "
29202 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
29203 "kernel-geometry>)."
29204 msgstr ""
29205
29206 # type: =head2
29207 #. type: =head2
29208 #: ../fish/guestfish-actions.pod:4106
29209 msgid "sfdisk-kernel-geometry"
29210 msgstr ""
29211
29212 # type: verbatim
29213 #. type: verbatim
29214 #: ../fish/guestfish-actions.pod:4108
29215 #, no-wrap
29216 msgid ""
29217 " sfdisk-kernel-geometry device\n"
29218 "\n"
29219 msgstr ""
29220
29221 # type: =head2
29222 #. type: =head2
29223 #: ../fish/guestfish-actions.pod:4115
29224 msgid "sfdisk-l"
29225 msgstr ""
29226
29227 # type: verbatim
29228 #. type: verbatim
29229 #: ../fish/guestfish-actions.pod:4117
29230 #, no-wrap
29231 msgid ""
29232 " sfdisk-l device\n"
29233 "\n"
29234 msgstr ""
29235
29236 # type: textblock
29237 #. type: textblock
29238 #: ../fish/guestfish-actions.pod:4123
29239 msgid "See also: L</part-list>"
29240 msgstr ""
29241
29242 # type: =head2
29243 #. type: =head2
29244 #: ../fish/guestfish-actions.pod:4125
29245 msgid "sh"
29246 msgstr ""
29247
29248 # type: verbatim
29249 #. type: verbatim
29250 #: ../fish/guestfish-actions.pod:4127
29251 #, no-wrap
29252 msgid ""
29253 " sh command\n"
29254 "\n"
29255 msgstr ""
29256
29257 # type: textblock
29258 #. type: textblock
29259 #: ../fish/guestfish-actions.pod:4132
29260 msgid "This is like L</command>, but passes the command to:"
29261 msgstr ""
29262
29263 # type: textblock
29264 #. type: textblock
29265 #: ../fish/guestfish-actions.pod:4140
29266 msgid "All the provisos about L</command> apply to this call."
29267 msgstr ""
29268
29269 # type: =head2
29270 #. type: =head2
29271 #: ../fish/guestfish-actions.pod:4142
29272 msgid "sh-lines"
29273 msgstr ""
29274
29275 # type: verbatim
29276 #. type: verbatim
29277 #: ../fish/guestfish-actions.pod:4144
29278 #, no-wrap
29279 msgid ""
29280 " sh-lines command\n"
29281 "\n"
29282 msgstr ""
29283
29284 # type: textblock
29285 #. type: textblock
29286 #: ../fish/guestfish-actions.pod:4146
29287 msgid "This is the same as L</sh>, but splits the result into a list of lines."
29288 msgstr ""
29289
29290 # type: textblock
29291 #. type: textblock
29292 #: ../fish/guestfish-actions.pod:4149
29293 msgid "See also: L</command-lines>"
29294 msgstr ""
29295
29296 # type: =head2
29297 #. type: =head2
29298 #: ../fish/guestfish-actions.pod:4151
29299 msgid "sleep"
29300 msgstr ""
29301
29302 # type: verbatim
29303 #. type: verbatim
29304 #: ../fish/guestfish-actions.pod:4153
29305 #, no-wrap
29306 msgid ""
29307 " sleep secs\n"
29308 "\n"
29309 msgstr ""
29310
29311 # type: =head2
29312 #. type: =head2
29313 #: ../fish/guestfish-actions.pod:4157
29314 msgid "stat"
29315 msgstr ""
29316
29317 # type: verbatim
29318 #. type: verbatim
29319 #: ../fish/guestfish-actions.pod:4159
29320 #, no-wrap
29321 msgid ""
29322 " stat path\n"
29323 "\n"
29324 msgstr ""
29325
29326 # type: =head2
29327 #. type: =head2
29328 #: ../fish/guestfish-actions.pod:4165
29329 msgid "statvfs"
29330 msgstr ""
29331
29332 # type: verbatim
29333 #. type: verbatim
29334 #: ../fish/guestfish-actions.pod:4167
29335 #, no-wrap
29336 msgid ""
29337 " statvfs path\n"
29338 "\n"
29339 msgstr ""
29340
29341 # type: =head2
29342 #. type: =head2
29343 #: ../fish/guestfish-actions.pod:4175
29344 msgid "strings"
29345 msgstr ""
29346
29347 # type: verbatim
29348 #. type: verbatim
29349 #: ../fish/guestfish-actions.pod:4177
29350 #, no-wrap
29351 msgid ""
29352 " strings path\n"
29353 "\n"
29354 msgstr ""
29355
29356 # type: =head2
29357 #. type: =head2
29358 #: ../fish/guestfish-actions.pod:4185
29359 msgid "strings-e"
29360 msgstr ""
29361
29362 # type: verbatim
29363 #. type: verbatim
29364 #: ../fish/guestfish-actions.pod:4187
29365 #, no-wrap
29366 msgid ""
29367 " strings-e encoding path\n"
29368 "\n"
29369 msgstr ""
29370
29371 # type: textblock
29372 #. type: textblock
29373 #: ../fish/guestfish-actions.pod:4189
29374 msgid ""
29375 "This is like the L</strings> command, but allows you to specify the encoding "
29376 "of strings that are looked for in the source file C<path>."
29377 msgstr ""
29378
29379 # type: textblock
29380 #. type: textblock
29381 #: ../fish/guestfish-actions.pod:4199
29382 msgid ""
29383 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
29384 "ISO-8859-X (this is what L</strings> uses)."
29385 msgstr ""
29386
29387 # type: =head2
29388 #. type: =head2
29389 #: ../fish/guestfish-actions.pod:4231
29390 msgid "swapoff-device"
29391 msgstr ""
29392
29393 # type: verbatim
29394 #. type: verbatim
29395 #: ../fish/guestfish-actions.pod:4233
29396 #, no-wrap
29397 msgid ""
29398 " swapoff-device device\n"
29399 "\n"
29400 msgstr ""
29401
29402 # type: textblock
29403 #. type: textblock
29404 #: ../fish/guestfish-actions.pod:4235
29405 msgid ""
29406 "This command disables the libguestfs appliance swap device or partition "
29407 "named C<device>.  See L</swapon-device>."
29408 msgstr ""
29409
29410 # type: =head2
29411 #. type: =head2
29412 #: ../fish/guestfish-actions.pod:4239
29413 msgid "swapoff-file"
29414 msgstr ""
29415
29416 # type: verbatim
29417 #. type: verbatim
29418 #: ../fish/guestfish-actions.pod:4241
29419 #, no-wrap
29420 msgid ""
29421 " swapoff-file file\n"
29422 "\n"
29423 msgstr ""
29424
29425 # type: =head2
29426 #. type: =head2
29427 #: ../fish/guestfish-actions.pod:4245
29428 msgid "swapoff-label"
29429 msgstr ""
29430
29431 # type: verbatim
29432 #. type: verbatim
29433 #: ../fish/guestfish-actions.pod:4247
29434 #, no-wrap
29435 msgid ""
29436 " swapoff-label label\n"
29437 "\n"
29438 msgstr ""
29439
29440 # type: =head2
29441 #. type: =head2
29442 #: ../fish/guestfish-actions.pod:4252
29443 msgid "swapoff-uuid"
29444 msgstr ""
29445
29446 # type: verbatim
29447 #. type: verbatim
29448 #: ../fish/guestfish-actions.pod:4254
29449 #, no-wrap
29450 msgid ""
29451 " swapoff-uuid uuid\n"
29452 "\n"
29453 msgstr ""
29454
29455 # type: =head2
29456 #. type: =head2
29457 #: ../fish/guestfish-actions.pod:4259
29458 msgid "swapon-device"
29459 msgstr ""
29460
29461 # type: verbatim
29462 #. type: verbatim
29463 #: ../fish/guestfish-actions.pod:4261
29464 #, no-wrap
29465 msgid ""
29466 " swapon-device device\n"
29467 "\n"
29468 msgstr ""
29469
29470 # type: textblock
29471 #. type: textblock
29472 #: ../fish/guestfish-actions.pod:4263
29473 msgid ""
29474 "This command enables the libguestfs appliance to use the swap device or "
29475 "partition named C<device>.  The increased memory is made available for all "
29476 "commands, for example those run using L</command> or L</sh>."
29477 msgstr ""
29478
29479 # type: =head2
29480 #. type: =head2
29481 #: ../fish/guestfish-actions.pod:4275
29482 msgid "swapon-file"
29483 msgstr ""
29484
29485 # type: verbatim
29486 #. type: verbatim
29487 #: ../fish/guestfish-actions.pod:4277
29488 #, no-wrap
29489 msgid ""
29490 " swapon-file file\n"
29491 "\n"
29492 msgstr ""
29493
29494 # type: textblock
29495 #. type: textblock
29496 #: ../fish/guestfish-actions.pod:4279
29497 msgid ""
29498 "This command enables swap to a file.  See L</swapon-device> for other notes."
29499 msgstr ""
29500
29501 # type: =head2
29502 #. type: =head2
29503 #: ../fish/guestfish-actions.pod:4282
29504 msgid "swapon-label"
29505 msgstr ""
29506
29507 # type: verbatim
29508 #. type: verbatim
29509 #: ../fish/guestfish-actions.pod:4284
29510 #, no-wrap
29511 msgid ""
29512 " swapon-label label\n"
29513 "\n"
29514 msgstr ""
29515
29516 # type: textblock
29517 #. type: textblock
29518 #: ../fish/guestfish-actions.pod:4286
29519 msgid ""
29520 "This command enables swap to a labeled swap partition.  See L</swapon-"
29521 "device> for other notes."
29522 msgstr ""
29523
29524 # type: =head2
29525 #. type: =head2
29526 #: ../fish/guestfish-actions.pod:4289
29527 msgid "swapon-uuid"
29528 msgstr ""
29529
29530 # type: verbatim
29531 #. type: verbatim
29532 #: ../fish/guestfish-actions.pod:4291
29533 #, no-wrap
29534 msgid ""
29535 " swapon-uuid uuid\n"
29536 "\n"
29537 msgstr ""
29538
29539 # type: textblock
29540 #. type: textblock
29541 #: ../fish/guestfish-actions.pod:4293
29542 msgid ""
29543 "This command enables swap to a swap partition with the given UUID.  See L</"
29544 "swapon-device> for other notes."
29545 msgstr ""
29546
29547 # type: =head2
29548 #. type: =head2
29549 #: ../fish/guestfish-actions.pod:4296
29550 msgid "sync"
29551 msgstr ""
29552
29553 # type: verbatim
29554 #. type: verbatim
29555 #: ../fish/guestfish-actions.pod:4298
29556 #, no-wrap
29557 msgid ""
29558 " sync\n"
29559 "\n"
29560 msgstr ""
29561
29562 # type: =head2
29563 #. type: =head2
29564 #: ../fish/guestfish-actions.pod:4306
29565 msgid "tail"
29566 msgstr ""
29567
29568 # type: verbatim
29569 #. type: verbatim
29570 #: ../fish/guestfish-actions.pod:4308
29571 #, no-wrap
29572 msgid ""
29573 " tail path\n"
29574 "\n"
29575 msgstr ""
29576
29577 # type: =head2
29578 #. type: =head2
29579 #: ../fish/guestfish-actions.pod:4316
29580 msgid "tail-n"
29581 msgstr ""
29582
29583 # type: verbatim
29584 #. type: verbatim
29585 #: ../fish/guestfish-actions.pod:4318
29586 #, no-wrap
29587 msgid ""
29588 " tail-n nrlines path\n"
29589 "\n"
29590 msgstr ""
29591
29592 # type: =head2
29593 #. type: =head2
29594 #: ../fish/guestfish-actions.pod:4331
29595 msgid "tar-in"
29596 msgstr ""
29597
29598 # type: verbatim
29599 #. type: verbatim
29600 #: ../fish/guestfish-actions.pod:4333
29601 #, no-wrap
29602 msgid ""
29603 " tar-in (tarfile|-) directory\n"
29604 "\n"
29605 msgstr ""
29606
29607 # type: textblock
29608 #. type: textblock
29609 #: ../fish/guestfish-actions.pod:4338
29610 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
29611 msgstr ""
29612
29613 # type: =head2
29614 #. type: =head2
29615 #: ../fish/guestfish-actions.pod:4343
29616 msgid "tar-out"
29617 msgstr ""
29618
29619 # type: verbatim
29620 #. type: verbatim
29621 #: ../fish/guestfish-actions.pod:4345
29622 #, no-wrap
29623 msgid ""
29624 " tar-out directory (tarfile|-)\n"
29625 "\n"
29626 msgstr ""
29627
29628 # type: textblock
29629 #. type: textblock
29630 #: ../fish/guestfish-actions.pod:4350
29631 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
29632 msgstr ""
29633
29634 # type: =head2
29635 #. type: =head2
29636 #: ../fish/guestfish-actions.pod:4355
29637 msgid "tgz-in"
29638 msgstr ""
29639
29640 # type: verbatim
29641 #. type: verbatim
29642 #: ../fish/guestfish-actions.pod:4357
29643 #, no-wrap
29644 msgid ""
29645 " tgz-in (tarball|-) directory\n"
29646 "\n"
29647 msgstr ""
29648
29649 # type: textblock
29650 #. type: textblock
29651 #: ../fish/guestfish-actions.pod:4362
29652 msgid "To upload an uncompressed tarball, use L</tar-in>."
29653 msgstr ""
29654
29655 # type: =head2
29656 #. type: =head2
29657 #: ../fish/guestfish-actions.pod:4366
29658 msgid "tgz-out"
29659 msgstr ""
29660
29661 # type: verbatim
29662 #. type: verbatim
29663 #: ../fish/guestfish-actions.pod:4368
29664 #, no-wrap
29665 msgid ""
29666 " tgz-out directory (tarball|-)\n"
29667 "\n"
29668 msgstr ""
29669
29670 # type: textblock
29671 #. type: textblock
29672 #: ../fish/guestfish-actions.pod:4373
29673 msgid "To download an uncompressed tarball, use L</tar-out>."
29674 msgstr ""
29675
29676 # type: =head2
29677 #. type: =head2
29678 #: ../fish/guestfish-actions.pod:4377
29679 msgid "touch"
29680 msgstr ""
29681
29682 # type: verbatim
29683 #. type: verbatim
29684 #: ../fish/guestfish-actions.pod:4379
29685 #, no-wrap
29686 msgid ""
29687 " touch path\n"
29688 "\n"
29689 msgstr ""
29690
29691 # type: =head2
29692 #. type: =head2
29693 #: ../fish/guestfish-actions.pod:4388
29694 msgid "truncate"
29695 msgstr ""
29696
29697 # type: verbatim
29698 #. type: verbatim
29699 #: ../fish/guestfish-actions.pod:4390
29700 #, no-wrap
29701 msgid ""
29702 " truncate path\n"
29703 "\n"
29704 msgstr ""
29705
29706 # type: =head2
29707 #. type: =head2
29708 #: ../fish/guestfish-actions.pod:4395
29709 msgid "truncate-size"
29710 msgstr ""
29711
29712 # type: verbatim
29713 #. type: verbatim
29714 #: ../fish/guestfish-actions.pod:4397
29715 #, no-wrap
29716 msgid ""
29717 " truncate-size path size\n"
29718 "\n"
29719 msgstr ""
29720
29721 # type: textblock
29722 #. type: textblock
29723 #: ../fish/guestfish-actions.pod:4402
29724 msgid ""
29725 "If the current file size is less than C<size> then the file is extended to "
29726 "the required size with zero bytes.  This creates a sparse file (ie. disk "
29727 "blocks are not allocated for the file until you write to it).  To create a "
29728 "non-sparse file of zeroes, use L</fallocate64> instead."
29729 msgstr ""
29730
29731 # type: =head2
29732 #. type: =head2
29733 #: ../fish/guestfish-actions.pod:4408
29734 msgid "tune2fs-l"
29735 msgstr ""
29736
29737 # type: verbatim
29738 #. type: verbatim
29739 #: ../fish/guestfish-actions.pod:4410
29740 #, no-wrap
29741 msgid ""
29742 " tune2fs-l device\n"
29743 "\n"
29744 msgstr ""
29745
29746 # type: =head2
29747 #. type: =head2
29748 #: ../fish/guestfish-actions.pod:4420
29749 msgid "txz-in"
29750 msgstr ""
29751
29752 # type: verbatim
29753 #. type: verbatim
29754 #: ../fish/guestfish-actions.pod:4422
29755 #, no-wrap
29756 msgid ""
29757 " txz-in (tarball|-) directory\n"
29758 "\n"
29759 msgstr ""
29760
29761 # type: =head2
29762 #. type: =head2
29763 #: ../fish/guestfish-actions.pod:4429
29764 msgid "txz-out"
29765 msgstr ""
29766
29767 # type: verbatim
29768 #. type: verbatim
29769 #: ../fish/guestfish-actions.pod:4431
29770 #, no-wrap
29771 msgid ""
29772 " txz-out directory (tarball|-)\n"
29773 "\n"
29774 msgstr ""
29775
29776 # type: =head2
29777 #. type: =head2
29778 #: ../fish/guestfish-actions.pod:4438
29779 msgid "umask"
29780 msgstr ""
29781
29782 # type: verbatim
29783 #. type: verbatim
29784 #: ../fish/guestfish-actions.pod:4440
29785 #, no-wrap
29786 msgid ""
29787 " umask mask\n"
29788 "\n"
29789 msgstr ""
29790
29791 # type: textblock
29792 #. type: textblock
29793 #: ../fish/guestfish-actions.pod:4454
29794 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
29795 msgstr ""
29796
29797 # type: =head2
29798 #. type: =head2
29799 #: ../fish/guestfish-actions.pod:4459
29800 msgid "umount"
29801 msgstr ""
29802
29803 # type: =head2
29804 #. type: =head2
29805 #: ../fish/guestfish-actions.pod:4461
29806 msgid "unmount"
29807 msgstr ""
29808
29809 # type: verbatim
29810 #. type: verbatim
29811 #: ../fish/guestfish-actions.pod:4463
29812 #, no-wrap
29813 msgid ""
29814 " umount pathordevice\n"
29815 "\n"
29816 msgstr ""
29817
29818 # type: =head2
29819 #. type: =head2
29820 #: ../fish/guestfish-actions.pod:4469
29821 msgid "umount-all"
29822 msgstr ""
29823
29824 # type: =head2
29825 #. type: =head2
29826 #: ../fish/guestfish-actions.pod:4471
29827 msgid "unmount-all"
29828 msgstr ""
29829
29830 # type: verbatim
29831 #. type: verbatim
29832 #: ../fish/guestfish-actions.pod:4473
29833 #, no-wrap
29834 msgid ""
29835 " umount-all\n"
29836 "\n"
29837 msgstr ""
29838
29839 # type: =head2
29840 #. type: =head2
29841 #: ../fish/guestfish-actions.pod:4479
29842 msgid "upload"
29843 msgstr ""
29844
29845 # type: verbatim
29846 #. type: verbatim
29847 #: ../fish/guestfish-actions.pod:4481
29848 #, no-wrap
29849 msgid ""
29850 " upload (filename|-) remotefilename\n"
29851 "\n"
29852 msgstr ""
29853
29854 # type: textblock
29855 #. type: textblock
29856 #: ../fish/guestfish-actions.pod:4488
29857 msgid "See also L</download>."
29858 msgstr ""
29859
29860 # type: =head2
29861 #. type: =head2
29862 #: ../fish/guestfish-actions.pod:4492
29863 msgid "upload-offset"
29864 msgstr ""
29865
29866 # type: verbatim
29867 #. type: verbatim
29868 #: ../fish/guestfish-actions.pod:4494
29869 #, no-wrap
29870 msgid ""
29871 " upload-offset (filename|-) remotefilename offset\n"
29872 "\n"
29873 msgstr ""
29874
29875 # type: textblock
29876 #. type: textblock
29877 #: ../fish/guestfish-actions.pod:4506
29878 msgid ""
29879 "Note that there is no limit on the amount of data that can be uploaded with "
29880 "this call, unlike with L</pwrite>, and this call always writes the full "
29881 "amount unless an error occurs."
29882 msgstr ""
29883
29884 # type: textblock
29885 #. type: textblock
29886 #: ../fish/guestfish-actions.pod:4511
29887 msgid "See also L</upload>, L</pwrite>."
29888 msgstr ""
29889
29890 # type: =head2
29891 #. type: =head2
29892 #: ../fish/guestfish-actions.pod:4515
29893 msgid "utimens"
29894 msgstr ""
29895
29896 # type: verbatim
29897 #. type: verbatim
29898 #: ../fish/guestfish-actions.pod:4517
29899 #, no-wrap
29900 msgid ""
29901 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
29902 "\n"
29903 msgstr ""
29904
29905 # type: =head2
29906 #. type: =head2
29907 #: ../fish/guestfish-actions.pod:4536
29908 msgid "version"
29909 msgstr ""
29910
29911 # type: verbatim
29912 #. type: verbatim
29913 #: ../fish/guestfish-actions.pod:4538
29914 #, no-wrap
29915 msgid ""
29916 " version\n"
29917 "\n"
29918 msgstr ""
29919
29920 # type: textblock
29921 #. type: textblock
29922 #: ../fish/guestfish-actions.pod:4565
29923 msgid ""
29924 "I<Note:> Don't use this call to test for availability of features.  In "
29925 "enterprise distributions we backport features from later versions into "
29926 "earlier versions, making this an unreliable way to test for features.  Use "
29927 "L</available> instead."
29928 msgstr ""
29929
29930 # type: =head2
29931 #. type: =head2
29932 #: ../fish/guestfish-actions.pod:4571
29933 msgid "vfs-label"
29934 msgstr ""
29935
29936 # type: verbatim
29937 #. type: verbatim
29938 #: ../fish/guestfish-actions.pod:4573
29939 #, no-wrap
29940 msgid ""
29941 " vfs-label device\n"
29942 "\n"
29943 msgstr ""
29944
29945 # type: textblock
29946 #. type: textblock
29947 #: ../fish/guestfish-actions.pod:4580
29948 msgid "To find a filesystem from the label, use L</findfs-label>."
29949 msgstr ""
29950
29951 # type: =head2
29952 #. type: =head2
29953 #: ../fish/guestfish-actions.pod:4582
29954 msgid "vfs-type"
29955 msgstr ""
29956
29957 # type: verbatim
29958 #. type: verbatim
29959 #: ../fish/guestfish-actions.pod:4584
29960 #, no-wrap
29961 msgid ""
29962 " vfs-type device\n"
29963 "\n"
29964 msgstr ""
29965
29966 # type: =head2
29967 #. type: =head2
29968 #: ../fish/guestfish-actions.pod:4594
29969 msgid "vfs-uuid"
29970 msgstr ""
29971
29972 # type: verbatim
29973 #. type: verbatim
29974 #: ../fish/guestfish-actions.pod:4596
29975 #, no-wrap
29976 msgid ""
29977 " vfs-uuid device\n"
29978 "\n"
29979 msgstr ""
29980
29981 # type: textblock
29982 #. type: textblock
29983 #: ../fish/guestfish-actions.pod:4603
29984 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
29985 msgstr ""
29986
29987 # type: =head2
29988 #. type: =head2
29989 #: ../fish/guestfish-actions.pod:4605
29990 msgid "vg-activate"
29991 msgstr ""
29992
29993 # type: verbatim
29994 #. type: verbatim
29995 #: ../fish/guestfish-actions.pod:4607
29996 #, no-wrap
29997 msgid ""
29998 " vg-activate true|false 'volgroups ...'\n"
29999 "\n"
30000 msgstr ""
30001
30002 # type: =head2
30003 #. type: =head2
30004 #: ../fish/guestfish-actions.pod:4620
30005 msgid "vg-activate-all"
30006 msgstr ""
30007
30008 # type: verbatim
30009 #. type: verbatim
30010 #: ../fish/guestfish-actions.pod:4622
30011 #, no-wrap
30012 msgid ""
30013 " vg-activate-all true|false\n"
30014 "\n"
30015 msgstr ""
30016
30017 # type: =head2
30018 #. type: =head2
30019 #: ../fish/guestfish-actions.pod:4632
30020 msgid "vgcreate"
30021 msgstr ""
30022
30023 # type: verbatim
30024 #. type: verbatim
30025 #: ../fish/guestfish-actions.pod:4634
30026 #, no-wrap
30027 msgid ""
30028 " vgcreate volgroup 'physvols ...'\n"
30029 "\n"
30030 msgstr ""
30031
30032 # type: =head2
30033 #. type: =head2
30034 #: ../fish/guestfish-actions.pod:4639
30035 msgid "vglvuuids"
30036 msgstr ""
30037
30038 # type: verbatim
30039 #. type: verbatim
30040 #: ../fish/guestfish-actions.pod:4641
30041 #, no-wrap
30042 msgid ""
30043 " vglvuuids vgname\n"
30044 "\n"
30045 msgstr ""
30046
30047 # type: textblock
30048 #. type: textblock
30049 #: ../fish/guestfish-actions.pod:4646
30050 msgid ""
30051 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
30052 "logical volumes and volume groups."
30053 msgstr ""
30054
30055 # type: textblock
30056 #. type: textblock
30057 #: ../fish/guestfish-actions.pod:4649
30058 msgid "See also L</vgpvuuids>."
30059 msgstr ""
30060
30061 # type: =head2
30062 #. type: =head2
30063 #: ../fish/guestfish-actions.pod:4651
30064 msgid "vgpvuuids"
30065 msgstr ""
30066
30067 # type: verbatim
30068 #. type: verbatim
30069 #: ../fish/guestfish-actions.pod:4653
30070 #, no-wrap
30071 msgid ""
30072 " vgpvuuids vgname\n"
30073 "\n"
30074 msgstr ""
30075
30076 # type: textblock
30077 #. type: textblock
30078 #: ../fish/guestfish-actions.pod:4658
30079 msgid ""
30080 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
30081 "physical volumes and volume groups."
30082 msgstr ""
30083
30084 # type: textblock
30085 #. type: textblock
30086 #: ../fish/guestfish-actions.pod:4661
30087 msgid "See also L</vglvuuids>."
30088 msgstr ""
30089
30090 # type: =head2
30091 #. type: =head2
30092 #: ../fish/guestfish-actions.pod:4663
30093 msgid "vgremove"
30094 msgstr ""
30095
30096 # type: verbatim
30097 #. type: verbatim
30098 #: ../fish/guestfish-actions.pod:4665
30099 #, no-wrap
30100 msgid ""
30101 " vgremove vgname\n"
30102 "\n"
30103 msgstr ""
30104
30105 # type: =head2
30106 #. type: =head2
30107 #: ../fish/guestfish-actions.pod:4672
30108 msgid "vgrename"
30109 msgstr ""
30110
30111 # type: verbatim
30112 #. type: verbatim
30113 #: ../fish/guestfish-actions.pod:4674
30114 #, no-wrap
30115 msgid ""
30116 " vgrename volgroup newvolgroup\n"
30117 "\n"
30118 msgstr ""
30119
30120 # type: =head2
30121 #. type: =head2
30122 #: ../fish/guestfish-actions.pod:4678
30123 msgid "vgs"
30124 msgstr ""
30125
30126 # type: verbatim
30127 #. type: verbatim
30128 #: ../fish/guestfish-actions.pod:4680
30129 #, no-wrap
30130 msgid ""
30131 " vgs\n"
30132 "\n"
30133 msgstr ""
30134
30135 # type: textblock
30136 #. type: textblock
30137 #: ../fish/guestfish-actions.pod:4688
30138 msgid "See also L</vgs-full>."
30139 msgstr ""
30140
30141 # type: =head2
30142 #. type: =head2
30143 #: ../fish/guestfish-actions.pod:4690
30144 msgid "vgs-full"
30145 msgstr ""
30146
30147 # type: verbatim
30148 #. type: verbatim
30149 #: ../fish/guestfish-actions.pod:4692
30150 #, no-wrap
30151 msgid ""
30152 " vgs-full\n"
30153 "\n"
30154 msgstr ""
30155
30156 # type: =head2
30157 #. type: =head2
30158 #: ../fish/guestfish-actions.pod:4697
30159 msgid "vgscan"
30160 msgstr ""
30161
30162 # type: verbatim
30163 #. type: verbatim
30164 #: ../fish/guestfish-actions.pod:4699
30165 #, no-wrap
30166 msgid ""
30167 " vgscan\n"
30168 "\n"
30169 msgstr ""
30170
30171 # type: =head2
30172 #. type: =head2
30173 #: ../fish/guestfish-actions.pod:4704
30174 msgid "vguuid"
30175 msgstr ""
30176
30177 # type: verbatim
30178 #. type: verbatim
30179 #: ../fish/guestfish-actions.pod:4706
30180 #, no-wrap
30181 msgid ""
30182 " vguuid vgname\n"
30183 "\n"
30184 msgstr ""
30185
30186 # type: =head2
30187 #. type: =head2
30188 #: ../fish/guestfish-actions.pod:4710
30189 msgid "wc-c"
30190 msgstr ""
30191
30192 # type: verbatim
30193 #. type: verbatim
30194 #: ../fish/guestfish-actions.pod:4712
30195 #, no-wrap
30196 msgid ""
30197 " wc-c path\n"
30198 "\n"
30199 msgstr ""
30200
30201 # type: =head2
30202 #. type: =head2
30203 #: ../fish/guestfish-actions.pod:4717
30204 msgid "wc-l"
30205 msgstr ""
30206
30207 # type: verbatim
30208 #. type: verbatim
30209 #: ../fish/guestfish-actions.pod:4719
30210 #, no-wrap
30211 msgid ""
30212 " wc-l path\n"
30213 "\n"
30214 msgstr ""
30215
30216 # type: =head2
30217 #. type: =head2
30218 #: ../fish/guestfish-actions.pod:4724
30219 msgid "wc-w"
30220 msgstr ""
30221
30222 # type: verbatim
30223 #. type: verbatim
30224 #: ../fish/guestfish-actions.pod:4726
30225 #, no-wrap
30226 msgid ""
30227 " wc-w path\n"
30228 "\n"
30229 msgstr ""
30230
30231 # type: =head2
30232 #. type: =head2
30233 #: ../fish/guestfish-actions.pod:4731
30234 msgid "write"
30235 msgstr ""
30236
30237 # type: verbatim
30238 #. type: verbatim
30239 #: ../fish/guestfish-actions.pod:4733
30240 #, no-wrap
30241 msgid ""
30242 " write path content\n"
30243 "\n"
30244 msgstr ""
30245
30246 # type: =head2
30247 #. type: =head2
30248 #: ../fish/guestfish-actions.pod:4741
30249 msgid "write-file"
30250 msgstr ""
30251
30252 # type: verbatim
30253 #. type: verbatim
30254 #: ../fish/guestfish-actions.pod:4743
30255 #, no-wrap
30256 msgid ""
30257 " write-file path content size\n"
30258 "\n"
30259 msgstr ""
30260
30261 # type: =head2
30262 #. type: =head2
30263 #: ../fish/guestfish-actions.pod:4766
30264 msgid "zegrep"
30265 msgstr ""
30266
30267 # type: verbatim
30268 #. type: verbatim
30269 #: ../fish/guestfish-actions.pod:4768
30270 #, no-wrap
30271 msgid ""
30272 " zegrep regex path\n"
30273 "\n"
30274 msgstr ""
30275
30276 # type: =head2
30277 #. type: =head2
30278 #: ../fish/guestfish-actions.pod:4776
30279 msgid "zegrepi"
30280 msgstr ""
30281
30282 # type: verbatim
30283 #. type: verbatim
30284 #: ../fish/guestfish-actions.pod:4778
30285 #, no-wrap
30286 msgid ""
30287 " zegrepi regex path\n"
30288 "\n"
30289 msgstr ""
30290
30291 # type: =head2
30292 #. type: =head2
30293 #: ../fish/guestfish-actions.pod:4786
30294 msgid "zero"
30295 msgstr ""
30296
30297 # type: verbatim
30298 #. type: verbatim
30299 #: ../fish/guestfish-actions.pod:4788
30300 #, no-wrap
30301 msgid ""
30302 " zero device\n"
30303 "\n"
30304 msgstr ""
30305
30306 # type: textblock
30307 #. type: textblock
30308 #: ../fish/guestfish-actions.pod:4796
30309 msgid "See also: L</zero-device>, L</scrub-device>."
30310 msgstr ""
30311
30312 # type: =head2
30313 #. type: =head2
30314 #: ../fish/guestfish-actions.pod:4798
30315 msgid "zero-device"
30316 msgstr ""
30317
30318 # type: verbatim
30319 #. type: verbatim
30320 #: ../fish/guestfish-actions.pod:4800
30321 #, no-wrap
30322 msgid ""
30323 " zero-device device\n"
30324 "\n"
30325 msgstr ""
30326
30327 # type: textblock
30328 #. type: textblock
30329 #: ../fish/guestfish-actions.pod:4802
30330 msgid ""
30331 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
30332 "which just zeroes the first few blocks of a device."
30333 msgstr ""
30334
30335 # type: =head2
30336 #. type: =head2
30337 #: ../fish/guestfish-actions.pod:4809
30338 msgid "zerofree"
30339 msgstr ""
30340
30341 # type: verbatim
30342 #. type: verbatim
30343 #: ../fish/guestfish-actions.pod:4811
30344 #, no-wrap
30345 msgid ""
30346 " zerofree device\n"
30347 "\n"
30348 msgstr ""
30349
30350 # type: =head2
30351 #. type: =head2
30352 #: ../fish/guestfish-actions.pod:4824
30353 msgid "zfgrep"
30354 msgstr ""
30355
30356 # type: verbatim
30357 #. type: verbatim
30358 #: ../fish/guestfish-actions.pod:4826
30359 #, no-wrap
30360 msgid ""
30361 " zfgrep pattern path\n"
30362 "\n"
30363 msgstr ""
30364
30365 # type: =head2
30366 #. type: =head2
30367 #: ../fish/guestfish-actions.pod:4834
30368 msgid "zfgrepi"
30369 msgstr ""
30370
30371 # type: verbatim
30372 #. type: verbatim
30373 #: ../fish/guestfish-actions.pod:4836
30374 #, no-wrap
30375 msgid ""
30376 " zfgrepi pattern path\n"
30377 "\n"
30378 msgstr ""
30379
30380 # type: =head2
30381 #. type: =head2
30382 #: ../fish/guestfish-actions.pod:4844
30383 msgid "zfile"
30384 msgstr ""
30385
30386 # type: verbatim
30387 #. type: verbatim
30388 #: ../fish/guestfish-actions.pod:4846
30389 #, no-wrap
30390 msgid ""
30391 " zfile meth path\n"
30392 "\n"
30393 msgstr ""
30394
30395 # type: textblock
30396 #. type: textblock
30397 #: ../fish/guestfish-actions.pod:4853
30398 msgid ""
30399 "Since 1.0.63, use L</file> instead which can now process compressed files."
30400 msgstr ""
30401
30402 # type: =head2
30403 #. type: =head2
30404 #: ../fish/guestfish-actions.pod:4863
30405 msgid "zgrep"
30406 msgstr ""
30407
30408 # type: verbatim
30409 #. type: verbatim
30410 #: ../fish/guestfish-actions.pod:4865
30411 #, no-wrap
30412 msgid ""
30413 " zgrep regex path\n"
30414 "\n"
30415 msgstr ""
30416
30417 # type: =head2
30418 #. type: =head2
30419 #: ../fish/guestfish-actions.pod:4873
30420 msgid "zgrepi"
30421 msgstr ""
30422
30423 # type: verbatim
30424 #. type: verbatim
30425 #: ../fish/guestfish-actions.pod:4875
30426 #, no-wrap
30427 msgid ""
30428 " zgrepi regex path\n"
30429 "\n"
30430 msgstr ""
30431
30432 # type: =head2
30433 #. type: =head2
30434 #: ../fish/guestfish-commands.pod:1
30435 msgid "alloc"
30436 msgstr ""
30437
30438 # type: =head2
30439 #. type: =head2
30440 #: ../fish/guestfish-commands.pod:3
30441 msgid "allocate"
30442 msgstr ""
30443
30444 # type: verbatim
30445 #. type: verbatim
30446 #: ../fish/guestfish-commands.pod:5
30447 #, no-wrap
30448 msgid ""
30449 " alloc filename size\n"
30450 "\n"
30451 msgstr ""
30452
30453 # type: textblock
30454 #. type: textblock
30455 #: ../fish/guestfish-commands.pod:7
30456 msgid ""
30457 "This creates an empty (zeroed) file of the given size, and then adds so it "
30458 "can be further examined."
30459 msgstr ""
30460
30461 # type: textblock
30462 #. type: textblock
30463 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
30464 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
30465 msgstr ""
30466
30467 # type: textblock
30468 #. type: textblock
30469 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
30470 msgid "Size can be specified using standard suffixes, eg. C<1M>."
30471 msgstr ""
30472
30473 # type: textblock
30474 #. type: textblock
30475 #: ../fish/guestfish-commands.pod:14
30476 msgid ""
30477 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
30478 "image, see L</PREPARED DISK IMAGES>."
30479 msgstr ""
30480
30481 # type: =head2
30482 #. type: =head2
30483 #: ../fish/guestfish-commands.pod:17
30484 msgid "copy-in"
30485 msgstr ""
30486
30487 # type: verbatim
30488 #. type: verbatim
30489 #: ../fish/guestfish-commands.pod:19
30490 #, no-wrap
30491 msgid ""
30492 " copy-in local [local ...] /remotedir\n"
30493 "\n"
30494 msgstr ""
30495
30496 # type: textblock
30497 #. type: textblock
30498 #: ../fish/guestfish-commands.pod:21
30499 msgid ""
30500 "C<copy-in> copies local files or directories recursively into the disk "
30501 "image, placing them in the directory called C</remotedir> (which must "
30502 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
30503 "other commands as necessary."
30504 msgstr ""
30505
30506 # type: textblock
30507 #. type: textblock
30508 #: ../fish/guestfish-commands.pod:26
30509 msgid ""
30510 "Multiple local files and directories can be specified, but the last "
30511 "parameter must always be a remote directory.  Wildcards cannot be used."
30512 msgstr ""
30513
30514 # type: =head2
30515 #. type: =head2
30516 #: ../fish/guestfish-commands.pod:30
30517 msgid "copy-out"
30518 msgstr ""
30519
30520 # type: verbatim
30521 #. type: verbatim
30522 #: ../fish/guestfish-commands.pod:32
30523 #, no-wrap
30524 msgid ""
30525 " copy-out remote [remote ...] localdir\n"
30526 "\n"
30527 msgstr ""
30528
30529 # type: textblock
30530 #. type: textblock
30531 #: ../fish/guestfish-commands.pod:34
30532 msgid ""
30533 "C<copy-out> copies remote files or directories recursively out of the disk "
30534 "image, placing them on the host disk in a local directory called C<localdir> "
30535 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
30536 "download>, L</tar-out> and other commands as necessary."
30537 msgstr ""
30538
30539 # type: textblock
30540 #. type: textblock
30541 #: ../fish/guestfish-commands.pod:40
30542 msgid ""
30543 "Multiple remote files and directories can be specified, but the last "
30544 "parameter must always be a local directory.  To download to the current "
30545 "directory, use C<.> as in:"
30546 msgstr ""
30547
30548 # type: verbatim
30549 #. type: verbatim
30550 #: ../fish/guestfish-commands.pod:44
30551 #, no-wrap
30552 msgid ""
30553 " copy-out /home .\n"
30554 "\n"
30555 msgstr ""
30556
30557 # type: textblock
30558 #. type: textblock
30559 #: ../fish/guestfish-commands.pod:46
30560 msgid ""
30561 "Wildcards cannot be used in the ordinary command, but you can use them with "
30562 "the help of L</glob> like this:"
30563 msgstr ""
30564
30565 # type: verbatim
30566 #. type: verbatim
30567 #: ../fish/guestfish-commands.pod:49
30568 #, no-wrap
30569 msgid ""
30570 " glob copy-out /home/* .\n"
30571 "\n"
30572 msgstr ""
30573
30574 # type: =head2
30575 #. type: =head2
30576 #: ../fish/guestfish-commands.pod:51
30577 msgid "echo"
30578 msgstr ""
30579
30580 # type: verbatim
30581 #. type: verbatim
30582 #: ../fish/guestfish-commands.pod:53
30583 #, no-wrap
30584 msgid ""
30585 " echo [params ...]\n"
30586 "\n"
30587 msgstr ""
30588
30589 # type: textblock
30590 #. type: textblock
30591 #: ../fish/guestfish-commands.pod:55
30592 msgid "This echos the parameters to the terminal."
30593 msgstr ""
30594
30595 # type: =head2
30596 #. type: =head2
30597 #: ../fish/guestfish-commands.pod:57
30598 msgid "edit"
30599 msgstr ""
30600
30601 # type: =head2
30602 #. type: =head2
30603 #: ../fish/guestfish-commands.pod:59
30604 msgid "vi"
30605 msgstr ""
30606
30607 # type: =head2
30608 #. type: =head2
30609 #: ../fish/guestfish-commands.pod:61
30610 msgid "emacs"
30611 msgstr ""
30612
30613 # type: verbatim
30614 #. type: verbatim
30615 #: ../fish/guestfish-commands.pod:63
30616 #, no-wrap
30617 msgid ""
30618 " edit filename\n"
30619 "\n"
30620 msgstr ""
30621
30622 # type: textblock
30623 #. type: textblock
30624 #: ../fish/guestfish-commands.pod:65
30625 msgid ""
30626 "This is used to edit a file.  It downloads the file, edits it locally using "
30627 "your editor, then uploads the result."
30628 msgstr ""
30629
30630 # type: textblock
30631 #. type: textblock
30632 #: ../fish/guestfish-commands.pod:68
30633 msgid ""
30634 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
30635 "or C<emacs> you will get those corresponding editors."
30636 msgstr ""
30637
30638 # type: =head2
30639 #. type: =head2
30640 #: ../fish/guestfish-commands.pod:72
30641 msgid "glob"
30642 msgstr ""
30643
30644 # type: verbatim
30645 #. type: verbatim
30646 #: ../fish/guestfish-commands.pod:74
30647 #, no-wrap
30648 msgid ""
30649 " glob command args...\n"
30650 "\n"
30651 msgstr ""
30652
30653 # type: textblock
30654 #. type: textblock
30655 #: ../fish/guestfish-commands.pod:76
30656 msgid ""
30657 "Expand wildcards in any paths in the args list, and run C<command> "
30658 "repeatedly on each matching path."
30659 msgstr ""
30660
30661 # type: textblock
30662 #. type: textblock
30663 #: ../fish/guestfish-commands.pod:79
30664 msgid "See L</WILDCARDS AND GLOBBING>."
30665 msgstr ""
30666
30667 # type: =head2
30668 #. type: =head2
30669 #: ../fish/guestfish-commands.pod:81
30670 msgid "hexedit"
30671 msgstr ""
30672
30673 # type: verbatim
30674 #. type: verbatim
30675 #: ../fish/guestfish-commands.pod:83
30676 #, no-wrap
30677 msgid ""
30678 " hexedit <filename|device>\n"
30679 " hexedit <filename|device> <max>\n"
30680 " hexedit <filename|device> <start> <max>\n"
30681 "\n"
30682 msgstr ""
30683
30684 # type: textblock
30685 #. type: textblock
30686 #: ../fish/guestfish-commands.pod:87
30687 msgid ""
30688 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
30689 "device."
30690 msgstr ""
30691
30692 # type: textblock
30693 #. type: textblock
30694 #: ../fish/guestfish-commands.pod:90
30695 msgid ""
30696 "This command works by downloading potentially the whole file or device, "
30697 "editing it locally, then uploading it.  If the file or device is large, you "
30698 "have to specify which part you wish to edit by using C<max> and/or C<start> "
30699 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
30700 "usual modifiers allowed such as C<1M> (1 megabyte)."
30701 msgstr ""
30702
30703 # type: textblock
30704 #. type: textblock
30705 #: ../fish/guestfish-commands.pod:97
30706 msgid "For example to edit the first few sectors of a disk you might do:"
30707 msgstr ""
30708
30709 # type: verbatim
30710 #. type: verbatim
30711 #: ../fish/guestfish-commands.pod:100
30712 #, no-wrap
30713 msgid ""
30714 " hexedit /dev/sda 1M\n"
30715 "\n"
30716 msgstr ""
30717
30718 # type: textblock
30719 #. type: textblock
30720 #: ../fish/guestfish-commands.pod:102
30721 msgid ""
30722 "which would allow you to edit anywhere within the first megabyte of the disk."
30723 msgstr ""
30724
30725 # type: textblock
30726 #. type: textblock
30727 #: ../fish/guestfish-commands.pod:105
30728 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
30729 msgstr ""
30730
30731 # type: verbatim
30732 #. type: verbatim
30733 #: ../fish/guestfish-commands.pod:107
30734 #, no-wrap
30735 msgid ""
30736 " hexedit /dev/sda1 0x400 0x400\n"
30737 "\n"
30738 msgstr ""
30739
30740 # type: textblock
30741 #. type: textblock
30742 #: ../fish/guestfish-commands.pod:109
30743 msgid "(assuming the superblock is in the standard location)."
30744 msgstr ""
30745
30746 # type: textblock
30747 #. type: textblock
30748 #: ../fish/guestfish-commands.pod:111
30749 msgid ""
30750 "This command requires the external L<hexedit(1)> program.  You can specify "
30751 "another program to use by setting the C<HEXEDITOR> environment variable."
30752 msgstr ""
30753
30754 # type: textblock
30755 #. type: textblock
30756 #: ../fish/guestfish-commands.pod:115
30757 msgid "See also L</hexdump>."
30758 msgstr ""
30759
30760 # type: =head2
30761 #. type: =head2
30762 #: ../fish/guestfish-commands.pod:117
30763 msgid "lcd"
30764 msgstr ""
30765
30766 # type: verbatim
30767 #. type: verbatim
30768 #: ../fish/guestfish-commands.pod:119
30769 #, no-wrap
30770 msgid ""
30771 " lcd directory\n"
30772 "\n"
30773 msgstr ""
30774
30775 # type: textblock
30776 #. type: textblock
30777 #: ../fish/guestfish-commands.pod:121
30778 msgid ""
30779 "Change the local directory, ie. the current directory of guestfish itself."
30780 msgstr ""
30781
30782 # type: textblock
30783 #. type: textblock
30784 #: ../fish/guestfish-commands.pod:124
30785 msgid "Note that C<!cd> won't do what you might expect."
30786 msgstr ""
30787
30788 # type: =head2
30789 #. type: =head2
30790 #: ../fish/guestfish-commands.pod:126
30791 msgid "man"
30792 msgstr ""
30793
30794 # type: =head2
30795 #. type: =head2
30796 #: ../fish/guestfish-commands.pod:128
30797 msgid "manual"
30798 msgstr ""
30799
30800 # type: verbatim
30801 #. type: verbatim
30802 #: ../fish/guestfish-commands.pod:130
30803 #, no-wrap
30804 msgid ""
30805 "  man\n"
30806 "\n"
30807 msgstr ""
30808
30809 # type: textblock
30810 #. type: textblock
30811 #: ../fish/guestfish-commands.pod:132
30812 msgid "Opens the manual page for guestfish."
30813 msgstr ""
30814
30815 # type: =head2
30816 #. type: =head2
30817 #: ../fish/guestfish-commands.pod:134
30818 msgid "more"
30819 msgstr ""
30820
30821 # type: =head2
30822 #. type: =head2
30823 #: ../fish/guestfish-commands.pod:136
30824 msgid "less"
30825 msgstr ""
30826
30827 # type: verbatim
30828 #. type: verbatim
30829 #: ../fish/guestfish-commands.pod:138
30830 #, no-wrap
30831 msgid ""
30832 " more filename\n"
30833 "\n"
30834 msgstr ""
30835
30836 # type: verbatim
30837 #. type: verbatim
30838 #: ../fish/guestfish-commands.pod:140
30839 #, no-wrap
30840 msgid ""
30841 " less filename\n"
30842 "\n"
30843 msgstr ""
30844
30845 # type: textblock
30846 #. type: textblock
30847 #: ../fish/guestfish-commands.pod:142
30848 msgid "This is used to view a file."
30849 msgstr ""
30850
30851 # type: textblock
30852 #. type: textblock
30853 #: ../fish/guestfish-commands.pod:144
30854 msgid ""
30855 "The default viewer is C<$PAGER>.  However if you use the alternate command "
30856 "C<less> you will get the C<less> command specifically."
30857 msgstr ""
30858
30859 # type: =head2
30860 #. type: =head2
30861 #: ../fish/guestfish-commands.pod:147
30862 msgid "reopen"
30863 msgstr ""
30864
30865 # type: verbatim
30866 #. type: verbatim
30867 #: ../fish/guestfish-commands.pod:149
30868 #, no-wrap
30869 msgid ""
30870 "  reopen\n"
30871 "\n"
30872 msgstr ""
30873
30874 # type: textblock
30875 #. type: textblock
30876 #: ../fish/guestfish-commands.pod:151
30877 msgid ""
30878 "Close and reopen the libguestfs handle.  It is not necessary to use this "
30879 "normally, because the handle is closed properly when guestfish exits.  "
30880 "However this is occasionally useful for testing."
30881 msgstr ""
30882
30883 # type: =head2
30884 #. type: =head2
30885 #: ../fish/guestfish-commands.pod:155
30886 msgid "sparse"
30887 msgstr ""
30888
30889 # type: verbatim
30890 #. type: verbatim
30891 #: ../fish/guestfish-commands.pod:157
30892 #, no-wrap
30893 msgid ""
30894 " sparse filename size\n"
30895 "\n"
30896 msgstr ""
30897
30898 # type: textblock
30899 #. type: textblock
30900 #: ../fish/guestfish-commands.pod:159
30901 msgid ""
30902 "This creates an empty sparse file of the given size, and then adds so it can "
30903 "be further examined."
30904 msgstr ""
30905
30906 # type: textblock
30907 #. type: textblock
30908 #: ../fish/guestfish-commands.pod:162
30909 msgid ""
30910 "In all respects it works the same as the L</alloc> command, except that the "
30911 "image file is allocated sparsely, which means that disk blocks are not "
30912 "assigned to the file until they are needed.  Sparse disk files only use "
30913 "space when written to, but they are slower and there is a danger you could "
30914 "run out of real disk space during a write operation."
30915 msgstr ""
30916
30917 # type: =head2
30918 #. type: =head2
30919 #: ../fish/guestfish-commands.pod:172
30920 msgid "supported"
30921 msgstr ""
30922
30923 # type: verbatim
30924 #. type: verbatim
30925 #: ../fish/guestfish-commands.pod:174
30926 #, no-wrap
30927 msgid ""
30928 " supported\n"
30929 "\n"
30930 msgstr ""
30931
30932 # type: textblock
30933 #. type: textblock
30934 #: ../fish/guestfish-commands.pod:176
30935 msgid ""
30936 "This command returns a list of the optional groups known to the daemon, and "
30937 "indicates which ones are supported by this build of the libguestfs appliance."
30938 msgstr ""
30939
30940 # type: textblock
30941 #. type: textblock
30942 #: ../fish/guestfish-commands.pod:180
30943 msgid "See also L<guestfs(3)/AVAILABILITY>."
30944 msgstr ""
30945
30946 # type: =head2
30947 #. type: =head2
30948 #: ../fish/guestfish-commands.pod:182
30949 msgid "time"
30950 msgstr ""
30951
30952 # type: verbatim
30953 #. type: verbatim
30954 #: ../fish/guestfish-commands.pod:184
30955 #, no-wrap
30956 msgid ""
30957 " time command args...\n"
30958 "\n"
30959 msgstr ""
30960
30961 # type: textblock
30962 #. type: textblock
30963 #: ../fish/guestfish-commands.pod:186
30964 msgid ""
30965 "Run the command as usual, but print the elapsed time afterwards.  This can "
30966 "be useful for benchmarking operations."
30967 msgstr ""
30968
30969 # type: textblock
30970 #. type: textblock
30971 #: ../test-tool/libguestfs-test-tool.pod:5
30972 msgid "libguestfs-test-tool - End user tests for libguestfs"
30973 msgstr ""
30974
30975 # type: verbatim
30976 #. type: verbatim
30977 #: ../test-tool/libguestfs-test-tool.pod:9
30978 #, no-wrap
30979 msgid ""
30980 " libguestfs-test-tool [--options]\n"
30981 "\n"
30982 msgstr ""
30983
30984 # type: textblock
30985 #. type: textblock
30986 #: ../test-tool/libguestfs-test-tool.pod:13
30987 msgid ""
30988 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
30989 "and developers, to allow them to check basic libguestfs functionality is "
30990 "working.  This is needed because libguestfs occasionally breaks for reasons "
30991 "beyond our control: usually because of changes in the underlying qemu or "
30992 "kernel packages, or the host environment."
30993 msgstr ""
30994
30995 # type: textblock
30996 #. type: textblock
30997 #: ../test-tool/libguestfs-test-tool.pod:20
30998 msgid "If you suspect a problem in libguestfs, then just run:"
30999 msgstr ""
31000
31001 # type: verbatim
31002 #. type: verbatim
31003 #: ../test-tool/libguestfs-test-tool.pod:22
31004 #, no-wrap
31005 msgid ""
31006 " libguestfs-test-tool\n"
31007 "\n"
31008 msgstr ""
31009
31010 # type: textblock
31011 #. type: textblock
31012 #: ../test-tool/libguestfs-test-tool.pod:24
31013 msgid "It will print lots of diagnostic messages."
31014 msgstr ""
31015
31016 # type: textblock
31017 #. type: textblock
31018 #: ../test-tool/libguestfs-test-tool.pod:26
31019 msgid "If it runs to completion successfully, you will see this near the end:"
31020 msgstr ""
31021
31022 # type: verbatim
31023 #. type: verbatim
31024 #: ../test-tool/libguestfs-test-tool.pod:28
31025 #, no-wrap
31026 msgid ""
31027 " ===== TEST FINISHED OK =====\n"
31028 "\n"
31029 msgstr ""
31030
31031 # type: textblock
31032 #. type: textblock
31033 #: ../test-tool/libguestfs-test-tool.pod:30
31034 msgid "and the test tool will exit with code 0."
31035 msgstr ""
31036
31037 # type: textblock
31038 #. type: textblock
31039 #: ../test-tool/libguestfs-test-tool.pod:32
31040 msgid ""
31041 "If it fails (and/or exits with non-zero error code), please paste the "
31042 "B<complete, unedited> output of the test tool into a bug report.  More "
31043 "information about reporting bugs can be found on the L<http://libguestfs.org/"
31044 "> website."
31045 msgstr ""
31046
31047 # type: =item
31048 #. type: =item
31049 #: ../test-tool/libguestfs-test-tool.pod:41
31050 msgid "I<--help>"
31051 msgstr ""
31052
31053 # type: textblock
31054 #. type: textblock
31055 #: ../test-tool/libguestfs-test-tool.pod:43
31056 msgid "Display short usage information and exit."
31057 msgstr ""
31058
31059 # type: =item
31060 #. type: =item
31061 #: ../test-tool/libguestfs-test-tool.pod:45
31062 msgid "I<--helper /path/to/libguestfs-test-tool-helper>"
31063 msgstr ""
31064
31065 # type: textblock
31066 #. type: textblock
31067 #: ../test-tool/libguestfs-test-tool.pod:47
31068 msgid ""
31069 "Pass an alternate name for the helper program.  libguestfs-test-tool will "
31070 "normally look in the C<$libexec> directory that was configured when the tool "
31071 "was built."
31072 msgstr ""
31073
31074 # type: =item
31075 #. type: =item
31076 #: ../test-tool/libguestfs-test-tool.pod:51
31077 msgid "I<--qemu qemu_binary>"
31078 msgstr ""
31079
31080 # type: textblock
31081 #. type: textblock
31082 #: ../test-tool/libguestfs-test-tool.pod:53
31083 msgid ""
31084 "If you have downloaded another qemu binary, point this option at the full "
31085 "path of the binary to try it."
31086 msgstr ""
31087
31088 # type: =item
31089 #. type: =item
31090 #: ../test-tool/libguestfs-test-tool.pod:56
31091 msgid "I<--qemudir qemu_source_dir>"
31092 msgstr ""
31093
31094 # type: textblock
31095 #. type: textblock
31096 #: ../test-tool/libguestfs-test-tool.pod:58
31097 msgid ""
31098 "If you have compiled qemu from source, point this option at the source "
31099 "directory to try it."
31100 msgstr ""
31101
31102 # type: =item
31103 #. type: =item
31104 #: ../test-tool/libguestfs-test-tool.pod:61
31105 msgid "I<--timeout N>"
31106 msgstr ""
31107
31108 # type: textblock
31109 #. type: textblock
31110 #: ../test-tool/libguestfs-test-tool.pod:63
31111 msgid ""
31112 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
31113 "does not usually need to be adjusted unless your machine is very slow."
31114 msgstr ""
31115
31116 # type: =head1
31117 #. type: =head1
31118 #: ../test-tool/libguestfs-test-tool.pod:69
31119 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
31120 msgstr ""
31121
31122 # type: textblock
31123 #. type: textblock
31124 #: ../test-tool/libguestfs-test-tool.pod:71
31125 msgid ""
31126 "If you have compiled another version of qemu from source and would like to "
31127 "try that, then you can use the I<--qemudir> option to point to the qemu "
31128 "source directory."
31129 msgstr ""
31130
31131 # type: textblock
31132 #. type: textblock
31133 #: ../test-tool/libguestfs-test-tool.pod:75
31134 msgid ""
31135 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
31136 "option to point to the binary."
31137 msgstr ""
31138
31139 # type: textblock
31140 #. type: textblock
31141 #: ../test-tool/libguestfs-test-tool.pod:78
31142 msgid ""
31143 "When using an alternate qemu with libguestfs, usually you would need to "
31144 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
31145 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
31146 "use either of the I<--qemudir> or I<--qemu> options."
31147 msgstr ""
31148
31149 # type: textblock
31150 #. type: textblock
31151 #: ../test-tool/libguestfs-test-tool.pod:85
31152 msgid ""
31153 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
31154 "I<1> if there was an error."
31155 msgstr ""
31156
31157 # type: =item
31158 #. type: =item
31159 #: ../test-tool/libguestfs-test-tool.pod:92
31160 msgid "/usr/libexec/libguestfs-test-tool-helper"
31161 msgstr ""
31162
31163 # type: textblock
31164 #. type: textblock
31165 #: ../test-tool/libguestfs-test-tool.pod:94
31166 msgid ""
31167 "This helper program is run inside the appliance and provides additional "
31168 "tests."
31169 msgstr ""
31170
31171 # type: =item
31172 #. type: =item
31173 #: ../test-tool/libguestfs-test-tool.pod:97
31174 msgid "/usr/bin/mkisofs"
31175 msgstr ""
31176
31177 # type: textblock
31178 #. type: textblock
31179 #: ../test-tool/libguestfs-test-tool.pod:99
31180 msgid ""
31181 "The C<mkisofs> command is required in order to construct a CD-ROM ISO file "
31182 "which is used as part of the tests."
31183 msgstr ""
31184
31185 # type: textblock
31186 #. type: textblock
31187 #: ../test-tool/libguestfs-test-tool.pod:106
31188 msgid ""
31189 "For the full list of environment variables which may affect libguestfs, "
31190 "please see the L<guestfs(3)> manual page."
31191 msgstr ""
31192
31193 # type: textblock
31194 #. type: textblock
31195 #: ../test-tool/libguestfs-test-tool.pod:111
31196 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
31197 msgstr ""
31198
31199 # type: textblock
31200 #. type: textblock
31201 #: ../test-tool/libguestfs-test-tool.pod:121
31202 msgid "Copyright (C) 2009 Red Hat Inc.  L<http://libguestfs.org/>"
31203 msgstr ""
31204
31205 # type: textblock
31206 #. type: textblock
31207 #: ../fuse/guestmount.pod:5
31208 msgid ""
31209 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
31210 msgstr ""
31211
31212 # type: verbatim
31213 #. type: verbatim
31214 #: ../fuse/guestmount.pod:9
31215 #, no-wrap
31216 msgid ""
31217 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
31218 "\n"
31219 msgstr ""
31220
31221 # type: verbatim
31222 #. type: verbatim
31223 #: ../fuse/guestmount.pod:11
31224 #, no-wrap
31225 msgid ""
31226 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
31227 "\n"
31228 msgstr ""
31229
31230 # type: verbatim
31231 #. type: verbatim
31232 #: ../fuse/guestmount.pod:13
31233 #, no-wrap
31234 msgid ""
31235 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
31236 "\n"
31237 msgstr ""
31238
31239 # type: textblock
31240 #. type: textblock
31241 #: ../fuse/guestmount.pod:17
31242 msgid ""
31243 "You must I<not> use C<guestmount> in read-write mode on live virtual "
31244 "machines.  If you do this, you risk disk corruption in the VM."
31245 msgstr ""
31246
31247 # type: textblock
31248 #. type: textblock
31249 #: ../fuse/guestmount.pod:22
31250 msgid ""
31251 "The guestmount program can be used to mount virtual machine filesystems and "
31252 "other disk images on the host.  It uses libguestfs for access to the guest "
31253 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
31254 "a mountable device."
31255 msgstr ""
31256
31257 # type: textblock
31258 #. type: textblock
31259 #: ../fuse/guestmount.pod:27
31260 msgid ""
31261 "Along with other options, you have to give at least one device (I<-a> "
31262 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
31263 "option) or use the I<-i> inspection option.  How this works is better "
31264 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
31265 "below."
31266 msgstr ""
31267
31268 # type: textblock
31269 #. type: textblock
31270 #: ../fuse/guestmount.pod:33
31271 msgid ""
31272 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
31273 "by you, and the filesystem will not be visible to any other users unless you "
31274 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
31275 "the filesystem, use the C<fusermount -u> command."
31276 msgstr ""
31277
31278 # type: textblock
31279 #. type: textblock
31280 #: ../fuse/guestmount.pod:41
31281 msgid ""
31282 "For a typical Windows guest which has its main filesystem on the first "
31283 "partition:"
31284 msgstr ""
31285
31286 # type: verbatim
31287 #. type: verbatim
31288 #: ../fuse/guestmount.pod:44
31289 #, no-wrap
31290 msgid ""
31291 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
31292 "\n"
31293 msgstr ""
31294
31295 # type: textblock
31296 #. type: textblock
31297 #: ../fuse/guestmount.pod:46
31298 msgid ""
31299 "For a typical Linux guest which has a /boot filesystem on the first "
31300 "partition, and the root filesystem on a logical volume:"
31301 msgstr ""
31302
31303 # type: verbatim
31304 #. type: verbatim
31305 #: ../fuse/guestmount.pod:49
31306 #, no-wrap
31307 msgid ""
31308 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
31309 "\n"
31310 msgstr ""
31311
31312 # type: textblock
31313 #. type: textblock
31314 #: ../fuse/guestmount.pod:51
31315 msgid "To get libguestfs to detect guest mountpoints for you:"
31316 msgstr ""
31317
31318 # type: verbatim
31319 #. type: verbatim
31320 #: ../fuse/guestmount.pod:53
31321 #, no-wrap
31322 msgid ""
31323 " guestmount -a guest.img -i --ro /mnt\n"
31324 "\n"
31325 msgstr ""
31326
31327 # type: textblock
31328 #. type: textblock
31329 #: ../fuse/guestmount.pod:55
31330 msgid "For a libvirt guest called \"Guest\" you could do:"
31331 msgstr ""
31332
31333 # type: verbatim
31334 #. type: verbatim
31335 #: ../fuse/guestmount.pod:57
31336 #, no-wrap
31337 msgid ""
31338 " guestmount -d Guest -i --ro /mnt\n"
31339 "\n"
31340 msgstr ""
31341
31342 # type: textblock
31343 #. type: textblock
31344 #: ../fuse/guestmount.pod:59
31345 msgid ""
31346 "If you don't know what filesystems are contained in a guest or disk image, "
31347 "use L<virt-filesystems(1)> first:"
31348 msgstr ""
31349
31350 # type: verbatim
31351 #. type: verbatim
31352 #: ../fuse/guestmount.pod:62
31353 #, no-wrap
31354 msgid ""
31355 " virt-filesystems MyGuest\n"
31356 "\n"
31357 msgstr ""
31358
31359 # type: textblock
31360 #. type: textblock
31361 #: ../fuse/guestmount.pod:64
31362 msgid ""
31363 "If you want to trace the libguestfs calls but without excessive debugging "
31364 "information, we recommend:"
31365 msgstr ""
31366
31367 # type: verbatim
31368 #. type: verbatim
31369 #: ../fuse/guestmount.pod:67
31370 #, no-wrap
31371 msgid ""
31372 " guestmount [...] --trace /mnt\n"
31373 "\n"
31374 msgstr ""
31375
31376 # type: textblock
31377 #. type: textblock
31378 #: ../fuse/guestmount.pod:69
31379 msgid "If you want to debug the program, we recommend:"
31380 msgstr ""
31381
31382 # type: verbatim
31383 #. type: verbatim
31384 #: ../fuse/guestmount.pod:71
31385 #, no-wrap
31386 msgid ""
31387 " guestmount [...] --trace --verbose /mnt\n"
31388 "\n"
31389 msgstr ""
31390
31391 # type: =item
31392 #. type: =item
31393 #: ../fuse/guestmount.pod:77
31394 msgid "B<-a image> | B<--add image>"
31395 msgstr ""
31396
31397 # type: textblock
31398 #. type: textblock
31399 #: ../fuse/guestmount.pod:79
31400 msgid "Add a block device or virtual machine image."
31401 msgstr ""
31402
31403 # type: =item
31404 #. type: =item
31405 #: ../fuse/guestmount.pod:84
31406 msgid "B<-c URI> | B<--connect URI>"
31407 msgstr ""
31408
31409 # type: =item
31410 #. type: =item
31411 #: ../fuse/guestmount.pod:90
31412 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
31413 msgstr ""
31414
31415 # type: =item
31416 #. type: =item
31417 #: ../fuse/guestmount.pod:96
31418 msgid "B<--dir-cache-timeout N>"
31419 msgstr ""
31420
31421 # type: textblock
31422 #. type: textblock
31423 #: ../fuse/guestmount.pod:98
31424 msgid ""
31425 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
31426 "seconds.  The readdir cache [actually, there are several semi-independent "
31427 "caches] is populated after a readdir(2) call with the stat and extended "
31428 "attributes of the files in the directory, in anticipation that they will be "
31429 "requested soon after."
31430 msgstr ""
31431
31432 # type: textblock
31433 #. type: textblock
31434 #: ../fuse/guestmount.pod:104
31435 msgid ""
31436 "There is also a different attribute cache implemented by FUSE (see the FUSE "
31437 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
31438 "requests, only cache existing ones."
31439 msgstr ""
31440
31441 # type: =item
31442 #. type: =item
31443 #: ../fuse/guestmount.pod:115
31444 msgid "B<--format=raw|qcow2|..> | B<--format>"
31445 msgstr ""
31446
31447 # type: textblock
31448 #. type: textblock
31449 #: ../fuse/guestmount.pod:122
31450 msgid ""
31451 "If you have untrusted raw-format guest disk images, you should use this "
31452 "option to specify the disk format.  This avoids a possible security problem "
31453 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
31454 "guestfs_add_drive_opts>."
31455 msgstr ""
31456
31457 # type: =item
31458 #. type: =item
31459 #: ../fuse/guestmount.pod:127
31460 msgid "B<--fuse-help>"
31461 msgstr ""
31462
31463 # type: textblock
31464 #. type: textblock
31465 #: ../fuse/guestmount.pod:129
31466 msgid "Display help on special FUSE options (see I<-o> below)."
31467 msgstr ""
31468
31469 # type: textblock
31470 #. type: textblock
31471 #: ../fuse/guestmount.pod:133
31472 msgid "Display brief help and exit."
31473 msgstr ""
31474
31475 # type: =item
31476 #. type: =item
31477 #: ../fuse/guestmount.pod:135
31478 msgid "B<-i> | B<--inspector>"
31479 msgstr ""
31480
31481 # type: =item
31482 #. type: =item
31483 #: ../fuse/guestmount.pod:151
31484 msgid "B<-m dev[:mnt]> | B<--mount dev[:mnt]>"
31485 msgstr ""
31486
31487 # type: textblock
31488 #. type: textblock
31489 #: ../fuse/guestmount.pod:153
31490 msgid ""
31491 "Mount the named partition or logical volume on the given mountpoint B<in the "
31492 "guest> (this has nothing to do with mountpoints in the host)."
31493 msgstr ""
31494
31495 # type: textblock
31496 #. type: textblock
31497 #: ../fuse/guestmount.pod:156
31498 msgid ""
31499 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
31500 "something on C</>."
31501 msgstr ""
31502
31503 # type: =item
31504 #. type: =item
31505 #: ../fuse/guestmount.pod:159
31506 msgid "B<-n> | B<--no-sync>"
31507 msgstr ""
31508
31509 # type: textblock
31510 #. type: textblock
31511 #: ../fuse/guestmount.pod:161
31512 msgid ""
31513 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
31514 "unmounted.  If you specify this option, then we don't attempt to sync the "
31515 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
31516 msgstr ""
31517
31518 # type: =item
31519 #. type: =item
31520 #: ../fuse/guestmount.pod:166
31521 msgid "B<-o option> | B<--option option>"
31522 msgstr ""
31523
31524 # type: textblock
31525 #. type: textblock
31526 #: ../fuse/guestmount.pod:168
31527 msgid "Pass extra options to FUSE."
31528 msgstr ""
31529
31530 # type: textblock
31531 #. type: textblock
31532 #: ../fuse/guestmount.pod:170
31533 msgid ""
31534 "To get a list of all the extra options supported by FUSE, use the command "
31535 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
31536 "of them are a good idea."
31537 msgstr ""
31538
31539 # type: verbatim
31540 #. type: verbatim
31541 #: ../fuse/guestmount.pod:174
31542 #, no-wrap
31543 msgid ""
31544 " guestmount --fuse-help\n"
31545 "\n"
31546 msgstr ""
31547
31548 # type: textblock
31549 #. type: textblock
31550 #: ../fuse/guestmount.pod:176
31551 msgid "Some potentially useful FUSE options:"
31552 msgstr ""
31553
31554 # type: =item
31555 #. type: =item
31556 #: ../fuse/guestmount.pod:180
31557 msgid "B<-o allow_other>"
31558 msgstr ""
31559
31560 # type: textblock
31561 #. type: textblock
31562 #: ../fuse/guestmount.pod:182
31563 msgid "Allow other users to see the filesystem."
31564 msgstr ""
31565
31566 # type: =item
31567 #. type: =item
31568 #: ../fuse/guestmount.pod:184
31569 msgid "B<-o attr_timeout=N>"
31570 msgstr ""
31571
31572 # type: textblock
31573 #. type: textblock
31574 #: ../fuse/guestmount.pod:186
31575 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
31576 msgstr ""
31577
31578 # type: =item
31579 #. type: =item
31580 #: ../fuse/guestmount.pod:188
31581 msgid "B<-o kernel_cache>"
31582 msgstr ""
31583
31584 # type: textblock
31585 #. type: textblock
31586 #: ../fuse/guestmount.pod:190
31587 msgid ""
31588 "Allow the kernel to cache files (reduces the number of reads that have to go "
31589 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
31590 "afford the extra memory usage."
31591 msgstr ""
31592
31593 # type: =item
31594 #. type: =item
31595 #: ../fuse/guestmount.pod:194
31596 msgid "B<-o uid=N> B<-o gid=N>"
31597 msgstr ""
31598
31599 # type: textblock
31600 #. type: textblock
31601 #: ../fuse/guestmount.pod:196
31602 msgid ""
31603 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
31604 "the chosen values."
31605 msgstr ""
31606
31607 # type: =item
31608 #. type: =item
31609 #: ../fuse/guestmount.pod:201
31610 msgid "B<-r> | B<--ro>"
31611 msgstr ""
31612
31613 # type: textblock
31614 #. type: textblock
31615 #: ../fuse/guestmount.pod:203
31616 msgid ""
31617 "Add devices and mount everything read-only.  Also disallow writes and make "
31618 "the disk appear read-only to FUSE."
31619 msgstr ""
31620
31621 # type: textblock
31622 #. type: textblock
31623 #: ../fuse/guestmount.pod:206
31624 msgid ""
31625 "This is highly recommended if you are not going to edit the guest disk.  If "
31626 "the guest is running and this option is I<not> supplied, then there is a "
31627 "strong risk of disk corruption in the guest.  We try to prevent this from "
31628 "happening, but it is not always possible."
31629 msgstr ""
31630
31631 # type: textblock
31632 #. type: textblock
31633 #: ../fuse/guestmount.pod:211
31634 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
31635 msgstr ""
31636
31637 # type: textblock
31638 #. type: textblock
31639 #: ../fuse/guestmount.pod:215
31640 msgid "Enable SELinux support for the guest."
31641 msgstr ""
31642
31643 # type: =item
31644 #. type: =item
31645 #: ../fuse/guestmount.pod:217
31646 msgid "B<-v> | B<--verbose>"
31647 msgstr ""
31648
31649 # type: textblock
31650 #. type: textblock
31651 #: ../fuse/guestmount.pod:219
31652 msgid "Enable verbose messages from underlying libguestfs."
31653 msgstr ""
31654
31655 # type: =item
31656 #. type: =item
31657 #: ../fuse/guestmount.pod:221
31658 msgid "B<-V> | B<--version>"
31659 msgstr ""
31660
31661 # type: textblock
31662 #. type: textblock
31663 #: ../fuse/guestmount.pod:223
31664 msgid "Display the program version and exit."
31665 msgstr ""
31666
31667 # type: =item
31668 #. type: =item
31669 #: ../fuse/guestmount.pod:225
31670 msgid "B<-w> | B<--rw>"
31671 msgstr ""
31672
31673 # type: textblock
31674 #. type: textblock
31675 #: ../fuse/guestmount.pod:227
31676 msgid ""
31677 "This option does nothing at the moment.  See L<guestfish(1)/OPENING DISKS "
31678 "FOR READ AND WRITE>."
31679 msgstr ""
31680
31681 # type: =item
31682 #. type: =item
31683 #: ../fuse/guestmount.pod:230
31684 msgid "B<-x> | B<--trace>"
31685 msgstr ""
31686
31687 # type: textblock
31688 #. type: textblock
31689 #: ../fuse/guestmount.pod:232
31690 msgid "Trace libguestfs calls and entry into each FUSE function."
31691 msgstr ""
31692
31693 # type: textblock
31694 #. type: textblock
31695 #: ../fuse/guestmount.pod:234
31696 msgid "This also stops the daemon from forking into the background."
31697 msgstr ""
31698
31699 # type: textblock
31700 #. type: textblock
31701 #: ../fuse/guestmount.pod:240
31702 msgid ""
31703 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
31704 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
31705 "net/>."
31706 msgstr ""
31707
31708 # type: textblock
31709 #. type: textblock
31710 #: ../tools/virt-edit.pl:34
31711 msgid "virt-edit - Edit a file in a virtual machine"
31712 msgstr ""
31713
31714 # type: verbatim
31715 #. type: verbatim
31716 #: ../tools/virt-edit.pl:38
31717 #, no-wrap
31718 msgid ""
31719 " virt-edit [--options] domname file\n"
31720 "\n"
31721 msgstr ""
31722
31723 # type: verbatim
31724 #. type: verbatim
31725 #: ../tools/virt-edit.pl:40
31726 #, no-wrap
31727 msgid ""
31728 " virt-edit [--options] disk.img [disk.img ...] file\n"
31729 "\n"
31730 msgstr ""
31731
31732 # type: verbatim
31733 #. type: verbatim
31734 #: ../tools/virt-edit.pl:42
31735 #, no-wrap
31736 msgid ""
31737 " virt-edit [domname|disk.img] file -e 'expr'\n"
31738 "\n"
31739 msgstr ""
31740
31741 # type: textblock
31742 #. type: textblock
31743 #: ../tools/virt-edit.pl:46
31744 msgid ""
31745 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
31746 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
31747 "doing this, but doesn't catch all cases."
31748 msgstr ""
31749
31750 # type: textblock
31751 #. type: textblock
31752 #: ../tools/virt-edit.pl:52
31753 msgid ""
31754 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
31755 "the named virtual machine (or disk image)."
31756 msgstr ""
31757
31758 # type: textblock
31759 #. type: textblock
31760 #: ../tools/virt-edit.pl:55
31761 msgid ""
31762 "If you want to just view a file, use L<virt-cat(1)>.  For more complex cases "
31763 "you should look at the L<guestfish(1)> tool."
31764 msgstr ""
31765
31766 # type: textblock
31767 #. type: textblock
31768 #: ../tools/virt-edit.pl:60
31769 msgid "Edit the named files interactively:"
31770 msgstr ""
31771
31772 # type: verbatim
31773 #. type: verbatim
31774 #: ../tools/virt-edit.pl:62
31775 #, no-wrap
31776 msgid ""
31777 " virt-edit mydomain /boot/grub/grub.conf\n"
31778 "\n"
31779 msgstr ""
31780
31781 # type: verbatim
31782 #. type: verbatim
31783 #: ../tools/virt-edit.pl:64
31784 #, no-wrap
31785 msgid ""
31786 " virt-edit mydomain /etc/passwd\n"
31787 "\n"
31788 msgstr ""
31789
31790 # type: textblock
31791 #. type: textblock
31792 #: ../tools/virt-edit.pl:66
31793 msgid ""
31794 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
31795 "below).  To change the init default level to 5:"
31796 msgstr ""
31797
31798 # type: verbatim
31799 #. type: verbatim
31800 #: ../tools/virt-edit.pl:70
31801 #, no-wrap
31802 msgid ""
31803 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
31804 "\n"
31805 msgstr ""
31806
31807 # type: textblock
31808 #. type: textblock
31809 #: ../tools/virt-edit.pl:82 ../tools/virt-win-reg.pl:106
31810 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113
31811 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
31812 msgid "Display brief help."
31813 msgstr ""
31814
31815 # type: textblock
31816 #. type: textblock
31817 #: ../tools/virt-edit.pl:90 ../tools/virt-win-reg.pl:114
31818 #: ../tools/virt-resize.pl:272 ../tools/virt-list-filesystems.pl:71
31819 #: ../tools/virt-tar.pl:121 ../tools/virt-make-fs.pl:171
31820 #: ../tools/virt-list-partitions.pl:72
31821 msgid "Display version number and exit."
31822 msgstr ""
31823
31824 # type: =item
31825 #. type: =item
31826 #: ../tools/virt-edit.pl:96
31827 msgid "B<--backup extension> | B<-b extension>"
31828 msgstr ""
31829
31830 # type: textblock
31831 #. type: textblock
31832 #: ../tools/virt-edit.pl:98
31833 msgid ""
31834 "Create a backup of the original file I<in the guest disk image>.  The backup "
31835 "has the original filename with C<extension> added."
31836 msgstr ""
31837
31838 # type: textblock
31839 #. type: textblock
31840 #: ../tools/virt-edit.pl:101
31841 msgid ""
31842 "Usually the first character of C<extension> would be a dot C<.> so you would "
31843 "write:"
31844 msgstr ""
31845
31846 # type: verbatim
31847 #. type: verbatim
31848 #: ../tools/virt-edit.pl:104
31849 #, no-wrap
31850 msgid ""
31851 " virt-edit -b .orig [etc]\n"
31852 "\n"
31853 msgstr ""
31854
31855 # type: textblock
31856 #. type: textblock
31857 #: ../tools/virt-edit.pl:106
31858 msgid "By default, no backup file is made."
31859 msgstr ""
31860
31861 # type: =item
31862 #. type: =item
31863 #: ../tools/virt-edit.pl:112 ../tools/virt-win-reg.pl:128
31864 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127
31865 #: ../tools/virt-list-partitions.pl:78
31866 msgid "B<--connect URI> | B<-c URI>"
31867 msgstr ""
31868
31869 # type: textblock
31870 #. type: textblock
31871 #: ../tools/virt-edit.pl:114 ../tools/virt-win-reg.pl:130
31872 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129
31873 #: ../tools/virt-list-partitions.pl:80
31874 msgid ""
31875 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
31876 "to the default libvirt hypervisor."
31877 msgstr ""
31878
31879 # type: textblock
31880 #. type: textblock
31881 #: ../tools/virt-edit.pl:117 ../tools/virt-win-reg.pl:133
31882 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132
31883 #: ../tools/virt-list-partitions.pl:83
31884 msgid ""
31885 "If you specify guest block devices directly, then libvirt is not used at all."
31886 msgstr ""
31887
31888 # type: =item
31889 #. type: =item
31890 #: ../tools/virt-edit.pl:124 ../tools/virt-win-reg.pl:140
31891 #: ../tools/virt-resize.pl:520 ../tools/virt-list-filesystems.pl:89
31892 #: ../tools/virt-tar.pl:139 ../tools/virt-list-partitions.pl:90
31893 msgid "B<--format> raw"
31894 msgstr ""
31895
31896 # type: textblock
31897 #. type: textblock
31898 #: ../tools/virt-edit.pl:126 ../tools/virt-win-reg.pl:142
31899 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141
31900 #: ../tools/virt-list-partitions.pl:92
31901 msgid ""
31902 "Specify the format of disk images given on the command line.  If this is "
31903 "omitted then the format is autodetected from the content of the disk image."
31904 msgstr ""
31905
31906 # type: textblock
31907 #. type: textblock
31908 #: ../tools/virt-edit.pl:130 ../tools/virt-win-reg.pl:146
31909 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145
31910 #: ../tools/virt-list-partitions.pl:96
31911 msgid ""
31912 "If disk images are requested from libvirt, then this program asks libvirt "
31913 "for this information.  In this case, the value of the format parameter is "
31914 "ignored."
31915 msgstr ""
31916
31917 # type: textblock
31918 #. type: textblock
31919 #: ../tools/virt-edit.pl:134 ../tools/virt-win-reg.pl:150
31920 #: ../tools/virt-resize.pl:525 ../tools/virt-resize.pl:540
31921 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149
31922 #: ../tools/virt-list-partitions.pl:100
31923 msgid ""
31924 "If working with untrusted raw-format guest disk images, you should ensure "
31925 "the format is always specified."
31926 msgstr ""
31927
31928 # type: =item
31929 #. type: =item
31930 #: ../tools/virt-edit.pl:141
31931 msgid "B<--expr EXPR> | B<-e EXPR>"
31932 msgstr ""
31933
31934 # type: textblock
31935 #. type: textblock
31936 #: ../tools/virt-edit.pl:143
31937 msgid ""
31938 "Instead of launching the external editor, non-interactively apply the Perl "
31939 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
31940 "EDITING> below."
31941 msgstr ""
31942
31943 # type: textblock
31944 #. type: textblock
31945 #: ../tools/virt-edit.pl:147
31946 msgid ""
31947 "Be careful to properly quote the expression to prevent it from being altered "
31948 "by the shell."
31949 msgstr ""
31950
31951 # type: =head1
31952 #. type: =head1
31953 #: ../tools/virt-edit.pl:268
31954 msgid "NON-INTERACTIVE EDITING"
31955 msgstr ""
31956
31957 # type: textblock
31958 #. type: textblock
31959 #: ../tools/virt-edit.pl:270
31960 msgid ""
31961 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
31962 "administrator can interactively edit the file."
31963 msgstr ""
31964
31965 # type: textblock
31966 #. type: textblock
31967 #: ../tools/virt-edit.pl:273
31968 msgid ""
31969 "There are two ways also to use C<virt-edit> from scripts in order to make "
31970 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
31971 "like this, it's less error-prone to write scripts directly using the "
31972 "libguestfs API and Augeas for configuration file editing.)"
31973 msgstr ""
31974
31975 # type: textblock
31976 #. type: textblock
31977 #: ../tools/virt-edit.pl:279
31978 msgid ""
31979 "The first method is to temporarily set C<$EDITOR> to any script or program "
31980 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
31981 "update C<tmpfile> in place however it likes."
31982 msgstr ""
31983
31984 # type: textblock
31985 #. type: textblock
31986 #: ../tools/virt-edit.pl:283
31987 msgid ""
31988 "The second method is to use the C<-e> parameter of C<virt-edit> to run a "
31989 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
31990 "instances of C<foo> with C<bar> in a file:"
31991 msgstr ""
31992
31993 # type: verbatim
31994 #. type: verbatim
31995 #: ../tools/virt-edit.pl:287
31996 #, no-wrap
31997 msgid ""
31998 " virt-edit domname filename -e 's/foo/bar/'\n"
31999 "\n"
32000 msgstr ""
32001
32002 # type: textblock
32003 #. type: textblock
32004 #: ../tools/virt-edit.pl:289
32005 msgid ""
32006 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
32007 "For example to delete root's password you could do:"
32008 msgstr ""
32009
32010 # type: verbatim
32011 #. type: verbatim
32012 #: ../tools/virt-edit.pl:292
32013 #, no-wrap
32014 msgid ""
32015 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
32016 "\n"
32017 msgstr ""
32018
32019 # type: textblock
32020 #. type: textblock
32021 #: ../tools/virt-edit.pl:294
32022 msgid ""
32023 "What really happens is that the snippet is evaluated as a Perl expression "
32024 "for each line of the file.  The line, including the final C<\\n>, is passed "
32025 "in C<$_> and the expression should update C<$_> or leave it unchanged."
32026 msgstr ""
32027
32028 # type: textblock
32029 #. type: textblock
32030 #: ../tools/virt-edit.pl:299
32031 msgid ""
32032 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
32033 "C<apache> user account from the password file you can do:"
32034 msgstr ""
32035
32036 # type: verbatim
32037 #. type: verbatim
32038 #: ../tools/virt-edit.pl:302
32039 #, no-wrap
32040 msgid ""
32041 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
32042 "\n"
32043 msgstr ""
32044
32045 # type: textblock
32046 #. type: textblock
32047 #: ../tools/virt-edit.pl:304
32048 msgid ""
32049 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
32050 "the end of the file is rather difficult this way since there is no concept "
32051 "of \"last line of the file\" - your expression just doesn't get called "
32052 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
32053 "want to do this."
32054 msgstr ""
32055
32056 # type: textblock
32057 #. type: textblock
32058 #: ../tools/virt-edit.pl:310
32059 msgid ""
32060 "The variable C<$lineno> contains the current line number.  As is "
32061 "traditional, the first line in the file is number C<1>."
32062 msgstr ""
32063
32064 # type: textblock
32065 #. type: textblock
32066 #: ../tools/virt-edit.pl:313
32067 msgid ""
32068 "The return value from the expression is ignored, but the expression may call "
32069 "C<die> in order to abort the whole program, leaving the original file "
32070 "untouched."
32071 msgstr ""
32072
32073 # type: textblock
32074 #. type: textblock
32075 #: ../tools/virt-edit.pl:317
32076 msgid ""
32077 "Remember when matching the end of a line that C<$_> may contain the final C<"
32078 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
32079 "newline then neither of these.  Thus to match or substitute some text at the "
32080 "end of a line, use this regular expression:"
32081 msgstr ""
32082
32083 # type: verbatim
32084 #. type: verbatim
32085 #: ../tools/virt-edit.pl:322
32086 #, no-wrap
32087 msgid ""
32088 " /some text(\\r?\\n)?$/\n"
32089 "\n"
32090 msgstr ""
32091
32092 # type: textblock
32093 #. type: textblock
32094 #: ../tools/virt-edit.pl:324
32095 msgid ""
32096 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
32097 "$_> itself (since that would remove all newlines from the file):"
32098 msgstr ""
32099
32100 # type: verbatim
32101 #. type: verbatim
32102 #: ../tools/virt-edit.pl:328
32103 #, no-wrap
32104 msgid ""
32105 " my $m = $_; chomp $m; $m =~ /some text$/\n"
32106 "\n"
32107 msgstr ""
32108
32109 # type: =item
32110 #. type: =item
32111 #: ../tools/virt-edit.pl:334
32112 msgid "C<EDITOR>"
32113 msgstr ""
32114
32115 # type: textblock
32116 #. type: textblock
32117 #: ../tools/virt-edit.pl:336
32118 msgid ""
32119 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
32120 "\"emacs -nw\">"
32121 msgstr ""
32122
32123 # type: textblock
32124 #. type: textblock
32125 #: ../tools/virt-edit.pl:339
32126 msgid "If not set, C<vi> is used."
32127 msgstr ""
32128
32129 # type: =head2
32130 #. type: =head1
32131 #: ../tools/virt-edit.pl:343 ../tools/virt-win-reg.pl:559
32132 #: ../tools/virt-resize.pl:1476 ../tools/virt-list-filesystems.pl:182
32133 #: ../tools/virt-tar.pl:279 ../tools/virt-make-fs.pl:527
32134 #: ../tools/virt-list-partitions.pl:250
32135 msgid "SHELL QUOTING"
32136 msgstr ""
32137
32138 # type: textblock
32139 #. type: textblock
32140 #: ../tools/virt-edit.pl:345 ../tools/virt-win-reg.pl:567
32141 #: ../tools/virt-resize.pl:1478 ../tools/virt-list-filesystems.pl:184
32142 #: ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:529
32143 #: ../tools/virt-list-partitions.pl:252
32144 msgid ""
32145 "Libvirt guest names can contain arbitrary characters, some of which have "
32146 "meaning to the shell such as C<#> and space.  You may need to quote or "
32147 "escape these characters on the command line.  See the shell manual page L<sh"
32148 "(1)> for details."
32149 msgstr ""
32150
32151 #. type: textblock
32152 #: ../tools/virt-edit.pl:352
32153 msgid ""
32154 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
32155 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
32156 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
32157 msgstr ""
32158
32159 # type: =head1
32160 #. type: =head1
32161 #: ../tools/virt-edit.pl:364 ../tools/virt-win-reg.pl:598
32162 #: ../tools/virt-resize.pl:1504 ../tools/virt-list-filesystems.pl:202
32163 #: ../tools/virt-tar.pl:301 ../tools/virt-make-fs.pl:559
32164 #: ../tools/virt-list-partitions.pl:269
32165 msgid "AUTHOR"
32166 msgstr ""
32167
32168 # type: textblock
32169 #. type: textblock
32170 #: ../tools/virt-edit.pl:366 ../tools/virt-win-reg.pl:600
32171 #: ../tools/virt-resize.pl:1506 ../tools/virt-list-filesystems.pl:204
32172 #: ../tools/virt-tar.pl:303 ../tools/virt-make-fs.pl:561
32173 #: ../tools/virt-list-partitions.pl:271
32174 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
32175 msgstr ""
32176
32177 # type: textblock
32178 #. type: textblock
32179 #: ../tools/virt-edit.pl:370 ../tools/virt-list-partitions.pl:275
32180 msgid "Copyright (C) 2009-2010 Red Hat Inc."
32181 msgstr ""
32182
32183 # type: textblock
32184 #. type: textblock
32185 #: ../tools/virt-win-reg.pl:37
32186 msgid ""
32187 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
32188 msgstr ""
32189
32190 # type: verbatim
32191 #. type: verbatim
32192 #: ../tools/virt-win-reg.pl:41
32193 #, no-wrap
32194 msgid ""
32195 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
32196 "\n"
32197 msgstr ""
32198
32199 # type: verbatim
32200 #. type: verbatim
32201 #: ../tools/virt-win-reg.pl:43
32202 #, no-wrap
32203 msgid ""
32204 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
32205 "\n"
32206 msgstr ""
32207
32208 # type: verbatim
32209 #. type: verbatim
32210 #: ../tools/virt-win-reg.pl:45
32211 #, no-wrap
32212 msgid ""
32213 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
32214 "\n"
32215 msgstr ""
32216
32217 # type: verbatim
32218 #. type: verbatim
32219 #: ../tools/virt-win-reg.pl:47
32220 #, no-wrap
32221 msgid ""
32222 " virt-win-reg --merge domname [input.reg ...]\n"
32223 "\n"
32224 msgstr ""
32225
32226 # type: verbatim
32227 #. type: verbatim
32228 #: ../tools/virt-win-reg.pl:49
32229 #, no-wrap
32230 msgid ""
32231 " virt-win-reg [--options] disk.img ... # instead of domname\n"
32232 "\n"
32233 msgstr ""
32234
32235 # type: textblock
32236 #. type: textblock
32237 #: ../tools/virt-win-reg.pl:53
32238 msgid ""
32239 "You must I<not> use C<virt-win-reg> with the C<--merge> option on live "
32240 "virtual machines.  If you do this, you I<will> get irreversible disk "
32241 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
32242 "but doesn't catch all cases."
32243 msgstr ""
32244
32245 # type: textblock
32246 #. type: textblock
32247 #: ../tools/virt-win-reg.pl:58
32248 msgid ""
32249 "Modifying the Windows Registry is an inherently risky operation.  The format "
32250 "is deliberately obscure and undocumented, and Registry changes can leave the "
32251 "system unbootable.  Therefore when using the C<--merge> option, make sure "
32252 "you have a reliable backup first."
32253 msgstr ""
32254
32255 # type: textblock
32256 #. type: textblock
32257 #: ../tools/virt-win-reg.pl:65
32258 msgid ""
32259 "This program can export and merge Windows Registry entries from a Windows "
32260 "guest."
32261 msgstr ""
32262
32263 # type: textblock
32264 #. type: textblock
32265 #: ../tools/virt-win-reg.pl:68
32266 msgid ""
32267 "The first parameter is the libvirt guest name or the raw disk image of a "
32268 "Windows guest."
32269 msgstr ""
32270
32271 # type: textblock
32272 #. type: textblock
32273 #: ../tools/virt-win-reg.pl:71
32274 msgid ""
32275 "If C<--merge> is I<not> specified, then the chosen registry key is displayed/"
32276 "exported (recursively).  For example:"
32277 msgstr ""
32278
32279 # type: verbatim
32280 #. type: verbatim
32281 #: ../tools/virt-win-reg.pl:74
32282 #, no-wrap
32283 msgid ""
32284 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
32285 "\n"
32286 msgstr ""
32287
32288 # type: textblock
32289 #. type: textblock
32290 #: ../tools/virt-win-reg.pl:76
32291 msgid ""
32292 "You can also display single values from within registry keys, for example:"
32293 msgstr ""
32294
32295 # type: verbatim
32296 #. type: verbatim
32297 #: ../tools/virt-win-reg.pl:79
32298 #, no-wrap
32299 msgid ""
32300 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
32301 " $ virt-win-reg Windows7 $cvkey ProductName\n"
32302 " Windows 7 Enterprise\n"
32303 "\n"
32304 msgstr ""
32305
32306 # type: textblock
32307 #. type: textblock
32308 #: ../tools/virt-win-reg.pl:83
32309 msgid ""
32310 "With C<--merge>, you can merge a textual regedit file into the Windows "
32311 "Registry:"
32312 msgstr ""
32313
32314 # type: verbatim
32315 #. type: verbatim
32316 #: ../tools/virt-win-reg.pl:86
32317 #, no-wrap
32318 msgid ""
32319 " $ virt-win-reg --merge Windows7 changes.reg\n"
32320 "\n"
32321 msgstr ""
32322
32323 # type: =head2
32324 #. type: =head1
32325 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
32326 msgid "NOTE"
32327 msgstr ""
32328
32329 # type: textblock
32330 #. type: textblock
32331 #: ../tools/virt-win-reg.pl:90
32332 msgid ""
32333 "This program is only meant for simple access to the registry.  If you want "
32334 "to do complicated things with the registry, we suggest you download the "
32335 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
32336 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
32337 "L<hivexregedit(1)>."
32338 msgstr ""
32339
32340 # type: =item
32341 #. type: =item
32342 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
32343 msgid "B<--debug>"
32344 msgstr ""
32345
32346 # type: textblock
32347 #. type: textblock
32348 #: ../tools/virt-win-reg.pl:122 ../tools/virt-resize.pl:498
32349 msgid "Enable debugging messages."
32350 msgstr ""
32351
32352 # type: =item
32353 #. type: =item
32354 #: ../tools/virt-win-reg.pl:157
32355 msgid "B<--merge>"
32356 msgstr ""
32357
32358 # type: textblock
32359 #. type: textblock
32360 #: ../tools/virt-win-reg.pl:159
32361 msgid ""
32362 "In merge mode, this merges a textual regedit file into the Windows Registry "
32363 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
32364 "displays or exports Registry entries instead."
32365 msgstr ""
32366
32367 # type: textblock
32368 #. type: textblock
32369 #: ../tools/virt-win-reg.pl:163
32370 msgid ""
32371 "Note that C<--merge> is I<unsafe> to use on live virtual machines, and will "
32372 "result in disk corruption.  However exporting (without this flag)  is always "
32373 "safe."
32374 msgstr ""
32375
32376 # type: =item
32377 #. type: =item
32378 #: ../tools/virt-win-reg.pl:171
32379 msgid "B<--encoding> UTF-16LE|ASCII"
32380 msgstr ""
32381
32382 # type: textblock
32383 #. type: textblock
32384 #: ../tools/virt-win-reg.pl:173
32385 msgid ""
32386 "When merging (only), you may need to specify the encoding for strings to be "
32387 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
32388 "(3)/ENCODING STRINGS>."
32389 msgstr ""
32390
32391 # type: textblock
32392 #. type: textblock
32393 #: ../tools/virt-win-reg.pl:177
32394 msgid ""
32395 "The default is to use UTF-16LE, which should work with recent versions of "
32396 "Windows."
32397 msgstr ""
32398
32399 # type: =head2
32400 #. type: =head1
32401 #: ../tools/virt-win-reg.pl:402
32402 msgid "SUPPORTED SYSTEMS"
32403 msgstr ""
32404
32405 # type: textblock
32406 #. type: textblock
32407 #: ../tools/virt-win-reg.pl:404
32408 msgid ""
32409 "The program currently supports Windows NT-derived guests starting with "
32410 "Windows XP through to at least Windows 7."
32411 msgstr ""
32412
32413 # type: textblock
32414 #. type: textblock
32415 #: ../tools/virt-win-reg.pl:407
32416 msgid ""
32417 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
32418 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
32419 "and C<HKEY_USERS\\.DEFAULT>."
32420 msgstr ""
32421
32422 # type: textblock
32423 #. type: textblock
32424 #: ../tools/virt-win-reg.pl:411
32425 msgid ""
32426 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
32427 "C<HKEY_USERS>."
32428 msgstr ""
32429
32430 # type: textblock
32431 #. type: textblock
32432 #: ../tools/virt-win-reg.pl:414
32433 msgid ""
32434 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
32435 "time."
32436 msgstr ""
32437
32438 # type: =head2
32439 #. type: =head1
32440 #: ../tools/virt-win-reg.pl:417
32441 msgid "ENCODING"
32442 msgstr ""
32443
32444 # type: textblock
32445 #. type: textblock
32446 #: ../tools/virt-win-reg.pl:419
32447 msgid ""
32448 "C<virt-win-reg> expects that regedit files have already been reencoded in "
32449 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
32450 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
32451 "Windows-style line endings, you may need to reencode the whole file before "
32452 "or after processing."
32453 msgstr ""
32454
32455 # type: textblock
32456 #. type: textblock
32457 #: ../tools/virt-win-reg.pl:425
32458 msgid ""
32459 "To reencode a file from Windows format to Linux (before processing it with "
32460 "the C<--merge> option), you would do something like this:"
32461 msgstr ""
32462
32463 # type: verbatim
32464 #. type: verbatim
32465 #: ../tools/virt-win-reg.pl:428
32466 #, no-wrap
32467 msgid ""
32468 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
32469 "\n"
32470 msgstr ""
32471
32472 # type: textblock
32473 #. type: textblock
32474 #: ../tools/virt-win-reg.pl:430
32475 msgid ""
32476 "To go in the opposite direction, after exporting and before sending the file "
32477 "to a Windows user, do something like this:"
32478 msgstr ""
32479
32480 # type: verbatim
32481 #. type: verbatim
32482 #: ../tools/virt-win-reg.pl:433
32483 #, no-wrap
32484 msgid ""
32485 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
32486 "\n"
32487 msgstr ""
32488
32489 # type: textblock
32490 #. type: textblock
32491 #: ../tools/virt-win-reg.pl:435
32492 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
32493 msgstr ""
32494
32495 # type: textblock
32496 #. type: textblock
32497 #: ../tools/virt-win-reg.pl:437
32498 msgid ""
32499 "If you are unsure about the current encoding, use the L<file(1)> command.  "
32500 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
32501 "style (CRLF) line endings, like this:"
32502 msgstr ""
32503
32504 # type: verbatim
32505 #. type: verbatim
32506 #: ../tools/virt-win-reg.pl:441
32507 #, no-wrap
32508 msgid ""
32509 " $ file software.reg\n"
32510 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
32511 " with CRLF line terminators\n"
32512 "\n"
32513 msgstr ""
32514
32515 # type: textblock
32516 #. type: textblock
32517 #: ../tools/virt-win-reg.pl:445
32518 msgid "This file would need conversion before you could C<--merge> it."
32519 msgstr ""
32520
32521 # type: =head2
32522 #. type: =head1
32523 #: ../tools/virt-win-reg.pl:447
32524 msgid "CurrentControlSet etc."
32525 msgstr ""
32526
32527 # type: textblock
32528 #. type: textblock
32529 #: ../tools/virt-win-reg.pl:449
32530 msgid ""
32531 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
32532 "Registry at the level of the hive file, and therefore you cannot modify "
32533 "these."
32534 msgstr ""
32535
32536 # type: textblock
32537 #. type: textblock
32538 #: ../tools/virt-win-reg.pl:453
32539 msgid ""
32540 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
32541 "circumstances it might refer to another control set.  The way to find out is "
32542 "to look at the C<HKLM\\SYSTEM\\Select> key:"
32543 msgstr ""
32544
32545 # type: verbatim
32546 #. type: verbatim
32547 #: ../tools/virt-win-reg.pl:457
32548 #, no-wrap
32549 msgid ""
32550 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
32551 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
32552 " \"Current\"=dword:00000001\n"
32553 " \"Default\"=dword:00000001\n"
32554 " \"Failed\"=dword:00000000\n"
32555 " \"LastKnownGood\"=dword:00000002\n"
32556 "\n"
32557 msgstr ""
32558
32559 # type: textblock
32560 #. type: textblock
32561 #: ../tools/virt-win-reg.pl:464
32562 msgid "\"Current\" is the one which Windows will choose when it boots."
32563 msgstr ""
32564
32565 # type: textblock
32566 #. type: textblock
32567 #: ../tools/virt-win-reg.pl:466
32568 msgid ""
32569 "Similarly, other C<Current...> keys in the path may need to be replaced."
32570 msgstr ""
32571
32572 # type: =head1
32573 #. type: =head1
32574 #: ../tools/virt-win-reg.pl:469
32575 msgid "WINDOWS TIPS"
32576 msgstr ""
32577
32578 # type: textblock
32579 #. type: textblock
32580 #: ../tools/virt-win-reg.pl:471
32581 msgid ""
32582 "Note that some of these tips modify the guest disk image.  The guest I<must> "
32583 "be shut off, else you will get disk corruption."
32584 msgstr ""
32585
32586 # type: =head2
32587 #. type: =head2
32588 #: ../tools/virt-win-reg.pl:474
32589 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
32590 msgstr ""
32591
32592 # type: textblock
32593 #. type: textblock
32594 #: ../tools/virt-win-reg.pl:476
32595 msgid ""
32596 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
32597 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
32598 "is uploaded into C<C:\\>:"
32599 msgstr ""
32600
32601 # type: verbatim
32602 #. type: verbatim
32603 #: ../tools/virt-win-reg.pl:480
32604 #, no-wrap
32605 msgid ""
32606 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
32607 "\n"
32608 msgstr ""
32609
32610 # type: textblock
32611 #. type: textblock
32612 #: ../tools/virt-win-reg.pl:482
32613 msgid "Prepare a regedit file containing the registry change:"
32614 msgstr ""
32615
32616 # type: verbatim
32617 #. type: verbatim
32618 #: ../tools/virt-win-reg.pl:484
32619 #, no-wrap
32620 msgid ""
32621 " cat > test.reg <<'EOF'\n"
32622 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
32623 " \"Test\"=\"c:\\\\test.bat\"\n"
32624 " EOF\n"
32625 "\n"
32626 msgstr ""
32627
32628 # type: textblock
32629 #. type: textblock
32630 #: ../tools/virt-win-reg.pl:489
32631 msgid ""
32632 "In this example we use the key C<RunOnce> which means that the script will "
32633 "run precisely once when the first user logs in.  If you want it to run every "
32634 "time a user logs in, replace C<RunOnce> with C<Run>."
32635 msgstr ""
32636
32637 # type: textblock
32638 #. type: textblock
32639 #: ../tools/virt-win-reg.pl:493
32640 msgid "Now update the registry:"
32641 msgstr ""
32642
32643 # type: verbatim
32644 #. type: verbatim
32645 #: ../tools/virt-win-reg.pl:495
32646 #, no-wrap
32647 msgid ""
32648 " virt-win-reg --merge WindowsGuest test.reg\n"
32649 "\n"
32650 msgstr ""
32651
32652 # type: =head2
32653 #. type: =head2
32654 #: ../tools/virt-win-reg.pl:497
32655 msgid "INSTALLING A SERVICE"
32656 msgstr ""
32657
32658 # type: textblock
32659 #. type: textblock
32660 #: ../tools/virt-win-reg.pl:499
32661 msgid ""
32662 "This section assumes you are familiar with Windows services, and you either "
32663 "have a program which handles the Windows Service Control Protocol directly "
32664 "or you want to run any program using a service wrapper like SrvAny or the "
32665 "free RHSrvAny."
32666 msgstr ""
32667
32668 # type: textblock
32669 #. type: textblock
32670 #: ../tools/virt-win-reg.pl:504
32671 msgid ""
32672 "First upload the program and optionally the service wrapper.  In this case "
32673 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
32674 msgstr ""
32675
32676 # type: verbatim
32677 #. type: verbatim
32678 #: ../tools/virt-win-reg.pl:508
32679 #, no-wrap
32680 msgid ""
32681 " guestfish -i -d WindowsGuest <<EOF\n"
32682 "   upload rhsrvany.exe /rhsrvany.exe\n"
32683 "   upload test.exe /test.exe\n"
32684 " EOF\n"
32685 "\n"
32686 msgstr ""
32687
32688 # type: textblock
32689 #. type: textblock
32690 #: ../tools/virt-win-reg.pl:513
32691 msgid ""
32692 "Prepare a regedit file containing the registry changes.  In this example, "
32693 "the first registry change is needed for the service itself or the service "
32694 "wrapper (if used).  The second registry change is only needed because I am "
32695 "using the RHSrvAny service wrapper."
32696 msgstr ""
32697
32698 # type: verbatim
32699 #. type: verbatim
32700 #: ../tools/virt-win-reg.pl:518
32701 #, no-wrap
32702 msgid ""
32703 " cat > service.reg <<'EOF'\n"
32704 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
32705 " \"Type\"=dword:00000010\n"
32706 " \"Start\"=dword:00000002\n"
32707 " \"ErrorControl\"=dword:00000001\n"
32708 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
32709 " \"DisplayName\"=\"RHSrvAny\"\n"
32710 " \"ObjectName\"=\"NetworkService\"\n"
32711 " \n"
32712 msgstr ""
32713
32714 # type: verbatim
32715 #. type: verbatim
32716 #: ../tools/virt-win-reg.pl:527
32717 #, no-wrap
32718 msgid ""
32719 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
32720 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
32721 " \"PWD\"=\"c:\\\\Temp\"\n"
32722 " EOF\n"
32723 "\n"
32724 msgstr ""
32725
32726 # type: textblock
32727 #. type: textblock
32728 #: ../tools/virt-win-reg.pl:538
32729 msgid ""
32730 "For use of C<ControlSet001> see the section above in this manual page.  You "
32731 "may need to adjust this according to the control set that is in use by the "
32732 "guest."
32733 msgstr ""
32734
32735 # type: textblock
32736 #. type: textblock
32737 #: ../tools/virt-win-reg.pl:544
32738 msgid ""
32739 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
32740 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
32741 "privileged account."
32742 msgstr ""
32743
32744 # type: textblock
32745 #. type: textblock
32746 #: ../tools/virt-win-reg.pl:550
32747 msgid ""
32748 "For the meaning of the magic numbers, see this Microsoft KB article: "
32749 "L<http://support.microsoft.com/kb/103000>."
32750 msgstr ""
32751
32752 # type: textblock
32753 #. type: textblock
32754 #: ../tools/virt-win-reg.pl:555
32755 msgid "Update the registry:"
32756 msgstr ""
32757
32758 # type: verbatim
32759 #. type: verbatim
32760 #: ../tools/virt-win-reg.pl:557
32761 #, no-wrap
32762 msgid ""
32763 " virt-win-reg --merge WindowsGuest service.reg\n"
32764 "\n"
32765 msgstr ""
32766
32767 # type: textblock
32768 #. type: textblock
32769 #: ../tools/virt-win-reg.pl:561
32770 msgid ""
32771 "Be careful when passing parameters containing C<\\> (backslash) in the "
32772 "shell.  Usually you will have to use 'single quotes' or double backslashes "
32773 "(but not both) to protect them from the shell."
32774 msgstr ""
32775
32776 # type: textblock
32777 #. type: textblock
32778 #: ../tools/virt-win-reg.pl:565
32779 msgid "Paths and value names are case-insensitive."
32780 msgstr ""
32781
32782 # type: textblock
32783 #. type: textblock
32784 #: ../tools/virt-win-reg.pl:574
32785 msgid ""
32786 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
32787 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
32788 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
32789 msgstr ""
32790
32791 # type: textblock
32792 #. type: textblock
32793 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:550
32794 msgid ""
32795 "When reporting bugs, please enable debugging and capture the I<complete> "
32796 "output:"
32797 msgstr ""
32798
32799 # type: verbatim
32800 #. type: verbatim
32801 #: ../tools/virt-win-reg.pl:592
32802 #, no-wrap
32803 msgid ""
32804 " export LIBGUESTFS_DEBUG=1\n"
32805 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
32806 "\n"
32807 msgstr ""
32808
32809 # type: textblock
32810 #. type: textblock
32811 #: ../tools/virt-win-reg.pl:595
32812 msgid ""
32813 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
32814 "redhat.com/>"
32815 msgstr ""
32816
32817 # type: textblock
32818 #. type: textblock
32819 #: ../tools/virt-win-reg.pl:604 ../tools/virt-resize.pl:1510
32820 #: ../tools/virt-make-fs.pl:565
32821 msgid "Copyright (C) 2010 Red Hat Inc."
32822 msgstr ""
32823
32824 # type: textblock
32825 #. type: textblock
32826 #: ../tools/virt-resize.pl:42
32827 msgid "virt-resize - Resize a virtual machine disk"
32828 msgstr ""
32829
32830 # type: verbatim
32831 #. type: verbatim
32832 #: ../tools/virt-resize.pl:46
32833 #, no-wrap
32834 msgid ""
32835 " virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
32836 "   [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
32837 "   [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
32838 "\n"
32839 msgstr ""
32840
32841 # type: textblock
32842 #. type: textblock
32843 #: ../tools/virt-resize.pl:52
32844 msgid ""
32845 "Virt-resize is a tool which can resize a virtual machine disk, making it "
32846 "larger or smaller overall, and resizing or deleting any partitions contained "
32847 "within."
32848 msgstr ""
32849
32850 # type: textblock
32851 #. type: textblock
32852 #: ../tools/virt-resize.pl:56
32853 msgid ""
32854 "Virt-resize B<cannot> resize disk images in-place.  Virt-resize B<should "
32855 "not> be used on live virtual machines - for consistent results, shut the "
32856 "virtual machine down before resizing it."
32857 msgstr ""
32858
32859 # type: textblock
32860 #. type: textblock
32861 #: ../tools/virt-resize.pl:60
32862 msgid ""
32863 "If you are not familiar with the associated tools: L<virt-filesystems(1)> "
32864 "and L<virt-df(1)>, we recommend you go and read those manual pages first."
32865 msgstr ""
32866
32867 # type: textblock
32868 #. type: textblock
32869 #: ../tools/virt-resize.pl:66
32870 msgid ""
32871 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
32872 "fill the extra 5GB of space."
32873 msgstr ""
32874
32875 #. type: verbatim
32876 #: ../tools/virt-resize.pl:69
32877 #, no-wrap
32878 msgid ""
32879 " truncate -r olddisk newdisk; truncate -s +5G newdisk\n"
32880 " virt-filesystems --long -h --all -a olddisk\n"
32881 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
32882 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
32883 "\n"
32884 msgstr ""
32885
32886 # type: textblock
32887 #. type: textblock
32888 #: ../tools/virt-resize.pl:74
32889 msgid ""
32890 "As above, but make the /boot partition 200MB bigger, while giving the "
32891 "remaining space to /dev/sda2:"
32892 msgstr ""
32893
32894 # type: verbatim
32895 #. type: verbatim
32896 #: ../tools/virt-resize.pl:77
32897 #, no-wrap
32898 msgid ""
32899 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 olddisk newdisk\n"
32900 "\n"
32901 msgstr ""
32902
32903 # type: textblock
32904 #. type: textblock
32905 #: ../tools/virt-resize.pl:79
32906 msgid "As above, but the output format will be uncompressed qcow2:"
32907 msgstr ""
32908
32909 # type: verbatim
32910 #. type: verbatim
32911 #: ../tools/virt-resize.pl:81
32912 #, no-wrap
32913 msgid ""
32914 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
32915 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
32916 "\n"
32917 msgstr ""
32918
32919 # type: =head1
32920 #. type: =head1
32921 #: ../tools/virt-resize.pl:84
32922 msgid "DETAILED USAGE"
32923 msgstr ""
32924
32925 # type: =head2
32926 #. type: =head2
32927 #: ../tools/virt-resize.pl:86
32928 msgid "EXPANDING A VIRTUAL MACHINE DISK"
32929 msgstr ""
32930
32931 # type: =item
32932 #. type: =item
32933 #: ../tools/virt-resize.pl:90
32934 msgid "1. Shut down the virtual machine"
32935 msgstr ""
32936
32937 # type: =item
32938 #. type: =item
32939 #: ../tools/virt-resize.pl:92
32940 msgid "2. Locate input disk image"
32941 msgstr ""
32942
32943 # type: textblock
32944 #. type: textblock
32945 #: ../tools/virt-resize.pl:94
32946 msgid ""
32947 "Locate the input disk image (ie. the file or device on the host containing "
32948 "the guest's disk).  If the guest is managed by libvirt, you can use C<virsh "
32949 "dumpxml> like this to find the disk image name:"
32950 msgstr ""
32951
32952 # type: verbatim
32953 #. type: verbatim
32954 #: ../tools/virt-resize.pl:98
32955 #, no-wrap
32956 msgid ""
32957 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
32958 " Found 1 nodes:\n"
32959 " -- NODE --\n"
32960 " <source dev=\"/dev/vg/lv_guest\" />\n"
32961 "\n"
32962 msgstr ""
32963
32964 # type: =item
32965 #. type: =item
32966 #: ../tools/virt-resize.pl:103
32967 msgid "3. Look at current sizing"
32968 msgstr ""
32969
32970 # type: textblock
32971 #. type: textblock
32972 #: ../tools/virt-resize.pl:105
32973 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
32974 msgstr ""
32975
32976 # type: verbatim
32977 #. type: verbatim
32978 #: ../tools/virt-resize.pl:108
32979 #, no-wrap
32980 msgid ""
32981 " # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
32982 " Name       Type       Size  Parent\n"
32983 " /dev/sda1  partition  101M  /dev/sda\n"
32984 " /dev/sda2  partition  7.9G  /dev/sda\n"
32985 " /dev/sda   device     8.0G  -\n"
32986 "\n"
32987 msgstr ""
32988
32989 # type: textblock
32990 #. type: textblock
32991 #: ../tools/virt-resize.pl:114
32992 msgid ""
32993 "(This example is a virtual machine with an 8 GB disk which we would like to "
32994 "expand up to 10 GB)."
32995 msgstr ""
32996
32997 # type: =item
32998 #. type: =item
32999 #: ../tools/virt-resize.pl:117
33000 msgid "4. Create output disk"
33001 msgstr ""
33002
33003 # type: textblock
33004 #. type: textblock
33005 #: ../tools/virt-resize.pl:119
33006 msgid ""
33007 "Virt-resize cannot do in-place disk modifications.  You have to have space "
33008 "to store the resized output disk."
33009 msgstr ""
33010
33011 # type: textblock
33012 #. type: textblock
33013 #: ../tools/virt-resize.pl:122
33014 msgid ""
33015 "To store the resized disk image in a file, create a file of a suitable size:"
33016 msgstr ""
33017
33018 # type: verbatim
33019 #. type: verbatim
33020 #: ../tools/virt-resize.pl:125
33021 #, no-wrap
33022 msgid ""
33023 " # rm -f outdisk\n"
33024 " # truncate -s 10G outdisk\n"
33025 "\n"
33026 msgstr ""
33027
33028 # type: textblock
33029 #. type: textblock
33030 #: ../tools/virt-resize.pl:128
33031 msgid "Or use L<lvcreate(1)> to create a logical volume:"
33032 msgstr ""
33033
33034 # type: verbatim
33035 #. type: verbatim
33036 #: ../tools/virt-resize.pl:130
33037 #, no-wrap
33038 msgid ""
33039 " # lvcreate -L 10G -n lv_name vg_name\n"
33040 "\n"
33041 msgstr ""
33042
33043 # type: textblock
33044 #. type: textblock
33045 #: ../tools/virt-resize.pl:132
33046 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
33047 msgstr ""
33048
33049 # type: verbatim
33050 #. type: verbatim
33051 #: ../tools/virt-resize.pl:134
33052 #, no-wrap
33053 msgid ""
33054 " # virsh pool-list\n"
33055 " # virsh vol-create-as poolname newvol 10G\n"
33056 "\n"
33057 msgstr ""
33058
33059 # type: =item
33060 #. type: =item
33061 #: ../tools/virt-resize.pl:137
33062 msgid "5. Resize"
33063 msgstr ""
33064
33065 # type: textblock
33066 #. type: textblock
33067 #: ../tools/virt-resize.pl:139
33068 msgid ""
33069 "virt-resize takes two mandatory parameters, the input disk (eg. device or "
33070 "file) and the output disk.  The output disk is the one created in the "
33071 "previous step."
33072 msgstr ""
33073
33074 # type: verbatim
33075 #. type: verbatim
33076 #: ../tools/virt-resize.pl:143
33077 #, no-wrap
33078 msgid ""
33079 " # virt-resize indisk outdisk\n"
33080 "\n"
33081 msgstr ""
33082
33083 # type: textblock
33084 #. type: textblock
33085 #: ../tools/virt-resize.pl:145
33086 msgid ""
33087 "This command just copies disk image C<indisk> to disk image C<outdisk> "
33088 "I<without> resizing or changing any existing partitions.  If C<outdisk> is "
33089 "larger, then an extra, empty partition is created at the end of the disk "
33090 "covering the extra space.  If C<outdisk> is smaller, then it will give an "
33091 "error."
33092 msgstr ""
33093
33094 # type: textblock
33095 #. type: textblock
33096 #: ../tools/virt-resize.pl:151
33097 msgid ""
33098 "More realistically you'd want to expand existing partitions in the disk "
33099 "image by passing extra options (for the full list see the L</OPTIONS> "
33100 "section below)."
33101 msgstr ""
33102
33103 # type: textblock
33104 #. type: textblock
33105 #: ../tools/virt-resize.pl:155
33106 msgid ""
33107 "L</--expand> is the most useful option.  It expands the named partition "
33108 "within the disk to fill any extra space:"
33109 msgstr ""
33110
33111 # type: verbatim
33112 #. type: verbatim
33113 #: ../tools/virt-resize.pl:158
33114 #, no-wrap
33115 msgid ""
33116 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
33117 "\n"
33118 msgstr ""
33119
33120 # type: textblock
33121 #. type: textblock
33122 #: ../tools/virt-resize.pl:160
33123 msgid ""
33124 "(In this case, an extra partition is I<not> created at the end of the disk, "
33125 "because there will be no unused space)."
33126 msgstr ""
33127
33128 # type: textblock
33129 #. type: textblock
33130 #: ../tools/virt-resize.pl:163
33131 msgid ""
33132 "L</--resize> is the other commonly used option.  The following would "
33133 "increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the "
33134 "rest of the available space:"
33135 msgstr ""
33136
33137 # type: verbatim
33138 #. type: verbatim
33139 #: ../tools/virt-resize.pl:167
33140 #, no-wrap
33141 msgid ""
33142 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
33143 "     indisk outdisk\n"
33144 "\n"
33145 msgstr ""
33146
33147 # type: textblock
33148 #. type: textblock
33149 #: ../tools/virt-resize.pl:170
33150 msgid ""
33151 "If the expanded partition in the image contains a filesystem or LVM PV, then "
33152 "if virt-resize knows how, it will resize the contents, the equivalent of "
33153 "calling a command such as L<pvresize(8)>, L<resize2fs(8)> or L<ntfsresize(8)"
33154 ">.  However virt-resize does not know how to resize some filesystems, so you "
33155 "would have to online resize them after booting the guest."
33156 msgstr ""
33157
33158 # type: textblock
33159 #. type: textblock
33160 #: ../tools/virt-resize.pl:177
33161 msgid "Other options are covered below."
33162 msgstr ""
33163
33164 # type: =item
33165 #. type: =item
33166 #: ../tools/virt-resize.pl:179
33167 msgid "6. Test"
33168 msgstr ""
33169
33170 # type: textblock
33171 #. type: textblock
33172 #: ../tools/virt-resize.pl:181
33173 msgid "Thoroughly test the new disk image I<before> discarding the old one."
33174 msgstr ""
33175
33176 # type: textblock
33177 #. type: textblock
33178 #: ../tools/virt-resize.pl:183
33179 msgid "If you are using libvirt, edit the XML to point at the new disk:"
33180 msgstr ""
33181
33182 # type: verbatim
33183 #. type: verbatim
33184 #: ../tools/virt-resize.pl:185
33185 #, no-wrap
33186 msgid ""
33187 " # virsh edit guestname\n"
33188 "\n"
33189 msgstr ""
33190
33191 # type: textblock
33192 #. type: textblock
33193 #: ../tools/virt-resize.pl:187
33194 msgid ""
33195 "Change E<lt>source ...E<gt>, see L<http://libvirt.org/formatdomain."
33196 "html#elementsDisks>"
33197 msgstr ""
33198
33199 # type: textblock
33200 #. type: textblock
33201 #: ../tools/virt-resize.pl:190
33202 msgid "Then start up the domain with the new, resized disk:"
33203 msgstr ""
33204
33205 # type: verbatim
33206 #. type: verbatim
33207 #: ../tools/virt-resize.pl:192
33208 #, no-wrap
33209 msgid ""
33210 " # virsh start guestname\n"
33211 "\n"
33212 msgstr ""
33213
33214 # type: textblock
33215 #. type: textblock
33216 #: ../tools/virt-resize.pl:194
33217 msgid ""
33218 "and check that it still works.  See also the L</NOTES> section below for "
33219 "additional information."
33220 msgstr ""
33221
33222 # type: =item
33223 #. type: =item
33224 #: ../tools/virt-resize.pl:197
33225 msgid "7. Resize LVs etc inside the guest"
33226 msgstr ""
33227
33228 # type: textblock
33229 #. type: textblock
33230 #: ../tools/virt-resize.pl:199
33231 msgid "(This can also be done offline using L<guestfish(1)>)"
33232 msgstr ""
33233
33234 # type: textblock
33235 #. type: textblock
33236 #: ../tools/virt-resize.pl:201
33237 msgid ""
33238 "Once the guest has booted you should see the new space available, at least "
33239 "for filesystems that virt-resize knows how to resize, and for PVs.  The user "
33240 "may need to resize LVs inside PVs, and also resize filesystem types that "
33241 "virt-resize does not know how to expand."
33242 msgstr ""
33243
33244 # type: =head2
33245 #. type: =head2
33246 #: ../tools/virt-resize.pl:208
33247 msgid "SHRINKING A VIRTUAL MACHINE DISK"
33248 msgstr ""
33249
33250 # type: textblock
33251 #. type: textblock
33252 #: ../tools/virt-resize.pl:210
33253 msgid ""
33254 "Shrinking is somewhat more complex than expanding, and only an overview is "
33255 "given here."
33256 msgstr ""
33257
33258 # type: textblock
33259 #. type: textblock
33260 #: ../tools/virt-resize.pl:213
33261 msgid ""
33262 "Firstly virt-resize will not attempt to shrink any partition content (PVs, "
33263 "filesystems).  The user has to shrink content before passing the disk image "
33264 "to virt-resize, and virt-resize will check that the content has been shrunk "
33265 "properly."
33266 msgstr ""
33267
33268 # type: textblock
33269 #. type: textblock
33270 #: ../tools/virt-resize.pl:218
33271 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
33272 msgstr ""
33273
33274 # type: textblock
33275 #. type: textblock
33276 #: ../tools/virt-resize.pl:220
33277 msgid ""
33278 "After shrinking PVs and filesystems, shut down the guest, and proceed with "
33279 "steps 3 and 4 above to allocate a new disk image."
33280 msgstr ""
33281
33282 # type: textblock
33283 #. type: textblock
33284 #: ../tools/virt-resize.pl:223
33285 msgid ""
33286 "Then run virt-resize with any of the C<--shrink> and/or C<--resize> options."
33287 msgstr ""
33288
33289 # type: =head2
33290 #. type: =head2
33291 #: ../tools/virt-resize.pl:226
33292 msgid "IGNORING OR DELETING PARTITIONS"
33293 msgstr ""
33294
33295 # type: textblock
33296 #. type: textblock
33297 #: ../tools/virt-resize.pl:228
33298 msgid ""
33299 "virt-resize also gives a convenient way to ignore or delete partitions when "
33300 "copying from the input disk to the output disk.  Ignoring a partition speeds "
33301 "up the copy where you don't care about the existing contents of a "
33302 "partition.  Deleting a partition removes it completely, but note that it "
33303 "also renumbers any partitions after the one which is deleted, which can "
33304 "leave some guests unbootable."
33305 msgstr ""
33306
33307 # type: =head2
33308 #. type: =head2
33309 #: ../tools/virt-resize.pl:235
33310 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
33311 msgstr ""
33312
33313 # type: textblock
33314 #. type: textblock
33315 #: ../tools/virt-resize.pl:237
33316 msgid ""
33317 "If the input disk is in qcow2 format, then you may prefer that the output is "
33318 "in qcow2 format as well.  Alternately, virt-resize can convert the format on "
33319 "the fly.  The output format is simply determined by the format of the empty "
33320 "output container that you provide.  Thus to create qcow2 output, use:"
33321 msgstr ""
33322
33323 # type: verbatim
33324 #. type: verbatim
33325 #: ../tools/virt-resize.pl:243
33326 #, no-wrap
33327 msgid ""
33328 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
33329 "\n"
33330 msgstr ""
33331
33332 # type: textblock
33333 #. type: textblock
33334 #: ../tools/virt-resize.pl:245
33335 msgid "instead of the truncate command (use C<-c> for a compressed disk)."
33336 msgstr ""
33337
33338 # type: textblock
33339 #. type: textblock
33340 #: ../tools/virt-resize.pl:247
33341 msgid "Similarly, to get non-sparse raw output use:"
33342 msgstr ""
33343
33344 # type: verbatim
33345 #. type: verbatim
33346 #: ../tools/virt-resize.pl:249
33347 #, no-wrap
33348 msgid ""
33349 " fallocate -l size outdisk\n"
33350 "\n"
33351 msgstr ""
33352
33353 # type: textblock
33354 #. type: textblock
33355 #: ../tools/virt-resize.pl:251
33356 msgid ""
33357 "(on older systems that don't have the L<fallocate(1)> command use C<dd if=/"
33358 "dev/zero of=outdisk bs=1M count=..>)"
33359 msgstr ""
33360
33361 # type: textblock
33362 #. type: textblock
33363 #: ../tools/virt-resize.pl:264
33364 msgid "Display help."
33365 msgstr ""
33366
33367 # type: =item
33368 #. type: =item
33369 #: ../tools/virt-resize.pl:278
33370 msgid "B<--resize part=size>"
33371 msgstr ""
33372
33373 # type: textblock
33374 #. type: textblock
33375 #: ../tools/virt-resize.pl:280
33376 msgid ""
33377 "Resize the named partition (expanding or shrinking it) so that it has the "
33378 "given size."
33379 msgstr ""
33380
33381 # type: textblock
33382 #. type: textblock
33383 #: ../tools/virt-resize.pl:283
33384 msgid ""
33385 "C<size> can be expressed as an absolute number followed by b/K/M/G/T/P/E to "
33386 "mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or "
33387 "Exabytes; or as a percentage of the current size; or as a relative number or "
33388 "percentage.  For example:"
33389 msgstr ""
33390
33391 # type: verbatim
33392 #. type: verbatim
33393 #: ../tools/virt-resize.pl:288
33394 #, no-wrap
33395 msgid ""
33396 " --resize /dev/sda2=10G\n"
33397 "\n"
33398 msgstr ""
33399
33400 # type: verbatim
33401 #. type: verbatim
33402 #: ../tools/virt-resize.pl:290
33403 #, no-wrap
33404 msgid ""
33405 " --resize /dev/sda4=90%\n"
33406 "\n"
33407 msgstr ""
33408
33409 # type: verbatim
33410 #. type: verbatim
33411 #: ../tools/virt-resize.pl:292
33412 #, no-wrap
33413 msgid ""
33414 " --resize /dev/sda2=+1G\n"
33415 "\n"
33416 msgstr ""
33417
33418 # type: verbatim
33419 #. type: verbatim
33420 #: ../tools/virt-resize.pl:294
33421 #, no-wrap
33422 msgid ""
33423 " --resize /dev/sda2=-200M\n"
33424 "\n"
33425 msgstr ""
33426
33427 # type: verbatim
33428 #. type: verbatim
33429 #: ../tools/virt-resize.pl:296
33430 #, no-wrap
33431 msgid ""
33432 " --resize /dev/sda1=+128K\n"
33433 "\n"
33434 msgstr ""
33435
33436 # type: verbatim
33437 #. type: verbatim
33438 #: ../tools/virt-resize.pl:298
33439 #, no-wrap
33440 msgid ""
33441 " --resize /dev/sda1=+10%\n"
33442 "\n"
33443 msgstr ""
33444
33445 # type: verbatim
33446 #. type: verbatim
33447 #: ../tools/virt-resize.pl:300
33448 #, no-wrap
33449 msgid ""
33450 " --resize /dev/sda1=-10%\n"
33451 "\n"
33452 msgstr ""
33453
33454 # type: textblock
33455 #. type: textblock
33456 #: ../tools/virt-resize.pl:302
33457 msgid ""
33458 "You can increase the size of any partition.  Virt-resize will expand the "
33459 "direct content of the partition if it knows how (see C<--expand> below)."
33460 msgstr ""
33461
33462 # type: textblock
33463 #. type: textblock
33464 #: ../tools/virt-resize.pl:306
33465 msgid ""
33466 "You can only I<decrease> the size of partitions that contain filesystems or "
33467 "PVs which have already been shrunk.  Virt-resize will check this has been "
33468 "done before proceeding, or else will print an error (see also C<--resize-"
33469 "force>)."
33470 msgstr ""
33471
33472 # type: textblock
33473 #. type: textblock
33474 #: ../tools/virt-resize.pl:311 ../tools/virt-resize.pl:403
33475 #: ../tools/virt-resize.pl:420
33476 msgid "You can give this option multiple times."
33477 msgstr ""
33478
33479 # type: =item
33480 #. type: =item
33481 #: ../tools/virt-resize.pl:317
33482 msgid "B<--resize-force part=size>"
33483 msgstr ""
33484
33485 # type: textblock
33486 #. type: textblock
33487 #: ../tools/virt-resize.pl:319
33488 msgid ""
33489 "This is the same as C<--resize> except that it will let you decrease the "
33490 "size of any partition.  Generally this means you will lose any data which "
33491 "was at the end of the partition you shrink, but you may not care about that "
33492 "(eg. if shrinking an unused partition, or if you can easily recreate it such "
33493 "as a swap partition)."
33494 msgstr ""
33495
33496 # type: textblock
33497 #. type: textblock
33498 #: ../tools/virt-resize.pl:325
33499 msgid "See also the C<--ignore> option."
33500 msgstr ""
33501
33502 # type: =item
33503 #. type: =item
33504 #: ../tools/virt-resize.pl:331
33505 msgid "B<--expand part>"
33506 msgstr ""
33507
33508 # type: textblock
33509 #. type: textblock
33510 #: ../tools/virt-resize.pl:333
33511 msgid ""
33512 "Expand the named partition so it uses up all extra space (space left over "
33513 "after any other resize changes that you request have been done)."
33514 msgstr ""
33515
33516 # type: textblock
33517 #. type: textblock
33518 #: ../tools/virt-resize.pl:336
33519 msgid ""
33520 "If virt-resize knows how, it will expand the direct content of the "
33521 "partition.  For example, if the partition is an LVM PV, it will expand the "
33522 "PV to fit (like calling L<pvresize(8)>).  Virt-resize leaves any other "
33523 "content it doesn't know about alone."
33524 msgstr ""
33525
33526 # type: textblock
33527 #. type: textblock
33528 #: ../tools/virt-resize.pl:341
33529 msgid "Currently virt-resize can resize:"
33530 msgstr ""
33531
33532 # type: textblock
33533 #. type: textblock
33534 #: ../tools/virt-resize.pl:347
33535 msgid ""
33536 "ext2, ext3 and ext4 filesystems when they are contained directly inside a "
33537 "partition."
33538 msgstr ""
33539
33540 # type: textblock
33541 #. type: textblock
33542 #: ../tools/virt-resize.pl:352
33543 msgid ""
33544 "NTFS filesystems contained directly in a partition, if libguestfs was "
33545 "compiled with support for NTFS."
33546 msgstr ""
33547
33548 # type: textblock
33549 #. type: textblock
33550 #: ../tools/virt-resize.pl:355
33551 msgid ""
33552 "The filesystem must have been shut down consistently last time it was used.  "
33553 "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
33554 "consistency check, so at the first boot after resizing Windows will check "
33555 "the disk."
33556 msgstr ""
33557
33558 # type: textblock
33559 #. type: textblock
33560 #: ../tools/virt-resize.pl:362
33561 msgid ""
33562 "LVM PVs (physical volumes).  virt-resize does not usually resize anything "
33563 "inside the PV, but see the C<--LV-expand> option.  The user could also "
33564 "resize LVs as desired after boot."
33565 msgstr ""
33566
33567 # type: textblock
33568 #. type: textblock
33569 #: ../tools/virt-resize.pl:368 ../tools/virt-resize.pl:390
33570 msgid "Note that you cannot use C<--expand> and C<--shrink> together."
33571 msgstr ""
33572
33573 # type: =item
33574 #. type: =item
33575 #: ../tools/virt-resize.pl:374
33576 msgid "B<--shrink part>"
33577 msgstr ""
33578
33579 # type: textblock
33580 #. type: textblock
33581 #: ../tools/virt-resize.pl:376
33582 msgid ""
33583 "Shrink the named partition until the overall disk image fits in the "
33584 "destination.  The named partition B<must> contain a filesystem or PV which "
33585 "has already been shrunk using another tool (eg. L<guestfish(1)> or other "
33586 "online tools).  Virt-resize will check this and give an error if it has not "
33587 "been done."
33588 msgstr ""
33589
33590 # type: textblock
33591 #. type: textblock
33592 #: ../tools/virt-resize.pl:382
33593 msgid ""
33594 "The amount by which the overall disk must be shrunk (after carrying out all "
33595 "other operations requested by the user) is called the \"deficit\".  For "
33596 "example, a straight copy (assume no other operations)  from a 5GB disk image "
33597 "to a 4GB disk image results in a 1GB deficit.  In this case, virt-resize "
33598 "would give an error unless the user specified a partition to shrink and that "
33599 "partition had more than a gigabyte of free space."
33600 msgstr ""
33601
33602 # type: =item
33603 #. type: =item
33604 #: ../tools/virt-resize.pl:396
33605 msgid "B<--ignore part>"
33606 msgstr ""
33607
33608 # type: textblock
33609 #. type: textblock
33610 #: ../tools/virt-resize.pl:398
33611 msgid ""
33612 "Ignore the named partition.  Effectively this means the partition is "
33613 "allocated on the destination disk, but the content is not copied across from "
33614 "the source disk.  The content of the partition will be blank (all zero "
33615 "bytes)."
33616 msgstr ""
33617
33618 # type: =item
33619 #. type: =item
33620 #: ../tools/virt-resize.pl:409
33621 msgid "B<--delete part>"
33622 msgstr ""
33623
33624 # type: textblock
33625 #. type: textblock
33626 #: ../tools/virt-resize.pl:411
33627 msgid ""
33628 "Delete the named partition.  It would be more accurate to describe this as "
33629 "\"don't copy it over\", since virt-resize doesn't do in-place changes and "
33630 "the original disk image is left intact."
33631 msgstr ""
33632
33633 # type: textblock
33634 #. type: textblock
33635 #: ../tools/virt-resize.pl:415
33636 msgid ""
33637 "Note that when you delete a partition, then anything contained in the "
33638 "partition is also deleted.  Furthermore, this causes any partitions that "
33639 "come after to be I<renumbered>, which can easily make your guest unbootable."
33640 msgstr ""
33641
33642 # type: =item
33643 #. type: =item
33644 #: ../tools/virt-resize.pl:426
33645 msgid "B<--LV-expand logvol>"
33646 msgstr ""
33647
33648 # type: textblock
33649 #. type: textblock
33650 #: ../tools/virt-resize.pl:428
33651 msgid ""
33652 "This takes the logical volume and, as a final step, expands it to fill all "
33653 "the space available in its volume group.  A typical usage, assuming a Linux "
33654 "guest with a single PV C</dev/sda2> and a root device called C</dev/vg_guest/"
33655 "lv_root> would be:"
33656 msgstr ""
33657
33658 # type: verbatim
33659 #. type: verbatim
33660 #: ../tools/virt-resize.pl:433
33661 #, no-wrap
33662 msgid ""
33663 " virt-resize indisk outdisk \\\n"
33664 "   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
33665 "\n"
33666 msgstr ""
33667
33668 # type: textblock
33669 #. type: textblock
33670 #: ../tools/virt-resize.pl:436
33671 msgid ""
33672 "This would first expand the partition (and PV), and then expand the root "
33673 "device to fill the extra space in the PV."
33674 msgstr ""
33675
33676 # type: textblock
33677 #. type: textblock
33678 #: ../tools/virt-resize.pl:439
33679 msgid ""
33680 "The contents of the LV are also resized if virt-resize knows how to do "
33681 "that.  You can stop virt-resize from trying to expand the content by using "
33682 "the option C<--no-expand-content>."
33683 msgstr ""
33684
33685 # type: textblock
33686 #. type: textblock
33687 #: ../tools/virt-resize.pl:443
33688 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
33689 msgstr ""
33690
33691 # type: textblock
33692 #. type: textblock
33693 #: ../tools/virt-resize.pl:446
33694 msgid ""
33695 "You can give this option multiple times, I<but> it doesn't make sense to do "
33696 "this unless the logical volumes you specify are all in different volume "
33697 "groups."
33698 msgstr ""
33699
33700 # type: =item
33701 #. type: =item
33702 #: ../tools/virt-resize.pl:454
33703 msgid "B<--no-copy-boot-loader>"
33704 msgstr ""
33705
33706 # type: textblock
33707 #. type: textblock
33708 #: ../tools/virt-resize.pl:456
33709 msgid ""
33710 "By default, virt-resize copies over some sectors at the start of the disk "
33711 "(up to the beginning of the first partition).  Commonly these sectors "
33712 "contain the Master Boot Record (MBR) and the boot loader, and are required "
33713 "in order for the guest to boot correctly."
33714 msgstr ""
33715
33716 # type: textblock
33717 #. type: textblock
33718 #: ../tools/virt-resize.pl:461
33719 msgid ""
33720 "If you specify this flag, then this initial copy is not done.  You may need "
33721 "to reinstall the boot loader in this case."
33722 msgstr ""
33723
33724 # type: =item
33725 #. type: =item
33726 #: ../tools/virt-resize.pl:469
33727 msgid "B<--no-extra-partition>"
33728 msgstr ""
33729
33730 # type: textblock
33731 #. type: textblock
33732 #: ../tools/virt-resize.pl:471
33733 msgid ""
33734 "By default, virt-resize creates an extra partition if there is any extra, "
33735 "unused space after all resizing has happened.  Use this option to prevent "
33736 "the extra partition from being created.  If you do this then the extra space "
33737 "will be inaccessible until you run fdisk, parted, or some other partitioning "
33738 "tool in the guest."
33739 msgstr ""
33740
33741 # type: textblock
33742 #. type: textblock
33743 #: ../tools/virt-resize.pl:477
33744 msgid ""
33745 "Note that if the surplus space is smaller than 10 MB, no extra partition "
33746 "will be created."
33747 msgstr ""
33748
33749 # type: =item
33750 #. type: =item
33751 #: ../tools/virt-resize.pl:484
33752 msgid "B<--no-expand-content>"
33753 msgstr ""
33754
33755 # type: textblock
33756 #. type: textblock
33757 #: ../tools/virt-resize.pl:486
33758 msgid ""
33759 "By default, virt-resize will try to expand the direct contents of "
33760 "partitions, if it knows how (see C<--expand> option above)."
33761 msgstr ""
33762
33763 # type: textblock
33764 #. type: textblock
33765 #: ../tools/virt-resize.pl:489
33766 msgid ""
33767 "If you give the C<--no-expand-content> option then virt-resize will not "
33768 "attempt this."
33769 msgstr ""
33770
33771 # type: =item
33772 #. type: =item
33773 #: ../tools/virt-resize.pl:496
33774 msgid "B<-d> | B<--debug>"
33775 msgstr ""
33776
33777 # type: =item
33778 #. type: =item
33779 #: ../tools/virt-resize.pl:504
33780 msgid "B<-n> | B<--dryrun>"
33781 msgstr ""
33782
33783 # type: textblock
33784 #. type: textblock
33785 #: ../tools/virt-resize.pl:506
33786 msgid "Print a summary of what would be done, but don't do anything."
33787 msgstr ""
33788
33789 # type: =item
33790 #. type: =item
33791 #: ../tools/virt-resize.pl:512
33792 msgid "B<-q> | B<--quiet>"
33793 msgstr ""
33794
33795 # type: textblock
33796 #. type: textblock
33797 #: ../tools/virt-resize.pl:514
33798 msgid "Don't print the summary."
33799 msgstr ""
33800
33801 # type: textblock
33802 #. type: textblock
33803 #: ../tools/virt-resize.pl:522
33804 msgid ""
33805 "Specify the format of the input disk image.  If this flag is not given then "
33806 "it is auto-detected from the image itself."
33807 msgstr ""
33808
33809 # type: textblock
33810 #. type: textblock
33811 #: ../tools/virt-resize.pl:528
33812 msgid ""
33813 "Note that this option I<does not> affect the output format.  See L</QCOW2 "
33814 "AND NON-SPARSE RAW FORMATS>."
33815 msgstr ""
33816
33817 # type: =item
33818 #. type: =item
33819 #: ../tools/virt-resize.pl:535
33820 msgid "B<--output-format> raw"
33821 msgstr ""
33822
33823 # type: textblock
33824 #. type: textblock
33825 #: ../tools/virt-resize.pl:537
33826 msgid ""
33827 "Specify the format of the output disk image.  If this flag is not given then "
33828 "it is auto-detected from the image itself."
33829 msgstr ""
33830
33831 # type: textblock
33832 #. type: textblock
33833 #: ../tools/virt-resize.pl:543
33834 msgid ""
33835 "Note that you still need to create the output disk with the right format.  "
33836 "See L</QCOW2 AND NON-SPARSE RAW FORMATS>."
33837 msgstr ""
33838
33839 # type: =head1
33840 #. type: =head1
33841 #: ../tools/virt-resize.pl:1419
33842 msgid "NOTES"
33843 msgstr ""
33844
33845 # type: =head2
33846 #. type: =head2
33847 #: ../tools/virt-resize.pl:1421
33848 msgid "\"Partition 1 does not end on cylinder boundary.\""
33849 msgstr ""
33850
33851 # type: textblock
33852 #. type: textblock
33853 #: ../tools/virt-resize.pl:1423
33854 msgid ""
33855 "Virt-resize aligns partitions to multiples of 64 sectors.  Usually this "
33856 "means the partitions will not be aligned to the ancient CHS geometry.  "
33857 "However CHS geometry is meaningless for disks manufactured since the early "
33858 "1990s, and doubly so for virtual hard drives.  Alignment of partitions to "
33859 "cylinders is not required by any modern operating system."
33860 msgstr ""
33861
33862 # type: =head2
33863 #. type: =head2
33864 #: ../tools/virt-resize.pl:1430
33865 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
33866 msgstr ""
33867
33868 # type: textblock
33869 #. type: textblock
33870 #: ../tools/virt-resize.pl:1432
33871 msgid ""
33872 "In Windows Vista and later versions, Microsoft switched to using a separate "
33873 "boot partition.  In these VMs, typically C</dev/sda1> is the boot partition "
33874 "and C</dev/sda2> is the main (C:) drive.  We have not had any luck resizing "
33875 "the boot partition.  Doing so seems to break the guest completely.  However "
33876 "expanding the second partition (ie. C: drive) should work."
33877 msgstr ""
33878
33879 # type: textblock
33880 #. type: textblock
33881 #: ../tools/virt-resize.pl:1439
33882 msgid ""
33883 "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if "
33884 "NTFS partitions have been expanded.  This is just a safety check and (unless "
33885 "it find errors) is nothing to worry about."
33886 msgstr ""
33887
33888 # type: =head2
33889 #. type: =head2
33890 #: ../tools/virt-resize.pl:1443
33891 msgid "GUEST BOOT STUCK AT \"GRUB\""
33892 msgstr ""
33893
33894 # type: textblock
33895 #. type: textblock
33896 #: ../tools/virt-resize.pl:1445
33897 msgid ""
33898 "If a Linux guest does not boot after resizing, and the boot is stuck after "
33899 "printing C<GRUB> on the console, try reinstalling grub.  This sometimes "
33900 "happens on older (RHEL 5-era) guests, for reasons we don't fully understand, "
33901 "although we think is to do with partition alignment."
33902 msgstr ""
33903
33904 # type: verbatim
33905 #. type: verbatim
33906 #: ../tools/virt-resize.pl:1450
33907 #, no-wrap
33908 msgid ""
33909 " guestfish -i -a newdisk\n"
33910 " ><fs> cat /boot/grub/device.map\n"
33911 " # check the contents of this file are sensible or\n"
33912 " # edit the file if necessary\n"
33913 " ><fs> grub-install / /dev/vda\n"
33914 " ><fs> exit\n"
33915 "\n"
33916 msgstr ""
33917
33918 # type: textblock
33919 #. type: textblock
33920 #: ../tools/virt-resize.pl:1457
33921 msgid ""
33922 "For more flexible guest reconfiguration, including if you need to specify "
33923 "other parameters to grub-install, use L<virt-rescue(1)>."
33924 msgstr ""
33925
33926 # type: =head1
33927 #. type: =head1
33928 #: ../tools/virt-resize.pl:1460
33929 msgid "ALTERNATIVE TOOLS"
33930 msgstr ""
33931
33932 # type: textblock
33933 #. type: textblock
33934 #: ../tools/virt-resize.pl:1462
33935 msgid ""
33936 "There are several proprietary tools for resizing partitions.  We won't "
33937 "mention any here."
33938 msgstr ""
33939
33940 # type: textblock
33941 #. type: textblock
33942 #: ../tools/virt-resize.pl:1465
33943 msgid ""
33944 "L<parted(8)> and its graphical shell gparted can do some types of resizing "
33945 "operations on disk images.  They can resize and move partitions, but I don't "
33946 "think they can do anything with the contents, and they certainly don't "
33947 "understand LVM."
33948 msgstr ""
33949
33950 # type: textblock
33951 #. type: textblock
33952 #: ../tools/virt-resize.pl:1470
33953 msgid ""
33954 "L<guestfish(1)> can do everything that virt-resize can do and a lot more, "
33955 "but at a much lower level.  You will probably end up hand-calculating sector "
33956 "offsets, which is something that virt-resize was designed to avoid.  If you "
33957 "want to see the guestfish-equivalent commands that virt-resize runs, use the "
33958 "C<--debug> flag."
33959 msgstr ""
33960
33961 # type: textblock
33962 #. type: textblock
33963 #: ../tools/virt-resize.pl:1485
33964 msgid ""
33965 "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<lvm"
33966 "(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)>, "
33967 "L<virsh(1)>, L<parted(8)>, L<truncate(1)>, L<fallocate(1)>, L<grub(8)>, "
33968 "L<grub-install(8)>, L<virt-rescue(1)>, L<Sys::Guestfs(3)>, L<http://"
33969 "libguestfs.org/>."
33970 msgstr ""
33971
33972 # type: textblock
33973 #. type: textblock
33974 #: ../tools/virt-list-filesystems.pl:32
33975 msgid ""
33976 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
33977 msgstr ""
33978
33979 # type: verbatim
33980 #. type: verbatim
33981 #: ../tools/virt-list-filesystems.pl:36
33982 #, no-wrap
33983 msgid ""
33984 " virt-list-filesystems [--options] domname\n"
33985 "\n"
33986 msgstr ""
33987
33988 # type: verbatim
33989 #. type: verbatim
33990 #: ../tools/virt-list-filesystems.pl:38
33991 #, no-wrap
33992 msgid ""
33993 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
33994 "\n"
33995 msgstr ""
33996
33997 # type: textblock
33998 #. type: textblock
33999 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
34000 msgid ""
34001 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
34002 "replacement."
34003 msgstr ""
34004
34005 # type: textblock
34006 #. type: textblock
34007 #: ../tools/virt-list-filesystems.pl:45
34008 msgid ""
34009 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
34010 "are contained in a virtual machine or disk image."
34011 msgstr ""
34012
34013 # type: textblock
34014 #. type: textblock
34015 #: ../tools/virt-list-filesystems.pl:49
34016 msgid ""
34017 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
34018 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34019 "> tool."
34020 msgstr ""
34021
34022 # type: =item
34023 #. type: =item
34024 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
34025 msgid "B<-l> | B<--long>"
34026 msgstr ""
34027
34028 # type: textblock
34029 #. type: textblock
34030 #: ../tools/virt-list-filesystems.pl:108
34031 msgid ""
34032 "With this option, C<virt-list-filesystems> displays the type of each "
34033 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
34034 msgstr ""
34035
34036 # type: =item
34037 #. type: =item
34038 #: ../tools/virt-list-filesystems.pl:115
34039 msgid "B<-a> | B<--all>"
34040 msgstr ""
34041
34042 # type: textblock
34043 #. type: textblock
34044 #: ../tools/virt-list-filesystems.pl:117
34045 msgid ""
34046 "Normally we only show mountable filesystems.  If this option is given then "
34047 "swap devices are shown too."
34048 msgstr ""
34049
34050 # type: textblock
34051 #. type: textblock
34052 #: ../tools/virt-list-filesystems.pl:191
34053 msgid ""
34054 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
34055 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
34056 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34057 msgstr ""
34058
34059 # type: textblock
34060 #. type: textblock
34061 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
34062 msgid "Copyright (C) 2009 Red Hat Inc."
34063 msgstr ""
34064
34065 # type: textblock
34066 #. type: textblock
34067 #: ../tools/virt-tar.pl:33
34068 msgid "virt-tar - Extract or upload files to a virtual machine"
34069 msgstr ""
34070
34071 # type: verbatim
34072 #. type: verbatim
34073 #: ../tools/virt-tar.pl:37
34074 #, no-wrap
34075 msgid ""
34076 " virt-tar [--options] -x domname directory tarball\n"
34077 "\n"
34078 msgstr ""
34079
34080 # type: verbatim
34081 #. type: verbatim
34082 #: ../tools/virt-tar.pl:39
34083 #, no-wrap
34084 msgid ""
34085 " virt-tar [--options] -u domname tarball directory\n"
34086 "\n"
34087 msgstr ""
34088
34089 # type: verbatim
34090 #. type: verbatim
34091 #: ../tools/virt-tar.pl:41
34092 #, no-wrap
34093 msgid ""
34094 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
34095 "\n"
34096 msgstr ""
34097
34098 # type: verbatim
34099 #. type: verbatim
34100 #: ../tools/virt-tar.pl:43
34101 #, no-wrap
34102 msgid ""
34103 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
34104 "\n"
34105 msgstr ""
34106
34107 #. type: textblock
34108 #: ../tools/virt-tar.pl:47
34109 msgid ""
34110 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
34111 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
34112 msgstr ""
34113
34114 # type: textblock
34115 #. type: textblock
34116 #: ../tools/virt-tar.pl:52
34117 msgid "Download C</home> from the VM into a local tarball:"
34118 msgstr ""
34119
34120 # type: verbatim
34121 #. type: verbatim
34122 #: ../tools/virt-tar.pl:54
34123 #, no-wrap
34124 msgid ""
34125 " virt-tar -x domname /home home.tar\n"
34126 "\n"
34127 msgstr ""
34128
34129 # type: verbatim
34130 #. type: verbatim
34131 #: ../tools/virt-tar.pl:56
34132 #, no-wrap
34133 msgid ""
34134 " virt-tar -zx domname /home home.tar.gz\n"
34135 "\n"
34136 msgstr ""
34137
34138 # type: textblock
34139 #. type: textblock
34140 #: ../tools/virt-tar.pl:58
34141 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
34142 msgstr ""
34143
34144 # type: verbatim
34145 #. type: verbatim
34146 #: ../tools/virt-tar.pl:60
34147 #, no-wrap
34148 msgid ""
34149 " virt-tar -u domname uploadstuff.tar /tmp\n"
34150 "\n"
34151 msgstr ""
34152
34153 # type: verbatim
34154 #. type: verbatim
34155 #: ../tools/virt-tar.pl:62
34156 #, no-wrap
34157 msgid ""
34158 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
34159 "\n"
34160 msgstr ""
34161
34162 # type: textblock
34163 #. type: textblock
34164 #: ../tools/virt-tar.pl:66
34165 msgid ""
34166 "You must I<not> use C<virt-tar> with the C<-u> option (upload) on live "
34167 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
34168 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
34169 msgstr ""
34170
34171 # type: textblock
34172 #. type: textblock
34173 #: ../tools/virt-tar.pl:71
34174 msgid ""
34175 "You can use C<-x> (extract) on live virtual machines, but you might get "
34176 "inconsistent results or errors if there is filesystem activity inside the "
34177 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
34178 "work, but the only way to guarantee consistent results is if the virtual "
34179 "machine is shut down."
34180 msgstr ""
34181
34182 # type: textblock
34183 #. type: textblock
34184 #: ../tools/virt-tar.pl:79
34185 msgid ""
34186 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
34187 "parts of a guest filesystem.  There are many possibilities: making backups, "
34188 "uploading data files, snooping on guest activity, fixing or customizing "
34189 "guests, etc."
34190 msgstr ""
34191
34192 # type: textblock
34193 #. type: textblock
34194 #: ../tools/virt-tar.pl:84
34195 msgid ""
34196 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
34197 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
34198 "should look at the L<guestfish(1)> tool."
34199 msgstr ""
34200
34201 # type: textblock
34202 #. type: textblock
34203 #: ../tools/virt-tar.pl:88
34204 msgid ""
34205 "There are two modes of operation: C<-x> (eXtract) downloads a directory and "
34206 "its contents (recursively) from the virtual machine into a local tarball.  "
34207 "C<-u> uploads from a local tarball, unpacking it into a directory inside the "
34208 "virtual machine.  You cannot use these two options together."
34209 msgstr ""
34210
34211 # type: textblock
34212 #. type: textblock
34213 #: ../tools/virt-tar.pl:94
34214 msgid ""
34215 "In addition, you may need to use the C<-z> (gZip) option to enable "
34216 "compression.  When uploading, you have to specify C<-z> if the upload file "
34217 "is compressed because virt-tar won't detect this on its own."
34218 msgstr ""
34219
34220 # type: textblock
34221 #. type: textblock
34222 #: ../tools/virt-tar.pl:98
34223 msgid ""
34224 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
34225 "example it cannot do PKZip files or bzip2 compression.  If you want that "
34226 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
34227 "the L<libguestfs(3)> API)."
34228 msgstr ""
34229
34230 # type: =item
34231 #. type: =item
34232 #: ../tools/virt-tar.pl:156
34233 msgid "B<-x> | B<--extract> | B<--download>"
34234 msgstr ""
34235
34236 # type: =item
34237 #. type: =item
34238 #: ../tools/virt-tar.pl:158
34239 msgid "B<-u> | B<--upload>"
34240 msgstr ""
34241
34242 # type: textblock
34243 #. type: textblock
34244 #: ../tools/virt-tar.pl:160
34245 msgid ""
34246 "Use C<-x> to extract (download) a directory from a virtual machine to a "
34247 "local tarball."
34248 msgstr ""
34249
34250 # type: textblock
34251 #. type: textblock
34252 #: ../tools/virt-tar.pl:163
34253 msgid ""
34254 "Use C<-u> to upload and unpack from a local tarball into a virtual machine.  "
34255 "Please read the L</WARNING> section above before using this option."
34256 msgstr ""
34257
34258 # type: textblock
34259 #. type: textblock
34260 #: ../tools/virt-tar.pl:167
34261 msgid "You must specify exactly one of these options."
34262 msgstr ""
34263
34264 # type: =item
34265 #. type: =item
34266 #: ../tools/virt-tar.pl:173
34267 msgid "B<-z> | B<--gzip>"
34268 msgstr ""
34269
34270 # type: textblock
34271 #. type: textblock
34272 #: ../tools/virt-tar.pl:175
34273 msgid "Specify that the input or output tarball is gzip-compressed."
34274 msgstr ""
34275
34276 #. type: textblock
34277 #: ../tools/virt-tar.pl:288
34278 msgid ""
34279 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
34280 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
34281 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
34282 "org/>."
34283 msgstr ""
34284
34285 # type: textblock
34286 #. type: textblock
34287 #: ../tools/virt-make-fs.pl:37
34288 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
34289 msgstr ""
34290
34291 # type: verbatim
34292 #. type: verbatim
34293 #: ../tools/virt-make-fs.pl:41
34294 #, no-wrap
34295 msgid ""
34296 " virt-make-fs [--options] input.tar output.img\n"
34297 "\n"
34298 msgstr ""
34299
34300 # type: verbatim
34301 #. type: verbatim
34302 #: ../tools/virt-make-fs.pl:43
34303 #, no-wrap
34304 msgid ""
34305 " virt-make-fs [--options] input.tar.gz output.img\n"
34306 "\n"
34307 msgstr ""
34308
34309 # type: verbatim
34310 #. type: verbatim
34311 #: ../tools/virt-make-fs.pl:45
34312 #, no-wrap
34313 msgid ""
34314 " virt-make-fs [--options] directory output.img\n"
34315 "\n"
34316 msgstr ""
34317
34318 # type: textblock
34319 #. type: textblock
34320 #: ../tools/virt-make-fs.pl:49
34321 msgid ""
34322 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
34323 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
34324 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
34325 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
34326 "you want to attach these filesystems to existing virtual machines (eg. to "
34327 "import large amounts of read-only data to a VM)."
34328 msgstr ""
34329
34330 # type: textblock
34331 #. type: textblock
34332 #: ../tools/virt-make-fs.pl:57
34333 msgid "Basic usage is:"
34334 msgstr ""
34335
34336 # type: verbatim
34337 #. type: verbatim
34338 #: ../tools/virt-make-fs.pl:59
34339 #, no-wrap
34340 msgid ""
34341 " virt-make-fs input output\n"
34342 "\n"
34343 msgstr ""
34344
34345 # type: textblock
34346 #. type: textblock
34347 #: ../tools/virt-make-fs.pl:61
34348 msgid ""
34349 "where C<input> is either a directory containing files that you want to add, "
34350 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
34351 "C<output> is a disk image.  The input type is detected automatically.  The "
34352 "output disk image defaults to a raw ext2 image unless you specify extra "
34353 "flags (see L</OPTIONS> below)."
34354 msgstr ""
34355
34356 # type: =head2
34357 #. type: =head2
34358 #: ../tools/virt-make-fs.pl:67
34359 msgid "EXTRA SPACE"
34360 msgstr ""
34361
34362 # type: textblock
34363 #. type: textblock
34364 #: ../tools/virt-make-fs.pl:69
34365 msgid ""
34366 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
34367 "the files that it contains, but might have extra space.  Depending on how "
34368 "you are going to use the output, you might think this extra space is wasted "
34369 "and want to minimize it, or you might want to leave space so that more files "
34370 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
34371 "but you can use the C<--size> flag to leave space in the filesystem if you "
34372 "want it."
34373 msgstr ""
34374
34375 # type: textblock
34376 #. type: textblock
34377 #: ../tools/virt-make-fs.pl:77
34378 msgid ""
34379 "An alternative way to leave extra space but not make the output image any "
34380 "bigger is to use an alternative disk image format (instead of the default "
34381 "\"raw\" format).  Using C<--format=qcow2> will use the native QEmu/KVM qcow2 "
34382 "image format (check your hypervisor supports this before using it).  This "
34383 "allows you to choose a large C<--size> but the extra space won't actually be "
34384 "allocated in the image until you try to store something in it."
34385 msgstr ""
34386
34387 #. type: textblock
34388 #: ../tools/virt-make-fs.pl:85
34389 msgid ""
34390 "Don't forget that you can also use local commands including L<resize2fs(8)> "
34391 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
34392 "to build another image from scratch."
34393 msgstr ""
34394
34395 # type: =head3
34396 #. type: =head3
34397 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
34398 #: ../tools/virt-make-fs.pl:142
34399 msgid "EXAMPLE"
34400 msgstr ""
34401
34402 # type: verbatim
34403 #. type: verbatim
34404 #: ../tools/virt-make-fs.pl:91
34405 #, no-wrap
34406 msgid ""
34407 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
34408 "\n"
34409 msgstr ""
34410
34411 # type: =head2
34412 #. type: =head2
34413 #: ../tools/virt-make-fs.pl:93
34414 msgid "FILESYSTEM TYPE"
34415 msgstr ""
34416
34417 # type: textblock
34418 #. type: textblock
34419 #: ../tools/virt-make-fs.pl:95
34420 msgid ""
34421 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
34422 "libguestfs supports can be used (but I<not> read-only formats like "
34423 "ISO9660).  Here are some of the more common choices:"
34424 msgstr ""
34425
34426 # type: =item
34427 #. type: =item
34428 #: ../tools/virt-make-fs.pl:101
34429 msgid "I<ext3>"
34430 msgstr ""
34431
34432 # type: textblock
34433 #. type: textblock
34434 #: ../tools/virt-make-fs.pl:103
34435 msgid ""
34436 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
34437 "you are not going to use the filesystem in a way that requires the journal, "
34438 "then this is just wasted overhead."
34439 msgstr ""
34440
34441 # type: =item
34442 #. type: =item
34443 #: ../tools/virt-make-fs.pl:107
34444 msgid "I<ntfs> or I<vfat>"
34445 msgstr ""
34446
34447 # type: textblock
34448 #. type: textblock
34449 #: ../tools/virt-make-fs.pl:109
34450 msgid "Useful if exporting data to a Windows guest."
34451 msgstr ""
34452
34453 # type: textblock
34454 #. type: textblock
34455 #: ../tools/virt-make-fs.pl:111
34456 msgid ""
34457 "I<Note for vfat>: The tar archive or local directory must only contain files "
34458 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
34459 "program running within libguestfs is unable to change the ownership of non-"
34460 "root files, since vfat itself does not support this."
34461 msgstr ""
34462
34463 # type: =item
34464 #. type: =item
34465 #: ../tools/virt-make-fs.pl:116
34466 msgid "I<minix>"
34467 msgstr ""
34468
34469 # type: textblock
34470 #. type: textblock
34471 #: ../tools/virt-make-fs.pl:118
34472 msgid ""
34473 "Lower overhead than C<ext2>, but certain limitations on filename length and "
34474 "total filesystem size."
34475 msgstr ""
34476
34477 # type: verbatim
34478 #. type: verbatim
34479 #: ../tools/virt-make-fs.pl:125
34480 #, no-wrap
34481 msgid ""
34482 " virt-make-fs --type=minix input minixfs.img\n"
34483 "\n"
34484 msgstr ""
34485
34486 # type: =head2
34487 #. type: =head2
34488 #: ../tools/virt-make-fs.pl:127
34489 msgid "TO PARTITION OR NOT TO PARTITION"
34490 msgstr ""
34491
34492 # type: textblock
34493 #. type: textblock
34494 #: ../tools/virt-make-fs.pl:129
34495 msgid "Optionally virt-make-fs can add a partition table to the output disk."
34496 msgstr ""
34497
34498 # type: textblock
34499 #. type: textblock
34500 #: ../tools/virt-make-fs.pl:131
34501 msgid ""
34502 "Adding a partition can make the disk image more compatible with certain "
34503 "virtualized operating systems which don't expect to see a filesystem "
34504 "directly located on a block device (Linux doesn't care and will happily "
34505 "handle both types)."
34506 msgstr ""
34507
34508 # type: textblock
34509 #. type: textblock
34510 #: ../tools/virt-make-fs.pl:136
34511 msgid ""
34512 "On the other hand, if you have a partition table then the output image is no "
34513 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
34514 "directly on a partitioned disk image.  (However libguestfs tools such as "
34515 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
34516 msgstr ""
34517
34518 # type: textblock
34519 #. type: textblock
34520 #: ../tools/virt-make-fs.pl:144
34521 msgid "Add an MBR partition:"
34522 msgstr ""
34523
34524 # type: verbatim
34525 #. type: verbatim
34526 #: ../tools/virt-make-fs.pl:146
34527 #, no-wrap
34528 msgid ""
34529 " virt-make-fs --partition -- input disk.img\n"
34530 "\n"
34531 msgstr ""
34532
34533 # type: textblock
34534 #. type: textblock
34535 #: ../tools/virt-make-fs.pl:148
34536 msgid ""
34537 "If the output disk image could be terabyte-sized or larger, it's better to "
34538 "use an EFI/GPT-compatible partition table:"
34539 msgstr ""
34540
34541 # type: verbatim
34542 #. type: verbatim
34543 #: ../tools/virt-make-fs.pl:151
34544 #, no-wrap
34545 msgid ""
34546 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
34547 "\n"
34548 msgstr ""
34549
34550 # type: textblock
34551 #. type: textblock
34552 #: ../tools/virt-make-fs.pl:179
34553 msgid "Enable debugging information."
34554 msgstr ""
34555
34556 # type: =item
34557 #. type: =item
34558 #: ../tools/virt-make-fs.pl:185
34559 msgid "B<--size=E<lt>NE<gt>>"
34560 msgstr ""
34561
34562 # type: =item
34563 #. type: =item
34564 #: ../tools/virt-make-fs.pl:187
34565 msgid "B<--size=+E<lt>NE<gt>>"
34566 msgstr ""
34567
34568 # type: =item
34569 #. type: =item
34570 #: ../tools/virt-make-fs.pl:189
34571 msgid "B<-s E<lt>NE<gt>>"
34572 msgstr ""
34573
34574 # type: =item
34575 #. type: =item
34576 #: ../tools/virt-make-fs.pl:191
34577 msgid "B<-s +E<lt>NE<gt>>"
34578 msgstr ""
34579
34580 # type: textblock
34581 #. type: textblock
34582 #: ../tools/virt-make-fs.pl:193
34583 msgid ""
34584 "Use the C<--size> (or C<-s>) option to choose the size of the output image."
34585 msgstr ""
34586
34587 # type: textblock
34588 #. type: textblock
34589 #: ../tools/virt-make-fs.pl:196
34590 msgid ""
34591 "If this option is I<not> given, then the output image will be just large "
34592 "enough to contain all the files, with not much wasted space."
34593 msgstr ""
34594
34595 # type: textblock
34596 #. type: textblock
34597 #: ../tools/virt-make-fs.pl:199
34598 msgid ""
34599 "To choose a fixed size output disk, specify an absolute number followed by b/"
34600 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34601 "Petabytes or Exabytes.  This must be large enough to contain all the input "
34602 "files, else you will get an error."
34603 msgstr ""
34604
34605 # type: textblock
34606 #. type: textblock
34607 #: ../tools/virt-make-fs.pl:204
34608 msgid ""
34609 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
34610 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34611 "Petabytes or Exabytes.  For example: C<--size=+200M> means enough space for "
34612 "the input files, and (approximately) an extra 200 MB free space."
34613 msgstr ""
34614
34615 # type: textblock
34616 #. type: textblock
34617 #: ../tools/virt-make-fs.pl:210
34618 msgid ""
34619 "Note that virt-make-fs estimates free space, and therefore will not produce "
34620 "filesystems containing precisely the free space requested.  (It is much more "
34621 "expensive and time-consuming to produce a filesystem which has precisely the "
34622 "desired free space)."
34623 msgstr ""
34624
34625 # type: =item
34626 #. type: =item
34627 #: ../tools/virt-make-fs.pl:219
34628 msgid "B<--format=E<lt>fmtE<gt>>"
34629 msgstr ""
34630
34631 # type: =item
34632 #. type: =item
34633 #: ../tools/virt-make-fs.pl:221
34634 msgid "B<-F E<lt>fmtE<gt>>"
34635 msgstr ""
34636
34637 # type: textblock
34638 #. type: textblock
34639 #: ../tools/virt-make-fs.pl:223
34640 msgid "Choose the output disk image format."
34641 msgstr ""
34642
34643 # type: textblock
34644 #. type: textblock
34645 #: ../tools/virt-make-fs.pl:225
34646 msgid "The default is C<raw> (raw disk image)."
34647 msgstr ""
34648
34649 # type: textblock
34650 #. type: textblock
34651 #: ../tools/virt-make-fs.pl:227
34652 msgid ""
34653 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
34654 "that would really make sense here is C<qcow2>."
34655 msgstr ""
34656
34657 # type: =item
34658 #. type: =item
34659 #: ../tools/virt-make-fs.pl:234
34660 msgid "B<--type=E<lt>fsE<gt>>"
34661 msgstr ""
34662
34663 # type: =item
34664 #. type: =item
34665 #: ../tools/virt-make-fs.pl:236
34666 msgid "B<-t E<lt>fsE<gt>>"
34667 msgstr ""
34668
34669 # type: textblock
34670 #. type: textblock
34671 #: ../tools/virt-make-fs.pl:238
34672 msgid "Choose the output filesystem type."
34673 msgstr ""
34674
34675 # type: textblock
34676 #. type: textblock
34677 #: ../tools/virt-make-fs.pl:240
34678 msgid "The default is C<ext2>."
34679 msgstr ""
34680
34681 # type: textblock
34682 #. type: textblock
34683 #: ../tools/virt-make-fs.pl:242
34684 msgid ""
34685 "Any filesystem which is supported read-write by libguestfs can be used here."
34686 msgstr ""
34687
34688 # type: =item
34689 #. type: =item
34690 #: ../tools/virt-make-fs.pl:249
34691 msgid "B<--partition>"
34692 msgstr ""
34693
34694 # type: =item
34695 #. type: =item
34696 #: ../tools/virt-make-fs.pl:251
34697 msgid "B<--partition=E<lt>parttypeE<gt>>"
34698 msgstr ""
34699
34700 # type: textblock
34701 #. type: textblock
34702 #: ../tools/virt-make-fs.pl:253
34703 msgid ""
34704 "If specified, this flag adds an MBR partition table to the output disk image."
34705 msgstr ""
34706
34707 # type: textblock
34708 #. type: textblock
34709 #: ../tools/virt-make-fs.pl:256
34710 msgid ""
34711 "You can change the partition table type, eg. C<--partition=gpt> for large "
34712 "disks."
34713 msgstr ""
34714
34715 # type: textblock
34716 #. type: textblock
34717 #: ../tools/virt-make-fs.pl:259
34718 msgid ""
34719 "Note that if you just use a lonesome C<--partition>, the Perl option parser "
34720 "might consider the next parameter to be the partition type.  For example:"
34721 msgstr ""
34722
34723 # type: verbatim
34724 #. type: verbatim
34725 #: ../tools/virt-make-fs.pl:263
34726 #, no-wrap
34727 msgid ""
34728 " virt-make-fs --partition input.tar ...\n"
34729 "\n"
34730 msgstr ""
34731
34732 # type: textblock
34733 #. type: textblock
34734 #: ../tools/virt-make-fs.pl:265
34735 msgid ""
34736 "would cause virt-make-fs to think you wanted to use a partition type of "
34737 "C<input.tar> which is completely wrong.  To avoid this, use C<--> (a double "
34738 "dash) between options and the input file argument:"
34739 msgstr ""
34740
34741 # type: verbatim
34742 #. type: verbatim
34743 #: ../tools/virt-make-fs.pl:269
34744 #, no-wrap
34745 msgid ""
34746 " virt-make-fs --partition -- input.tar ...\n"
34747 "\n"
34748 msgstr ""
34749
34750 #. type: textblock
34751 #: ../tools/virt-make-fs.pl:536
34752 msgid ""
34753 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
34754 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
34755 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
34756 msgstr ""
34757
34758 # type: verbatim
34759 #. type: verbatim
34760 #: ../tools/virt-make-fs.pl:553
34761 #, no-wrap
34762 msgid ""
34763 " export LIBGUESTFS_DEBUG=1\n"
34764 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
34765 "\n"
34766 msgstr ""
34767
34768 # type: textblock
34769 #. type: textblock
34770 #: ../tools/virt-make-fs.pl:556
34771 msgid ""
34772 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
34773 "redhat.com/>"
34774 msgstr ""
34775
34776 # type: textblock
34777 #. type: textblock
34778 #: ../tools/virt-list-partitions.pl:32
34779 msgid ""
34780 "virt-list-partitions - List partitions in a virtual machine or disk image"
34781 msgstr ""
34782
34783 # type: verbatim
34784 #. type: verbatim
34785 #: ../tools/virt-list-partitions.pl:36
34786 #, no-wrap
34787 msgid ""
34788 " virt-list-partitions [--options] domname\n"
34789 "\n"
34790 msgstr ""
34791
34792 # type: verbatim
34793 #. type: verbatim
34794 #: ../tools/virt-list-partitions.pl:38
34795 #, no-wrap
34796 msgid ""
34797 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
34798 "\n"
34799 msgstr ""
34800
34801 # type: textblock
34802 #. type: textblock
34803 #: ../tools/virt-list-partitions.pl:45
34804 msgid ""
34805 "C<virt-list-partitions> is a command line tool to list the partitions that "
34806 "are contained in a virtual machine or disk image.  It is mainly useful as a "
34807 "first step to using L<virt-resize(1)>."
34808 msgstr ""
34809
34810 # type: textblock
34811 #. type: textblock
34812 #: ../tools/virt-list-partitions.pl:50
34813 msgid ""
34814 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
34815 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34816 "> tool."
34817 msgstr ""
34818
34819 # type: =item
34820 #. type: =item
34821 #: ../tools/virt-list-partitions.pl:107
34822 msgid "B<-h> | B<--human-readable>"
34823 msgstr ""
34824
34825 # type: textblock
34826 #. type: textblock
34827 #: ../tools/virt-list-partitions.pl:109
34828 msgid "Show sizes in human-readable form (eg. \"1G\")."
34829 msgstr ""
34830
34831 # type: textblock
34832 #. type: textblock
34833 #: ../tools/virt-list-partitions.pl:117
34834 msgid ""
34835 "With this option, C<virt-list-partitions> displays the type and size of each "
34836 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
34837 msgstr ""
34838
34839 # type: =item
34840 #. type: =item
34841 #: ../tools/virt-list-partitions.pl:124
34842 msgid "B<-t> | B<--total>"
34843 msgstr ""
34844
34845 # type: textblock
34846 #. type: textblock
34847 #: ../tools/virt-list-partitions.pl:126
34848 msgid ""
34849 "Display the total size of each block device (as a separate row or rows)."
34850 msgstr ""
34851
34852 # type: textblock
34853 #. type: textblock
34854 #: ../tools/virt-list-partitions.pl:259
34855 msgid ""
34856 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
34857 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
34858 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34859 msgstr ""