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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.24

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
13   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
20       ARM (32 bit) and PPC64 are now fully supported.
21
22       Tools
23
24       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
27       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
33       virt-resize(1) and virt-sysprep can now use URIs to specify a remote
34       disk.
35
36       Use "guestfish -N filename=type" to create a named disk image (instead
37       of the default test1.img etc).
38
39       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
43       virt-format(1) and virt-make-fs(1): new --label option for setting
44       filesystem label.
45
46       virt-resize --no-sparse flag can be used to resize on to partitions and
47       other targets that are not zeroed.
48
49       Language bindings
50
51       New bindings for the Go programming language.
52
53       API
54
55       Support for the systemd journal.
56
57       "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
61       "guestfs_set_label" now works for XFS and btrfs.
62
63       New GUESTFS_EVENT_WARNING event for warning messages.
64
65       Inspection
66
67       Better inspection of SUSE guests (Olaf Hering).
68
69       Better support for non-standard Windows %systemroot% (Matthew Booth).
70
71       Enhanced error reporting for Augeas errors.
72
73   Security
74       CVE-2013-2124
75           https://bugzilla.redhat.com/show_bug.cgi?id=968306
76
77           A denial of service was possible when inspecting certain guests.
78           The fix has been backported to 1.20 and 1.22 branches.
79
80       CVE-2013-4419
81           https://www.redhat.com/archives/libguestfs/2013-October/msg00031.html
82
83           Fix insecure temporary directory handling for remote guestfish.
84           The fix has been backported to 1.20 and 1.22 branches.
85
86   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
100       "is-file", "is-dir", "is-blockdev", "is-chardev", "is-fifo",
101       "is-socket" APIs now have an extra "followsymlinks" flag.
102
103       "add-drive" has a new "cachemode" parameter.
104
105   Build changes
106       The following packages are required to build libguestfs 1.24:
107
108       Augeas ≥ 1.0.0
109
110       The following optional packages may be added to enhance functionality
111       but are not required:
112
113       sd-journal
114           To read journal files from guests which use that.
115
116       url_mkcow
117           For UML backend.
118
119       curl
120       gpg
121       xz  For virt-builder.
122
123       golang ≥ 1.1.1
124           For Go language bindings.
125
126   Internals
127       New "make check-*" rules replace "make extra-tests".  See "make help"
128       and guestfs(3) for details.
129
130       Perl code can now be valgrinded.
131
132       Inspection code is now fuzz-tested.
133
134       "make" no longer recurses into the generator directory in every other
135       directory.  This reduces the overhead of builds considerably.
136
137       Additional tests for Augeas, hivex.
138
139       Add a launch timeout of 20 minutes waiting for the appliance to start
140       up.
141
142       Add a timeout (4 hours) to all tests so we can catch the case where
143       qemu or other components hang.
144
145       Use kvmclock and "-cpu host".  This improves clock stability and
146       overall performance.
147
148       "./configure --enable-packet-dump" mode is fixed.
149
150       "./configure --enable-valgrind-daemon" mode has been rewritten.  It is
151       now feasible for developers to keep this flag enabled at all times.
152
153       Backends have been refactored to be modular (although they are not
154       actually loadable modules).
155
156       When enabled, the network now uses resolver configuration (ie.
157       /etc/resolv.conf) from the host.
158
159   Bugs fixed
160       https://bugzilla.redhat.com/1019889
161           libguestfs-tools.conf should have a man page
162
163       https://bugzilla.redhat.com/1018149
164           valgrind errors in btrfs_subvolume_list
165
166       https://bugzilla.redhat.com/1002032
167           mke2fs can't return the correct filesystem type when blockscount is
168           less than 2048 for ext3
169
170       https://bugzilla.redhat.com/1001876
171           Update "rsync-out" helpout for using wildcard
172
173       https://bugzilla.redhat.com/1001875
174           Argument 'excludes' of tar-out does not work
175
176       https://bugzilla.redhat.com/1000428
177           virt-format uses wrong partition type for vfat filesystems
178
179       https://bugzilla.redhat.com/1000121
180           'sh' command before mount causes daemon to segfault
181
182       https://bugzilla.redhat.com/998513
183           guestfish does not work when you mix --remote and --add options
184
185       https://bugzilla.redhat.com/998482
186           guestfish remote prints "libguestfs: error: waitpid (qemu): No
187           child processes"
188
189       https://bugzilla.redhat.com/995711
190           list-filesystems command fails if there are no block devices
191
192       https://bugzilla.redhat.com/994517
193           cache=none/O_DIRECT workaround doesn't work for images with backing
194           files
195
196       https://bugzilla.redhat.com/989356
197           cap-get-file will return error if the file has not be set
198           capabilities
199
200       https://bugzilla.redhat.com/986877
201           RFE: Implement set-uuid command
202
203       https://bugzilla.redhat.com/986875
204           RFE: Implement set-label for xfs
205
206       https://bugzilla.redhat.com/985269
207           Can't set acl value for a specified user with 'acl-set-file'
208
209       https://bugzilla.redhat.com/983218
210           libguestfs double free when kernel link fails during launch
211
212       https://bugzilla.redhat.com/981715
213           Make xfs filesystem failed with specified blocksize, gives "unknown
214           option -b" error
215
216       https://bugzilla.redhat.com/981683
217           "hivex-commit" should fail with a relative path
218
219       https://bugzilla.redhat.com/981663
220           disk-format "qemu-img info: JSON parse error" when target file does
221           not exist
222
223       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
227       https://bugzilla.redhat.com/975797
228           Specifying virtio interface ('iface' parameter) breaks the direct
229           backend - libguestfs hangs
230
231       https://bugzilla.redhat.com/975753
232           "virt-resize --expand" and "virt-resize --resize" outputs error
233           message for Win2008 32bit OS
234
235       https://bugzilla.redhat.com/975412
236           inspection: Augeas expressions are broken with augeas >= 0.10
237
238       https://bugzilla.redhat.com/974904
239           virt-resize --expand fails on Ubuntu Cloud Image
240
241       https://bugzilla.redhat.com/974489
242           Regression: Fedora inspection broken by change from guestfs_exists
243           to guestfs_is_file
244
245       https://bugzilla.redhat.com/972775
246           txz-out command produces a bzip2-compressed file (should be xz-
247           compressed)
248
249       https://bugzilla.redhat.com/969845
250           upload to a directory occasionally hangs instead of failing
251
252       https://bugzilla.redhat.com/968875
253           virt-sysprep should support URL-type arguments
254
255       https://bugzilla.redhat.com/624334
256           blockdev-setbsz succeeds, but does not affect blockdev-getbsz
257

SEE ALSO

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

AUTHOR

264       Richard W.M. Jones
265
267       Copyright (C) 2009-2020 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.49.9                 2023-01-19     guestfs-release-notes-1.24(1)
Impressum