qemu-sanity-check is a short shell script that test-boots a Linux
kernel under qemu, making sure it boots up to userspace.  The idea is
to test the Linux kernel and/or qemu to make sure they are working.

Please read the qemu-sanity-check(1) man page, but basic usage is very
simple.  You probably want to use one of the following commands:

Test qemu on path against most recent installed Linux kernel in /boot:

  qemu-sanity-check

Test a given qemu binary with a given Linux kernel (you can omit
either option):

  qemu-sanity-check --qemu=/path/to/qemu --kernel=/path/to/vmlinuz

License
-------

The shell script is licensed under the GNU General Public License,
version 2 or (at your option) a later version.  See 'COPYING' for the
full license.

Author
------

Richard W.M. Jones <rjones@redhat.com>

Building
--------

Requirements:

  bash - to run the script

  gcc - to compile the helper program

  static libc - to link the helper program statically

  cpio - to build the initramfs

  qemu and/or Linux kernel - something to test

  pod2man (from Perl) - if you want to build the manual page

To build:

  From git:                     From tarball:
    autoreconf -i
    ./configure                   ./configure
    make                          make
    make check                    make check

Developers
----------

Upstream git repository is:
http://git.annexia.org/?p=qemu-sanity-check.git;a=summary

Please send patches etc to the qemu-devel mailing list:
https://lists.nongnu.org/mailman/listinfo/qemu-devel
(but also CC the author).
