todo: guestfish drive letters.
[libguestfs.git] / RELEASE-NOTES
index 9275c54..91b10a9 100644 (file)
@@ -1,8 +1,140 @@
+Release notes for libguestfs 1.10.0
+-----------------------------------
+
+[Not complete. Last update commit 872e67ffdf6c7b19782514445d13e8f405e435c1]
+
+These release notes only cover the differences from the previous
+stable/dev branch split (1.8.0).  For detailed changelogs, please see
+the git repository, or the ChangeLog file distributed in the tarball.
+
+New features
+
+ - libguestfs and tools can be used against live virtual machines.
+   See the 'guestfish --live' and 'guestmount --live' options, and (for
+   the low-level interface) the new APIs set-attach-method and
+   get-attach-method.
+
+ - New virt tools:
+   virt-copy-in, virt-copy-out, virt-tar-in, virt-tar-out.
+
+ - libguestfs can get the drive letter mappings for Windows guests.
+
+ - virt-inspector displays drive letter mappings for Windows guests.
+
+ - Drive letters can now be used in virt-edit and guestfish programs
+   when operating on Windows guests.
+
+ - You can now inspect the install disks and live CDs of many different
+   operating systems.
+
+ - guestfish <! cmd which executes a shell cmd and inlines the result.
+
+ - guestfish, guestmount, virt-rescue now all support --ro and --rw
+   options, and the default for this can be chosen via a configuration
+   file (/etc/libguestfs-tools.conf).
+
+ - New event API allows more than one callback to be registered for
+   each event, makes it possible to call the API from other languages,
+   and allows nearly all log, debug and trace messages to be rerouted
+   from stderr.
+
+ - A series of protocol fixes has fixed the old bug RHBZ#576879
+   which used to cause errors during the upload command to lose
+   protocol synchronization.
+
+ - Greater FHS compliance for temporary files, including using /var/tmp
+   for large cached files that should survive reboot (instead of /tmp).
+
+ - guestfish, guestmount -m option allows mount options to be passed
+   through to the underlying filesystem.
+
+ - mkfs-opts allows filesystem features to be specified.
+
+ - More intelligent handling of mountpoints, allowing mkmountpoint, mount
+   and umount-all commands to work together properly.
+
+ - Trace messages are prefixed with a distinct string, allowing them to
+   be easily 'grepped' out from debug output.
+
+ - guestfs_launch (guestfish 'run' command) now produces progress
+   messages (a guestfish progress bar) if it takes longer than 5
+   seconds to run.
+
+ - Several long-running commands where we are unable to estimate time
+   to completion generate "pulse mode" progress events.  Progress bar
+   in guestfish has been updated to display these.
+
+ - Publish example code in: C, Perl, Python, OCaml, Ruby.
+
+ - New virt-dhcp-address example program.
+
+ - The Java and Ruby bindings have been improved greatly.
+
+ - Perl includes a way to get the errno of the last error.
+
+ - Python bindings now compatible with rpyc (thanks Erez Shinan).
+
+ - Transifex is now being used to manage translations.
+   http://www.transifex.net/projects/p/libguestfs/
+
+ - Inspection now supports Red Hat Desktop, Slackware distributions.
+
+ - Inspection no longer fails for Windows guests that have two or
+   more disks.
+
+ - Inspection can now tell the difference between Windows 2008 Server
+   and Windows 7.
+
+ - Inspection can detect 32 bit applications installed in 64 bit
+   Windows, running on the WOW64 emulator.
+
+ - New logo!
+
+Security
+
+  [none]
+
+New APIs
+
+  first-private,
+  get-attach-method,
+  inspect-get-drive-mappings,
+  inspect-get-product-variant,
+  inspect-get-windows-current-control-set,
+  next-private,
+  resize2fs-M,
+  set-attach-method,
+
+Internals
+
+ - The 'HACKING' file is obsolete.  The contents have been moved into
+   a section of the guestfs(3) manual page.
+
+Bugs fixed
+
+ - 502533 Updated Polish translation of libguestfs
+ - 576879 libguestfs protocol loses synchronization if you 'upload' before mounting disks
+ - 599503 document that mkmountpoint and umount-all cannot be mixed
+ - 617440 guestfish: fails to tilde expand '~' when the $HOME env is unset
+ - 664558 RFE: Allow to set log callback in Ruby bindings
+ - 665358 Punjabi Translation Completed (pa_IN)
+ - 666577 libguestfs: unknown filesystem /dev/fd0
+ - 667610 Multiple bugs, memory leaks in libguestfs ruby bindings
+ - 668112 virt-filesystems command fails on guest with corrupt filesystem label
+ - 668574 guestfish -i is trying to mount all mounts from /etc/fstab and fails with an error when device doesn't exists
+ - 673479 Add a grep-friendly string to LIBGUESTFS_TRACE output
+ - 674130 Inspection code fails for Windows guest with two disks
+ - 682756 libguestfs trace segfaults when list-filesystems returns error
+ - 682979 libguestfs incorrectly detects Red Hat desktop as 'redhat-based' instead of 'redhat'
+ - 690819 mkfs fails creating a filesytem on a disk device when using a disk with 'ide' interface
+ - 691389 Extended attributes don't work over guestmount (FUSE)
+ - 691724 virt-inspector reports unknown filesystem /dev/vda1
+ - 692545 inspect-list-applications fails to detect 32 bit apps installed under WOW64 emulator on 64 bit Windows
+ - 693324 sfdisk's python interface only accepts lists of type 'list' for the lines parameter
+
 Release notes for libguestfs 1.8.0
 ----------------------------------
 
 Release notes for libguestfs 1.8.0
 ----------------------------------
 
