libguestfs 1.39.12 - en to en_GB translation catalogue (57 entries)

note: type: textblock
en: When the guest OS is virtualized, the host operating system and hypervisor may prefer accesses aligned to one of:
en_GB: When the guest OS is virtualised, the host operating system and hypervisor may prefer accesses aligned to one of:

note: type: textblock
en: The fields are normally space-separated.  Filenames are B<not> quoted, so you cannot use the output in another program (because filenames can contain spaces and other unsafe characters).  If the guest was untrusted and someone knew you were using C<virt-ls> to analyze the guest, they could play tricks on you by creating filenames with embedded newline characters.  To B<safely> parse the output in another program, use the I<--csv> (Comma-Separated Values) option.
en_GB: The fields are normally space-separated.  Filenames are B<not> quoted, so you cannot use the output in another program (because filenames can contain spaces and other unsafe characters).  If the guest was untrusted and someone knew you were using C<virt-ls> to analyse the guest, they could play tricks on you by creating filenames with embedded newline characters.  To B<safely> parse the output in another program, use the I<--csv> (Comma-Separated Values) option.

note: type: textblock
en: Virt tools (website: L<http://virt-tools.org>) are a whole set of virtualization management tools aimed at system administrators.  Some of them come from libguestfs, some from libvirt and many others from other open source projects.  So virt tools is a superset of libguestfs.  However libguestfs comes with many important tools.  See L<http://libguestfs.org> for a full list.
en_GB: Virt tools (website: L<http://virt-tools.org>) are a whole set of virtualisation management tools aimed at system administrators.  Some of them come from libguestfs, some from libvirt and many others from other open source projects.  So virt tools is a superset of libguestfs.  However libguestfs comes with many important tools.  See L<http://libguestfs.org> for a full list.

note: type: textblock
en: Another method we have considered is to place a snapshot over the original disk image, so that the original data is untouched and only differences are recorded in the snapshot.  You can do this today using C<qemu-img create> + C<virt-resize>, but qemu currently isn't smart enough to recognize when the same block is written back to the snapshot as already exists in the backing disk, so you will find that this doesn't save you any space or time.
en_GB: Another method we have considered is to place a snapshot over the original disk image, so that the original data is untouched and only differences are recorded in the snapshot.  You can do this today using C<qemu-img create> + C<virt-resize>, but qemu currently isn't smart enough to recognise when the same block is written back to the snapshot as already exists in the backing disk, so you will find that this doesn't save you any space or time.

note: type: textblock
en: Language bindings should come with tests.  Previously testing of language bindings was rather ad-hoc, but we have been trying to formalize the set of tests that every language binding should use.
en_GB: Language bindings should come with tests.  Previously testing of language bindings was rather ad-hoc, but we have been trying to formalise the set of tests that every language binding should use.

note: type: =head2
en: INTERNATIONALIZATION (I18N) SUPPORT
en_GB: INTERNATIONALISATION (I18N) SUPPORT

note: type: =item
en: Initialize the appliance
en_GB: Initialise the appliance

note: type: textblock
en: The appliance itself now initializes itself.  This involves starting certain processes like C<udev>, possibly printing some debug information, and finally running the daemon (C<guestfsd>).
en_GB: The appliance itself now initialises itself.  This involves starting certain processes like C<udev>, possibly printing some debug information, and finally running the daemon (C<guestfsd>).

note: type: textblock
en: Three main areas are covered. Libguestfs runs an appliance (a small Linux distribution) inside qemu/KVM.  The first two areas are: minimizing the time taken to start this appliance, and the number of times the appliance has to be started.  The third area is shortening the time taken for inspection of VMs.
en_GB: Three main areas are covered. Libguestfs runs an appliance (a small Linux distribution) inside qemu/KVM.  The first two areas are: minimising the time taken to start this appliance, and the number of times the appliance has to be started.  The third area is shortening the time taken for inspection of VMs.

note: type: textblock
en: Hardware virt is not usually available inside VMs, and libguestfs will run slowly inside another virtual machine whatever you do.  Nested virtualization does not work well in our experience, and is certainly no substitute for running libguestfs on baremetal.
en_GB: Hardware virt is not usually available inside VMs, and libguestfs will run slowly inside another virtual machine whatever you do.  Nested virtualisation does not work well in our experience, and is certainly no substitute for running libguestfs on baremetal.

note: type: verbatim
en:  - A series of protocol fixes has fixed the old bug RHBZ#576879
       which used to cause errors during the upload command to lose
       protocol synchronization.
en_GB:  - A series of protocol fixes has fixed the old bug RHBZ#576879
       which used to cause errors during the upload command to lose
       protocol synchronisation.

note: type: verbatim
en:  - is-zero, is-zero-device APIs: optimize these so zero detection is
       faster.
en_GB:  - is-zero, is-zero-device APIs: optimise these so zero detection is
       faster.

note: type: verbatim
en:  - 822490 virt-ls error: "libguestfs: error: checksum: path: parameter cannot be NULL"
     - 816839 data overflow error when debug progress -1
     - 816098 virt-make-fs fails to make a btrfs filesystem because it doesn't allocate enough space
     - 811872 inspection fails on ubuntu 10.04 guest with encrypted swap
     - 811650 guestfs_last_error not set when qemu fails early during launch
     - 811649 libguestfs cannot open disk images which are symlinks to files that contain ':' (colon) character
     - 811117 [RFE][virt-sysprep] net-hwaddr not removed from "ifcfg-*" files on rhel
     - 811112 [RFE][virt-sysprep] hostname can not be changed on rhel system
     - 809361 inspection doesn't recognize Fedora 18 (grub2 + GPT)
     - 807905 mkfs blocksize option breaks when creating btrfs
     - 805070 virt-filesystems should show 'parents' of LV and RAID devices
     - 804464 libguestfs cannot be built when LINGUAS is different then ja or uk
     - 803664 libguestfs inspection fails on Windows XP: libguestfs: error: hivex: could not locate HKLM\SYSTEM\MountedDevices
     - 803533 guestfish: write error
     - 802389 event handlers for 'close' event doesn't work in remote mode
     - 802109 libguestfs uses putc on stderr, results in many individual 1 byte writes of debug messages
     - 801640 [RFE] the error reported by resize2fs-M need to be more clear
     - 801298 Possible null dereference and resource leaks
     - 801273 Document for set-pgroup need to be updated
     - 798196 virt-resize confuses format and output_format variables; using --output-format sets the input format
     - 797986 virt-resize on Windows XP in sysprep state causes "UNMOUNTABLE_BOOT_VOLUME" BSOD
     - 796520 [RFE] Prevent user from running some appliance configure commands after appliance boot up
     - 790721 multiprovider build error: RuntimeError: link: /tmp/.guestfs-0/kernel /tmp/.guestfs-0/kernel.10139: File exists
     - 789960 guestfsd crash when try to mount non-exist disk
     - 789504 virt-df (other tools?) should not give up if a guest disk is missing
     - 788641 virt-edit doesn't preserve file permissions
     - 786215 libguestfs inspection does not recognize FreeDOS operating system
     - 786188 libguestfs inspection does not recognize FreeDOS install CD
     - 785668 aug-defnode: daemon crash
     - 784647 Libguestfs uses deprecated net-tools
     - 769304 virt-resize on RHEL 6 kernel fails to re-read the partition table
     - 755729 Error message for resize2fs-M needs tweaking
     - 701814 virt-win-reg fails on a libvirt guest that has no defined disk format: "format parameter is empty or contains disallowed characters"
     - 679737 libguestfs: improve error message when zerofree is not available in the appliance
     - 635971 glob mkfs ext2 /dev/vd[b-t]1 does not expand
en_GB:  - 822490 virt-ls error: "libguestfs: error: checksum: path: parameter cannot be NULL"
     - 816839 data overflow error when debug progress -1
     - 816098 virt-make-fs fails to make a btrfs filesystem because it doesn't allocate enough space
     - 811872 inspection fails on ubuntu 10.04 guest with encrypted swap
     - 811650 guestfs_last_error not set when qemu fails early during launch
     - 811649 libguestfs cannot open disk images which are symlinks to files that contain ':' (colon) character
     - 811117 [RFE][virt-sysprep] net-hwaddr not removed from "ifcfg-*" files on rhel
     - 811112 [RFE][virt-sysprep] hostname can not be changed on rhel system
     - 809361 inspection doesn't recognise Fedora 18 (grub2 + GPT)
     - 807905 mkfs blocksize option breaks when creating btrfs
     - 805070 virt-filesystems should show 'parents' of LV and RAID devices
     - 804464 libguestfs cannot be built when LINGUAS is different then ja or uk
     - 803664 libguestfs inspection fails on Windows XP: libguestfs: error: hivex: could not locate HKLM\SYSTEM\MountedDevices
     - 803533 guestfish: write error
     - 802389 event handlers for 'close' event doesn't work in remote mode
     - 802109 libguestfs uses putc on stderr, results in many individual 1 byte writes of debug messages
     - 801640 [RFE] the error reported by resize2fs-M need to be more clear
     - 801298 Possible null dereference and resource leaks
     - 801273 Document for set-pgroup need to be updated
     - 798196 virt-resize confuses format and output_format variables; using --output-format sets the input format
     - 797986 virt-resize on Windows XP in sysprep state causes "UNMOUNTABLE_BOOT_VOLUME" BSOD
     - 796520 [RFE] Prevent user from running some appliance configure commands after appliance boot up
     - 790721 multiprovider build error: RuntimeError: link: /tmp/.guestfs-0/kernel /tmp/.guestfs-0/kernel.10139: File exists
     - 789960 guestfsd crash when try to mount non-exist disk
     - 789504 virt-df (other tools?) should not give up if a guest disk is missing
     - 788641 virt-edit doesn't preserve file permissions
     - 786215 libguestfs inspection does not recognise FreeDOS operating system
     - 786188 libguestfs inspection does not recognise FreeDOS install CD
     - 785668 aug-defnode: daemon crash
     - 784647 Libguestfs uses deprecated net-tools
     - 769304 virt-resize on RHEL 6 kernel fails to re-read the partition table
     - 755729 Error message for resize2fs-M needs tweaking
     - 701814 virt-win-reg fails on a libvirt guest that has no defined disk format: "format parameter is empty or contains disallowed characters"
     - 679737 libguestfs: improve error message when zerofree is not available in the appliance
     - 635971 glob mkfs ext2 /dev/vd[b-t]1 does not expand

note: type: textblock
en: new I<--firstboot> parameter allowing firstboot scripts for customizing guests
en_GB: new I<--firstboot> parameter allowing firstboot scripts for customising guests

note: type: textblock
en: guestfish printed paths are not canonicalized
en_GB: guestfish printed paths are not canonicalised

note: type: textblock
en: guestfish unrecognized mount option gives confusing error message
en_GB: guestfish unrecognised mount option gives confusing error message

note: type: textblock
en: Ubuntu install CDs from oneiric onwards are not recognized: "multi-boot operating systems are not supported"
en_GB: Ubuntu install CDs from oneiric onwards are not recognised: "multi-boot operating systems are not supported"

note: type: textblock
en: libguestfs doesn't recognize Windows Dynamic disks in some configurations, eg. spanned
en_GB: libguestfs doesn't recognise Windows Dynamic disks in some configurations, eg. spanned

note: type: textblock
en: C<guestmount --no-fork> flag prevents guestmount from daemonizing.
en_GB: C<guestmount --no-fork> flag prevents guestmount from daemonising.

note: type: verbatim
en:  - Localization now works for all the libguestfs tools (RHBZ#559963).
en_GB:  - Localisation now works for all the libguestfs tools (RHBZ#559963).

note: type: verbatim
en:  - 612178 guestfish: using -m option in conjunction with --listen option causes appliance to die
     - 610880 libguestfs should set broader read perms on tmpdir, so works in some situations when executed with umask 077
     - 604691 OCaml bindings are not thread safe
     - 603870 Updates to Spanish translation
     - 602592 [RFE] expose guestfs_close in perl bindings
     - 600977 virt-df -h --csv "Argument .. isn't numeric in printf"
     - 599464 mkfs-b does not support vfat/ntfs
     - 598807 add_cdrom does not work in RHEL 6
     - 598309 part-list and several other cmd failed on libguestfs on RHEL5
     - 597145 guestfish 'help' command should indicate error in exit status with an unknown command
     - 597135 guestfish write-file cmd does not check "size" parameter
     - 597118 A warning should be given in the help of mke2journal-L for the length of label
     - 597112 get-e2uuid should use blkid instead of "tune2fs -l" to get filesystem UUID
     - 596776 virt-inspector doesn't discover modprobe aliases on RHEL 3 guests
     - 596763 Updates to Spanish translation
     - 593292 Updates to Spanish translation
     - 592883 can not edit files on  images mounted with guestmount cmd
     - 592360 Updates to Spanish translation
     - 591250 virt-tar prints "tar_in: tar subcommand failed on directory" if the archive is compressed or not in the right format
     - 591155 virt-tar prints "tar_in: tar subcommand failed on directory" if a disk image is not writable
     - 591142 virt-inspector should give an error for unrecognized disk images
     - 590167 virt-inspector and other virt tools should be able to handle filesystem-on-image VMs
     - 589039 guestfish read-file cmd will cause daemon hang when read large files
     - 588851 guestfs_launch() returns -1, but guestfs_last_error() == NULL
     - 588763 libguestfs should use non-public or link-local addresses for appliance network
     - 588733 Updates to Spanish translation
     - 588651 guestfish 'strings-e' cmd does not give proper error message or hint
     - 587484 lvresize can't reduce size of a volumn
     - 585961 Updates to Spanish translation
     - 585223 ntfsresize should support shrinking filesystems
     - 585222 pvresize should support shrinking PVs
     - 585221 resize2fs should support shrinking filesystems
     - 584038 Updates to Spanish translation
     - 583554 [FEAT] mknod-mode command is needed to set mode explicitly
     - 583242 [RFE] guestfish should print outputs in a suitable base (eg. octal for modes)
     - 582993 guestfish eats words when tab completing case (in)sensitive paths
     - 582953 Misleading help information about lvcreate command
     - 582948 mknod command doesn't make block, character or FIFO devices
     - 582929 mknod doesn't check for invalid mode
     - 582901 guestfish chmod/umask commands do not check invalid mode value
     - 582899 guestfish:sparse is missed from command autocomplete list
     - 582891 [Feature Request] behavior and return value of guestfish umask cmd should be changed
     - 582548 [mknod] umask shouldn't take effect when mode is set explicitly
     - 582484 some guestfish sub commands can not handle special files properly
     - 582252 Updates to Spanish translation
     - 581501 Updates to Spanish translation
     - 580650 virt-inspector warns "No grub default specified at /usr/lib/perl5/Sys/Guestfs/Lib.pm at [...]"
     - 580556 request for libguestfs to support .txz tarballs
     - 580246 tar-in command hangs if uploading more than available space
     - 580016 aug-ls in guestfish does not take augeas variable as argument
     - 579664 guestfish doesn't report error when there is not enough space for image allocation
     - 579608 multiple commands in guestfish can not work for symbol links
     - 579155 libguestfs hangs if qemu doesn't start (in null vmchannel mode)
     - 578407 the prefix '-' in sub-command isn't handled by guestfish in remote control mode
     - 576879 libguestfs protocol loses synchronization if you 'upload' before mounting disks
     - 559963 libguestfs Perl programs do set locale, but still localization doesn't work
     - 521674 Perl modules are unversioned, but should carry version numbers
     - 516096 Race condition in test_swapon_label_0: /sbin/blockdev: BLKRRPART: Device or resource busy
     - 507810 guestfish -i / virt-inspector cannot handle spaces in filenames
     - 502533 Updated Polish translation of libguestfs
     - 501894 Some String parameters should be OptString
     - 501893 String parameters should be checked for != NULL
     - 501889 write-file does not support strings containing ASCII NUL
     - 484986 grub-install fails on virtio disk
en_GB:  - 612178 guestfish: using -m option in conjunction with --listen option causes appliance to die
     - 610880 libguestfs should set broader read perms on tmpdir, so works in some situations when executed with umask 077
     - 604691 OCaml bindings are not thread safe
     - 603870 Updates to Spanish translation
     - 602592 [RFE] expose guestfs_close in perl bindings
     - 600977 virt-df -h --csv "Argument .. isn't numeric in printf"
     - 599464 mkfs-b does not support vfat/ntfs
     - 598807 add_cdrom does not work in RHEL 6
     - 598309 part-list and several other cmd failed on libguestfs on RHEL5
     - 597145 guestfish 'help' command should indicate error in exit status with an unknown command
     - 597135 guestfish write-file cmd does not check "size" parameter
     - 597118 A warning should be given in the help of mke2journal-L for the length of label
     - 597112 get-e2uuid should use blkid instead of "tune2fs -l" to get filesystem UUID
     - 596776 virt-inspector doesn't discover modprobe aliases on RHEL 3 guests
     - 596763 Updates to Spanish translation
     - 593292 Updates to Spanish translation
     - 592883 can not edit files on  images mounted with guestmount cmd
     - 592360 Updates to Spanish translation
     - 591250 virt-tar prints "tar_in: tar subcommand failed on directory" if the archive is compressed or not in the right format
     - 591155 virt-tar prints "tar_in: tar subcommand failed on directory" if a disk image is not writable
     - 591142 virt-inspector should give an error for unrecognised disk images
     - 590167 virt-inspector and other virt tools should be able to handle filesystem-on-image VMs
     - 589039 guestfish read-file cmd will cause daemon hang when read large files
     - 588851 guestfs_launch() returns -1, but guestfs_last_error() == NULL
     - 588763 libguestfs should use non-public or link-local addresses for appliance network
     - 588733 Updates to Spanish translation
     - 588651 guestfish 'strings-e' cmd does not give proper error message or hint
     - 587484 lvresize can't reduce size of a volumn
     - 585961 Updates to Spanish translation
     - 585223 ntfsresize should support shrinking filesystems
     - 585222 pvresize should support shrinking PVs
     - 585221 resize2fs should support shrinking filesystems
     - 584038 Updates to Spanish translation
     - 583554 [FEAT] mknod-mode command is needed to set mode explicitly
     - 583242 [RFE] guestfish should print outputs in a suitable base (eg. octal for modes)
     - 582993 guestfish eats words when tab completing case (in)sensitive paths
     - 582953 Misleading help information about lvcreate command
     - 582948 mknod command doesn't make block, character or FIFO devices
     - 582929 mknod doesn't check for invalid mode
     - 582901 guestfish chmod/umask commands do not check invalid mode value
     - 582899 guestfish:sparse is missed from command autocomplete list
     - 582891 [Feature Request] behaviour and return value of guestfish umask cmd should be changed
     - 582548 [mknod] umask shouldn't take effect when mode is set explicitly
     - 582484 some guestfish sub commands can not handle special files properly
     - 582252 Updates to Spanish translation
     - 581501 Updates to Spanish translation
     - 580650 virt-inspector warns "No grub default specified at /usr/lib/perl5/Sys/Guestfs/Lib.pm at [...]"
     - 580556 request for libguestfs to support .txz tarballs
     - 580246 tar-in command hangs if uploading more than available space
     - 580016 aug-ls in guestfish does not take augeas variable as argument
     - 579664 guestfish doesn't report error when there is not enough space for image allocation
     - 579608 multiple commands in guestfish can not work for symbol links
     - 579155 libguestfs hangs if qemu doesn't start (in null vmchannel mode)
     - 578407 the prefix '-' in sub-command isn't handled by guestfish in remote control mode
     - 576879 libguestfs protocol loses synchronisation if you 'upload' before mounting disks
     - 559963 libguestfs Perl programs do set locale, but still localisation doesn't work
     - 521674 Perl modules are unversioned, but should carry version numbers
     - 516096 Race condition in test_swapon_label_0: /sbin/blockdev: BLKRRPART: Device or resource busy
     - 507810 guestfish -i / virt-inspector cannot handle spaces in filenames
     - 502533 Updated Polish translation of libguestfs
     - 501894 Some String parameters should be OptString
     - 501893 String parameters should be checked for != NULL
     - 501889 write-file does not support strings containing ASCII NUL
     - 484986 grub-install fails on virtio disk

note: type: verbatim
en:  - Excluded packages in the appliance are now listed in a separate
       file appliance/excludelist.in, and can be customized per-distro.
en_GB:  - Excluded packages in the appliance are now listed in a separate
       file appliance/excludelist.in, and can be customised per-distro.

note: type: textblock
en: Before 2010 libguestfs did not have official release notes or a formalized version numbering system.  However these are links to historically significant versions.
en_GB: Before 2010 libguestfs did not have official release notes or a formalised version numbering system.  However these are links to historically significant versions.

note: type: textblock
en: Now try to load this into your favorite spreadsheet or database.  Are the results reproduced faithfully in the spreadsheet/database?
en_GB: Now try to load this into your favourite spreadsheet or database.  Are the results reproduced faithfully in the spreadsheet/database?

note: type: textblock
en: Buildroot-derived distro, but not one we specifically recognize.
en_GB: Buildroot-derived distro, but not one we specifically recognise.

note: type: textblock
en: The display name of the application, sometimes localized to the install language of the guest operating system.
en_GB: The display name of the application, sometimes localised to the install language of the guest operating system.

note: type: textblock
en: Usually it is more efficient to use the L<isoinfo(1)> command with the I<-d> option on the host to analyze ISO files, instead of going through libguestfs.
en_GB: Usually it is more efficient to use the L<isoinfo(1)> command with the I<-d> option on the host to analyse ISO files, instead of going through libguestfs.

note: type: textblock
en: This creates an ext2/3/4 filesystem on C<device> with an external journal on the journal labeled C<label>.
en_GB: This creates an ext2/3/4 filesystem on C<device> with an external journal on the journal labelled C<label>.

note: type: textblock
en: L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used to create extra mountpoints before mounting the first filesystem.
en_GB: L</mkmountpoint> and L</rmmountpoint> are specialised calls that can be used to create extra mountpoints before mounting the first filesystem.

note: type: textblock
en: The bootable flag is used by some operating systems (notably Windows) to determine which partition to boot from.  It is by no means universally recognized.
en_GB: The bootable flag is used by some operating systems (notably Windows) to determine which partition to boot from.  It is by no means universally recognised.

note: type: textblock
en: Return the canonicalized absolute pathname of C<path>.  The returned path has no C<.>, C<..> or symbolic link path elements.
en_GB: Return the canonicalised absolute pathname of C<path>.  The returned path has no C<.>, C<..> or symbolic link path elements.

note: type: textblock
en: This call may be used to copy or synchronize two directories under the same libguestfs handle.  This uses the L<rsync(1)> program which uses a fast algorithm that avoids copying files unnecessarily.
en_GB: This call may be used to copy or synchronise two directories under the same libguestfs handle.  This uses the L<rsync(1)> program which uses a fast algorithm that avoids copying files unnecessarily.

note: type: textblock
en: This call may be used to copy or synchronize the filesystem on the host or on a remote computer with the filesystem within libguestfs.  This uses the L<rsync(1)> program which uses a fast algorithm that avoids copying files unnecessarily.
en_GB: This call may be used to copy or synchronise the filesystem on the host or on a remote computer with the filesystem within libguestfs.  This uses the L<rsync(1)> program which uses a fast algorithm that avoids copying files unnecessarily.

note: type: textblock
en: This call may be used to copy or synchronize the filesystem within libguestfs with a filesystem on the host or on a remote computer.  This uses the L<rsync(1)> program which uses a fast algorithm that avoids copying files unnecessarily.
en_GB: This call may be used to copy or synchronise the filesystem within libguestfs with a filesystem on the host or on a remote computer.  This uses the L<rsync(1)> program which uses a fast algorithm that avoids copying files unnecessarily.

note: type: textblock
en: If C<autosync> is true, this enables autosync.  Libguestfs will make a best effort attempt to make filesystems consistent and synchronized when the handle is closed (also if the program exits without closing handles).
en_GB: If C<autosync> is true, this enables autosync.  Libguestfs will make a best effort attempt to make filesystems consistent and synchronised when the handle is closed (also if the program exits without closing handles).

note: type: textblock
en: This is the opposite of L</launch>.  It performs an orderly shutdown of the backend process(es).  If the autosync flag is set (which is the default) then the disk image is synchronized.
en_GB: This is the opposite of L</launch>.  It performs an orderly shutdown of the backend process(es).  If the autosync flag is set (which is the default) then the disk image is synchronised.

note: type: textblock
en: This command disables the libguestfs appliance swap on labeled swap partition.
en_GB: This command disables the libguestfs appliance swap on labelled swap partition.

note: type: textblock
en: This command enables swap to a labeled swap partition.  See L</swapon-device> for other notes.
en_GB: This command enables swap to a labelled swap partition.  See L</swapon-device> for other notes.

note: type: textblock
en: Change the behavior of the kernel code when errors are detected.  Possible values currently are: C<continue>, C<remount-ro>, C<panic>.  In practice these options don't really make any difference, particularly for write errors.
en_GB: Change the behaviour of the kernel code when errors are detected.  Possible values currently are: C<continue>, C<remount-ro>, C<panic>.  In practice these options don't really make any difference, particularly for write errors.

note: type: textblock
en: If the filesystem is unlabeled, this returns the empty string.
en_GB: If the filesystem is unlabelled, this returns the empty string.

note: type: textblock
en: When L<guestunmount(1)>/L<fusermount(1)> exits, guestmount may still be running and cleaning up the mountpoint.  The disk image will not be fully finalized.
en_GB: When L<guestunmount(1)>/L<fusermount(1)> exits, guestmount may still be running and cleaning up the mountpoint.  The disk image will not be fully finalised.

note: type: textblock
en: Guestunmount never daemonizes itself.
en_GB: Guestunmount never daemonises itself.

note: type: textblock
en: In brief, E<lt>nameE<gt> is the class of operating system (something like C<linux> or C<windows>), E<lt>distroE<gt> is the distribution (eg. C<fedora> but many other distros are recognized) and E<lt>archE<gt> is the guest architecture.  The other fields are fairly self-explanatory, but because these fields are taken directly from the libguestfs inspection API you can find precise information from L<guestfs(3)/INSPECTION>.
en_GB: In brief, E<lt>nameE<gt> is the class of operating system (something like C<linux> or C<windows>), E<lt>distroE<gt> is the distribution (eg. C<fedora> but many other distros are recognised) and E<lt>archE<gt> is the guest architecture.  The other fields are fairly self-explanatory, but because these fields are taken directly from the libguestfs inspection API you can find precise information from L<guestfs(3)/INSPECTION>.

note: type: textblock
en: C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls that can be used to create extra mountpoints before mounting the first filesystem.
en_GB: C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialised calls that can be used to create extra mountpoints before mounting the first filesystem.

note: type: textblock
en: This is the opposite of C<guestfs_launch>.  It performs an orderly shutdown of the backend process(es).  If the autosync flag is set (which is the default) then the disk image is synchronized.
en_GB: This is the opposite of C<guestfs_launch>.  It performs an orderly shutdown of the backend process(es).  If the autosync flag is set (which is the default) then the disk image is synchronised.

note: type: textblock
en: This command enables swap to a labeled swap partition.  See C<guestfs_swapon_device> for other notes.
en_GB: This command enables swap to a labelled swap partition.  See C<guestfs_swapon_device> for other notes.

note: type: verbatim
en:  /* Synchronize the disk.  This is the opposite of guestfs_launch. */
     guestfs_shutdown (g);
en_GB:  /* Synchronise the disk.  This is the opposite of guestfs_launch. */
     guestfs_shutdown (g);

note: type: textblock
en: Libguestfs provides access to a large part of the LVM2 API, such as L</guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless you familiarize yourself with the concepts of physical volumes, volume groups and logical volumes.
en_GB: Libguestfs provides access to a large part of the LVM2 API, such as L</guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless you familiarise yourself with the concepts of physical volumes, volume groups and logical volumes.

note: type: textblock
en: Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls and certain heuristics, and returns a list of operating systems that were found.  An empty list means none were found.  A single element is the root filesystem of the operating system.  For dual- or multi-boot guests, multiple roots can be returned, each one corresponding to a separate operating system.  (Multi-boot virtual machines are extremely rare in the world of virtualization, but since this scenario can happen, we have built libguestfs to deal with it.)
en_GB: Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls and certain heuristics, and returns a list of operating systems that were found.  An empty list means none were found.  A single element is the root filesystem of the operating system.  For dual- or multi-boot guests, multiple roots can be returned, each one corresponding to a separate operating system.  (Multi-boot virtual machines are extremely rare in the world of virtualisation, but since this scenario can happen, we have built libguestfs to deal with it.)

note: type: textblock
en: A new stable branch starts when we think the new features in development are substantial and compelling enough over the current stable branch to warrant it.  When that happens we create new stable and development versions 1.N.0 and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so stable at this point, but by backporting fixes from development, that branch will stabilize over time.
en_GB: A new stable branch starts when we think the new features in development are substantial and compelling enough over the current stable branch to warrant it.  When that happens we create new stable and development versions 1.N.0 and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so stable at this point, but by backporting fixes from development, that branch will stabilise over time.

note: type: textblock
en: Adding a partition can make the disk image more compatible with certain virtualized operating systems which don't expect to see a filesystem directly located on a block device (Linux doesn't care and will happily handle both types).
en_GB: Adding a partition can make the disk image more compatible with certain virtualised operating systems which don't expect to see a filesystem directly located on a block device (Linux doesn't care and will happily handle both types).

note: type: textblock
en: Unlike formats such as tar and squashfs, a filesystem does not "just fit" the files that it contains, but might have extra space.  Depending on how you are going to use the output, you might think this extra space is wasted and want to minimize it, or you might want to leave space so that more files can be added later.  Virt-make-fs defaults to minimizing the extra space, but you can use the I<--size> flag to leave space in the filesystem if you want it.
en_GB: Unlike formats such as tar and squashfs, a filesystem does not "just fit" the files that it contains, but might have extra space.  Depending on how you are going to use the output, you might think this extra space is wasted and want to minimise it, or you might want to leave space so that more files can be added later.  Virt-make-fs defaults to minimising the extra space, but you can use the I<--size> flag to leave space in the filesystem if you want it.

note: type: textblock
en: Remove email from the local mail spool directory.
en_GB: Remove e-mail from the local mail spool directory.

note: type: textblock
en: virt-sysprep - Reset, unconfigure or customize a virtual machine so clones can be made
en_GB: virt-sysprep - Reset, unconfigure or customise a virtual machine so clones can be made

note: type: textblock
en: Virt-sysprep can reset or unconfigure a virtual machine so that clones can be made from it.  Steps in this process include removing SSH host keys, removing persistent network MAC configuration, and removing user accounts.  Virt-sysprep can also customize a virtual machine, for instance by adding SSH keys, users or logos.  Each step can be enabled or disabled as required.
en_GB: Virt-sysprep can reset or unconfigure a virtual machine so that clones can be made from it.  Steps in this process include removing SSH host keys, removing persistent network MAC configuration, and removing user accounts.  Virt-sysprep can also customise a virtual machine, for instance by adding SSH keys, users or logos.  Each step can be enabled or disabled as required.

note: type: textblock
en: You may want to run virt-sysprep twice, once to reset the guest (to make a template) and a second time to customize the guest for a specific user:
en_GB: You may want to run virt-sysprep twice, once to reset the guest (to make a template) and a second time to customise the guest for a specific user:

note: type: textblock
en: C<virt-tar> is a general purpose archive tool for downloading and uploading parts of a guest filesystem.  There are many possibilities: making backups, uploading data files, snooping on guest activity, fixing or customizing guests, etc.
en_GB: C<virt-tar> is a general purpose archive tool for downloading and uploading parts of a guest filesystem.  There are many possibilities: making backups, uploading data files, snooping on guest activity, fixing or customising guests, etc.
