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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.46

9       The big news in this release is that the virt tools like
10       virt-builder(1), virt-cat(1), virt-customize(1), virt-df(1), and many
11       more were moved to a new project.  The temporary repository for the new
12       guestfs-tools project is here:
13       https://github.com/rwmjones/guestfs-tools while we set up a permanent
14       home for it on gitlab.  The tarballs containing the tools are here:
15       https://download.libguestfs.org/guestfs-tools/
16
17       Spinning out all of the tools into a new repository has made libguestfs
18       a bit easier and simpler to build and manage, and allows us to focus on
19       just being the API.
20
21       Note that the tools guestfish(1) (which is really a "shell API"),
22       guestmount(1), libguestfs-test-tool(1) and virt-rescue(1) are still
23       part of the libguestfs repo.
24
25       The not quite so big news is that we have moved away from FreeNode to
26       Libera Chat for IRC.  The new channel on Libera is called "#guestfs"
27       (thanks Daniel Berrangé).
28
29   Language bindings
30       Libguestfs is now compatible with Go 1.16, and defines a Go module
31       (thanks Gianfranco Costamagna).
32
33       Memory leaks in Python APIs that returned structs are fixed (thanks
34       朱丹).
35
36       Python PyPi code has been relicensed to LGPLv2+ (from GPLv2+).
37
38   Inspection
39       Inspection of RPM guests now uses librpm instead of trying to parse the
40       Berkeley DB directly.  Since most RPM-based guests have replaced BDB
41       with sqlite this allows us to read these newer guests while retaining
42       compatibility with the older guests (thanks Panu Matilainen).
43
44       Inspection of RHEL 8+ with split /usr configuration has been made more
45       reliable.
46
47       Inspection of Windows Server 2022 should now work correctly (Yongkui
48       Guo).
49
50   API
51       New APIs
52
53       No new APIs were added in libguestfs 1.46.
54
55       Other API changes
56
57       The output of the "guestfs_cap_get_file" API has changed slightly
58       because of changes in the underlying libcap.  This isn't strictly
59       speaking an API break because the new output is a still valid but more
60       compact description of file capabilities, but because it is different
61       it may cause problems for users of the API.
62
63       The "guestfs_mkfs_btrfs" API now ignores the "allocstart" parameter
64       since it was deprecated by btrfs 4.14.1 and later removed.
65
66       "guestfs_isoinfo_*" APIs now directly parse the CD Primary Volume
67       Descriptor instead of using an external tool.  The APIs should appear
68       to work exactly the same (thanks Thomas Schmitt).
69
70       You can now force the appliance to use KVM or fail if not supported
71       (Sam Eiderman).
72
73       Because of a change to XFS in version 5, disabling lazy-counters no
74       longer works.  The API still works for earlier versions of XFS (Laszlo
75       Ersek).
76
77   Build changes
78       The build now uses and requires PCRE2 (instead of PCRE).
79
80       This version requires libvirt ≥ 7.1.0, if libvirt is enabled.
81
82       gnulib is no longer bundled with libguestfs, making builds from git
83       much simpler.
84
85       Perl "Sys::Virt" (libvirt bindings for Perl) are no longer required by
86       libguestfs.
87
88       The code has been compiled with both LTO and GCC -fanalyzer and many
89       bugs and warnings fixed.
90
91       Allow projects like guestfs-tools and virt-v2v to be compiled with
92       locally built (but not installed) libguestfs (Laszlo Ersek).
93
94       Tests now run in parallel (many additional fixes by Laszlo Ersek).
95
96       Work around RAID0 regression in Linux 3.14/5.4 (Laszlo Ersek).
97
98       Support for RISC-V (Heinrich Schuchardt).
99
100       Support for building on Alma and Cloud Linux (Александр Кравченко).
101
102       Fix to compile with OCaml 4.12.
103
104       The tarball no longer includes the ChangeLog file.  To get a detailed
105       changelog, please look at the upstream git repository.
106
107       Don't assume bash in the ./configure script (Martin Kletzander).
108
109       Fix ./configure --with-distro option (Alexandre Iooss).
110
111       Various fixes for qemu 6.1.
112
113       Fix creating appliance dependencies on Debian (Hilko Bengen).
114
115       Update appliance packages on SUSE and several other improvements to the
116       init script (Olaf Hering).
117
118   Internals
119       We now use the qemu / libvirt feature -cpu max to select the best CPU
120       to run the appliance.  This should improve performance for things like
121       encrypted disks (Daniel Berrangé).
122
123       When passing the appliance filesystem UUID to supermin we now read it
124       directly out of the appliance instead of using the file(1) program.
125       This is more reliable, especially as file often breaks or changed its
126       output.
127
128       The qemu -enable-fips option is no longer used.  It was not needed and
129       has been deprecated by qemu.
130
131       On Fedora, pull in glibc-gconv-extra to fix the "guestfs_syslinux" API
132       (Yongkui Guo).
133
134       We no longer use qemu's sga (Serial Graphics Adapter) option ROM,
135       instead using the equivalent seabios feature.
136
137   Bugs fixed
138       https://bugzilla.redhat.com/2002325
139           Use -machine graphics=off instead of sga device
140
141       https://bugzilla.redhat.com/2001636
142           [RFE] libguestfs: Add detection of AlmaLinux and CloudLinux
143
144       https://bugzilla.redhat.com/1997446
145           osinfo is not correct when handling windows server 2022 image
146
147       https://bugzilla.redhat.com/1990720
148           syslinux: failed to create ldlinux.sys
149
150       https://bugzilla.redhat.com/1985912
151           The lstatns function has a memory leak. (python3)
152
153       https://bugzilla.redhat.com/1960217
154           [Regression] ls: cannot read symbolic link after running guestmount
155
156       https://bugzilla.redhat.com/1949683
157           virt-v2v: error: inspection could not detect the source guest (or
158           physical  machine)
159
160       https://bugzilla.redhat.com/1938982
161           Move libguestfs from PCRE to PCRE2
162
163       https://bugzilla.redhat.com/1930996
164           [Regression] lvcreate fails to wipe signatures again
165
166       https://bugzilla.redhat.com/1930133
167           Virt-v2v can't convert rhel8 guest whose usr partition is
168           independent
169
170       https://bugzilla.redhat.com/1915646
171           libguestfs-1.44.0 - guestfs appliance path broken
172
173       https://bugzilla.redhat.com/1911177
174           virt-builder + virt-install creates a VM that cannot boot fedora 33
175
176       https://bugzilla.redhat.com/1766487
177           libguestfs assumes rpmdb is in Berkeley DB format
178
179       https://bugzilla.redhat.com/1409024
180           [Debian] Missing db_dump abort inspection
181

