X-Git-Url: http://git.tuebingen.mpg.de/?p=paraslash.git;a=blobdiff_plain;f=command.c;h=d55d1e6e8a60d958ce2ffbf16e2f0d75e2065570;hp=26126cc938cc0f8c9bb751b2cebf6f7ee52d5169;hb=3f696a82bbb79cb07bfdb8e510bb4f3515570cec;hpb=f6a99f9e27cf84d92fc992677dca9578c5a3b585

diff --git a/command.c b/command.c
index 26126cc9..d55d1e6e 100644
--- a/command.c
+++ b/command.c
@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 1997-2013 Andre Noll <maan@systemlinux.org>
+ * Copyright (C) 1997 Andre Noll <maan@tuebingen.mpg.de>
  *
  * Licensed under the GPL v2. For licencing details see COPYING.
  */
@@ -15,6 +15,7 @@
 #include <arpa/inet.h>
 #include <sys/un.h>
 #include <netdb.h>
+#include <lopsub.h>
 
 #include "para.h"
 #include "error.h"
@@ -34,14 +35,39 @@
 #include "daemon.h"
 #include "fd.h"
 #include "ipc.h"
+#include "server_cmd.lsg.h"
 #include "user_list.h"
-#include "server_command_list.h"
-#include "afs_command_list.h"
+#include "afs.command_list.h"
 #include "signal.h"
 #include "version.h"
 
+#define SERVER_CMD_AUX_INFO(_arg) _arg,
+static const unsigned server_command_perms[] = {LSG_SERVER_CMD_AUX_INFOS};
+#undef SERVER_CMD_AUX_INFO
+#define SERVER_CMD_AUX_INFO(_arg) #_arg,
+static const char * const server_command_perms_txt[] = {LSG_SERVER_CMD_AUX_INFOS};
+#undef SERVER_CMD_AUX_INFO
+
+typedef int server_command_handler_t(struct command_context *);
+server_command_handler_t AFS_COMMAND_HANDLERS;
+
+/* Defines one command of para_server. */
+struct server_command {
+	/* The name of the command. */
+	const char *name;
+	/* Pointer to the function that handles the command. */
+	server_command_handler_t *handler;
+	/* The privileges a user must have to execute this command. */
+	unsigned int perms;
+	/* One-line description of the command. */
+	const char *description;
+	/* Summary of the command line options. */
+	const char *usage;
+	/* The long help text. */
+	const char *help;
+};
+
 static struct server_command afs_cmds[] = {DEFINE_AFS_CMD_ARRAY};
-static struct server_command server_cmds[] = {DEFINE_SERVER_CMD_ARRAY};
 
 /** Commands including options must be shorter than this. */
 #define MAX_COMMAND_LEN 32768
@@ -55,20 +81,14 @@ static void dummy(__a_unused int s)
 {
 }
 
-static void mmd_dup(struct misc_meta_data *new_mmd)
-{
-	mutex_lock(mmd_mutex);
-	*new_mmd = *mmd;
-	mutex_unlock(mmd_mutex);
-}
-
 /*
- * Compute human readable string containing vss status for given integer value.
+ * Compute human readable vss status text.
  *
- * We don't want to use vss_playing() and friends here because we take a
- * snapshot of the mmd struct and use the copy for computing the state of the
- * vss. If the real data were used, we would take the mmd lock for a rather
- * long time or risk to get an inconsistent view.
+ * We can't call vss_playing() and friends here because those functions read
+ * the flags from the primary mmd structure, so calling them from command
+ * handler context would require to take the mmd lock. At the time the function
+ * is called we already took a copy of the mmd structure and want to use the
+ * flags value of the copy for computing the vss status text.
  */
 static char *vss_status_tohuman(unsigned int flags)
 {
@@ -79,21 +99,6 @@ static char *vss_status_tohuman(unsigned int flags)
 	return para_strdup("paused");
 }
 
-/*
- * return human readable permission string. Never returns NULL.
- */
-static char *cmd_perms_itohuman(unsigned int perms)
-{
-	char *msg = para_malloc(5 * sizeof(char));
-
-	msg[0] = perms & AFS_READ? 'a' : '-';
-	msg[1] = perms & AFS_WRITE? 'A' : '-';
-	msg[2] = perms & VSS_READ? 'v' : '-';
-	msg[3] = perms & VSS_WRITE? 'V' : '-';
-	msg[4] = '\0';
-	return msg;
-}
-
 /*
  * Never returns NULL.
  */
@@ -109,25 +114,18 @@ static char *vss_get_status_flags(unsigned int flags)
 	return msg;
 }
 
