log: more general error message formatting

[disorder] / clients / disorder.c

/*
 * This file is part of DisOrder.
 * Copyright (C) 2004-2013 Richard Kettlewell
 *
 * 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 <http://www.gnu.org/licenses/>.
 */
/** @file clients/disorder.c
 * @brief Command-line client
 */

#include "common.h"

#include <getopt.h>
#include <sys/types.h>
#if HAVE_SYS_SOCKET_H
# include <sys/socket.h>
#endif
#if HAVE_SYS_UN_H
# include <sys/un.h>
#endif
#include <errno.h>
#include <locale.h>
#include <time.h>
#include <stddef.h>
#if HAVE_UNISTD_H
# include <unistd.h>
#endif
#if HAVE_PCRE_H
# include <pcre.h>
#endif
#include <ctype.h>
#if HAVE_GCRYPT_H
# include <gcrypt.h>
#endif
#if HAVE_LANGINFO_H
# include <langinfo.h>
#endif

#include "configuration.h"
#include "syscalls.h"
#include "log.h"
#include "queue.h"
#include "client.h"
#include "wstat.h"
#include "table.h"
#include "charset.h"
#include "kvp.h"
#include "split.h"
#include "sink.h"
#include "mem.h"
#include "defs.h"
#include "authorize.h"
#include "vector.h"
#include "version.h"
#include "dateparse.h"
#include "inputline.h"

static disorder_client *client;

static const struct option options[] = {
  { "help", no_argument, 0, 'h' },
  { "version", no_argument, 0, 'V' },
  { "config", required_argument, 0, 'c' },
  { "debug", no_argument, 0, 'd' },
  { "local", no_argument, 0, 'l' },
  { "no-per-user-config", no_argument, 0, 'N' },
  { "help-commands", no_argument, 0, 'H' },
  { "user", required_argument, 0, 'u' },
  { "password", required_argument, 0, 'p' },
  { 0, 0, 0, 0 }
};

/* display usage message and terminate */
static void help(void) {
  xprintf("Usage:\n"
	  "  disorder [OPTIONS] COMMAND ...\n"
	  "Options:\n"
	  "  --help, -h              Display usage message\n"
	  "  --help-commands, -H     List commands\n"
	  "  --version, -V           Display version number\n"
	  "  --config PATH, -c PATH  Set configuration file\n"
	  "  --local, -l             Force connection to local server\n"
	  "  --debug, -d             Turn on debugging\n");
  xfclose(stdout);
  exit(0);
}

static disorder_client *getclient(void) {
  if(!client) {
    if(!(client = disorder_new(1))) exit(EXIT_FAILURE);
    if(disorder_connect(client)) exit(EXIT_FAILURE);
  }
  return client;
}

static void cf_version(char attribute((unused)) **argv) {
  char *v;

  if(disorder_version(getclient(), &v)) exit(EXIT_FAILURE);
  v = nullcheck(utf82mb_f(v));
  xprintf("%s\n", v);
  xfree(v);
}

static void print_queue_entry(const struct queue_entry *q) {
  if(q->track) xprintf("track %s\n", nullcheck(utf82mb(q->track)));
  if(q->id) xprintf("  id %s\n", nullcheck(utf82mb(q->id)));
  switch(q->origin) {
  case origin_adopted:
  case origin_picked:
  case origin_scheduled:
    xprintf("  %s by %s at %s",
            track_origins[q->origin],
            nullcheck(utf82mb(q->submitter)), ctime(&q->when));
    break;
  default:
    break;
  }
  if(q->played) xprintf("  played at %s", ctime(&q->played));
  if(q->state == playing_started
     || q->state == playing_paused) xprintf("  %lds so far",  q->sofar);
  else if(q->expected) xprintf("  might start at %s", ctime(&q->expected));
  if(q->scratched) xprintf("  scratched by %s\n",
			   nullcheck(utf82mb(q->scratched)));
  else xprintf("  %s\n", playing_states[q->state]);
  if(q->wstat) xprintf("  %s\n", wstat(q->wstat));
}

