test_key: add small helper for client-side key-input

We sometimes need to test what keys a client receives when specific keys
are pressed. This small helper simply runs in a terminal and receives raw
keyboard input and prints it to stdout with debugging information.

This can definitely be improved with the help of the TSM state-machine to
print more useful information and directly parse the input. However, this
is better than nothing.

Signed-off-by: David Herrmann <dh.herrmann@googlemail.com>

Makefile.am

@@ -28,10 +28,7 @@ pkgconfig_DATA =
 
 bin_PROGRAMS = \
 	kmscon
-check_PROGRAMS = \
-	test_output \
-	test_vt \
-	test_input
+check_PROGRAMS =
 noinst_PROGRAMS = \
 	genshader \
 	genunifont
@@ -389,11 +386,17 @@ kmscon_LDADD = \
 	libeloop.la \
 	libkmscon-core.la
 
+check_PROGRAMS += test_output
 test_output_SOURCES = tests/test_output.c tests/test_include.h
 test_output_LDADD = libkmscon-core.la
 
+check_PROGRAMS += test_vt
 test_vt_SOURCES = tests/test_vt.c
 test_vt_LDADD = libkmscon-core.la
 
+check_PROGRAMS += test_input
 test_input_SOURCES = tests/test_input.c
 test_input_LDADD = libkmscon-core.la
+
+check_PROGRAMS += test_key
+test_key_SOURCES = tests/test_key.c

tests/test_key.c

@@ -0,0 +1,78 @@
+/*
+ * test_key - Test client key-input
+ *
+ * Copyright (c) 2012 David Herrmann <dh.herrmann@googlemail.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files
+ * (the "Software"), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included
+ * in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+
+#include <errno.h>
+#include <stdbool.h>
+#include <stdio.h>
+#include <string.h>
+#include <termios.h>
+
+int main()
+{
+	int res;
+	unsigned char buf;
+	struct termios omode, nmode;
+	bool reset = false;
+
+	fprintf(stderr, "Quit with 'q' (maybe followed by 'enter'/'return')\r\n");
+	fprintf(stderr, "Maybe your terminal may be unusable after this, use 'reset' to fix it\r\n");
+
+	if (tcgetattr(0, &omode) < 0) {
+		fprintf(stderr, "cannot retrieve terminal attributes (%d): %m\r\n",
+			errno);
+	} else {
+		memcpy(&nmode, &omode, sizeof(nmode));
+		cfmakeraw(&nmode);
+		if (tcsetattr(0, TCSANOW, &nmode) < 0)
+			fprintf(stderr, "cannot set terminal attributes (%d): %m\r\n",
+				errno);
+		else
+			reset = true;
+	}
+
+	while (1) {
+		res = fread(&buf, 1, 1, stdin);
+		if (res != 1) {
+			fprintf(stderr, "error on stdin: %d %d: %m\r\n",
+				res, errno);
+			break;
+		}
+
+		if (buf == '\n')
+			fprintf(stderr, "key: <newline>\r\n");
+		else
+			fprintf(stderr, "key: %x %u %o '%c'\r\n",
+				(int)buf, buf, buf, buf);
+
+		if (buf == 'q')
+			break;
+	}
+
+	if (reset && tcsetattr(0, TCSANOW, &omode) < 0)
+		fprintf(stderr, "cannot reset terminal attributes (%d): %m\r\n",
+			errno);
+
+	return 0;
+}