.\" Automatically generated by Podwrapper::Man 1.50.1 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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
.\" ========================================================================
.\"
.IX Title "guestfs-release-notes-1.50 1"
.TH guestfs-release-notes-1.50 1 "2023-02-21" "libguestfs-1.50.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.50"
.IX Header "RELEASE NOTES FOR LIBGUESTFS 1.50"
These are the release notes for libguestfs stable release 1.50.
This describes the major changes since 1.48.
.PP
Libguestfs 1.50.0 was released on \fB7 February 2023\fR.
.SS "Language bindings"
.IX Subsection "Language bindings"
Fix the \s-1PHP\s0 bindings for \s-1PHP8\s0 (Geoff Amey).
.PP
Fix various deprecation warnings in the GObject bindings.
.PP
We no longer use the deprecated Python distutils library
(thanks Miro Hrončok).
.SS "Inspection"
.IX Subsection "Inspection"
When listing the packages in RPM-based guests, the inspection \s-1API\s0 no
longer checks package signatures.  This is because the newer librpm
used by libguestfs does not understand signatures stored in older
guests, such as \s-1SHA1\s0 used by \s-1RHEL 6\s0 (thanks Panu Matilainen).
.PP
\&\*(L"guestfs_inspect_get_hostname\*(R" in \fBguestfs\fR\|(3) can now handle
\&\fI/etc/hostname\fR files containing comments (thanks Dawid Zamirski).
.PP
\&\*(L"guestfs_file_architecture\*(R" in \fBguestfs\fR\|(3) can now parse files using zstd
compression.
.PP
\&\*(L"guestfs_inspect_get_osinfo\*(R" in \fBguestfs\fR\|(3) now returns the correct
osinfo field for Windows 11.  However because of decisions made by
Microsoft, these guests still return product name and other strings
identifying as Windows 10 (thanks Yaakov Selkowitz, Yongkui Guo).
.SS "\s-1API\s0"
.IX Subsection "API"
\fINew APIs\fR
.IX Subsection "New APIs"
.PP
\&\*(L"guestfs_device_name\*(R" in \fBguestfs\fR\|(3) is a new \s-1API\s0 to read the device name
associated with a drive, for example calling this with \f(CW0\fR will
return \f(CW\*(C`/dev/sda\*(C'\fR.
.PP
\&\*(L"guestfs_clevis_luks_unlock\*(R" in \fBguestfs\fR\|(3) is a new \s-1API\s0 for unlocking
disks using the Clevis/Tang network-based full disk encryption scheme.
Furthermore implement this in guestfish and guestmount (Laszlo Ersek).
.PP
\&\*(L"guestfs_inspect_get_build_id\*(R" in \fBguestfs\fR\|(3) is a new \s-1API\s0 for reading
the build \s-1ID\s0 from some Linux and Windows guests.  It is not widely
used on Linux, but for Windows it is vital for identifying Windows 11.
.PP
\fIOther \s-1API\s0 changes\fR
.IX Subsection "Other API changes"
.PP
In the \*(L"guestfs_add_drive\*(R" in \fBguestfs\fR\|(3) \s-1API,\s0 the \f(CW\*(C`name\*(C'\fR and \f(CW\*(C`iface\*(C'\fR
fields are not used.  \f(CW\*(C`name\*(C'\fR has not been used since around 2017, but
the documentation has only just been updated to reflect this.
\&\f(CW\*(C`iface\*(C'\fR was never allowed for the libvirt backend and didn't work
reliably with the direct backend (Laszlo Ersek).
.PP
\&\*(L"guestfs_readdir\*(R" in \fBguestfs\fR\|(3) is no longer limited to the maximum
message size but can read a directory of any size (Laszlo Ersek).
.SS "Build changes"
.IX Subsection "Build changes"
\&\fBNote\fR that the Augeas bindings for libguestfs are no longer bundled
with libguestfs and must be built separately.  See:
https://people.redhat.com/~rjones/augeas/  For \s-1RHEL 7+\s0 rebuilding
the Fedora Rawhide package will work.
.PP
\&\fBNote\fR that libguestfs now requires minimum OCaml 4.04.  It will not
compile on \s-1RHEL 6.\s0
.PP
\&\fBNote\fR that zstd is now a required dependency.
.PP
OCaml gettext is no longer a dependency of libguestfs.  (Plain gettext
is still optionally used to translate C source files.)
.PP
Add support for OCaml 4.14.
.PP
Fix build for missing stdlib functions in OCaml 4.04.
.PP
Fix \f(CW\*(C`./configure \-\-disable\-ocaml\*(C'\fR.  OCaml is still required to build
libguestfs, but this now correctly disables the OCaml bindings of the
\&\s-1API.\s0
.PP
Add support for building on Artix, Rocky and Virtuozzo (Halil Tezcan
\&\s-1KARABULUT,\s0 Neil Hanlon, Andrey Drobyshev).  In addition when working
out the local distro we now look at \f(CW$ID_LIKE\fR in \fI/etc/os\-release\fR
before \f(CW$ID\fR which helps on Arch (thanks S D Rausty).
.PP
Add preliminary support for compiling libguestfs on macOS.
.PP
Fix website description of cloning the libguestfs repository (Kashyap
Chamarthy).
.PP
We no longer use glibc custom printf.
.PP
We no longer use \f(CW\*(C`LD_PRELOAD=libSegFault.so\*(C'\fR in the appliance.  This
feature was removed in glibc 2.35.
.PP
We no longer use dtrace / systemtap probes.
.SS "Internals"
.IX Subsection "Internals"
Fix regression tests to use correct paths (Nikolay Shirokovskiy).
.PP
Various improvements to qcow2 appliance handling (Andrey Drobyshev).
.PP
Disable 5\-level page tables in qemu.  This avoids a bug in older
versions of qemu.
.PP
Disable the \s-1LVM2\s0 devicesfile in the appliance since it interferes with
cloned LVs that have the same \s-1UUID\s0 (Laszlo Ersek).
.PP
Don't use \f(CW\*(C`\-cpu max\*(C'\fR on RISC-V as it is not yet supported by qemu's
\&\s-1TCG\s0 emulation of that architecture.  This will be reenabled when qemu
gets support.
.PP
Avoid a rare hang that would happen when launching the appliance.
This turned out to be caused by using the unsafe call \fBsetenv\fR\|(3)
between fork and exec (thanks Siddhesh Poyarekar).
.PP
When running the file command inside the appliance we now disable
seccomp since it interferes with processing compressed files (thanks
David Runge, Toolybird).
.SS "Bugs fixed"
.IX Subsection "Bugs fixed"
.IP "https://bugzilla.redhat.com/2108425" 4
.IX Item "https://bugzilla.redhat.com/2108425"
compile of libguestfs\-1.48.4 fails with Error: static declaration of ‘caml_alloc_initialized_string’ follows non-static declaration
.IP "https://bugzilla.redhat.com/2064182" 4
.IX Item "https://bugzilla.redhat.com/2064182"
\&\s-1SHA 1\s0 signatures required to inspect packages in \s-1RHEL 6\s0 guests
.IP "https://bugzilla.redhat.com/2033247" 4
.IX Item "https://bugzilla.redhat.com/2033247"
document encrypted \s-1RBD\s0 disk limitation
.IP "https://bugzilla.redhat.com/2012658" 4
.IX Item "https://bugzilla.redhat.com/2012658"
libguestfs fails to detect Windows 11 guest image
.IP "https://bugzilla.redhat.com/1965941" 4
.IX Item "https://bugzilla.redhat.com/1965941"
lvm-set-filter failed in guestfish with the latest lvm2 package
.IP "https://bugzilla.redhat.com/1844341" 4
.IX Item "https://bugzilla.redhat.com/1844341"
The duplicate block device is listed when iface is set to 'virtio'
.IP "https://bugzilla.redhat.com/1809453" 4
.IX Item "https://bugzilla.redhat.com/1809453"
[\s-1RFE\s0] Add support for \s-1LUKS\s0 encrypted disks with Clevis & Tang
.IP "https://bugzilla.redhat.com/1794518" 4
.IX Item "https://bugzilla.redhat.com/1794518"
Rewrite libguestfs use of setfiles so that it doesn't stop on ext4 immutable bits
.IP "https://bugzilla.redhat.com/1674392" 4
.IX Item "https://bugzilla.redhat.com/1674392"
No return values from a directory listing when there are simply too many files in that directory (\s-1NULL\s0 value return)
.IP "https://bugzilla.redhat.com/1554735" 4
.IX Item "https://bugzilla.redhat.com/1554735"
\&\s-1RFE:\s0 customize \-\-selinux\-relabel should be the default, with \-\-no\-selinux\-relabel used to opt out
.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 "Adolfo Jayme Barrientos" 4
.IX Item "Adolfo Jayme Barrientos"
.PD 0
.IP "Andrey Drobyshev" 4
.IX Item "Andrey Drobyshev"
.IP "Emilio Herrera" 4
.IX Item "Emilio Herrera"
.IP "Ettore Atalan" 4
.IX Item "Ettore Atalan"
.IP "Geoff Amey" 4
.IX Item "Geoff Amey"
.IP "Hela Basa" 4
.IX Item "Hela Basa"
.IP "Jan Kuparinen" 4
.IX Item "Jan Kuparinen"
.IP "Kashyap Chamarthy" 4
.IX Item "Kashyap Chamarthy"
.IP "Laszlo Ersek" 4
.IX Item "Laszlo Ersek"
.IP "Marcin Stanclik" 4
.IX Item "Marcin Stanclik"
.IP "Michał Smyk" 4
.IX Item "Michał Smyk"
.IP "Neil Hanlon" 4
.IX Item "Neil Hanlon"
.IP "Nikolay Shirokovskiy" 4
.IX Item "Nikolay Shirokovskiy"
.IP "Pavel Borecki" 4
.IX Item "Pavel Borecki"
.IP "Piotr Drąg" 4
.IX Item "Piotr Drąg"
.IP "Richard W.M. Jones" 4
.IX Item "Richard W.M. Jones"
.IP "Ricky Tigg" 4
.IX Item "Ricky Tigg"
.IP "Temuri Doghonadze" 4
.IX Item "Temuri Doghonadze"
.IP "Yuri Chornoivan" 4
.IX Item "Yuri Chornoivan"
.PD
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2009\-2023 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 \s-1GNU\s0 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
\&\s-1WITHOUT ANY WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS FOR A PARTICULAR PURPOSE.\s0  See the \s-1GNU\s0
General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, \s-1MA 02110\-1301 USA.\s0
.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.