Scroll to navigation

guestfs-release-notes-1.52(1) Virtualization Support guestfs-release-notes-1.52(1)


guestfs-release-notes - libguestfs Release Notes


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


guestfs-examples(1), guestfs-faq(1), guestfs-performance(1), guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),



Copyright (C) 2009-2024 Red Hat Inc.


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:

To report a new bug against libguestfs, use this link:

When reporting a bug, please supply:

  • The version of libguestfs.
  • Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
  • Describe the bug accurately and give a way to reproduce it.
  • Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.
2024-01-05 libguestfs-1.52.0