SEE ALSO

183       guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
184       guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
185       http://libguestfs.org/
186

AUTHORS

188       Alexandre Iooss
189       Daniel P. Berrangé
190       Heinrich Schuchardt
191       Hilko Bengen
192       Laszlo Ersek
193       Martin Kletzander
194       Remi Collet
195       Richard W.M. Jones
196       Sam Eiderman
197
199       Copyright (C) 2009-2021 Red Hat Inc.
200

LICENSE

202       This program is free software; you can redistribute it and/or modify it
203       under the terms of the GNU General Public License as published by the
204       Free Software Foundation; either version 2 of the License, or (at your
205       option) any later version.
206
207       This program is distributed in the hope that it will be useful, but
208       WITHOUT ANY WARRANTY; without even the implied warranty of
209       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
210       General Public License for more details.
211
212       You should have received a copy of the GNU General Public License along
213       with this program; if not, write to the Free Software Foundation, Inc.,
214       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
215

BUGS

217       To get a list of bugs against libguestfs, use this link:
218       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
219
220       To report a new bug against libguestfs, use this link:
221       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
222
223       When reporting a bug, please supply:
224
225       •   The version of libguestfs.
226
227       •   Where you got libguestfs (eg. which Linux distro, compiled from
228           source, etc)
229
230       •   Describe the bug accurately and give a way to reproduce it.
231
232       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
233           into the bug report.
234
235
236
237libguestfs-1.46.0                 2021-09-23     guestfs-release-notes-1.46(1)
Impressum