Generate a dummy 'Fedora' fedora.img in images directory for use by tests.

We were generating this dummy 'Fedora' image already in the
tools directory.  It contains just enough Fedora-like files
to fool our inspection code and thus to test the tools.

This is general enough that we can use it everywhere.

Defend all typedefs in <guestfs.h> with #ifdefs.

This allows other libraries to redefine those typedefs
if they need to use but not depend on <guestfs.h>.

lib: Make <guestfs.h> be completely generated.

This removes the 'not-quite-separate' guestfs-actions.h and
guestfs-structs.h files.

Fix small typo in a comment in src/Makefile.am.

capitests: Add the code to test (proposed) add-libvirt-dom C API.

This API was dropped as there are some problems with it.  This
commit adds the original test code, but commented out.

fish: Use core add-domain API to implement '-d' option.

This also makes libxml2 and libvirt into optional dependencies.
If they are missing then the core API will print an error, as
will the '-d' option to guestfish.

New API: add-domain

This new API allows you to add the disks from a libvirt
domain.

In guestfish you can use the 'domain' command to access the
API, eg:

><fs> domain Fedora14 libvirturi:qemu:///system
1

The returned number is the number of disks that were added.

Also here is a proposed (but commented out) low-level API
which would allow you to add a domain from a virDomainPtr.
However there are several problems with this API -- see discussion
on the list:
https://www.redhat.com/archives/libguestfs/2010-November/thread.html#00028

generator: Add Pointer parameter type to the generator.

This allows generic "foo *bar" pointers to be passed to
library functions (not to daemon functions).

In the language bindings (except Perl) these are handled
as generic int64s with the assumption being that any
pointer can be converted to and from this.  There is room
to add specific support for some pointer types in future
by specializing the match cases.  However this is inherently
tricky because it depends on the implementation details of
other bindings (eg. to support virDomainPtr in OCaml depends
on the implementation details of the ocaml-libvirt project).

Perl is slightly different in that you have to supply a
typemap.  Again this would depend on the implementation
detail of an external library unless you supplied a generic
typemap for int64.

New API: debug-cmdline for printing QEMU command line (internal only).

This is an internal-only debugging API so may be changed or
removed at any time in the future.

Add internal facility to checkpoint and roll back the command line.

This internal interface can be used to ensure that certain
operations are atomic.

lib: Make pcre, libmagic and hivex libraries optional.

This change makes these libraries optional.  If they are not
available at compile time then certain core API features will
be disabled (see below).

This also changes PCRE detection to use pkg-config instead
of the ad hoc autoconf checks.

The large inspect.c file has been split out into separate
function-specific files.

  file-architecture: requires pcre & libmagic
  inspection: requires pcre & hivex

Don't include debug* commands in the documentation.

capitests: Add whitespace in Makefile.

inspect: win64 regexp was dead code.

lib: Augeas (client side) is not needed by the library.

However it is used by the daemon.

ocaml: Error on compiler warnings.

ruby: Remove extra space before parenthesis.

Revert "autogen: Touch ocaml/.depend"

This reverts commit a0f85ba643990da25b6afe6a2bbd2407cf312c73.

Revert "Remove ocaml/.depend from git."

This reverts commit 064569bcbf854a9cf588ce31851d987d5f114ec8.

This commit does the wrong thing: creating an empty ocaml/.depend
file is wrong because building the OCaml bindings will fail.
Not having this file will prevent automake from running.  Therefore
this file has to exist with the correct content in git.

Version 1.7.3.

build: Create an AUTHORS file.

build: Don't try to rebuild po-docs/<lang> if no po4a.

build: Add ./configure --disable-php option.

This disables the PHP language bindings.

build: Test for virt tools Perl libraries conditionally.

Only test for these if $PERL is defined, and use $PERL as
the interpreter.

build: Add ./configure --disable-haskell option.

This disables the Haskell language bindings.

build: Add ./configure --disable-ruby option.

This disables the Ruby language bindings.

build: Warn if Python include or site-packages not found.

build: Add ./configure --disable-python option.

This disables the Python language bindings.

build: Add ./configure --disable-perl option.

This disables the Perl bindings.

ocaml: Remove the old OCaml viewer program.

This program is obsolete and the code has been reused for
guestfs-browser here:
http://people.redhat.com/~rjones/guestfs-browser/

