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.

guestfs(3): Referenced section is above, not below.

guestfs(3): Refresh autosync gotcha documentation.

guestfs(3): Writing to a file descriptor, not just a pipe.

guestfs(3): Refresh documentation for guestfs_create, guestfs_close.

Add a trace message to guestfs_close.

Only the "first half" (ie. the call) is traced, because by the time
the function returns the handle has gone and there's no way to
generate events.

You should see:

  libguestfs: trace: close

internal: Use size_t instead of int for command line size.

guestfs_close: Move local variables close to code that uses them.

This is just code motion.

guestfs_close: Remove unused local variable.

guestfs(3): Document limits.

todo: Integrate with CMDBs (thanks Quinten Laureijs).

python: Ensure Python GIL state is correct during callback.

This updates commit 2cac52000a6a96a583af72e289a4296c596047d5.

Version 1.11.3.

python: Implement new event API.

This implements set_event_callback and delete_event_callback so that
Python programs can use the new event mechanism.

python: Rearrange C files for bindings.

Move the hand-written functions into two new files:
guestfs-py.h and guestfs-py-byhand.c

This is just code motion.

perl: Decrement refcount in $g->delete_event_callback.

This updates commit bc468c87d04b34faacd208c49cca4a5096e5103c.

inspect: Look for %systemroot%/system32 for Windows heuristic.

The virt-v2v transfer ISO had a /windows directory.  The core
inspection code thought this was a Windows root filesystem.

list-applications: If software hive is missing, this is an error.

virt-inspector would exit silently if list-applications failed along
this error path.

inspect: "centos" and "scientificlinux" are now separate distros.

Previously we returned "rhel" for these, which was not accurate.

Update TODO.

Version 1.11.2.

python: Release Python GIL while running libguestfs calls.

Release the Python global interpreter lock while running libguestfs
calls.

We don't release it around guestfs_create() because that is a short
call that just allocates memory.  We do release it around
guestfs_close() since that is a potentially long-running (it can call
wait(2) amongst other things).  We also release it around all the
other generated Python calls.

We don't yet support callbacks into Python code (ie. the new event
API).  But when we do in future, we will need to also handle the GIL
around those callbacks.

This code is adapted from libvirt's python/typewrappers.h.  Thanks to
Dan Berrange for showing us how to do this properly.

fish: --rw option will be mandatory in 1.12 not 1.10.

fish: Fix typo in guestfish man page (--format option).

inspector: Refresh the virt-inspector(1) manpage.

run script: Don't depend on libtool being installed.

Also use 'exec' to run the program.

Version 1.11.1.

Add images/guestfs-aux/fedora-packages.db{,.txt} to EXTRA_DIST.

This updates commit d95874db3dc6c415061b86275d03770b4f28ffbb.

Remove local LIBGUESTFS_PATH detection from guestfish and guestmount.

Remove the hack that let you run ./fish/guestfish or
./fuse/guestmount.  You now have to do:

  ./run ./fish/guestfish
or
  ./run ./fuse/guestmount

to run these programs without installing.

Remove ad-hoc run*locally scripts, replace with './run'

Remove all the run*locally scripts and replace with a single top level
./run shell script.

inspector: Handle write failures when creating example-*.xml.

Delete file so db_load doesn't run incrementally.

It turns out that db_load incrementally updates the database (instead
of writing a new one).  Remove the old database to force db_load to
write a new one.

This also ensures that we handle write failure gracefully.

inspector: Include <hostname> in output.

inspect: Get version and release of RPM packages.

This commit downloads the Packages RPM database allowing us to find
other details about installed RPM packages (via
inspect-list-applications).  This adds version and release.  Epoch
cannot yet be found.

This commit also updates the Fedora example image so that it contains
a dummy RPM Packages database with some data.

inspect: Abstract out db_dump code for listing RPM applications.

There are two changes here:

(1) The code for listing RPM applications ran db_dump and parsed the
output.  We abstract out that parsing code into a separate reusable
module (src/dbdump.c).

(2) The old db_dump parsing code used db_dump -p (printable) format.
Instead use db_dump -k (hex) format so we can read binary fields.

inspect: Split code into separate files.

The src/inspect.c file had grown rather large -- 3,500 lines.  Split
it across several files according to function.

This is just moving code.

After the split the files are more evenly divided:

  536 src/inspect_apps.c
  766 src/inspect.c
  537 src/inspect_fs.c
  404 src/inspect_fs_cd.c
  785 src/inspect_fs_unix.c
  535 src/inspect_fs_windows.c
 3563 total

inspect: Move shared PCRE match functions to separate file.

This is just moving code around.

inspect: Cache downloaded files in the handle g->tmpdir.

During inspection we download various files such as the Windows
'software' and 'system' registries.  Previously these were downloaded
as temporary files and discarded immediately after use.  This meant
that the 'software' registry was being downloaded twice by
virt-inspector (it's required once for basic OS inspection, and a
second time to list Windows applications).

This commit changes this so that these files are cached in g->tmpdir,
and thus the second time we just reuse the file we've already
downloaded.

Callers shouldn't be relying on inspect-list-applications to reread
the actual registry from the VM (unless you close and reopen the
handle).  It says in the documentation that the results of inspection
may be cached in the handle.

Remove temporary directory containing arbitrary files.

In preparation for caching inspection information in the temporary
directory (g->tmpdir), allow the temporary directory to contain
arbitrary files, and remove all of them when the handle is closed.

This just generalizes the previous method of cleaning up the tmpdir.

Include string.h and libintl.h, as needed.

* df/df.c: As above.
* df/main.c: As above.
* df/output.c: As above.
* fuse/guestmount.c: As above.
* inspector/virt-inspector.c: As above.
* rescue/virt-rescue.c: As above.

Add more missing include directives.

* cat/virt-cat.c: Include string.h and libintl.h.
* cat/virt-filesystems.c: Likewise.
* cat/virt-ls.c: Likewise.

debian: Add dependency on libpcre-ocaml-dev.

Add missing include directives.

* fish/config.c: Include string.h, for use of strlen.
* fish/keys.c: Likewise, but for use of memcpy.
* fish/man.c: Likewise, but for use of memset.

Avoid warning about implicit declaration of strlen.

* src/events.c: Include <string.h>, for use of strlen.

debian: libguestfs-test-tool-helper no longer exists.

resize: Include stamp file for manpage in CLEANFILES.

Version 1.11.0.

Update RELEASE-NOTES for 1.10 release.

Update ROADMAP for 1.12 and beyond.

README: virtio-serial is required.

guestfs(3): Fix documentation for drive letters.

We can now get drive letter mappings through the inspection API.

inspect: Fix some small memory leaks in Windows inspection.

Found using valgrind.

fish: Allows win:... paths to work with drives mounted anywhere.

This allows you to mount disks on (eg) /c and /e and have the
guestfish win:... path mechanism map drive letters to the
right places.