static void cf_playing(char attribute((unused)) **argv) {
  struct queue_entry *q;

  if(disorder_playing(getclient(), &q)) exit(EXIT_FAILURE);
  if(q)
    print_queue_entry(q);
  else
    xprintf("nothing\n");
}

static void cf_play(char **argv) {
  char *id;
  while(*argv)
    if(disorder_play(getclient(), *argv++, &id)) exit(EXIT_FAILURE);
}

static void cf_remove(char **argv) {
  if(disorder_remove(getclient(), argv[0])) exit(EXIT_FAILURE);
}

static void cf_disable(char attribute((unused)) **argv) {
  if(disorder_disable(getclient())) exit(EXIT_FAILURE);
}

static void cf_enable(char attribute((unused)) **argv) {
  if(disorder_enable(getclient())) exit(EXIT_FAILURE);
}

static void cf_scratch(char **argv) {
  if(disorder_scratch(getclient(), argv[0])) exit(EXIT_FAILURE);
}

static void cf_shutdown(char attribute((unused)) **argv) {
  if(disorder_shutdown(getclient())) exit(EXIT_FAILURE);
}

static void cf_reconfigure(char attribute((unused)) **argv) {
  /* Re-check configuration for server */
  if(config_read(1, NULL))
    disorder_fatal(0, "cannot read configuration");
  if(disorder_reconfigure(getclient())) exit(EXIT_FAILURE);
}

static void cf_rescan(char attribute((unused)) **argv) {
  if(disorder_rescan(getclient())) exit(EXIT_FAILURE);
}

static void cf_somequeue(int (*fn)(disorder_client *c,
				   struct queue_entry **qp)) {
  struct queue_entry *q, *qbase;

  if(fn(getclient(), &qbase)) exit(EXIT_FAILURE);
  for(q = qbase; q; q = q->next)
    print_queue_entry(q);
  queue_free(qbase, 1);
}

static void cf_recent(char attribute((unused)) **argv) {
  cf_somequeue(disorder_recent);
}

static void cf_queue(char attribute((unused)) **argv) {
  cf_somequeue(disorder_queue);
}

static void cf_quack(char attribute((unused)) **argv) {
  if(!strcasecmp(nl_langinfo(CODESET), "utf-8")) {
#define TL "\xE2\x95\xAD"
#define TR "\xE2\x95\xAE"
#define BR "\xE2\x95\xAF"
#define BL "\xE2\x95\xB0"
#define H "\xE2\x94\x80"
#define V "\xE2\x94\x82"
#define T "\xE2\x94\xAC"
    xprintf("\n"
            " "TL H H H H H H H H H H H H H H H H H H TR"\n"
            " "V" Naath is a babe! "V"\n"
            " "BL H H H H H H H H H T H H H H H H H H BR"\n"
            "            \\\n"
            "              >0\n"
            "               (<)'\n"
            "~~~~~~~~~~~~~~~~~~~~~~\n"
            "\n");
  } else {
    xprintf("\n"
            " .------------------.\n"
            " | Naath is a babe! |\n"
            " `---------+--------'\n"
            "            \\\n"
            "              >0\n"
            "               (<)'\n"
            "~~~~~~~~~~~~~~~~~~~~~~\n"
            "\n");
  }
}

static void cf_somelist(char **argv,
			int (*fn)(disorder_client *c,
				  const char *arg, const char *re,
				  char ***vecp, int *nvecp)) {
  char **vec, **base;
  const char *re;

  if(argv[1])
    re = xstrdup(argv[1] + 1);
  else
    re = 0;
  if(fn(getclient(), argv[0], re, &base, 0)) exit(EXIT_FAILURE);
  for(vec = base; *vec; ++vec)
    xprintf("%s\n", nullcheck(utf82mb_f(*vec)));
  xfree(base);
}

static int isarg_regexp(const char *s) {
  return s[0] == '~';
}

static void cf_dirs(char **argv) {
  cf_somelist(argv, disorder_dirs);
}

static void cf_files(char **argv) {
  cf_somelist(argv, disorder_files);
}

static void cf_allfiles(char **argv) {
  cf_somelist(argv, disorder_allfiles);
}

