.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.56.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "guestfs-release-notes-1.56 1"
.TH guestfs-release-notes-1.56 1 2025-08-13 libguestfs-1.56.2 "Virtualization Support"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
guestfs\-release\-notes \- libguestfs Release Notes
.SH "RELEASE NOTES FOR LIBGUESTFS 1.56"
.IX Header "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.
.PP
Libguestfs 1.56.0 was released on \fB11th June 2025\fR.
.SS Inspection
.IX Subsection "Inspection"
Add support for Windows 2025 (thanks Ming Xie).
.PP
Add support for TencentOS (Denise Cheng).
.PP
Inspection of Ubuntu 22+ guests that use a split \fI/usr\fR configuration
now works properly (thanks Jaroslav Spanko, Daniel Berrange).
.PP
Inspecting guests that have duplicated root mountpoints now works.
.PP
Inspection of SUSE Linux guests using btrfs snapshots now ignores
snapshots that mirror content in the root filesystem (thanks Ming
Xie).
.PP
Inspection of SUSE Linux >= 15 now returns the correct osinfo short
name (eg. \f(CW"sle15"\fR) (thanks Ming Xie).
.SS API
.IX Subsection "API"
New \f(CW\*(C`command_out\*(C'\fR and \f(CW\*(C`sh_out\*(C'\fR APIs which allow you to capture
output from guest commands that generate more output than the protocol
limit allows.
.PP
New \f(CW\*(C`btrfs_scrub_full\*(C'\fR API which runs a full Btrfs scrub,
synchronously.  It works more like fsck for other filesystems.
.PP
The \f(CW\*(C`fstrim\*(C'\fR API has been modified to work around several issues in
upstream and RHEL 9 kernels related to XFS support (Eric Sandeen, Dave
Chinner).
.PP
The existing \f(CW\*(C`e2fsck\*(C'\fR API has a new \f(CW\*(C`FORCENO\*(C'\fR option enabling use of
the command line \fI\-n\fR flag.
.SS "Language bindings"
.IX Subsection "Language bindings"
Previously \f(CW\*(C`\-L../lib/.libs\*(C'\fR got embedded in the distributed OCaml
bindings.  This has been fixed.
.PP
GObject bindings have been deprecated and will be removed in
libguestfs\ 1.58.
.SS "Build changes"
.IX Subsection "Build changes"
json\-c is now required.  This replaces Jansson which was previously
used for parsing JSON input files.
.PP
OCaml ≥ 4.08 is now required.
.PP
OCaml oUnit is no longer used.
.PP
We now assume that \f(CW\*(C`_\|_attribute_\|_((cleanup))\*(C'\fR always works.  This
requires gcc or Clang.
.PP
Fix compatibility with \fBfile\fR\|(1) ≥ 5.46.
.PP
Fix compatibility with Fedora ≥ 42 which merges \fI/usr/sbin\fR into
\&\fI/usr/bin\fR.
.PP
Fix compatibility with latest Rust compiler (Jacob Reger).
.PP
\&\fBlex\fR\|(1), \fByacc\fR\|(1) and libmagic (part of \fBfile\fR\|(1)) have not been
required by libguestfs for a long time, but were still checked by the
\&\fI./configure\fR script.  This has been fixed, they are no longer build
dependencies (thanks Mohamed Akram).
.PP
When using \f(CW\*(C`./configure \-\-disable\-daemon\*(C'\fR we no longer require augeas
and hivex (thanks Mohamed Akram).
.PP
\&\f(CW\*(C`zfs\-fuse\*(C'\fR support has been dropped.  The project is unmaintained
upstream (thanks Paul Bolle, Gwyn Ciesla, Timothée Ravier).
.PP
Fix compatibility with GNU gettext 0.25.
.SS Internals
.IX Subsection "Internals"
The tests were modified to use a set of common functions and remove
use of the weird \f(CW$TEST_FUNCTIONS\fR macro, similar to how we do it in
nbdkit.
.PP
Fix dhcpcd failing on systemd\-resolved stub (Thomas Wouters).
.PP
Add support for dhcpcd and sfdisk on Debian (Daniel Gomez).
.PP
Print the kernel utsname in debug output.
.PP
The legacy \f(CW\*(C`pvs_full\*(C'\fR, \f(CW\*(C`vgs_full\*(C'\fR and \f(CW\*(C`lvs_full\*(C'\fR APIs were
completely rewritten in OCaml.
.PP
Some deprecated autoconf macros are no longer used.
.PP
We no longer emit a false warning about \f(CW\*(C`BLKDISCARD\*(C'\fR when creating a
block device.
.PP
Some internal OCaml List and String functions that we used have been
replaced by ones from the OCaml stdlib, reducing code maintenance.
.PP
If \fBqemu\-img\fR\|(1) commands fail during snapshot creation, make sure we
capture and print stderr from the qemu command (Cole Robinson).
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.IP https://issues.redhat.com/browse/RHEL\-62935 4
.IX Item "https://issues.redhat.com/browse/RHEL-62935"
[rhel 9.6] windows version of win2025 guest shows incorrect during v2v conversion
.IP https://issues.redhat.com/browse/RHEL\-80159 4
.IX Item "https://issues.redhat.com/browse/RHEL-80159"
Add new APIs to allow command output > 4MB
.IP https://issues.redhat.com/browse/RHEL\-87493 4
.IX Item "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]
.IP https://issues.redhat.com/browse/RHEL\-88450 4
.IX Item "https://issues.redhat.com/browse/RHEL-88450"
fstrim on a RHEL 7.2\-created XFS filesystem does not trim as much as expected
.IP https://issues.redhat.com/browse/RHEL\-88508 4
.IX Item "https://issues.redhat.com/browse/RHEL-88508"
Run fstrim twice to work around incorrect fstrim behaviour in RHEL 9 kernel
.IP https://issues.redhat.com/browse/RHEL\-90168 4
.IX Item "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]
.IP https://issues.redhat.com/browse/RHEL\-92239 4
.IX Item "https://issues.redhat.com/browse/RHEL-92239"
Lost error when opening wrong format of image readonly [rhel\-10.1]
.IP https://issues.redhat.com/browse/RHEL\-93109 4
.IX Item "https://issues.redhat.com/browse/RHEL-93109"
RFE: Investigate & do something useful with btrfsvol:...snapshots in
SUSE Linux guests
.IP https://issues.redhat.com/browse/RHEL\-95791 4
.IX Item "https://issues.redhat.com/browse/RHEL-95791"
libguestfs generates the wrong osinfo for SLES 15 guests [rhel\-9.6]
.IP https://github.com/libguestfs/libguestfs/issues/155 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/155"
1.54.0: gdisk/test\-expand\-gpt.pl fails
.IP https://github.com/libguestfs/libguestfs/issues/162 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/162"
New test suite failure in c\-api with file\-5.46
.IP https://github.com/libguestfs/libguestfs/issues/167 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/167"
Weblate | erroneous source strings
.IP https://github.com/libguestfs/libguestfs/issues/182 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/182"
sed: RE error: illegal byte sequence in build
.IP https://github.com/libguestfs/libguestfs/issues/183 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/183"
bash\-completion fails to install on macOS
.IP https://github.com/libguestfs/libguestfs/issues/184 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/184"
augeas, hivex and libmagic required even when daemon is disabled
.IP https://github.com/libguestfs/libguestfs/issues/191 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/191"
Failing to build ocaml/examples
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBguestfs\-examples\fR\|(1),
\&\fBguestfs\-faq\fR\|(1),
\&\fBguestfs\-performance\fR\|(1),
\&\fBguestfs\-recipes\fR\|(1),
\&\fBguestfs\-testing\fR\|(1),
\&\fBguestfs\fR\|(3),
\&\fBguestfish\fR\|(1),
http://libguestfs.org/
.SH AUTHORS
.IX Header "AUTHORS"
.IP "Cole Robinson" 4
.IX Item "Cole Robinson"
.PD 0
.IP "Daniel Gomez" 4
.IX Item "Daniel Gomez"
.IP "Denise Cheng" 4
.IX Item "Denise Cheng"
.IP "Ettore Atalan" 4
.IX Item "Ettore Atalan"
.IP "Jacob Reger" 4
.IX Item "Jacob Reger"
.IP "Krascovict Petrov" 4
.IX Item "Krascovict Petrov"
.IP "Léane GRASSER" 4
.IX Item "Léane GRASSER"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.IP "Ricky Tigg" 4
.IX Item "Ricky Tigg"
.IP "Thomas Wouters" 4
.IX Item "Thomas Wouters"
.IP "Yuri Chornoivan" 4
.IX Item "Yuri Chornoivan"
.PD
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2025 Red Hat Inc.
.SH LICENSE
.IX Header "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.
.PP
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.
.PP
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.
.SH BUGS
.IX Header "BUGS"
To get a list of bugs against libguestfs, use this link:
https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
.PP
To report a new bug against libguestfs, use this link:
https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
.PP
When reporting a bug, please supply:
.IP \(bu 4
The version of libguestfs.
.IP \(bu 4
Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
.IP \(bu 4
Describe the bug accurately and give a way to reproduce it.
.IP \(bu 4
Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR
output into the bug report.