mirror of
https://gitlab.freedesktop.org/libinput/libinput.git
synced 2025-12-20 15:00:05 +01:00
e9fc59efc8
Chaining args together inside a single binary would be nice, but it gets nasty quickly (as I found out adding 3, 4 extra commands). Switch over to using a git-style exec-ing command where libinput merely changes argv[0] and then executes whatever it assembled. And those binaries can hide in libexec so they don't clutter up the global namespace. This also makes it a lot easier to write man pages, adopt the same style as git uses. Compatibilty wrapper scripts are provided for libinput-list-devices and libinput-debug events. These warn the user about the changed command, then exec the new one. Expect these wrappers to be removed at some point in the future. Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
41 lines
1.3 KiB
Groff
41 lines
1.3 KiB
Groff
.TH LIBINPUT-LIST-DEVICES "1"
|
|
.SH NAME
|
|
libinput-list-devices \- list local devices as recognized by libinput
|
|
.SH SYNOPSIS
|
|
.B libinput list-devices [--help]
|
|
.SH DESCRIPTION
|
|
.PP
|
|
The
|
|
.B "libinput list-devices"
|
|
tool creates a libinput context on the default seat "seat0" and lists all
|
|
devices recognized by libinput. Each device shows available configurations
|
|
the respective default configuration setting.
|
|
.PP
|
|
For configuration options that allow multiple different settings
|
|
(e.g. scrolling), all available settings are listed. The default setting is
|
|
prefixed by an asterisk (*).
|
|
.PP
|
|
This tool usually needs to be run as root to have access to the
|
|
/dev/input/eventX nodes.
|
|
.SH OPTIONS
|
|
.TP 8
|
|
.B --help
|
|
Print help
|
|
.SH NOTES
|
|
.PP
|
|
Some specific feature may still be available on a device even when
|
|
no configuration is exposed, a lack of a configuration option does not
|
|
necessarily mean that this feature does not work.
|
|
.PP
|
|
A device may be recognized by libinput but not handled by the X.Org libinput
|
|
driver or the Wayland compositor.
|
|
.PP
|
|
An xorg.conf(5) configuration entry or Wayland compositor setting may have
|
|
changed configurations on a device. The
|
|
.B "libinput list-devices"
|
|
tool only shows the device's default configuration, not the current
|
|
configuration.
|
|
.SH LIBINPUT
|
|
Part of the
|
|
.B libinput(1)
|
|
suite
|