You will need a Fedora 18 host.  A fast physical machine with KVM is
usually required.

SELinux must be set to Permissive (RHBZ#896685).

Install libguestfs build dependencies:

  sudo yum-builddep libguestfs

Clone libguestfs from git:

  git clone git://github.com/libguestfs/libguestfs.git
  cd libguestfs

Create the following two files in the top-level libguestfs directory:

(1) 'localconfigure'
----------------------------------------------------------------------
. localenv

./autogen.sh \
  --prefix /usr \
  --with-default-attach-method=libvirt \
  --enable-gcc-warnings \
  --enable-gtk-doc \
  -C \
  "$@"
----------------------------------------------------------------------

(2) 'localenv'
----------------------------------------------------------------------
# NB: -*- Makefile -*- AND a shell script.

# Skip all tests that involve btrfs because of RHBZ#863978.
export SKIP_TEST_BTRFS_FSCK=1
export SKIP_TEST_BTRFS_SET_SEEDING=1
export SKIP_TEST_BTRFS_FILESYSTEM_SYNC=1
export SKIP_TEST_BTRFS_SUBVOLUME_DELETE=1
export SKIP_TEST_BTRFS_SUBVOLUME_SNAPSHOT=1
export SKIP_TEST_MKFS_BTRFS=1
export SKIP_TEST_BTRFS_DEVICES_SH=1
export SKIP_TEST_BTRFS_SUBVOLUME_DEFAULT_PL=1
export SKIP_TEST_CHARSET_FIDELITY=1
export SKIP_TEST_VIRT_MAKE_FS_BTRFS=1
----------------------------------------------------------------------

Set the permissions on 'localconfigure':

  chmod +x localconfigure

Build it:

  ./localconfigure
  make

The following command does an "is it basically working" test.  It's
not the full test suite, but worth doing anyway:

  make quickcheck

Run the full test suite:

  make check LIBGUESTFS_DEBUG=1 LIBGUESTFS_TRACE=1

The full test suite takes ~ 20 minutes to complete (depending on
hardware, and it's much much slower without KVM).

If you want to run the full test suite against an alternate libvirt
(eg. libvirt from git):

  killall libvirtd lt-libvirtd
  ../libvirt/run make check

Note that the libvirtd session process is persistent, so when changing
to another libvirt, make sure you 'killall libvirtd lt-libvirtd'.

If you want to run a script (eg. guestfish script) using libguestfs
from git, do:

  ./run /tmp/test.sh