evtest.txt

   1 EVTEST(1)
   2 =========
   3
   4 NAME
   5 ----
   6
   7      evtest - Input device event monitor and query tool
   8
   9 SYNOPSIS
  10 --------
  11      evtest [--grab] /dev/input/eventX
  12
  13      evtest --query /dev/input/eventX <type> <value>
  14
  15 DESCRIPTION
  16 -----------
  17 The first invocation type displayed above ("capture mode") causes evtest to
  18 display information about the specified input device, including all the events
  19 supported by the device. It then monitors the device and displays all the
  20 events layer events generated.
  21
  22 If the --grab flag is given in capture mode, evtest keeps an EVIOCGRAB on the
  23 device. While this grab is active, other processes will not receive events
  24 from the kernel devices. The grab is released again when evtest quits.
  25
  26 In the second invocation type ("query mode"), evtest performs a one-shot query
  27 of the state of a specific key *value* of an event *type*.
  28
  29 *type* is one of: *EV_KEY*, *EV_SW*, *EV_SND*, *EV_LED* (or the numerical value)
  30
  31 *value* can be either a decimal representation (e.g. 44), hex
  32 (e.g. 0x2c), or the constant name (e.g. KEY_Z) of the key/switch/sound/LED
  33 being queried.
  34
  35 If the state bit is set (key pressed, switch on, ...), evtest exits with
  36 code 10. If the state bit is unset (key depressed, switch off, ...), evtest
  37 exits with code 0. No other output is generated.
  38
  39 evtest needs to be able to read from the device; in most cases this means it
  40 must be run as root.
  41
  42 evtest is commonly used to debug issues with input devices in X.Org. The
  43 output of evtest shows the information presented by the kernel; based on
  44 this information it can be determined whether a bug may be a kernel or an
  45 X.Org issue.
  46
  47 DIAGNOSTICS
  48 -----------
  49 If evtest does not show any events even though the device is being used, the
  50 device may be grabbed by a process (EVIOCGRAB).  This is usually the case
  51 when debugging a synaptics device from within X. VT switching to a TTY or
  52 shutting down the X server terminates this grab and synaptics devices can be
  53 debugged.
  54
  55 The following command shows the processes with an open file descriptor on
  56 the device:
  57
  58    fuser -v /dev/input/eventX
  59
  60 EXIT CODE
  61 ---------
  62 evtest returns 1 on error.
  63
  64 When used to query state, evtest returns 0 if the state bit is unset and
  65 10 if the state bit is set.
  66
  67 SEE ALSO
  68 --------
  69 inputattach(1)
  70
  71 AUTHOR
  72 ------
  73 evtest was written by Vojtech Pavlik <vojtech@suse.cz>.
  74
  75 This manual page was written by Stephen Kitt <steve@sk2.org>, based on that
  76 present in the lineakd package, for the Debian GNU/Linux system (but may be
  77 used by others).
  78