/**
* mds — A micro-display server
* Copyright © 2014 Mattias Andrée (maandree@member.fsf.org)
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see .
*/
#include "mds-kkbd.h"
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#define reconnect_to_display() -1 /* TODO */
#ifdef __sparc__
# define GET_LED KIOCGLED
# define SET_LED KIOCSLED
#else
# define GET_LED KDGETLED
# define SET_LED KDSETLED
#endif
#ifdef __sparc__
# define LED_NUM_LOCK 1
# define LED_CAPS_LOCK 8
# define LED_SCRL_LOCK 4
# define LED_COMPOSE 2
#else
# define LED_NUM_LOCK LED_NUM
# define LED_CAPS_LOCK LED_CAP
# define LED_SCRL_LOCK LED_SCR
#endif
#define MDS_KKBD_VARS_VERSION 0
/**
* The name of the keyboard for which its server implements control
*/
#define KEYBOARD_ID "kernel"
/**
* This variable should declared by the actual server implementation.
* It must be configured before `main` is invoked.
*
* This tells the server-base how to behave
*/
server_characteristics_t server_characteristics =
{
.require_privileges = 0,
.require_display = 1,
.require_respawn_info = 0,
.sanity_check_argc = 1,
.fork_for_safety = 1
};
/**
* Value of the ‘Message ID’ header for the next message
*/
static int32_t message_id = 2;
/**
* Buffer for received messages
*/
static mds_message_t received;
/**
* Whether the server is connected to the display
*/
static int connected = 1;
/**
* File descriptor for accessing the keyboard LED:s
*/
static int ledfd = 0;
/**
* Saved LED states
*/
static int saved_leds;
/**
* Saved TTY settings
*/
static struct termios saved_stty;
/**
* Save keyboard mode
*/
static int saved_kbd_mode;
/**
* Keycode remapping table
*/
static int* restrict mapping = NULL;
/**
* The size of `mapping`
*/
static size_t mapping_size = 0;
/**
* Scancode buffer
*/
static int scancode_buf[3] = { 0, 0, 0 };
/**
* The number of elements stored in `scancode_buf`
*/
static int scancode_ptr = 0;
/**
* Message buffer for `send_key`
*/
static char* key_send_buffer = NULL;
/**
* The keyboard listener thread
*/
static pthread_t kbd_thread;
/**
* Whether `kbd_thread` has started
*/
static int kbd_thread_started = 0;
/**
* Mutex that should be used when sending message
*/
static pthread_mutex_t send_mutex;
/**
* This function will be invoked before `initialise_server` (if not re-exec:ing)
* or before `unmarshal_server` (if re-exec:ing)
*
* @return Non-zero on error
*/
int __attribute__((const)) preinitialise_server(void)
{
return 0;
}
/**
* This function should initialise the server,
* and it not invoked after a re-exec.
*
* @return Non-zero on error
*/
int initialise_server(void)
{
int stage = 0;
const char* const message =
"Command: intercept\n"
"Message ID: 0\n"
"Length: 54\n"
"\n"
"Command: set-keyboard-leds\n"
"Command: get-keyboard-leds\n"
/* NEXT MESSAGE */
"Command: intercept\n"
"Message ID: 1\n"
"Modifying: yes\n"
"Length: 59\n"
"\n"
"Command: enumerate-keyboards\n"
"Command: keyboard-enumeration\n";
fail_if (open_leds() < 0);
stage = 1;
fail_if (open_input() < 0);
stage = 2;
fail_if (pthread_mutex_init(&send_mutex, NULL));
stage = 3;
if (full_send(message, strlen(message)))
return 1;
fail_if (server_initialised());
stage = 4;
fail_if (mds_message_initialise(&received));
fail_if (xmalloc(key_send_buffer, 111, char));
return 0;
pfail:
xperror(*argv);
if (stage < 4)
{
if (stage >= 2) close_input();
if (stage >= 1) close_leds();
}
if (stage >= 3)
pthread_mutex_destroy(&send_mutex);
mds_message_destroy(&received);
return 1;
}
/**
* This function will be invoked after `initialise_server` (if not re-exec:ing)
* or after `unmarshal_server` (if re-exec:ing)
*
* @return Non-zero on error
*/
int postinitialise_server(void)
{
if (connected)
return 0;
if (reconnect_to_display())
{
mds_message_destroy(&received);
return 1;
}
connected = 1;
return 0;
}
/**
* This function is called by the parent server process when the
* child server process exits, if the server has completed its
* initialisation
*
* @param status The status the child died with
*/
void fork_cleanup(int status)
{
(void) status;
close_input();
close_leds();
}
/**
* Calculate the number of bytes that will be stored by `marshal_server`
*
* On failure the program should `abort()` or exit by other means.
* However it should not be possible for this function to fail.
*
* @return The number of bytes that will be stored by `marshal_server`
*/
size_t marshal_server_size(void)
{
size_t rc = 9 * sizeof(int) + sizeof(int32_t) + sizeof(struct termios);
rc += sizeof(size_t) + mapping_size * sizeof(int);
rc += mds_message_marshal_size(&received);
return rc;
}
/**
* Marshal server implementation specific data into a buffer
*
* @param state_buf The buffer for the marshalled data
* @return Non-zero on error
*/
int marshal_server(char* state_buf)
{
buf_set_next(state_buf, int, MDS_KKBD_VARS_VERSION);
buf_set_next(state_buf, int, connected);
buf_set_next(state_buf, int32_t, message_id);
buf_set_next(state_buf, int, ledfd);
buf_set_next(state_buf, int, saved_leds);
buf_set_next(state_buf, struct termios, saved_stty);
buf_set_next(state_buf, int, saved_kbd_mode);
buf_set_next(state_buf, int, scancode_ptr);
buf_set_next(state_buf, int, scancode_buf[0]);
buf_set_next(state_buf, int, scancode_buf[1]);
buf_set_next(state_buf, int, scancode_buf[2]);
buf_set_next(state_buf, size_t, mapping_size);
if (mapping_size > 0)
{
memcpy(state_buf, mapping, mapping_size * sizeof(int));
state_buf += mapping_size * sizeof(int) / sizeof(char);
}
mds_message_marshal(&received, state_buf);
mds_message_destroy(&received);
free(mapping);
return 0;
}
/**
* Unmarshal server implementation specific data and update the servers state accordingly
*
* On critical failure the program should `abort()` or exit by other means.
* That is, do not let `reexec_failure_recover` run successfully, if it unrecoverable
* error has occurred or one severe enough that it is better to simply respawn.
*
* @param state_buf The marshalled data that as not been read already
* @return Non-zero on error
*/
int unmarshal_server(char* state_buf)
{
/* buf_get_next(state_buf, int, MDS_KKBDOARD_VARS_VERSION); */
buf_next(state_buf, int, 1);
buf_get_next(state_buf, int, connected);
buf_get_next(state_buf, int32_t, message_id);
buf_get_next(state_buf, int, ledfd);
buf_get_next(state_buf, int, saved_leds);
buf_get_next(state_buf, struct termios, saved_stty);
buf_get_next(state_buf, int, saved_kbd_mode);
buf_get_next(state_buf, int, scancode_ptr);
buf_get_next(state_buf, int, scancode_buf[0]);
buf_get_next(state_buf, int, scancode_buf[1]);
buf_get_next(state_buf, int, scancode_buf[2]);
buf_get_next(state_buf, size_t, mapping_size);
if (mapping_size > 0)
{
fail_if (xmalloc(mapping, mapping_size, int));
memcpy(mapping, state_buf, mapping_size * sizeof(int));
state_buf += mapping_size * sizeof(int) / sizeof(char);
}
fail_if (mds_message_unmarshal(&received, state_buf));
return 0;
pfail:
xperror(*argv);
mds_message_destroy(&received);
free(mapping);
abort(); /* We must abort on failure to not risk the keyboard
getting stuck and freeze up the computer until
someone ssh:es into it and kill the server. */
return -1;
}
/**
* Attempt to recover from a re-exec failure that has been
* detected after the server successfully updated it execution image
*
* @return Non-zero on error
*/
int __attribute__((const)) reexec_failure_recover(void)
{
return -1;
}
/**
* Perform the server's mission
*
* @return Non-zero on error
*/
int master_loop(void)
{
int rc = 1, joined = 0;
void* kbd_ret;
fail_if ((errno = pthread_create(&kbd_thread, NULL, keyboard_loop, NULL)));
while (!reexecing && !terminating)
{
int r = mds_message_read(&received, socket_fd);
if (r == 0)
{
if (r = handle_message(), r == 0)
continue;
}
if (r == -2)
{
eprint("corrupt message received, aborting.");
goto fail;
}
else if (errno == EINTR)
continue;
else if (errno != ECONNRESET)
goto pfail;
eprint("lost connection to server.");
mds_message_destroy(&received);
mds_message_initialise(&received);
connected = 0;
if (reconnect_to_display())
goto fail;
connected = 1;
}
joined = 1;
fail_if ((errno = pthread_join(kbd_thread, &kbd_ret)));
rc = kbd_ret == NULL ? 0 : 1;
goto fail;
pfail:
xperror(*argv);
fail:
if (!rc && reexecing)
return 0;
if ((!joined) && (errno = pthread_join(kbd_thread, NULL)))
xperror(*argv);
mds_message_destroy(&received);
return rc;
}
/**
* The keyboard listener thread's main function
*
* @param data Input data
* @return Output data
*/
void* keyboard_loop(void* data)
{
(void) data;
kbd_thread_started = 1;
while (!reexecing && !terminating)
if (fetch_keys() < 0)
if (errno != EINTR)
goto pfail;
free(mapping);
return NULL;
pfail:
xperror(*argv);
free(mapping);
raise(SIGTERM);
return (void*)1024;
}
/**
* Handle the received message
*
* @return Zero on success, -1 on error
*/
int handle_message(void)
{
const char* recv_command = NULL;
const char* recv_client_id = "0:0";
const char* recv_message_id = NULL;
const char* recv_modify_id = NULL;
const char* recv_active = NULL;
const char* recv_mask = NULL;
const char* recv_keyboard = NULL;
size_t i;
#define __get_header(storage, header) \
(startswith(received.headers[i], header)) \
storage = received.headers[i] + strlen(header)
for (i = 0; i < received.header_count; i++)
{
if __get_header(recv_command, "Command: ");
else if __get_header(recv_client_id, "Client ID: ");
else if __get_header(recv_message_id, "Message ID: ");
else if __get_header(recv_modify_id, "Modify ID: ");
else if __get_header(recv_active, "Active: ");
else if __get_header(recv_mask, "Mask: ");
else if __get_header(recv_keyboard, "Keyboard: ");
}
#undef __get_header
if (recv_message_id == NULL)
{
eprint("received message with ID, ignoring, master server is misbehaving.");
return 0;
}
if (recv_command == NULL)
return 0; /* How did that get here, not matter, just ignore it? */
if (strequals(recv_command, "enumerate-keyboards"))
return handle_enumerate_keyboards(recv_client_id, recv_message_id, recv_modify_id);
if (strequals(recv_command, "keyboard-enumeration"))
return handle_keyboard_enumeration(recv_modify_id);
if (strequals(recv_command, "set-keyboard-leds"))
return handle_set_keyboard_leds(recv_active, recv_mask, recv_keyboard);
if (strequals(recv_command, "get-keyboard-leds"))
return handle_get_keyboard_leds(recv_client_id, recv_message_id, recv_keyboard);
return 0; /* How did that get here, not matter, just ignore it? */
}
/**
* Handle the received message after it has been
* identified to contain `Command: enumerate-keyboards`
*
* @param recv_client_id The value of the `Client ID`-header, `NULL` if omitted
* @param recv_message_id The value of the `Message ID`-header, `NULL` if omitted
* @param recv_modify_id The value of the `Modify ID`-header, `NULL` if omitted
* @return Zero on success, -1 on error
*/
int handle_enumerate_keyboards(const char* recv_client_id, const char* recv_message_id,
const char* recv_modify_id)
{
if (recv_modify_id == NULL)
{
eprint("did not get add modify ID, ignoring.");
return 0;
}
if (strequals(recv_client_id, "0:0"))
{
eprint("received information request from an anonymous client, sending non-modifying response.");
/* TODO send non-modifying response */
return 0;
}
/* TODO */
return 0;
}
/**
* Handle the received message after it has been
* identified to contain `Command: keyboard-enumeration`
*
* @param recv_modify_id The value of the `Modify ID`-header, `NULL` if omitted
* @return Zero on success, -1 on error
*/
int handle_keyboard_enumeration(const char* recv_modify_id)
{
if (recv_modify_id == NULL)
{
eprint("did not get add modify ID, ignoring.");
return 0;
}
/* TODO */
return 0;
}
/**
* Handle the received message after it has been
* identified to contain `Command: set-keyboard-leds`
*
* @param recv_active The value of the `Active`-header, `NULL` if omitted
* @param recv_mask The value of the `Mask`-header, `NULL` if omitted
* @param recv_keyboard The value of the `Keyboard`-header, `NULL` if omitted
* @return Zero on success, -1 on error
*/
int handle_set_keyboard_leds(const char* recv_active, const char* recv_mask,
const char* recv_keyboard)
{
int active = 0;
int mask = 0;
int current;
const char* begin;
const char* end;
if ((recv_keyboard != NULL) && !strequals(recv_keyboard, KEYBOARD_ID))
return 0;
if (recv_active == NULL)
{
eprint("received LED writing request without active header, ignoring.");
return 0;
}
if (recv_mask == NULL)
{
eprint("received LED writing request without mask header, ignoring.");
return 0;
}
current = get_leds();
if (current < 0)
{
xperror(*argv);
return 0; /* Not fatal */
}
#define __test(have, want) (startswith(have, want " ") || strequals(have, want))
for (begin = end = recv_active; end != NULL;)
{
end = strchr(begin, ' ');
if (__test(begin, "num")) active |= LED_NUM_LOCK;
else if (__test(begin, "caps")) active |= LED_CAPS_LOCK;
else if (__test(begin, "scroll")) active |= LED_SCRL_LOCK;
#ifdef LED_COMPOSE
else if (__test(begin, "compose")) active |= LED_COMPOSE;
#endif
begin = end + 1;
}
for (begin = end = recv_mask; end != NULL;)
{
end = strchr(begin, ' ');
if (__test(begin, "num")) mask |= LED_NUM_LOCK;
else if (__test(begin, "caps")) mask |= LED_CAPS_LOCK;
else if (__test(begin, "scroll")) mask |= LED_SCRL_LOCK;
#ifdef LED_COMPOSE
else if (__test(begin, "compose")) mask |= LED_COMPOSE;
#endif
begin = end + 1;
}
#undef __test
current = (active & mask) | ((current ^ active) & ~mask);
if (set_leds(current) < 0)
{
xperror(*argv); /* Not fatal */
return 0;
}
return 0;
}
/**
* Handle the received message after it has been
* identified to contain `Command: get-keyboard-leds`
*
* @param recv_client_id The value of the `Client ID`-header, `NULL` if omitted
* @param recv_message_id The value of the `Message ID`-header, `NULL` if omitted
* @param recv_keyboard The value of the `Keyboard`-header, `NULL` if omitted
* @return Zero on success, -1 on error
*/
int handle_get_keyboard_leds(const char* recv_client_id, const char* recv_message_id,
const char* recv_keyboard)
{
if ((recv_keyboard != NULL) && !strequals(recv_keyboard, KEYBOARD_ID))
return 0;
if (recv_keyboard == NULL)
{
eprint("received LED reading request but no specified keyboard, ignoring.");
return 0;
}
if (strequals(recv_client_id, "0:0"))
{
eprint("received information request from an anonymous client, ignoring.");
return 0;
}
/* TODO */
return 0;
}
/**
* Send a singal to all threads except the current thread
*
* @param signo The signal
*/
void signal_all(int signo)
{
pthread_t current_thread = pthread_self();
if (pthread_equal(current_thread, master_thread) == 0)
pthread_kill(master_thread, signo);
if (kbd_thread_started)
if (pthread_equal(current_thread, kbd_thread) == 0)
pthread_kill(kbd_thread, signo);
}
/**
* Send a full message even if interrupted
*
* @param message The message to send
* @param length The length of the message
* @return Non-zero on success
*/
int full_send(const char* message, size_t length)
{
size_t sent;
while (length > 0)
{
sent = send_message(socket_fd, message, length);
if (sent > length)
{
eprint("Sent more of a message than exists in the message, aborting.");
return -1;
}
else if ((sent < length) && (errno != EINTR))
{
xperror(*argv);
return -1;
}
message += sent;
length -= sent;
}
return 0;
}
/**
* Acquire access of the keyboard's LED:s
*
* @return Zero on success, -1 on error
*/
int open_leds(void)
{
#ifdef __sparc__
if ((ledfd = open(SPARC_KBD, O_RDONLY)) < 0)
return -1;
if (ioctl(ledfd, GET_LED, &saved_leds) < 0)
{
close(ledfd);
return -1;
}
return 0;
#else
return ioctl(ledfd, GET_LED, &saved_leds);
#endif
}
/**
* Release access of the keyboard's LED:s
*/
void close_leds(void)
{
if (ioctl(ledfd, SET_LED, saved_leds) < 0)
xperror(*argv);
#ifdef __sparc__
close(ledfd);
#endif
}
/**
* Get active LED:s on the keyboard
*
* @return Active LED:s, -1 on error
*/
int get_leds(void)
{
int leds;
if (ioctl(ledfd, GET_LED, &leds) < 0)
return -1;
#ifdef __sparc__
leds &= 15;
#endif
return leds;
}
/**
* Set active LED:s on the keyboard
*
* @param leds Active LED:s
* @return Zero on success, -1 on error
*/
int set_leds(int leds)
{
return ioctl(ledfd, SET_LED, leds);
}
/**
* Acquire access of keyboard input
*
* @return Zero on success, -1 on error
*/
int open_input(void)
{
struct termios stty;
if (tcgetattr(STDIN_FILENO, &saved_stty) < 0)
return -1;
stty = saved_stty;
stty.c_lflag &= (tcflag_t)~(ECHO | ICANON | ISIG);
stty.c_iflag = 0;
if (tcsetattr(STDIN_FILENO, TCSAFLUSH, &stty) < 0)
return -1;
/* K_MEDIUMRAW: utilise keyboard drivers, but not layout */
if ((ioctl(STDIN_FILENO, KDGKBMODE, &saved_kbd_mode) < 0) ||
(ioctl(STDIN_FILENO, KDSKBMODE, K_MEDIUMRAW) < 0))
{
xperror(*argv);
return tcsetattr(STDIN_FILENO, TCSAFLUSH, &saved_stty);
}
return 0;
}
/**
* Release access of keyboard input
*/
void close_input(void)
{
if (ioctl(STDIN_FILENO, KDSKBMODE, saved_kbd_mode) < 0)
xperror(*argv);
if (tcsetattr(STDIN_FILENO, TCSAFLUSH, &saved_stty) < 0)
xperror(*argv);
}
/**
* Broadcast a keyboard input event
*
* @param scancode The scancode
* @param trio Whether the scancode has three integers rather than one
* @return Zero on success, -1 on error
*/
int send_key(int* restrict scancode, int trio)
{
int r, keycode, released = (scancode[0] & 0x80) == 0x80;
scancode[0] &= 0x7F;
if (trio)
{
keycode = (scancode[1] &= 0x7F) << 7;
keycode |= (scancode[2] &= 0x7F);
}
else
keycode = scancode[0];
if ((size_t)keycode < mapping_size)
keycode = mapping[keycode];
if (trio)
sprintf(key_send_buffer,
"Command: key-sent\n"
"Scancode: %i %i %i\n"
"Keycode: %i\n"
"Released: %s\n"
"Keyboard: " KEYBOARD_ID "\n"
"Message ID: " PRIi32 "\n"
"\n",
scancode[0], scancode[1], scancode[2], keycode,
released ? "yes" : "no", message_id);
else
sprintf(key_send_buffer,
"Command: key-sent\n"
"Scancode: %i\n"
"Keycode: %i\n"
"Released: %s\n"
"Keyboard: " KEYBOARD_ID "\n"
"Message ID: " PRIi32 "\n"
"\n",
scancode[0], keycode,
released ? "yes" : "no", message_id);
message_id = message_id == INT32_MAX ? 0 : (message_id + 1);
with_mutex (send_mutex,
r = full_send(key_send_buffer, strlen(key_send_buffer));
);
return r;
}
/**
* Fetch and broadcast keys until interrupted
*
* @return Zero on success, -1 on error
*/
int fetch_keys(void)
{
#ifdef DEBUG
int consecutive_escapes = 0;
#endif
int c;
ssize_t r;
for (;;)
{
r = read(STDIN_FILENO, &c, sizeof(int));
if (r <= 0)
{
if (r == 0)
{
raise(SIGTERM);
errno = 0;
}
break;
}
#ifdef DEBUG
if ((c & 0x7F) == 1) /* Exit with ESCAPE, ESCAPE, ESCAPE */
{
if (++consecutive_escapes >= 2 * 3)
{
raise(SIGTERM);
errno = 0;
break;
}
}
else
consecutive_escapes = 0;
#endif
redo:
scancode_buf[scancode_ptr] = c;
if (scancode_ptr == 0)
{
if ((c & 0x7F) == 0)
scancode_ptr++;
else
send_key(scancode_buf, 0);
}
else if (scancode_ptr == 1)
{
if ((c & 0x80) == 0)
{
scancode_ptr = 0;
goto redo;
}
scancode_ptr++;
}
else
{
scancode_ptr = 0;
if ((c & 0x80) == 0)
{
send_key(scancode_buf + 1, 0);
goto redo;
}
send_key(scancode_buf, 1);
}
}
return errno == 0 ? 0 : -1;
}