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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.18

9       These release notes only cover the differences from the previous
10       stable/dev branch split (1.16.0).  For detailed changelogs, please see
11       the git repository, or the ChangeLog file distributed in the tarball.
12
13   New features
14       virt tools
15
16          - virt-sysprep has been rewritten and expanded (thanks Wanlong Gao)
17            http://libguestfs.org/virt-sysprep.1.html
18
19          - virt-sparsify --zero is a new option that zeroes the named
20            partition or filesystem
21
22          - virt-sparsify can now safely sparsify Linux swap partitions
23
24          - virt-sparsify fixed so it cleans up after ^C
25            http://libguestfs.org/virt-sparsify.1.html
26
27          - a new tool 'libguestfs-make-fixed-appliance' is provided to build
28            fixed appliances that can be copied to other machines that don't
29            have febootstrap support
30            http://libguestfs.org/libguestfs-make-fixed-appliance.1.html
31
32          - virt-filesystems now displays the parents (containers) of MD
33            devices and volume groups
34
35          - virt-alignment-scan, run with no args, displays alignment information
36            for all libvirt domains
37
38          - virt-df and virt-alignment-scan will display information from all
39            guests even when a disk is inaccessible
40
41          - virt-rescue new --scratch option to make scratch disks
42            https://rwmj.wordpress.com/2012/04/26/virt-rescue-scratch/#content
43
44          - virt-make-fs can now be used to create btrfs
45
46          - virt-edit preserves permissions, UID, GID and SELinux context
47            when editing files
48
49          - guestfish passes the close event over stdout and remote correctly
50
51          - guestfish new '--pipe-error' option lets you detect errors in pipe
52            commands
53
54          - guestfish globs now expand device names
55
56          - comma and colon characters in filenames now handled correctly by
57            all virt tools
58
59       inspection
60
61          - added support for Fedora 17+
62
63          - added support for FreeDOS
64
65          - added support for Buildroot and Cirros
66
67          - inspection is now compatible with Windows guests that have been
68            sysprepped (thanks Grant Williamson).
69
70       API
71
72          - broad support for btrfs added, including adding multiple devices,
73            fsck, snapshots (thanks Wanlong Gao)
74
75          - the new 'mount-local' API brings FUSE support directly into the
76            core libguestfs API
77            https://rwmj.wordpress.com/2012/05/14/tip-using-mount-local-api-from-c/#content
78
79          - new man page: guestfs-performance(1), which contains performance
80            tuning tips
81            http://libguestfs.org/guestfs-performance.1.html
82
83          - new man page: guestfs-faq(1), Frequently Asked Questions
84            http://libguestfs.org/guestfs-faq.1.html
85
86          - ENOTSUP (from guestfs_last_errno) is now returned for APIs that
87            are not supported
88
89       examples
90
91          - 'copy_over' example showing how to copy between two handles
92
93          - 'display_icon' program displays the icon associated with a guest
94
95          - 'mount_local.c' example shows how to use the mount-local API
96
97   Security
98         (no security problems were found or fixed in this release)
99
100   New APIs
101         btrfs-device-add: Add devices to a btrfs filesystem.
102         btrfs-device-delete: Remove devices from a btrfs filesystem.
103         btrfs-filesystem-sync: Sync a btrfs filesystem.
104         btrfs-filesystem-balance: Balance a btrfs filesystem.
105         btrfs-fsck: Check btrfs filesystem.
106         btrfs-set-seeding: Enable or disable seeding.
107         btrfs-subvolume-create: Create a btrfs snapshot.
108         btrfs-subvolume-delete: Delete a btrfs snapshot.
109         btrfs-subvolume-list: List btrfs snapshots and subvolumes.
110         btrfs-subvolume-set-default: Set default btrfs subvolume.
111         btrfs-subvolume-snapshot: Create a writable btrfs snapshot.
112         get-e2attrs: List ext2 file attributes of a file.
113         get-e2generation: Get ext2 file generation of a file.
114         isoinfo, isoinfo-device: Get information from the header of ISO files.
115         llz: List files with SELinux information.
116         lvcreate-free: Create an LVM logical volume in % remaining free space.
117         md-stat: Return underlying devices from an MD device.
118         mkfs-brtfs: Make btrfs filesystem, with all tunables.
119         mount-local, mount-local-run, umount-local: FUSE support in the API.
120         ntfsclone-in, ntfsclone-out: Save, restore NTFS from backup.
121         ntfsfix: Fix common errors and force Windows to check NTFS.
122         set-e2attrs: Set or clear ext2 file attributes of a file.
123         set-e2generation: Set ext2 file generation of a file.
124         set-label: Unified interface for setting filesystem label.
125         vgmeta: Get volume group metadata.
126         wipefs: Wipe filesystem signatures from a device.
127         zero-free-space: Zero free space in a filesystem.
128
129   Internals
130        - The debian/ subdirectory has been removed.  We recommend you use
131          the official Debian packages made by Hilko Bengen.
132          http://people.debian.org/~bengen/libguestfs/
133          http://packages.debian.org/search?keywords=libguestfs
134
135        - O_CLOEXEC / SOCK_CLOEXEC is now used for almost all file
136          descriptors that the library opens.
137
138        - posix_fadvise is called when sequentially reading or writing large
139          files.
140
141        - close all file descriptors and remove all signal handlers in the
142          recovery process
143
144        - multiple gcc warnings and Coverity bugs have been fixed;  many
145          strict-overflow bugs have also been fixed
146
147        - use ./configure --enable-valgrind-daemon to use valgrind on the
148          daemon;  many errors have been fixed
149
150        - use ./configure --with-qemu-options to pass extra options to qemu
151
152        - the daemon now has a growable strings buffer type (DECLARE_STRINGSBUF)
153
154        - the <guestfs.h> header file works with C++ and we have a regression
155          test for this
156
157        - multiple APIs which should only be called in the CONFIG state now
158          give an error if they are not
159
160        - .gitignore fixed to use absolute paths
161
162        - gobject bindings have been expanded, including mapping libguestfs
163          events to gobject signals (thanks Matt Booth)
164
165        - gobject documentation is generated properly (thanks Matt Booth)
166
167        - gobject header files now live in a subdirectory
168
169        - CompareWithString test in the generator now works
170
171        - FUInt32, FUInt64 struct field types now use the correct XDR type
172
173        - OCaml tests are now run on bytecode and native code.
174
175        - java -Xlint:all is used, and all warnings have been fixed
176
177        - bmptopng, wrestool (etc) missing or failure no longer prints
178          warning messages
179
180        - ruby: Use RbConfig instead of Config.
181
182        - PYTHONPATH is set by the ./run script.
183
184        - appliance building is now thread-safe.
185
186        - appliance now uses 'ip' instead of 'ifconfig' and 'netstat'
187          commands
188
189        - several fixes to make parallel builds work properly
190
191        - guestfish --listen now cleans up properly
192
193        - the BUSY state has been removed
194
195        - gettextize has been removed, replaced by a simple Makefile.am
196
197        - gettext support now covers virt-resize, virt-sparsify and virt-sysprep
198
199        - better support for the arm architecture
200
201   Bugs fixed
202        - 822490 virt-ls error: "libguestfs: error: checksum: path: parameter cannot be NULL"
203        - 816839 data overflow error when debug progress -1
204        - 816098 virt-make-fs fails to make a btrfs filesystem because it doesn't allocate enough space
205        - 811872 inspection fails on ubuntu 10.04 guest with encrypted swap
206        - 811650 guestfs_last_error not set when qemu fails early during launch
207        - 811649 libguestfs cannot open disk images which are symlinks to files that contain ':' (colon) character
208        - 811117 [RFE][virt-sysprep] net-hwaddr not removed from "ifcfg-*" files on rhel
209        - 811112 [RFE][virt-sysprep] hostname can not be changed on rhel system
210        - 809361 inspection doesn't recognize Fedora 18 (grub2 + GPT)
211        - 807905 mkfs blocksize option breaks when creating btrfs
212        - 805070 virt-filesystems should show 'parents' of LV and RAID devices
213        - 804464 libguestfs cannot be built when LINGUAS is different then ja or uk
214        - 803664 libguestfs inspection fails on Windows XP: libguestfs: error: hivex: could not locate HKLM\SYSTEM\MountedDevices
215        - 803533 guestfish: write error
216        - 802389 event handlers for 'close' event doesn't work in remote mode
217        - 802109 libguestfs uses putc on stderr, results in many individual 1 byte writes of debug messages
218        - 801640 [RFE] the error reported by resize2fs-M need to be more clear
219        - 801298 Possible null dereference and resource leaks
220        - 801273 Document for set-pgroup need to be updated
221        - 798196 virt-resize confuses format and output_format variables; using --output-format sets the input format
222        - 797986 virt-resize on Windows XP in sysprep state causes "UNMOUNTABLE_BOOT_VOLUME" BSOD
223        - 796520 [RFE] Prevent user from running some appliance configure commands after appliance boot up
224        - 790721 multiprovider build error: RuntimeError: link: /tmp/.guestfs-0/kernel /tmp/.guestfs-0/kernel.10139: File exists
225        - 789960 guestfsd crash when try to mount non-exist disk
226        - 789504 virt-df (other tools?) should not give up if a guest disk is missing
227        - 788641 virt-edit doesn't preserve file permissions
228        - 786215 libguestfs inspection does not recognize FreeDOS operating system
229        - 786188 libguestfs inspection does not recognize FreeDOS install CD
230        - 785668 aug-defnode: daemon crash
231        - 784647 Libguestfs uses deprecated net-tools
232        - 769304 virt-resize on RHEL 6 kernel fails to re-read the partition table
233        - 755729 Error message for resize2fs-M needs tweaking
234        - 701814 virt-win-reg fails on a libvirt guest that has no defined disk format: "format parameter is empty or contains disallowed characters"
235        - 679737 libguestfs: improve error message when zerofree is not available in the appliance
236        - 635971 glob mkfs ext2 /dev/vd[b-t]1 does not expand
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

AUTHOR

244       Richard W.M. Jones
245
247       Copyright (C) 2009-2020 Red Hat Inc.
248

LICENSE

250       This program is free software; you can redistribute it and/or modify it
251       under the terms of the GNU General Public License as published by the
252       Free Software Foundation; either version 2 of the License, or (at your
253       option) any later version.
254
255       This program is distributed in the hope that it will be useful, but
256       WITHOUT ANY WARRANTY; without even the implied warranty of
257       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
258       General Public License for more details.
259
260       You should have received a copy of the GNU General Public License along
261       with this program; if not, write to the Free Software Foundation, Inc.,
262       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
263

BUGS

265       To get a list of bugs against libguestfs, use this link:
266       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
267
268       To report a new bug against libguestfs, use this link:
269       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
270
271       When reporting a bug, please supply:
272
273       •   The version of libguestfs.
274
275       •   Where you got libguestfs (eg. which Linux distro, compiled from
276           source, etc)
277
278       •   Describe the bug accurately and give a way to reproduce it.
279
280       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
281           into the bug report.
282
283
284
285libguestfs-1.45.4                 2021-04-03     guestfs-release-notes-1.18(1)
Impressum