%general-entities; ]> $Date$ libinput-&libinput-version; libinput Introduction to libinput libinput is a library that handles input devices for display servers and other applications that need to directly deal with input devices. &lfs112_checked; Package Information Download (HTTP): Download (FTP): Download MD5 sum: &libinput-md5sum; Download size: &libinput-size; Estimated disk space required: &libinput-buildsize; Estimated build time: &libinput-time; libinput Dependencies Required and Optional (to run the tests), (to build the GUI event viewer), (required for tests), , and Sphinx (required to build documentation), PyParsing (for one non-root test) User Notes: kernel configuration for running the libinput testsuite Although libinput works with the same kernel configuration used by , its extensive testsuite requires the presence of /dev/uinput (as well as both and ). If you wish to run the full tests, enable the following option in the kernel configuration and recompile the kernel if necessary: Device Drivers ---> Input device support ---> Miscellaneous Devices ---> <*/M> User level driver support [CONFIG_INPUT_UINPUT] If you build this as a module, it needs to be inserted before the testsuite runs. On an Xorg system you will also need to prevent the events generated during the testsuite from interfering with your desktop. Copy the file test/50-litest.conf into ${XORG_PREFIX}/share/X11/xorg.conf.d and restart X. For further information see libinput test suite. libinput Installation of libinput Install libinput by running the following commands: mkdir build && cd build && meson --prefix=$XORG_PREFIX \ --buildtype=release \ -Ddebug-gui=false \ -Dtests=false \ -Dlibwacom=false \ -Dudev-dir=/usr/lib/udev \ .. && ninja If you want to run the full tests, remove -Dtests from the meson command above. Please read "kernel configuration for running the libinput testsuite" (above). If you have enabled the full tests, you can run the main tests as the root user by executing: ninja test. A very large number of tests will be run, about 20 fail (at least on an Xorg system). Now, as the root user: ninja install If you have passed to meson, you can install the generated documentation by running the following commands as the root user: install -v -dm755 /usr/share/doc/libinput-&libinput-version;/html && cp -rv Documentation/* /usr/share/doc/libinput-&libinput-version;/html Command Explanations -Ddebug-gui=false: This switch disables creation of a visual debug helper for libinput. Remove if you want it, and you have installed. -Dtests=false: This switch disables compilation of the main tests. Even with the tests defined as false, you can still run the first four minor tests, as a regular user, but one will be skipped if PyParsing is not installed. -Dlibwacom=false: Remove this option if you have installed, or if you are installing GNOME. -Dudev-dir=/usr/lib/udev: In case that the value of XORG_PREFIX is not set to /usr, this option prevents the package from installing Udev rules and helpers into $XORG_PREFIX/lib/udev which is not searched by Udev daemon. This option is not needed for systems with XORG_PREFIX set to /usr, but does no harm. : This switch enables generation of the documentation. Add it if you want to generate the documentation. You must have and installed. Contents Installed Programs Installed Libraries Installed Directories libinput libinput.so /etc/libinput, $XORG_PREFIX/libexec/libinput, $XORG_PREFIX/usr/share/libinput, and (optionally) $XORG_PREFIX/share/doc/libinput-&libinput-version; Short Descriptions libinput is a set of tools to interface with the libinput library libinput libinput.so contains API functions for handling input devices libinput.so