guestfs-release-notes-1.56(1)

NAME
guestfs-release-notes - libguestfs Release Notes

RELEASE NOTES FOR LIBGUESTFS 1.56
These are the release notes for libguestfs stable release 1.56. This describes the major changes since 1.54.

Libguestfs 1.56.0 was released on 11th June 2025.

  Inspection
Add support for Windows 2025 (thanks Ming Xie).

Add support for TencentOS (Denise Cheng).

Inspection of Ubuntu 22+ guests that use a split /usr configuration now works properly (thanks Jaroslav Spanko, Daniel Berrange).

Inspecting guests that have duplicated root mountpoints now works.

Inspection of SUSE Linux guests using btrfs snapshots now ignores snapshots that mirror content in the root filesystem (thanks Ming Xie).

Inspection of SUSE Linux >= 15 now returns the correct osinfo short name (eg. "sle15") (thanks Ming Xie).

  API
New "command_out" and "sh_out" APIs which allow you to capture output from guest commands that generate more output than the protocol limit allows.

New "btrfs_scrub_full" API which runs a full Btrfs scrub, synchronously. It works more like fsck for other filesystems.

The "fstrim" API has been modified to work around several issues in upstream and RHEL 9 kernels related to XFS support (Eric Sandeen, Dave Chinner).

The existing "e2fsck" API has a new "FORCENO" option enabling use of the command line -n flag.

  Language bindings
Previously "-L../lib/.libs" got embedded in the distributed OCaml bindings. This has been fixed.

GObject bindings have been deprecated and will be removed in libguestfs 1.58.

  Build changes
json-c is now required. This replaces Jansson which was previously used for parsing JSON input files.

OCaml ≥ 4.08 is now required.

OCaml oUnit is no longer used.

We now assume that "__attribute__((cleanup))" always works. This requires gcc or Clang.

Fix compatibility with file(1) ≥ 5.46.

Fix compatibility with Fedora ≥ 42 which merges /usr/sbin into /usr/bin.

Fix compatibility with latest Rust compiler (Jacob Reger).

lex(1), yacc(1) and libmagic (part of file(1)) have not been required by libguestfs for a long time, but were still checked by the ./configure script. This has been fixed, they are no longer build dependencies (thanks Mohamed Akram).

When using "./configure --disable-daemon" we no longer require augeas and hivex (thanks Mohamed Akram).

"zfs-fuse" support has been dropped. The project is unmaintained upstream (thanks Paul Bolle, Gwyn Ciesla, Timothée Ravier).

Fix compatibility with GNU gettext 0.25.

  Internals
The tests were modified to use a set of common functions and remove use of the weird $TEST_FUNCTIONS macro, similar to how we do it in nbdkit.

Fix dhcpcd failing on systemd-resolved stub (Thomas Wouters).

Add support for dhcpcd and sfdisk on Debian (Daniel Gomez).

Print the kernel utsname in debug output.

The legacy "pvs_full", "vgs_full" and "lvs_full" APIs were completely rewritten in OCaml.

Some deprecated autoconf macros are no longer used.

We no longer emit a false warning about "BLKDISCARD" when creating a block device.

Some internal OCaml List and String functions that we used have been replaced by ones from the OCaml stdlib, reducing code maintenance.

If qemu-img(1) commands fail during snapshot creation, make sure we capture and print stderr from the qemu command (Cole Robinson).

  Bugs fixed

https://issues.redhat.com/browse/RHEL-62935
    [rhel 9.6] windows version of win2025 guest shows incorrect during v2v conversion

https://issues.redhat.com/browse/RHEL-80159
    Add new APIs to allow command output > 4MB

https://issues.redhat.com/browse/RHEL-87493
    The Ubuntu 22.04 VM from VMware fails with Inspection field ‘i_arch’ was ‘unknown’ [rhel-9.7]

https://issues.redhat.com/browse/RHEL-88450
    fstrim on a RHEL 7.2-created XFS filesystem does not trim as much as expected

https://issues.redhat.com/browse/RHEL-88508
    Run fstrim twice to work around incorrect fstrim behaviour in RHEL 9 kernel

https://issues.redhat.com/browse/RHEL-90168
    virt-v2v fails with mount exited with status 32: mount: /sysroot: /dev/sda2 already mounted on /sysroot. [rhel-9.7]

https://issues.redhat.com/browse/RHEL-92239
    Lost error when opening wrong format of image readonly [rhel-10.1]

https://issues.redhat.com/browse/RHEL-93109
    RFE: Investigate & do something useful with btrfsvol:...snapshots in SUSE Linux guests

https://issues.redhat.com/browse/RHEL-95791
    libguestfs generates the wrong osinfo for SLES 15 guests [rhel-9.6]

https://github.com/libguestfs/libguestfs/issues/155
    1.54.0: gdisk/test-expand-gpt.pl fails

https://github.com/libguestfs/libguestfs/issues/162
    New test suite failure in c-api with file-5.46

https://github.com/libguestfs/libguestfs/issues/167
    Weblate | erroneous source strings

https://github.com/libguestfs/libguestfs/issues/182
    sed: RE error: illegal byte sequence in build

https://github.com/libguestfs/libguestfs/issues/183
    bash-completion fails to install on macOS

https://github.com/libguestfs/libguestfs/issues/184
    augeas, hivex and libmagic required even when daemon is disabled

https://github.com/libguestfs/libguestfs/issues/191
    Failing to build ocaml/examples

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

AUTHORS

Cole Robinson
Daniel Gomez
Denise Cheng
Ettore Atalan
Jacob Reger
Krascovict Petrov
Léane GRASSER
Richard W.M. Jones
Ricky Tigg
Thomas Wouters
Yuri Chornoivan

COPYRIGHT
Copyright (C) 2009-2025 Red Hat Inc.

LICENSE
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.

BUGS
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:

•   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.