-static unsigned get_status(struct misc_meta_data *nmmd, int parser_friendly,
+static unsigned get_status(struct misc_meta_data *nmmd, bool parser_friendly,
 		char **result)
 {
-	char mtime[30] = "";
 	char *status, *flags; /* vss status info */
 	/* nobody updates our version of "now" */
-	char *ut = get_server_uptime_str(NULL);
 	long offset = (nmmd->offset + 500) / 1000;
 	struct timeval current_time;
-	struct tm mtime_tm;
 	struct para_buffer b = {.flags = parser_friendly? PBF_SIZE_PREFIX : 0};
 
 	/* report real status */
 	status = vss_status_tohuman(nmmd->vss_status_flags);
 	flags = vss_get_status_flags(nmmd->vss_status_flags);
-	if (nmmd->size) { /* parent currently has an audio file open */
-		localtime_r(&nmmd->mtime, &mtime_tm);
-		strftime(mtime, 29, "%b %d %Y", &mtime_tm);
-	}
 	clock_get_realtime(&current_time);
 	/*
 	 * The calls to WRITE_STATUS_ITEM() below never fail because
@@ -135,8 +133,6 @@ static unsigned get_status(struct misc_meta_data *nmmd, int parser_friendly,
 	 * is not smart enough to prove this and complains nevertheless.
 	 * Casting the return value to void silences clang.
 	 */
-	(void)WRITE_STATUS_ITEM(&b, SI_FILE_SIZE, "%zu\n", nmmd->size / 1024);
-	(void)WRITE_STATUS_ITEM(&b, SI_MTIME, "%s\n", mtime);
 	(void)WRITE_STATUS_ITEM(&b, SI_STATUS, "%s\n", status);
 	(void)WRITE_STATUS_ITEM(&b, SI_STATUS_FLAGS, "%s\n", flags);
 	(void)WRITE_STATUS_ITEM(&b, SI_OFFSET, "%li\n", offset);
@@ -149,58 +145,10 @@ static unsigned get_status(struct misc_meta_data *nmmd, int parser_friendly,
 		(long unsigned)current_time.tv_usec);
 	free(flags);
 	free(status);
-	free(ut);
 	*result = b.buf;
 	return b.offset;
 }
 
-static int check_sender_args(int argc, char * const * argv, struct sender_command_data *scd)
-{
-	int i;
-	/* this has to match sender.h */
-	const char *subcmds[] = {"add", "delete", "allow", "deny", "on", "off", NULL};
-
-	scd->sender_num = -1;
-	if (argc < 2)
-		return -E_COMMAND_SYNTAX;
-	for (i = 0; senders[i].name; i++)
-		if (!strcmp(senders[i].name, argv[1]))
-			break;
-	PARA_DEBUG_LOG("%d:%s\n", argc, argv[1]);
-	if (!senders[i].name)
-		return -E_COMMAND_SYNTAX;
-	scd->sender_num = i;
-	for (i = 0; subcmds[i]; i++)
-		if (!strcmp(subcmds[i], argv[2]))
-			break;
-	if (!subcmds[i])
-		return -E_COMMAND_SYNTAX;
-	scd->cmd_num = i;
-	if (!senders[scd->sender_num].client_cmds[scd->cmd_num])
-		return -E_SENDER_CMD;
-	switch (scd->cmd_num) {
-	case SENDER_ON:
-	case SENDER_OFF:
-		if (argc != 3)
-			return -E_COMMAND_SYNTAX;
-		break;
-	case SENDER_DENY:
-	case SENDER_ALLOW:
-		if (argc != 4 || parse_cidr(argv[3], scd->host,
-				sizeof(scd->host), &scd->netmask) == NULL)
-			return -E_COMMAND_SYNTAX;
-		break;
-	case SENDER_ADD:
-	case SENDER_DELETE:
-		if (argc != 4)
-			return -E_COMMAND_SYNTAX;
-		return parse_fec_url(argv[3], scd);
-	default:
-		return -E_COMMAND_SYNTAX;
-	}
-	return 1;
-}
-
 /**
  * Send a sideband packet through a blocking file descriptor.
  *
@@ -212,7 +160,7 @@ static int check_sender_args(int argc, char * const * argv, struct sender_comman
  *
  * The nonblock flag must be disabled for the file descriptor given by \a scc.
  *
- * Stream cipher encryption is automatically activated if neccessary via the
+ * Stream cipher encryption is automatically activated if necessary via the
  * sideband transformation, depending on the value of \a band.
  *
  * \return Standard.
@@ -276,6 +224,81 @@ int send_strerror(struct command_context *cc, int err)
 	return send_sb_va(&cc->scc, SBD_ERROR_LOG, "%s\n", para_strerror(err));
 }
 
+/**
+ * Send an error context to a client,
+ *
+ * \param cc Client info.
+ * \param errctx The error context string.
+ *
+ * \return The return value of the underlying call to send_sb_va().
+ *
+ * This function frees the error context string after it was sent.
+ */
+int send_errctx(struct command_context *cc, char *errctx)
+{
+	int ret;
+
+	if (!errctx)
+		return 0;
+	ret = send_sb_va(&cc->scc, SBD_ERROR_LOG, "%s\n", errctx);
+	free(errctx);
+	return ret;
+}
+
+static int check_sender_args(struct command_context *cc,
+		struct lls_parse_result *lpr, struct sender_command_data *scd)
+{
+	int i, ret;
+	const char *subcmds[] = {SENDER_SUBCOMMANDS};
+	const char *arg;
+	char *errctx;
+	unsigned num_inputs = lls_num_inputs(lpr);
+
+	scd->sender_num = -1;
+	ret = lls(lls_check_arg_count(lpr, 2, INT_MAX, &errctx));
+	if (ret < 0) {
+		send_errctx(cc, errctx);
+		return ret;
+	}
+	arg = lls_input(0, lpr);
+	for (i = 0; senders[i].name; i++)
+		if (!strcmp(senders[i].name, arg))
+			break;
+	if (!senders[i].name)
+		return -E_COMMAND_SYNTAX;
+	scd->sender_num = i;
+	arg = lls_input(1, lpr);
+	for (i = 0; subcmds[i]; i++)
+		if (!strcmp(subcmds[i], arg))
+			break;
+	if (!subcmds[i])
+		return -E_COMMAND_SYNTAX;
+	scd->cmd_num = i;
+	if (!senders[scd->sender_num].client_cmds[scd->cmd_num])
+		return -E_SENDER_CMD;
+	switch (scd->cmd_num) {
+	case SENDER_on:
+	case SENDER_off:
+		if (num_inputs != 2)
+			return -E_COMMAND_SYNTAX;
+		break;
+	case SENDER_deny:
+	case SENDER_allow:
+		if (num_inputs != 3 || parse_cidr(lls_input(2, lpr), scd->host,
+				sizeof(scd->host), &scd->netmask) == NULL)
+			return -E_COMMAND_SYNTAX;
+		break;
+	case SENDER_add:
+	case SENDER_delete:
+		if (num_inputs != 3)
+			return -E_COMMAND_SYNTAX;
+		return parse_fec_url(lls_input(2, lpr), scd);
+	default:
+		return -E_COMMAND_SYNTAX;
+	}
+	return 1;
+}
+
 /**
  * Send a sideband packet through a blocking file descriptor.
  *
@@ -326,13 +349,13 @@ fail:
 	return ret;
 }
 
-static int com_sender(struct command_context *cc)
+static int com_sender(struct command_context *cc, struct lls_parse_result *lpr)
 {
 	int i, ret = 0;
 	char *msg = NULL;
 	struct sender_command_data scd;
 
-	if (cc->argc < 2) {
+	if (lls_num_inputs(lpr) == 0) {
 		for (i = 0; senders[i].name; i++) {
 			char *tmp;
 			ret = xasprintf(&tmp, "%s%s\n", msg? msg : "",
@@ -342,19 +365,23 @@ static int com_sender(struct command_context *cc)
 		}
 		return send_sb(&cc->scc, msg, ret, SBD_OUTPUT, false);
 	}
-	ret = check_sender_args(cc->argc, cc->argv, &scd);
+	ret = check_sender_args(cc, lpr, &scd);
 	if (ret < 0) {
 		if (scd.sender_num < 0)
 			return ret;
-		msg = senders[scd.sender_num].help();
+		if (strcmp(lls_input(1, lpr), "status") == 0)
+			msg = senders[scd.sender_num].status();
+		else
+			msg = senders[scd.sender_num].help();
 		return send_sb(&cc->scc, msg, strlen(msg), SBD_OUTPUT, false);
 	}
 
 	switch (scd.cmd_num) {
-	case SENDER_ADD:
-	case SENDER_DELETE:
+	case SENDER_add:
+	case SENDER_delete:
 		assert(senders[scd.sender_num].resolve_target);
-		ret = senders[scd.sender_num].resolve_target(cc->argv[3], &scd);
+		ret = senders[scd.sender_num].resolve_target(lls_input(2, lpr),
+			&scd);
 		if (ret < 0)
 			return ret;
 	}
@@ -362,42 +389,35 @@ static int com_sender(struct command_context *cc)
 	for (i = 0; i < 10; i++) {
 		mutex_lock(mmd_mutex);
 		if (mmd->sender_cmd_data.cmd_num >= 0) {
+			/* another sender command is active, retry in 100ms */
+			struct timespec ts = {.tv_nsec = 100 * 1000 * 1000};
 			mutex_unlock(mmd_mutex);
-			usleep(100 * 1000);
+			nanosleep(&ts, NULL);
 			continue;
 		}
