4 This file is part of PulseAudio.
6 Copyright 2004-2006 Lennart Poettering
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.
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.
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
35 #include <pulse/xmalloc.h>
37 #include <pulsecore/core-util.h>
38 #include <pulsecore/strbuf.h>
42 /* Argument codes for getopt_long() */
52 ARG_DISALLOW_MODULE_LOADING
,
66 ARG_DUMP_RESAMPLE_METHODS
,
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
},
100 void pa_cmdline_help(const char *argv0
) {
103 if ((e
= strrchr(argv0
, '/')))
108 printf("%s [options]\n\n"
110 " -h, --help Show this help\n"
111 " --version Show version\n"
112 " --dump-conf Dump default configuration\n"
113 " --dump-modules Dump list of available modules\n"
114 " --dump-resample-methods Dump available resample methods\n"
115 " -k --kill Kill a running daemon\n"
116 " --check Check for a running daemon\n\n"
119 " --system[=BOOL] Run as system-wide instance\n"
120 " -D, --daemonize[=BOOL] Daemonize after startup\n"
121 " --fail[=BOOL] Quit when startup fails\n"
122 " --high-priority[=BOOL] Try to set high process priority\n"
123 " (only available as root)\n"
124 " --disallow-module-loading[=BOOL] Disallow module loading after startup\n"
125 " --exit-idle-time=SECS Terminate the daemon when idle and this\n"
127 " --module-idle-time=SECS Unload autoloaded modules when idle and\n"
128 " this time passed\n"
129 " --scache-idle-time=SECS Unload autoloaded samples when idle and\n"
130 " this time passed\n"
131 " --log-level[=LEVEL] Increase or set verbosity level\n"
132 " -v Increase the verbosity level\n"
133 " --log-target={auto,syslog,stderr} Specify the log target\n"
134 " -p, --dl-search-path=PATH Set the search path for dynamic shared\n"
135 " objects (plugins)\n"
136 " --resample-method=[METHOD] Use the specified resampling method\n"
137 " (See --dump-resample-methods for\n"
138 " possible values)\n"
139 " --use-pid-file[=BOOL] Create a PID file\n"
140 " --no-cpu-limit[=BOOL] Do not install CPU load limiter on\n"
141 " platforms that support it.\n"
142 " --disable-shm[=BOOL] Disable shared memory support.\n\n"
145 " -L, --load=\"MODULE ARGUMENTS\" Load the specified plugin module with\n"
146 " the specified argument\n"
147 " -F, --file=FILENAME Run the specified script\n"
148 " -C Open a command line on the running TTY\n"
151 " -n Don't load default script file\n", e
);
154 int pa_cmdline_parse(pa_daemon_conf
*conf
, int argc
, char *const argv
[], int *d
) {
155 pa_strbuf
*buf
= NULL
;
157 assert(conf
&& argc
&& argv
);
159 buf
= pa_strbuf_new();
161 if (conf
->script_commands
)
162 pa_strbuf_puts(buf
, conf
->script_commands
);
164 while ((c
= getopt_long(argc
, argv
, "L:F:ChDnp:kv", long_options
, NULL
)) != -1) {
168 conf
->cmd
= PA_CMD_HELP
;
172 conf
->cmd
= PA_CMD_VERSION
;
176 conf
->cmd
= PA_CMD_DUMP_CONF
;
179 case ARG_DUMP_MODULES
:
180 conf
->cmd
= PA_CMD_DUMP_MODULES
;
183 case ARG_DUMP_RESAMPLE_METHODS
:
184 conf
->cmd
= PA_CMD_DUMP_RESAMPLE_METHODS
;
189 conf
->cmd
= PA_CMD_KILL
;
193 conf
->cmd
= PA_CMD_CHECK
;
198 pa_strbuf_printf(buf
, "load-module %s\n", optarg
);
204 pa_strbuf_printf(buf
, ".include %s\n", p
= pa_make_path_absolute(optarg
));
210 pa_strbuf_puts(buf
, "load-module module-cli exit_on_eof=1\n");
215 if ((conf
->daemonize
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
216 pa_log("--daemonize expects boolean argument");
222 if ((conf
->fail
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
223 pa_log("--fail expects boolean argument");
232 if (pa_daemon_conf_set_log_level(conf
, optarg
) < 0) {
233 pa_log("--log-level expects log level argument (either numeric in range 0..4 or one of debug, info, notice, warn, error).");
237 if (conf
->log_level
< PA_LOG_LEVEL_MAX
-1)
243 case ARG_HIGH_PRIORITY
:
244 if ((conf
->high_priority
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
245 pa_log("--high-priority expects boolean argument");
250 case ARG_DISALLOW_MODULE_LOADING
:
251 if ((conf
->disallow_module_loading
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
252 pa_log("--disallow-module-loading expects boolean argument");
257 case ARG_USE_PID_FILE
:
258 if ((conf
->use_pid_file
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
259 pa_log("--use-pid-file expects boolean argument");
265 case ARG_DL_SEARCH_PATH
:
266 pa_xfree(conf
->dl_search_path
);
267 conf
->dl_search_path
= *optarg
? pa_xstrdup(optarg
) : NULL
;
271 pa_xfree(conf
->default_script_file
);
272 conf
->default_script_file
= NULL
;
276 if (pa_daemon_conf_set_log_target(conf
, optarg
) < 0) {
277 pa_log("Invalid log target: use either 'syslog', 'stderr' or 'auto'.");
282 case ARG_EXIT_IDLE_TIME
:
283 conf
->exit_idle_time
= atoi(optarg
);
286 case ARG_MODULE_IDLE_TIME
:
287 conf
->module_idle_time
= atoi(optarg
);
290 case ARG_SCACHE_IDLE_TIME
:
291 conf
->scache_idle_time
= atoi(optarg
);
294 case ARG_RESAMPLE_METHOD
:
295 if (pa_daemon_conf_set_resample_method(conf
, optarg
) < 0) {
296 pa_log("Invalid resample method '%s'.", optarg
);
302 if ((conf
->system_instance
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
303 pa_log("--system expects boolean argument");
308 case ARG_NO_CPU_LIMIT
:
309 if ((conf
->no_cpu_limit
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
310 pa_log("--no-cpu-limit expects boolean argument");
315 case ARG_DISABLE_SHM
:
316 if ((conf
->disable_shm
= optarg
? pa_parse_boolean(optarg
) : 1) < 0) {
317 pa_log("--disable-shm expects boolean argument");
327 pa_xfree(conf
->script_commands
);
328 conf
->script_commands
= pa_strbuf_tostring_free(buf
);
330 if (!conf
->script_commands
) {
331 pa_xfree(conf
->script_commands
);
332 conf
->script_commands
= NULL
;