static void cf_get(char **argv) {
  char *value;

  if(disorder_get(getclient(), argv[0], argv[1], &value)) exit(EXIT_FAILURE);
  xprintf("%s\n", nullcheck(utf82mb_f(value)));
}

static void cf_length(char **argv) {
  long length;

  if(disorder_length(getclient(), argv[0], &length)) exit(EXIT_FAILURE);
  xprintf("%ld\n", length);
}

static void cf_set(char **argv) {
  if(disorder_set(getclient(), argv[0], argv[1], argv[2])) exit(EXIT_FAILURE);
}

static void cf_unset(char **argv) {
  if(disorder_unset(getclient(), argv[0], argv[1])) exit(EXIT_FAILURE);
}

static void cf_prefs(char **argv) {
  struct kvp *k, *base;

  if(disorder_prefs(getclient(), argv[0], &base)) exit(EXIT_FAILURE);
  for(k = base; k; k = k->next)
    xprintf("%s = %s\n",
	    nullcheck(utf82mb(k->name)), nullcheck(utf82mb(k->value)));
  kvp_free(base);
}

static void cf_search(char **argv) {
  char **results;
  int nresults, n;

  if(disorder_search(getclient(), *argv, &results, &nresults)) exit(EXIT_FAILURE);
  for(n = 0; n < nresults; ++n)
    xprintf("%s\n", nullcheck(utf82mb(results[n])));
  free_strings(nresults, results);
}

static void cf_random_disable(char attribute((unused)) **argv) {
  if(disorder_random_disable(getclient())) exit(EXIT_FAILURE);
}

static void cf_random_enable(char attribute((unused)) **argv) {
  if(disorder_random_enable(getclient())) exit(EXIT_FAILURE);
}

static void cf_stats(char attribute((unused)) **argv) {
  char **vec;
  int nvec;

  if(disorder_stats(getclient(), &vec, &nvec)) exit(EXIT_FAILURE);
  for(int n = 0; n < nvec; ++n)
    xprintf("%s\n", nullcheck(utf82mb(vec[n])));
  free_strings(nvec, vec);
}

static void cf_get_volume(char attribute((unused)) **argv) {
  long l, r;

  if(disorder_get_volume(getclient(), &l, &r)) exit(EXIT_FAILURE);
  xprintf("%ld %ld\n", l, r);
}

static void cf_set_volume(char **argv) {
  if(disorder_set_volume(getclient(), atoi(argv[0]), atoi(argv[1]))) exit(EXIT_FAILURE);
}

static void cf_log(char attribute((unused)) **argv) {
  if(disorder_log(getclient(), sink_stdio("stdout", stdout))) exit(EXIT_FAILURE);
}

static void cf_move(char **argv) {
  long n;
  int e;
  
  if((e = xstrtol(&n, argv[1], 0, 10)))
    disorder_fatal(e, "cannot convert '%s'", argv[1]);
  if(n > INT_MAX || n < INT_MIN)
    disorder_fatal(e, "%ld out of range", n);
  if(disorder_move(getclient(), argv[0], (int)n)) exit(EXIT_FAILURE);
}

static void cf_part(char **argv) {
  char *s;

  if(disorder_part(getclient(), argv[0], argv[1], argv[2], &s)) exit(EXIT_FAILURE);
  xprintf("%s\n", nullcheck(utf82mb_f(s)));
}

static int isarg_filename(const char *s) {
  return s[0] == '/';
}

static void cf_authorize(char **argv) {
  authorize(getclient(), argv[0], argv[1]);
}

static void cf_resolve(char **argv) {
  char *track;

  if(disorder_resolve(getclient(), argv[0], &track)) exit(EXIT_FAILURE);
  xprintf("%s\n", nullcheck(utf82mb_f(track)));
}

static void cf_pause(char attribute((unused)) **argv) {
  if(disorder_pause(getclient())) exit(EXIT_FAILURE);
}

static void cf_resume(char attribute((unused)) **argv) {
  if(disorder_resume(getclient())) exit(EXIT_FAILURE);
}

static void cf_tags(char attribute((unused)) **argv) {
  char **vec;

  if(disorder_tags(getclient(), &vec, 0)) exit(EXIT_FAILURE);
  while(*vec)
      xprintf("%s\n", nullcheck(utf82mb(*vec++)));
}

