+#. type: verbatim
+#: ../src/guestfs-structs.pod:218
+#, no-wrap
+msgid ""
+" struct guestfs_inotify_event_list {\n"
+" uint32_t len; /* Number of elements in list. */\n"
+" struct guestfs_inotify_event *val; /* Elements. */\n"
+" };\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-structs.pod:223
+#, no-wrap
+msgid ""
+" void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
+" void guestfs_free_inotify_event_list (struct "
+"guestfs_free_inotify_event_list *);\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-structs.pod:226
+msgid "guestfs_partition"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-structs.pod:228
+#, no-wrap
+msgid ""
+" struct guestfs_partition {\n"
+" int32_t part_num;\n"
+" uint64_t part_start;\n"
+" uint64_t part_end;\n"
+" uint64_t part_size;\n"
+" };\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-structs.pod:235
+#, no-wrap
+msgid ""
+" struct guestfs_partition_list {\n"
+" uint32_t len; /* Number of elements in list. */\n"
+" struct guestfs_partition *val; /* Elements. */\n"
+" };\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-structs.pod:240
+#, no-wrap
+msgid ""
+" void guestfs_free_partition (struct guestfs_free_partition *);\n"
+" void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../src/guestfs-structs.pod:243
+msgid "guestfs_application"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-structs.pod:245
+#, no-wrap
+msgid ""
+" struct guestfs_application {\n"
+" char *app_name;\n"
+" char *app_display_name;\n"
+" int32_t app_epoch;\n"
+" char *app_version;\n"
+" char *app_release;\n"
+" char *app_install_path;\n"
+" char *app_trans_path;\n"
+" char *app_publisher;\n"
+" char *app_url;\n"
+" char *app_source_package;\n"
+" char *app_summary;\n"
+" char *app_description;\n"
+" };\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-structs.pod:260
+#, no-wrap
+msgid ""
+" struct guestfs_application_list {\n"
+" uint32_t len; /* Number of elements in list. */\n"
+" struct guestfs_application *val; /* Elements. */\n"
+" };\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../src/guestfs-structs.pod:265
+#, no-wrap
+msgid ""
+" void guestfs_free_application (struct guestfs_free_application *);\n"
+" void guestfs_free_application_list (struct guestfs_free_application_list "
+"*);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:5
+msgid "guestfish - the libguestfs Filesystem Interactive SHell"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:9
+#, no-wrap
+msgid ""
+" guestfish [--options] [commands]\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:11
+#, no-wrap
+msgid ""
+" guestfish\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:13
+#, no-wrap
+msgid ""
+" guestfish [--ro|--rw] -a disk.img\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:15
+#, no-wrap
+msgid ""
+" guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:17
+#, no-wrap
+msgid ""
+" guestfish -d libvirt-domain\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:19
+#, no-wrap
+msgid ""
+" guestfish [--ro|--rw] -a disk.img -i\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:21
+#, no-wrap
+msgid ""
+" guestfish -d libvirt-domain -i\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44 ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:59
+msgid "WARNING"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:25
+msgid ""
+"Using guestfish in read/write mode on live virtual machines can be "
+"dangerous, potentially causing disk corruption. Use the I<--ro> (read-only) "
+"option to use guestfish safely if the disk image or virtual machine might be "
+"live."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:32
+msgid ""
+"Guestfish is a shell and command-line tool for examining and modifying "
+"virtual machine filesystems. It uses libguestfs and exposes all of the "
+"functionality of the guestfs API, see L<guestfs(3)>."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:36
+msgid ""
+"Guestfish gives you structured access to the libguestfs API, from shell "
+"scripts or the command line or interactively. If you want to rescue a "
+"broken virtual machine image, you should look at the L<virt-rescue(1)> "
+"command."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:41 ../fish/guestfish.pod:908 ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63 ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:45
+msgid "EXAMPLES"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:43
+msgid "As an interactive shell"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:45
+#, no-wrap
+msgid ""
+" $ guestfish\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:47
+#, no-wrap
+msgid ""
+" Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
+" editing virtual machine filesystems.\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:50
+#, no-wrap
+msgid ""
+" Type: 'help' for a list of commands\n"
+" 'man' to read the manual\n"
+" 'quit' to quit the shell\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:54
+#, no-wrap
+msgid ""
+" ><fs> add-ro disk.img\n"
+" ><fs> run\n"
+" ><fs> list-filesystems\n"
+" /dev/sda1: ext4\n"
+" /dev/vg_guest/lv_root: ext4\n"
+" /dev/vg_guest/lv_swap: swap\n"
+" ><fs> mount /dev/vg_guest/lv_root /\n"
+" ><fs> cat /etc/fstab\n"
+" # /etc/fstab\n"
+" # Created by anaconda\n"
+" [...]\n"
+" ><fs> exit\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:67
+msgid "From shell scripts"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:69
+msgid "Create a new C</etc/motd> file in a guest or disk image:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:71
+#, no-wrap
+msgid ""
+" guestfish <<_EOF_\n"
+" add disk.img\n"
+" run\n"
+" mount /dev/vg_guest/lv_root /\n"
+" write /etc/motd \"Welcome, new users\"\n"
+" _EOF_\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:78
+msgid "List the LVM logical volumes in a disk image:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:80
+#, no-wrap
+msgid ""
+" guestfish -a disk.img --ro <<_EOF_\n"
+" run\n"
+" lvs\n"
+" _EOF_\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:85
+msgid "List all the filesystems in a disk image:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:87
+#, no-wrap
+msgid ""
+" guestfish -a disk.img --ro <<_EOF_\n"
+" run\n"
+" list-filesystems\n"
+" _EOF_\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:92
+msgid "On one command line"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:94
+msgid "Update C</etc/resolv.conf> in a guest:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:96
+#, no-wrap
+msgid ""
+" guestfish \\\n"
+" add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
+" write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:100
+msgid "Edit C</boot/grub/grub.conf> interactively:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:102
+#, no-wrap
+msgid ""
+" guestfish --rw --add disk.img \\\n"
+" --mount /dev/vg_guest/lv_root \\\n"
+" --mount /dev/sda1:/boot \\\n"
+" edit /boot/grub/grub.conf\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:107
+msgid "Mount disks automatically"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:109
+msgid ""
+"Use the I<-i> option to automatically mount the disks from a virtual "
+"machine:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:112
+#, no-wrap
+msgid ""
+" guestfish --ro -a disk.img -i cat /etc/group\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:114
+#, no-wrap
+msgid ""
+" guestfish --ro -d libvirt-domain -i cat /etc/group\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:116
+msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:118
+#, no-wrap
+msgid ""
+" guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:120
+msgid "As a script interpreter"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:122
+msgid "Create a 100MB disk containing an ext2-formatted partition:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:124
+#, no-wrap
+msgid ""
+" #!/usr/bin/guestfish -f\n"
+" sparse test1.img 100M\n"
+" run\n"
+" part-disk /dev/sda mbr\n"
+" mkfs ext2 /dev/sda1\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:130
+msgid "Start with a prepared disk"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:132
+msgid ""
+"An alternate way to create a 100MB disk called C<test1.img> containing a "
+"single ext2-formatted partition:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:135
+#, no-wrap
+msgid ""
+" guestfish -N fs\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:137
+msgid "To list what is available do:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:139 ../fish/guestfish.pod:899
+#, no-wrap
+msgid ""
+" guestfish -N help | less\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:141
+msgid "Remote control"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:143
+#, no-wrap
+msgid ""
+" eval \"`guestfish --listen`\"\n"
+" guestfish --remote add-ro disk.img\n"
+" guestfish --remote run\n"
+" guestfish --remote lvs\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37 ../fuse/guestmount.pod:73 ../tools/virt-edit.pl:77 ../tools/virt-win-reg.pl:96 ../tools/virt-resize.pl:254 ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:98 ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
+msgid "OPTIONS"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:131 ../tools/virt-edit.pl:85 ../tools/virt-win-reg.pl:104 ../tools/virt-resize.pl:262 ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:106 ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62
+msgid "B<--help>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:154
+msgid "Displays general help on options."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:156
+msgid "B<-h>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:158
+msgid "B<--cmd-help>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:160
+msgid "Lists all available guestfish commands."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:162
+msgid "B<-h cmd>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:164
+msgid "B<--cmd-help cmd>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:166
+msgid "Displays detailed help on a single command C<cmd>."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:168
+msgid "B<-a image>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:170
+msgid "B<--add image>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:172
+msgid "Add a block device or virtual machine image to the shell."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:81
+msgid ""
+"The format of the disk image is auto-detected. To override this and force a "
+"particular format use the I<--format=..> option."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:177
+msgid ""
+"Using this flag is mostly equivalent to using the C<add> command, with "
+"C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
+"the I<--format=...> flag was given."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:181
+msgid "B<-c URI>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:183
+msgid "B<--connect URI>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:86
+msgid ""
+"When used in conjunction with the I<-d> option, this specifies the libvirt "
+"URI to use. The default is to use the default libvirt connection."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:189
+msgid "B<--csh>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:191
+msgid ""
+"If using the I<--listen> option and a csh-like shell, use this option. See "
+"section L</REMOTE CONTROL AND CSH> below."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:194
+msgid "B<-d libvirt-domain>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:196
+msgid "B<--domain libvirt-domain>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:92
+msgid ""
+"Add disks from the named libvirt domain. If the I<--ro> option is also "
+"used, then any libvirt domain can be used. However in write mode, only "
+"libvirt domains which are shut down can be named here."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:202
+msgid ""
+"Using this flag is mostly equivalent to using the C<add-domain> command, "
+"with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
+"if the I<--format:...> flag was given."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:206
+msgid "B<-D>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:208
+msgid "B<--no-dest-paths>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:210
+msgid ""
+"Don't tab-complete paths on the guest filesystem. It is useful to be able "
+"to hit the tab key to complete paths on the guest filesystem, but this "
+"causes extra \"hidden\" guestfs calls to be made, so this option is here to "
+"allow this feature to be disabled."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:108
+msgid "B<--echo-keys>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:110
+msgid ""
+"When prompting for keys and passphrases, guestfish normally turns echoing "
+"off so you cannot see what you are typing. If you are not worried about "
+"Tempest attacks and there is no one else in the room you can specify this "
+"flag to see what you are typing."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:222
+msgid "B<-f file>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:224
+msgid "B<--file file>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:226
+msgid "Read commands from C<file>. To write pure guestfish scripts, use:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:229
+#, no-wrap
+msgid ""
+" #!/usr/bin/guestfish -f\n"
+"\n"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:231
+msgid "B<--format=raw|qcow2|..>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:233
+msgid "B<--format>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:117
+msgid ""
+"The default for the I<-a> option is to auto-detect the format of the disk "
+"image. Using this forces the disk format for I<-a> options which follow on "
+"the command line. Using I<--format> with no argument switches back to "
+"auto-detection for subsequent I<-a> options."
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:242
+#, no-wrap
+msgid ""
+" guestfish --format=raw -a disk.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:244
+msgid "forces raw format (no auto-detection) for C<disk.img>."
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:246
+#, no-wrap
+msgid ""
+" guestfish --format=raw -a disk.img --format -a another.img\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:248
+msgid ""
+"forces raw format (no auto-detection) for C<disk.img> and reverts to "
+"auto-detection for C<another.img>."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:251
+msgid ""
+"If you have untrusted raw-format guest disk images, you should use this "
+"option to specify the disk format. This avoids a possible security problem "
+"with malicious guests (CVE-2010-3851). See also L</add-drive-opts>."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:256
+msgid "B<-i>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:258
+msgid "B<--inspector>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:137
+msgid ""
+"Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
+"system and mount filesystems as they would be mounted on the real virtual "
+"machine."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:264
+msgid "Typical usage is either:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:266
+#, no-wrap
+msgid ""
+" guestfish -d myguest -i\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:268
+msgid "(for an inactive libvirt domain called I<myguest>), or:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:270
+#, no-wrap
+msgid ""
+" guestfish --ro -d myguest -i\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:272
+msgid "(for active domains, readonly), or specify the block device directly:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:274
+#, no-wrap
+msgid ""
+" guestfish --rw -a /dev/Guests/MyGuest -i\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:276
+msgid ""
+"Note that the command line syntax changed slightly over older versions of "
+"guestfish. You can still use the old syntax:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:279
+#, no-wrap
+msgid ""
+" guestfish [--ro] -i disk.img\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:281
+#, no-wrap
+msgid ""
+" guestfish [--ro] -i libvirt-domain\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:283
+msgid ""
+"Using this flag is mostly equivalent to using the C<inspect-os> command and "
+"then using other commands to mount the filesystems that were found."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:141
+msgid "B<--keys-from-stdin>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:143
+msgid ""
+"Read key or passphrase parameters from stdin. The default is to try to read "
+"passphrases from the user by opening C</dev/tty>."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:292
+msgid "B<--listen>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:294
+msgid ""
+"Fork into the background and listen for remote commands. See section "
+"L</REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:297
+msgid "B<-m dev[:mountpoint]>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:299
+msgid "B<--mount dev[:mountpoint]>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:301
+msgid "Mount the named partition or logical volume on the given mountpoint."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:303
+msgid "If the mountpoint is omitted, it defaults to C</>."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:305
+msgid "You have to mount something on C</> before most commands will work."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:307
+msgid ""
+"If any I<-m> or I<--mount> options are given, the guest is automatically "
+"launched."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:310
+msgid ""
+"If you don't know what filesystems a disk image contains, you can either run "
+"guestfish without this option, then list the partitions, filesystems and LVs "
+"available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
+"commands), or you can use the L<virt-filesystems(1)> program."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:316
+msgid ""
+"Using this flag is mostly equivalent to using the C<mount-options> command "
+"or the C<mount-ro> command if the I<--ro> flag was given."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:319
+msgid "B<-n>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:321
+msgid "B<--no-sync>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:323
+msgid ""
+"Disable autosync. This is enabled by default. See the discussion of "
+"autosync in the L<guestfs(3)> manpage."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:326
+msgid "B<-N type>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:328
+msgid "B<--new type>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:330
+msgid "B<-N help>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:332
+msgid ""
+"Prepare a fresh disk image formatted as \"type\". This is an alternative to "
+"the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
+"preformatted disk with a filesystem and adds it. See L</PREPARED DISK "
+"IMAGES> below."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:337
+msgid "B<--progress-bars>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:339
+msgid "Enable progress bars, even when guestfish is used non-interactively."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:341
+msgid ""
+"Progress bars are enabled by default when guestfish is used as an "
+"interactive shell."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:344
+msgid "B<--no-progress-bars>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:346
+msgid "Disable progress bars."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:348
+msgid "B<--remote[=pid]>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:350
+msgid ""
+"Send remote commands to C<$GUESTFISH_PID> or C<pid>. See section L</REMOTE "
+"CONTROL GUESTFISH OVER A SOCKET> below."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:353
+msgid "B<-r>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:355
+msgid "B<--ro>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:357
+msgid ""
+"This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
+"mounts are done read-only."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:360
+msgid ""
+"The option must always be used if the disk image or virtual machine might be "
+"running, and is generally recommended in cases where you don't need write "
+"access to the disk."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:364
+msgid ""
+"Note that prepared disk images created with I<-N> are not affected by this "
+"option. Also commands like C<add> are not affected - you have to specify "
+"the C<readonly:true> option explicitly if you need it."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:368
+msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:370 ../fuse/guestmount.pod:208
+msgid "B<--selinux>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:372
+msgid "Enable SELinux support for the guest. See L<guestfs(3)/SELINUX>."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:374
+msgid "B<-v>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:376
+msgid "B<--verbose>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:378
+msgid ""
+"Enable very verbose messages. This is particularly useful if you find a "
+"bug."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:381
+msgid "B<-V>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:383 ../tools/virt-edit.pl:93 ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270 ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:114 ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
+msgid "B<--version>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:385
+msgid "Display the guestfish / libguestfs version number and exit."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:387
+msgid "B<-w>"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:389
+msgid "B<--rw>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:391
+msgid ""
+"This option does nothing at the moment. See L</OPENING DISKS FOR READ AND "
+"WRITE> below."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:394
+msgid "B<-x>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:396
+msgid "Echo each command before executing it."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:400
+msgid "COMMANDS ON COMMAND LINE"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:402
+msgid "Any additional (non-option) arguments are treated as commands to execute."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:405
+msgid ""
+"Commands to execute should be separated by a colon (C<:>), where the colon "
+"is a separate parameter. Thus:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:408
+#, no-wrap
+msgid ""
+" guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:410
+msgid ""
+"If there are no additional arguments, then we enter a shell, either an "
+"interactive shell with a prompt (if the input is a terminal) or a "
+"non-interactive shell."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:414
+msgid ""
+"In either command line mode or non-interactive shell, the first command that "
+"gives an error causes the whole shell to exit. In interactive mode (with a "
+"prompt) if a command fails, you can continue to enter commands."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:419
+msgid "USING launch (OR run)"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:421
+msgid ""
+"As with L<guestfs(3)>, you must first configure your guest by adding disks, "
+"then launch it, then mount any disks you need, and finally issue "
+"actions/commands. So the general order of the day is:"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:429
+msgid "add or -a/--add"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:433
+msgid "launch (aka run)"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:437
+msgid "mount or -m/--mount"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:441
+msgid "any other commands"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:445
+msgid ""
+"C<run> is a synonym for C<launch>. You must C<launch> (or C<run>) your "
+"guest before mounting or performing any other commands."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:448
+msgid ""
+"The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
+"I<--new> options were given then C<run> is done automatically, simply "
+"because guestfish can't perform the action you asked for without doing this."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:453
+msgid "OPENING DISKS FOR READ AND WRITE"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:455
+msgid ""
+"The guestfish (and L<guestmount(1)>) options I<--ro> and I<--rw> affect "
+"whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> "
+"open disk images read-only or for writing."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:459
+msgid ""
+"In libguestfs E<lt> 1.6.2, guestfish and guestmount defaulted to opening "
+"disk images supplied on the command line for write. To open a disk image "
+"read-only you have to do I<-a image --ro>."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:463
+msgid ""
+"This matters: If you accidentally open a live VM disk image writable then "
+"you will cause irreversible disk corruption."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:466
+msgid ""
+"By libguestfs 1.10 we intend to change the default the other way. Disk "
+"images will be opened read-only. You will have to either specify "
+"I<guestfish --rw> or change a configuration file in order to get write "
+"access for disk images specified by those other command line options."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:471
+msgid ""
+"This version of guestfish has a I<--rw> option which does nothing (it is "
+"already the default). However it is highly recommended that you use this "
+"option to indicate that guestfish needs write access, and to prepare your "
+"scripts for the day when this option will be required for write access."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:477
+msgid ""
+"B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
+"other libguestfs program apart from guestfish and guestmount."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:480
+msgid "QUOTING"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:482
+msgid ""
+"You can quote ordinary parameters using either single or double quotes. For "
+"example:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:485
+#, no-wrap
+msgid ""
+" add \"file with a space.img\"\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:487
+#, no-wrap
+msgid ""
+" rm '/file name'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:489
+#, no-wrap
+msgid ""
+" rm '/\"'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:491
+msgid ""
+"A few commands require a list of strings to be passed. For these, use a "
+"whitespace-separated list, enclosed in quotes. Strings containing "
+"whitespace to be passed through must be enclosed in single quotes. A "
+"literal single quote must be escaped with a backslash."
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:496
+#, no-wrap
+msgid ""
+" vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
+" command \"/bin/echo 'foo bar'\"\n"
+" command \"/bin/echo \\'foo\\'\"\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:500
+msgid "OPTIONAL ARGUMENTS"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:502
+msgid ""
+"Some commands take optional arguments. These arguments appear in this "
+"documentation as C<[argname:..]>. You can use them as in these examples:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:506
+#, no-wrap
+msgid ""
+" add-drive-opts filename\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:508
+#, no-wrap
+msgid ""
+" add-drive-opts filename readonly:true\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:510
+#, no-wrap
+msgid ""
+" add-drive-opts filename format:qcow2 readonly:false\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:512
+msgid ""
+"Each optional argument can appear at most once. All optional arguments must "
+"appear after the required ones."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:515
+msgid "NUMBERS"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:517
+msgid "This section applies to all commands which can take integers as parameters."
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:520
+msgid "SIZE SUFFIX"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:522
+msgid ""
+"When the command takes a parameter measured in bytes, you can use one of the "
+"following suffixes to specify kilobytes, megabytes and larger sizes:"
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:528
+msgid "B<k> or B<K> or B<KiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:530
+msgid "The size in kilobytes (multiplied by 1024)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:532
+msgid "B<KB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:534
+msgid "The size in SI 1000 byte units."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:536
+msgid "B<M> or B<MiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:538
+msgid "The size in megabytes (multiplied by 1048576)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:540
+msgid "B<MB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:542
+msgid "The size in SI 1000000 byte units."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:544
+msgid "B<G> or B<GiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:546
+msgid "The size in gigabytes (multiplied by 2**30)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:548
+msgid "B<GB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:550
+msgid "The size in SI 10**9 byte units."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:552
+msgid "B<T> or B<TiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:554
+msgid "The size in terabytes (multiplied by 2**40)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:556
+msgid "B<TB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:558
+msgid "The size in SI 10**12 byte units."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:560
+msgid "B<P> or B<PiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:562
+msgid "The size in petabytes (multiplied by 2**50)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:564
+msgid "B<PB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:566
+msgid "The size in SI 10**15 byte units."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:568
+msgid "B<E> or B<EiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:570
+msgid "The size in exabytes (multiplied by 2**60)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:572
+msgid "B<EB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:574
+msgid "The size in SI 10**18 byte units."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:576
+msgid "B<Z> or B<ZiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:578
+msgid "The size in zettabytes (multiplied by 2**70)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:580
+msgid "B<ZB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:582
+msgid "The size in SI 10**21 byte units."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:584
+msgid "B<Y> or B<YiB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:586
+msgid "The size in yottabytes (multiplied by 2**80)."
+msgstr ""
+
+#. type: =item
+#: ../fish/guestfish.pod:588
+msgid "B<YB>"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:590
+msgid "The size in SI 10**24 byte units."
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:596
+#, no-wrap
+msgid ""
+" truncate-size /file 1G\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:598
+msgid "would truncate the file to 1 gigabyte."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:600
+msgid ""
+"Be careful because a few commands take sizes in kilobytes or megabytes "
+"(eg. the parameter to L</memsize> is specified in megabytes already). "
+"Adding a suffix will probably not do what you expect."
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:604
+msgid "OCTAL AND HEXADECIMAL NUMBERS"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:606
+msgid ""
+"For specifying the radix (base) use the C convention: C<0> to prefix an "
+"octal number or C<0x> to prefix a hexadecimal number. For example:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:609
+#, no-wrap
+msgid ""
+" 1234 decimal number 1234\n"
+" 02322 octal number, equivalent to decimal 1234\n"
+" 0x4d2 hexadecimal number, equivalent to decimal 1234\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:613
+msgid ""
+"When using the C<chmod> command, you almost always want to specify an octal "
+"number for the mode, and you must prefix it with C<0> (unlike the Unix "
+"L<chmod(1)> program):"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:617
+#, no-wrap
+msgid ""
+" chmod 0777 /public # OK\n"
+" chmod 777 /public # WRONG! This is mode 777 decimal = 01411 octal.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:620
+msgid ""
+"Commands that return numbers usually print them in decimal, but some "
+"commands print numbers in other radices (eg. C<umask> prints the mode in "
+"octal, preceeded by C<0>)."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:624
+msgid "WILDCARDS AND GLOBBING"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:626
+msgid ""
+"Neither guestfish nor the underlying guestfs API performs wildcard expansion "
+"(globbing) by default. So for example the following will not do what you "
+"expect:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:630
+#, no-wrap
+msgid ""
+" rm-rf /home/*\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:632
+msgid ""
+"Assuming you don't have a directory called literally C</home/*> then the "
+"above command will return an error."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:635
+msgid "To perform wildcard expansion, use the C<glob> command."
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:637
+#, no-wrap
+msgid ""
+" glob rm-rf /home/*\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:639
+msgid ""
+"runs C<rm-rf> on each path that matches (ie. potentially running the command "
+"many times), equivalent to:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:642
+#, no-wrap
+msgid ""
+" rm-rf /home/jim\n"
+" rm-rf /home/joe\n"
+" rm-rf /home/mary\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:646
+msgid "C<glob> only works on simple guest paths and not on device names."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:648
+msgid ""
+"If you have several parameters, each containing a wildcard, then glob will "
+"perform a Cartesian product."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:651
+msgid "COMMENTS"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:653
+msgid ""
+"Any line which starts with a I<#> character is treated as a comment and "
+"ignored. The I<#> can optionally be preceeded by whitespace, but B<not> by "
+"a command. For example:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:657
+#, no-wrap
+msgid ""
+" # this is a comment\n"
+" # this is a comment\n"
+" foo # NOT a comment\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:661
+msgid "Blank lines are also ignored."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:663
+msgid "RUNNING COMMANDS LOCALLY"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:665
+msgid ""
+"Any line which starts with a I<!> character is treated as a command sent to "
+"the local shell (C</bin/sh> or whatever L<system(3)> uses). For example:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:669
+#, no-wrap
+msgid ""
+" !mkdir local\n"
+" tgz-out /remote local/remote-data.tar.gz\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:672
+msgid ""
+"will create a directory C<local> on the host, and then export the contents "
+"of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>. "
+"(See C<tgz-out>)."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:676
+msgid ""
+"To change the local directory, use the C<lcd> command. C<!cd> will have no "
+"effect, due to the way that subprocesses work in Unix."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:679
+msgid "PIPES"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:681
+msgid ""
+"Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
+"command (a guestfish command) to the second command (any host command). For "
+"example:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:685
+#, no-wrap
+msgid ""
+" cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:687
+msgid ""
+"(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
+"program). The above command would list all accounts in the guest filesystem "
+"which have UID 0, ie. root accounts including backdoors. Other examples:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:692
+#, no-wrap
+msgid ""
+" hexdump /bin/ls | head\n"
+" list-devices | tail -1\n"
+" tgz-out / - | tar ztf -\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:696
+msgid ""
+"The space before the pipe symbol is required, any space after the pipe "
+"symbol is optional. Everything after the pipe symbol is just passed "
+"straight to the host shell, so it can contain redirections, globs and "
+"anything else that makes sense on the host side."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:701
+msgid ""
+"To use a literal argument which begins with a pipe symbol, you have to quote "
+"it, eg:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:704
+#, no-wrap
+msgid ""
+" echo \"|\"\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:706
+msgid "HOME DIRECTORIES"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:708
+msgid ""
+"If a parameter starts with the character C<~> then the tilde may be expanded "
+"as a home directory path (either C<~> for the current user's home directory, "
+"or C<~user> for another user)."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:712
+msgid ""
+"Note that home directory expansion happens for users known I<on the host>, "
+"not in the guest filesystem."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:715
+msgid ""
+"To use a literal argument which begins with a tilde, you have to quote it, "
+"eg:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:718
+#, no-wrap
+msgid ""
+" echo \"~\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:722
+msgid ""
+"Libguestfs has some support for Linux guests encrypted according to the "
+"Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
+"disk encryption systems used by modern Linux guests. Currently only "
+"LVM-on-LUKS is supported."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:727
+msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:729
+#, no-wrap
+msgid ""
+" ><fs> vfs-type /dev/sda2\n"
+" crypto_LUKS\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:732
+msgid ""
+"Then open those devices using L</luks-open>. This creates a device-mapper "
+"device called C</dev/mapper/luksdev>."
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:735
+#, no-wrap
+msgid ""
+" ><fs> luks-open /dev/sda2 luksdev\n"
+" Enter key or passphrase (\"key\"): <enter the passphrase>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:738
+msgid ""
+"Finally you have to tell LVM to scan for volume groups on the newly created "
+"mapper device:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:741
+#, no-wrap
+msgid ""
+" vgscan\n"
+" vg-activate-all true\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:744
+msgid "The logical volume(s) can now be mounted in the usual way."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:746
+msgid ""
+"Before closing a LUKS device you must unmount any logical volumes on it and "
+"deactivate the volume groups by calling C<vg-activate false VG> on each "
+"one. Then you can close the mapper device:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:750
+#, no-wrap
+msgid ""
+" vg-activate false /dev/VG\n"
+" luks-close /dev/mapper/luksdev\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:753
+msgid "WINDOWS PATHS"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:755
+msgid ""
+"If a path is prefixed with C<win:> then you can use Windows-style paths "
+"(with some limitations). The following commands are equivalent:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:758
+#, no-wrap
+msgid ""
+" file /WINDOWS/system32/config/system.LOG\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:760
+#, no-wrap
+msgid ""
+" file win:/windows/system32/config/system.log\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:762
+#, no-wrap
+msgid ""
+" file win:\\windows\\system32\\config\\system.log\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:764
+#, no-wrap
+msgid ""
+" file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:766
+msgid ""
+"This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also "
+"handles case insensitivity like Windows would. This only works in argument "
+"positions that expect a path."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:770
+msgid "UPLOADING AND DOWNLOADING FILES"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:772
+msgid ""
+"For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
+"others which upload from or download to a local file, you can use the "
+"special filename C<-> to mean \"from stdin\" or \"to stdout\". For example:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:776
+#, no-wrap
+msgid ""
+" upload - /foo\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:778
+msgid "reads stdin and creates from that a file C</foo> in the disk image, and:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:781
+#, no-wrap
+msgid ""
+" tar-out /etc - | tar tf -\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:783
+msgid ""
+"writes the tarball to stdout and then pipes that into the external \"tar\" "
+"command (see L</PIPES>)."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:786
+msgid ""
+"When using C<-> to read from stdin, the input is read up to the end of "
+"stdin. You can also use a special \"heredoc\"-like syntax to read up to "
+"some arbitrary end marker:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:790
+#, no-wrap
+msgid ""
+" upload -<<END /foo\n"
+" input line 1\n"
+" input line 2\n"
+" input line 3\n"
+" END\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:796
+msgid ""
+"Any string of characters can be used instead of C<END>. The end marker must "
+"appear on a line of its own, without any preceeding or following characters "
+"(not even spaces)."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:800
+msgid ""
+"Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
+"upload local files (so-called \"FileIn\" parameters in the generator)."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:803
+msgid "EXIT ON ERROR BEHAVIOUR"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:805
+msgid ""
+"By default, guestfish will ignore any errors when in interactive mode "
+"(ie. taking commands from a human over a tty), and will exit on the first "
+"error in non-interactive mode (scripts, commands given on the command line)."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:810
+msgid ""
+"If you prefix a command with a I<-> character, then that command will not "
+"cause guestfish to exit, even if that (one) command returns an error."
+msgstr ""
+
+#. type: =head1
+#: ../fish/guestfish.pod:814
+msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:816
+msgid ""
+"Guestfish can be remote-controlled over a socket. This is useful "
+"particularly in shell scripts where you want to make several different "
+"changes to a filesystem, but you don't want the overhead of starting up a "
+"guestfish process each time."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:821
+msgid "Start a guestfish server process using:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:823
+#, no-wrap
+msgid ""
+" eval \"`guestfish --listen`\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:825
+msgid "and then send it commands by doing:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:827
+#, no-wrap
+msgid ""
+" guestfish --remote cmd [...]\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:829
+msgid "To cause the server to exit, send it the exit command:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:831
+#, no-wrap
+msgid ""
+" guestfish --remote exit\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:833
+msgid ""
+"Note that the server will normally exit if there is an error in a command. "
+"You can change this in the usual way. See section L</EXIT ON ERROR "
+"BEHAVIOUR>."
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:837
+msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:839
+msgid ""
+"The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
+"is how the I<--remote> option knows where to send the commands. You can "
+"have several guestfish listener processes running using:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:843
+#, no-wrap
+msgid ""
+" eval \"`guestfish --listen`\"\n"
+" pid1=$GUESTFISH_PID\n"
+" eval \"`guestfish --listen`\"\n"
+" pid2=$GUESTFISH_PID\n"
+" ...\n"
+" guestfish --remote=$pid1 cmd\n"
+" guestfish --remote=$pid2 cmd\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:851
+msgid "REMOTE CONTROL AND CSH"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:853
+msgid ""
+"When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
+"option:"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:856
+#, no-wrap
+msgid ""
+" eval \"`guestfish --listen --csh`\"\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:858
+msgid "REMOTE CONTROL DETAILS"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:860
+msgid ""
+"Remote control happens over a Unix domain socket called "
+"C</tmp/.guestfish-$UID/socket-$PID>, where C<$UID> is the effective user ID "
+"of the process, and C<$PID> is the process ID of the server."
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:864
+msgid "Guestfish client and server versions must match exactly."
+msgstr ""
+
+#. type: =head2
+#: ../fish/guestfish.pod:866
+msgid "REMOTE CONTROL RUN COMMAND HANGING"
+msgstr ""
+
+#. type: textblock
+#: ../fish/guestfish.pod:868
+msgid ""
+"Using the C<run> (or C<launch>) command remotely in a command substitution "
+"context hangs, ie. don't do (note the backquotes):"
+msgstr ""
+
+#. type: verbatim
+#: ../fish/guestfish.pod:871
git.annexia.org / libguestfs.git / blobdiff