-		memcpy(&mmd->sender_cmd_data, &scd, sizeof(scd));
+		mmd->sender_cmd_data = scd;
 		mutex_unlock(mmd_mutex);
 		break;
 	}
 	return (i < 10)? 1 : -E_LOCK;
 }
+EXPORT_SERVER_CMD_HANDLER(sender);
 
-/* server info */
-static int com_si(struct command_context *cc)
+static int com_si(struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	int i, ret;
-	char *msg, *ut, *sender_info = NULL;
+	char *msg, *ut;
+	int ret;
 
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
+	ut = daemon_get_uptime_str(now);
 	mutex_lock(mmd_mutex);
-	for (i = 0; senders[i].name; i++) {
-		char *info = senders[i].info();
-		sender_info = para_strcat(sender_info, info);
-		free(info);
-	}
-	ut = get_server_uptime_str(now);
 	ret = xasprintf(&msg,
-		"version: %s\n"
 		"up: %s\nplayed: %u\n"
 		"server_pid: %d\n"
 		"afs_pid: %d\n"
 		"connections (active/accepted/total): %u/%u/%u\n"
 		"current loglevel: %s\n"
-		"supported audio formats: %s\n"
-		"%s",
-		version_git(),
+		"supported audio formats: %s\n",
 		ut, mmd->num_played,
 		(int)getppid(),
 		(int)mmd->afs_pid,
@@ -405,27 +425,28 @@ static int com_si(struct command_context *cc)
 		mmd->num_commands,
 		mmd->num_connects,
 		conf.loglevel_arg,
-		AUDIO_FORMAT_HANDLERS,
-		sender_info
+		AUDIO_FORMAT_HANDLERS
 	);
 	mutex_unlock(mmd_mutex);
 	free(ut);
-	free(sender_info);
 	return send_sb(&cc->scc, msg, ret, SBD_OUTPUT, false);
 }
