1guestfs-release-notes-1.50(1)Virtualization Supportguestfs-release-notes-1.50(1)
2
3
4

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.50

9       These are the release notes for libguestfs stable release 1.50.  This
10       describes the major changes since 1.48.
11
12       Libguestfs 1.50.0 was released on 7 February 2023.
13
14   Language bindings
15       Fix the PHP bindings for PHP8 (Geoff Amey).
16
17       Fix various deprecation warnings in the GObject bindings.
18
19       We no longer use the deprecated Python distutils library (thanks Miro
20       Hrončok).
21
22   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
28       "guestfs_inspect_get_hostname" in guestfs(3) can now handle
29       /etc/hostname files containing comments (thanks Dawid Zamirski).
30
31       "guestfs_file_architecture" in guestfs(3) can now parse files using
32       zstd compression.
33
34       "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
39   API
40       New APIs
41
42       "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
46       "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
50       "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
54       Other API changes
55
56       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
62       "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
65   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
71       Note that libguestfs now requires minimum OCaml 4.04.  It will not
72       compile on RHEL 6.
73
74       Note that zstd is now a required dependency.
75
76       OCaml gettext is no longer a dependency of libguestfs.  (Plain gettext
77       is still optionally used to translate C source files.)
78
79       Add support for OCaml 4.14.
80
81       Fix build for missing stdlib functions in OCaml 4.04.
82
83       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
87       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
92       Add preliminary support for compiling libguestfs on macOS.
93
94       Fix website description of cloning the libguestfs repository (Kashyap
95       Chamarthy).
96
97       We no longer use glibc custom printf.
98
99       We no longer use "LD_PRELOAD=libSegFault.so" in the appliance.  This
100       feature was removed in glibc 2.35.
101
102       We no longer use dtrace / systemtap probes.
103
104   Internals
105       Fix regression tests to use correct paths (Nikolay Shirokovskiy).
106
107       Various improvements to qcow2 appliance handling (Andrey Drobyshev).
108
109       Disable 5-level page tables in qemu.  This avoids a bug in older
110       versions of qemu.
111
112       Disable the LVM2 devicesfile in the appliance since it interferes with
113       cloned LVs that have the same UUID (Laszlo Ersek).
114
115       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
119       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
123       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
127   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
132       https://bugzilla.redhat.com/2064182
133           SHA 1 signatures required to inspect packages in RHEL 6 guests
134
135       https://bugzilla.redhat.com/2033247
136           document encrypted RBD disk limitation
137
138       https://bugzilla.redhat.com/2012658
139           libguestfs fails to detect Windows 11 guest image
140
141       https://bugzilla.redhat.com/1965941
142           lvm-set-filter failed in guestfish with the latest lvm2 package
143
144       https://bugzilla.redhat.com/1844341
145           The duplicate block device is listed when iface is set to 'virtio'
146
147       https://bugzilla.redhat.com/1809453
148           [RFE] Add support for LUKS encrypted disks with Clevis & Tang
149
150       https://bugzilla.redhat.com/1794518
151           Rewrite libguestfs use of setfiles so that it doesn't stop on ext4
152           immutable bits
153
154       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
158       https://bugzilla.redhat.com/1554735
159           RFE: customize --selinux-relabel should be the default, with
160           --no-selinux-relabel used to opt out
161

SEE ALSO

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

AUTHORS

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

LICENSE

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
197       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
202       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

BUGS

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
210       To report a new bug against libguestfs, use this link:
211       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
212
213       When reporting a bug, please supply:
214
215       •   The version of libguestfs.
216
217       •   Where you got libguestfs (eg. which Linux distro, compiled from
218           source, etc)
219
220       •   Describe the bug accurately and give a way to reproduce it.
221
222       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
223           into the bug report.
224
225
226
227libguestfs-1.50.1                 2023-02-21     guestfs-release-notes-1.50(1)
Impressum