static void cf_users(char attribute((unused)) **argv) {
  char **vec;

  if(disorder_users(getclient(), &vec, 0)) exit(EXIT_FAILURE);
  while(*vec)
    xprintf("%s\n", nullcheck(utf82mb(*vec++)));
}

static void cf_get_global(char **argv) {
  char *value;

  if(disorder_get_global(getclient(), argv[0], &value)) exit(EXIT_FAILURE);
  xprintf("%s\n", nullcheck(utf82mb_f(value)));
}

static void cf_set_global(char **argv) {
  if(disorder_set_global(getclient(), argv[0], argv[1])) exit(EXIT_FAILURE);
}

static void cf_unset_global(char **argv) {
  if(disorder_unset_global(getclient(), argv[0])) exit(EXIT_FAILURE);
}

static int isarg_integer(const char *s) {
  if(!*s) return 0;
  while(*s) {
    if(!isdigit((unsigned char)*s))
      return 0;
    ++s;
  }
  return 1;
}

static void cf_new(char **argv) {
  char **vec;

  if(disorder_new_tracks(getclient(), argv[0] ? atol(argv[0]) : 0, &vec, 0))
    exit(EXIT_FAILURE);
  while(*vec)
    xprintf("%s\n", nullcheck(utf82mb(*vec++)));
}

static void cf_rtp_address(char attribute((unused)) **argv) {
  char *address, *port;

  if(disorder_rtp_address(getclient(), &address, &port)) exit(EXIT_FAILURE);
  xprintf("address: %s\nport: %s\n", address, port);
}

static int isarg_rights(const char *arg) {
  return strchr(arg, ',') || !parse_rights(arg, 0, 0);
}

static void cf_adduser(char **argv) {
  if(disorder_adduser(getclient(), argv[0], argv[1], argv[2]))
    exit(EXIT_FAILURE);
}

static void cf_deluser(char **argv) {
  if(disorder_deluser(getclient(), argv[0]))
    exit(EXIT_FAILURE);
}

static void cf_edituser(char **argv) {
  if(disorder_edituser(getclient(), argv[0], argv[1], argv[2]))
    exit(EXIT_FAILURE);
}

static void cf_userinfo(char **argv) {
  char *s;

  if(disorder_userinfo(getclient(), argv[0], argv[1], &s))
    exit(EXIT_FAILURE);
  xprintf("%s\n", nullcheck(utf82mb_f(s)));
}

static int isarg_option(const char *arg) {
  return arg[0] == '-';
}

static int argvlen(char **argv) {
  char **start = argv;
  
  while(*argv)
    ++argv;
  return argv - start;
}

static const struct option setup_guest_options[] = {
  { "help", no_argument, 0, 'h' },
  { "online-registration", no_argument, 0, 'r' },
  { "no-online-registration", no_argument, 0, 'R' },
  { 0, 0, 0, 0 }
};

static void help_setup_guest(void) {
  xprintf("Usage:\n"
	  "  disorder setup-guest [OPTIONS]\n"
	  "Options:\n"
	  "  --help, -h                Display usage message\n"
	  "  --online-registration     Enable online registration (default)\n"
	  "  --no-online-registration  Disable online registration\n");
  xfclose(stdout);
  exit(0);
}

static void cf_setup_guest(char **argv) {
  int n, online_registration = 1;
  
  while((n = getopt_long(argvlen(argv) + 1, argv - 1,
			 "hrR", setup_guest_options, 0)) >= 0) {
    switch(n) {
    case 'h': help_setup_guest();
    case 'r': online_registration = 1; break;
    case 'R': online_registration = 0; break;
    default: disorder_fatal(0, "invalid option");
    }
  }
  if(online_registration && !config->mail_sender)
    disorder_fatal(0, "you MUST set mail_sender if you want online registration");
  if(disorder_adduser(getclient(), "guest", "",
		      online_registration ? "read,register" : "read"))
    exit(EXIT_FAILURE);
}

/** @brief A scheduled event read from the server */
struct scheduled_event {
  /** @brief When event should occur */
  time_t when;