+EXPORT_SERVER_CMD_HANDLER(si);
 
-/* version */
-static int com_version(struct command_context *cc)
+static int com_version(struct command_context *cc, struct lls_parse_result *lpr)
 {
 	char *msg;
 	size_t len;
 
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
-	len = xasprintf(&msg, "%s", version_text("server"));
+	if (SERVER_CMD_OPT_GIVEN(VERSION, VERBOSE, lpr))
+		len = xasprintf(&msg, "%s", version_text("server"));
+	else
+		len = xasprintf(&msg, "%s\n", version_single_line("server"));
 	return send_sb(&cc->scc, msg, len, SBD_OUTPUT, false);
 }
+EXPORT_SERVER_CMD_HANDLER(version);
 
+/** These status items are cleared if no audio file is currently open. */
 #define EMPTY_STATUS_ITEMS \
 	ITEM(PATH) \
 	ITEM(DIRECTORY) \
@@ -452,14 +473,18 @@ static int com_version(struct command_context *cc)
 	ITEM(YEAR) \
 	ITEM(ALBUM) \
 	ITEM(COMMENT) \
-	ITEM(AMPLIFICATION)
+	ITEM(MTIME) \
+	ITEM(FILE_SIZE) \
+	ITEM(CHUNK_TIME) \
+	ITEM(NUM_CHUNKS) \
+	ITEM(AMPLIFICATION) \
 
 /**
  * Write a list of audio-file related status items with empty values.
  *
  * This is used by vss when currently no audio file is open.
  */
-static unsigned empty_status_items(int parser_friendly, char **result)
+static unsigned empty_status_items(bool parser_friendly, char **result)
 {
 	char *esi;
 	unsigned len;
@@ -469,7 +494,7 @@ static unsigned empty_status_items(int parser_friendly, char **result)
 			#define ITEM(x) "0004 %02x:\n"
 			EMPTY_STATUS_ITEMS
 			#undef ITEM
-			#define ITEM(x) , SI_ ## x
+			#define ITEM(x) , (unsigned) SI_ ## x
 			EMPTY_STATUS_ITEMS
 			#undef ITEM
 		);
@@ -487,41 +512,24 @@ static unsigned empty_status_items(int parser_friendly, char **result)
 }
 #undef EMPTY_STATUS_ITEMS
 
