1guestfs-release-notes-1.14(1)Virtualization Supportguestfs-release-notes-1.14(1)
2
6 guestfs-release-notes - libguestfs Release Notes
7
9 These release notes only cover the differences from the previous
10 stable/dev branch split (1.12.0). For detailed changelogs, please see
11 the git repository, or the ChangeLog file distributed in the tarball.
12 New features
14 Erlang bindings.
15 virt-alignment-scan is a new tool to check the alignment of
17 partitions within virtual machines or disk images.
18 virt-sparsify is a new tool to make virtual machine disk images
20 sparse.
21 virt-sysprep is a new tool to make cloning guests from a template
23 simpler.
24 guestfish
26 - New commands setenv, unsetenv, to set environment variables.
28 - The input file and line number is printed in error messages.
30 - guestfish progress bars are now a "mini-library" used by other
32 tools too.
33 guestmount
35 - the --live option (for access to live VMs) now works.
37 virt-cat
39 - virt-cat can now handle Windows paths and drive letters (RHBZ#693359).
41 virt-filesystems
43 - the MBR partition type byte is displayed in --long output.
45 virt-make-fs
47 - virt-make-fs now sets the MBR partition type byte correctly,
49 improving compatibility with Windows (RHBZ#746295).
50 virt-resize
52 - virt-resize can now work with guests using extended and logical
54 partitions, in particular Ubuntu guests.
55 - virt-resize can now align the first partition of Windows guests,
57 improving performance. The new virt-resize --align-first option
58 controls this behaviour.
59 - The virt-resize --machine-readable flag makes it possible to use
61 virt-resize from other programs.
62 - Partitions are now aligned to 128 sectors (usually 64K) by
64 default. This improves efficiency on high-end storage. The new
65 virt-resize --alignment option allows the alignment to be
66 adjusted.
67 virt-win-reg
69 - The syntax for deleting registry keys and values is documented
71 in the man page (RHBZ#737944).
72 library
74 - non-printing characters are escaped correctly in debug output.
76 - GUESTFS_EVENT_ENTER is a new event type generated whenever a
78 libguestfs function is called.
79 - the library contains systemtap/DTrace probes.
81 - the library can now be compiled without hivex (RHBZ#723474).
83 inspection
85 - Improve detection of Windows disks.
87 - Adds support for:
89 ttylinux - a minimal Linux
90 Mageia (thanks Michael Scherer)
91 OpenSUSE and zypper (thanks Michael Scherer, Vincent Untz)
92 Ubuntu logos (thanks Michael Scherer)
93 NetBSD and pkgsrc (thanks Michael Scherer)
94 - Handle some guest types that use /dev/root in /etc/fstab.
96 - Fix handling of guests with > 26 disks (thanks Matthew Booth)
98 - Add support for guests with HP Smart Array disks (thanks Matthew Booth)
100 febootstrap
102 - FEBOOTSTRAP_KERNEL, FEBOOTSTRAP_MODULES environment variables can
104 be set in order to choose which kernel to use for the appliance.
105 misc
107 - ArchLinux support now working with Linux 3.0 (thanks Erik Nolte)
109 - libvirt disks marked <readonly/> are now added readonly when
111 using the virt-tools '-d' option.
112 Security
114 (no security problems were found or fixed in this release)
115 New APIs
117 compress-out, compress-device-out, copy-device-to-device,
118 copy-device-to-file, copy-file-to-device, copy-file-to-file,
119 get-smp, part-to-partnum, set-smp.
120 The mount API no longer implicitly adds -o sync,noatime options.
122 add-domain has a new 'readonlydisk' optional parameter to control
124 how <readonly/> disks are handled.
125 Internals
127 - Coverity was run on the source and more bugs were identified and
128 fixed.
129 - PCRE library is now required to build libguestfs.
131 - APIC is now the default for the appliance. You can also enable
133 SMP support in the appliance.
134 - OCaml bindings now correctly acquire GC lock during callbacks.
136 - Out of tree builds should now work correctly (thanks Hilko Bengen).
138 - ./configure --with-extra="..." can be used by packagers to set
140 the extra version string.
141 - zero, zero-device APIs: if the blocks already contain zeroes,
143 don't write zeroes, so that we don't unnecessarily make the
144 underlying storage non-sparse.
145 - is-zero, is-zero-device APIs: optimize these so zero detection is
147 faster.
148 Bugs fixed
150 - 748266 libguestfs should detect versions of qemu which require -machine pc option
151 - 747290 libguestfs ignores <readonly/> in libvirt XML
152 - 747287 Misleading error message when permission denied opening a disk image
153 - 746295 virt-make-fs doesn't set partition ID
154 - 744795 guestmount --live is not usable
155 - 737944 virt-win-reg hyphen (delete key) syntax may be wrong, and is not documented
156 - 733297 ruby event handlers fail with "exception in callback: wrong argument type Proc (expected Data)"
157 - 731744 libguestfs should escape special/non-printing characters in debug output
158 - 729887 appliance crashes running aug_init with flags=4
159 - 729075 libguestfs confuses Hp_recovery partition with Windows root filesystem
160 - 727178 error: luks_open: cryptsetup: error while loading shared libraries: libfipscheck.so.1: cannot open shared object file: No such file or directory
161 - 726739 libguestfs: error: aug_get: no matching node, trying to find hostname
162 - 723474 If hivex and/or pcre not installed, libguestfs fails to compile
163 - 693359 virt-cat and virt-edit don't handle case sensitive NTFS paths properly
164 - 678231 virt-inspector reports unknown filesystem UUID
165 - 671082 libguestfs does not work with kernel-rt
166 - 666578 libguestfs: unknown filesystem label SWAP-sda2
167 - 642821 virt-resize falls over on a disk image with a logical swap partition
168
170 guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
171 guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
172 http://libguestfs.org/
173
175 Richard W.M. Jones
176
178 Copyright (C) 2009-2020 Red Hat Inc.
179
181 This program is free software; you can redistribute it and/or modify it
182 under the terms of the GNU General Public License as published by the
183 Free Software Foundation; either version 2 of the License, or (at your
184 option) any later version.
185 This program is distributed in the hope that it will be useful, but
187 WITHOUT ANY WARRANTY; without even the implied warranty of
188 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
189 General Public License for more details.
190 You should have received a copy of the GNU General Public License along
192 with this program; if not, write to the Free Software Foundation, Inc.,
193 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
194
196 To get a list of bugs against libguestfs, use this link:
197 https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
198 To report a new bug against libguestfs, use this link:
200 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
201 When reporting a bug, please supply:
203 · The version of libguestfs.
205 · Where you got libguestfs (eg. which Linux distro, compiled from
207 source, etc)
208 · Describe the bug accurately and give a way to reproduce it.
210 · Run libguestfs-test-tool(1) and paste the complete, unedited output
212 into the bug report.
213libguestfs-1.42.0 2020-03-09 guestfs-release-notes-1.14(1)