  /** @brief Details of action */
  struct kvp *actiondata;

  /** @brief Event ID */
  char *id;
};

static int compare_event(const void *av, const void *bv) {
  struct scheduled_event *a = (void *)av, *b = (void *)bv;

  /* Primary sort key is the trigger time */
  if(a->when < b->when)
    return -1;
  else if(a->when > b->when)
    return 1;
  /* For events that go off at the same time just sort by ID */
  return strcmp(a->id, b->id);
}

static void cf_schedule_list(char attribute((unused)) **argv) {
  char **ids;
  int nids, n;
  struct scheduled_event *events;
  char tb[128];
  const char *action, *key, *value, *priority;
  int prichar;

  /* Get all known events */
  if(disorder_schedule_list(getclient(), &ids, &nids))
    exit(EXIT_FAILURE);
  events = xcalloc(nids, sizeof *events);
  for(n = 0; n < nids; ++n) {
    events[n].id = ids[n];
    if(disorder_schedule_get(getclient(), ids[n], &events[n].actiondata))
      exit(EXIT_FAILURE);
    events[n].when = atoll(kvp_get(events[n].actiondata, "when"));
  }
  /* Sort by trigger time */
  qsort(events, nids, sizeof *events, compare_event);
  /* Display them */
  for(n = 0; n < nids; ++n) {
    strftime(tb, sizeof tb, "%Y-%m-%d %H:%M:%S %Z", localtime(&events[n].when));
    action = kvp_get(events[n].actiondata, "action");
    priority = kvp_get(events[n].actiondata, "priority");
    if(!strcmp(priority, "junk"))
      prichar = 'J';
    else if(!strcmp(priority, "normal"))
      prichar = 'N';
    else
      prichar = '?';
    xprintf("%11s %-25s %c %-8s %s",
	    events[n].id, tb, prichar, kvp_get(events[n].actiondata, "who"),
	    action);
    if(!strcmp(action, "play"))
      xprintf(" %s",
	      nullcheck(utf82mb(kvp_get(events[n].actiondata, "track"))));
    else if(!strcmp(action, "set-global")) {
      key = kvp_get(events[n].actiondata, "key");
      value = kvp_get(events[n].actiondata, "value");
      if(value)
	xprintf(" %s=%s",
		nullcheck(utf82mb(key)),
		nullcheck(utf82mb(value)));
      else
	xprintf(" %s unset",
		nullcheck(utf82mb(key)));
    }
    xprintf("\n");
  }
}

static void cf_schedule_del(char **argv) {
  if(disorder_schedule_del(getclient(), argv[0]))
    exit(EXIT_FAILURE);
}

static void cf_schedule_play(char **argv) {
  if(disorder_schedule_add_play(getclient(),
                                dateparse(argv[0]),
                                argv[1],
                                argv[2]))
    exit(EXIT_FAILURE);
}

static void cf_schedule_set_global(char **argv) {
  if(disorder_schedule_add_set_global(getclient(),
                                      dateparse(argv[0]),
                                      argv[1],
                                      argv[2],
                                      argv[3]))
    exit(EXIT_FAILURE);
}

static void cf_schedule_unset_global(char **argv) {
  if(disorder_schedule_add_unset_global(getclient(),
                                        dateparse(argv[0]),
                                        argv[1],
                                        argv[2]))
    exit(EXIT_FAILURE);
}

static void cf_adopt(char **argv) {
  if(disorder_adopt(getclient(), argv[0]))
    exit(EXIT_FAILURE);
}

static void cf_playlists(char attribute((unused)) **argv) {
  char **vec;
  int nvec;

  if(disorder_playlists(getclient(), &vec, &nvec))
    exit(EXIT_FAILURE);
  for(int n = 0; n < nvec; ++n)
    xprintf("%s\n", nullcheck(utf82mb(vec[n])));
  free_strings(nvec, vec);
}

static void cf_playlist_del(char **argv) {
  if(disorder_playlist_delete(getclient(), argv[0]))
    exit(EXIT_FAILURE);
}