build: Add ./configure --disable-ocaml option.

This can be used to disable the OCaml bindings.  Note that
OCaml is still required in any case where you need to rerun
the generator.

build: Add ./configure --disable-fuse option.

If this option is specified, FUSE support is unconditionally
disabled.

supermin: If disabled, don't compile in supermin code or check for supermin.

If supermin is disabled at compile time and the user just wants to
use the ordinary appliance, there is no need to compile in all
the supermin code, and in particular there is no need to check
for the supermin appliance (which involves running
febootstrap-supermin-helper that probably doesn't exist).

This fixes a warning message observed under Debian w/o supermin:

  sh: febootstrap-supermin-helper: command not found

fish: Add --rw option (does nothing yet).

This adds the guestfish --rw option, intended in future
to be required for writing to disk images.

At the moment this does not change the default and so does
nothing.  This patch is intended for backporting to the
stable branches so that we can start to introduce scripts
which use 'guestfish --rw'.

Add missing generated files to the tarball (thanks maksbotan).

C# bindings were omitted entirely.  Add a Makefile.am for this
directory even though we don't build these.

Because of a missing backslash, some POD files were not being
included.

fish: Add --listen --csh to for csh, tcsh compatibility.

(Thanks Eric Blake).

fish: Suggest safer form of eval.

eval "$(guestfish --listen)"

instead of various other forms.

(Thanks Eric Blake).

fish: More portable export sh statment.

Don't depend on bash, but allow sh/dash/etc format:
GUESTFISH_PID=nn; export GUESTFISH_PID

(Thanks Eric Blake).

New API: inspect-get-roots to return roots from last inspection.

Return the roots found by the last call to inspect-os, but
without redoing the whole inspection.

generator: Don't die if an API call isn't listed in API versions file.

For example, it may just have been added.

Version 1.7.2.

configure: Test for 'kvm' binary.

Include <stdarg.h> in public header.

Public headers use va_list, and this gives an error unless <stdarg.h>
had been included before the header.

Don't print out key material in trace output.

fish: '-i' option automatically handles whole-disk encryption.

This feature is also available in guestmount because of the
shared option parsing code.

You don't need to do anything to enable it, just using -i
will attempt decryption of encrypted partitions.

Only works for simple Fedora whole-disk encryption.  It's a
work-in-progress to make it work for other types of encryption.

docs: Fix API support script.

Before libguestfs 1.0.69 we needed to look in src/guestfs.c to
see all the API calls.

fish: Fix missing guestfish commands in HTML docs.

fish: Make the 'help' command more helpful.

docs: Which API calls were first supported in which upstream versions.

Run src/api-support/update-from-tarballs.sh (this won't work
unless you have a local copy of the tarballs from the website).

src/api-support/added contains the result of running the
script, a list of pairs: (API name, version first appeared).

virt-win-reg: Current is the control set Windows chooses at boot.

HACKING: Mention PHP bindings.

docs: Indent *_va and *_argv functions correctly.

This fixes commit f661db2c393d1b7e4211c55682b7fac82a70e36d.

Version 1.7.1.

fish: Use a perfect hash for faster command lookups.

Existing command lookups are approx O(n^2).  Replace this
with a perfect hash implementation which should be a lot
faster.

generator: Properly lay out and indent multi-line C function decls.

docs: Clarify no additional error available from guestfs_create.

docs: Clarify default error handler.

docs: Error strings are in fact localized, documentation was wrong.

docs: Clarify, not every function that returns int returns -1 for errors.

capitests: Test guestfs_last_errno call.

fuse: Use guestfs_last_errno instead of errno-reversal-hack.

lib: Expose errno through new API guestfs_last_errno.

If either the daemon sends back an errno, or a system call
fails in the library, save the errno in the handle and then
make it available to callers through the guestfs_last_errno
function.

daemon: Send back the errno as a string.

This changes the protocol again so that if the errno is available,
it is converted to a string (like "EIO") and sent back over the
protocol to the library.

In this commit the library just discards the string.

capitests: Test guestfs_add_drive_opts with optional args from C.

capitests: Test some basic aspects of the C API.

capitests: Use ftruncate instead of seek + write to create test files.

capitests: Don't open test files with O_NONBLOCK.

I have no idea why we were doing this.

capitests: Set path in TESTS_ENVIRONMENT instead of in tests.c

By exporting LIBGUESTFS_PATH with the right path to the appliance,
we no longer need to hard code the path in tests.c

generator: Remove unnecessary macro redefinitions.

These macros are already defined in guestfs-internals.h

Define internal safe_calloc shorthand.

daemon: Don't use ../src path to include generator_protocol.h

This file is already hard-linked into the current directory, so
the relative path is not required.

tests: Remove use of sfdisk from tests.

Some older tests used sfdisk to create partitions for the
tests.  sfdisk is buggy (more so than parted -- what is it
with partitioning tools?) so replace these tests with
equivalent part-* commands.

daemon: Tolerate failure of blockdev --rereadpt after sfdisk.

See commit 840536ea5a0568296dfd3e483442c76b93c5a949
and commit 956fc5a3feacc970ea763697bf28fb686c875408.

binary: Link guestmount static binary with -lm.

This is indirectly required via the new shared guestfish
C inspection code by libxml2.

website: Distribute BUGS and RELEASE-NOTES files to website.

Version 1.7.0.

Final RELEASE-NOTES file for version 1.6.0.

inspect: Add support for MeeGo.

Version 1.5.26.

inspect: Add support for Ubuntu.

inspect: Add detection of Gentoo.

inspect: Add detection of Arch Linux.

inspect: Add detection of Pardus.

inspect: Generic parsing of MAJOR.MINOR in product names.

inspect: Generic parsing of release files.

inspector: Sort <filesystems> section.

inspect: Ignore Pardus "/.swap" swapfile.

autogen: Touch ocaml/.depend

inspector: List Debian packages.

List Debian packages by downloading and parsing the file
/var/lib/dpkg/status.

inspector: Introductory documentation for XML format.

inspector: Debian package format 'deb' instead of 'dpkg'.

inspector: Return canonical block device paths in XML.

Version 1.5.25.

Ensure atomic creation of a cached appliance

Cached appliances are discovered by their predictable path. Previously we were
creating a cached appliance directly in this predictable path. This had at least
2 undesirable effects:

* Interrupting appliance creation would leave a corrupt appliance
* 2 processes could simultaneously attempt to create the same appliance, causing
  corruption.

This patch causes the cached appliance to be created in a temporary directory,
and then renamed to the predictable path. As rename is an atomic operation, this
makes the whole creation atomic.

This patch also changes the predictable path to have a prefix of 'guestfs.'.
This will make it simpler for system administrators to clean up old cached
appliances.

This patch resolves RHBZ#639405

Call febootstrap-supermin-helper using the new -u and -g options

Use febootstrap-supermin-helper's new -u and -g command line options to setuid,
rather than doing it in libguestfs.

This resolves an issue with the generation of the cached appliance checksum. The
checksum was being generated by a call to febootstrap-supermin-helper through
popen(). Unfortunately, a bash misfeature meant that euid would be reset to uid,
and the checksum was generated for uid, not euid. When virt-v2v is writing to a
RHEV target, uid == 0 and euid == 36, which resulted in a cached appliance being
created for root with permissions for uid 36.

Note this requires febootstrap 2.10.

Log the febootstrap-supermin-helper command line

A side-effect of change 17e7cb9937a63ed8f9bb0fb6ac7302758be76846 was the the
febootstrap-supermin-helper was no longer logged. This change adds it back using
the new guestfs___print_timestamped_argv internal function.

New internal function guestfs___print_timestamped_argv

This function generalises the existing print_cmdline used to output the qemu
command line to output any given command line, and exports it to other modules.
It also adds a timestamp to the old print_cmdline output for consistency with
guestfs___print_timestamped_message.

list-filesystems: Use core list-filesystems API (RHBZ#642933).

Change virt-list-filesystems to use the core inspection API
instead of the deprecated Sys::Guestfs::Lib::get_partitions
function.

Sys::Guestfs::Lib: deprecate get_partitions (RHBZ#642933).

However the code is left since this function is used
by virt-v2v amongst others.

inspector: Rewrite virt-inspector (RHBZ#642930).

Rewrite virt-inspector:

 - remove old and unsupportable features
 - use the C inspection API
 - don't run programs from the guest

The RNG has been updated to reflect the new XML-only output.

The new example files show the new XML output.