-/* stat */
-static int com_stat(struct command_context *cc)
+static int com_stat(struct command_context *cc, struct lls_parse_result *lpr)
 {
-	int i, ret;
+	int ret;
 	struct misc_meta_data tmp, *nmmd = &tmp;
 	char *s;
-	int32_t num = 0;
-	int parser_friendly = 0;
+	bool parser_friendly = SERVER_CMD_OPT_GIVEN(STAT, PARSER_FRIENDLY,
+		lpr) > 0;
+	uint32_t num = SERVER_CMD_UINT32_VAL(STAT, NUM, lpr);
 
 	para_sigaction(SIGUSR1, dummy);
-
-	for (i = 1; i < cc->argc; i++) {
-		const char *arg = cc->argv[i];
-		if (arg[0] != '-')
-			break;
-		if (!strcmp(arg, "--")) {
-			i++;
-			break;
-		}
-		if (!strncmp(arg, "-n=", 3)) {
-			ret = para_atoi32(arg + 3, &num);
-			if (ret < 0)
-				return ret;
-			continue;
-		}
-		if (!strcmp(arg, "-p")) {
-			parser_friendly = 1;
-			continue;
-		}
-		return -E_COMMAND_SYNTAX;
-	}
-	if (i != cc->argc)
-		return -E_COMMAND_SYNTAX;
 	for (;;) {
-		mmd_dup(nmmd);
+		/*
+		 * Copy the mmd structure to minimize the time we hold the mmd
+		 * lock.
+		 */
+		mutex_lock(mmd_mutex);
+		*nmmd = *mmd;
+		mutex_unlock(mmd_mutex);
 		ret = get_status(nmmd, parser_friendly, &s);
 		ret = send_sb(&cc->scc, s, ret, SBD_OUTPUT, false);
 		if (ret < 0)
@@ -545,21 +553,34 @@ static int com_stat(struct command_context *cc)
 out:
 	return ret;
 }
+EXPORT_SERVER_CMD_HANDLER(stat);
 
-static int send_list_of_commands(struct command_context *cc, struct server_command *cmd,
-		const char *handler)
+/* fixed-length, human readable permission string */
+const char *server_cmd_perms_str(unsigned int perms)
 {
-	char *msg = NULL;
+	static char result[5];
+
+	result[0] = perms & AFS_READ? 'a' : '-';
+	result[1] = perms & AFS_WRITE? 'A' : '-';
+	result[2] = perms & VSS_READ? 'v' : '-';
+	result[3] = perms & VSS_WRITE? 'V' : '-';
+	result[4] = '\0';
+	return result;
+}
 
-	for (; cmd->name; cmd++) {
-		char *tmp, *perms = cmd_perms_itohuman(cmd->perms);
-		tmp = make_message("%s\t%s\t%s\t%s\n", cmd->name, handler,
-			perms, cmd->description);
-		free(perms);
-		msg = para_strcat(msg, tmp);
-		free(tmp);
+static int send_list_of_commands(struct command_context *cc)
+{
+	int i;
+	const struct lls_command *cmd;
+	char *msg = para_strdup("");
+
+	for (i = 1; (cmd = lls_cmd(i, server_cmd_suite)); i++) {
+		const char *perms = server_cmd_perms_str(server_command_perms[i]);
+		char *tmp = make_message("%s%s\t%s\t%s\n", msg,
+			lls_command_name(cmd), perms, lls_purpose(cmd));
+		free(msg);
+		msg = tmp;
 	}
-	assert(msg);
 	return send_sb(&cc->scc, msg, strlen(msg), SBD_OUTPUT, false);
 }
 
@@ -568,12 +589,6 @@ static struct server_command *get_cmd_ptr(const char *name, char **handler)
 {
 	struct server_command *cmd;
 
-	for (cmd = server_cmds; cmd->name; cmd++)
-		if (!strcmp(cmd->name, name)) {
-			if (handler)
-				*handler = para_strdup("server"); /* server commands */
-			return cmd;
-		}
 	/* not found, look for commands supported by afs */
 	for (cmd = afs_cmds; cmd->name; cmd++)
 		if (!strcmp(cmd->name, name)) {
@@ -584,75 +599,67 @@ static struct server_command *get_cmd_ptr(const char *name, char **handler)
 	return NULL;
 }
 
-/* help */
-static int com_help(struct command_context *cc)
+static int com_help(struct command_context *cc, struct lls_parse_result *lpr)
 {
-	struct server_command *cmd;
-	char *perms, *handler, *buf;
+	const char *perms;
+	char *long_help, *buf, *errctx;
 	int ret;
+	const struct lls_command *cmd;
 
-	if (cc->argc < 2) {
-		/* no argument given, print list of commands */
-		if ((ret = send_list_of_commands(cc, server_cmds, "server")) < 0)
-			return ret;
-		return send_list_of_commands(cc, afs_cmds, "afs");
+	ret = lls(lls_check_arg_count(lpr, 0, 1, &errctx));
+	if (ret < 0) {
+		send_errctx(cc, errctx);
+		return ret;
 	}
+	if (lls_num_inputs(lpr) == 0)
+		return send_list_of_commands(cc);
 	/* argument given for help */
-	cmd = get_cmd_ptr(cc->argv[1], &handler);
-	if (!cmd)
-		return -E_BAD_CMD;
-	perms = cmd_perms_itohuman(cmd->perms);
-	ret = xasprintf(&buf, "%s - %s\n\n"
-		"handler: %s\n"
-		"permissions: %s\n"
-		"usage: %s\n\n"
-		"%s\n",
-		cc->argv[1],
-		cmd->description,
-		handler,
-		perms,
-		cmd->usage,
-		cmd->help
-	);
-	free(perms);
-	free(handler);
+	ret = lls(lls_lookup_subcmd(lls_input(0, lpr), server_cmd_suite,
+		&errctx));
+	if (ret < 0) {
+		send_errctx(cc, errctx);
+		return ret;
+	}
+	cmd = lls_cmd(ret, server_cmd_suite);
+	perms = server_command_perms_txt[ret];
+	long_help = lls_long_help(cmd);
+	assert(long_help);
+	ret = xasprintf(&buf, "%spermissions: %s\n", long_help, perms);
+	free(long_help);
 	return send_sb(&cc->scc, buf, ret, SBD_OUTPUT, false);
 }
+EXPORT_SERVER_CMD_HANDLER(help);
 
-/* hup */
-static int com_hup(struct command_context *cc)
+static int com_hup(__a_unused struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
 	kill(getppid(), SIGHUP);
 	return 1;
 }
+EXPORT_SERVER_CMD_HANDLER(hup);
 
-/* term */
-static int com_term(struct command_context *cc)
+static int com_term(__a_unused struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
 	kill(getppid(), SIGTERM);
 	return 1;
 }
+EXPORT_SERVER_CMD_HANDLER(term);
 
-static int com_play(struct command_context *cc)
+static int com_play(__a_unused struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
 	mutex_lock(mmd_mutex);
 	mmd->new_vss_status_flags |= VSS_PLAYING;
 	mmd->new_vss_status_flags &= ~VSS_NOMORE;
 	mutex_unlock(mmd_mutex);
 	return 1;
 }
+EXPORT_SERVER_CMD_HANDLER(play);
 
-/* stop */
-static int com_stop(struct command_context *cc)
+static int com_stop(__a_unused struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
 	mutex_lock(mmd_mutex);
 	mmd->new_vss_status_flags &= ~VSS_PLAYING;
 	mmd->new_vss_status_flags &= ~VSS_REPOS;
@@ -660,12 +667,11 @@ static int com_stop(struct command_context *cc)
 	mutex_unlock(mmd_mutex);
 	return 1;
 }
+EXPORT_SERVER_CMD_HANDLER(stop);
 
-/* pause */
-static int com_pause(struct command_context *cc)
+static int com_pause(__a_unused struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
 	mutex_lock(mmd_mutex);
 	if (!vss_paused() && !vss_stopped()) {
 		mmd->events++;
@@ -675,42 +681,44 @@ static int com_pause(struct command_context *cc)
 	mutex_unlock(mmd_mutex);
 	return 1;
 }
+EXPORT_SERVER_CMD_HANDLER(pause);
 
-/* next */
-static int com_next(struct command_context *cc)
+static int com_next(__a_unused struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
 	mutex_lock(mmd_mutex);
 	mmd->events++;
 	mmd->new_vss_status_flags |= VSS_NEXT;
 	mutex_unlock(mmd_mutex);
 	return 1;
 }
+EXPORT_SERVER_CMD_HANDLER(next);
 
-/* nomore */
-static int com_nomore(struct command_context *cc)
+static int com_nomore(__a_unused struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
 {
-	if (cc->argc != 1)
-		return -E_COMMAND_SYNTAX;
 	mutex_lock(mmd_mutex);
 	if (vss_playing() || vss_paused())
 		mmd->new_vss_status_flags |= VSS_NOMORE;
 	mutex_unlock(mmd_mutex);
 	return 1;
 }
+EXPORT_SERVER_CMD_HANDLER(nomore);
 
-/* ff */
-static int com_ff(struct command_context *cc)
+static int com_ff(__a_unused struct command_context *cc,
+		struct lls_parse_result *lpr)
 {
 	long promille;
 	int ret, backwards = 0;
 	unsigned i;
-	char c;
+	char c, *errctx;
 
-	if (cc->argc != 2)
-		return -E_COMMAND_SYNTAX;
-	if (!(ret = sscanf(cc->argv[1], "%u%c", &i, &c)))
+	ret = lls(lls_check_arg_count(lpr, 1, 1, &errctx));
+	if (ret < 0) {
+		send_errctx(cc, errctx);
+		return ret;
+	}
+	if (!(ret = sscanf(lls_input(0, lpr), "%u%c", &i, &c)))
 		return -E_COMMAND_SYNTAX;
 	if (ret > 1 && c == '-')
 		backwards = 1; /* jmp backwards */
@@ -725,7 +733,7 @@ static int com_ff(struct command_context *cc)
 		promille += 1000 * i / mmd->afd.afhi.seconds_total;
 	if (promille < 0)
 		promille = 0;
-	if (promille >  1000) {
+	if (promille > 1000) {
 		mmd->new_vss_status_flags |= VSS_NEXT;
 		goto out;
 	}
@@ -738,17 +746,22 @@ out:
 	mutex_unlock(mmd_mutex);
 	return ret;
 }
+EXPORT_SERVER_CMD_HANDLER(ff);
 
-/* jmp */
-static int com_jmp(struct command_context *cc)
+static int com_jmp(__a_unused struct command_context *cc,
+		struct lls_parse_result *lpr)
 {
 	long unsigned int i;
 	int ret;
+	char *errctx;
 
-	if (cc->argc != 2)
-		return -E_COMMAND_SYNTAX;
-	if (sscanf(cc->argv[1], "%lu", &i) <= 0)
-		return -E_COMMAND_SYNTAX;
+	ret = lls(lls_check_arg_count(lpr, 1, 1, &errctx));
+	if (ret < 0) {
+		send_errctx(cc, errctx);
+		return ret;
+	}
+	if (sscanf(lls_input(0, lpr), "%lu", &i) <= 0)
+		return -ERRNO_TO_PARA_ERROR(EINVAL);
 	mutex_lock(mmd_mutex);
 	ret = -E_NO_AUDIO_FILE;
 	if (!mmd->afd.afhi.chunks_total)
@@ -756,8 +769,8 @@ static int com_jmp(struct command_context *cc)
 	if (i > 100)
 		i = 100;
 	PARA_INFO_LOG("jumping to %lu%%\n", i);
-	mmd->repos_request = (mmd->afd.afhi.chunks_total * i + 50)/ 100;
-	PARA_INFO_LOG("sent: %lu,  offset before jmp: %lu\n",
+	mmd->repos_request = (mmd->afd.afhi.chunks_total * i + 50) / 100;
+	PARA_INFO_LOG("sent: %lu, offset before jmp: %li\n",
 		mmd->chunks_sent, mmd->offset);
 	mmd->new_vss_status_flags |= VSS_REPOS;
 	mmd->new_vss_status_flags &= ~VSS_NEXT;
@@ -767,12 +780,22 @@ out:
 	mutex_unlock(mmd_mutex);
 	return ret;
 }
+EXPORT_SERVER_CMD_HANDLER(jmp);
+
+static int com_tasks(struct command_context *cc,
+		__a_unused struct lls_parse_result *lpr)
+{
+	char *tl = server_get_tasks();
+	assert(tl);
+	return send_sb(&cc->scc, tl, strlen(tl), SBD_OUTPUT, false);
+}
+EXPORT_SERVER_CMD_HANDLER(tasks);
 
 /*
  * check if perms are sufficient to exec a command having perms cmd_perms.
  * Returns 0 if perms are sufficient, -E_PERM otherwise.
  */
-static int check_perms(unsigned int perms, struct server_command *cmd_ptr)
+static int check_perms(unsigned int perms, const struct server_command *cmd_ptr)
 {
 	PARA_DEBUG_LOG("checking permissions\n");
 	return (cmd_ptr->perms & perms) < cmd_ptr->perms ? -E_PERM : 0;
@@ -787,7 +810,6 @@ static void reset_signals(void)
 }
 
 struct connection_features {
-	bool sideband_requested;
 	bool aes_ctr128_requested;
 };
 
@@ -815,8 +837,8 @@ static int parse_auth_request(char *buf, int len, struct user **u,
 		create_argv(p, ",", &features);
 		for (i = 0; features[i]; i++) {
 			if (strcmp(features[i], "sideband") == 0)
-				cf->sideband_requested = true;
-			else if (strcmp(features[i], "aes_ctr128") == 0)
+				continue;
+			if (strcmp(features[i], "aes_ctr128") == 0)
 				cf->aes_ctr128_requested = true;
 			else {
 				ret = -E_BAD_FEATURE;
@@ -834,22 +856,40 @@ out:
 
 #define HANDSHAKE_BUFSIZE 4096
 
-static int parse_sb_command(struct command_context *cc, struct iovec *iov)
+static int run_command(struct command_context *cc, struct iovec *iov,
+		const char *peername)
 {
 	int ret, i;
 	char *p, *end;
+	struct server_command *cmd = NULL;
+	const struct lls_command *lcmd = NULL;
+	unsigned perms;
+	struct lls_parse_result *lpr;
+	char *errctx;
 
-	ret = -E_BAD_CMD;
 	if (iov->iov_base == NULL || iov->iov_len == 0)
-		goto out;
+		return -ERRNO_TO_PARA_ERROR(EINVAL);
 	p = iov->iov_base;
 	p[iov->iov_len - 1] = '\0'; /* just to be sure */
-	cc->cmd = get_cmd_ptr(p, NULL);
-	if (!cc->cmd)
-		goto out;
-	ret = check_perms(cc->u->perms, cc->cmd);
-	if (ret < 0)
-		goto out;
+
+	ret = lls(lls_lookup_subcmd(p, server_cmd_suite, &errctx));
+	if (ret >= 0 && !strcmp(p, lls_command_name(lls_cmd(ret,
+			server_cmd_suite)))) {
+		perms = server_command_perms[ret];
+		if ((perms & cc->u->perms) != perms)
+			return -E_PERM;
+		lcmd = lls_cmd(ret, server_cmd_suite);
+	} else {
+		cmd = get_cmd_ptr(p, NULL);
+		if (!cmd) {
+			send_errctx(cc, errctx);
+			return ret;
+		}
+		perms = cmd->perms;
+		ret = check_perms(cc->u->perms, cmd);
+		if (ret < 0)
+			return ret;
+	}
 	end = iov->iov_base + iov->iov_len;
 	for (i = 0; p < end; i++)
 		p += strlen(p) + 1;
@@ -860,9 +900,25 @@ static int parse_sb_command(struct command_context *cc, struct iovec *iov)
 		p += strlen(p) + 1;
 	}
 	cc->argv[cc->argc] = NULL;
-	ret = cc->argc;
-out:
-	free(iov->iov_base);
+	PARA_NOTICE_LOG("calling com_%s() for %s@%s\n", lcmd?
+		lls_command_name(lcmd) : cmd->name, cc->u->name, peername);
+	if (lcmd) {
+		ret = lls(lls_parse(cc->argc, cc->argv, lcmd, &lpr, &errctx));
+		if (ret >= 0) {
+			const struct server_cmd_user_data *ud = lls_user_data(lcmd);
+			ret = ud->handler(cc, lpr);
+			lls_free_parse_result(lpr, lcmd);
+		} else
+			send_errctx(cc, errctx);
+	} else {
+		ret = cmd->handler(cc);
+	}
+	free_argv(cc->argv);
+	mutex_lock(mmd_mutex);
+	mmd->num_commands++;
+	if (ret >= 0 && (perms & AFS_WRITE))
+		mmd->events++;
+	mutex_unlock(mmd_mutex);
 	return ret;
 }
 
@@ -872,24 +928,22 @@ out:
  * \param fd The file descriptor to send output to.
  * \param peername Identifies the connecting peer.
  *
- * Whenever para_server accepts an incoming tcp connection on
- * the port it listens on, it forks and the resulting child
- * calls this function.
+ * Whenever para_server accepts an incoming tcp connection on the port it
+ * listens on, it forks and the resulting child calls this function.
  *
- * An RSA-based challenge/response is used to authenticate
- * the peer. It that authentication succeeds, a random
- * session key is generated and sent back to the peer,
- * encrypted with its RSA public key.  From this point on,
- * all transfers are crypted with this session key.
+ * An RSA-based challenge/response is used to authenticate the peer. It that
+ * authentication succeeds, a random session key is generated and sent back to
+ * the peer, encrypted with its RSA public key. From this point on, all
+ * transfers are crypted with this session key.
  *
- * Next it is checked if the peer supplied  a valid server command or a command
- * for the audio file selector.  If yes, and if the user has sufficient
+ * Next it is checked if the peer supplied a valid server command or a command
+ * for the audio file selector. If yes, and if the user has sufficient
  * permissions to execute that command, the function calls the corresponding
  * command handler which does argument checking and further processing.
  *
- * In order to cope with a DOS attacks, a timeout is set up
- * which terminates the function if the connection was not
- * authenticated when the timeout expires.
+ * In order to cope with a DOS attacks, a timeout is set up which terminates
+ * the function if the connection was not authenticated when the timeout
+ * expires.
  *
  * \sa alarm(2), crypt.c, crypt.h
  */
@@ -912,7 +966,7 @@ __noreturn void handle_connect(int fd, const char *peername)
 		goto net_err;
 	/* send Welcome message */
 	ret = write_va_buffer(fd, "This is para_server, version "
-		PACKAGE_VERSION  ".\n"
+		PACKAGE_VERSION ".\n"
 		"Features: sideband,aes_ctr128\n"
 	);
 	if (ret < 0)
@@ -924,11 +978,6 @@ __noreturn void handle_connect(int fd, const char *peername)
 	ret = parse_auth_request(buf, ret, &cc->u, &cf);
 	if (ret < 0)
 		goto net_err;
-	if (!cf.sideband_requested) { /* sideband is mandatory */
-		PARA_ERROR_LOG("client did not request sideband\n");
-		ret = -E_BAD_FEATURE;
-		goto net_err;
-	}
 	if (cc->u) {
 		get_random_bytes_or_die(rand_buf, sizeof(rand_buf));
 		ret = pub_encrypt(cc->u->pubkey, rand_buf, sizeof(rand_buf),
@@ -945,7 +994,7 @@ __noreturn void handle_connect(int fd, const char *peername)
 		numbytes = 256;
 		get_random_bytes_or_die((unsigned char *)buf, numbytes);
 	}
-	PARA_DEBUG_LOG("sending %u byte challenge + session key (%zu bytes)\n",
+	PARA_DEBUG_LOG("sending %d byte challenge + session key (%zu bytes)\n",
 		CHALLENGE_SIZE, numbytes);
 	ret = send_sb(&cc->scc, buf, numbytes, SBD_CHALLENGE, false);
 	buf = NULL;
@@ -985,17 +1034,10 @@ __noreturn void handle_connect(int fd, const char *peername)
 	ret = recv_sb(&cc->scc, SBD_COMMAND, MAX_COMMAND_LEN, &iov);
 	if (ret < 0)
 		goto net_err;
-	ret = parse_sb_command(cc, &iov);
+	ret = run_command(cc, &iov, peername);
+	free(iov.iov_base);
 	if (ret < 0)
 		goto err_out;
-	cc->argc = ret;
-	PARA_NOTICE_LOG("calling com_%s() for %s@%s\n", cc->cmd->name,
-		cc->u->name, peername);
-	ret = cc->cmd->handler(cc);
-	free_argv(cc->argv);
-	mutex_lock(mmd_mutex);
-	mmd->num_commands++;
-	mutex_unlock(mmd_mutex);
 	if (ret >= 0)
 		goto out;
 err_out:
@@ -1007,8 +1049,6 @@ out:
 	free(buf);
 	free(command);
 	mutex_lock(mmd_mutex);
-	if (cc->cmd && (cc->cmd->perms & AFS_WRITE) && ret >= 0)
-		mmd->events++;
 	mmd->active_connections--;
 	mutex_unlock(mmd_mutex);
 	if (ret >= 0) {