Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

7.112. libguestfs

Updated libguestfs packages that fix numerous bugs and add various enhancements are now available for Red Hat Enterprise Linux 6.
The libguestfs packages contain a library, which is used for accessing and modifying guest disk images.

Bug Fixes

BZ#801640
Previously, when using the resize2fs -M command and an error due to lack of free space occurred, the returned error message was incorrect and could confuse the user. With this update, a proper error message is returned instead.
BZ#822626
Due to a bug in the source code, an error occurred when using the virt-ls --checksum command and the following error message was returned:
libguestfs: error: checksum: path: parameter cannot be NULL
The underlying source code has been modified and virt-ls --checksum now works as expected.
BZ#830369
Due to the guestfs_inspect_get_hostname() function, the libguestfs-based commands did not work properly when an empty /etc/HOSTNAME file was created on a Linux guest. This update applies a patch to fix this bug and the libguestfs based commands now work in the described scenario.
BZ#836573
Previously, the libguestfs library did not handle the /dev/disk/by-id/* paths. Consequently, it was impossible to examine a guest using commands with such a path and an error message was returned. With this update, a patch has been applied to fix this bug and the libguestfs library no longer returns error in this situation.
BZ#837691
Previously, under certain conditions, writing to disks in the qcow2 format could cause silent data loss. The underlying source code has been modified to prevent this behavior and writing to disks in the qcow2 format now works as expected.
BZ#838609
Due to a race condition between the guestmount and the fusermount tools, unmouting and then immediately using a disk image was not safe and could cause data loss or memory corruption. This update adds the new --pid-file option for guestmount to avoid the race condition between these tools and attempts to use disk images immediately after unmounting can no longer cause data loss or memory corruption.
BZ#852396
Previously, the libguestfs library limited the total size of downloaded hive files from a Windows Registry to 100 MB. Consequently, an attempt to inspect systems with large amount of hive files caused libguestfs to return an error message. With this update, the limit was increased to 300 MB and libguestfs can now inspect a larger Widows Registry properly.
BZ#853763
Previously, using the file utility to detect the format of a disk image could produce different output for different versions of this utility. The underlying source code has been modified and output is now the same for all versions of the file utility.
BZ#858126
Due to a bug in the underlying source code, the virt-inspector tool failed to work with certain Windows guests. This update applies a patch to fix this bug and virt-inspector now supports all Windows guests as expected.
BZ#858648
Due to recent changes in the iptables packages, the libguestfs library could not be installed with the new version of the iptables tool. The underlying source code has been modified to fix this bug and the installation of libguestfs works as expected.
BZ#872454
Previously, the libguestfs library detected the Red Hat Enterprise Linux 5.1 guests as NetBSD guests. This update applies a patch to fix this bug and libguestfs now detects Red Hat Enterprise Linux 5.1 guest correctly.
BZ#880805
The virt-df command with -a or -d arguments works correctly only with a single guest. An attempt to use this command with multiple arguments, such as virt-df -a RHEL-Server-5.9-32-pv.raw -a opensuse.img, caused the disk image names to be displayed incorrectly. With this update, the plus sign (+) is displayed for each additional disk, so that the user can easily recognize them. In addition, the correct usage of the virt-df command has been described in the virt-df(1) man page.

Enhancements

BZ#830135
This enhancement improves the libguestfs library to support mount-local APIs.
BZ#836501
With this update, the dependency on the fuse packages has been added to libguestfs dependencies.
All users of libguestfs are advised to upgrade to these updated packages, which fix these bugs and add these enhancements.