code.delx.au - pulseaudio/blob - polyp/cmdline.c

   1 /* $Id$ */
   2
   3 /***
   4   This file is part of polypaudio.
   5
   6   polypaudio is free software; you can redistribute it and/or modify
   7   it under the terms of the GNU Lesser General Public License as published
   8   by the Free Software Foundation; either version 2 of the License,
   9   or (at your option) any later version.
  10
  11   polypaudio is distributed in the hope that it will be useful, but
  12   WITHOUT ANY WARRANTY; without even the implied warranty of
  13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  14   General Public License for more details.
  15
  16   You should have received a copy of the GNU Lesser General Public License
  17   along with polypaudio; if not, write to the Free Software
  18   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  19   USA.
  20 ***/
  21
  22 #ifdef HAVE_CONFIG_H
  23 #include <config.h>
  24 #endif
  25
  26 #include <string.h>
  27 #include <assert.h>
  28 #include <stdlib.h>
  29 #include <stdio.h>
  30 #include <getopt.h>
  31 #include <sys/stat.h>
  32
  33 #include "cmdline.h"
  34 #include "util.h"
  35 #include "strbuf.h"
  36 #include "xmalloc.h"
  37
  38 /* Argument codes for getopt_long() */
  39 enum {
  40     ARG_HELP = 256,
  41     ARG_VERSION,
  42     ARG_DUMP_CONF,
  43     ARG_DUMP_MODULES,
  44     ARG_DAEMONIZE,
  45     ARG_FAIL,
  46     ARG_VERBOSE,
  47     ARG_HIGH_PRIORITY,
  48     ARG_DISALLOW_MODULE_LOADING,
  49     ARG_EXIT_IDLE_TIME,
  50     ARG_MODULE_IDLE_TIME,
  51     ARG_SCACHE_IDLE_TIME,
  52     ARG_LOG_TARGET,
  53     ARG_LOAD,
  54     ARG_FILE,
  55     ARG_DL_SEARCH_PATH,
  56     ARG_RESAMPLE_METHOD,
  57     ARG_KILL,
  58     ARG_USE_PID_FILE,
  59     ARG_CHECK
  60 };
  61
  62 /* Tabel for getopt_long() */
  63 static struct option long_options[] = {
  64     {"help",                        0, 0, ARG_HELP},
  65     {"version",                     0, 0, ARG_VERSION},
  66     {"dump-conf",                   0, 0, ARG_DUMP_CONF},
  67     {"dump-modules",                0, 0, ARG_DUMP_MODULES},
  68     {"daemonize",                   2, 0, ARG_DAEMONIZE},
  69     {"fail",                        2, 0, ARG_FAIL},
  70     {"verbose",                     2, 0, ARG_VERBOSE},
  71     {"high-priority",               2, 0, ARG_HIGH_PRIORITY},
  72     {"disallow-module-loading",     2, 0, ARG_DISALLOW_MODULE_LOADING},
  73     {"exit-idle-time",              2, 0, ARG_EXIT_IDLE_TIME},
  74     {"module-idle-time",            2, 0, ARG_MODULE_IDLE_TIME},
  75     {"scache-idle-time",            2, 0, ARG_SCACHE_IDLE_TIME},
  76     {"log-target",                  1, 0, ARG_LOG_TARGET},
  77     {"load",                        1, 0, ARG_LOAD},
  78     {"file",                        1, 0, ARG_FILE},
  79     {"dl-search-path",              1, 0, ARG_DL_SEARCH_PATH},
  80     {"resample-method",             1, 0, ARG_RESAMPLE_METHOD},
  81     {"kill",                        0, 0, ARG_KILL},
  82     {"use-pid-file",                2, 0, ARG_USE_PID_FILE},
  83     {"check",                       0, 0, ARG_CHECK},
  84     {NULL, 0, 0, 0}
  85 };
  86
  87 void pa_cmdline_help(const char *argv0) {
  88     const char *e;
  89
  90     if ((e = strrchr(argv0, '/')))
  91         e++;
  92     else
  93         e = argv0;
  94
  95     printf("%s [options]\n\n"
  96            "COMMANDS:\n"
  97            "  -h, --help                            Show this help\n"
  98            "      --version                         Show version\n"
  99            "      --dump-conf                       Dump default configuration\n"
 100            "      --dump-modules                    Dump list of available modules\n"
 101            "  -k  --kill                            Kill a running daemon\n"
 102            "      --check                           Check for a running daemon\n\n"
 103
 104            "OPTIONS:\n"
 105            "  -D, --daemonize[=BOOL]                Daemonize after startup\n"
 106            "      --fail[=BOOL]                     Quit when startup fails\n"
 107            "      --verbose[=BOOL]                  Be slightly more verbose\n"
 108            "      --high-priority[=BOOL]            Try to set high process priority\n"
 109            "                                        (only available as root)\n"
 110            "      --disallow-module-loading[=BOOL]  Disallow module loading after startup\n"
 111            "      --exit-idle-time=SECS             Terminate the daemon when idle and this\n"
 112            "                                        time passed\n"
 113            "      --module-idle-time=SECS           Unload autoloaded modules when idle and\n"
 114            "                                        this time passed\n"
 115            "      --scache-idle-time=SECS           Unload autoloaded samples when idle and\n"
 116            "                                        this time passed\n"
 117            "      --log-target={auto,syslog,stderr} Specify the log target\n"
 118            "  -p, --dl-search-path=PATH             Set the search path for dynamic shared\n"
 119            "                                        objects (plugins)\n"
 120            "      --resample-method=[METHOD]        Use the specified resampling method\n"
 121            "                                        (one of src-sinc-medium-quality,\n"
 122            "                                        src-sinc-best-quality,src-sinc-fastest\n"
 123            "                                        src-zero-order-hold,src-linear,trivial)\n"
 124            "      --use-pid-file[=BOOL]             Create a PID file\n\n"
 125
 126            "STARTUP SCRIPT:\n"
 127            "  -L, --load=\"MODULE ARGUMENTS\"         Load the specified plugin module with\n"
 128            "                                        the specified argument\n"
 129            "  -F, --file=FILENAME                   Run the specified script\n"
 130            "  -C                                    Open a command line on the running TTY\n"
 131            "                                        after startup\n\n"
 132
 133            "  -n                                    Don't load default script file\n", e);
 134 }
 135
 136 int pa_cmdline_parse(struct pa_daemon_conf *conf, int argc, char *const argv [], int *d) {
 137     struct pa_strbuf *buf = NULL;
 138     int c;
 139     assert(conf && argc && argv);
 140
 141     buf = pa_strbuf_new();
 142
 143     if (conf->script_commands)
 144         pa_strbuf_puts(buf, conf->script_commands);
 145
 146     while ((c = getopt_long(argc, argv, "L:F:ChDnp:k", long_options, NULL)) != -1) {
 147         switch (c) {
 148             case ARG_HELP:
 149             case 'h':
 150                 conf->cmd = PA_CMD_HELP;
 151                 break;
 152
 153             case ARG_VERSION:
 154                 conf->cmd = PA_CMD_VERSION;
 155                 break;
 156
 157             case ARG_DUMP_CONF:
 158                 conf->cmd = PA_CMD_DUMP_CONF;
 159                 break;
 160
 161             case ARG_DUMP_MODULES:
 162                 conf->cmd = PA_CMD_DUMP_MODULES;
 163                 break;
 164
 165             case 'k':
 166             case ARG_KILL:
 167                 conf->cmd = PA_CMD_KILL;
 168                 break;
 169
 170             case ARG_CHECK:
 171                 conf->cmd = PA_CMD_CHECK;
 172                 break;
 173
 174             case ARG_LOAD:
 175             case 'L':
 176                 pa_strbuf_printf(buf, "load-module %s\n", optarg);
 177                 break;
 178
 179             case ARG_FILE:
 180             case 'F':
 181                 pa_strbuf_printf(buf, ".include %s\n", optarg);
 182                 break;
 183
 184             case 'C':
 185                 pa_strbuf_puts(buf, "load-module module-cli\n");
 186                 break;
 187
 188             case ARG_DAEMONIZE:
 189             case 'D':
 190                 if ((conf->daemonize = optarg ? pa_parse_boolean(optarg) : 1) < 0) {
 191                     pa_log(__FILE__": --daemonize expects boolean argument\n");
 192                     goto fail;
 193                 }
 194                 break;
 195
 196             case ARG_FAIL:
 197                 if ((conf->fail = optarg ? pa_parse_boolean(optarg) : 1) < 0) {
 198                     pa_log(__FILE__": --fail expects boolean argument\n");
 199                     goto fail;
 200                 }
 201                 break;
 202
 203             case ARG_VERBOSE:
 204                 if ((conf->verbose = optarg ? pa_parse_boolean(optarg) : 1) < 0) {
 205                     pa_log(__FILE__": --verbose expects boolean argument\n");
 206                     goto fail;
 207                 }
 208                 break;
 209
 210             case ARG_HIGH_PRIORITY:
 211                 if ((conf->high_priority = optarg ? pa_parse_boolean(optarg) : 1) < 0) {
 212                     pa_log(__FILE__": --high-priority expects boolean argument\n");
 213                     goto fail;
 214                 }
 215                 break;
 216
 217             case ARG_DISALLOW_MODULE_LOADING:
 218                 if ((conf->disallow_module_loading = optarg ? pa_parse_boolean(optarg) : 1) < 0) {
 219                     pa_log(__FILE__": --disallow-module-loading expects boolean argument\n");
 220                     goto fail;
 221                 }
 222                 break;
 223
 224             case ARG_USE_PID_FILE:
 225                 if ((conf->use_pid_file = optarg ? pa_parse_boolean(optarg) : 1) < 0) {
 226                     pa_log(__FILE__": --use-pid-file expects boolean argument\n");
 227                     goto fail;
 228                 }
 229                 break;
 230
 231             case 'p':
 232             case ARG_DL_SEARCH_PATH:
 233                 pa_xfree(conf->dl_search_path);
 234                 conf->dl_search_path = *optarg ? pa_xstrdup(optarg) : NULL;
 235                 break;
 236
 237             case 'n':
 238                 pa_xfree(conf->default_script_file);
 239                 conf->default_script_file = NULL;
 240                 break;
 241
 242             case ARG_LOG_TARGET:
 243                 if (pa_daemon_conf_set_log_target(conf, optarg) < 0) {
 244                     pa_log(__FILE__": Invalid log target: use either 'syslog', 'stderr' or 'auto'.\n");
 245                     goto fail;
 246                 }
 247                 break;
 248
 249             case ARG_EXIT_IDLE_TIME:
 250                 conf->exit_idle_time = atoi(optarg);
 251                 break;
 252
 253             case ARG_MODULE_IDLE_TIME:
 254                 conf->module_idle_time = atoi(optarg);
 255                 break;
 256
 257             case ARG_SCACHE_IDLE_TIME:
 258                 conf->scache_idle_time = atoi(optarg);
 259                 break;
 260
 261             case ARG_RESAMPLE_METHOD:
 262                 if (pa_daemon_conf_set_resample_method(conf, optarg) < 0) {
 263                     pa_log(__FILE__": Invalid resample method '%s'.\n", optarg);
 264                     goto fail;
 265                 }
 266                 break;
 267
 268             default:
 269                 goto fail;
 270         }
 271     }
 272
 273     pa_xfree(conf->script_commands);
 274     conf->script_commands = pa_strbuf_tostring_free(buf);
 275
 276     if (!conf->script_commands) {
 277         pa_xfree(conf->script_commands);
 278         conf->script_commands = NULL;
 279     }
 280
 281     *d = optind;
 282
 283     return 0;
 284
 285 fail:
 286     if (buf)
 287         pa_strbuf_free(buf);
 288
 289     return -1;
 290 }