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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.42

9       Please note that virt-v2v, virt-p2v and the boot analysis tools were
10       moved out of the libguestfs package / repository into separate
11       projects.  See:
12
13       •   https://github.com/libguestfs/virt-v2v
14
15       •   https://github.com/libguestfs/virt-p2v
16
17       •   https://github.com/libguestfs/libguestfs-analysis-tools
18
19       Those projects are now on a separate release cycle.  Release notes are
20       published separately.
21
22   New features
23       Add support for the Vala language (Corentin Noël).
24
25       Add support for the Rust language (Hiroyuki Katsura, sponsored by
26       Google Summer of Code).
27
28       Reproducible builds (Chris Lamb).
29
30       Advanced Format disks (which use 4K sectors) can now be processed by
31       libguestfs.  Use the new optional "blocksize" parameter to
32       "guestfs_add_drive_opts", and the --blocksize option added to several
33       tools (Nikolay Ivanets).
34
35       Windows CompactOS (NTFS file compression) is now supported.
36
37       New features in existing tools
38
39       Advanced machine readable output in various virt tools now supports
40       JSON output, and writing logs to a numbered file descriptor (Pino
41       Toscano).
42
43       virt-filesystems tool now more accurately reports filesystem total
44       size, in the case where for example the filesystem does not occupy the
45       whole of its containing device (Pino Toscano).
46
47       Language bindings
48
49       Python ≥ 2.7 is required.
50
51       Python bindings are now more extensively tested (Hiroyuki Katsura).
52
53       Python bindings should now work with Python ≥ 3.8.
54
55       Multiple fixes to avoid crashes in the Python bindings (Sam Eiderman).
56
57       OCaml bindings are compiled with "-DCAML_NAME_SPACE" to ensure no
58       non-caml_-namespaced symbols are used (Pino Toscano).
59
60       OCaml bindings should now work with OCaml 4.09 and 4.10.
61
62       Erlang has deprecated the old "erl_interface" library which we use for
63       Erlang bindings.  It will be removed in OTP 22, which will permanently
64       break Erlang support unless someone steps forward to update the Erlang
65       bindings in libguestfs.
66
67       Fix compatibility with newer cgo for Go bindings (Tomáš Golembiovský).
68
69       Go API error handling is now more idiomatic (Csaba Henk).
70
71       Update documentation about how to handle boolean parameters in Ruby
72       bindings (Csaba Henk).
73
74       Inspection
75
76       Libguestfs can now extract icons for Gentoo, newer SUSE and
77       OpenMandriva guests.  Improved extraction of RHEL icons.  (Pino
78       Toscano).
79
80       Inspection returns the osinfo IDs of newer Windows versions, and
81       rolling Linux distros (Pino Toscano).
82
83       OpenMandriva is now detected (Bernhard Rosenkränzer).
84
85       Arch Linux detection improvements (Pino Toscano).
86
87       Architectures and platforms
88
89       Libguestfs can now be compiled on OpenMandriva (Bernhard Rosenkränzer).
90
91       Ubuntu fix for enabling network support (Ioanna Alifieraki).
92
93       Other
94
95       Use of deprecated libguestfs APIs will now cause compiler deprecation
96       warnings by default, whereas previously you have to enable these
97       warnings.  To turn off these warnings use
98       "-DGUESTFS_NO_WARN_DEPRECATED=1".  A new feature is that you can now
99       disable deprecated APIs completely if you want, using
100       "-DGUESTFS_NO_DEPRECATED=1" (Pino Toscano).
101
102       Fix hostname in virt-builder templates (Pino Toscano).
103
104       The single large release notes file is now split into multiple
105       documents organized by version.
106
107       The "--key" option of several tools was broken, especially if you tried
108       to use the option to pass multiple keys.  This has been fixed and a
109       regression test added.
110
111       Augeas exceptions occurring in daemon (eg. during inspection) will now
112       produced detailed errors (Pino Toscano).
113
114   Security
115       No security issues were found in this release.
116
117   API
118       New APIs
119
120       "luks_uuid" returns the UUID of a LUKS device (Pino Toscano).
121
122       Other API changes
123
124       Cope with new output from the "btrfs scrub" command.  There is no
125       visible change at the API level.
126
127       New optional parameter "blocksize" added to "guestfs_add_drive_opts" to
128       support Advanced Format disks (Nikolay Ivanets).
129
130   Build changes
131       Minimum version of Augeas required is 1.2.0 (Pino Toscano).
132
133       "common/" subdirectory is now a git submodule shared with the virt-v2v
134       project.
135
136       Supermin ≥ 5.1.18 is required.
137
138       There were several bugs in libvirt 5.10.0 and 6.0 which affected
139       libguestfs.  It is highly advisable to use libvirt 6.1 where these bugs
140       are fixed (versions of libvirt < 5.10.0 are also fine).
141
142       Many gnulib modules which we were not using or which we used in only a
143       few places have been removed (Pino Toscano).
144
145       Multiple fixes for builddir != sourcedir builds (Pino Toscano).
146
147       A new "bundled/" subdirectory contains one bundled library that we
148       currently use, "ocaml-augeas" (Pino Toscano).
149
150       Fix compatibility issues when being compiled with GCC 10.
151
152   Internals
153       When linking OCaml programs, automake silent rules and the "V=1" flag
154       are both now obeyed (Pino Toscano).
155
156       The "guestfs_device_index" API was reimplemented in library code
157       instead of in the daemon.  There should be no observable effect of this
158       change.
159
160       Since Linux 5.6 enumerates "/dev/sdX" devices in parallel, libguestfs
161       was changed to map API device names to appliance device names, and then
162       do the reverse mapping when returning names from the appliance.
163       Hopefully this should have no observable effect, but can produce
164       somewhat confusing debugging messages since device names in the debug
165       might not match device names passed in to APIs.  Furthermore the
166       "root=UUID=..." option is always passed to the appliance (instead of
167       naming the device containing the root filesystem).
168
169       We expect to move from the Zanata service to the Weblate service for
170       translated strings.  For more information see
171       https://bugzilla.redhat.com/1787301
172
173   Bugs fixed
174       https://bugzilla.redhat.com/1773520
175           Segfault in python bindings for
176           guestfs_int_py_event_callback_wrapper
177
178       https://bugzilla.redhat.com/1746699
179           Can't import guest from export domain to data domain on rhv4.3 due
180           to error "Invalid parameter: 'DiskType=1'"
181
182       https://bugzilla.redhat.com/1733168
183           virt-v2v: Use scp -T in -i vmx -it ssh mode
184
185       https://bugzilla.redhat.com/1723305
186           Delete info"export PATH=/path/to/nbdkit-1.1.x:$PATH" in
187           virt-v2v-input-vmware manual page
188
189       https://bugzilla.redhat.com/1705482
190           python 3.8 requires using -embed variant of pkgconf file, causing
191           libguestfs to fail to build Python 3.8 bindings
192
193       https://bugzilla.redhat.com/1703463
194           libguestfs cannot inspect disks using WIndows 10 NTFS compression,
195           error "unsupported reparse point"
196
197       https://bugzilla.redhat.com/1694268
198           [PATCH] Add OpenMandriva support
199
200       https://bugzilla.redhat.com/1691659
201           virt-v2v should show a message when qemu-guest-agent is installed
202           in guest successfully during conversion
203
204       https://bugzilla.redhat.com/1690574
205           virt-v2v fails to import a guest while cannot find
206           `file_architecture` for a file
207
208       https://bugzilla.redhat.com/1680361
209           [v2v][RHV][Scale] v2v Migration to RHV failed on timed out waiting
210           for transfer to finalize
211
212       https://bugzilla.redhat.com/1661871
213           python bindings wrongly using str for APIs with RBufferOut/FBuffer
214           on Python 3
215
216       https://bugzilla.redhat.com/1626503
217           Unable to maintain static IP address configuration post VM
218           migration
219
220       https://bugzilla.redhat.com/1612653
221           Guest has no disk after rhv-upload converting if target data domain
222           has similar name with other data domain on rhv4.2
223
224       https://bugzilla.redhat.com/1605242
225           Update nbdkit info for vddk in v2v man page
226
227       https://bugzilla.redhat.com/1584678
228           On W2K12r2 rhev-apt does not run non-interactively, causing race
229           when starting rhev-apt service from the command line
230
231       https://bugzilla.redhat.com/1518539
232           Macvtap network will be lost during v2v conversion
233
234       https://bugzilla.redhat.com/1351000
235           virt-customize --commands-from-file will fail if there is an extra
236           blank in the file
237

