.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Podwrapper::Man 1.58.1 (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.58 1"
.TH guestfs-release-notes-1.58 1 2026-01-19 libguestfs-1.58.1 "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.58"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.58"
These are the release notes for libguestfs stable release 1.58.
This describes the major changes since 1.56.
.PP
Libguestfs 1.58.0 was released on \fB5th January 2026\fR.
.SS Inspection
.IX Subsection "Inspection"
Fix inspection of SLES 15 guests that have an encrypted Btrfs
filesystem, by correctly parsing \fI/etc/crypttab\fR (Cole Robinson).
.PP
Windows named drives (like \f(CW\*(C`D:\*(C'\fR) which point to completely blank
disks are now ignored instead of causing an error (thanks Ming Xie,
Ameen Barakat).
.PP
Existing code in virt\-v2v which recognized Windows Antivirus (AV)
software is now part of inspection.  The new code recognizes a wider
range of AV software.
.SS API
.IX Subsection "API"
\&\f(CW\*(C`guestfs_selinux_relabel\*(C'\fR was deprecated, replaced by new
\&\f(CW\*(C`guestfs_setfiles\*(C'\fR.  This new API also uses the \fBsetfiles\fR\|(8) \fI\-A\fR
option to reduce memory usage.
.PP
New \f(CW\*(C`guestfs_ntfs_chmod\*(C'\fR API which changes the permissions of Windows
paths (Cole Robinson).
.PP
In the list of structures returned by
\&\f(CW\*(C`guestfs_inspect_get_applications2\*(C'\fR, a new \f(CW\*(C`app2_class\*(C'\fR field has
been added.  This classifies the application by its primary usage, but
currently only \f(CW"antivirus"\fR can be returned here for Windows AV
software.
.PP
New \f(CW\*(C`guestfs_inspect_get_windows_group_policy\*(C'\fR API which reports
whether Group Policy Objects were found in the Windows guest.
.PP
\&\f(CW\*(C`guestfs_btrfs_subvolume_show\*(C'\fR would sometimes crash when parsing the
snapshots of a Btrfs subvolume.  Furthermore, in any API that returned
a device name associated with a Btrfs volume, the device name might
not be translated correctly resulting in the wrong device name being
returned.  (Both problems fixed by Arye Yurkovsky.)
.PP
Fix a memory leak in \f(CW\*(C`guestfs_filesystem_walk\*(C'\fR (Susant Sahani).
.PP
In \f(CW\*(C`guestfs_disk_create\*(C'\fR, when creating raw block devices, check for
errors in the \fBclose\fR\|(2) system call, ensuring we don\*(Aqt miss any
delayed I/O errors (Susant Sahani).
.PP
In several LVM\-related APIs, it was possible for an internal failure
to happen for logical volumes which are incomplete (eg. missing a
physical volume).  This was fixed by skipping these LVs (Arye
Yurkovsky).
.SS "Language bindings"
.IX Subsection "Language bindings"
Note that GObject / Javascript bindings will be removed in the next
release of libguestfs.
.PP
Ruby deprecation warnings were fixed (Cole Robinson).
.SS Documentation
.IX Subsection "Documentation"
Fix links to ntfs\-3g documentation (Cole Robinson).
.SS "Build changes"
.IX Subsection "Build changes"
libvirt ≥ 11.10.0 with passt support is now required.
.PP
qemu ≥ 7.2.0 is now required.
.PP
Fix guestmount compilation on macOS (thanks Mohamed Akram).
.PP
Basic github CI has been implemented.  Pull requests now do the
equivalent of \f(CW\*(C`./configure \-\-enable\-werror && make && make check\*(C'\fR on
a few common platforms.
.PP
Several obsolete tests were removed, and the test suite in general has
been fixed and made more robust against missing dependencies and other
common problems (Cole Robinson).
.PP
In test output we no longer print absolute paths for the test names
(Cole Robinson).
.PP
\&\f(CW\*(C`AM_GNU_GETTEXT\*(C'\fR usage was completely removed and replaced
with a simple test for LIBINTL (Cole Robinson).
.PP
\&\fIbuild\-aux/config.rpath\fR was removed since it was no longer actually
used (Cole Robinson).
.PP
Fix const\-correctness issues caused by changes to the \fBstrchr\fR\|(3) and
\&\fBstrrchr\fR\|(3) functions in C23.
.SS Internals
.IX Subsection "Internals"
If the \f(CW\*(C`sit.ko\*(C'\fR Linux kernel module is loaded, then a \f(CW\*(C`sit0\*(C'\fR (a kind
of IPv6 tunnel) network device is created in the appliance.  Ignore
this as it would break appliance networking (thanks Srikanth Aithal,
Stefano Brivio).
.PP
In the direct backend we simplified probing of qemu features by
assuming that qemu ≥ 7.2.0.
.PP
In the libvirt backend:
.IP \(bu 4
Fix compatibility with SeaBIOS 1.17 (thanks Gerd Hoffmann).
.IP \(bu 4
We made some changes to how errors from the libvirt call
\&\f(CW\*(C`virDomainDestroyFlags\*(C'\fR are handled when shutting down the appliance.
If there is an error, the error message is now printed when debug is
enabled (but it is still non\-fatal).  Also we sleep between retries
instead of busy looping.
.IP \(bu 4
The libvirt backend now adds a virtio\-rng device to the appliance
unconditionally so that we always have good entropy (for cryptographic
operations).
.IP \(bu 4
When running as root, remove explicit socket relabelling and allow
libvirt to relabel the sockets instead (Cole Robinson).
.IP \(bu 4
Enable sVirt for the appliance, which was sometimes accidentally
disabled (Cole Robinson).
.PP
During inspection of Linux/Unix guests, the contents of guest
\&\fI/etc/fstab\fR and some mdadm files are written to debug output.  This
can help with debugging inspection issues (thanks Ming Xie).
.PP
When the appliance starts up, if debugging is enabled, then we log
\&\fBlsblk\fR\|(8) and \fBblkid\fR\|(8) info to debugging output (thanks Ming
Xie).
.PP
In the generator \f(CWStringList(Pathname)\fR was implemented for OCaml
functions.
.PP
Add more debugging in Windows Registry inspection functions to make it
easier to track what\*(Aqs going on.
.PP
OCaml \f(CW\*(C`{|...|}\*(C'\fR string literals are now used in the code for things
like literal Windows batch files that we inject into the guest,
regular expressions, and POD documentation in the generator (thanks
Nicolas Ojeda Bar).
.PP
Internal calls to \fBpcre2_match\fR\|(3) which return an unexpected error
now emit a debug message, although the error is still ignored.
.PP
Multiple code cleanups throughout (Susant Sahani).
.PP
Fix order of inclusion of Python header file because of changes in
recent Python 3.14.
.PP
Some test scripts which were written in Perl before have been
rewritten in Python (Susant Sahani).
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.IP https://issues.redhat.com/browse/RHEL\-104352 4
.IX Item "https://issues.redhat.com/browse/RHEL-104352"
Change permission of guestfs folder created
.IP https://issues.redhat.com/browse/RHEL\-106490 4
.IX Item "https://issues.redhat.com/browse/RHEL-106490"
Adding the commands "lsblk", "cat /etc/fstab" and "blkid" to the v2v
debug log
.IP https://issues.redhat.com/browse/RHEL\-108803 4
.IX Item "https://issues.redhat.com/browse/RHEL-108803"
Parted fails to read a blank disk "virt\-v2v: error: libguestfs error:
inspect_os: parted: /dev/sdb: parted exited with status 1: Error:
/dev/sdb: unrecognised disk label: Invalid argument" [rhel\-9.7]
.IP https://issues.redhat.com/browse/RHEL\-111165 4
.IX Item "https://issues.redhat.com/browse/RHEL-111165"
[Testonly]virt\-v2v of RHEL 8.10 VM fails because setfiles invoked
oom\-killer
.IP https://issues.redhat.com/browse/RHEL\-111505 4
.IX Item "https://issues.redhat.com/browse/RHEL-111505"
Lots of memory used in \*(Aqsetfiles\*(Aq utility / \*(Aqrestorecon_sb\*(Aq function
.IP https://issues.redhat.com/browse/RHEL\-113397 4
.IX Item "https://issues.redhat.com/browse/RHEL-113397"
[DEV Task]: The available subscriptions of guest sometimes can\*(Aqt be
shown unless use \-\-sm\-remove and \-\-sm\-unregister options to remove all
subscriptions from the guest
.IP https://issues.redhat.com/browse/RHEL\-113398 4
.IX Item "https://issues.redhat.com/browse/RHEL-113398"
[DEV Task]: Virt\-v2v can\*(Aqt use \-\-sm\-remove and \-\-sm\-unregister options
to remove the subscriptions from guest if consumer profile has been
deleted from the guest.
.IP https://issues.redhat.com/browse/RHEL\-114292 4
.IX Item "https://issues.redhat.com/browse/RHEL-114292"
Use setfiles \-A option when relabelling
.IP https://issues.redhat.com/browse/RHEL\-121076 4
.IX Item "https://issues.redhat.com/browse/RHEL-121076"
[libguestfs] [aarch64] libguestfs\-test\-tool failed with
LIBGUESTFS_BACKEND=direct
.IP https://issues.redhat.com/browse/RHEL\-125846 4
.IX Item "https://issues.redhat.com/browse/RHEL-125846"
virt\-inspector detect if AV/GPOs are present in a VM
.IP https://issues.redhat.com/browse/RHEL\-93584 4
.IX Item "https://issues.redhat.com/browse/RHEL-93584"
virt\-v2v can\*(Aqt convert sles15sp6 guest with encrypted brtfs fliesystem
.IP https://github.com/libguestfs/libguestfs/issues/180 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/180"
Fails to build with macFUSE
.IP https://github.com/libguestfs/libguestfs/issues/234 4
.IX Item "https://github.com/libguestfs/libguestfs/issues/234"
make \-j8 check failures with selinux enforcing
.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 "Arye Yurkovsky" 4
.IX Item "Arye Yurkovsky"
.PD 0
.IP "Cole Robinson" 4
.IX Item "Cole Robinson"
.IP "Ettore Atalan" 4
.IX Item "Ettore Atalan"
.IP "Fco. Javier F. Serrador" 4
.IX Item "Fco. Javier F. Serrador"
.IP "Pavel Borecki" 4
.IX Item "Pavel Borecki"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.IP "Susant Sahani" 4
.IX Item "Susant Sahani"
.IP "Yuri Chornoivan" 4
.IX Item "Yuri Chornoivan"
.PD
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2026 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.