docs: Update API support.

Version 1.11.12.

fish: Add 'display' command for displaying graphical files.

New API: inspect-get-icon returns the guest icon.

This API returns the guest's favicon if found, else an icon
representing the guest operating system.  Currently supported by this
patch: Fedora, RHEL and derivatives, Debian (but not Ubuntu),
Windows XP, Windows 7.

This also updates virt-inspector to include an <icon> element
containing the icon in base64 encoding.

Change download_to_tmp so it can work with multi-root operating systems.

The previous guestfs___download_to_tmp function did not handle
multiboot correctly.  In particular it used the same cache name
for downloaded files from different roots, which could have caused
things like applications in each root to be confused.

This changes the function so that the cache filename is prefixed
with the root / fs number, eg. $tmpdir/0-Name instead of $tmpdir/Name.

This change also requires the function to return the new name, so
all places in the code which called this function had to be
updated.

This updates and fixes commit 3c1f762abed92f7a358f3bc93e3396d0606b18ad.

generator: Fix functions with both RBufferOut and optional args.

No current function returns RBufferOut and has optional args.  Such
functions would be generated incorrectly.

RBufferOut implies a silent "size_t *size_r" argument is added after
the regular arguments and before the optional arguments.  Various
changes to the code generator need to be made to take this into
account.

inspector: Fix comment in virt-inspector.rng.

The comment referred to the command line syntax of the old
virt-inspector.

inspection: Remove note about root device string.

This is a fairly pointless note/warning since (a) you can't use the
API if you don't pass a root device string and (b) the code gives you
a good error message if you pass something that is not a root device
string.

guestfs.h: Tidy up *_argv structs and other #defines.

Revert "Lib.pm: unknown filesystem label SWAP-sda2 (RHBZ#666578)"

This reverts commit 5cab0d6c807d8a3bf9690375c663d11a10e21656.

