Docs: Add "API Overview" section to guestfs(3) manpage.

This section collects together related API calls, to provide
more coherent documentation about different ways to carry
out actions such as uploading and downloading.

Generator: Improve accuracy of a comment.

virt-inspector --fish: Fix incorrect '-a' parameter (RHBZ#512709)

virt-inspector --fish dom
virt-inspector --ro-fish dom

Both of the above commands give incorrect results if run on a
libvirt domain, eg:

$ virt-inspector --ro-fish RHEL54Betax64
==> --ro -a RHEL54Betax64 -m /dev/VolGroup00/LogVol00:/ -m /dev/sda1:/boot
            ^^^^^^^^^^^^^

This is because the current code just prints back the original @ARGV
parameters.

This patch fixes this by getting the image names instead.

Replace 'distrofamily' with feature tags

It turns out that the distribution hierarchy is not as reliable concept as you
might think. This patch removes distrofamily again.

Instead of distrofamily, we will add feature tags. This patch adds 2 feature
tags for Linux distributions:

package_format (eg rpm/dpkg)
package_management (eg rhn/yum/apt)

This change is reflected in the output of virt-inspector

add nls_base.ko and nls_cp437.ko for vfat

Make /sysroot path configurable.

Currently /sysroot is hard-coded throughout the daemon code.

This patch turns the path into a variable so that we can change
it in future, for example to allow standalone mode to be implemented.

This patch was tested by running all the C API tests successfully.

Version 1.0.62.

Merge branch 'master' of git+ssh://g-rjones@et.redhat.com/git/libguestfs

RHEL 5.4 fix: Check for qemu-kvm binary in /usr/libexec

Differentiate 'distro' and 'distrofamily' in Sys::Guestfs::Lib

Change distro in the output formally known as virt-inspector to reflect the
actual distro. Possible values are now: fedora, rhel, centos, scientific,
debian.

Add new distrofamily entry which is one of: redhat, debian. Currently all
distros except 'debian' are in the redhat family.

This allows you to, for example, select a RHEL/CentOS/Scientific Linux specific
kernel for installation rather than assuming they're all the same.

Note this also changes the behaviour of virt-inspector --query. It will now only
return rhel=yes for RHEL.

cat: Example of finding DHCP IP address of a VM.

Fix non-srcdir builds: Ignore perl/Makefile-pl.old

Fix non-srcdir builds: further fixes to OCaml build rules.

Fixes for non-srcdir builds: Only include POTFILES from SUBDIRS directories.

Fix non-srcdir builds: fix OCaml build rules.

Fix non-srcdir builds: Files generated by configure should be in the tarball.

Fix non-srcdir builds: Don't include generated *_protocol.c files in POTFILES.

Don't clean up some non-generated files.

Fix for non-srcdir builds: more misc fixes.

Fix for non-srcdir builds: Run src/generator.ml from the srcdir.

Note that files generated by src/generator.ml are stored in
the srcdir, *not* the builddir.  The reason is so that they
can be included in the tarball and will appear in the srcdir
for tarball builds.

More misc fixes to non-srcdir builds.

More misc fixes for non-srcdir builds.

Miscellaneous fixes for non-srcdir builds.

New commands: 'mkmountpoint' and 'rmmountpoint'

These specialized commands are used to create additional mountpoints
before mounting filesystems.  They are only used where you want to
mount several unrelated or read-only filesystems together, and need
additional care to use correctly.

Here is how to use these calls to unpack the "Russian doll" nest
of a Fedora 11 live CD:

 add-ro Fedora-11-i686-Live.iso
 run
 mkmountpoint /cd
 mkmountpoint /squash
 mkmountpoint /ext3
 mount /dev/sda /cd
 mount-loop /cd/LiveOS/squashfs.img /squash
 mount-loop /squash/LiveOS/ext3fs.img /ext3

The inner filesystem is now unpacked under the /ext3 mountpoint.

New command: 'mountpoints' which returns a hash of device -> mountpoint.

Build fix: perl-libintl is not required for the basic Perl bindings.

Version 1.0.61

New tool virt-cat: display a file in a virtual machine.

This script is just a simpler way to cat a file from a VM.  It
is otherwise equivalent to using guestfish.

 virt-cat someguest /etc/fstab

 virt-cat someguest /var/log/messages | tail

Make Perl strings translatable using perl-libintl.

All Perl strings are now marked as translatable using __"string"
or __x("string {placeholder}", placeholder => $_).  Perl strings
now get copied to the PO files.

The po/POTFILES.in file is now updated automagically whenever we
add new *.c, *.pl or *.pm files into the repository.

guestfish: Add tilde expansion for paths (RHBZ#511372).

This commit adds tilde expansion for local users in guestfish:

  ><fs> echo "~"
  ~
  ><fs> echo ~
  /home/rjones
  ><fs> echo ~foo
  ~foo
  ><fs> echo ~rjones/bar
  /home/rjones/bar
  ><fs> echo ~roo
  ~roo
  ><fs> echo ~root/foo
  /root/foo
  ><fs> echo ~root
  /root

Version 1.0.60.

java/Makefile.inc: Include this generated file.

We have to include this generated file because it is part of
the build system, thus required to exist before the generator
runs.

File missing from tarball: rc_protocol.x

Version 1.0.59.

RHEL 5: header was called <sys/xattr.h>

Fix: daemon/xattr.c can now compile even when no xattr support.

Guestfish feature: remote control of guestfish over a pipe.

The use case is to have a long-running guestfish process in
a shell script, and thus to avoid the overhead of starting
guestfish each time.  Do:

 eval `guestfish --listen`

 guestfish --remote somecmd
 guestfish --remote someothercmd
 guestfish --remote exit

This patch also supports having multiple guestfish processes
at the same time.

The protocol is simple XDR messages over a Unix domain socket.

Removed getfattr/setfattr from TODO list, since now implemented.

Support for Linux extended attributes.

This commit adds six calls to support Linux extended attributes.
They are:
  getxattrs     list all extended attributes for a file or directory
  setxattr      add/replace an extended attribute
  removexattr   remove an extended attribute
  lgetxattrs    \
  lsetxattr     (same as above, but operate on symbolic links)
  lremovexattr  /

See attr(5) for more information.

This also adds support for the FBuffer field type, which maps to
an XDR opaque<> or a C (int, char *) pair.

virt-inspector: Ignore swap partitions marked as "none".

Improve launch error message.

The previous error message was confusing for new users:

  libguestfs: error: guestfs_mount: call launch() before using this function

The new error message explains the action that the user must take,
especially if they are using guestfish:

  ><fs> mount /dev/sda1 /
  libguestfs: error: guestfs_mount: call launch before using this function
  (in guestfish, don't forget to use the 'run' command)

Add reiserfs module to kernel whitelist.

Only allow virt-v2v to be run on single root guests (ie. no multi-boot).

Ignore old-style initrd which is a compressed ext2 filesystem.

'cpio' chokes on these, taking ages to decide that they are
not cpio files, and producing masses of messages.  This was
causing virt-inspector to be very slow (many minutes) on
RHEL 3 guests.  With this fix, speed is back to normal.

Implement new 'zfile' command, to show file type inside compressed files.

Ignore java/Makefile.inc (generated file).

Automatically generate list of built java sources

Revert "Fix checking of generator being run from the right directory."

This reverts commit 35c646965a21d452cf74ef3683612210a653c36d.

As well as reverting this change, add a comment explaining that
configure must run first.

Move BUILT_SOURCES so the comment is back in the right place.

Order alphabetically the options in guestfish.1 manpage.

Guestfish: implement -x option, echo commands before executing them.

Fix: '-D' was not recognized as a parameter to guestfish.

Regression test: Test reopening the handle in the same process.

Guestfish: Add 'reopen' command to reopen the libguestfs handle.

Add missing documentation for "more" command in guestfish help output.

Add tests to many non-daemon functions.

Tests are added to the following functions:
  get_qemu get_path get_append get_autosync
  is_ready is_config is_launching is_busy
  set_memsize get_memsize get_pid

Add TestOutputIntOp, CompareWithIntOp.

These constructors allow enhanced tests where we compare
the result of a test against some operator, eg. >= 1 or < 5

Test for "version" command should be InitNone.

Add comment to the code about InitNone and InitEmpty.

These two constructors are treated as identical, but they
should be distinct concepts.

Fix UPDATES and host_cpu in configure.ac.

UPDATES does not need to be propagated into config.h.

host_cpu was AC_DEFINE'd twice.

Documentation for virt-v2v.

V2V outline program.

Don't list Java files explicitly, since these files are auto-generated.

Version 1.0.58.

Proposal to add BufferIn and RBufferOut types (not implemented).

Sys::Guestfs::Lib: Exit with error if a libvirt domain appears to have no disks.

virt-df: Recognise libvirt domains with file-backed disks.

File-backed disks (<source file="...">) didn't get recognised
before.  This patch fixes the problem.

Add --version options to virt-df, virt-inspector and virt-v2v.

Add 'version' call to get true library version number.

This patch also changes the way that the version is specified
in configure.ac.  It is now made out of four parts (major, minor,
release and extra) and constructed for AC_INIT.

Move 'use File::Temp' from virt-inspector program to Sys::Guestfs::Lib.

Version 1.0.57.

Update PO files.

Additional C files for POTFILES.in.

Rename internal subroutines with leading underscore character.

Otherwise Pod::Coverage in the tests will complain that the
internal subroutines are undocumented.

Working version of virt-df.

Fix for returning structures (hashes) from Perl calls.

Calls such as stat and statvfs which returned a single structure
were returning an array of values instead of a full hash of keys +
values.

Fix this by pushing the key names on the stack too.

'$_' should be marked as a local variable in Sys::Guestfs::Lib::open_guest.

Properly close fds and unregister handlers in guestfs_close.

This caused a segfault if you tried to repeatedly open and close
a guestfs handle in the same program.  The reason is that the
old handler remained registered (not always - it was racey).

This adds proper cleanup to the guestfs_close path, also for file
descriptors.

Added framework for 'virt-df' command.

Ignore any file called 'localconfigure'.

Developers should put their custom parameters for configure/autogen.sh
into a script called ./localconfigure, and this script will be ignored
by git and the build system.

Added outline of the virt-v2v script.

Remove virt-inspector --force option - it didn't do anything.

Sys::Guestfs::Lib minor documentation clean-up.

Move the inspection analysis code into Sys::Guestfs::Lib library.

Creates new functions:
  inspect_all_partitions
  inspect_partition
  inspect_operating_systems
  mount_operating_system
  inspect_in_detail

Includes far more documentation for the process.

Move 'resolve_windows_path' to Sys::Guestfs::Lib.

Move 'get_partitions' call into Sys::Guestfs::Lib.

Add Sys::Guestfs::Lib - useful functions for using libguestfs from Perl.

This adds an extra Perl module called Sys::Guestfs::Lib which
adds useful functions for using libguestfs from Perl.

The intention is that common code shared between virt-inspector,
virt-df and virt-v2v will move into this library.

This patch also changes virt-inspector to use this library.

Just whitespace changes in the generator code.

Update with links to the new mailing list.

Fix checking of generator being run from the right directory.

Originally it was looking for 'config.status', but this file
might not exist until configure has been run.  Make it look for
HACKING instead.

Version 1.0.56.

RHEL 5: Mount squashfs with explicit type.

RHEL 5: Skip 'scrub' test if command is not in the initramfs.

RHEL 5: 'mkswap -U' not supported, check before testing it.

Update ocaml/.depend.

RHEL 5: RHEL kernels don't have $arch at the end, so look for non-arch kernels too.

RHEL 5: $(builddir) did not exist with this old autoconf/automake, so workaround.

RHEL 5: for (int i = ...) is not permitted with this old version of GCC.

Merge branch 'master' of git://git.et.redhat.com/libguestfs

Generate structs and struct lists generically.

This modifies the way that struct and struct lists are generated
(for return values) so that there is no need to add an explicit
new type when adding a new structure.

All tests pass, and the C API should be compatible.

I have also inspected the changes that are made to the generated
code by hand.