libinput-test-suite - run the libinput test suite
Contents
Bugs
Some tests are sensitive to timing. Where a system is under heavy load, a test may fail. Re-running the
test with --filter-test can help verify whether a test case failure was a true failure.
Description
The libinputtest-suite command runs the libinput test suite. Its primary purpose is to verify
distribution composes after package updates. Test suite failures usually indicate missing patches and/or
incompatible lower system layers.
Thetestsuiteshouldnotberunbyusers.Datalossispossible.
The test suite must be run as root. The test suite installs several files on the host system (see section
FILES), runs system commands and creates virtual kernel devices via uinput. These devices will interfere
with any active session and may cause data loss.
It is recommended that the test suite is run in a virtual machine and/or on a system not otherwise in
use. A graphical environment is not required to run the test suite.
Files
The following directories are modified:
/usr/share/libinput
Test device-specific quirks are installed in this directory with a custom prefix. Files in this
directory are untouched but new files are installed and removed on exit. Existing files (e.g.
from a previous aborted run) with the same name will be silently overwritten and removed.
/run/udev/rules.d
Test-specific udev rules are installed in this directory and removed on exit.
Libinput
Part of the libinput(1) suite
libinput 1.27.1 libinput-test-suite(1)
Name
libinput-test-suite - run the libinput test suite
Options
Note that the options may change in future releases of libinput. Test names, test device names and test
group names may change at any time.
--filter-test"testname"
A glob limiting the tests to run. Specifying a filter sets the --jobs default to 1.
--filter-device"devicename"
A glob limiting the devices to run tests for. Specifying a filter sets the --jobs default to 1.
--filter-group"groupname"
A glob limiting the tests to (arbitrarily named) groups. Specifying a filter sets the --jobs
default to 1.
--filter-devicelessFORINTERNALUSEONLY-h,--help
Print help
-j,--jobs8
Number of parallel processes to run. Default: 8.
--list List all test cases and the devices they are run for. Test names, test device names and test
group names may change at any time.
--verbose
Enable verbose output, including libinput debug messages.
Synopsis
libinputtest-suite[OPTIONS]
System Setup
The xorg.conf.d(5) snippet below ensures the X server ignores the test devices created by this test
suite:
Section"InputClass"Identifier"Ignorelibinputtestsuitedevices"MatchProduct"litest"Option"Ignore""on"EndSection
No configuration is required for Wayland compositors. libinput's default mode will ignore test devices
from this test suite.
