1guestfs-release-notes-1.24(1)Virtualization Supportguestfs-release-notes-1.24(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.22.0). For detailed changelogs, please see
11 the git repository, or the ChangeLog file distributed in the tarball.
12 New features
14 User-Mode Linux (UML) can be used as an alternative backend (ie.
15 instead of KVM). This improves performance especially when using
16 libguestfs inside a VM (eg. in the cloud). UML is supported as a
17 first-class backend. See "USER-MODE LINUX BACKEND" in guestfs(3) for
18 how to use this.
19 ARM (32 bit) and PPC64 are now fully supported.
21 Tools
23 virt-builder(1) is a new tool for building virtual machine images. It
25 lets you rapidly and securely create guests and customize them.
26 New virt-sysprep(1) operations: Remove files in /tmp and /var/tmp.
28 Remove RPM database files. Change root and user passwords. More log
29 files are removed. New operations which are not enabled by default:
30 Create random UUIDs for filesystems. Reset firewall rules. (Wanlong
31 Gao)
32 virt-resize(1) and virt-sysprep can now use URIs to specify a remote
34 disk.
35 Use "guestfish -N filename=type" to create a named disk image (instead
37 of the default test1.img etc).
38 virt-sparsify(1) now tests if there is enough disk space to complete
40 the operation, instead of possibly running out of space half way
41 through.
42 virt-format(1) and virt-make-fs(1): new --label option for setting
44 filesystem label.
45 virt-resize --no-sparse flag can be used to resize on to partitions and
47 other targets that are not zeroed.
48 Language bindings
50 New bindings for the Go programming language.
52 API
54 Support for the systemd journal.
56 "guestfs_add_drive_opts" can now control the qemu caching mode through
58 a new "cachemode" parameter. You can select improved performance for
59 temporary drives, or safety.
60 "guestfs_set_label" now works for XFS and btrfs.
62 New GUESTFS_EVENT_WARNING event for warning messages.
64 Inspection
66 Better inspection of SUSE guests (Olaf Hering).
68 Better support for non-standard Windows %systemroot% (Matthew Booth).
70 Enhanced error reporting for Augeas errors.
72 Security
74 CVE-2013-2124
75 https://bugzilla.redhat.com/show_bug.cgi?id=968306
76 A denial of service was possible when inspecting certain guests.
78 The fix has been backported to 1.20 and 1.22 branches.
79 CVE-2013-4419
81 https://www.redhat.com/archives/libguestfs/2013-October/msg00031.html
82 Fix insecure temporary directory handling for remote guestfish.
84 The fix has been backported to 1.20 and 1.22 branches.
85 New APIs
87 add-drive-scratch: Add a temporary scratch drive
88 aug-label
89 aug-setm
90 journal-open: Systemd journal support
91 journal-close
92 journal-next
93 journal-skip
94 journal-get
95 journal-get-data-threshold
96 journal-set-data-threshold
97 remount: Allow rw flag to be adjusted on mounted filesystems
98 set-uuid: Set UUID of filesystem
99 "is-file", "is-dir", "is-blockdev", "is-chardev", "is-fifo",
101 "is-socket" APIs now have an extra "followsymlinks" flag.
102 "add-drive" has a new "cachemode" parameter.
104 Build changes
106 The following packages are required to build libguestfs 1.24:
107 Augeas ≥ 1.0.0
109 The following optional packages may be added to enhance functionality
111 but are not required:
112 sd-journal
114 To read journal files from guests which use that.
115 url_mkcow
117 For UML backend.
118 curl
120 gpg
121 xz For virt-builder.
122 golang ≥ 1.1.1
124 For Go language bindings.
125 Internals
127 New "make check-*" rules replace "make extra-tests". See "make help"
128 and guestfs(3) for details.
129 Perl code can now be valgrinded.
131 Inspection code is now fuzz-tested.
133 "make" no longer recurses into the generator directory in every other
135 directory. This reduces the overhead of builds considerably.
136 Additional tests for Augeas, hivex.
138 Add a launch timeout of 20 minutes waiting for the appliance to start
140 up.
141 Add a timeout (4 hours) to all tests so we can catch the case where
143 qemu or other components hang.
144 Use kvmclock and "-cpu host". This improves clock stability and
146 overall performance.
147 "./configure --enable-packet-dump" mode is fixed.
149 "./configure --enable-valgrind-daemon" mode has been rewritten. It is
151 now feasible for developers to keep this flag enabled at all times.
152 Backends have been refactored to be modular (although they are not
154 actually loadable modules).
155 When enabled, the network now uses resolver configuration (ie.
157 /etc/resolv.conf) from the host.
158 Bugs fixed
160 https://bugzilla.redhat.com/1019889
161 libguestfs-tools.conf should have a man page
162 https://bugzilla.redhat.com/1018149
164 valgrind errors in btrfs_subvolume_list
165 https://bugzilla.redhat.com/1002032
167 mke2fs can't return the correct filesystem type when blockscount is
168 less than 2048 for ext3
169 https://bugzilla.redhat.com/1001876
171 Update "rsync-out" helpout for using wildcard
172 https://bugzilla.redhat.com/1001875
174 Argument 'excludes' of tar-out does not work
175 https://bugzilla.redhat.com/1000428
177 virt-format uses wrong partition type for vfat filesystems
178 https://bugzilla.redhat.com/1000121
180 'sh' command before mount causes daemon to segfault
181 https://bugzilla.redhat.com/998513
183 guestfish does not work when you mix --remote and --add options
184 https://bugzilla.redhat.com/998482
186 guestfish remote prints "libguestfs: error: waitpid (qemu): No
187 child processes"
188 https://bugzilla.redhat.com/995711
190 list-filesystems command fails if there are no block devices
191 https://bugzilla.redhat.com/994517
193 cache=none/O_DIRECT workaround doesn't work for images with backing
194 files
195 https://bugzilla.redhat.com/989356
197 cap-get-file will return error if the file has not be set
198 capabilities
199 https://bugzilla.redhat.com/986877
201 RFE: Implement set-uuid command
202 https://bugzilla.redhat.com/986875
204 RFE: Implement set-label for xfs
205 https://bugzilla.redhat.com/985269
207 Can't set acl value for a specified user with 'acl-set-file'
208 https://bugzilla.redhat.com/983218
210 libguestfs double free when kernel link fails during launch
211 https://bugzilla.redhat.com/981715
213 Make xfs filesystem failed with specified blocksize, gives "unknown
214 option -b" error
215 https://bugzilla.redhat.com/981683
217 "hivex-commit" should fail with a relative path
218 https://bugzilla.redhat.com/981663
220 disk-format "qemu-img info: JSON parse error" when target file does
221 not exist
222 https://bugzilla.redhat.com/978302
224 mke2fs-J should give a meaningful error when specified type is
225 anything except 'ext{2,3,4}'
226 https://bugzilla.redhat.com/975797
228 Specifying virtio interface ('iface' parameter) breaks the direct
229 backend - libguestfs hangs
230 https://bugzilla.redhat.com/975753
232 "virt-resize --expand" and "virt-resize --resize" outputs error
233 message for Win2008 32bit OS
234 https://bugzilla.redhat.com/975412
236 inspection: Augeas expressions are broken with augeas >= 0.10
237 https://bugzilla.redhat.com/974904
239 virt-resize --expand fails on Ubuntu Cloud Image
240 https://bugzilla.redhat.com/974489
242 Regression: Fedora inspection broken by change from guestfs_exists
243 to guestfs_is_file
244 https://bugzilla.redhat.com/972775
246 txz-out command produces a bzip2-compressed file (should be xz-
247 compressed)
248 https://bugzilla.redhat.com/969845
250 upload to a directory occasionally hangs instead of failing
251 https://bugzilla.redhat.com/968875
253 virt-sysprep should support URL-type arguments
254 https://bugzilla.redhat.com/624334
256 blockdev-setbsz succeeds, but does not affect blockdev-getbsz
257
259 guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
260 guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
261 http://libguestfs.org/
262
264 Richard W.M. Jones
265
267 Copyright (C) 2009-2020 Red Hat Inc.
268
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 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 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
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 To report a new bug against libguestfs, use this link:
289 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
290 When reporting a bug, please supply:
292 • The version of libguestfs.
294 • Where you got libguestfs (eg. which Linux distro, compiled from
296 source, etc)
297 • Describe the bug accurately and give a way to reproduce it.
299 • Run libguestfs-test-tool(1) and paste the complete, unedited output
301 into the bug report.
302libguestfs-1.46.0 2021-09-23 guestfs-release-notes-1.24(1)