SEE ALSO

239       guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
240       guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
241       http://libguestfs.org/
242

AUTHORS

244       Ioanna Alifieraki
245
246       Sam Eiderman
247
248       Tomáš Golembiovský
249
250       Csaba Henk
251
252       Nikolay Ivanets
253
254       Richard W.M. Jones
255
256       Hiroyuki Katsura
257
258       Chris Lamb
259
260       Corentin Noël
261
262       Bernhard Rosenkränzer
263
264       Pino Toscano
265

COPYRIGHT

267       Copyright (C) 2009-2023 Red Hat Inc.
268

LICENSE

270       This program is free software; you can redistribute it and/or modify it
271       under the terms of the GNU General Public License as published by the
272       Free Software Foundation; either version 2 of the License, or (at your
273       option) any later version.
274
275       This program is distributed in the hope that it will be useful, but
276       WITHOUT ANY WARRANTY; without even the implied warranty of
277       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
278       General Public License for more details.
279
280       You should have received a copy of the GNU General Public License along
281       with this program; if not, write to the Free Software Foundation, Inc.,
282       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
283

BUGS

285       To get a list of bugs against libguestfs, use this link:
286       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
287
288       To report a new bug against libguestfs, use this link:
289       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
290
291       When reporting a bug, please supply:
292
293       •   The version of libguestfs.
294
295       •   Where you got libguestfs (eg. which Linux distro, compiled from
296           source, etc)
297
298       •   Describe the bug accurately and give a way to reproduce it.
299
300       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
301           into the bug report.
302
303
304
305libguestfs-1.50.1                 2023-02-21     guestfs-release-notes-1.42(1)