static void cf_playlist_get(char **argv) {
  char **vec;
  int nvec;

  if(disorder_playlist_get(getclient(), argv[0], &vec, &nvec))
    exit(EXIT_FAILURE);
  for(int n = 0; n < nvec; ++n)
    xprintf("%s\n", nullcheck(utf82mb(vec[n])));
  free_strings(nvec, vec);
}

static void cf_playlist_set(char **argv) {
  struct vector v[1];
  FILE *input;
  const char *tag;
  char *l;

  if(argv[1]) {
    // Read track list from file
    if(!(input = fopen(argv[1], "r")))
      disorder_fatal(errno, "opening %s", argv[1]);
    tag = argv[1];
  } else {
    // Read track list from standard input
    input = stdin;
    tag = "stdin";
  }
  vector_init(v);
  while(!inputline(tag, input, &l, '\n')) {
    if(!strcmp(l, "."))
      break;
    vector_append(v, l);
  }
  if(ferror(input))
    disorder_fatal(errno, "reading %s", tag);
  if(input != stdin)
    fclose(input);
  if(disorder_playlist_lock(getclient(), argv[0])
     || disorder_playlist_set(getclient(), argv[0], v->vec, v->nvec)
     || disorder_playlist_unlock(getclient()))
    exit(EXIT_FAILURE);
}

