2 * Copyright (C) 1997-2012 Andre Noll <maan@systemlinux.org>
4 * Licensed under the GPL v2. For licencing details see COPYING.
7 /** \file command.c Client authentication and server commands. */
12 #include <sys/types.h>
19 #include "server.cmdline.h"
32 #include "user_list.h"
33 #include "server_command_list.h"
34 #include "afs_command_list.h"
38 /** Commands including options must be shorter than this. */
39 #define MAX_COMMAND_LEN 32768
42 extern struct misc_meta_data *mmd;
43 extern struct sender senders[];
44 int send_afs_status(struct stream_cipher_context *scc, int parser_friendly);
46 const char *status_item_list[] = {STATUS_ITEM_ARRAY};
48 static void dummy(__a_unused int s)
52 static void mmd_dup(struct misc_meta_data *new_mmd)
54 mutex_lock(mmd_mutex);
56 mutex_unlock(mmd_mutex);
60 * Compute human readable string containing vss status for given integer value.
62 * We don't want to use vss_playing() and friends here because we take a
63 * snapshot of the mmd struct and use the copy for computing the state of the
64 * vss. If the real data were used, we would take the mmd lock for a rather
65 * long time or risk to get an inconsistent view.
67 static char *vss_status_tohuman(unsigned int flags)
69 if (flags & VSS_PLAYING)
70 return para_strdup("playing");
72 return para_strdup("stopped");
73 return para_strdup("paused");
77 * return human readable permission string. Never returns NULL.
79 static char *cmd_perms_itohuman(unsigned int perms)
81 char *msg = para_malloc(5 * sizeof(char));
83 msg[0] = perms & AFS_READ? 'a' : '-';
84 msg[1] = perms & AFS_WRITE? 'A' : '-';
85 msg[2] = perms & VSS_READ? 'v' : '-';
86 msg[3] = perms & VSS_WRITE? 'V' : '-';
94 static char *vss_get_status_flags(unsigned int flags)
96 char *msg = para_malloc(5 * sizeof(char));
98 msg[0] = (flags & VSS_PLAYING)? 'P' : '_';
99 msg[1] = (flags & VSS_NOMORE)? 'O' : '_';
100 msg[2] = (flags & VSS_NEXT)? 'N' : '_';
101 msg[3] = (flags & VSS_REPOS)? 'R' : '_';
106 static char *get_status(struct misc_meta_data *nmmd, int parser_friendly)
109 char *status, *flags; /* vss status info */
110 /* nobody updates our version of "now" */
111 char *ut = get_server_uptime_str(NULL);
112 long offset = (nmmd->offset + 500) / 1000;
113 struct timeval current_time;
115 struct para_buffer b = {.flags = parser_friendly? PBF_SIZE_PREFIX : 0};
117 /* report real status */
118 status = vss_status_tohuman(nmmd->vss_status_flags);
119 flags = vss_get_status_flags(nmmd->vss_status_flags);
120 if (nmmd->size) { /* parent currently has an audio file open */
121 localtime_r(&nmmd->mtime, &mtime_tm);
122 strftime(mtime, 29, "%b %d %Y", &mtime_tm);
124 gettimeofday(¤t_time, NULL);
126 * The calls to WRITE_STATUS_ITEM() below never fail because
127 * b->max_size is zero (unlimited), see para_printf(). However, clang
128 * is not smart enough to prove this and complains nevertheless.
129 * Casting the return value to void silences solves this.
131 (void)WRITE_STATUS_ITEM(&b, SI_FILE_SIZE, "%zu\n", nmmd->size / 1024);
132 (void)WRITE_STATUS_ITEM(&b, SI_MTIME, "%s\n", mtime);
133 (void)WRITE_STATUS_ITEM(&b, SI_STATUS, "%s\n", status);
134 (void)WRITE_STATUS_ITEM(&b, SI_STATUS_FLAGS, "%s\n", flags);
135 (void)WRITE_STATUS_ITEM(&b, SI_OFFSET, "%li\n", offset);
136 (void)WRITE_STATUS_ITEM(&b, SI_AFS_MODE, "%s\n", mmd->afs_mode_string);
137 (void)WRITE_STATUS_ITEM(&b, SI_STREAM_START, "%lu.%lu\n",
138 (long unsigned)nmmd->stream_start.tv_sec,
139 (long unsigned)nmmd->stream_start.tv_usec);
140 (void)WRITE_STATUS_ITEM(&b, SI_CURRENT_TIME, "%lu.%lu\n",
141 (long unsigned)current_time.tv_sec,
142 (long unsigned)current_time.tv_usec);
149 static int check_sender_args(int argc, char * const * argv, struct sender_command_data *scd)
152 /* this has to match sender.h */
153 const char *subcmds[] = {"add", "delete", "allow", "deny", "on", "off", NULL};
155 scd->sender_num = -1;
157 return -E_COMMAND_SYNTAX;
158 for (i = 0; senders[i].name; i++)
159 if (!strcmp(senders[i].name, argv[1]))
161 PARA_DEBUG_LOG("%d:%s\n", argc, argv[1]);
162 if (!senders[i].name)
163 return -E_COMMAND_SYNTAX;
165 for (i = 0; subcmds[i]; i++)
166 if (!strcmp(subcmds[i], argv[2]))
169 return -E_COMMAND_SYNTAX;
171 if (!senders[scd->sender_num].client_cmds[scd->cmd_num])
172 return -E_SENDER_CMD;
173 switch (scd->cmd_num) {
177 return -E_COMMAND_SYNTAX;
181 if (argc != 4 || parse_cidr(argv[3], scd->host,
182 sizeof(scd->host), &scd->netmask) == NULL)
183 return -E_COMMAND_SYNTAX;
188 return -E_COMMAND_SYNTAX;
189 return parse_fec_url(argv[3], scd);
191 return -E_COMMAND_SYNTAX;
196 int com_sender(struct stream_cipher_context *scc, int argc, char * const * argv)
200 struct sender_command_data scd;
203 for (i = 0; senders[i].name; i++) {
204 char *tmp = make_message("%s%s\n",
205 msg? msg : "", senders[i].name);
209 ret = sc_send_buffer(scc, msg);
213 ret = check_sender_args(argc, argv, &scd);
215 if (scd.sender_num < 0)
217 msg = senders[scd.sender_num].help();
218 ret = sc_send_buffer(scc, msg);
223 switch (scd.cmd_num) {
226 assert(senders[scd.sender_num].resolve_target);
227 ret = senders[scd.sender_num].resolve_target(argv[3], &scd);
232 for (i = 0; i < 10; i++) {
233 mutex_lock(mmd_mutex);
234 if (mmd->sender_cmd_data.cmd_num >= 0) {
235 mutex_unlock(mmd_mutex);
239 memcpy(&mmd->sender_cmd_data, &scd, sizeof(scd));
240 mutex_unlock(mmd_mutex);
243 return (i < 10)? 1 : -E_LOCK;
247 int com_si(struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
251 char *sender_info = NULL;
254 return -E_COMMAND_SYNTAX;
255 mutex_lock(mmd_mutex);
256 for (i = 0; senders[i].name; i++) {
257 char *info = senders[i].info();
258 sender_info = para_strcat(sender_info, info);
261 ut = get_server_uptime_str(now);
262 ret = sc_send_va_buffer(scc, "version: " GIT_VERSION "\n"
263 "up: %s\nplayed: %u\n"
266 "connections (active/accepted/total): %u/%u/%u\n"
267 "current loglevel: %s\n"
268 "supported audio formats: %s\n"
273 mmd->active_connections,
277 SERVER_AUDIO_FORMATS,
280 mutex_unlock(mmd_mutex);
287 int com_version(struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
290 return -E_COMMAND_SYNTAX;
291 return sc_send_buffer(scc, VERSION_TEXT("server")
292 "built: " BUILD_DATE "\n"
293 UNAME_RS ", " CC_VERSION "\n"
297 #define EMPTY_STATUS_ITEMS \
302 ITEM(ATTRIBUTES_BITMAP) \
303 ITEM(ATTRIBUTES_TXT) \
314 ITEM(SECONDS_TOTAL) \
326 * Write a list of audio-file related status items with empty values.
328 * This is used by vss when currently no audio file is open.
330 static char *empty_status_items(int parser_friendly)
334 #define ITEM(x) "0004 %02x:\n"
337 #define ITEM(x) , SI_ ## x
342 #define ITEM(x) "%s:\n"
345 #define ITEM(x) ,status_item_list[SI_ ## x]
350 #undef EMPTY_STATUS_ITEMS
353 int com_stat(struct stream_cipher_context *scc, int argc, char * const * argv)
356 struct misc_meta_data tmp, *nmmd = &tmp;
359 int parser_friendly = 0;
361 para_sigaction(SIGUSR1, dummy);
363 for (i = 1; i < argc; i++) {
364 const char *arg = argv[i];
367 if (!strcmp(arg, "--")) {
371 if (!strncmp(arg, "-n=", 3)) {
372 ret = para_atoi32(arg + 3, &num);
377 if (!strcmp(arg, "-p")) {
381 return -E_COMMAND_SYNTAX;
384 return -E_COMMAND_SYNTAX;
387 s = get_status(nmmd, parser_friendly);
388 ret = sc_send_buffer(scc, s);
392 if (nmmd->vss_status_flags & VSS_NEXT) {
395 esi = empty_status_items(parser_friendly);
396 ret = sc_send_buffer(scc, esi);
400 send_afs_status(scc, parser_friendly);
402 if (num > 0 && !--num)
406 return -E_SERVER_CRASH;
412 static int send_list_of_commands(struct stream_cipher_context *scc, struct server_command *cmd,
417 for (i = 1; cmd->name; cmd++, i++) {
418 char *perms = cmd_perms_itohuman(cmd->perms);
419 ret = sc_send_va_buffer(scc, "%s\t%s\t%s\t%s\n", cmd->name,
430 /* returns string that must be freed by the caller */
431 static struct server_command *get_cmd_ptr(const char *name, char **handler)
433 struct server_command *cmd;
435 for (cmd = server_cmds; cmd->name; cmd++)
436 if (!strcmp(cmd->name, name)) {
438 *handler = para_strdup("server"); /* server commands */
441 /* not found, look for commands supported by afs */
442 for (cmd = afs_cmds; cmd->name; cmd++)
443 if (!strcmp(cmd->name, name)) {
445 *handler = para_strdup("afs");
452 int com_help(struct stream_cipher_context *scc, int argc, char * const * argv)
454 struct server_command *cmd;
455 char *perms, *handler;
459 /* no argument given, print list of commands */
460 if ((ret = send_list_of_commands(scc, server_cmds, "server")) < 0)
462 return send_list_of_commands(scc, afs_cmds, "afs");
464 /* argument given for help */
465 cmd = get_cmd_ptr(argv[1], &handler);
468 perms = cmd_perms_itohuman(cmd->perms);
469 ret = sc_send_va_buffer(scc,
488 int com_hup(__a_unused struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
491 return -E_COMMAND_SYNTAX;
492 kill(getppid(), SIGHUP);
497 int com_term(__a_unused struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
500 return -E_COMMAND_SYNTAX;
501 kill(getppid(), SIGTERM);
505 int com_play(__a_unused struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
508 return -E_COMMAND_SYNTAX;
509 mutex_lock(mmd_mutex);
510 mmd->new_vss_status_flags |= VSS_PLAYING;
511 mmd->new_vss_status_flags &= ~VSS_NOMORE;
512 mutex_unlock(mmd_mutex);
518 int com_stop(__a_unused struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
521 return -E_COMMAND_SYNTAX;
522 mutex_lock(mmd_mutex);
523 mmd->new_vss_status_flags &= ~VSS_PLAYING;
524 mmd->new_vss_status_flags &= ~VSS_REPOS;
525 mmd->new_vss_status_flags |= VSS_NEXT;
526 mutex_unlock(mmd_mutex);
531 int com_pause(__a_unused struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
534 return -E_COMMAND_SYNTAX;
535 mutex_lock(mmd_mutex);
536 if (!vss_paused() && !vss_stopped()) {
538 mmd->new_vss_status_flags &= ~VSS_PLAYING;
539 mmd->new_vss_status_flags &= ~VSS_NEXT;
541 mutex_unlock(mmd_mutex);
546 int com_next(__a_unused struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
549 return -E_COMMAND_SYNTAX;
550 mutex_lock(mmd_mutex);
552 mmd->new_vss_status_flags |= VSS_NEXT;
553 mutex_unlock(mmd_mutex);
558 int com_nomore(__a_unused struct stream_cipher_context *scc, int argc, __a_unused char * const * argv)
561 return -E_COMMAND_SYNTAX;
562 mutex_lock(mmd_mutex);
563 if (vss_playing() || vss_paused())
564 mmd->new_vss_status_flags |= VSS_NOMORE;
565 mutex_unlock(mmd_mutex);
570 int com_ff(__a_unused struct stream_cipher_context *scc, int argc, char * const * argv)
573 int ret, backwards = 0;
578 return -E_COMMAND_SYNTAX;
579 if (!(ret = sscanf(argv[1], "%u%c", &i, &c)))
580 return -E_COMMAND_SYNTAX;
581 if (ret > 1 && c == '-')
582 backwards = 1; /* jmp backwards */
583 mutex_lock(mmd_mutex);
584 ret = -E_NO_AUDIO_FILE;
585 if (!mmd->afd.afhi.chunks_total || !mmd->afd.afhi.seconds_total)
587 promille = (1000 * mmd->current_chunk) / mmd->afd.afhi.chunks_total;
589 promille -= 1000 * i / mmd->afd.afhi.seconds_total;
591 promille += 1000 * i / mmd->afd.afhi.seconds_total;
594 if (promille > 1000) {
595 mmd->new_vss_status_flags |= VSS_NEXT;
598 mmd->repos_request = (mmd->afd.afhi.chunks_total * promille) / 1000;
599 mmd->new_vss_status_flags |= VSS_REPOS;
600 mmd->new_vss_status_flags &= ~VSS_NEXT;
604 mutex_unlock(mmd_mutex);
609 int com_jmp(__a_unused struct stream_cipher_context *scc, int argc, char * const * argv)
615 return -E_COMMAND_SYNTAX;
616 if (sscanf(argv[1], "%lu", &i) <= 0)
617 return -E_COMMAND_SYNTAX;
618 mutex_lock(mmd_mutex);
619 ret = -E_NO_AUDIO_FILE;
620 if (!mmd->afd.afhi.chunks_total)
624 PARA_INFO_LOG("jumping to %lu%%\n", i);
625 mmd->repos_request = (mmd->afd.afhi.chunks_total * i + 50)/ 100;
626 PARA_INFO_LOG("sent: %lu, offset before jmp: %lu\n",
627 mmd->chunks_sent, mmd->offset);
628 mmd->new_vss_status_flags |= VSS_REPOS;
629 mmd->new_vss_status_flags &= ~VSS_NEXT;
633 mutex_unlock(mmd_mutex);
638 * check if perms are sufficient to exec a command having perms cmd_perms.
639 * Returns 0 if perms are sufficient, -E_PERM otherwise.
641 static int check_perms(unsigned int perms, struct server_command *cmd_ptr)
643 PARA_DEBUG_LOG("checking permissions\n");
644 return (cmd_ptr->perms & perms) < cmd_ptr->perms ? -E_PERM : 0;
648 * Parse first string from *cmd and lookup in table of valid commands.
649 * On error, NULL is returned.
651 static struct server_command *parse_cmd(const char *cmdstr)
656 sscanf(cmdstr, "%200s%n", buf, &n);
660 return get_cmd_ptr(buf, NULL);
663 static int read_command(struct stream_cipher_context *scc, char **result)
667 char *command = NULL;
673 ret = sc_recv_buffer(scc, buf, sizeof(buf));
679 ret = -E_COMMAND_SYNTAX;
680 if (command && numbytes + strlen(command) > MAX_COMMAND_LEN) /* DOS */
682 command = para_strcat(command, buf);
683 p = strstr(command, EOC_MSG);
689 ret = command? 1 : -E_COMMAND_SYNTAX;
699 static void reset_signals(void)
701 para_sigaction(SIGCHLD, SIG_IGN);
702 para_sigaction(SIGINT, SIG_DFL);
703 para_sigaction(SIGTERM, SIG_DFL);
704 para_sigaction(SIGHUP, SIG_DFL);
708 * Perform user authentication and execute a command.
710 * \param fd The file descriptor to send output to.
711 * \param peername Identifies the connecting peer.
713 * Whenever para_server accepts an incoming tcp connection on
714 * the port it listens on, it forks and the resulting child
715 * calls this function.
717 * An RSA-based challenge/response is used to authenticate
718 * the peer. It that authentication succeeds, a random
719 * session key is generated and sent back to the peer,
720 * encrypted with its RSA public key. From this point on,
721 * all transfers are crypted with this session key.
723 * Next it is checked if the peer supplied a valid server command or a command
724 * for the audio file selector. If yes, and if the user has sufficient
725 * permissions to execute that command, the function calls the corresponding
726 * command handler which does argument checking and further processing.
728 * In order to cope with a DOS attacks, a timeout is set up
729 * which terminates the function if the connection was not
730 * authenticated when the timeout expires.
732 * \sa alarm(2), crypt.c, crypt.h
734 __noreturn void handle_connect(int fd, const char *peername)
738 unsigned char rand_buf[CHALLENGE_SIZE + 2 * SESSION_KEY_LEN];
739 unsigned char challenge_hash[HASH_SIZE];
741 struct server_command *cmd = NULL;
743 char *p, *command = NULL;
745 struct stream_cipher_context scc = {.fd = fd};
748 /* we need a blocking fd here as recv() might return EAGAIN otherwise. */
749 ret = mark_fd_blocking(fd);
752 /* send Welcome message */
753 ret = send_va_buffer(fd, "This is para_server, version "
754 PACKAGE_VERSION ".\n" );
757 /* recv auth request line */
758 ret = recv_buffer(fd, buf, sizeof(buf));
762 ret = -E_AUTH_REQUEST;
765 ret = -E_AUTH_REQUEST;
766 if (strncmp(buf, AUTH_REQUEST_MSG, strlen(AUTH_REQUEST_MSG)))
768 p = buf + strlen(AUTH_REQUEST_MSG);
769 PARA_DEBUG_LOG("received auth request for user %s\n", p);
772 get_random_bytes_or_die(rand_buf, sizeof(rand_buf));
773 ret = pub_encrypt(u->pubkey, rand_buf, sizeof(rand_buf),
774 (unsigned char *)buf);
780 * We don't want to reveal our user names, so we send a
781 * challenge to the client even if the user does not exist, and
782 * fail the authentication later.
785 get_random_bytes_or_die((unsigned char *)buf, numbytes);
787 PARA_DEBUG_LOG("sending %u byte challenge + rc4 keys (%zu bytes)\n",
788 CHALLENGE_SIZE, numbytes);
789 ret = send_bin_buffer(fd, buf, numbytes);
792 /* recv challenge response */
793 ret = recv_bin_buffer(fd, buf, HASH_SIZE);
797 PARA_DEBUG_LOG("received %d bytes challenge response\n", ret);
802 * The correct response is the hash of the first CHALLENGE_SIZE bytes
803 * of the random data.
806 if (numbytes != HASH_SIZE)
808 hash_function((char *)rand_buf, CHALLENGE_SIZE, challenge_hash);
809 if (memcmp(challenge_hash, buf, HASH_SIZE))
811 /* auth successful */
813 PARA_INFO_LOG("good auth for %s\n", u->name);
814 /* init stream cipher keys with the second part of the random buffer */
815 scc.recv = sc_new(rand_buf + CHALLENGE_SIZE, SESSION_KEY_LEN);
816 scc.send = sc_new(rand_buf + CHALLENGE_SIZE + SESSION_KEY_LEN, SESSION_KEY_LEN);
817 ret = sc_send_buffer(&scc, PROCEED_MSG);
820 ret = read_command(&scc, &command);
821 if (ret == -E_COMMAND_SYNTAX)
826 cmd = parse_cmd(command);
829 /* valid command, check permissions */
830 ret = check_perms(u->perms, cmd);
833 /* valid command and sufficient perms */
834 ret = create_argv(command, "\n", &argv);
838 PARA_NOTICE_LOG("calling com_%s() for %s@%s\n", cmd->name, u->name,
840 ret = cmd->handler(&scc, argc, argv);
842 mutex_lock(mmd_mutex);
844 mutex_unlock(mmd_mutex);
848 sc_send_va_buffer(&scc, "%s\n", para_strerror(-ret));
850 PARA_NOTICE_LOG("%s\n", para_strerror(-ret));
855 mutex_lock(mmd_mutex);
856 if (cmd && (cmd->perms & AFS_WRITE) && ret >= 0)
858 mmd->active_connections--;
859 mutex_unlock(mmd_mutex);
860 exit(ret < 0? EXIT_FAILURE : EXIT_SUCCESS);