libguestfs-test-tool(1)     Virtualization Support     libguestfs-test-tool(1)


<?><?><?> (NAME)
       libguestfs-test-tool - <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> libguestfs

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
        libguestfs-test-tool [--options]

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> libguestfs-test-tool <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> libguestfs <?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> libguestfs
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>. <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> libguestfs <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> qemu <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
       libguestfs <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>:

        libguestfs-test-tool

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?>.

       <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>:

        ===== TEST FINISHED OK =====

       <?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> 0
       <?><?><?><?> <?><?><?><?><?> <?><?>.

       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> (<?>/<?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>)<?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?>. <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       http://libguestfs.org <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       --help
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?>
           <?><?><?><?>.

       --qemu qemu_binary
           <?><?><?> <?><?> <?><?><?><?><?><?> qemu <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?><?> <?><?><?>.

       --qemudir qemu_source_dir
           <?><?><?> qemu <?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?>.

       -t N
       --timeout N
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> "N"
           <?><?><?><?><?>. <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> (<?><?> <?><?><?><?><?>) <?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?>.

       -V
       --version
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> libguestfs <?>
           <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> QEMU (TRYING OUT A
       DIFFERENT VERSION OF QEMU)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> qemu <?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> --qemudir
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> qemu <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> qemu <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       --qemu <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> qemu (<<QEMU WRAPPERS>>
       <?><?> guestfs(3)) <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> libguestfs-test-tool <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (TRYING OUT A DIFFERENT
       KERNEL)
       <?><?><?><?><?><?><?><?><?> <?><?> supermin <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       "SUPERMIN_KERNEL"<?> "SUPERMIN_KERNEL_VERSION" <?>/<?><?>
       "SUPERMIN_MODULES" <?><?><?><?><?> <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <<ENVIRONMENT
       VARIABLES>> <?><?> supermin(1) <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> LIBVIRT (TRYING
       OUT A DIFFERENT VERSION OF LIBVIRT)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> libguestfs <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?>:

        unset LIBGUESTFS_BACKEND
        guestfish get-backend

       <?><?><?> <?><?> <?><?><?><?><?><?> libvirt <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?> (<?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>):

        killall libvirtd lt-libvirtd
        ~/path/to/libvirt/run libguestfs-test-tool

       <?><?> <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> upstream) <?><?> libvirt <?><?>
       <?><?><?><?><?><?> <?><?><?><?>.  <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> "libvirtd" <?><?> <?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?> "run" <?><?><?><?><?> <?><?>
       libvirt (<?><?> <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> libvirt) <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       libvirt <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> LIBVIRT (TRYING OUT WITH /
       WITHOUT LIBVIRT)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> libguestfs <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>:

        unset LIBGUESTFS_BACKEND
        guestfish get-backend

       <?><?><?> <?><?> <?><?><?><?><?><?> libvirt <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> libvirt (<?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       qemu <?><?><?><?> libguestfs) <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?>:

        export LIBGUESTFS_BACKEND=direct

       <?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       (direct) <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> libvirt <?><?> <?><?><?><?><?><?>
       <?><?><?><?>:

        export LIBGUESTFS_BACKEND=libvirt

       <?><?> <?><?> libvirt <?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> (URI) <?><?><?>:

        export LIBGUESTFS_BACKEND=libvirt:qemu:///session

<?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> SELINUX (TRYING OUT
       DIFFERENT SELINUX SETTINGS)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> libguestfs <?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>:

        unset LIBGUESTFS_BACKEND
        guestfish get-backend

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> SELinux
       <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?>:

        getenforce

       <?><?><?> <?><?> libvirt<?> SELinux <?> sVirt <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> SELinux
       <?><?> <<permissive>> (<?><?><?><?><?><?><?><?>) <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?>:

        setenforce Permissive

       <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       (audit logs) <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       (<<AVCs>>) <?><?><?><?><?><?>:

        ausearch -m avc -ts recent

       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> audit2allow(1)
       <?><?><?><?><?><?><?><?> AVC <?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> SELinux <?><?><?><?><?>
       <?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <<Security Enhanced Linux User Guide>> <?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> SELinux <?>
       sVirt<?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>:

        setenforce Enforcing

<?><?><?><?><?><?><?><?><?><?><?> (SELF-DIAGNOSIS)
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> libguestfs-test-tool <?>/<?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <<APPLIANCE BOOT PROCESS>> <?><?> guestfs(3) <?><?><?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?><?><?> libguestfs-test-tool <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> 0 <?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> 1 <?><?> <?><?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> <?><?><?><?><?> (ENVIRONMENT VARIABLES)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?> libguestfs
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> guestfs(3) <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       guestfs(3), http://libguestfs.org, http://qemu.org

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       Richard W.M. Jones ("rjones at redhat dot com")

<?><?> <?><?><?> (COPYRIGHT)
       Copyright (C) 2009-2025 Red Hat Inc.

<?><?><?><?> (LICENSE)
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> (GNU General Public License)
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?> <?><?><?><?> <?><?> (<?><?> <?><?><?><?><?><?>
       <?><?><?>) <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?>/<?><?> <?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>.

       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>:
       Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
       Boston, MA 02110-1301 USA.

<?><?><?><?><?><?><?> (BUGS)
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> libguestfs<?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>:
       https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       libguestfs<?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>:
       https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>:

       o   <?><?><?><?> libguestfs.

       o   <?><?><?> <?><?><?><?><?><?> libguestfs (<?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?> <?><?><?><?>)

       o   <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>.

       o   <?><?><?><?><?> libguestfs-test-tool(1) <?><?> <?><?><?><?>
           <?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?> <?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

libguestfs-1.60.1                 2026-07-14           libguestfs-test-tool(1)