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

NAME

6       guestfs-release-notes - libguestfs Release Notes
7

RELEASE NOTES FOR LIBGUESTFS 1.6

9       These release notes only cover the differences from the previous
10       stable/dev branch split (1.4.0).  For detailed changelogs, please see
11       the git repository, or the ChangeLog file distributed in the tarball.
12
13   New features
14        - Use a new method for creating and caching the appliance.  This
15          greatly improves the performance of libguestfs, often by a factor
16          of x 4 to x 5.
17
18        - Support for guest inspection (like virt-inspector) via the ordinary
19          API and all language bindings.  'guestfish -i' option is as a side-
20          effect much quicker.
21
22        - virt-inspector and core inspection API can now detect guests running:
23          Fedora, Debian, Ubuntu, Windows, Red Hat Enterprise Linux, CentOS,
24          Scientific Linux, Gentoo, Pardus, Arch Linux, MeeGo.
25
26        - Support for LUKS whole-disk encryption in guests.
27
28        - PHP bindings.
29
30        - Progress messages (and progress bars in guestfish and virt-resize)
31          for certain long-running operations.
32
33        - virt-df is now much more efficient.  Use '--one-per-guest' to restore
34          the old per-guest isolation behaviour.
35
36        - guestfish 'copy-in' and 'copy-out' commands for copying files and
37          directories recursively in and out of the guest.
38
39        - guestfish 'hexedit' command for doing binary edits to devices and
40          files.
41
42        - Change guestfish -i syntax to allow commands to be specified on the
43          command line (retaining backwards compatibility).
44
45        - guestfish '-d <domain>' for adding disks from libvirt domains.
46
47        - guestfish '-N' option supports several new prepared disk image types:
48                lvfs : disk with LV formatted with filesystem
49                  lv : disk with LV
50            bootroot : boot+root
51          bootrootlv : boot and root on LV
52
53        - guestfish 'more' and 'edit' commands now work with arbitrary files.
54
55        - guestfish '--echo-keys' option allows you to echo keys/passphrases
56          while typing them.
57
58        - guestmount now supports -a / -d / -i options, like guestfish.
59
60        - Use virtio-serial for communications with the appliance.  This
61          also has a major performance benefit.
62
63        - virt-edit '-b' option to create a backup of edited files.
64
65        - virt-edit '-e' option for non-interactive edits to files.
66
67        - Ability to capture core dumps from the appliance (thanks Matthew Booth).
68
69        - virt-rescue now shuts down cleanly (thanks Matthew Booth).
70
71        - virt-rescue now has a --network option to enable network access.
72
73        - virt-resize can now handle guests which use GPT partition table format.
74
75        - virt-resize has better support for shrinking guests.
76
77        - virt-resize supports qcow2-format guests.
78
79        - $TMPDIR can be used to override almost all temporary directory usage.
80
81        - OCaml users can use an alternate OO-style of coding, eg. g#launch ()
82
83        - The API supports calls which take optional parameters, eg.
84            $g->add_drive_opts ("disk", readonly => 1);
85
86        - Trace output now escapes and shortens large strings (thanks
87          Matthew Booth).
88
89        - Autosync is now on by default, resulting in more reliable behaviour
90          when the handle is closed.
91
92        - virt-df --uuid option allows you to follow a domain across migration
93          and renaming.
94
95        - Translations of manual pages.
96
97   Security
98        - CVE-2010-3851 libguestfs: missing disk format specifier when adding a disk
99          https://www.redhat.com/archives/libguestfs/2010-October/msg00036.html
100          This is comprehensively fixed in this release, and the fix will be
101          backported to the other stable branches after more testing.
102
103        - virt-inspector no longer relies on untrusted guest code to list
104          applications in some guests.
105
106   New APIs
107         download-offset, file-architecture, findfs-label, findfs-uuid,
108         inspect-os, inspect-get-arch, inspect-get-distro,
109         inspect-get-filesystems, inspect-get-major-version,
110         inspect-get-minor-version, inspect-get-mountpoints,
111         inspect-get-product-name, inspect-get-type, is-blockdev, is-chardev,
112         is-fifo, is-lv, is-socket, is-symlink, list-filesystems, luks-add-key,
113         luks-close, luks-format, luks-format-cipher, luks-kill-slot,
114         luks-open, luks-open-ro, lvm-clear-filter, lvm-canonical-lv-name,
115         lvm-set-filter, part-to-dev, pread-device, pwrite-device,
116         upload-offset
117
118   Internals
119        - Use size_t for loop iterators.
120        - Refactor the library code into separate files.
121        - Refactor the generator code into separate files.
122        - Generate guestfish commands.
123        - guestfish & guestmount options processing is unified.
124        - Protocol changes:
125            error message size increased to 64K
126            send errno to library
127        - Add 'make bindist' to make a binary distribution.
128        - Cleaner behaviour under valgrind.
129        - More testing of the guestfish command line options and libvirt
130          integration.
131        - The Perl inspection code is no longer used by any of the tools.
132
133   Bugs fixed
134        - 646822 libguestfs trace mode should not print long binary strings
135        - 646821 virt-df should have --uuid option
136        - 646432 /dev/mapper paths should not be returned from guestfs_mountpoints
137        - 643624 libguestfs tools documentation should describe how to quote guest domain names from shell
138        - 642934 No way to specify disk format when adding a disk to libguestfs
139        - 642933 guestfs_list_filesystems should be used in all possible places
140        - 642932 guestmount options should match guestfish options
141        - 642930 virt-inspector (Sys::Guestfs::Lib) should use C inspection APIs
142        - 642929 C inspection code should ignore /dev/fd* in /etc/fstab
143        - 642826 virt-resize converts any other image format to raw without notifying user, instructions do not account for this
144        - 640961 Document that grub-install might be needed for old Linux guests after virt-resize
145        - 639986 virt-df --csv does not properly quote " in libvirt domain names
146        - 639405 Interrupted cached appliance creation leaves libguestfs unusable
147        - 638901 Appliance filename should not contain repository name
148        - 638899 /dev/mapper paths should not be returned from C inspection APIs
149        - 636918 Updates to Spanish translation
150        - 636061 [abrt] guestfish-1.2.11-1.fc12: malloc_consolidate: Process /usr/bin/guestfish was killed by signal 11 (SIGSEGV)
151        - 635969 glob echo mkfs ext2 /dev/vd[b-t]1 prints garbage
152        - 634246 guestfs_part_get_parttype returns "loop" when run against a partition, LV or filesystem
153        - 633766 virt-resize --shrink fails
154        - 633357 Updates to Spanish translation
155        - 633096 virt-resize calculates block device size incorrectly, doesn't work with qcow2 target
156        - 629593 Dutch translation added
157        - 627556 Updates to Spanish translations of libguestfs
158        - 626843 Updates to Spanish translations
159        - 619793 [RFE] Need a way to determine if a particular block device is a logical volume
160        - 618556 virt-rescue return none zero value when exit
161        - 617200 mount operation failed and hung on some images which running in read-only mode
162        - 610880 libguestfs should set broader read perms on tmpdir, so works in some situations when executed with umask 077
163        - 599503 document that mkmountpoint and umount-all cannot be mixed
164        - 571714 Running virt-df on disk image relabels it, so qemu can no longer write to it.
165        - 502533 Updated Polish translation of libguestfs
166