/** @brief Command-line client's definition of a command */
static const struct client_command {
  /** @brief Command name */
  const char *name;

  /** @brief Minimum number of argument */
  int min;

  /** @brief Maximum number of argument */
  int max;

  /** @brief Pointer to function implementing command */
  void (*fn)(char **);

  /** @brief Function to recognize a valid argument, or NULL */
  int (*isarg)(const char *);

  /** @brief Summary of arguments */
  const char *argstr;

  /** @brief Description */
  const char *desc;
} commands[] = {
  { "adduser",        2, 3, cf_adduser, isarg_rights, "USERNAME PASSWORD [RIGHTS]",
                      "Create a new user" },
  { "adopt",          1, 1, cf_adopt, 0, "ID",
                      "Adopt a randomly picked track" },
  { "allfiles",       1, 2, cf_allfiles, isarg_regexp, "DIR [~REGEXP]",
                      "List all files and directories in DIR" },
  { "authorize",      1, 2, cf_authorize, isarg_rights, "USERNAME [RIGHTS]",
                      "Authorize user USERNAME to connect" },
  { "deluser",        1, 1, cf_deluser, 0, "USERNAME",
                      "Delete user USERNAME" },
  { "dirs",           1, 2, cf_dirs, isarg_regexp, "DIR [~REGEXP]",
                      "List directories in DIR" },
  { "disable",        0, 0, cf_disable, 0, "",
                      "Disable play" },
  { "disable-random", 0, 0, cf_random_disable, 0, "",
                      "Disable random play" },
  { "edituser",       3, 3, cf_edituser, 0, "USERNAME PROPERTY VALUE",
                      "Set a property of user USERNAME" },
  { "enable",         0, 0, cf_enable, 0, "",
                      "Enable play" },
  { "enable-random",  0, 0, cf_random_enable, 0, "",
                      "Enable random play" },
  { "files",          1, 2, cf_files, isarg_regexp, "DIR [~REGEXP]",
                      "List files in DIR" },
  { "get",            2, 2, cf_get, 0, "TRACK NAME",
                      "Get a preference value" },
  { "get-global",     1, 1, cf_get_global, 0, "NAME",
                      "Get a global preference value" },
  { "get-volume",     0, 0, cf_get_volume, 0, "",
                      "Get the current volume" },
  { "length",         1, 1, cf_length, 0, "TRACK",
                      "Get the length of TRACK in seconds" },
  { "log",            0, 0, cf_log, 0, "",
                      "Copy event log to stdout" },
  { "move",           2, 2, cf_move, 0, "TRACK DELTA",
                      "Move a track in the queue" },
  { "new",            0, 1, cf_new, isarg_integer, "[MAX]",
                      "Get the most recently added MAX tracks" },
  { "part",           3, 3, cf_part, 0, "TRACK CONTEXT PART",
                      "Find a track name part" },
  { "pause",          0, 0, cf_pause, 0, "",
                      "Pause the currently playing track" },
  { "play",           1, INT_MAX, cf_play, isarg_filename, "TRACKS...",
                      "Add TRACKS to the end of the queue" },
  { "playing",        0, 0, cf_playing, 0, "",
                      "Report the playing track" },
  { "playlist-del",   1, 1, cf_playlist_del, 0, "PLAYLIST",
                      "Delete a playlist" },
  { "playlist-get",   1, 1, cf_playlist_get, 0, "PLAYLIST",
                      "Get the contents of a playlist" },
  { "playlist-set",   1, 2, cf_playlist_set, isarg_filename, "PLAYLIST [PATH]",
                      "Set the contents of a playlist" },
  { "playlists",      0, 0, cf_playlists, 0, "",
                      "List playlists" },
  { "prefs",          1, 1, cf_prefs, 0, "TRACK",
                      "Display all the preferences for TRACK" },
  { "quack",          0, 0, cf_quack, 0, 0, 0 },
  { "queue",          0, 0, cf_queue, 0, "",
                      "Display the current queue" },
  { "random-disable", 0, 0, cf_random_disable, 0, "",
                      "Disable random play" },
  { "random-enable",  0, 0, cf_random_enable, 0, "",
                      "Enable random play" },
  { "recent",         0, 0, cf_recent, 0, "",
                      "Display recently played track" },
  { "reconfigure",    0, 0, cf_reconfigure, 0, "",
                      "Reconfigure the daemon" },
  { "remove",         1, 1, cf_remove, 0, "TRACK",
                      "Remove a track from the queue" },
  { "rescan",         0, 0, cf_rescan, 0, "",
                      "Rescan for new tracks" },
  { "resolve",        1, 1, cf_resolve, 0, "TRACK",
                      "Resolve alias for TRACK" },
  { "resume",         0, 0, cf_resume, 0, "",
                      "Resume after a pause" },
  { "rtp-address",    0, 0, cf_rtp_address, 0, "",
                      "Report server's broadcast address" },
  { "schedule-del",   1, 1, cf_schedule_del, 0, "EVENT",
                      "Delete a scheduled event" },
  { "schedule-list",  0, 0, cf_schedule_list, 0, "",
                      "List scheduled events" },
  { "schedule-play",  3, 3, cf_schedule_play, 0, "WHEN PRI TRACK",
                      "Play TRACK later" },
  { "schedule-set-global", 4, 4, cf_schedule_set_global, 0, "WHEN PRI NAME VAL",
                      "Set a global preference later" },
  { "schedule-unset-global", 3, 3, cf_schedule_unset_global, 0, "WHEN PRI NAME",
                      "Unset a global preference later" },
  { "scratch",        0, 0, cf_scratch, 0, "",
                      "Scratch the currently playing track" },
  { "scratch-id",     1, 1, cf_scratch, 0, "ID",
                      "Scratch the currently playing track" },
  { "search",         1, 1, cf_search, 0, "WORDS",
                      "Display tracks matching all the words" },
  { "set",            3, 3, cf_set, 0, "TRACK NAME VALUE",
                      "Set a preference value" },
  { "set-global",     2, 2, cf_set_global, 0, "NAME VALUE",
                      "Set a global preference value" },
  { "set-volume",     2, 2, cf_set_volume, 0, "LEFT RIGHT",
                      "Set the volume" },
  { "setup-guest",    0, INT_MAX, cf_setup_guest, isarg_option, "[OPTIONS]",
                      "Create the guest login" },
  { "shutdown",       0, 0, cf_shutdown, 0, "",
                      "Shut down the daemon" },
  { "stats",          0, 0, cf_stats, 0, "",
                      "Display server statistics" },
  { "tags",           0, 0, cf_tags, 0, "",
                      "List known tags" },
  { "unset",          2, 2, cf_unset, 0, "TRACK NAME",
                      "Unset a preference" },
  { "unset-global",   1, 1, cf_unset_global, 0, "NAME",
                      "Unset a global preference" },
  { "userinfo",       2, 2, cf_userinfo, 0, "USERNAME PROPERTY",
                      "Get a property of a user" },
  { "users",          0, 0, cf_users, 0, "",
                      "List all users" },
  { "version",        0, 0, cf_version, 0, "",
                      "Display the server version" },
};

