Your company here — click to reach over 10,000 unique daily visitors

guestfs-release-notes-1.52 - Man Page

libguestfs Release Notes

Release Notes for Libguestfs 1.52

These are the release notes for libguestfs stable release 1.52. This describes the major changes since 1.50.

Libguestfs 1.52.0 was released on 5 January 2024.

Language bindings

The Python bindings now use bytes (instead of str) for the event callback message, since it may contain arbitrary 8 bit data (thanks Yonatan Shtarkman).

Also in the Python bindings, fix a rare crash, and avoid memory leaks in event callbacks (thanks Yonatan Shtarkman, Laszlo Ersek, Eric Blake).

Support for OCaml 5, and OCaml ≥ 4.07 is now the minimum (thanks Guillaume Munch-Maccagnoni, Jerry James, Josh Berdine, Jürgen Hötzel, Vincent Laviron).

The OCaml bindings now release the runtime lock around calls to guestfs_close, since that call might be long-running (for example it might have to shut down the appliance and synch disks).


Support OpencloudOS (cunshunxia@tencent).


SELinux relabelling now runs in parallel, meaning it's a lot quicker (Andrey Drobyshev).

Add support for lzma and zstd compression methods in tar APIs (like guestfs_tar_in) (Zixun LI).

guestfs_pvs_full previously didn't always return the correct device names.  This has now been fixed.

guestfs_btrfs_filesystem_balance fixed so it now works with more modern btrfs tools (Jürgen Hötzel).


The guestfish(1) --key option now recognizes LVM names like /dev/mapper/rhel_bootp--73--75--123-root (Laszlo Ersek).

guestfish --key option also supports a new --key all:... selector to try the same key on all devices.

In guestmount(1) avoid calling fclose(NULL) on error paths, which might have caused a crash on some platforms.

Build changes

The RELEASES file (which listed release dates) has been removed and replaced with a simple RELEASE_DATE macro in ./configure.  This should simplify builds.

Optionally passt(1) may be used for networking (Laszlo Ersek).

dhcpcd(8) is now used in preference to dh-client on Red Hat platforms.

Old Ruby MiniTest and Test::Unit dependencies replaced with new Minitest.

Fix compatibility issues with libxml2 2.12.


On x86-64 we now use the more modern q35 machine type when running the appliance.  This should perform slightly better and has more development attention from the qemu community.  The change should be invisible to libguestfs users.

Fix a segmentation fault when TERM environment variable was set to dumb (Daisuke HATAYAMA).

Avoid a warning on modern Fedora which does not have /selinux (Andrey Drobyshev).

Fix build on OpenSUSE LEAP 15 or other distros with a file(1) command which did not understand the -S option (thanks Olaf Hering).

Bugs fixed


Remove dependency on dhcp-client in libguestfs


RFE: support passt for appliance networking, as QEMU userspace networking backend


use q35 machine type for libguestfs appliance


virt-dib doesn't work with newer diskimage-builder version on RHEL8

See Also

guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1), http://libguestfs.org/


Andrey Drobyshev


Emilio Herrera



Jan Kuparinen

Jürgen Hötzel

Laszlo Ersek

Pavel Borecki

Richard W.M. Jones

Temuri Doghonadze

Tian Shixiong

Yuri Chornoivan

Zixun LI


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

Referenced By


2024-07-08 libguestfs-1.53.5 Virtualization Support