SEE ALSO

168       guestfs-examples(1), guestfs-faq(1), guestfs-performance(1),
169       guestfs-recipes(1), guestfs-testing(1), guestfs(3), guestfish(1),
170       http://libguestfs.org/
171

AUTHOR

173       Richard W.M. Jones
174
176       Copyright (C) 2009-2020 Red Hat Inc.
177

LICENSE

179       This program is free software; you can redistribute it and/or modify it
180       under the terms of the GNU General Public License as published by the
181       Free Software Foundation; either version 2 of the License, or (at your
182       option) any later version.
183
184       This program is distributed in the hope that it will be useful, but
185       WITHOUT ANY WARRANTY; without even the implied warranty of
186       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
187       General Public License for more details.
188
189       You should have received a copy of the GNU General Public License along
190       with this program; if not, write to the Free Software Foundation, Inc.,
191       51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
192

BUGS

194       To get a list of bugs against libguestfs, use this link:
195       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools
196
197       To report a new bug against libguestfs, use this link:
198       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
199
200       When reporting a bug, please supply:
201
202       •   The version of libguestfs.
203
204       •   Where you got libguestfs (eg. which Linux distro, compiled from
205           source, etc)
206
207       •   Describe the bug accurately and give a way to reproduce it.
208
209       •   Run libguestfs-test-tool(1) and paste the complete, unedited output
210           into the bug report.
211
212
213
214libguestfs-1.49.9                 2023-01-19      guestfs-release-notes-1.6(1)
Impressum