tools: ship the event-debug tool as an installed libinput-debug-events tool
authorPeter Hutterer <peter.hutterer@who-t.net>
Thu, 30 Apr 2015 02:41:50 +0000 (12:41 +1000)
committerPeter Hutterer <peter.hutterer@who-t.net>
Thu, 30 Apr 2015 09:20:49 +0000 (19:20 +1000)
Rebuild the same binary but without the special LDFLAG. The event-debug tool
is left as-is to allow for easy debugging with gdb, the new tool is now
libtool-enabled and can't be run directly in gdb without installing it first.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
Reviewed-by: Hans de Goede <hdegoede@redhat.com>
tools/.gitignore
tools/Makefile.am
tools/libinput-debug-events.man [new file with mode: 0644]

index e58dba9..cb93429 100644 (file)
@@ -2,3 +2,4 @@ event-debug
 event-gui
 ptraccel-debug
 libinput-list-devices
+libinput-debug-events
index 792f310..6fb797f 100644 (file)
@@ -1,5 +1,5 @@
 noinst_PROGRAMS = event-debug ptraccel-debug
-bin_PROGRAMS = libinput-list-devices
+bin_PROGRAMS = libinput-list-devices libinput-debug-events
 noinst_LTLIBRARIES = libshared.la
 
 AM_CPPFLAGS = -I$(top_srcdir)/include \
@@ -26,6 +26,11 @@ libinput_list_devices_LDADD = ../src/libinput.la libshared.la $(LIBUDEV_LIBS)
 libinput_list_devices_CFLAGS = $(LIBUDEV_CFLAGS)
 dist_man1_MANS = libinput-list-devices.man
 
+libinput_debug_events_SOURCES = $(event_debug_SOURCES)
+libinput_debug_events_LDADD = $(event_debug_LDADD)
+libinput_debug_events_CFLAGS = $(event_debug_CFLAGS)
+dist_man1_MANS = libinput-debug-events.man
+
 if BUILD_EVENTGUI
 noinst_PROGRAMS += event-gui
 
diff --git a/tools/libinput-debug-events.man b/tools/libinput-debug-events.man
new file mode 100644 (file)
index 0000000..bb39399
--- /dev/null
@@ -0,0 +1,31 @@
+.TH LIBINPUT-DEBUG-EVENTS "1"
+.SH NAME
+libinput-debug-events \- debug helper for libinput
+.SH SYNOPSIS
+.B libinput-debug-events [--help]
+.SH DESCRIPTION
+.PP
+The
+.I libinput-debug-events
+tool creates a libinput context and prints all events from these devices.
+.PP
+This is a debugging tool only, its output may change at any time. Do not
+rely on the output.
+.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
+.PP
+For all other options, see the output from --help. Options may be added or
+removed at any time.
+.SH NOTES
+.PP
+Events shown by this tool may not correspond to the events seen by a
+different user of libinput. This tool initializes a separate context.
+.PP
+Events shown by this tool include key codes in plain text. Anything you type
+while this tool is running will show up in the output, including your
+passwords.