static void help_commands(void) {
  unsigned n, max = 0, l;

  xprintf("Command summary:\n");
  for(n = 0; n < sizeof commands / sizeof *commands; ++n) {
    if(!commands[n].desc) continue;
    l = strlen(commands[n].name);
    if(*commands[n].argstr)
      l += strlen(commands[n].argstr) + 1;
    if(l > max)
      max = l;
  }
  for(n = 0; n < sizeof commands / sizeof *commands; ++n) {
    if(!commands[n].desc) continue;
    l = strlen(commands[n].name);
    if(*commands[n].argstr)
      l += strlen(commands[n].argstr) + 1;
    xprintf("  %s%s%s%*s  %s\n", commands[n].name,
	    *commands[n].argstr ? " " : "",
	    commands[n].argstr,
	    max - l, "",
	    commands[n].desc);
  }
  xfclose(stdout);
  exit(0);
}

int main(int argc, char **argv) {
  int n, i, j, local = 0;
  int status = 0;
  struct vector args;
  const char *user = 0, *password = 0;

  mem_init();
#if HAVE_PCRE_H
  /* garbage-collect PCRE's memory */
  pcre_malloc = xmalloc;
  pcre_free = xfree;
#endif
  if(!setlocale(LC_CTYPE, "")) disorder_fatal(errno, "error calling setlocale");
  if(!setlocale(LC_TIME, "")) disorder_fatal(errno, "error calling setlocale");
  while((n = getopt_long(argc, argv, "+hVc:dHlNu:p:", options, 0)) >= 0) {
    switch(n) {
    case 'h': help();
    case 'H': help_commands();
    case 'V': version("disorder");
    case 'c': configfile = optarg; break;
    case 'd': debugging = 1; break;
    case 'l': local = 1; break;
    case 'N': config_per_user = 0; break;
    case 'u': user = optarg; break;
    case 'p': password = optarg; break;
    default: disorder_fatal(0, "invalid option");
    }
  }
  if(config_read(0, NULL)) disorder_fatal(0, "cannot read configuration");
  if(user) {
    xfree(config->username);
    config->username = xstrdup(user);
    config->password = 0;
  }
  if(password) {
    xfree(config->password);
    config->password = xstrdup(password);
  }
  if(local)
    config->connect.af = -1;
  n = optind;
  optind = 1;				/* for subsequent getopt calls */
#if HAVE_GCRYPT_H
  /* gcrypt initialization */
  if(!gcry_check_version(NULL))
    disorder_fatal(0, "gcry_check_version failed");
  gcry_control(GCRYCTL_INIT_SECMEM, 0);
  gcry_control (GCRYCTL_INITIALIZATION_FINISHED, 0);
#endif
  /* accumulate command args */
  while(n < argc) {
    if((i = TABLE_FIND(commands, name, argv[n])) < 0)
      disorder_fatal(0, "unknown command '%s'", argv[n]);
    if(n + commands[i].min >= argc)
      disorder_fatal(0, "missing arguments to '%s'", argv[n]);
    vector_init(&args);
    /* Include the command name in the args, but at element -1, for
     * the benefit of subcommand getopt calls */
    vector_append(&args, xstrdup(argv[n]));
    n++;
    for(j = 0; j < commands[i].min; ++j)
      vector_append(&args, nullcheck(mb2utf8(argv[n + j])));
    for(; j < commands[i].max
	  && n + j < argc
	  && commands[i].isarg(argv[n + j]); ++j)
      vector_append(&args, nullcheck(mb2utf8(argv[n + j])));
    vector_terminate(&args);
    commands[i].fn(args.vec + 1);
    vector_clear(&args);
    n += j;
  }
  if(client && disorder_close(client)) exit(EXIT_FAILURE);
  if(fclose(stdout) < 0) disorder_fatal(errno, "error closing stdout");
  config_free(config);
  xfree(client);
  return status;
}

/*
Local Variables:
c-basic-offset:2
comment-column:40
End:
*/