Fix error message in strings-e command (RHBZ#588651).

(cherry picked from commit 287f8957fea3efe411c7ac55595d5d6c7b613e4e
and modified to apply to the stable branch.  Note that the original
commit message contains a typo 'string-e' instead of 'strings-e')

Reduce imported functions in virt-df to ones which are actually used.
(cherry picked from commit 5477d98548661394cf0df3ce48929961e0d2a38f)

Run udev_settle() after swapon/swapoff (RHBZ#516096).
(cherry picked from commit 9d158c3ab132df21d58890f18224cd2fe020de67)

virt-rescue: Refresh documentation.
(cherry picked from commit d0afef23e54f75a521eed8c7261a533776242cfc)

launch: Rearrange the code so config check is first.

Move the config state check first in the guestfs_launch function,
so that we don't reset g->launch_t or calculate the temporary
directory in the case where the launch function will immediately
return with an error.
(cherry picked from commit 55e9707f8591488542da48fc89738234b4d85016)

Ignore test1.img file in directory.
(cherry picked from commit 2064e43bcfc7fc5bde08a0442c646a0a46997875)

fish: Make '-x' option enable traces instead of using separate echo path.

Previously we had separate code paths for echoing commands (-x)
and tracing (guestfs_set_trace).  This just unifies that so that
the guestfish -x option enables tracing.

(cherry picked from commit 8e007581c91a5193e6aec0f6f9aeb379a935c9d4
and commit a96d70113ffcd01f55262c3d0fbe711bee759fec
and commit 87eecb507ee09a62f3a12f5f75d3417a09c0c8d4 which are all
logically part of the same fix)

daemon: gnulib module 'error' is used directly by the daemon.
(cherry picked from commit b52ef0b021fc443d88d4d9c43f57468712e40965)

If qemu dies during launch, set an error message (RHBZ#588851).
(cherry picked from commit fc6dd9daa13ac774156d0822b5aa7830171feb85)

daemon: Fix read-file so it fails gracefully for large files (RHBZ#589039).

Pengzhen Cao noticed that read-file would fail for files
larger than the protocol size; this is *not* the bug.  However
it would also lose protocol synchronization after this.

The reason was that functions which return RBufferOut in the
generator must not 'touch' the *size_r parameter along error
return paths.

I fixed read-file and initrd-cat, and I checked that pread was
doing the right thing.

This also adds regression tests for read-file with various categories
of large file.
(cherry picked from commit 42f59b28f123f53ae038df23a9abee08e959e46b)

Warn instead of dying if grub refers to non-existent kernel
(cherry picked from commit 4839d5142ca50818965866287932f9ded14729e6)

Change network configuration to use macros.

Change the network configuration so everything is set using
some macros at the top of src/guestfs.c.

Also, rename the macros used in the daemon so they are not the
same.  It was a very long time since these sets of macros had to
match the ones defined in src/guestfs.c, despite what the comment
said.

Note that this commit should not change the semantics of the
program at all.
(cherry picked from commit 8a9f2ca65521d093ac14307aca4370d9497ac840)

tests: In verbose mode, print dashes between each test.

Only affects tests when run with LIBGUESTFS_DEBUG=1.  Lets you easily
see when each test starts and ends.
(cherry picked from commit 097266e01cfa28319834bf750649650f3c22006f)

Version 1.2.5

Document that guestfs_mount implies -o sync and performance problem (RHBZ#587582).
(cherry picked from commit fd2d10d6ed91f417a9b99bb61526b45bb7ed3e4e)

contrib: Add dependency diagram of libguestfs ecosystem.
(cherry picked from commit 90b4e24df6f27c02d3b11d8021b27a197cf18b75)

contrib: Add header to README file.
(cherry picked from commit 2f9f3375028a02fdaec62f30e11bacd6524a342c)

lvresize: Use --force so it can make LVs smaller (RHBZ#587484).

This also adds a regression test for this bug.
(cherry picked from commit c24de46d06cc3ecccf00bfaaffb06172659cdd0a)

tools: Fix documentation for CurrentControlSet (thanks Yuval Kashtan).
(cherry picked from commit 25c15261253bbd2fb140e5ca1c902acf714f76a9)

guestfs(3): Documentation on protocol gotchas.
(cherry picked from commit 55641f5d1e9964f8a039005b511b8e688c92cddb)

docs: Routine refresh of the documentation for guestfs(3) and guestfish(1).

For stable branch:
 - cherry picked from commit ce95be8b185ce69
 - updated the patch so it doesn't refer to any new guestfish features
     in the 1.3 branch

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).