NAME¶
libguestfs-test-tool - Diagnostics for libguestfs
SYNOPSIS¶
libguestfs-test-tool [--options]
DESCRIPTION¶
libguestfs-test-tool is a test program shipped with libguestfs to allow you to
check basic libguestfs functionality is working. This is needed because
libguestfs occasionally breaks for reasons beyond our control: usually because
of changes in the underlying qemu or kernel packages, or the host environment.
If you suspect a problem in libguestfs, then just run:
libguestfs-test-tool
It will print lots of diagnostic messages.
If it runs to completion successfully, you will see this near the end:
===== TEST FINISHED OK =====
and the test tool will exit with code 0.
If it fails (and/or exits with non-zero error code), please paste the
complete, unedited output of the test tool into a bug report. More
information about reporting bugs can be found on the
<
http://libguestfs.org/> website.
OPTIONS¶
- --help
- Display short usage information and exit.
- --qemu qemu_binary
- If you have downloaded another qemu binary, point this
option at the full path of the binary to try it.
- --qemudir qemu_source_dir
- If you have compiled qemu from source, point this option at
the source directory to try it.
- -t N
- --timeout N
- Set the launch timeout to "N" seconds. The
default is 600 seconds (10 minutes) which does not usually need to be
adjusted.
- -V
- --version
- Display the libguestfs version number and exit.
TRYING OUT A DIFFERENT VERSION OF QEMU¶
If you have compiled another version of qemu from source and would like to try
that, then you can use the
--qemudir option to point to the qemu source
directory.
If you have downloaded a qemu binary from somewhere, use the
--qemu
option to point to the binary.
Note when using these options, you can ignore the business of qemu wrapper
scripts ("QEMU WRAPPERS" in
guestfs(3)), since
libguestfs-test-tool writes a wrapper script for you if one is needed.
TRYING OUT A DIFFERENT KERNEL¶
If you are using febootstrap ≥ 3.8 then you can select which kernel
libguestfs tries. You do this by setting the environment variables
"FEBOOTSTRAP_KERNEL" and/or "FEBOOTSTRAP_MODULES".
Refer to "ENVIRONMENT VARIABLES" in
febootstrap-supermin-helper(8) for further information.
SELF-DIAGNOSIS¶
Refer to "APPLIANCE BOOT PROCESS" in
guestfs(3) to understand
the messages produced by libguestfs-test-tool and/or possible errors.
EXIT STATUS¶
libguestfs-test-tool returns
0 if the tests completed without error, or
1 if there was an error.
ENVIRONMENT VARIABLES¶
For the full list of environment variables which may affect libguestfs, please
see the
guestfs(3) manual page.
SEE ALSO¶
guestfs(3), <
http://libguestfs.org/>, <
http://qemu.org/>.
AUTHORS¶
Richard W.M. Jones ("rjones at redhat dot com")
COPYRIGHT¶
Copyright (C) 2009-2012 Red Hat Inc. <
http://libguestfs.org/>
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
Street, Fifth Floor, Boston, MA 02110-1301 USA.
