Whitespace and comment changes.

df: Fix alignment of columns.

guestfish: Make more strings translatable.

However this doesn't yet attempt to translate the POD
command documentation.  We need a plan to do that.

tests: Use squashfs for static data where possible.

Instead of creating a new InitBasicFS for just about every test,
where a test doesn't need to write to the filesystem it is far
faster to use prepared data on an InitSquashFS instead.

This commit changes as many tests as possible to make this so,
making the tests much faster.

tests: Fix read_file test.

The test ignored the fact that this function returns a (char *, size_t)
pair, and just treated the char * as a string.  This of course would
fail if the string didn't happen to be nul-terminated.

The tests are updated to add a new TestOutputBuffer type which should
be used with functions that return RBufferOut.

Implement '*grep*' family of commands.

Updated Polish translations (Piotr Drąg).

Version 1.0.65.

Updated PO files.

build: avoid locale-specific changes in generated, VC'd file

When I build with LC_ALL=C in my environment,
the all-local rule generates po/POTFILES.in that
is sorted differently from the on that is checked in:

    diff --git a/po/POTFILES.in b/po/POTFILES.in
    index ca01b3d..154915a 100644
    --- a/po/POTFILES.in
    +++ b/po/POTFILES.in
    @@ -63,12 +63,11 @@ fish/tilde.c
     fish/time.c
     inspector/virt-inspector.pl
     java/com_redhat_et_libguestfs_GuestFS.c
    -ocaml/guestfs_c_actions.c
     ocaml/guestfs_c.c
    +ocaml/guestfs_c_actions.c
     perl/bindtests.pl
    -perl/Guestfs.c
    -perl/lib/Sys/Guestfs/Lib.pm
     perl/lib/Sys/Guestfs.pm
    +perl/lib/Sys/Guestfs/Lib.pm
     python/guestfs-py.c
     ruby/ext/guestfs/_guestfs.c
     src/guestfs-actions.c

If we generate that file so that sort always uses the C locale, then,
this type of difference will not arise.  Here's the patch to fix the
rule as well as to reflect the change in the generated file:

>From 609e1d1840da25614a7c9e8954e5356050c9f2ad Mon Sep 17 00:00:00 2001
From: Jim Meyering <meyering@redhat.com>
Date: Wed, 29 Jul 2009 08:13:35 -0400
Subject: [PATCH] build: avoid locale-specific changes in generated, VC'd file

* Makefile.am (all-local): Use LC_ALL=C to sort in C locale.
* po/POTFILES.in: Regenerate.

On RHEL 5, 'file' command prints 'AMD x86-64' for 'x86-64' arch.

Run cpio with --quiet option so it doesn't print 'xx blocks'

Lib.pm: Skip tests if perl-libintl module is not available.

Lib.pm: Use Perl backtick instead of slurp (Aron Griffis).

Don't show empty CD devices (RHBZ#514505).

ocaml: Rebuild the tests from source if the main library changes.

inspector: Determine guest architecture.

This commit adds kernel and userspace architecture detection
(fully for Linux, partially for Windows).  It adds an architecture
for each kernel detected, and an architecture for each root (ie.
userspace) found.

Lib.pm: Add file_architecture command.

This command detects the architecture of some types of binaries,
libraries, kernel modules and initrd images.

Lib: Document the $ro parameter for mount_operating_system properly.

Mention related tools in the manual page.

Whitespace: indent some names in images/Makefile.am correctly.

Lib.pm: Use 'file' as replacement for 'zfile'.

Pass '-z' parameter to 'file' command so it looks inside compressed files.

Also we deprecate the old 'zfile' command.

Add DeprecatedBy flag to mark functions which are deprecated.

Need to declare asprintf_nowarn as inline to avoid gcc complaining.

Replace shell_quote function with %Q and %R printf specifiers.

%Q => simple shell quoted string
%R => path will be prefixed by /sysroot

eg. snprintf (cmd, sizeof cmd, "cat %R", path); system (cmd);

Add InitSquashFS test type, for tests that just use the squashfs (/dev/sdd).

This also speeds up those tests because we don't have to wait
to create a filesystem which is never used.

Make read-only optional in mount_operating_system()

More ideas on a quick Perl one-liner syntax for TODO file.

guestfish -iv should print virt-inspector command (for debugging).

Reformat the TODO file.

Pass cgroup_disable=memory, saves ~ 5MB of RAM.

get_append call can return NULL, but bindings didn't handle it.

It's not a good idea because there is no way to return an error
indication.  However at least this means it won't segfault.

RHEL 5 thinks squashfs is HFS+ filesystem, unless we specify the type explicitly.

Remove hard-coded qemu-kvm, replace with $QEMU.

Version 1.0.63

Add libguestfs-test-tool.

This is an end-user testing tool, designed to test basic functionality
of libguestfs/qemu/kernel combination on the end-user's final host
machine.

It does not perform a thorough test, but should be enough to find
most booting issues.

Also this is intended to be used when reporting bugs.

Fix typo in error message.

Revert "Add 'set-kernel'/'get-kernel'/LIBGUESTFS_KERNEL to override appliance kernel."

This reverts commit 34d2df41626f1ee4172a6d40b06d72d6ed9d6348.

set-append and set-kernel parameters are both nullable.

(So are the return values, but leave that bug for another day).

Add 'set-kernel'/'get-kernel'/LIBGUESTFS_KERNEL to override appliance kernel.

This allows you to override the appliance kernel with an easy
command or environment variable.

Todo: Suggestion for 'replace' command.

Add commented-out support for alternate guestfwd syntax.

This commit just moves code around.  The new support is not enabled
because it doesn't work.  See qemu-devel, subject
"guestfwd option doesn't allow supplementary ,server,nowait"

configure: Detect new-style guestfwd support (RHBZ#512957)

However new qemu 0.10.5 still doesn't work.

Library: Pass more options on the Linux kernel command line.

Always pass:
  noapic             (APIC causes problems for lots of people)
  udevtimeout=300    (for very slow qemu using softemu)
  acpi=off           (ACPI is troublesome and unnecessary, so turn it off)

Split $os->{version} into $os->{major_version} and $os->{minor_version}

Allow TMPDIR to override directory used for temporary files (RHBZ#512905).

Generator: Implement RBufferOut and "read-file" call.

This commit implements the RBufferOut type for returning
arbitrary 8 bit data from calls.

We also implement the guestfs_read_file call to read a
whole file that can contain any 8 bit content, but up to
a limit of ~ 2 MB.

Docs: Fully document the guestfs_readdir ftyp return field.

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.