Version 1.2.4

todo docs: Discuss shrinking filesystems and specifying sizes in guestfish.
(cherry picked from commit 7c285ea84f63e511f95a3c8bfbb98cbf99b9466b)

daemon: Split out checksum type to program name mapping into function.

This shouldn't change the semantics of the program.

For stable-1.2 this was cherry picked from commit af29c84 and
rebased against the older code in daemon/checksum.c.

todo docs: Integrate with host intrusion detection systems.
(cherry picked from commit 6e269c6e5123c1558589e0a59844dc0187fbd63a)

todo docs: Mapping filesystems to and from disk blocks.

(cherry picked from commit 2ed549e95c7ad75f28b5f0dd4c53849e1607444e)

fish docs: Be consistent about using I<-..> for options.
(cherry picked from commit 89486c50eaeb8b1cc5a6ff388cb47e859f8565d1)

fish docs: Use L</...> for internal links in the man page.
(cherry picked from commit e3e67f63b0a6ce952ba92cb966b8ac5ef239dcf9)

Whitelist the loop kernel module

loop is sometimes a module, for example on RHEL 5.
(cherry picked from commit 75d9c056b2db9ceedef9eca64e67ad3350eabad8)

Don't die during inspection if rpm -qa or dpkg-query fails

If a problem in the package database prevented package enumeration from working,
inspection would die. This change makes it emit a warning and continue.
(cherry picked from commit 39416cdb11bb2005915ed293eafb3cc6d714416d)

Don't die during inspection if initrd doesn't exist

This fixes a problem where inspection would die if grub.conf referenced a
non-existent initrd. Just return an empty initrd instead.
(cherry picked from commit 2b43970c8c97f24b1f45c040c6963d30661fa514)

Remove checks for Test::Pod and Test::Pod::Coverage.

Although these modules are optionally used by the Perl tests,
they aren't necessary and won't break the build if they are not
there.  These modules aren't available in RHEL 5.  Therefore
remove these checks.
(cherry picked from commit c8f302a17453ad58acccd137342438795763606a)

Check user doesn't run configure, make or make check as root.

(Thanks to Yufang Zhang for helping to debug this issue).
(cherry picked from commit 199f218bf431b77c12a728f7072bed1553a0f0af)

Replace 'dd' in tests with use of guestfish 'sparse' command.

'dd' is a very inefficient way to create files.  'truncate' is
better, but unfortunately that command is not available in RHEL 5.
So use the guestfish 'sparse' command instead (which also avoids
allocating disk space).
(cherry picked from commit 175c01d2336c07113f1c2966966957de5c344e3a)

Document new version numbering policy.

See discussion on mailing list:

https://www.redhat.com/archives/libguestfs/2010-April/msg00005.html
https://www.redhat.com/archives/libguestfs/2010-April/msg00057.html
https://www.redhat.com/archives/libguestfs/2010-April/msg00058.html
(cherry picked from commit 54a8f8f30de2f3132da97c54d07ca4639c405de1)

Update PO files.

Prepare for 1.2.3.

