RELEASE-NOTES

   1 Release notes for libguestfs 1.4.0
   2 ----------------------------------
   3
   4 These release notes only cover the differences from the previous
   5 stable/dev branch split (1.2.0).  For detailed changelogs, please see
   6 the git repository, or the ChangeLog file distributed in the tarball.
   7
   8 New features
   9
  10  - guestfish lets you choose a prepared disk image, eg:
  11      guestfish -N fs:ext4
  12
  13  - Add write support to guestmount (FUSE) module.
  14
  15  - virt-resize can now resize the content of partitions and logical
  16    volumes in the guest, and we have better support for shrinking guests.
  17
  18  - Bash tab-completion script for guestfish.
  19
  20  - Add ZFS support to virt-rescue.
  21
  22  - New tool 'virt-make-fs' for creating filesystems with content.
  23
  24  - Allow suffixes on any guestfish number parameter, eg. "1M".
  25
  26  - guestfish 'man' command opens the manual page.
  27
  28  - guestfish supports a "heredoc" syntax for uploading files:
  29      upload -<<_end_ /foo
  30      content
  31      _end_
  32
  33  - Some guestfish commands now print their output in octal or hex
  34    where appropriate (RHBZ#583242).
  35
  36  - Allow dash prefix on guestfish command line.  This ignores any
  37    error from the second command:                   (RHBZ#578407)
  38      guestfish -- cmd1 : -cmd2 : cmd3
  39
  40  - guestfish -h / help command now returns an error for non-existent
  41    commands (RHBZ#597145).
  42
  43  - New 'supported' command in guestfish to list optional groups of
  44    commands which are supported by the daemon / configuration.
  45
  46  - virt-inspector and guestfish -i now work for filenames which
  47    contain spaces (RHBZ#507810).
  48
  49  - Change the protocol to use link-local addresses, to avoid
  50    conflicting with any address that the host might be using
  51    (RHBZ#588763).
  52
  53  - libguestfs now sets the correct time and timezone on filesystem
  54    modifications.
  55
  56  - Sort the domains into alphabetical order in virt-df.
  57
  58  - Make mkfs-b command work for FAT and NTFS by mapping the blocksize
  59    parameter to the cluster size (RHBZ#599464).
  60
  61  - Add version numbers to Perl modules (RHBZ#521674).
  62
  63  - Localization now works for all the libguestfs tools (RHBZ#559963).
  64
  65  - Tools now support filesystem-on-image VMs (RHBZ#590167).
  66
  67  - virt-list-partitions has a '-t' option to show the total size of disks.
  68
  69  - Include extra Augeas lenses in the supermin appliance (Matthew Booth).
  70
  71  - Add error and close callbacks.
  72
  73  - Add explicit close method in the Perl API.
  74
  75  - Multiple fixes for RHEL 5 compatibility.
  76
  77  - Multiple fixes for Debian/Ubuntu compatibility.
  78
  79  - Multiple revisions to improve the documentation.
  80
  81 Security
  82
  83  - Fix a potential DoS in virt-inspector and virt-v2v if a specially
  84    crafted disk image contained a char device in place of one of the
  85    configuration files that we read under /etc (RHBZ#582484).
  86
  87 New APIs
  88
  89  - aug-clear - clear Augeas path
  90  - available-all-groups - return a list of all optional groups
  91  - base64-in - upload base64-encoded data to file
  92  - base64-out - download file and encode as base64
  93  - checksum-device - compute checksums on the contents of a device
  94  - checksums-out - compute checksums of multiple files in a directory
  95  - debug-upload - upload a file to the appliance
  96  - fallocate64 - preallocate a file in the guest filesystem
  97  - fill-pattern - fill a file with a repeating pattern of bytes
  98  - get-umask - get the current umask
  99  - lvresize-free - expand an LV to fill free space
 100  - ntfsresize - resize an NTFS filesystem
 101  - ntfsresize-size - resize an NTFS filesystem (with size)
 102  - part-del - delete a partition
 103  - part-get-bootable - get the bootable flag of a partition
 104  - part-get-mbr-id - get the MBR type byte of a partition
 105  - part-set-mbr-id - set the MBR type byte of a partition
 106  - pvresize-size - resize a physical volume (with size)
 107  - pwrite - write to part of a file
 108  - resize2fs-size - resize an ext2/3/4 filesystem (with size)
 109  - txz-in - unpack compressed tarball to directory (RHBZ#580556)
 110  - txz-out - pack directory into compressed tarball (RHBZ#580556)
 111  - vfs-label - get the filesystem label
 112  - vfs-uuid - get the filesystem UUID
 113  - vgscan - rescan for LVM physical volumes, volume groups and logical volumes
 114  - write - create a new file
 115  - zero-device - write zeroes to an entire device
 116
 117 Internals
 118
 119  - Extend the generator to support testing optional features.
 120  - Stricter checks on input parameters to many calls (RHBZ#501893 RHBZ#501894)
 121  - Extend the protocol to support sending arbitrary 8 bit data buffers.
 122  - Ship 'BUGS' file with releases.  This is a summary of the bugs in
 123    the Red Hat Bugzilla database.
 124  - Ship 'RELEASE-NOTES' file with releases, containing release notes.
 125  - Unify supermin appliance building into one place, in febootstrap 2.7.
 126  - Fix the protocol code to handle the case where both ends send cancel
 127    messages at the same time.
 128
 129 Bugs fixed
 130
 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
 196 Release notes for previous versions of libguestfs
 197 -------------------------------------------------
 198
 199 2009-11-10 : 1.0.78
 200 https://www.redhat.com/archives/libguestfs/2009-November/msg00095.html
 201
 202 2009-09-13 : 1.0.67
 203 https://www.redhat.com/archives/libguestfs/2009-August/msg00281.html
 204
 205 2009-07-23 : 1.0.64
 206 https://www.redhat.com/archives/libguestfs/2009-July/msg00059.html
 207
 208 2009-07-14 : 1.0.59
 209 https://www.redhat.com/archives/libguestfs/2009-July/msg00023.html