libinput-list-devices.man 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152
  1. .TH libinput-list-devices "1" "" "libinput @LIBINPUT_VERSION@" "libinput Manual"
  2. .SH NAME
  3. libinput\-list\-devices \- list local devices as recognized by libinput and
  4. default values of their configuration
  5. .SH SYNOPSIS
  6. .B libinput list\-devices [\-\-help]
  7. .PP
  8. .B libinput list\-devices \fI/dev/input/event0\fB [\fI/dev/input/event1\fB...]
  9. .SH DESCRIPTION
  10. .PP
  11. The
  12. .B "libinput list\-devices"
  13. tool creates a libinput context on the default seat "seat0" and lists
  14. devices recognized by libinput. Each device shows available configurations
  15. the respective default configuration setting.
  16. .PP
  17. For options that allow more settings than "enabled/disabled", all available ones
  18. are listed. The default setting is prefixed by an asterisk (*).
  19. .PP
  20. If one or more event node paths are given, only those devices are listed.
  21. By default all devices recognized by libinput are listed.
  22. .PP
  23. This tool usually needs to be run as root to have access to the
  24. /dev/input/eventX nodes.
  25. .SH OPTIONS
  26. .TP 8
  27. .B \-\-help
  28. Print help
  29. .TP 8
  30. .B \-\-verbose
  31. Use verbose output
  32. .SH NOTES
  33. .PP
  34. libinput\-list\-devices only lists available configuration options for
  35. a feature. In some cases a device may support a specific feature but
  36. does not expose configuration for it, e.g. when using the
  37. device without that particular feature does not make sense.
  38. A lack of a configuration option thus does not
  39. necessarily mean that this feature does not work.
  40. .PP
  41. A device may be recognized by libinput but not handled by the X.Org libinput
  42. driver or the Wayland compositor.
  43. .PP
  44. An xorg.conf(5) configuration entry or Wayland compositor setting may have
  45. changed configurations on a device. The
  46. .B "libinput list\-devices"
  47. tool only shows the device's default configuration, not the current
  48. configuration.
  49. .SH LIBINPUT
  50. Part of the
  51. .B libinput(1)
  52. suite