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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.4

9       These release notes only cover the differences from the previous
10       stable/dev branch split (1.2.0).  For detailed changelogs, please see
11       the git repository, or the ChangeLog file distributed in the tarball.
12
13   New features
14        - guestfish lets you choose a prepared disk image, eg:
15            guestfish -N fs:ext4
16
17        - Add write support to guestmount (FUSE) module.
18
19        - virt-resize can now resize the content of partitions and logical
20          volumes in the guest, and we have better support for shrinking guests.
21
22        - Bash tab-completion script for guestfish.
23
24        - Add ZFS support to virt-rescue.
25
26        - New tool 'virt-make-fs' for creating filesystems with content.
27
28        - Allow suffixes on any guestfish number parameter, eg. "1M".
29
30        - guestfish 'man' command opens the manual page.
31
32        - guestfish supports a "heredoc" syntax for uploading files:
33            upload -<<_end_ /foo
34            content
35            _end_
36
37        - Some guestfish commands now print their output in octal or hex
38          where appropriate (RHBZ#583242).
39
40        - Allow dash prefix on guestfish command line.  This ignores any
41          error from the second command:                   (RHBZ#578407)
42            guestfish -- cmd1 : -cmd2 : cmd3
43
44        - guestfish -h / help command now returns an error for non-existent
45          commands (RHBZ#597145).
46
47        - New 'supported' command in guestfish to list optional groups of
48          commands which are supported by the daemon / configuration.
49
50        - virt-inspector and guestfish -i now work for filenames which
51          contain spaces (RHBZ#507810).
52
53        - Change the protocol to use link-local addresses, to avoid
54          conflicting with any address that the host might be using
55          (RHBZ#588763).
56
57        - libguestfs now sets the correct time and timezone on filesystem
58          modifications.
59
60        - Sort the domains into alphabetical order in virt-df.
61
62        - Make mkfs-b command work for FAT and NTFS by mapping the blocksize
63          parameter to the cluster size (RHBZ#599464).
64
65        - Add version numbers to Perl modules (RHBZ#521674).
66
67        - Localization now works for all the libguestfs tools (RHBZ#559963).
68
69        - Tools now support filesystem-on-image VMs (RHBZ#590167).
70
71        - virt-list-partitions has a '-t' option to show the total size of disks.
72
73        - Include extra Augeas lenses in the supermin appliance (Matthew Booth).
74
75        - Add error and close callbacks.
76
77        - Add explicit close method in the Perl API.
78
79        - Multiple fixes for RHEL 5 compatibility.
80
81        - Multiple fixes for Debian/Ubuntu compatibility.
82
83        - Multiple revisions to improve the documentation.
84
85   Security
86        - Fix a potential DoS in virt-inspector and virt-v2v if a specially
87          crafted disk image contained a char device in place of one of the
88          configuration files that we read under /etc (RHBZ#582484).
89
90   New APIs
91        - aug-clear - clear Augeas path
92        - available-all-groups - return a list of all optional groups
93        - base64-in - upload base64-encoded data to file
94        - base64-out - download file and encode as base64
95        - checksum-device - compute checksums on the contents of a device
96        - checksums-out - compute checksums of multiple files in a directory
97        - debug-upload - upload a file to the appliance
98        - fallocate64 - preallocate a file in the guest filesystem
99        - fill-pattern - fill a file with a repeating pattern of bytes
100        - get-umask - get the current umask
101        - lvresize-free - expand an LV to fill free space
102        - ntfsresize - resize an NTFS filesystem
103        - ntfsresize-size - resize an NTFS filesystem (with size)
104        - part-del - delete a partition
105        - part-get-bootable - get the bootable flag of a partition
106        - part-get-mbr-id - get the MBR type byte of a partition
107        - part-set-mbr-id - set the MBR type byte of a partition
108        - pvresize-size - resize a physical volume (with size)
109        - pwrite - write to part of a file
110        - resize2fs-size - resize an ext2/3/4 filesystem (with size)
111        - txz-in - unpack compressed tarball to directory (RHBZ#580556)
112        - txz-out - pack directory into compressed tarball (RHBZ#580556)
113        - vfs-label - get the filesystem label
114        - vfs-uuid - get the filesystem UUID
115        - vgscan - rescan for LVM physical volumes, volume groups and logical volumes
116        - write - create a new file
117        - zero-device - write zeroes to an entire device
118
119   Internals
120        - Extend the generator to support testing optional features.
121        - Stricter checks on input parameters to many calls (RHBZ#501893 RHBZ#501894)
122        - Extend the protocol to support sending arbitrary 8 bit data buffers.
123        - Ship 'BUGS' file with releases.  This is a summary of the bugs in
124          the Red Hat Bugzilla database.
125        - Ship 'RELEASE-NOTES' file with releases, containing release notes.
126        - Unify supermin appliance building into one place, in febootstrap 2.7.
127        - Fix the protocol code to handle the case where both ends send cancel
128          messages at the same time.
129
130   Bugs fixed
131        - 612178 guestfish: using -m option in conjunction with --listen option causes appliance to die
132        - 610880 libguestfs should set broader read perms on tmpdir, so works in some situations when executed with umask 077
133        - 604691 OCaml bindings are not thread safe
134        - 603870 Updates to Spanish translation
135        - 602592 [RFE] expose guestfs_close in perl bindings
136        - 600977 virt-df -h --csv "Argument .. isn't numeric in printf"
137        - 599464 mkfs-b does not support vfat/ntfs
138        - 598807 add_cdrom does not work in RHEL 6
139        - 598309 part-list and several other cmd failed on libguestfs on RHEL5
140        - 597145 guestfish 'help' command should indicate error in exit status with an unknown command
141        - 597135 guestfish write-file cmd does not check "size" parameter
142        - 597118 A warning should be given in the help of mke2journal-L for the length of label
143        - 597112 get-e2uuid should use blkid instead of "tune2fs -l" to get filesystem UUID
144        - 596776 virt-inspector doesn't discover modprobe aliases on RHEL 3 guests
145        - 596763 Updates to Spanish translation
146        - 593292 Updates to Spanish translation
147        - 592883 can not edit files on  images mounted with guestmount cmd
148        - 592360 Updates to Spanish translation
149        - 591250 virt-tar prints "tar_in: tar subcommand failed on directory" if the archive is compressed or not in the right format
150        - 591155 virt-tar prints "tar_in: tar subcommand failed on directory" if a disk image is not writable
151        - 591142 virt-inspector should give an error for unrecognized disk images
152        - 590167 virt-inspector and other virt tools should be able to handle filesystem-on-image VMs
153        - 589039 guestfish read-file cmd will cause daemon hang when read large files
154        - 588851 guestfs_launch() returns -1, but guestfs_last_error() == NULL
155        - 588763 libguestfs should use non-public or link-local addresses for appliance network
156        - 588733 Updates to Spanish translation
157        - 588651 guestfish 'strings-e' cmd does not give proper error message or hint
158        - 587484 lvresize can't reduce size of a volumn
159        - 585961 Updates to Spanish translation
160        - 585223 ntfsresize should support shrinking filesystems
161        - 585222 pvresize should support shrinking PVs
162        - 585221 resize2fs should support shrinking filesystems
163        - 584038 Updates to Spanish translation
164        - 583554 [FEAT] mknod-mode command is needed to set mode explicitly
165        - 583242 [RFE] guestfish should print outputs in a suitable base (eg. octal for modes)
166        - 582993 guestfish eats words when tab completing case (in)sensitive paths
167        - 582953 Misleading help information about lvcreate command
168        - 582948 mknod command doesn't make block, character or FIFO devices
169        - 582929 mknod doesn't check for invalid mode
170        - 582901 guestfish chmod/umask commands do not check invalid mode value
171        - 582899 guestfish:sparse is missed from command autocomplete list
172        - 582891 [Feature Request] behavior and return value of guestfish umask cmd should be changed
173        - 582548 [mknod] umask shouldn't take effect when mode is set explicitly
174        - 582484 some guestfish sub commands can not handle special files properly
175        - 582252 Updates to Spanish translation
176        - 581501 Updates to Spanish translation
177        - 580650 virt-inspector warns "No grub default specified at /usr/lib/perl5/Sys/Guestfs/Lib.pm at [...]"
178        - 580556 request for libguestfs to support .txz tarballs
179        - 580246 tar-in command hangs if uploading more than available space
180        - 580016 aug-ls in guestfish does not take augeas variable as argument
181        - 579664 guestfish doesn't report error when there is not enough space for image allocation
182        - 579608 multiple commands in guestfish can not work for symbol links
183        - 579155 libguestfs hangs if qemu doesn't start (in null vmchannel mode)
184        - 578407 the prefix '-' in sub-command isn't handled by guestfish in remote control mode
185        - 576879 libguestfs protocol loses synchronization if you 'upload' before mounting disks
186        - 559963 libguestfs Perl programs do set locale, but still localization doesn't work
187        - 521674 Perl modules are unversioned, but should carry version numbers
188        - 516096 Race condition in test_swapon_label_0: /sbin/blockdev: BLKRRPART: Device or resource busy
189        - 507810 guestfish -i / virt-inspector cannot handle spaces in filenames
190        - 502533 Updated Polish translation of libguestfs
191        - 501894 Some String parameters should be OptString
192        - 501893 String parameters should be checked for != NULL
193        - 501889 write-file does not support strings containing ASCII NUL
194        - 484986 grub-install fails on virtio disk
195

SEE ALSO

197       guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
198       guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
199       http://libguestfs.org/
200

AUTHOR

202       Richard W.M. Jones
203
205       Copyright (C) 2009-2020 Red Hat Inc.
206

LICENSE

208       This program is free software; you can redistribute it and/or modify it
209       under the terms of the GNU General Public License as published by the
210       Free Software Foundation; either version 2 of the License, or (at your
211       option) any later version.
212
213       This program is distributed in the hope that it will be useful, but
214       WITHOUT ANY WARRANTY; without even the implied warranty of
215       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
216       General Public License for more details.
217
218       You should have received a copy of the GNU General Public License along
219       with this program; if not, write to the Free Software Foundation, Inc.,
220       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
221

BUGS

223       To get a list of bugs against libguestfs, use this link:
224       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
225
226       To report a new bug against libguestfs, use this link:
227       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
228
229       When reporting a bug, please supply:
230
231       •   The version of libguestfs.
232
233       •   Where you got libguestfs (eg. which Linux distro, compiled from
234           source, etc)
235
236       •   Describe the bug accurately and give a way to reproduce it.
237
238       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
239           into the bug report.
240
241
242
243libguestfs-1.46.0                 2021-09-23      guestfs-release-notes-1.4(1)
Impressum