daemon: write-file: Check range of size parameter (RHBZ#597135).

This also adds a regression test.

For stable-1.2 branch:
 - cherry picked from commit 9733d4746988b3a072d8bb1daac4b9795b8f4134
 - modify the regression test to apply against the generator

daemon: Limit label lengths (RHBZ#597118).
(cherry picked from commit 52f9cd4882135910ea06e1e50ac6441d455c9ab1)

daemon: Kill blkid cache to improve reliability of blkid commands.

By killing the cache file, we make blkid work in situations such
as a just-created filesystem.
(cherry picked from commit 21c42e9fabf6cea3d564e338a314479ef120502a)

daemon: Generalize the implementation of vfs-type.

Note that there is no change to the semantics of the code.
(cherry picked from commit 85c71f8fff3e80f549342bf995b686ba7303c2b4)

todo: Should generate -N option.
(cherry picked from commit fc1dc099a1ceeea45d3c21c699daf39618ca714a)

todo: Remove implemented resize functions from TODO file.
(cherry picked from commit 0e42861ccf9e55582db13828ca4eaef213de1f8a)

Rely on new augeas lens for modules.conf and conf.modules

Latest augeas includes a lens for /etc/modules.conf. If this new lens is
present, the code to force the Modprobe lens to try to match /etc/modules.conf
as well results in /etc/modules.conf not being parsed at all. This results in
modprobe_aliases in virt-inspector output being empty.

This change is equivalent to change cfd28d1140393667913689b7b9bcf21c8bfe592c
from virt-v2v.

An effect of this change is that the Modules_conf augeas lens is now required
for correct operation on guests which use /etc/modules.conf.

Fixes RHBZ#596776
(cherry picked from commit 245ed4b8eb076a8c4cc5787f49d21c4f68630f9f)

Fix documentation for vfs-type to reflect reality.
(cherry picked from commit 0f6c6239fe0d1b4624e4e9776559c21486a9c7cf)

Clarify documentation on distro backports in version command.
(cherry picked from commit 11eeb8885c7a8ffb59e12cd5fb2ae0fc324df383)

Add reference to version number documentation to version command.
(cherry picked from commit 8355d3245623c106439ca5ef66f24972c8e09019)

Clarify sparse behaviour of truncate-size command.
(cherry picked from commit d12a702fe1898f3ea421210d92c705440efe07a8)

Fix typo in documentation of guestfs_readlinklist.
(cherry picked from commit 4412fd951ee7766ee9a70bf66b5cf11378a64ed0)

Fix missing word in docuentation of guestfs_readdir.
(cherry picked from commit b8861242d13cc034383a56ba891d3e0b9123a99c)

Fix typo in description of echo-daemon command.
(cherry picked from commit c1e3cff523d72e8110cbc568a3c280e57c2aabca)

fish: Don't eat words when completing case-insensitive paths (RHBZ#582993).

(cherry picked from commit 21bd2db7cf259a17cc3922409937b849e4b83c0f)

fish: Sort returned paths so the list is stable across multiple calls.
(cherry picked from commit 53c3b9d2b03fa5cb0ac7e86a5a51f2a18a2b91c1)

fish: Create a separate FILES section in the manpage.
(cherry picked from commit 7fd6e4bfb11d1f86c585de06fb2146aa5cbd400e)

fish: Move 'EXIT CODE' section to a more logical place in the documentation.
(cherry picked from commit 34a306ab2a7e6d9f468e8194cef8a05624325260)

resize: Refresh the examples in the documentation.

The documentation was previously very intimidating.  Bring some
common, simple examples up to the top of the page in a separate
section.

For stable-1.2 branch:
 - cherry picked from commit 0e28e4104d96bf0bf5b88fb07bb7e5f9f6e6f41f
 - modified instructions slightly to apply to older version of
   virt-list-partitions
 - replace 'truncate' with 'dd'

fish: Make the read/write warning more prominent.

Follow the example on other manual pages by making the warning
more prominent.
(cherry picked from commit 57cc217335ff511e579b094e47b0de57d5c3aaef)

Version 1.2.8.

build: For development releases, print a notice.
(cherry picked from commit 613d041c78e25dafc238696f2fe35b51e443f23b)

guestfs_version: Correct documentation.

Remove reference to 'ELF weak linking tricks' and replace
with suggestion to use dl* functions.
(cherry picked from commit 94030c5ce8b5848330e15e812a01064d5afcc6d0)

TODO: Suggest including undelete utility.
(cherry picked from commit 478e1942a9fb4d86b0c4701b6b71f1eac376d0c1)

Fix name of update-bugs script in output file BUGS.
(cherry picked from commit aecdf3c117874e3dc44282600b988d18350b3ad5)

generator: Some String parameters should be OptString (RHBZ#501894).

I haven't checked the list of functions exhaustively, but
these are the obvious ones.
(cherry picked from commit e715451fae0ba738973af98a4e506b6c5564626a)

fish: Fix build error if built without readline.

fish.c:1447: error: 'add_history_line' defined but not used [-Wunused-function]

(Reported by Matt Booth)

(cherry picked from commit 5af010c96d687a7cf5251107a74770a231f42b77)

appliance: Ignore utempter unreadable binaries (for RHEL 6).
(cherry picked from commit 2dc7bb00337656c00fabed2c1f017aac1fa09da4)

appliance: Change comment about unreadable binaries.

For stable branch, change reference to febootstrap-supermin-helper
to libguestfs-supermin-helper.
(cherry picked from commit 155aa76e57c99594a3724933b6d117f1053544b3)

Update BUGS and PO files.

Update BUGS.

Version 1.2.7.

Generate BUGS file from Red Hat Bugzilla database.

Add a script which generates the 'BUGS' file from Red Hat Bugzilla.
This is run whenever we do 'make dist' and deliberately stored in git.
(cherry picked from commit 002dc21cba1469cc5b1ce5ef4a7984a733b44a1f)

virt-df: Display domains in sorted order.
(cherry picked from commit 5d5565ca24b95719461b0c0aebdb0651dd2671ca)

Update PO files.

Version 1.2.6

Improved error if virt-inspector cannot find OSes in image (RHBZ#591142).

(cherry picked from commit 94e310dcfbcd368cbe02dbc1643ed2ff9821cd48
and modified to apply to the stable branch)

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)