1guestfs-release-notes-1.50(1)Virtualization Supportguestfs-release-notes-1.50(1)
2
6 guestfs-release-notes - libguestfs Release Notes
7
9 These are the release notes for libguestfs stable release 1.50. This
10 describes the major changes since 1.48.
11 Libguestfs 1.50.0 was released on 7 February 2023.
13 Language bindings
15 Fix the PHP bindings for PHP8 (Geoff Amey).
16 Fix various deprecation warnings in the GObject bindings.
18 We no longer use the deprecated Python distutils library (thanks Miro
20 Hrončok).
21 Inspection
23 When listing the packages in RPM-based guests, the inspection API no
24 longer checks package signatures. This is because the newer librpm
25 used by libguestfs does not understand signatures stored in older
26 guests, such as SHA1 used by RHEL 6 (thanks Panu Matilainen).
27 "guestfs_inspect_get_hostname" in guestfs(3) can now handle
29 /etc/hostname files containing comments (thanks Dawid Zamirski).
30 "guestfs_file_architecture" in guestfs(3) can now parse files using
32 zstd compression.
33 "guestfs_inspect_get_osinfo" in guestfs(3) now returns the correct
35 osinfo field for Windows 11. However because of decisions made by
36 Microsoft, these guests still return product name and other strings
37 identifying as Windows 10 (thanks Yaakov Selkowitz, Yongkui Guo).
38 API
40 New APIs
41 "guestfs_device_name" in guestfs(3) is a new API to read the device
43 name associated with a drive, for example calling this with 0 will
44 return "/dev/sda".
45 "guestfs_clevis_luks_unlock" in guestfs(3) is a new API for unlocking
47 disks using the Clevis/Tang network-based full disk encryption scheme.
48 Furthermore implement this in guestfish and guestmount (Laszlo Ersek).
49 "guestfs_inspect_get_build_id" in guestfs(3) is a new API for reading
51 the build ID from some Linux and Windows guests. It is not widely used
52 on Linux, but for Windows it is vital for identifying Windows 11.
53 Other API changes
55 In the "guestfs_add_drive" in guestfs(3) API, the "name" and "iface"
57 fields are not used. "name" has not been used since around 2017, but
58 the documentation has only just been updated to reflect this. "iface"
59 was never allowed for the libvirt backend and didn't work reliably with
60 the direct backend (Laszlo Ersek).
61 "guestfs_readdir" in guestfs(3) is no longer limited to the maximum
63 message size but can read a directory of any size (Laszlo Ersek).
64 Build changes
66 Note that the Augeas bindings for libguestfs are no longer bundled with
67 libguestfs and must be built separately. See:
68 https://people.redhat.com/~rjones/augeas/ For RHEL 7+ rebuilding the
69 Fedora Rawhide package will work.
70 Note that libguestfs now requires minimum OCaml 4.04. It will not
72 compile on RHEL 6.
73 Note that zstd is now a required dependency.
75 OCaml gettext is no longer a dependency of libguestfs. (Plain gettext
77 is still optionally used to translate C source files.)
78 Add support for OCaml 4.14.
80 Fix build for missing stdlib functions in OCaml 4.04.
82 Fix "./configure --disable-ocaml". OCaml is still required to build
84 libguestfs, but this now correctly disables the OCaml bindings of the
85 API.
86 Add support for building on Artix, Rocky and Virtuozzo (Halil Tezcan
88 KARABULUT, Neil Hanlon, Andrey Drobyshev). In addition when working
89 out the local distro we now look at $ID_LIKE in /etc/os-release before
90 $ID which helps on Arch (thanks S D Rausty).
91 Add preliminary support for compiling libguestfs on macOS.
93 Fix website description of cloning the libguestfs repository (Kashyap
95 Chamarthy).
96 We no longer use glibc custom printf.
98 We no longer use "LD_PRELOAD=libSegFault.so" in the appliance. This
100 feature was removed in glibc 2.35.
101 We no longer use dtrace / systemtap probes.
103 Internals
105 Fix regression tests to use correct paths (Nikolay Shirokovskiy).
106 Various improvements to qcow2 appliance handling (Andrey Drobyshev).
108 Disable 5-level page tables in qemu. This avoids a bug in older
110 versions of qemu.
111 Disable the LVM2 devicesfile in the appliance since it interferes with
113 cloned LVs that have the same UUID (Laszlo Ersek).
114 Don't use "-cpu max" on RISC-V as it is not yet supported by qemu's TCG
116 emulation of that architecture. This will be reenabled when qemu gets
117 support.
118 Avoid a rare hang that would happen when launching the appliance. This
120 turned out to be caused by using the unsafe call setenv(3) between fork
121 and exec (thanks Siddhesh Poyarekar).
122 When running the file command inside the appliance we now disable
124 seccomp since it interferes with processing compressed files (thanks
125 David Runge, Toolybird).
126 Bugs fixed
128 https://bugzilla.redhat.com/2108425
129 compile of libguestfs-1.48.4 fails with Error: static declaration
130 of ‘caml_alloc_initialized_string’ follows non-static declaration
131 https://bugzilla.redhat.com/2064182
133 SHA 1 signatures required to inspect packages in RHEL 6 guests
134 https://bugzilla.redhat.com/2033247
136 document encrypted RBD disk limitation
137 https://bugzilla.redhat.com/2012658
139 libguestfs fails to detect Windows 11 guest image
140 https://bugzilla.redhat.com/1965941
142 lvm-set-filter failed in guestfish with the latest lvm2 package
143 https://bugzilla.redhat.com/1844341
145 The duplicate block device is listed when iface is set to 'virtio'
146 https://bugzilla.redhat.com/1809453
148 [RFE] Add support for LUKS encrypted disks with Clevis & Tang
149 https://bugzilla.redhat.com/1794518
151 Rewrite libguestfs use of setfiles so that it doesn't stop on ext4
152 immutable bits
153 https://bugzilla.redhat.com/1674392
155 No return values from a directory listing when there are simply too
156 many files in that directory (NULL value return)
157 https://bugzilla.redhat.com/1554735
159 RFE: customize --selinux-relabel should be the default, with
160 --no-selinux-relabel used to opt out
161
163 guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
164 guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
165 http://libguestfs.org/
166
168 Adolfo Jayme Barrientos
169 Andrey Drobyshev
170 Emilio Herrera
171 Ettore Atalan
172 Geoff Amey
173 Hela Basa
174 Jan Kuparinen
175 Kashyap Chamarthy
176 Laszlo Ersek
177 Marcin Stanclik
178 Michał Smyk
179 Neil Hanlon
180 Nikolay Shirokovskiy
181 Pavel Borecki
182 Piotr Drąg
183 Richard W.M. Jones
184 Ricky Tigg
185 Temuri Doghonadze
186 Yuri Chornoivan
187
189 Copyright (C) 2009-2023 Red Hat Inc.
190
192 This program is free software; you can redistribute it and/or modify it
193 under the terms of the GNU General Public License as published by the
194 Free Software Foundation; either version 2 of the License, or (at your
195 option) any later version.
196 This program is distributed in the hope that it will be useful, but
198 WITHOUT ANY WARRANTY; without even the implied warranty of
199 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
200 General Public License for more details.
201 You should have received a copy of the GNU General Public License along
203 with this program; if not, write to the Free Software Foundation, Inc.,
204 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
205
207 To get a list of bugs against libguestfs, use this link:
208 https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
209 To report a new bug against libguestfs, use this link:
211 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
212 When reporting a bug, please supply:
214 • The version of libguestfs.
216 • Where you got libguestfs (eg. which Linux distro, compiled from
218 source, etc)
219 • Describe the bug accurately and give a way to reproduce it.
221 • Run libguestfs-test-tool(1) and paste the complete, unedited output
223 into the bug report.
224libguestfs-1.51.9 2023-12-09 guestfs-release-notes-1.50(1)