diff --git a/guestfs-release-notes.pod b/guestfs-release-notes.pod index 87b057eb0..71ab0ac2d 100644 --- a/guestfs-release-notes.pod +++ b/guestfs-release-notes.pod @@ -7,7 +7,7 @@ guestfs-release-notes - libguestfs Release Notes =begin comment NOTE! Pre-release notes for the next stable version of libguestfs. -Updated to commit dfa25a46e35b87ae8a5e548d383e8bf75b4b4b26 +Updated to commit f7c312ba6bc99a331f2b3996624dc3408a8cc3c0 =end comment @@ -30,8 +30,48 @@ the git repository, or the ChangeLog file distributed in the tarball. =head3 API -Remote access to disks: Network Block Device (nbd), Gluster, Ceph -(rbd) and Sheepdog protocols are now supported. +Remote access to disks: + +=over 4 + +=item * + +Network Block Device (nbd) + +=item * + +Secure Shell (ssh) + +=item * + +HTTP and HTTPS + +=item * + +FTP and FTPS + +=item * + +iSCSI + +=item * + +Gluster + +=item * + +Ceph/rbd +(Mike Kelly) + +=item * + +Sheepdog + +=item * + +TFTP + +=back The SYSLINUX and EXTLINUX bootloaders can now be installed in disk images using the API. @@ -42,6 +82,8 @@ are separately mountable (Matthew Booth). "Attach methods" are now known as "backends". Compatibility with existing code is preserved. +Filenames can contain ':', as long as newer QEMU is being used. + =head3 Tools Virt-alignment-scan and virt-df scan multiple guests in parallel. @@ -49,6 +91,16 @@ Virt-alignment-scan and virt-df scan multiple guests in parallel. Guestmount now passes errno accurately back to userspace in almost all cases. +Guestfish and other tools can now use a URI-like syntax to access +remote disks, eg: + + guestfish -a ssh://example.com/path/to/disk.img + +Guestfish and guestmount now allow you to specify the filesystem type +when mounting, which is more secure (Dave Vasilevsky). + +Guestfish is now the "guest filesystem shell". + Guestfish allows only C<1> C C C C C C<0> C C C C C for boolean values (case insensitive), and gives an error for all other strings. @@ -81,6 +133,11 @@ The long-deprecated Perl C library has been removed. L +=head3 Examples + +New example program showing how to enable debugging and capture +log messages. + =head3 Other Distributors can add arbitrary extra packages to the appliance by @@ -88,18 +145,27 @@ doing: ./configure --with-extra-packages="list of package names" +Distributors can use: + + ./configure --with-supermin-extra-options="..." + +to add arbitrary extra options to supermin. + =head2 Security No security issues were found in this release. =head2 New APIs + cp-r extlinux feature-available + get-program is-whole-device part-get-gpt-type part-set-gpt-type rename + set-program syslinux C only: @@ -118,20 +184,31 @@ The febootstrap tool has now been renamed to "supermin". Libguestfs can use either, but now prefers "supermin". L +libxml2 is required to build libguestfs. + +The hivexregedit program (from hivex) is required to build from git. + Internal functions can no longer be used unless the caller defines C<-DGUESTFS_PRIVATE=1>. Enable C compiler warnings in Python, Ruby bindings. -Fail early and clearly if libvirt does not support qemu/KVM (eg. if +Fail early and clearly if libvirt does not support qemu/KVM (eg. if default libvirt connection is to Xen). C rule, useful for selectively running tests. +Multiple fixes to allow separated (sourcedir != builddir) builds. + Multiple fixes to Haskell bindings. C and C APIs now capture C correctly. +Language binding tests use (mostly) a standard numbering scheme and +aim to test the same range of features in each language. Also the +number of launches required has been reduced so these tests should run +much more quickly. + Library code internally uses GCC C<__attribute__((cleanup))> (if available) to simplify memory allocation. @@ -165,6 +242,9 @@ Valgrind log files are now written to C-I.log> C cleans the local C directory. +The C API tests have been rewritten using a more flexible generator +language that allows arbitrary C code to be executing during tests. + =head2 Bugs fixed =begin comment @@ -175,6 +255,22 @@ C cleans the local C directory. =over 4 +=item L + +Segfault in inspect-fs.c in mountable code + +=item L + +tar-out and base64-out quoting error + +=item L + +libguestfs: error: btrfsvol:/dev/sda2/root: root device not found: only call this function with a root device previously returned by guestfs_inspect_os + +=item L + +inspection fails if libosinfo is not installed + =item L file on zero-sized file now produces "empty " instead of "empty" @@ -227,6 +323,10 @@ virt-tar fails on non-existent directory names "error in chunked encoding at /ho virt-cat fails on directory names "/dev/stdout: error in chunked encoding" +=item L + +btrfs causes subsequent ntfs-3g filesystem to fail + =item L "No such file or directory" when execute "hivex-commit" @@ -267,6 +367,14 @@ libguestfs with libvirt attach-method fails with odd error if default hypervisor Addng a zero-length virtio-scsi disk causes: qemu-kvm: hw/scsi-bus.c:1568: scsi_req_complete: Assertion `req->status == -1' failed. +=item L + +libguestfs cannot open disk images which are symlinks to files that contain ':' (colon) character + +=item L + +RFE: Allow to set log callback in Ruby bindings + =back =for comment ################################################################ diff --git a/guestfs-release-notes.txt b/guestfs-release-notes.txt index 2517c2c4e..c4453d0d5 100644 --- a/guestfs-release-notes.txt +++ b/guestfs-release-notes.txt @@ -12,8 +12,25 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 API - Remote access to disks: Network Block Device (nbd), Gluster, Ceph (rbd) - and Sheepdog protocols are now supported. + Remote access to disks: + + * Network Block Device (nbd) + + * Secure Shell (ssh) + + * HTTP and HTTPS + + * FTP and FTPS + + * iSCSI + + * Gluster + + * Ceph/rbd (Mike Kelly) + + * Sheepdog + + * TFTP The SYSLINUX and EXTLINUX bootloaders can now be installed in disk images using the API. @@ -24,6 +41,8 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 "Attach methods" are now known as "backends". Compatibility with existing code is preserved. + Filenames can contain ':', as long as newer QEMU is being used. + Tools Virt-alignment-scan and virt-df scan multiple guests in parallel. @@ -31,6 +50,16 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 Guestmount now passes errno accurately back to userspace in almost all cases. + Guestfish and other tools can now use a URI-like syntax to access + remote disks, eg: + + guestfish -a ssh://example.com/path/to/disk.img + + Guestfish and guestmount now allow you to specify the filesystem type + when mounting, which is more secure (Dave Vasilevsky). + + Guestfish is now the "guest filesystem shell". + Guestfish allows only 1 true t yes y on 0 false f no n off for boolean values (case insensitive), and gives an error for all other strings. @@ -61,6 +90,11 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 The long-deprecated Perl Sys::Guestfs::Lib library has been removed. https://www.redhat.com/archives/libguestfs/2013-April/msg00001.html + Examples + + New example program showing how to enable debugging and capture log + messages. + Other Distributors can add arbitrary extra packages to the appliance by @@ -68,18 +102,27 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 ./configure --with-extra-packages="list of package names" + Distributors can use: + + ./configure --with-supermin-extra-options="..." + + to add arbitrary extra options to supermin. + Security No security issues were found in this release. New APIs + cp-r extlinux feature-available + get-program is-whole-device part-get-gpt-type part-set-gpt-type rename + set-program syslinux C only: @@ -98,6 +141,10 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 use either, but now prefers "supermin". http://people.redhat.com/~rjones/supermin/ + libxml2 is required to build libguestfs. + + The hivexregedit program (from hivex) is required to build from git. + Internal functions can no longer be used unless the caller defines -DGUESTFS_PRIVATE=1. @@ -108,10 +155,17 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 make print-subdirs rule, useful for selectively running tests. + Multiple fixes to allow separated (sourcedir != builddir) builds. + Multiple fixes to Haskell bindings. ln and ln-f APIs now capture errno correctly. + Language binding tests use (mostly) a standard numbering scheme and aim + to test the same range of features in each language. Also the number of + launches required has been reduced so these tests should run much more + quickly. + Library code internally uses GCC __attribute__((cleanup)) (if available) to simplify memory allocation. @@ -144,8 +198,29 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 make clean cleans the local tmp/ directory. + The C API tests have been rewritten using a more flexible generator + language that allows arbitrary C code to be executing during tests. + Bugs fixed + https://bugzilla.redhat.com/961812 + + Segfault in inspect-fs.c in mountable code + + https://bugzilla.redhat.com/957772 + + tar-out and base64-out quoting error + + https://bugzilla.redhat.com/957380 + + libguestfs: error: btrfsvol:/dev/sda2/root: root device not found: + only call this function with a root device previously returned by + guestfs_inspect_os + + https://bugzilla.redhat.com/948324 + + inspection fails if libosinfo is not installed + https://bugzilla.redhat.com/928995 file on zero-sized file now produces "empty " instead of "empty" @@ -204,6 +279,10 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 virt-cat fails on directory names "/dev/stdout: error in chunked encoding" + https://bugzilla.redhat.com/907554 + + btrfs causes subsequent ntfs-3g filesystem to fail + https://bugzilla.redhat.com/905341 "No such file or directory" when execute "hivex-commit" @@ -249,6 +328,15 @@ RELEASE NOTES FOR LIBGUESTFS 1.22 hw/scsi-bus.c:1568: scsi_req_complete: Assertion `req->status == -1' failed. + https://bugzilla.redhat.com/811649 + + libguestfs cannot open disk images which are symlinks to files that + contain ':' (colon) character + + https://bugzilla.redhat.com/664558 + + RFE: Allow to set log callback in Ruby bindings + RELEASE NOTES FOR LIBGUESTFS 1.20 These release notes only cover the differences from the previous