New API: mount-9p lets you mount 9p filesystems (RHBZ#714981).

The updated patch makes 'options' into an optional parameter.

New API: list-9p lists 9p filesystem mount tags (RHBZ#714981).

trace: Print empty list correctly.

Empty lists returned by RStringList and RHashtable functions
were incorrectly printed as [""].

Fix this so they are printed as [] instead.

Version 1.11.11.

Enable deprecated option only with gcc >= 4.5.

Before gcc 4.5, the deprecated option did not take the optional string
argument (see [1]).  This caused compilation to fail with gcc < 4.5.

[1] http://gcc.gnu.org/gcc-4.5/changes.html

perl: Ignore MYMETA.yml.

This file is created by one of the build tools used by Perl 5.14.

todo: Idea for interactive disk creator program.

perl: Don't use qw() as parentheses.

In Perl 5.14:

Use of qw(...) as parentheses is deprecated at perl/blib/lib/Sys/Guestfs/Lib.pm line 1111.

generator: Rewrite UUIDs that begin with zero byte.

In util-linux <= 2.19, mkswap -U cannot handle the first byte of the
UUID being zero, so we artificially rewrite such UUIDs.

See: http://article.gmane.org/gmane.linux.utilities.util-linux-ng/4273

Version 1.11.10.

build: include <string.h> for src/match.c's use of strlen

bootstrap: use --libtool

build: update to latest gnulib

* .gnulib: Update submodule to latest.
* daemon/m4/gnulib-cache.m4: Regenerate.

daemon: Keep Coverity happy by ignoring some return values.

Coverity: Don't return freed pointers from command* along error path.

If the external command failed to run, we could free up the allocated
*stdoutput and *stderror pointers, but then return those freed
pointers to the caller.  The caller usually tries to print and free
*stderror, so this is a serious error.

Instead, return *stdoutput as NULL, and *stderror pointing to a
generic error message.

Coverity: Missing return on error path.

Coverity: Ensure fp is closed along all error paths.

Coverity: Close directory handle along error paths.

Coverity: Don't leak argv arrays.

Coverity: Don't leak error strings.

Coverity: Check return value of sysroot_path.

For some reason we were checking the parameter!

Coverity: Check return value of malloc.

Coverity: Don't close fd_cwd if fd_cwd == -1.

Coverity: Avoid calling sort_strings (NULL, 0) on empty list.

Coverity: Don't call free_strings (NULL).

Coverity: Remove unreachable code.

init: Remove timeout in udevadm settle command.

The given timeout (10s) was too low if the appliance was
running slowly, which caused a cascade of other failures
during tests.

Note that in udev-171 and above on Fedora, /sbin/start_udev
no longer exists, so now we are using this manual method to
start udevd.

protocol: Enhance "unexpected end of file when reading from daemon" error.

Make this error more informative, since it is a common error when the
appliance fails to start up.

Version 1.11.9.

Only include date, not time, in BUGS file.

This is so the file does not change so often when using 'make dist'.

Remove dependency diagram, since it is very out of date.

virt-ls: Add virt-ls -lR option for complex file iteration.

virt-ls: Refactor mode selection code.

This is just code motion.

virt-ls: Small fix for output of --help option.

Ubuntu: Fix compilation of virt-resize if old libguestfs already installed.

recipes: in tr command \000 should be \0

daemon: Fix error message.

todo: Document thoughts on visiting files.

debian: Add build dependencies: dpkg-dev, devscripts, gperf.

daemon: Make sysroot_len be size_t instead of int.

todo: Remove event log parsing - done.

build: Install guestfs-recipes.1.html on website.

This updates commit f2c7df589c7e161f33b46d05a943b5489dc2cffe.

Add new guestfs-rescue(1) man page with recipes.

Remove guestfish recipes.

These were out of date.  We will replace them with more up to date
information.

guestfs-examples(3): Remove link to OCaml homepage.

Version 1.11.8.

zero: Disable file test because of bug in file command.

See: https://bugzilla.redhat.com/show_bug.cgi?id=705499

virt-win-reg: Win XP paths can contain %systemdrive%.

virt-win-reg: systemroot macro should be replaced case insensitive.

New APIs: is-zero and is-zero-device, to test if file or device is all zeroes.

Document that guestfs_file output depends on file(1) command.

And therefore practically it cannot be part of the ABI since
the output of file(1) itself changes from time to time.

fuse: Add note about allowing other users to see filesystem (RHBZ#705200).

Version 1.11.7.

generator: Mark sfdisk functions as deprecated.

Point to the part-* API calls as replacements.

generator: Mark mount as deprecated.

Callers should use 'mount_options' or 'mount_vfs' instead.

See also:
http://libguestfs.org/guestfs.3.html#libguestfs_gotchas

generator: Mark wait_ready as deprecated.

The function has been a no op for a very long time.  By marking
it as deprecated we make it clear that you shouldn't call it
in new code.

generator: Check the flags fields.

Enable deprecation warnings on all C programs.

fish: fuse: Remove redundant -DGUESTFS_DEFAULT_PATH.

This was left over from earlier code.  It is used in the base library,
but not in guestfish or guestmount.

lib: Warn about deprecated functions (enable with -DGUESTFS_WARN_DEPRECATED=1).

This allows C API users to be warned if they are using any deprecated
functions.

We don't warn about this by default.  Users have to specifically
request this by defining the cpp symbol GUESTFS_WARN_DEPRECATED as 1.

lib: Add GCC version macro to the header file.

This will be used to internally enable various GCC enhancements.

lib: Add vertical space between each function in <guestfs.h>.

appliance: Use qemu -machine option where available (RHBZ#700369).

virt-win-reg: Support HKEY_USERS keys.

This adds support for various Registry keys under HKEY_USERS (user
preferences).

(1) HKEY_USERS\<SID>
    where <SID> is a User SID.

For example:

  # virt-win-reg Windows 'HKEY_USERS\S-1-5-19'

lists out the LocalService user's registry.

(2) HKEY_USERS\<username>
    where <username> is a Windows local username (this is a
    libguestfs extension).

For example:

  # virt-win-reg Windows 'HKEY_USERS\rjones'

lists out the user preferences of user 'rjones'.

HKU can be used as an abbreviation for HKEY_USERS.  Merging is also
supported.

virt-win-reg: Don't use implicit $_ in map_path_to_hive function.

virt-win-reg: Don't hard-code the relationship between hive name and path.

The crucial change is the tuple that is returned by map_path_to_hive:

-    my ($hivename, [...]) = map_path_to_hive ($_);
+    my ($hiveshortname, $hivefile, [...]) = map_path_to_hive ($_);

Previously the $hivename was both the name of the hive (eg. "sam"),
the name of the local copy in /tmp, and the name of the hive in
%systemroot%\system32\config.

In the new code, the $hiveshortname (eg. "sam") is still used for the
local copy in /tmp, but we return $hivefile which is the full Windows
path (eg. "/windows/system32/config/sam").

The purpose of this change is to allow us in future to return hives
from other Windows directories, specifically HKEY_USERS hives from
Windows home directories.

Although this is just code motion, it requires some quite extensive
changes to virt-win-reg.

virt-win-reg: Add --unsafe-printable-strings option.

This also requires hivex >= 1.2.7.

todo: See if qemu -machine option can be used to select KVM, TCG acceleration.

Version 1.11.6.

debian: Note that libconfig-dev ought to be required.

However it doesn't appear to be in Debian at the moment.

debian: Include debian/ directory in tarball.

This makes it simpler to build Debian and Ubuntu packages from the
tarballs.

build: Sort EXTRA_DIST into lexicographic order.

configure: Use Python platform-dependent site-packages.

This updates commit c446e6e26e317e105870b0ab25fb082887e23bf6.

Version 1.11.5.

edit: Reorganize options alphabetically.

edit: Fix reference to virt-cat in the documentation.

This updates commit 2b5fbc882a0a79646b668c7b95442f0b3673d63a.

Use Python distutils to determine include and site-packages directories.

This change was inspired by Hilko Bengen's similar change to hivex:
http://git.annexia.org/?p=hivex.git;a=commitdiff;h=b808c875a34e62fcdf360534f923d6030590ff44

Rewrite virt-edit in C.

daemon: Remove some less useful debugging messages.

Remove some debug messages which were basically left over from when
the code was being developed.

However we leave debug messages where it is printing an external
command that is about to be executed, since those are useful.

Version 1.11.4.

Fix guestfs___rollback_cmdline when pos == 0.

Because of the previous change to size_t, when pos == 0 the loop would
wrap around and cause a segmentation fault.

This fixes a regression introduced by
commit 10167cea98f93a74abe63f0a54d3a662997e7489.

configure: Sort output files in AC_CONFIG_FILES section.

fish: Allow -d UUID (specify libvirt domains by UUID).

This applies in all the commands which use the common C option parsing
code, ie:

* guestfish
* guestmount
* virt-cat
* virt-df
* virt-filesystems
* virt-inspector
* virt-ls
* virt-rescue

add-domain: Add allowuuid flag to allow UUIDs to be used for names.

This makes a backwards-compatible change to the add-domain API.  If
the optional allowuuid flag is true then UUIDs can be used instead of
names in the domain name parameter.

add-domain: Suppress libvirt errors on stderr.

Install an error handler on the libvirt error connection so that
errors are not printed on stderr (instead they go up through the usual
libguestfs error mechanism).

Unfortunately this doesn't suppress initial connection error messages
to stderr.  I cannot see how to do this without affecting the global
libvirt error handler, which is not acceptable for a library to be
doing.

doc: Use I<-...> for cross-references to command line options.

This is now used consistently across all the documentation.

df: Refresh virt-df(1) man page.

Add examples.

Refresh description.

Use I<...> to refer to command line options.

guestfs(3): Note that host file size limits affect guest disk limits.

guestfs(3): Refresh documentation for private data area keys.

guestfs(3): Document that old callback functions still work.