guestfs-release-notes-1.48(1)

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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.48

9       These are the release notes for libguestfs stable release 1.48.  This
10       describes the major changes since 1.46.
11
12       Libguestfs 1.48.0 was released on 14 March 2022.
13
14   Some features removed
15       The following little used, experimental or unsafe features have been
16       removed:
17
18       "Libguestfs live" was an experimental feature that allowed you (in
19       theory) to connect to an existing instance of the libguestfs daemon in
20       a running guest.  If you want to do this we recommend installing qemu-
21       guest-agent in the guest instead and using the APIs provided by it.
22       The related "unix:" backend has been removed.  The guestfish(1) and
23       guestmount(1) --live option now prints an error.
24
25       The User-mode Linux ("uml") backend has been removed.  It was an
26       alternate hypervisor that could be used instead of qemu.  It had many
27       limitations including lack of network support, and lack of qemu native
28       features like qcow2 or network-backed disks.  In addition it was slower
29       than KVM and particular features like bulk upload/download were
30       painfully slow.  Also the UML feature of Linux that it was based on
31       often does not work.
32
33       The 9pfs APIs "guestfs_list_9p" and "guestfs_mount_9p" have been
34       deprecated and now return errors.  This was related to an experimental
35       feature for passing through host filesystems to the appliance.  You had
36       to hand-hack the qemu command line for this to work and it did not fit
37       the libguestfs model very well.
38
39       "guestfs_add_drive" no longer supports hotplugging (adding a drive
40       after launch), and "guestfs_remove_drive" has been deprecated and now
41       returns an error.  Hotplugging was an unsuccessful feature which was
42       complicated to implement and maintain, and was slow and insecure.  It
43       also only worked with the non-default libvirt backend, and was never
44       implemented in the default "direct" backend.
45
46   Language bindings
47       Fix allocation and deallocation of string lists in golang bindings
48       (Laszlo Ersek).
49
50       Multiple fixes to the OCaml bindings: Fix warnings, move minimum
51       version to OCaml 4.04, replace various deprecated OCaml features with
52       modern OCaml features.
53
54       Running "make distclean" in the rust directory now completely cleans
55       the cargo temporary files.
56
57   Inspection
58       Fix inspection of modern Pardus GNU/Linux (Laszlo Ersek).
59
60       Add support for Kylin (Laszlo Ersek).
61
62       Add support for Rocky Linux (Neil Hanlon).
63
64       Inspection of guests which use LUKS encryption on top of LVM logical
65       volumes should now work (Laszlo Ersek).
66
67   API
68       New APIs
69
70       No new APIs were added in libguestfs 1.48.
71
72       Other API changes
73
74       "guestfs_list_9p" and "guestfs_mount_9p" are deprecated and now return
75       errors.
76
77       "guestfs_remove_drive" has been deprecated and now returns an error.
78
79       In "guestfs_xfs_admin" the "lazycounter" parameter is deprecated
80       because it is no longer supported in recent versions of XFS.
81
82       Partition APIs now cope with the broken MBR partition tables created by
83       dosfstools ≥ 4.2 (Laszlo Ersek).
84
85       In "guestfs_md_create" the "chunk" parameter should not be used with
86       RAID 1.  Previously it was allowed but ignored, but now it will give an
87       error (Laszlo Ersek).
88
89   Build changes
90       Multiple compiler warnings fixed and/or analyzed and suppressed (Laszlo
91       Ersek).
92
93       Fix detection of optional Yara library using pkg-config instead of
94       checking for library/header file (Laszlo Ersek).
95
96       Update valgrind suppressions for glibc 2.35, OCaml 4.13 and libvirt
97       7.7.  "make check-valgrind" works again.
98
99       If using libvirt ≥ 3.8.0, we now use <interface> to create the
100       appliance network interface instead of adding qemu command line
101       parameters (Laszlo Ersek).
102
103       The guestfs-release-notes(1) page was a broken link, but it has now
104       been restored as a new page that links to the release notes from each
105       stable release.
106
107   Internals
108       The libc API strerror_r(3) is difficult to use correctly because of
109       differing signatures in glibc and other libc.  A wrapper
110       "guestfs_int_strerror" has been created to hide the differences.
111
112   Bugs fixed
113       https://bugzilla.redhat.com/2030709
114           [RFE] libguestfs: Add Rocky Linux support
115
116       https://bugzilla.redhat.com/2030396
117           Fix usage of strerror_r which caused corrupted error messages
118
119       https://bugzilla.redhat.com/2024022
120           xfs-admin: Cannot disable lazy-counters on V5 fs
121
122       https://bugzilla.redhat.com/1995391
123           RFE: virt-inspector fails to detect the distro and applications on
124           Kylin-Desktop-V10 image
125
126       https://bugzilla.redhat.com/1993842
127           RFE: virt-inspector fails to detect the distro on Pardus-19.5 image
128
129       https://bugzilla.redhat.com/1931821
130           work around mkfs.vfat writes corrupted filesystem/partition table
131           when used on whole block device
132
133       https://bugzilla.redhat.com/1451665
134           RFE: Virt-v2v can't convert the guest which has encrypted partition
135

AUTHORS

142       Laszlo Ersek
143       Neil Hanlon
144       Richard W.M. Jones
145

COPYRIGHT

147       Copyright (C) 2009-2022 Red Hat Inc.
148

LICENSE

150       This program is free software; you can redistribute it and/or modify it
151       under the terms of the GNU General Public License as published by the
152       Free Software Foundation; either version 2 of the License, or (at your
153       option) any later version.
154
155       This program is distributed in the hope that it will be useful, but
156       WITHOUT ANY WARRANTY; without even the implied warranty of
157       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
158       General Public License for more details.
159
160       You should have received a copy of the GNU General Public License along
161       with this program; if not, write to the Free Software Foundation, Inc.,
162       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
163

BUGS

165       To get a list of bugs against libguestfs, use this link:
166       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
167
168       To report a new bug against libguestfs, use this link:
169       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
170
171       When reporting a bug, please supply:
172
173       •   The version of libguestfs.
174
175       •   Where you got libguestfs (eg. which Linux distro, compiled from
176           source, etc)
177
178       •   Describe the bug accurately and give a way to reproduce it.
179
180       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
181           into the bug report.
182
183
184
185libguestfs-1.48.3                 2022-05-26     guestfs-release-notes-1.48(1)

NAME

RELEASE NOTES FOR LIBGUESTFS 1.48

SEE ALSO

AUTHORS

COPYRIGHT

LICENSE

BUGS