code.delx.au - pulseaudio/blob - src/daemon/cmdline.c

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