guestfs-release-notes-1.32(1)

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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.32

9       These release notes only cover the differences from the previous
10       stable/dev branch split (1.30.0).  For detailed changelogs, please see
11       the git repository, or the ChangeLog file distributed in the tarball.
12
13   New features
14       New tools
15
16       The new virt-v2v-copy-to-local(1) tool is an ancillary tool for
17       virt-v2v(1) allowing you to convert source guests that virt-v2v is
18       unable to access directly.
19
20       New features in existing tools
21
22       Virt-customize knows how to write a random seed to CirrOS (Pino
23       Toscano).
24
25       On Fedora, virt-customize runs dnf(8) with the --best flag, ensuring it
26       always updates to the latest available packages.
27
28       Virt-builder now provides 32 bit Fedora templates.
29
30       Virt-builder and virt-customize --install option now works on 32 bit
31       Fedora guests.  Previously it would try to install 64 bit packages (Jan
32       Sedlák).
33
34       Virt-builder can now fetch cloud images using Simple Streams v1.0
35       metadata (Pino Toscano).
36
37       Virt-builder can now fetch openSUSE cloud images out of the box (Cédric
38       Bosdonnat).
39
40       Virt-customize will now use stronger (SHA-512) encrypted passwords by
41       default on openSUSE ≥ 11 (Pino Toscano).
42
43       Virt-builder will now correctly handle output filenames containing
44       colon characters (":"), and will create temporary files in the
45       libguestfs cache directory instead of defaulting to /tmp (Pino
46       Toscano).
47
48       Virt-resize has a new --unknown-filesystems option to control what to
49       do when asked to resize a filesystem that libguestfs doesn't know how
50       to resize.
51
52       Virt-v2v now has an --in-place flag/mode, allowing in-place conversion
53       of guests (Roman Kagan).
54
55       Virt-v2v has a --compressed option for creating compressed qcow2 output
56       files.
57
58       Virt-v2v can now correctly get the VMware datacenter path (dcPath) from
59       libvirt, instead of having to calculate it using an algorithm that
60       occasionally got the wrong answer (Matthias Bolte, Tingting Zheng).
61
62       Virt-v2v now processes RAM sizes correctly for 64 bit guests when
63       running on a 32 bit host.
64
65       Language bindings
66
67       In Perl and Python programs, the "get_program_name" API now returns the
68       true program name, instead of the incorrect string "perl" or "python".
69
70       The Python bindings can now be compiled against a different version of
71       libguestfs, allowing the pip module to be built against any version of
72       libguestfs (instead of requiring the pip module and libguestfs to have
73       exactly the same version).
74
75       The quality of the Ruby rdoc (documentation) has been improved (Pino
76       Toscano).
77
78       Perl scripts no longer hard-code the location of perl in the shebang
79       line, but use env(1) to locate it instead (Pino Toscano).
80
81       In OCaml programs, the guestfs handle was incorrectly made into a
82       global root, meaning it could never be garbage collected.  If you
83       didn't call the "close" function explicitly, the handle would not be
84       closed until the whole program exited.  This has now been fixed so
85       handles will be garbage collected in the usual way.  This changes the
86       API of the OCaml function "Guestfs.event_callback".  Note that non-C
87       language bindings are not covered by the libguestfs API/ABI guarantee,
88       although we try hard not to change them, but in this case it was
89       essential in order to fix this very serious bug.
90
91       Inspection
92
93       Alpine Linux and the APK package manager, ALT Linux, Frugalware, and
94       PLD Linux are now recognized (Pino Toscano).
95
96       If it exists, /etc/os-release will be preferred for inspecting Linux
97       guests (Pino Toscano).
98
99       The correct kernel version is returned for Windows guests ≥ 10.
100
101       Documentation
102
103       The large guestfs(3) man page has been split into several separate man
104       pages: guestfs-hacking(1) guestfs-internals(1) guestfs-security(1).  In
105       the source tree, a new docs directory contains this documentation.
106
107       Architectures and platforms
108
109       Libguestfs now supports ARM 64 bit platforms with vGICv3.
110
111   Security
112       See also guestfs-security(1).
113
114       "CVE-2015-5745"
115           https://bugzilla.redhat.com/1251157
116
117           This is not a vulnerability in libguestfs, but because we always
118           give a virtio-serial port to each guest (since that is how guest-
119           host communication happens), an escalation from the appliance to
120           the host qemu process is possible.  This could affect you if:
121
122           •   your libguestfs program runs untrusted programs out of the
123               guest (using "guestfs_sh" etc), or
124
125           •   another exploit was found in (for example) kernel filesystem
126               code that allowed a malformed filesystem to take over the
127               appliance.
128
129           If you use sVirt to confine qemu, that would thwart some attacks.
130
131       Virt-customize permissions on .ssh, .ssh/authorized_keys
132           https://bugzilla.redhat.com/1260778.
133
134           Previously when asked to inject an SSH key into a guest, virt-
135           customize (hence virt-builder too) would create the .ssh directory
136           and .ssh/authorized_keys file with too broad permissions, allowing
137           other users to read.  They are now created as 0700 and 0600
138           respectively, which is the same as the ssh-copy-id(1) utility.
139
140   API
141       New APIs
142
143       "guestfs_get_identifier"
144       "guestfs_set_identifier"
145           Get/set a per-handle identifier.  The main effect of this is to
146           change trace output from:
147
148            libguestfs: trace: foo
149
150           to:
151
152            libguestfs: trace: ID: foo
153
154           making it easier to follow traces in multi-threaded programs, or
155           where a program uses multiple handles (especially virt-v2v).
156
157       "guestfs_vfs_minimum_size"
158           Return the minimum size of a filesystem (when shrunk).  This
159           supports ext2/3/4, XFS and btrfs, and can support other filesystem
160           types in future (Maxim Perevedentsev).
161
162       Other API changes
163
164       "guestfs_disk_create": add "preallocation" = "off"/"metadata"/"full".
165           For raw, this allows "off" as a synonym for "sparse" (making it
166           consistent with qcow2).  For qcow2, this allows "sparse" as a
167           synonym for "off".
168
169           It also adds "full", which corresponds to fully allocated, but uses
170           posix_fallocate(3) for efficiency.
171
172       "guestfs_tar_in": new "xattrs", "selinux", "acl" parameters.
173       "guestfs_tar_out": new "xattrs", "selinux", "acl" parameters.
174           These extra parameters control whether extended attributes, SELinux
175           contexts and/or POSIX ACLs are restored from / saved to tarballs.
176
177       "guestfs_add_drive"
178           The existing "username" and "secret" parameters can be used to
179           supply authentication for iSCSI (Pino Toscano).
180
181   Build changes
182       The "./configure --enable-valgrind-daemon" option has been removed.
183
184       You can no longer build libguestfs on RHEL 5-era (c.2007) machines.
185       See the "oldlinux" branch if you need (limited) RHEL 5 support.
186
187       Virt-p2v can now be built on RHEL 6-era (c.2010) Linux distros.
188
189       OCaml ≥ 3.11 (released in 2008) is now required to build from git.
190
191       Building the Perl bindings now requires "Module::Build" (instead of
192       "ExtUtils::MakeMaker").
193
194       Builds should be faster (especially when incrementally rebuilding),
195       because work was done to reduce build times.
196
197       Both OCaml and the OCaml findlib module are required if you need to run
198       the generator at build time.  Previously the build would have failed if
199       findlib was not installed.
200
201       "make check" tests now run in parallel (within each test directory).
202
203       "make install" no longer installs OCaml bindtests.* files incorrectly.
204
205       "make install" can now be run twice.  Previously it would fail on the
206       second run.
207
208       "make clean" should now remove nearly every file that "make" creates.
209
210       A new "make installcheck" rule has been added, allowing the installed
211       copy of libguestfs to be tested.
212
213   Internals
214       Some effort was put into minimizing the size of the appliance, which
215       reduces temporary disk space and time needed by libguestfs handles.
216
217       The appliance now passes the NIC name to dhcpd, fixing hangs when
218       running the appliance on some distros (Cédric Bosdonnat).
219
220       OCaml "Guestfs.Errno" is now generated (Pino Toscano).
221
222       In OCaml tools, common code now handles --debug-gc, --verbose and other
223       common options (Roman Kagan, Pino Toscano).
224
225       The virt-v2v test harness allows us to boot the test guests at fixed
226       dates in the past, ensuring that Windows reactivation doesn't kick in.
227
228       There is a new internal API for reading/writing a subprocess via a pipe
229       from library code.
230
231       Used "deheader" program to remove unused "#include" directives.
232
233       In OCaml tools, the "Char" and "String" modules now implicitly
234       reference the "Common_utils.Char" and "Common_utils.String" modules
235       (instead of the ones from stdlib).  The "Common_utils" modules contain
236       a number of extra char/string utility functions, and also hide some
237       unsafe functions in stdlib.
238
239       Many more virt-v2v tests will now be run even if you don't have
240       rhsrvany and virtio-win installed (Roman Kagan).
241
242       The huge configure.ac file has been split into several smaller files
243       called m4/guestfs_*.m4.
244
245       The old tests/data and tests/guests directories have been moved to
246       test-data/.  This new top level directory carries all test data which
247       is common, large and/or shared between multiple tests.
248
249       There is a new top level website/ directory containing the public
250       http://libguestfs.org website (or most of it).
251
252       The fuzz testing of inspection (tests/fuzz) has been removed.
253
254       Virt-p2v now saves the source physical machine dmesg output into the
255       conversion server debug directory, making it simpler to debug cases of
256       missing drivers, firmware etc.
257
258   Bugs fixed
259       https://bugzilla.redhat.com/1294956
260           set-label returns wrong error message when set the ext3/ext4
261           filesystem label
262
263       https://bugzilla.redhat.com/1288733
264           Add a Fedora 23 32-bit base image for virt-builder
265
266       https://bugzilla.redhat.com/1288201
267           virt-builder writes temporary files to /tmp
268
269       https://bugzilla.redhat.com/1285847
270           virt-resize does not copy logical partitions
271
272       https://bugzilla.redhat.com/1281578
273           virt-inspector returns version 6.3 for win10 images (should return
274           10.0)
275
276       https://bugzilla.redhat.com/1281577
277           virt-inspector --xpath segfault on attribute get
278
279       https://bugzilla.redhat.com/1280029
280           libguestfs can run commands with stdin not open (or worse still,
281           connected to arbitrary guest-chosen random devices)
282
283       https://bugzilla.redhat.com/1279273
284           About compression option for qcow2
285
286       https://bugzilla.redhat.com/1278878
287           guestfish should be able to handle LVM thin layouts
288
289       https://bugzilla.redhat.com/1278382
290           DNF python programming error when run from virt-builder
291
292       https://bugzilla.redhat.com/1278371
293           inspection returns arch="unknown" for Windows guest if file command
294           is not installed
295
296       https://bugzilla.redhat.com/1277274
297           Document permissions needed for non-admin users to use virt-v2v
298
299       https://bugzilla.redhat.com/1277122
300           RFE: virt-sparsify: make '--in-place' sparsification safe to abort
301           (gracefully or ungracefully)
302
303       https://bugzilla.redhat.com/1277074
304           Virt-p2v client shouldn't present the vdsm option because it's not
305           usable
306
307       https://bugzilla.redhat.com/1276540
308           virt-v2v fails to convert Windows raw image: error "device name is
309           not a partition"
310
311       https://bugzilla.redhat.com/1275806
312           virt-builder: error: [file] is not a regular file in the guest
313
314       https://bugzilla.redhat.com/1270011
315           Simplestreams test fails: virt-builder: error: the value for the
316           key 'size' is not an integer
317
318       https://bugzilla.redhat.com/1267032
319           guestfish copy-in command behaves oddly/unexpectedly with wildcards
320
321       https://bugzilla.redhat.com/1262983
322           python: Cannot compile pip module if installed libguestfs != pip
323           guestfs version
324
325       https://bugzilla.redhat.com/1262127
326           Better diagnostic message when virbr0 doesn't exist
327
328       https://bugzilla.redhat.com/1261436
329           No warning shows when convert a win7 guest with AVG AntiVirus
330           installed
331
332       https://bugzilla.redhat.com/1260778
333           virt-builder --ssh-inject doesn't set proper permissions on created
334           files
335
336       https://bugzilla.redhat.com/1260689
337           RFE: V2V to check and warn user to disable group policy and anti
338           virus on Windows guests
339
340       https://bugzilla.redhat.com/1260590
341           Wrong graphics protocal and video type set for guest after convert
342           to rhev 3.6 by virt-v2v
343
344       https://bugzilla.redhat.com/1258342
345           extra slashes in vcenter URL confuses virt-v2v
346
347       https://bugzilla.redhat.com/1257895
348           [RHEV][V2V] virt-v2v ignores NIC if interface source/@network or
349           source/@bridge is an empty string
350
351       https://bugzilla.redhat.com/1256405
352           virt-builder created Fedora 22 32bit disk image cannot be updated
353
354       https://bugzilla.redhat.com/1256222
355           virt-p2v no GUI mode:error opening control connection to
356           $ip:22:unexpected …rompt
357
358       https://bugzilla.redhat.com/1251909
359           Option -oa preallocated -of qcow2 of virt-v2v didn't work
360           efficiently
361
362       https://bugzilla.redhat.com/1250715
363           v2v: spaces need to be escaped as %20 in paths
364
365       https://bugzilla.redhat.com/1248678
366           Close all incoming ports on virt-p2v ISO
367
368       https://bugzilla.redhat.com/1246882
369           man virt-customize shows synopsis twice
370
371       https://bugzilla.redhat.com/1242853
372           mount-loop failed to setup loop device: No such file or directory
373
374       https://bugzilla.redhat.com/1237136
375           BUG: unable to handle kernel NULL pointer dereference at <addr> in
376           function __blkg_lookup
377
378       https://bugzilla.redhat.com/1230412
379           virt-v2v should ignore bogus kernel entries in grub config
380
381       https://bugzilla.redhat.com/1229119
382           Unrelated info in fstab makes virt-v2v fail with unclear error info
383
384       https://bugzilla.redhat.com/1227609
385           virt-p2v: Using "Back" button causes output list to be repopulated
386           multiple times
387
388       https://bugzilla.redhat.com/1225789
389           Wrong video driver is installed for rhel5.11 guest after conversion
390           to libvirt
391
392       https://bugzilla.redhat.com/1204131
393           RFE: virt-builder creates qcow v3 images, add build option for qcow
394           v2
395
396       https://bugzilla.redhat.com/1176801
397           File /etc/sysconfig/kernel isn't updated when convert XenPV guest
398           with regular kernel installed
399
400       https://bugzilla.redhat.com/1174551
401           "lstatnslist" and "lstatlist" don't give an error if the API is
402           used wrongly
403
404       https://bugzilla.redhat.com/1168223
405           koji spin-livecd cannot build a working live CD
406
407       https://bugzilla.redhat.com/1165785
408           mount-loop command fails: mount failed: Unknown error -1
409
410       https://bugzilla.redhat.com/1164708
411           set-label can only set <=127 bytes for btrfs and <=126 bytes for
412           ntfs filesystem which not meet the help message. Also for ntfs it
413           should give a warning message when the length >128 bytes
414
415       https://bugzilla.redhat.com/1020216
416           libvirt fails to shut down domain: could not destroy libvirt
417           domain: Requested operation is not valid: domain is not running
418
419       https://bugzilla.redhat.com/1011907
420           mount-loop failed to setup loop device: No such file or directory
421

