1libinput-test-suite(1)          libinput Manual         libinput-test-suite(1)
2
3
4

NAME

6       libinput-test-suite - run the libinput test suite
7

SYNOPSIS

9       libinput test-suite [OPTIONS]
10

DESCRIPTION

12       The libinput test-suite command runs the libinput test suite.  Its pri‐
13       mary purpose is to verify distribution composes after package  updates.
14       Test  suite failures usually indicate missing patches and/or incompati‐
15       ble lower system layers.
16
17       The test suite should not be run by users. Data loss is possible.
18
19       The test suite must be run as root. The  test  suite  installs  several
20       files  on the host system (see section FILES), runs system commands and
21       creates virtual kernel devices via uinput. These devices will interfere
22       with any active session and may cause data loss.
23
24       It  is  recommended  that  the  test  suite is run in a virtual machine
25       and/or on a system not otherwise in use. A graphical environment is not
26       required to run the test suite.
27
28

OPTIONS

30       Note  that  the options may change in future releases of libinput. Test
31       names, test device names and test group names may change at any time.
32
33       --filter-test "testname"
34               A glob limiting the tests to run. Specifying a filter sets  the
35               --jobs default to 1.
36
37       --filter-device "devicename"
38               A glob limiting the devices to run tests for. Specifying a fil‐
39               ter sets the --jobs default to 1.
40
41       --filter-group "groupname"
42               A glob limiting the tests to (arbitrarily named) groups. Speci‐
43               fying a filter sets the --jobs default to 1.
44
45       --filter-deviceless
46               FOR INTERNAL USE ONLY
47
48       -h, --help
49               Print help
50
51       -j, --jobs 8
52               Number of parallel processes to run. Default: 8.
53
54       --list  List  all  test  cases  and  the devices they are run for. Test
55               names, test device names and test group names may change at any
56               time.
57
58       --verbose
59               Enable verbose output, including libinput debug messages.
60

FILES

62       The following directories are modified:
63
64
65       /usr/share/libinput
66               Test  device-specific  quirks  are  installed in this directory
67               with a custom prefix. Files in this directory are untouched but
68               new  files  are  installed  and removed on exit. Existing files
69               (e.g. from a previous aborted run) with the same name  will  be
70               silently overwritten and removed.
71
72       /run/udev/rules.d
73               Test-specific  udev  rules  are installed in this directory and
74               removed on exit.
75

SYSTEM SETUP

77       The xorg.conf.d(5) snippet below ensures the X server ignores the  test
78       devices created by this test suite:
79
80           Section "InputClass"
81                   Identifier "Ignore libinput test suite devices"
82                   MatchProduct "litest"
83                   Option "Ignore" "on"
84           EndSection
85
86       No  configuration  is  required for Wayland compositors. libinput's de‐
87       fault mode will ignore test devices from this test suite.
88

BUGS

90       Some tests are sensitive to timing. Where a system is under heavy load,
91       a test may fail. Re-running the test with --filter-test can help verify
92       whether a test case failure was a true failure.
93

LIBINPUT

95       Part of the libinput(1) suite
96
97
98
99libinput 1.21.0                                         libinput-test-suite(1)
Impressum