From 3fac199a8b4f4580d348807769d964b94179cd7f Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Tue, 2 Nov 2010 16:18:30 +0000 Subject: [PATCH 1/1] Final RELEASE-NOTES file for version 1.6.0. --- RELEASE-NOTES | 115 ++++++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 80 insertions(+), 35 deletions(-) diff --git a/RELEASE-NOTES b/RELEASE-NOTES index 6302e75..086a2dc 100644 --- a/RELEASE-NOTES +++ b/RELEASE-NOTES @@ -1,6 +1,5 @@ Release notes for libguestfs 1.6.0 ---------------------------------- -[updated to commit d75a2bff1264828f02b68a9c8bc7eb2521bd6684] These release notes only cover the differences from the previous stable/dev branch split (1.4.0). For detailed changelogs, please see @@ -9,13 +8,18 @@ the git repository, or the ChangeLog file distributed in the tarball. New features - Use a new method for creating and caching the appliance. This - greatly improves the performance of libguestfs. + greatly improves the performance of libguestfs, often by a factor + of x 4 to x 5. - Support for guest inspection (like virt-inspector) via the ordinary API and all language bindings. 'guestfish -i' option is as a side- effect much quicker. - - Support for LUKS-encrypted guests. + - virt-inspector and core inspection API can now detect guests running: + Fedora, Debian, Ubuntu, Windows, Red Hat Enterprise Linux, CentOS, + Scientific Linux, Gentoo, Pardus, Arch Linux, MeeGo. + + - Support for LUKS whole-disk encryption in guests. - PHP bindings. @@ -31,7 +35,8 @@ New features - guestfish 'hexedit' command for doing binary edits to devices and files. - - Change guestfish -i syntax slightly to allow commands to be specified. + - Change guestfish -i syntax to allow commands to be specified on the + command line (retaining backwards compatibility). - guestfish '-d ' for adding disks from libvirt domains. @@ -46,6 +51,8 @@ New features - guestfish '--echo-keys' option allows you to echo keys/passphrases while typing them. + - guestmount now supports -a / -d / -i options, like guestfish. + - Use virtio-serial for communications with the appliance. This also has a major performance benefit. @@ -57,43 +64,54 @@ New features - virt-rescue now shuts down cleanly (thanks Matthew Booth). + - virt-rescue now has a --network option to enable network access. + + - virt-resize can now handle guests which use GPT partition table format. + + - virt-resize has better support for shrinking guests. + + - virt-resize supports qcow2-format guests. + + - $TMPDIR can be used to override almost all temporary directory usage. + + - OCaml users can use an alternate OO-style of coding, eg. g#launch () + + - The API supports calls which take optional parameters, eg. + $g->add_drive_opts ("disk", readonly => 1); + + - Trace output now escapes and shortens large strings (thanks + Matthew Booth). + + - Autosync is now on by default, resulting in more reliable behaviour + when the handle is closed. + + - virt-df --uuid option allows you to follow a domain across migration + and renaming. + - Translations of manual pages. Security + - CVE-2010-3851 libguestfs: missing disk format specifier when adding a disk + https://www.redhat.com/archives/libguestfs/2010-October/msg00036.html + This is comprehensively fixed in this release, and the fix will be + backported to the other stable branches after more testing. + + - virt-inspector no longer relies on untrusted guest code to list + applications in some guests. + New APIs - - download-offset - - file-architecture - - findfs-label - - findfs-uuid - - inspect-os - - inspect-get-arch - - inspect-get-distro - - inspect-get-filesystems - - inspect-get-major-version - - inspect-get-minor-version - - inspect-get-mountpoints - - inspect-get-product-name - - inspect-get-type - - is-blockdev - - is-chardev - - is-fifo - - is-lv - - is-socket - - is-symlink - - list-filesystems - - luks-add-key - - luks-close - - luks-format - - luks-format-cipher - - luks-kill-slot - - luks-open - - luks-open-ro - - lvm-clear-filter - - lvm-set-filter - - part-to-dev - - upload-offset + download-offset, file-architecture, findfs-label, findfs-uuid, + inspect-os, inspect-get-arch, inspect-get-distro, + inspect-get-filesystems, inspect-get-major-version, + inspect-get-minor-version, inspect-get-mountpoints, + inspect-get-product-name, inspect-get-type, is-blockdev, is-chardev, + is-fifo, is-lv, is-socket, is-symlink, list-filesystems, luks-add-key, + luks-close, luks-format, luks-format-cipher, luks-kill-slot, + luks-open, luks-open-ro, lvm-clear-filter, lvm-canonical-lv-name, + lvm-set-filter, part-to-dev, pread-device, pwrite-device, + upload-offset Internals @@ -101,14 +119,40 @@ Internals - Refactor the library code into separate files. - Refactor the generator code into separate files. - Generate guestfish commands. + - guestfish & guestmount options processing is unified. - Protocol changes: error message size increased to 64K send errno to library - Add 'make bindist' to make a binary distribution. + - Cleaner behaviour under valgrind. + - More testing of the guestfish command line options and libvirt + integration. + - The Perl inspection code is no longer used by any of the tools. Bugs fixed + - 646822 libguestfs trace mode should not print long binary strings + - 646821 virt-df should have --uuid option + - 646432 /dev/mapper paths should not be returned from guestfs_mountpoints + - 643624 libguestfs tools documentation should describe how to quote guest domain names from shell + - 642934 No way to specify disk format when adding a disk to libguestfs + - 642933 guestfs_list_filesystems should be used in all possible places + - 642932 guestmount options should match guestfish options + - 642930 virt-inspector (Sys::Guestfs::Lib) should use C inspection APIs + - 642929 C inspection code should ignore /dev/fd* in /etc/fstab + - 642826 virt-resize converts any other image format to raw without notifying user, instructions do not account for this + - 640961 Document that grub-install might be needed for old Linux guests after virt-resize + - 639986 virt-df --csv does not properly quote " in libvirt domain names + - 639405 Interrupted cached appliance creation leaves libguestfs unusable + - 638901 Appliance filename should not contain repository name + - 638899 /dev/mapper paths should not be returned from C inspection APIs + - 636918 Updates to Spanish translation + - 636061 [abrt] guestfish-1.2.11-1.fc12: malloc_consolidate: Process /usr/bin/guestfish was killed by signal 11 (SIGSEGV) + - 635969 glob echo mkfs ext2 /dev/vd[b-t]1 prints garbage + - 634246 guestfs_part_get_parttype returns "loop" when run against a partition, LV or filesystem + - 633766 virt-resize --shrink fails - 633357 Updates to Spanish translation + - 633096 virt-resize calculates block device size incorrectly, doesn't work with qcow2 target - 629593 Dutch translation added - 627556 Updates to Spanish translations of libguestfs - 626843 Updates to Spanish translations @@ -116,6 +160,7 @@ Bugs fixed - 618556 virt-rescue return none zero value when exit - 617200 mount operation failed and hung on some images which running in read-only mode - 610880 libguestfs should set broader read perms on tmpdir, so works in some situations when executed with umask 077 + - 599503 document that mkmountpoint and umount-all cannot be mixed - 571714 Running virt-df on disk image relabels it, so qemu can no longer write to it. - 502533 Updated Polish translation of libguestfs -- 1.8.3.1