AUTHOR

428       Richard W.M. Jones
429

COPYRIGHT

431       Copyright (C) 2009-2020 Red Hat Inc.
432

LICENSE

434       This program is free software; you can redistribute it and/or modify it
435       under the terms of the GNU General Public License as published by the
436       Free Software Foundation; either version 2 of the License, or (at your
437       option) any later version.
438
439       This program is distributed in the hope that it will be useful, but
440       WITHOUT ANY WARRANTY; without even the implied warranty of
441       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
442       General Public License for more details.
443
444       You should have received a copy of the GNU General Public License along
445       with this program; if not, write to the Free Software Foundation, Inc.,
446       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
447

BUGS

449       To get a list of bugs against libguestfs, use this link:
450       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
451
452       To report a new bug against libguestfs, use this link:
453       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
454
455       When reporting a bug, please supply:
456
457       •   The version of libguestfs.
458
459       •   Where you got libguestfs (eg. which Linux distro, compiled from
460           source, etc)
461
462       •   Describe the bug accurately and give a way to reproduce it.
463
464       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
465           into the bug report.
466
467
468
469libguestfs-1.48.3                 2022-05-26     guestfs-release-notes-1.32(1)

NAME

RELEASE NOTES FOR LIBGUESTFS 1.32

SEE ALSO

AUTHOR

COPYRIGHT

LICENSE

BUGS