Document umask (RHBZ#582548, RHBZ#583554).
(cherry picked from commit c2a8efc548d6f997049cbb3d63bab360b0d946b6)

docs: Clarify documentation for mknod (RHBZ#582948).
(cherry picked from commit 42e43db927dac13da0afe6dba39708295eb06021)

docs: Add virt-resize(1) link to guestfish(1) manpage.
(cherry picked from commit 92d38b9ae3a0b1b4694da5e3d3a3cb155842cd91)

todo documentation: Idea: List, mount filesystems by UUID and label.
(cherry picked from commit e55400960a6a06eb6dc16ea96f3c30ed580d3d3a)

todo documentation: remove 'virt-grow/shrink', see virt-resize
(cherry picked from commit abb7365d4df7b945846a9f6189bbbd70e10122d1)

todo documentation: virt-rescue now uses $TERM from library, remove from todo list
(cherry picked from commit 398e6830a34e916c52cd23ba6d0b4c00602dfc61)

todo documentation: Remove old section on PPC bugs.

No one cares for PPC, and if they do they should file these
as bugs in the bug tracker.
(cherry picked from commit 3b759fe7fe568a3d643ee99e0aef0adaf163d1e5)

todo documentation: Remove old ideas for Python bindings.
(cherry picked from commit fc50bf2680d4ed653ff00d390cd7a17ebeb22cf2)

Documentation: Use 'g' instead of 'handle' in documentation.

By convention we use 'g' for handles.  Copy this convention
through to all the documentation.
(cherry picked from commit 2e0f3ed54b978925c79ca0d33e76bec338b23631)

In guestfs(3), unmount "/" directory in the example.
(cherry picked from commit 6e4bf8e278f5c8bd28eba7152d2f11d1e537ee1b)

Add compilation/linking example to guestfs(3) man page.
(cherry picked from commit 4680c732585b2c2d292f521f393215c7943096fa)

Build top-level directories in a more logical order.
(cherry picked from commit 09a0427448b1f4328b9246d4d8a26610bb5228c8)

generator: Fix typo in a comment.
(cherry picked from commit 68467cb1c2f8b1cc7844ed6512b7f76ef2aba1d1)

Improved checking, documentation of modes (RHBZ#582901, RHBZ#582929).

chmod: Disallow negative mode, document mode affected by umask.

mkdir-mode: Disallow negative mode, document that filesystems
may interpret the mode in different ways.

mknod: Disallow negative mode, document mode affected by umask.

umask: Check the range of umask mask value carefully.
(cherry picked from commit 61ab83d19009a8006dd73ebe16d22494b78be4d1)

fish: Autocomplete 'sparse' command (RHBZ#582899).

I also rechecked the list of built-in commands against
the actual commands to make sure no others were omitted.
(cherry picked from commit 42fc0e02b094ef3b19dae115276a0a33116af6d5)

Add a build test for the 'umask' command.

(cherry picked from commit 116d497c68c2e57f6e92abf8834112a794a145f0)

Documentation: lvcreate should say 'logical volume' (RHBZ#582953)
(cherry picked from commit e64c1e5aacd605ea177972e56ede5be22ae13d4f)

Fix build error in fuse/guestmount.c.

guestmount.c: In function 'main':
guestmount.c:899: error: implicit declaration of function 'setlocale'
[-Wimplicit-function-declaration]

guestmount.c wasn't including locale.h.
(cherry picked from commit c0d73e0e60b99b87855364ff346551f5ff7efccb)

fish: Allow '-' prefix on command line to override exit on error (RHBZ#578407).

Allow -cmd on the command line to mean that normal exit on error
behaviour is overridden, ie. we will not exit.

This allows you to do:

  guestfish -- command : -command : command

with the second command allowing errors.  (Note that '--' is required
to stop getopt parsing -command as an option).

Also this fixes the remote case which is what the original
bug report was about.
(cherry picked from commit ad752b80d7fa064b7bdd3d4c8d47c95d79265b58)

fish: Update documentation: Add another pipe example.
(cherry picked from commit c076aaea7e6d9459c8d8a96d21abd71a0223f098)

fish: Update documentation: Using 'lcd' command to change local directory.
(cherry picked from commit c7c4a476a5957794dc2e9af0ec14b447ecef5740)

Version 1.2.2

Fix time and timezone to be correct within the appliance.
(cherry picked from commit 508f1ee87e816bf6b6fc8e629ccbb2d61a971169)

virt-resize: Mention alternate tools like gparted in the documentation.

Note for stable-1.2:
Cherry picked from development commit c53e64a and rebased
against stable-1.2 tree.

Documentation updates.

Fix copyright years.
Fix URLs to point to new PRC site.
Make sure guestfish(1) and guestfs(3) manpages reference the
current list of tools.

(cherry picked from commit 9a608a1516bd339dc6d5ebe9952d3bced273c416)

Bugfixes for virt-resize.

 - copy more than 64 boot loader sectors across, since real boot
   loaders (eg. for Windows) can be much larger than this
 - copy bootable flag and ID byte to new partitions
 - start the first partition on the new disk at the same sector
   offset as on the old disk
 - sync the disks before existing
(cherry picked from commit add5e22563972210f5c8baf9e8cf651fc1a7bbd8)

New partition APIs: part_del, part_get_bootable, part_get/set_mbr_id

These APIs flesh out further the partitioning API.

Note for stable-1.2 branch:
Cherry picked from b68c030adfdbefe65bc9 and modified
to apply against stable-1.2.  We need these new APIs
in order to support bugfixes in virt-resize.

daemon: More reliable parsing of the output from 'parted print'.

Previously we used strtok.  However this has the problem that
strtok considers multiple delimiter characters to be like a single
delimiter, eg. "1:::2" would be parsed the same as "1:2".  In
other words, the previous code would skip over or fail if there
are empty fields.
(cherry picked from commit cb9350019cc6382a35c98f522c9c4d221c92b605)

daemon: Make the RUN_PARTED macro take an error statement.

This allows us to make the RUN_PARTED macro do something else
along the error path, other than just returning -1.
(cherry picked from commit 440ad646cdf31bdb5ad2bc92fc51fa6df3fb9c63)

Documentation: Clarify documentation on the bootable flag.
(cherry picked from commit 30752ac7ca042f533b8d0c4c6144400a8532b154)

Allow aug-ls to take Augeas variable as argument (RHBZ#580016).
(cherry picked from commit d1dd00606d0b5b1430598e5092b017aa15d9ee11)

Update PO files.

Prepare for stable version 1.2.1.

Remove warning "No grub default" (RHBZ#580650).
(cherry picked from commit 3765f97898a1194d96ab4124e1eb46e25701b3b2)

If qemu dies during launch in "null vmchannel" mode, don't hang (RHBZ#579155).

Detect if qemu dies during launch by wait(2)-ing for it, and
then getting EOF on the qemu pipe.  This was broken in null
vmchannel mode, causing a hang.
(cherry picked from commit e35debd642bea240609775610b68145dab0a634b)

Don't kill self accidentally.

Always check that pid > 0 before calling kill (pid, 9).  The
issue was that sometimes pid == 0, and this ends up killing
ourselves.
(cherry picked from commit dc5df3bfec706803e75a5f2454293db30e753249)

Fix for "warning: unexpected connection from UID ..."

This warning is currently a fatal error.  The code attempts
to retry the accept call, but because we don't reset sock = -1
the retry doesn't happen and it dies anyway.

Set sock = -1 so the retry attempt can happen.
(cherry picked from commit fb4ec82d97f71963ea7f830cb0bc38abefcbac99)

configure: Default to using Fedora 12 repo (was Fedora 11).

Fedora 11 is almost EOL at this point.
(cherry picked from commit 0ce9b2bb9bcac61f7fb5dd2811d9b3b621f8309b)

Code cleanups related to RHBZ#580246.

This includes various code cleanups:

 (a) A regression test for RHBZ#580246.

 (b) Use write instead of fwrite to write out the tar file.  This is
     just because the error handling of write seems to be better
     specified and easier to use.

 (c) Use size_t instead of int for length.

 (d) Clearer debug messages when in verbose mode.
(cherry picked from commit de7ef2a0fdcbcddfd35ecb8ee2804e1ca0968454)

Fix tar-in command hangs when running out of disk space (RHBZ#580246).

The problem was this sequence of events:

 (1) File transfer goes through OK.

 (2) pclose returns failure (because 'tar' subprocess failed)

 (3) We try to cancel the transfer by calling cancel_receive.

Step (3) fails because the transfer (as far as the library is
concerned) has succeeded, so causing a hang.

The more fundamental reason why we see steps (1) and (2) is that
'tar' does NOT fail immediately if there is a write error.  Instead
it continues reading and discarding the input until the end of the
input before giving "Error exit delayed from previous errors".
IMHO this is a bug with tar, since an ENOSPC write error should
be fatal for tar.
(cherry picked from commit 07f4b20ae959069fca41756b0dc103ec5fa99754)

fish: Print extended help when the user types an unknown command first.

$ guestfish /tmp/disk.img
/tmp/disk.img: unknown command
Did you mean to open a disk image?  guestfish -a disk.img
For a list of commands:             guestfish -h
For complete documentation:         man guestfish
(cherry picked from commit 4c50f4c38d9a50fbf983c79dd208d1b1598fef8a)

Check error returns from posix_fallocate (RHBZ#579664).

posix_fallocate has a non-standard way to return error indications.
Thus all our calls to posix_fallocate were effectively unchecked.  For
example:

  $ guestfish alloc test.img 1P
  $ echo $?
  0
  $ ll test.img
  -rw-rw-r--. 1 rjones rjones 0 2010-04-06 11:02 test.img
  $ rm test.img

With this change, errors are detected and reported properly:

  $ ./fish/guestfish alloc test.img 1P
  fallocate: File too large

This is a fix for:
https://bugzilla.redhat.com/show_bug.cgi?id=579664
(cherry picked from commit 2ade61d1f864c75ce65c358e4ac8a012a897b89a)

Prettier POD CSS.
(cherry picked from commit fb0375a0984efca96db1277398f9fe50ecdd578d)

Update PO files.

chmod +x virt-resize binary.

Fix EXTRA_DIST rule.

Prepare for 1.0.89.

Improved version of virt-win-reg, supporting exporting and merging.

virt-df: Match output with native (coreutils) 'df' command (RHBZ#578123).

This commit fixes the 'Use%' field in the output so it matches what
coreutils' 'df' command would print.

Firstly we change the calculation to use the space available to root,
not the space available to non-root.  This means it matches what 'df'
when run as root in the guest would show.

Secondly we display this rounded up to the next whole percent (ie. using
ceil), which is also what 'df' does.

Thirdly we change the regression test so it tests this.

Note that even with these changes you are not guaranteed to get precisely
the same figures from inside and outside the guest, as it depends on
how quiescent the guest is and how recently the superblock was synced.

Thanks: Rita Wu

tools: Add basic tests for the virt-* tools.

tools: Sectional header for manpages in Makefile.am

tools: Rearrange list of tools in Makefile.am.

daemon: Set TERM=dumb inside the daemon.

Since commit 977edb3185fe8f we have been passing TERM from the
library into the appliance (for the benefit of virt-rescue).
However this changes the output of parted, which I would argue
is a bug in parted:

 TERM=xterm /sbin/parted -m -- /dev/sda unit b print 2>&1 | hexdump -C
 00000000  1b 5b 3f 31 30 33 34 68  42 59 54 3b 0a 2f 64 65  |.[?1034hBYT;./de|

Notice the escape-sequence junk before the official "BYT;"
header.

By setting TERM=dumb we avoid this.

Fix the error message when reply body is too large (RHBZ#509597).

tests: Move alarm(2) calls to the correct place in the tests.

This is a re-fix for RHBZ#505329.

Prepare for 1.0.88.

rescue: Pass $TERM from library into the virt-rescue appliance.

We set it on the kernel command line, then get it out from
there when the rescue appliance boots.

rescue: Sync disk on exit, and improve messaging.

Const-correctness fix.

appliance: Set $PATH instead of hard-coding paths to binaries everywhere.

Change the appliance so PATH includes common directories.  Thus
we don't need to hard-code paths to binaries (eg. "/sbin/fdisk")
everywhere.

perl: use newSVpvn for variable length strings.

Previously we used newSVpv (str, len), but if len == 0 then
this means Perl tries to calculate the string length using
strlen(3).  This is not desirable when we know the length, in
which case we should use newSVpvn instead.

Update PO files.

Update Spanish translation of libguestfs (RHBZ#576876).

Fix lvresize test on RHEL 5, by fixing guestfs_e2fsck_l.

The problem is that mkfs was making an ext2 filesystem,
which later we were checking with e4fsck.  e4fsck corrects
an "error" on the filesystem:
  /dev/VG/LV: Adding dirhash hint to filesystem.
e4fsck returns 1 (errors corrected) which we were interpreting
as an error return.

Use ext4 dev tools on RHEL 5 (RHBZ#576688).

Add support for minix filesystem (RHBZ#576689).

Version 1.0.87.

New tools: virt-resize and virt-list-partitions.

Virt-resize is the main contribution here, a program which can
be used to expand and shrink partitions in disk images.

Virt-list-partitions is used as an ancillary tool for planning
resize operations.

New API: guestfs_copy_size to copy a fixed number of bytes.

This is similar to 'guestfs_dd', but it copies just a fixed
number of bytes from the source to the destination.  It's an
error if the source is too short or if the destination is too
small.

Change some _exit(0|1) to _exit(EXIT_SUCCESS|EXIT_FAILURE).

Mac OS X: Fix configure-time tests for Ruby.

For ARCHFLAGS change, see:
http://www.ruby-forum.com/topic/129717#579065

We also add a test for the <guestfs.h> header and include
that header when testing the library.

guestfs.h: Include <stdint.h>.

This allows programs to work if they just
  #include <guestfs.h>
and no other headers.  It's not useful in the general
case, but fixes some configure-time tests, particularly
the one for Ruby on OS X.

ocaml examples: Fix linking line so it uses local library.

Mac OS X: Disable null vmchannel implementation.

As far as I can tell, Darwin has no way to check the peer euid
of a _loopback_ TCP socket.  This is required for the "null vmchannel"
implementation to work securely.

Therefore disable this - Darwin will use one of the other supported
vmchannel implementations instead.

Mac OS X: 'xdr_uint32_t' is 'xdr_u_int32_t'

Mac OS X: For PATH_MAX, include <limits.h>

Mac OS X: setlocale function requires <locale.h> header file.

Mac OS X: implement readline functions.

OS X has an older version of readline with some differences
in the names of functions.

Mac OS X: provide alternate implementation of posix_fallocate.

Mac OS X: include <rpc/types.h> before <rpc/xdr.h>

In PortableXDR this is not included automatically so we
have to include it explicitly to get definitions for the
XDR types.

Mac OS X: include <string.h> in guestfs-actions.c

This is required because guestfs-actions.c uses 'memset'.

Mac OS X: Fix HAVE_GNU_CALLOC so it works when __GLIBC__ is not defined.

Mac OS X: strerror_r on Macs is not like GNU strerror_r.

Really this should be turned into a configure-time test.
Perhaps one exists already?

Mac OS X: define MAX macro if not already defined.