evtest-capture.txt

   1 EVTEST-CAPTURE(1)
   2 =================
   3
   4 NAME
   5 ----
   6
   7      evtest-capture - Input device event capture program
   8
   9 SYNOPSIS
  10 --------
  11      evtest-capture "/dev/input/eventX" [evtest-capture.xml]
  12
  13 DESCRIPTION
  14 -----------
  15 evtest-capture captures the information and events from the input device
  16 specified on the command line and writes it to the xml file given. If no
  17 filename is given for the output file, evtest-capture.xml is chosen as
  18 default.
  19
  20 evtest-capture needs to be able to read from the device; in most cases this means it
  21 must be run as root.
  22
  23 Together with with evtest-create-device.xsl, a simple uinput-based software
  24 input device can be created that replays the events as if the same input was
  25 performed on the physical device. This can be useful to replicate bugs with
  26 input devices in upper layers of the stack.
  27
  28 To convert evtest-capture.xml into such a uinput device, run:
  29
  30      xsltproc evtest-create-device.xls evtest-capture.xml > mydevice.c
  31      gcc -o mydevice mydevice.c
  32      ./mydevice
  33
  34
  35 DIAGNOSTICS
  36 -----------
  37 If evtest-capture does not see any events even though the device is being
  38 used, the device may be grabbed by a process (EVIOCGRAB).  This is usually the
  39 case when debugging a synaptics device from within X. VT switching to a TTY or
  40 shutting down the X server terminates this grab and synaptics devices can be
  41 debugged.
  42
  43 SEE ALSO
  44 --------
  45 evtest(1)
  46
  47 AUTHOR
  48 ------
  49 evtest-capture was written by Peter Hutterer <peter.hutterer@redhat.com>.