-Updated to commit 573e01e0871324c038bac2fd391c86c8b7fb0247 (1.7.23)
-
 These release notes only cover the differences from the previous
 stable/dev branch split (1.6.0).  For detailed changelogs, please see
 the git repository, or the ChangeLog file distributed in the tarball.
 These release notes only cover the differences from the previous
 stable/dev branch split (1.6.0).  For detailed changelogs, please see
 the git repository, or the ChangeLog file distributed in the tarball.
@@ -69,6 +201,10 @@ New features
  - Appliance builder more careful about not leaving temporary files
    around in /tmp.
 
  - Appliance builder more careful about not leaving temporary files
    around in /tmp.
 
+ - getfattr/setfattr commands added to virt-rescue.
+
+ - ROADMAP file covers roadmap and goals for future releases.
+
 Security
 
  - New SECURITY section in guestfs(3) API documentation.
 Security
 
  - New SECURITY section in guestfs(3) API documentation.
@@ -78,15 +214,19 @@ Security
  - Inspection code is more careful about avoiding very large files
    from guests which might previously have caused a denial of service.
 
  - Inspection code is more careful about avoiding very large files
    from guests which might previously have caused a denial of service.
 
+ - FUSE calls into guestmount are now traced when using guestmount -x.
+
 New APIs
 
  - add-domain
  - add-drive-opts
 New APIs
 
  - add-domain
  - add-drive-opts
+ - getxattr
  - inspect-get-hostname
  - inspect-get-package-format
  - inspect-get-package-management
  - inspect-get-roots
  - inspect-list-applications
  - inspect-get-hostname
  - inspect-get-package-format
  - inspect-get-package-management
  - inspect-get-roots
  - inspect-list-applications
+ - lgetxattr
  - mkfs-opts
 
 Internals
  - mkfs-opts
 
 Internals
@@ -121,8 +261,13 @@ Internals
  - New C API test type 'InitScratchFS' makes the tests run a little
    more quickly.
 
  - New C API test type 'InitScratchFS' makes the tests run a little
    more quickly.
 
+ - Excluded packages in the appliance are now listed in a separate
+   file appliance/excludelist.in, and can be customized per-distro.
+
 Bugs fixed
 
 Bugs fixed
 
+ - 663407 readlink and readlinklist returns /sysroot/ in some paths
+ - 661280 virt-rescue: panic when shutting down: "/sbin/reboot: No such file or directory"
  - 657499 checksum: wrong check sum type causes umount to fail
  - 655554 Whole disk paths are not made canonical by virt-inspector
  - 654638 openssl updated to 1.0.0b libguestfs depends on exact file names
  - 657499 checksum: wrong check sum type causes umount to fail
  - 655554 Whole disk paths are not made canonical by virt-inspector
  - 654638 openssl updated to 1.0.0b libguestfs depends on exact file names
@@ -503,3 +648,6 @@ https://www.redhat.com/archives/libguestfs/2009-July/msg00059.html
 
 2009-07-14 : 1.0.59
 https://www.redhat.com/archives/libguestfs/2009-July/msg00023.html
 
 2009-07-14 : 1.0.59
 https://www.redhat.com/archives/libguestfs/2009-July/msg00023.html
+
+2009-04-01 : Initial announcement
+http://rwmj.wordpress.com/2009/04/01/libguestfs-access-and-modify-virtual-machine-disk-images/