]> code.delx.au - pulseaudio/blob - src/pulsecore/cli-command.c
delx.au / code / pulseaudio / blob
summary | shortlog | log | commit | commitdiff | tree
history | raw | HEAD
move flat volume logic into the core. while doing so add n_volume_steps field to...
[pulseaudio] / src / pulsecore / cli-command.c
1 /***
2 This file is part of PulseAudio.
3
4 Copyright 2004-2006 Lennart Poettering
5 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
6
7 PulseAudio is free software; you can redistribute it and/or modify
8 it under the terms of the GNU Lesser General Public License as published
9 by the Free Software Foundation; either version 2 of the License,
10 or (at your option) any later version.
11
12 PulseAudio is distributed in the hope that it will be useful, but
13 WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 General Public License for more details.
16
17 You should have received a copy of the GNU Lesser General Public License
18 along with PulseAudio; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
20 USA.
21 ***/
22
23 #ifdef HAVE_CONFIG_H
24 #include <config.h>
25 #endif
26
27 #include <stdio.h>
28 #include <string.h>
29 #include <stdlib.h>
30 #include <errno.h>
31 #include <unistd.h>
32 #include <ltdl.h>
33
34 #include <pulse/xmalloc.h>
35
36 #include <pulsecore/module.h>
37 #include <pulsecore/sink.h>
38 #include <pulsecore/source.h>
39 #include <pulsecore/client.h>
40 #include <pulsecore/sink-input.h>
41 #include <pulsecore/source-output.h>
42 #include <pulsecore/tokenizer.h>
43 #include <pulsecore/strbuf.h>
44 #include <pulsecore/namereg.h>
45 #include <pulsecore/cli-text.h>
46 #include <pulsecore/core-scache.h>
47 #include <pulsecore/sample-util.h>
48 #include <pulsecore/sound-file.h>
49 #include <pulsecore/play-memchunk.h>
50 #include <pulsecore/sound-file-stream.h>
51 #include <pulsecore/shared.h>
52 #include <pulsecore/core-util.h>
53 #include <pulsecore/core-error.h>
54 #include <pulsecore/modinfo.h>
55
56 #include "cli-command.h"
57
58 struct command {
59 const char *name;
60 int (*proc) (pa_core *c, pa_tokenizer*t, pa_strbuf *buf, pa_bool_t *fail);
61 const char *help;
62 unsigned args;
63 };
64
65 #define META_INCLUDE ".include"
66 #define META_FAIL ".fail"
67 #define META_NOFAIL ".nofail"
68 #define META_IFEXISTS ".ifexists"
69 #define META_ELSE ".else"
70 #define META_ENDIF ".endif"
71
72 enum {
73 IFSTATE_NONE = -1,
74 IFSTATE_FALSE = 0,
75 IFSTATE_TRUE = 1,
76 };
77
78 /* Prototypes for all available commands */
79 static int pa_cli_command_exit(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
80 static int pa_cli_command_help(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
81 static int pa_cli_command_modules(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
82 static int pa_cli_command_clients(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
83 static int pa_cli_command_cards(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
84 static int pa_cli_command_sinks(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
85 static int pa_cli_command_sources(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
86 static int pa_cli_command_sink_inputs(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
87 static int pa_cli_command_source_outputs(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
88 static int pa_cli_command_stat(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
89 static int pa_cli_command_info(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
90 static int pa_cli_command_load(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
91 static int pa_cli_command_unload(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
92 static int pa_cli_command_describe(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
93 static int pa_cli_command_sink_volume(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
94 static int pa_cli_command_sink_input_volume(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
95 static int pa_cli_command_source_volume(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
96 static int pa_cli_command_sink_mute(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
97 static int pa_cli_command_source_mute(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
98 static int pa_cli_command_sink_input_mute(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
99 static int pa_cli_command_sink_default(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
100 static int pa_cli_command_source_default(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
101 static int pa_cli_command_kill_client(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
102 static int pa_cli_command_kill_sink_input(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
103 static int pa_cli_command_kill_source_output(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
104 static int pa_cli_command_scache_play(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
105 static int pa_cli_command_scache_remove(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
106 static int pa_cli_command_scache_list(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
107 static int pa_cli_command_scache_load(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
108 static int pa_cli_command_scache_load_dir(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
109 static int pa_cli_command_play_file(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
110 static int pa_cli_command_dump(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
111 static int pa_cli_command_list_shared_props(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
112 static int pa_cli_command_move_sink_input(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
113 static int pa_cli_command_move_source_output(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
114 static int pa_cli_command_vacuum(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
115 static int pa_cli_command_suspend_sink(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
116 static int pa_cli_command_suspend_source(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
117 static int pa_cli_command_suspend(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
118 static int pa_cli_command_log_level(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
119 static int pa_cli_command_log_meta(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
120 static int pa_cli_command_log_time(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
121 static int pa_cli_command_log_backtrace(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
122 static int pa_cli_command_update_sink_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
123 static int pa_cli_command_update_source_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
124 static int pa_cli_command_update_sink_input_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
125 static int pa_cli_command_update_source_output_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
126 static int pa_cli_command_card_profile(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail);
127
128 /* A method table for all available commands */
129
130 static const struct command commands[] = {
131 { "exit", pa_cli_command_exit, "Terminate the daemon", 1 },
132 { "help", pa_cli_command_help, "Show this help", 1 },
133 { "list-modules", pa_cli_command_modules, "List loaded modules", 1 },
134 { "list-sinks", pa_cli_command_sinks, "List loaded sinks", 1 },
135 { "list-sources", pa_cli_command_sources, "List loaded sources", 1 },
136 { "list-clients", pa_cli_command_clients, "List loaded clients", 1 },
137 { "list-sink-inputs", pa_cli_command_sink_inputs, "List sink inputs", 1 },
138 { "list-source-outputs", pa_cli_command_source_outputs, "List source outputs", 1 },
139 { "list-cards", pa_cli_command_cards, "List cards", 1 },
140 { "stat", pa_cli_command_stat, "Show memory block statistics", 1 },
141 { "info", pa_cli_command_info, "Show comprehensive status", 1 },
142 { "ls", pa_cli_command_info, NULL, 1 },
143 { "list", pa_cli_command_info, NULL, 1 },
144 { "load-module", pa_cli_command_load, "Load a module (args: name, arguments)", 3},
145 { "unload-module", pa_cli_command_unload, "Unload a module (args: index)", 2},
146 { "describe-module", pa_cli_command_describe, "Describe a module (arg: name)", 2},
147 { "set-sink-volume", pa_cli_command_sink_volume, "Set the volume of a sink (args: index|name, volume)", 3},
148 { "set-sink-input-volume", pa_cli_command_sink_input_volume, "Set the volume of a sink input (args: index, volume)", 3},
149 { "set-source-volume", pa_cli_command_source_volume, "Set the volume of a source (args: index|name, volume)", 3},
150 { "set-sink-mute", pa_cli_command_sink_mute, "Set the mute switch of a sink (args: index|name, bool)", 3},
151 { "set-sink-input-mute", pa_cli_command_sink_input_mute, "Set the mute switch of a sink input (args: index, bool)", 3},
152 { "set-source-mute", pa_cli_command_source_mute, "Set the mute switch of a source (args: index|name, bool)", 3},
153 { "update-sink-proplist", pa_cli_command_update_sink_proplist, "Update the properties of a sink (args: index|name, properties)", 3},
154 { "update-source-proplist", pa_cli_command_update_source_proplist, "Update the properties of a source (args: index|name, properties)", 3},
155 { "update-sink-input-proplist", pa_cli_command_update_sink_input_proplist, "Update the properties of a sink input (args: index, properties)", 3},
156 { "update-source-output-proplist", pa_cli_command_update_source_output_proplist, "Update the properties of a source_output (args: index, properties)", 3},
157 { "set-default-sink", pa_cli_command_sink_default, "Set the default sink (args: index|name)", 2},
158 { "set-default-source", pa_cli_command_source_default, "Set the default source (args: index|name)", 2},
159 { "kill-client", pa_cli_command_kill_client, "Kill a client (args: index)", 2},
160 { "kill-sink-input", pa_cli_command_kill_sink_input, "Kill a sink input (args: index)", 2},
161 { "kill-source-output", pa_cli_command_kill_source_output, "Kill a source output (args: index)", 2},
162 { "list-samples", pa_cli_command_scache_list, "List all entries in the sample cache", 1},
163 { "play-sample", pa_cli_command_scache_play, "Play a sample from the sample cache (args: name, sink|index)", 3},
164 { "remove-sample", pa_cli_command_scache_remove, "Remove a sample from the sample cache (args: name)", 2},
165 { "load-sample", pa_cli_command_scache_load, "Load a sound file into the sample cache (args: name, filename)", 3},
166 { "load-sample-lazy", pa_cli_command_scache_load, "Lazily load a sound file into the sample cache (args: name, filename)", 3},
167 { "load-sample-dir-lazy", pa_cli_command_scache_load_dir, "Lazily load all files in a directory into the sample cache (args: pathname)", 2},
168 { "play-file", pa_cli_command_play_file, "Play a sound file (args: filename, sink|index)", 3},
169 { "dump", pa_cli_command_dump, "Dump daemon configuration", 1},
170 { "shared", pa_cli_command_list_shared_props, NULL, 1},
171 { "move-sink-input", pa_cli_command_move_sink_input, "Move sink input to another sink (args: index, sink)", 3},
172 { "move-source-output", pa_cli_command_move_source_output, "Move source output to another source (args: index, source)", 3},
173 { "vacuum", pa_cli_command_vacuum, NULL, 1},
174 { "suspend-sink", pa_cli_command_suspend_sink, "Suspend sink (args: index|name, bool)", 3},
175 { "suspend-source", pa_cli_command_suspend_source, "Suspend source (args: index|name, bool)", 3},
176 { "suspend", pa_cli_command_suspend, "Suspend all sinks and all sources (args: bool)", 2},
177 { "set-card-profile", pa_cli_command_card_profile, "Change the profile of a card (aargs: index, name)", 3},
178 { "set-log-level", pa_cli_command_log_level, "Change the log level (args: numeric level)", 2},
179 { "set-log-meta", pa_cli_command_log_meta, "Show source code location in log messages (args: bool)", 2},
180 { "set-log-time", pa_cli_command_log_time, "Show timestamps in log messages (args: bool)", 2},
181 { "set-log-backtrace", pa_cli_command_log_backtrace, "Show bakctrace in log messages (args: frames)", 2},
182 { NULL, NULL, NULL, 0 }
183 };
184
185 static const char whitespace[] = " \t\n\r";
186 static const char linebreak[] = "\n\r";
187
188 static uint32_t parse_index(const char *n) {
189 uint32_t idx;
190
191 if (pa_atou(n, &idx) < 0)
192 return (uint32_t) PA_IDXSET_INVALID;
193
194 return idx;
195 }
196
197 static int pa_cli_command_exit(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
198 pa_core_assert_ref(c);
199 pa_assert(t);
200 pa_assert(buf);
201 pa_assert(fail);
202
203 if (pa_core_exit(c, FALSE, 0) < 0)
204 pa_strbuf_puts(buf, "Not allowed to terminate daemon.\n");
205
206 return 0;
207 }
208
209 static int pa_cli_command_help(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
210 const struct command*command;
211
212 pa_core_assert_ref(c);
213 pa_assert(t);
214 pa_assert(buf);
215 pa_assert(fail);
216
217 pa_strbuf_puts(buf, "Available commands:\n");
218
219 for (command = commands; command->name; command++)
220 if (command->help)
221 pa_strbuf_printf(buf, " %-25s %s\n", command->name, command->help);
222 return 0;
223 }
224
225 static int pa_cli_command_modules(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
226 char *s;
227
228 pa_core_assert_ref(c);
229 pa_assert(t);
230 pa_assert(buf);
231 pa_assert(fail);
232
233 pa_assert_se(s = pa_module_list_to_string(c));
234 pa_strbuf_puts(buf, s);
235 pa_xfree(s);
236 return 0;
237 }
238
239 static int pa_cli_command_clients(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
240 char *s;
241
242 pa_core_assert_ref(c);
243 pa_assert(t);
244 pa_assert(buf);
245 pa_assert(fail);
246
247 pa_assert_se(s = pa_client_list_to_string(c));
248 pa_strbuf_puts(buf, s);
249 pa_xfree(s);
250 return 0;
251 }
252
253 static int pa_cli_command_cards(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
254 char *s;
255
256 pa_core_assert_ref(c);
257 pa_assert(t);
258 pa_assert(buf);
259 pa_assert(fail);
260
261 pa_assert_se(s = pa_card_list_to_string(c));
262 pa_strbuf_puts(buf, s);
263 pa_xfree(s);
264 return 0;
265 }
266
267 static int pa_cli_command_sinks(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
268 char *s;
269
270 pa_core_assert_ref(c);
271 pa_assert(t);
272 pa_assert(buf);
273 pa_assert(fail);
274
275 pa_assert_se(s = pa_sink_list_to_string(c));
276 pa_strbuf_puts(buf, s);
277 pa_xfree(s);
278 return 0;
279 }
280
281 static int pa_cli_command_sources(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
282 char *s;
283
284 pa_core_assert_ref(c);
285 pa_assert(t);
286 pa_assert(buf);
287 pa_assert(fail);
288
289 pa_assert_se(s = pa_source_list_to_string(c));
290 pa_strbuf_puts(buf, s);
291 pa_xfree(s);
292 return 0;
293 }
294
295 static int pa_cli_command_sink_inputs(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
296 char *s;
297
298 pa_core_assert_ref(c);
299 pa_assert(t);
300 pa_assert(buf);
301 pa_assert(fail);
302
303 pa_assert_se(s = pa_sink_input_list_to_string(c));
304 pa_strbuf_puts(buf, s);
305 pa_xfree(s);
306 return 0;
307 }
308
309 static int pa_cli_command_source_outputs(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
310 char *s;
311
312 pa_core_assert_ref(c);
313 pa_assert(t);
314 pa_assert(buf);
315 pa_assert(fail);
316
317 pa_assert_se(s = pa_source_output_list_to_string(c));
318 pa_strbuf_puts(buf, s);
319 pa_xfree(s);
320 return 0;
321 }
322
323 static int pa_cli_command_stat(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
324 char s[256];
325 const pa_mempool_stat *stat;
326 unsigned k;
327 const char *def_sink, *def_source;
328
329 static const char* const type_table[PA_MEMBLOCK_TYPE_MAX] = {
330 [PA_MEMBLOCK_POOL] = "POOL",
331 [PA_MEMBLOCK_POOL_EXTERNAL] = "POOL_EXTERNAL",
332 [PA_MEMBLOCK_APPENDED] = "APPENDED",
333 [PA_MEMBLOCK_USER] = "USER",
334 [PA_MEMBLOCK_FIXED] = "FIXED",
335 [PA_MEMBLOCK_IMPORTED] = "IMPORTED",
336 };
337
338 pa_core_assert_ref(c);
339 pa_assert(t);
340 pa_assert(buf);
341 pa_assert(fail);
342
343 stat = pa_mempool_get_stat(c->mempool);
344
345 pa_strbuf_printf(buf, "Memory blocks currently allocated: %u, size: %s.\n",
346 (unsigned) pa_atomic_load(&stat->n_allocated),
347 pa_bytes_snprint(s, sizeof(s), (unsigned) pa_atomic_load(&stat->allocated_size)));
348
349 pa_strbuf_printf(buf, "Memory blocks allocated during the whole lifetime: %u, size: %s.\n",
350 (unsigned) pa_atomic_load(&stat->n_accumulated),
351 pa_bytes_snprint(s, sizeof(s), (unsigned) pa_atomic_load(&stat->accumulated_size)));
352
353 pa_strbuf_printf(buf, "Memory blocks imported from other processes: %u, size: %s.\n",
354 (unsigned) pa_atomic_load(&stat->n_imported),
355 pa_bytes_snprint(s, sizeof(s), (unsigned) pa_atomic_load(&stat->imported_size)));
356
357 pa_strbuf_printf(buf, "Memory blocks exported to other processes: %u, size: %s.\n",
358 (unsigned) pa_atomic_load(&stat->n_exported),
359 pa_bytes_snprint(s, sizeof(s), (unsigned) pa_atomic_load(&stat->exported_size)));
360
361 pa_strbuf_printf(buf, "Total sample cache size: %s.\n",
362 pa_bytes_snprint(s, sizeof(s), (unsigned) pa_scache_total_size(c)));
363
364 pa_strbuf_printf(buf, "Default sample spec: %s\n",
365 pa_sample_spec_snprint(s, sizeof(s), &c->default_sample_spec));
366
367 def_sink = pa_namereg_get_default_sink_name(c);
368 def_source = pa_namereg_get_default_source_name(c);
369 pa_strbuf_printf(buf, "Default sink name: %s\n"
370 "Default source name: %s\n",
371 def_sink ? def_sink : "none",
372 def_source ? def_source : "none");
373
374 for (k = 0; k < PA_MEMBLOCK_TYPE_MAX; k++)
375 pa_strbuf_printf(buf,
376 "Memory blocks of type %s: %u allocated/%u accumulated.\n",
377 type_table[k],
378 (unsigned) pa_atomic_load(&stat->n_allocated_by_type[k]),
379 (unsigned) pa_atomic_load(&stat->n_accumulated_by_type[k]));
380
381 return 0;
382 }
383
384 static int pa_cli_command_info(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
385 pa_core_assert_ref(c);
386 pa_assert(t);
387 pa_assert(buf);
388 pa_assert(fail);
389
390 pa_cli_command_stat(c, t, buf, fail);
391 pa_cli_command_modules(c, t, buf, fail);
392 pa_cli_command_sinks(c, t, buf, fail);
393 pa_cli_command_sources(c, t, buf, fail);
394 pa_cli_command_clients(c, t, buf, fail);
395 pa_cli_command_cards(c, t, buf, fail);
396 pa_cli_command_sink_inputs(c, t, buf, fail);
397 pa_cli_command_source_outputs(c, t, buf, fail);
398 pa_cli_command_scache_list(c, t, buf, fail);
399 return 0;
400 }
401
402 static int pa_cli_command_load(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
403 pa_module *m;
404 const char *name;
405
406 pa_core_assert_ref(c);
407 pa_assert(t);
408 pa_assert(buf);
409 pa_assert(fail);
410
411 if (!(name = pa_tokenizer_get(t, 1))) {
412 pa_strbuf_puts(buf, "You need to specify the module name and optionally arguments.\n");
413 return -1;
414 }
415
416 if (!(m = pa_module_load(c, name, pa_tokenizer_get(t, 2)))) {
417 pa_strbuf_puts(buf, "Module load failed.\n");
418 return -1;
419 }
420
421 return 0;
422 }
423
424 static int pa_cli_command_unload(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
425 pa_module *m;
426 uint32_t idx;
427 const char *i;
428 char *e;
429
430 pa_core_assert_ref(c);
431 pa_assert(t);
432 pa_assert(buf);
433 pa_assert(fail);
434
435 if (!(i = pa_tokenizer_get(t, 1))) {
436 pa_strbuf_puts(buf, "You need to specify the module index.\n");
437 return -1;
438 }
439
440 idx = (uint32_t) strtoul(i, &e, 10);
441 if (*e || !(m = pa_idxset_get_by_index(c->modules, idx))) {
442 pa_strbuf_puts(buf, "Invalid module index.\n");
443 return -1;
444 }
445
446 pa_module_unload_request(m, FALSE);
447 return 0;
448 }
449
450 static int pa_cli_command_describe(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
451 const char *name;
452 pa_modinfo *i;
453
454 pa_core_assert_ref(c);
455 pa_assert(t);
456 pa_assert(buf);
457 pa_assert(fail);
458
459 if (!(name = pa_tokenizer_get(t, 1))) {
460 pa_strbuf_puts(buf, "You need to specify the module name.\n");
461 return -1;
462 }
463
464 if ((i = pa_modinfo_get_by_name(name))) {
465
466 pa_strbuf_printf(buf, "Name: %s\n", name);
467
468 if (!i->description && !i->version && !i->author && !i->usage)
469 pa_strbuf_printf(buf, "No module information available\n");
470 else {
471 if (i->version)
472 pa_strbuf_printf(buf, "Version: %s\n", i->version);
473 if (i->description)
474 pa_strbuf_printf(buf, "Description: %s\n", i->description);
475 if (i->author)
476 pa_strbuf_printf(buf, "Author: %s\n", i->author);
477 if (i->usage)
478 pa_strbuf_printf(buf, "Usage: %s\n", i->usage);
479 pa_strbuf_printf(buf, "Load Once: %s\n", pa_yes_no(i->load_once));
480 }
481
482 pa_modinfo_free(i);
483 } else
484 pa_strbuf_puts(buf, "Failed to open module.\n");
485
486 return 0;
487 }
488
489 static int pa_cli_command_sink_volume(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
490 const char *n, *v;
491 pa_sink *sink;
492 uint32_t volume;
493 pa_cvolume cvolume;
494
495 pa_core_assert_ref(c);
496 pa_assert(t);
497 pa_assert(buf);
498 pa_assert(fail);
499
500 if (!(n = pa_tokenizer_get(t, 1))) {
501 pa_strbuf_puts(buf, "You need to specify a sink either by its name or its index.\n");
502 return -1;
503 }
504
505 if (!(v = pa_tokenizer_get(t, 2))) {
506 pa_strbuf_puts(buf, "You need to specify a volume >= 0. (0 is muted, 0x10000 is normal volume)\n");
507 return -1;
508 }
509
510 if (pa_atou(v, &volume) < 0) {
511 pa_strbuf_puts(buf, "Failed to parse volume.\n");
512 return -1;
513 }
514
515 if (!(sink = pa_namereg_get(c, n, PA_NAMEREG_SINK))) {
516 pa_strbuf_puts(buf, "No sink found by this name or index.\n");
517 return -1;
518 }
519
520 pa_cvolume_set(&cvolume, sink->sample_spec.channels, volume);
521 pa_sink_set_volume(sink, &cvolume, TRUE, TRUE);
522 return 0;
523 }
524
525 static int pa_cli_command_sink_input_volume(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
526 const char *n, *v;
527 pa_sink_input *si;
528 pa_volume_t volume;
529 pa_cvolume cvolume;
530 uint32_t idx;
531
532 pa_core_assert_ref(c);
533 pa_assert(t);
534 pa_assert(buf);
535 pa_assert(fail);
536
537 if (!(n = pa_tokenizer_get(t, 1))) {
538 pa_strbuf_puts(buf, "You need to specify a sink input by its index.\n");
539 return -1;
540 }
541
542 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
543 pa_strbuf_puts(buf, "Failed to parse index.\n");
544 return -1;
545 }
546
547 if (!(v = pa_tokenizer_get(t, 2))) {
548 pa_strbuf_puts(buf, "You need to specify a volume >= 0. (0 is muted, 0x10000 is normal volume)\n");
549 return -1;
550 }
551
552 if (pa_atou(v, &volume) < 0) {
553 pa_strbuf_puts(buf, "Failed to parse volume.\n");
554 return -1;
555 }
556
557 if (!(si = pa_idxset_get_by_index(c->sink_inputs, (uint32_t) idx))) {
558 pa_strbuf_puts(buf, "No sink input found with this index.\n");
559 return -1;
560 }
561
562 pa_cvolume_set(&cvolume, si->sample_spec.channels, volume);
563 pa_sink_input_set_volume(si, &cvolume);
564 return 0;
565 }
566
567 static int pa_cli_command_source_volume(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
568 const char *n, *v;
569 pa_source *source;
570 uint32_t volume;
571 pa_cvolume cvolume;
572
573 pa_core_assert_ref(c);
574 pa_assert(t);
575 pa_assert(buf);
576 pa_assert(fail);
577
578 if (!(n = pa_tokenizer_get(t, 1))) {
579 pa_strbuf_puts(buf, "You need to specify a source either by its name or its index.\n");
580 return -1;
581 }
582
583 if (!(v = pa_tokenizer_get(t, 2))) {
584 pa_strbuf_puts(buf, "You need to specify a volume >= 0. (0 is muted, 0x10000 is normal volume)\n");
585 return -1;
586 }
587
588 if (pa_atou(v, &volume) < 0) {
589 pa_strbuf_puts(buf, "Failed to parse volume.\n");
590 return -1;
591 }
592
593 if (!(source = pa_namereg_get(c, n, PA_NAMEREG_SOURCE))) {
594 pa_strbuf_puts(buf, "No source found by this name or index.\n");
595 return -1;
596 }
597
598 pa_cvolume_set(&cvolume, source->sample_spec.channels, volume);
599 pa_source_set_volume(source, &cvolume);
600 return 0;
601 }
602
603 static int pa_cli_command_sink_mute(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
604 const char *n, *m;
605 pa_sink *sink;
606 int mute;
607
608 pa_core_assert_ref(c);
609 pa_assert(t);
610 pa_assert(buf);
611 pa_assert(fail);
612
613 if (!(n = pa_tokenizer_get(t, 1))) {
614 pa_strbuf_puts(buf, "You need to specify a sink either by its name or its index.\n");
615 return -1;
616 }
617
618 if (!(m = pa_tokenizer_get(t, 2))) {
619 pa_strbuf_puts(buf, "You need to specify a mute switch setting (0/1).\n");
620 return -1;
621 }
622
623 if ((mute = pa_parse_boolean(m)) < 0) {
624 pa_strbuf_puts(buf, "Failed to parse mute switch.\n");
625 return -1;
626 }
627
628 if (!(sink = pa_namereg_get(c, n, PA_NAMEREG_SINK))) {
629 pa_strbuf_puts(buf, "No sink found by this name or index.\n");
630 return -1;
631 }
632
633 pa_sink_set_mute(sink, mute);
634 return 0;
635 }
636
637 static int pa_cli_command_source_mute(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
638 const char *n, *m;
639 pa_source *source;
640 int mute;
641
642 pa_core_assert_ref(c);
643 pa_assert(t);
644 pa_assert(buf);
645 pa_assert(fail);
646
647 if (!(n = pa_tokenizer_get(t, 1))) {
648 pa_strbuf_puts(buf, "You need to specify a source either by its name or its index.\n");
649 return -1;
650 }
651
652 if (!(m = pa_tokenizer_get(t, 2))) {
653 pa_strbuf_puts(buf, "You need to specify a mute switch setting (0/1).\n");
654 return -1;
655 }
656
657 if ((mute = pa_parse_boolean(m)) < 0) {
658 pa_strbuf_puts(buf, "Failed to parse mute switch.\n");
659 return -1;
660 }
661
662 if (!(source = pa_namereg_get(c, n, PA_NAMEREG_SOURCE))) {
663 pa_strbuf_puts(buf, "No sink found by this name or index.\n");
664 return -1;
665 }
666
667 pa_source_set_mute(source, mute);
668 return 0;
669 }
670
671 static int pa_cli_command_update_sink_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
672 const char *n, *s;
673 pa_sink *sink;
674 pa_proplist *p;
675
676 pa_core_assert_ref(c);
677 pa_assert(t);
678 pa_assert(buf);
679 pa_assert(fail);
680
681 if (!(n = pa_tokenizer_get(t, 1))) {
682 pa_strbuf_puts(buf, "You need to specify a sink either by its name or its index.\n");
683 return -1;
684 }
685
686 if (!(s = pa_tokenizer_get(t, 2))) {
687 pa_strbuf_puts(buf, "You need to specify a \"key=value\" argument.\n");
688 return -1;
689 }
690
691 if (!(sink = pa_namereg_get(c, n, PA_NAMEREG_SINK))) {
692 pa_strbuf_puts(buf, "No sink found by this name or index.\n");
693 return -1;
694 }
695
696 p = pa_proplist_from_string(s);
697
698 pa_sink_update_proplist(sink, PA_UPDATE_REPLACE, p);
699
700 pa_proplist_free(p);
701
702 return 0;
703 }
704
705 static int pa_cli_command_update_source_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
706 const char *n, *s;
707 pa_source *source;
708 pa_proplist *p;
709
710 pa_core_assert_ref(c);
711 pa_assert(t);
712 pa_assert(buf);
713 pa_assert(fail);
714
715 if (!(n = pa_tokenizer_get(t, 1))) {
716 pa_strbuf_puts(buf, "You need to specify a source either by its name or its index.\n");
717 return -1;
718 }
719
720 if (!(s = pa_tokenizer_get(t, 2))) {
721 pa_strbuf_puts(buf, "You need to specify a \"key=value\" argument.\n");
722 return -1;
723 }
724
725 if (!(source = pa_namereg_get(c, n, PA_NAMEREG_SOURCE))) {
726 pa_strbuf_puts(buf, "No source found by this name or index.\n");
727 return -1;
728 }
729
730 p = pa_proplist_from_string(s);
731
732 pa_source_update_proplist(source, PA_UPDATE_REPLACE, p);
733
734 pa_proplist_free(p);
735
736 return 0;
737 }
738
739 static int pa_cli_command_update_sink_input_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
740 const char *n, *s;
741 pa_sink_input *si;
742 uint32_t idx;
743 pa_proplist *p;
744
745 pa_core_assert_ref(c);
746 pa_assert(t);
747 pa_assert(buf);
748 pa_assert(fail);
749
750 if (!(n = pa_tokenizer_get(t, 1))) {
751 pa_strbuf_puts(buf, "You need to specify a sink input either by index.\n");
752 return -1;
753 }
754
755 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
756 pa_strbuf_puts(buf, "Failed to parse index.\n");
757 return -1;
758 }
759
760 if (!(s = pa_tokenizer_get(t, 2))) {
761 pa_strbuf_puts(buf, "You need to specify a \"key=value\" argument.\n");
762 return -1;
763 }
764
765 if (!(si = pa_idxset_get_by_index(c->sink_inputs, (uint32_t) idx))) {
766 pa_strbuf_puts(buf, "No sink input found with this index.\n");
767 return -1;
768 }
769
770 p = pa_proplist_from_string(s);
771
772 pa_sink_input_update_proplist(si, PA_UPDATE_REPLACE, p);
773
774 pa_proplist_free(p);
775
776 return 0;
777 }
778
779 static int pa_cli_command_update_source_output_proplist(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
780 const char *n, *s;
781 pa_source_output *so;
782 uint32_t idx;
783 pa_proplist *p;
784
785 pa_core_assert_ref(c);
786 pa_assert(t);
787 pa_assert(buf);
788 pa_assert(fail);
789
790 if (!(n = pa_tokenizer_get(t, 1))) {
791 pa_strbuf_puts(buf, "You need to specify a source output by its index.\n");
792 return -1;
793 }
794
795 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
796 pa_strbuf_puts(buf, "Failed to parse index.\n");
797 return -1;
798 }
799
800 if (!(s = pa_tokenizer_get(t, 2))) {
801 pa_strbuf_puts(buf, "You need to specify a \"key=value\" argument.\n");
802 return -1;
803 }
804
805 if (!(so = pa_idxset_get_by_index(c->source_outputs, (uint32_t) idx))) {
806 pa_strbuf_puts(buf, "No source output found with this index.\n");
807 return -1;
808 }
809
810 p = pa_proplist_from_string(s);
811
812 pa_source_output_update_proplist(so, PA_UPDATE_REPLACE, p);
813
814 pa_proplist_free(p);
815
816 return 0;
817 }
818
819 static int pa_cli_command_sink_input_mute(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
820 const char *n, *v;
821 pa_sink_input *si;
822 uint32_t idx;
823 int mute;
824
825 pa_core_assert_ref(c);
826 pa_assert(t);
827 pa_assert(buf);
828 pa_assert(fail);
829
830 if (!(n = pa_tokenizer_get(t, 1))) {
831 pa_strbuf_puts(buf, "You need to specify a sink input by its index.\n");
832 return -1;
833 }
834
835 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
836 pa_strbuf_puts(buf, "Failed to parse index.\n");
837 return -1;
838 }
839
840 if (!(v = pa_tokenizer_get(t, 2))) {
841 pa_strbuf_puts(buf, "You need to specify a mute switch setting (0/1).\n");
842 return -1;
843 }
844
845 if ((mute = pa_parse_boolean(v)) < 0) {
846 pa_strbuf_puts(buf, "Failed to parse mute switch.\n");
847 return -1;
848 }
849
850 if (!(si = pa_idxset_get_by_index(c->sink_inputs, (uint32_t) idx))) {
851 pa_strbuf_puts(buf, "No sink input found with this index.\n");
852 return -1;
853 }
854
855 pa_sink_input_set_mute(si, mute);
856 return 0;
857 }
858
859 static int pa_cli_command_sink_default(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
860 const char *n;
861
862 pa_core_assert_ref(c);
863 pa_assert(t);
864 pa_assert(buf);
865 pa_assert(fail);
866
867 if (!(n = pa_tokenizer_get(t, 1))) {
868 pa_strbuf_puts(buf, "You need to specify a sink either by its name or its index.\n");
869 return -1;
870 }
871
872 pa_namereg_set_default(c, n, PA_NAMEREG_SINK);
873 return 0;
874 }
875
876 static int pa_cli_command_source_default(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
877 const char *n;
878
879 pa_core_assert_ref(c);
880 pa_assert(t);
881 pa_assert(buf);
882 pa_assert(fail);
883
884 if (!(n = pa_tokenizer_get(t, 1))) {
885 pa_strbuf_puts(buf, "You need to specify a source either by its name or its index.\n");
886 return -1;
887 }
888
889 pa_namereg_set_default(c, n, PA_NAMEREG_SOURCE);
890 return 0;
891 }
892
893 static int pa_cli_command_kill_client(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
894 const char *n;
895 pa_client *client;
896 uint32_t idx;
897
898 pa_core_assert_ref(c);
899 pa_assert(t);
900 pa_assert(buf);
901 pa_assert(fail);
902
903 if (!(n = pa_tokenizer_get(t, 1))) {
904 pa_strbuf_puts(buf, "You need to specify a client by its index.\n");
905 return -1;
906 }
907
908 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
909 pa_strbuf_puts(buf, "Failed to parse index.\n");
910 return -1;
911 }
912
913 if (!(client = pa_idxset_get_by_index(c->clients, idx))) {
914 pa_strbuf_puts(buf, "No client found by this index.\n");
915 return -1;
916 }
917
918 pa_client_kill(client);
919 return 0;
920 }
921
922 static int pa_cli_command_kill_sink_input(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
923 const char *n;
924 pa_sink_input *sink_input;
925 uint32_t idx;
926
927 pa_core_assert_ref(c);
928 pa_assert(t);
929 pa_assert(buf);
930 pa_assert(fail);
931
932 if (!(n = pa_tokenizer_get(t, 1))) {
933 pa_strbuf_puts(buf, "You need to specify a sink input by its index.\n");
934 return -1;
935 }
936
937 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
938 pa_strbuf_puts(buf, "Failed to parse index.\n");
939 return -1;
940 }
941
942 if (!(sink_input = pa_idxset_get_by_index(c->sink_inputs, idx))) {
943 pa_strbuf_puts(buf, "No sink input found by this index.\n");
944 return -1;
945 }
946
947 pa_sink_input_kill(sink_input);
948 return 0;
949 }
950
951 static int pa_cli_command_kill_source_output(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
952 const char *n;
953 pa_source_output *source_output;
954 uint32_t idx;
955
956 pa_core_assert_ref(c);
957 pa_assert(t);
958 pa_assert(buf);
959 pa_assert(fail);
960
961 if (!(n = pa_tokenizer_get(t, 1))) {
962 pa_strbuf_puts(buf, "You need to specify a source output by its index.\n");
963 return -1;
964 }
965
966 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
967 pa_strbuf_puts(buf, "Failed to parse index.\n");
968 return -1;
969 }
970
971 if (!(source_output = pa_idxset_get_by_index(c->source_outputs, idx))) {
972 pa_strbuf_puts(buf, "No source output found by this index.\n");
973 return -1;
974 }
975
976 pa_source_output_kill(source_output);
977 return 0;
978 }
979
980 static int pa_cli_command_scache_list(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
981 char *s;
982
983 pa_core_assert_ref(c);
984 pa_assert(t);
985 pa_assert(buf);
986 pa_assert(fail);
987
988 pa_assert_se(s = pa_scache_list_to_string(c));
989 pa_strbuf_puts(buf, s);
990 pa_xfree(s);
991
992 return 0;
993 }
994
995 static int pa_cli_command_scache_play(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
996 const char *n, *sink_name;
997 pa_sink *sink;
998 uint32_t idx;
999
1000 pa_core_assert_ref(c);
1001 pa_assert(t);
1002 pa_assert(buf);
1003 pa_assert(fail);
1004
1005 if (!(n = pa_tokenizer_get(t, 1)) || !(sink_name = pa_tokenizer_get(t, 2))) {
1006 pa_strbuf_puts(buf, "You need to specify a sample name and a sink name.\n");
1007 return -1;
1008 }
1009
1010 if (!(sink = pa_namereg_get(c, sink_name, PA_NAMEREG_SINK))) {
1011 pa_strbuf_puts(buf, "No sink by that name.\n");
1012 return -1;
1013 }
1014
1015 if (pa_scache_play_item(c, n, sink, PA_VOLUME_NORM, NULL, &idx) < 0) {
1016 pa_strbuf_puts(buf, "Failed to play sample.\n");
1017 return -1;
1018 }
1019
1020 pa_strbuf_printf(buf, "Playing on sink input #%i\n", idx);
1021
1022 return 0;
1023 }
1024
1025 static int pa_cli_command_scache_remove(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1026 const char *n;
1027
1028 pa_core_assert_ref(c);
1029 pa_assert(t);
1030 pa_assert(buf);
1031 pa_assert(fail);
1032
1033 if (!(n = pa_tokenizer_get(t, 1))) {
1034 pa_strbuf_puts(buf, "You need to specify a sample name.\n");
1035 return -1;
1036 }
1037
1038 if (pa_scache_remove_item(c, n) < 0) {
1039 pa_strbuf_puts(buf, "Failed to remove sample.\n");
1040 return -1;
1041 }
1042
1043 return 0;
1044 }
1045
1046 static int pa_cli_command_scache_load(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1047 const char *fname, *n;
1048 int r;
1049
1050 pa_core_assert_ref(c);
1051 pa_assert(t);
1052 pa_assert(buf);
1053 pa_assert(fail);
1054
1055 if (!(fname = pa_tokenizer_get(t, 2)) || !(n = pa_tokenizer_get(t, 1))) {
1056 pa_strbuf_puts(buf, "You need to specify a file name and a sample name.\n");
1057 return -1;
1058 }
1059
1060 if (strstr(pa_tokenizer_get(t, 0), "lazy"))
1061 r = pa_scache_add_file_lazy(c, n, fname, NULL);
1062 else
1063 r = pa_scache_add_file(c, n, fname, NULL);
1064
1065 if (r < 0)
1066 pa_strbuf_puts(buf, "Failed to load sound file.\n");
1067
1068 return 0;
1069 }
1070
1071 static int pa_cli_command_scache_load_dir(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1072 const char *pname;
1073
1074 pa_core_assert_ref(c);
1075 pa_assert(t);
1076 pa_assert(buf);
1077 pa_assert(fail);
1078
1079 if (!(pname = pa_tokenizer_get(t, 1))) {
1080 pa_strbuf_puts(buf, "You need to specify a path name.\n");
1081 return -1;
1082 }
1083
1084 if (pa_scache_add_directory_lazy(c, pname) < 0) {
1085 pa_strbuf_puts(buf, "Failed to load directory.\n");
1086 return -1;
1087 }
1088
1089 return 0;
1090 }
1091
1092 static int pa_cli_command_play_file(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1093 const char *fname, *sink_name;
1094 pa_sink *sink;
1095
1096 pa_core_assert_ref(c);
1097 pa_assert(t);
1098 pa_assert(buf);
1099 pa_assert(fail);
1100
1101 if (!(fname = pa_tokenizer_get(t, 1)) || !(sink_name = pa_tokenizer_get(t, 2))) {
1102 pa_strbuf_puts(buf, "You need to specify a file name and a sink name.\n");
1103 return -1;
1104 }
1105
1106 if (!(sink = pa_namereg_get(c, sink_name, PA_NAMEREG_SINK))) {
1107 pa_strbuf_puts(buf, "No sink by that name.\n");
1108 return -1;
1109 }
1110
1111
1112 return pa_play_file(sink, fname, NULL);
1113 }
1114
1115 static int pa_cli_command_list_shared_props(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1116 pa_core_assert_ref(c);
1117 pa_assert(t);
1118 pa_assert(buf);
1119 pa_assert(fail);
1120
1121 pa_shared_dump(c, buf);
1122 return 0;
1123 }
1124
1125 static int pa_cli_command_vacuum(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1126 pa_core_assert_ref(c);
1127 pa_assert(t);
1128 pa_assert(buf);
1129 pa_assert(fail);
1130
1131 pa_mempool_vacuum(c->mempool);
1132
1133 return 0;
1134 }
1135
1136 static int pa_cli_command_move_sink_input(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1137 const char *n, *k;
1138 pa_sink_input *si;
1139 pa_sink *sink;
1140 uint32_t idx;
1141
1142 pa_core_assert_ref(c);
1143 pa_assert(t);
1144 pa_assert(buf);
1145 pa_assert(fail);
1146
1147 if (!(n = pa_tokenizer_get(t, 1))) {
1148 pa_strbuf_puts(buf, "You need to specify a sink input by its index.\n");
1149 return -1;
1150 }
1151
1152 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
1153 pa_strbuf_puts(buf, "Failed to parse index.\n");
1154 return -1;
1155 }
1156
1157 if (!(k = pa_tokenizer_get(t, 2))) {
1158 pa_strbuf_puts(buf, "You need to specify a sink.\n");
1159 return -1;
1160 }
1161
1162 if (!(si = pa_idxset_get_by_index(c->sink_inputs, (uint32_t) idx))) {
1163 pa_strbuf_puts(buf, "No sink input found with this index.\n");
1164 return -1;
1165 }
1166
1167 if (!(sink = pa_namereg_get(c, k, PA_NAMEREG_SINK))) {
1168 pa_strbuf_puts(buf, "No sink found by this name or index.\n");
1169 return -1;
1170 }
1171
1172 if (pa_sink_input_move_to(si, sink) < 0) {
1173 pa_strbuf_puts(buf, "Moved failed.\n");
1174 return -1;
1175 }
1176 return 0;
1177 }
1178
1179 static int pa_cli_command_move_source_output(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1180 const char *n, *k;
1181 pa_source_output *so;
1182 pa_source *source;
1183 uint32_t idx;
1184
1185 pa_core_assert_ref(c);
1186 pa_assert(t);
1187 pa_assert(buf);
1188 pa_assert(fail);
1189
1190 if (!(n = pa_tokenizer_get(t, 1))) {
1191 pa_strbuf_puts(buf, "You need to specify a source output by its index.\n");
1192 return -1;
1193 }
1194
1195 if ((idx = parse_index(n)) == PA_IDXSET_INVALID) {
1196 pa_strbuf_puts(buf, "Failed to parse index.\n");
1197 return -1;
1198 }
1199
1200 if (!(k = pa_tokenizer_get(t, 2))) {
1201 pa_strbuf_puts(buf, "You need to specify a source.\n");
1202 return -1;
1203 }
1204
1205 if (!(so = pa_idxset_get_by_index(c->source_outputs, (uint32_t) idx))) {
1206 pa_strbuf_puts(buf, "No source output found with this index.\n");
1207 return -1;
1208 }
1209
1210 if (!(source = pa_namereg_get(c, k, PA_NAMEREG_SOURCE))) {
1211 pa_strbuf_puts(buf, "No source found by this name or index.\n");
1212 return -1;
1213 }
1214
1215 if (pa_source_output_move_to(so, source) < 0) {
1216 pa_strbuf_puts(buf, "Moved failed.\n");
1217 return -1;
1218 }
1219 return 0;
1220 }
1221
1222 static int pa_cli_command_suspend_sink(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1223 const char *n, *m;
1224 pa_sink *sink;
1225 int suspend;
1226
1227 pa_core_assert_ref(c);
1228 pa_assert(t);
1229 pa_assert(buf);
1230 pa_assert(fail);
1231
1232 if (!(n = pa_tokenizer_get(t, 1))) {
1233 pa_strbuf_puts(buf, "You need to specify a sink either by its name or its index.\n");
1234 return -1;
1235 }
1236
1237 if (!(m = pa_tokenizer_get(t, 2))) {
1238 pa_strbuf_puts(buf, "You need to specify a suspend switch setting (0/1).\n");
1239 return -1;
1240 }
1241
1242 if ((suspend = pa_parse_boolean(m)) < 0) {
1243 pa_strbuf_puts(buf, "Failed to parse suspend switch.\n");
1244 return -1;
1245 }
1246
1247 if (!(sink = pa_namereg_get(c, n, PA_NAMEREG_SINK))) {
1248 pa_strbuf_puts(buf, "No sink found by this name or index.\n");
1249 return -1;
1250 }
1251
1252 pa_sink_suspend(sink, suspend);
1253 return 0;
1254 }
1255
1256 static int pa_cli_command_suspend_source(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1257 const char *n, *m;
1258 pa_source *source;
1259 int suspend;
1260
1261 pa_core_assert_ref(c);
1262 pa_assert(t);
1263 pa_assert(buf);
1264 pa_assert(fail);
1265
1266 if (!(n = pa_tokenizer_get(t, 1))) {
1267 pa_strbuf_puts(buf, "You need to specify a source either by its name or its index.\n");
1268 return -1;
1269 }
1270
1271 if (!(m = pa_tokenizer_get(t, 2))) {
1272 pa_strbuf_puts(buf, "You need to specify a suspend switch setting (0/1).\n");
1273 return -1;
1274 }
1275
1276 if ((suspend = pa_parse_boolean(m)) < 0) {
1277 pa_strbuf_puts(buf, "Failed to parse suspend switch.\n");
1278 return -1;
1279 }
1280
1281 if (!(source = pa_namereg_get(c, n, PA_NAMEREG_SOURCE))) {
1282 pa_strbuf_puts(buf, "No source found by this name or index.\n");
1283 return -1;
1284 }
1285
1286 pa_source_suspend(source, suspend);
1287 return 0;
1288 }
1289
1290 static int pa_cli_command_suspend(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1291 const char *m;
1292 int suspend;
1293 int ret;
1294
1295 pa_core_assert_ref(c);
1296 pa_assert(t);
1297 pa_assert(buf);
1298 pa_assert(fail);
1299
1300 if (!(m = pa_tokenizer_get(t, 1))) {
1301 pa_strbuf_puts(buf, "You need to specify a suspend switch setting (0/1).\n");
1302 return -1;
1303 }
1304
1305 if ((suspend = pa_parse_boolean(m)) < 0) {
1306 pa_strbuf_puts(buf, "Failed to parse suspend switch.\n");
1307 return -1;
1308 }
1309
1310 ret = - (pa_sink_suspend_all(c, suspend) < 0);
1311 if (pa_source_suspend_all(c, suspend) < 0)
1312 ret = -1;
1313
1314 if (ret < 0)
1315 pa_strbuf_puts(buf, "Failed to resume/suspend all sinks/sources.\n");
1316
1317 return 0;
1318 }
1319
1320 static int pa_cli_command_log_level(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1321 const char *m;
1322 uint32_t level;
1323
1324 pa_core_assert_ref(c);
1325 pa_assert(t);
1326 pa_assert(buf);
1327 pa_assert(fail);
1328
1329 if (!(m = pa_tokenizer_get(t, 1))) {
1330 pa_strbuf_puts(buf, "You need to specify a log level (0..4).\n");
1331 return -1;
1332 }
1333
1334 if (pa_atou(m, &level) < 0 || level >= PA_LOG_LEVEL_MAX) {
1335 pa_strbuf_puts(buf, "Failed to parse log level.\n");
1336 return -1;
1337 }
1338
1339 pa_log_set_maximal_level(level);
1340
1341 return 0;
1342 }
1343
1344 static int pa_cli_command_log_meta(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1345 const char *m;
1346 pa_bool_t b;
1347
1348 pa_core_assert_ref(c);
1349 pa_assert(t);
1350 pa_assert(buf);
1351 pa_assert(fail);
1352
1353 if (!(m = pa_tokenizer_get(t, 1))) {
1354 pa_strbuf_puts(buf, "You need to specify a boolean.\n");
1355 return -1;
1356 }
1357
1358 if ((b = pa_parse_boolean(m)) < 0) {
1359 pa_strbuf_puts(buf, "Failed to parse log meta switch.\n");
1360 return -1;
1361 }
1362
1363 pa_log_set_show_meta(b);
1364
1365 return 0;
1366 }
1367
1368 static int pa_cli_command_log_time(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1369 const char *m;
1370 pa_bool_t b;
1371
1372 pa_core_assert_ref(c);
1373 pa_assert(t);
1374 pa_assert(buf);
1375 pa_assert(fail);
1376
1377 if (!(m = pa_tokenizer_get(t, 1))) {
1378 pa_strbuf_puts(buf, "You need to specify a boolean.\n");
1379 return -1;
1380 }
1381
1382 if ((b = pa_parse_boolean(m)) < 0) {
1383 pa_strbuf_puts(buf, "Failed to parse log meta switch.\n");
1384 return -1;
1385 }
1386
1387 pa_log_set_show_time(b);
1388
1389 return 0;
1390 }
1391
1392 static int pa_cli_command_log_backtrace(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1393 const char *m;
1394 uint32_t nframes;
1395
1396 pa_core_assert_ref(c);
1397 pa_assert(t);
1398 pa_assert(buf);
1399 pa_assert(fail);
1400
1401 if (!(m = pa_tokenizer_get(t, 1))) {
1402 pa_strbuf_puts(buf, "You need to specify a backtrace level.\n");
1403 return -1;
1404 }
1405
1406 if (pa_atou(m, &nframes) < 0 || nframes >= 1000) {
1407 pa_strbuf_puts(buf, "Failed to parse backtrace level.\n");
1408 return -1;
1409 }
1410
1411 pa_log_set_show_backtrace(nframes);
1412
1413 return 0;
1414 }
1415
1416 static int pa_cli_command_card_profile(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1417 const char *n, *p;
1418 pa_card *card;
1419
1420 pa_core_assert_ref(c);
1421 pa_assert(t);
1422 pa_assert(buf);
1423 pa_assert(fail);
1424
1425 if (!(n = pa_tokenizer_get(t, 1))) {
1426 pa_strbuf_puts(buf, "You need to specify a card either by its name or its index.\n");
1427 return -1;
1428 }
1429
1430 if (!(p = pa_tokenizer_get(t, 2))) {
1431 pa_strbuf_puts(buf, "You need to specify a profile by its name.\n");
1432 return -1;
1433 }
1434
1435 if (!(card = pa_namereg_get(c, n, PA_NAMEREG_CARD))) {
1436 pa_strbuf_puts(buf, "No card found by this name or index.\n");
1437 return -1;
1438 }
1439
1440 if (pa_card_set_profile(card, p) < 0) {
1441 pa_strbuf_printf(buf, "Failed to set card profile to '%s'.\n", p);
1442 return -1;
1443 }
1444
1445 return 0;
1446 }
1447
1448 static int pa_cli_command_dump(pa_core *c, pa_tokenizer *t, pa_strbuf *buf, pa_bool_t *fail) {
1449 pa_module *m;
1450 pa_sink *sink;
1451 pa_source *source;
1452 pa_card *card;
1453 int nl;
1454 const char *p;
1455 uint32_t idx;
1456 char txt[256];
1457 time_t now;
1458
1459 pa_core_assert_ref(c);
1460 pa_assert(t);
1461 pa_assert(buf);
1462 pa_assert(fail);
1463
1464 time(&now);
1465
1466 #ifdef HAVE_CTIME_R
1467 pa_strbuf_printf(buf, "### Configuration dump generated at %s\n", ctime_r(&now, txt));
1468 #else
1469 pa_strbuf_printf(buf, "### Configuration dump generated at %s\n", ctime(&now));
1470 #endif
1471
1472 for (m = pa_idxset_first(c->modules, &idx); m; m = pa_idxset_next(c->modules, &idx)) {
1473
1474 pa_strbuf_printf(buf, "load-module %s", m->name);
1475
1476 if (m->argument)
1477 pa_strbuf_printf(buf, " %s", m->argument);
1478
1479 pa_strbuf_puts(buf, "\n");
1480 }
1481
1482 nl = 0;
1483
1484 for (sink = pa_idxset_first(c->sinks, &idx); sink; sink = pa_idxset_next(c->sinks, &idx)) {
1485
1486 if (!nl) {
1487 pa_strbuf_puts(buf, "\n");
1488 nl = 1;
1489 }
1490
1491 pa_strbuf_printf(buf, "set-sink-volume %s 0x%03x\n", sink->name, pa_cvolume_avg(pa_sink_get_volume(sink, FALSE)));
1492 pa_strbuf_printf(buf, "set-sink-mute %s %s\n", sink->name, pa_yes_no(pa_sink_get_mute(sink, FALSE)));
1493 pa_strbuf_printf(buf, "suspend-sink %s %s\n", sink->name, pa_yes_no(pa_sink_get_state(sink) == PA_SINK_SUSPENDED));
1494 }
1495
1496 for (source = pa_idxset_first(c->sources, &idx); source; source = pa_idxset_next(c->sources, &idx)) {
1497
1498 if (!nl) {
1499 pa_strbuf_puts(buf, "\n");
1500 nl = 1;
1501 }
1502
1503 pa_strbuf_printf(buf, "set-source-volume %s 0x%03x\n", source->name, pa_cvolume_avg(pa_source_get_volume(source, FALSE)));
1504 pa_strbuf_printf(buf, "set-source-mute %s %s\n", source->name, pa_yes_no(pa_source_get_mute(source, FALSE)));
1505 pa_strbuf_printf(buf, "suspend-source %s %s\n", source->name, pa_yes_no(pa_source_get_state(source) == PA_SOURCE_SUSPENDED));
1506 }
1507
1508 for (card = pa_idxset_first(c->cards, &idx); card; card = pa_idxset_next(c->cards, &idx)) {
1509
1510 if (!nl) {
1511 pa_strbuf_puts(buf, "\n");
1512 nl = 1;
1513 }
1514
1515 if (card->active_profile)
1516 pa_strbuf_printf(buf, "set-card-profile %s %s\n", card->name, card->active_profile->name);
1517 }
1518
1519 nl = 0;
1520
1521 if ((p = pa_namereg_get_default_sink_name(c))) {
1522 if (!nl) {
1523 pa_strbuf_puts(buf, "\n");
1524 nl = 1;
1525 }
1526 pa_strbuf_printf(buf, "set-default-sink %s\n", p);
1527 }
1528
1529 if ((p = pa_namereg_get_default_source_name(c))) {
1530 if (!nl) {
1531 pa_strbuf_puts(buf, "\n");
1532 nl = 1;
1533 }
1534 pa_strbuf_printf(buf, "set-default-source %s\n", p);
1535 }
1536
1537 pa_strbuf_puts(buf, "\n### EOF\n");
1538
1539 return 0;
1540 }
1541
1542 int pa_cli_command_execute_line_stateful(pa_core *c, const char *s, pa_strbuf *buf, pa_bool_t *fail, int *ifstate) {
1543 const char *cs;
1544
1545 pa_assert(c);
1546 pa_assert(s);
1547 pa_assert(buf);
1548
1549 cs = s+strspn(s, whitespace);
1550
1551 if (*cs == '#' || !*cs)
1552 return 0;
1553 else if (*cs == '.') {
1554 if (!strcmp(cs, META_ELSE)) {
1555 if (!ifstate || *ifstate == IFSTATE_NONE) {
1556 pa_strbuf_printf(buf, "Meta command %s is not valid in this context\n", cs);
1557 return -1;
1558 } else if (*ifstate == IFSTATE_TRUE)
1559 *ifstate = IFSTATE_FALSE;
1560 else
1561 *ifstate = IFSTATE_TRUE;
1562 return 0;
1563 } else if (!strcmp(cs, META_ENDIF)) {
1564 if (!ifstate || *ifstate == IFSTATE_NONE) {
1565 pa_strbuf_printf(buf, "Meta command %s is not valid in this context\n", cs);
1566 return -1;
1567 } else
1568 *ifstate = IFSTATE_NONE;
1569 return 0;
1570 }
1571 if (ifstate && *ifstate == IFSTATE_FALSE)
1572 return 0;
1573 if (!strcmp(cs, META_FAIL))
1574 *fail = TRUE;
1575 else if (!strcmp(cs, META_NOFAIL))
1576 *fail = FALSE;
1577 else {
1578 size_t l;
1579 l = strcspn(cs, whitespace);
1580
1581 if (l == sizeof(META_INCLUDE)-1 && !strncmp(cs, META_INCLUDE, l)) {
1582 const char *filename = cs+l+strspn(cs+l, whitespace);
1583 if (pa_cli_command_execute_file(c, filename, buf, fail) < 0)
1584 if (*fail)
1585 return -1;
1586 } else if (l == sizeof(META_IFEXISTS)-1 && !strncmp(cs, META_IFEXISTS, l)) {
1587 if (!ifstate) {
1588 pa_strbuf_printf(buf, "Meta command %s is not valid in this context\n", cs);
1589 return -1;
1590 } else if (*ifstate != IFSTATE_NONE) {
1591 pa_strbuf_printf(buf, "Nested %s commands not supported\n", cs);
1592 return -1;
1593 } else {
1594 const char *filename = cs+l+strspn(cs+l, whitespace);
1595
1596 /* Search DL_SEARCH_PATH unless the filename is absolute */
1597 if (filename[0] == PA_PATH_SEP_CHAR) {
1598
1599 *ifstate = access(filename, F_OK) == 0 ? IFSTATE_TRUE : IFSTATE_FALSE;
1600 pa_log_debug("Checking for existance of '%s': %s", filename, *ifstate == IFSTATE_TRUE ? "success" : "failure");
1601
1602 } else {
1603 const char *paths, *state = NULL;
1604 char *p;
1605
1606 if (!(paths = lt_dlgetsearchpath()))
1607 return -1;
1608
1609 while ((p = pa_split(paths, ":", &state))) {
1610 char *pathname;
1611
1612 pathname = pa_sprintf_malloc("%s" PA_PATH_SEP "%s", p, filename);
1613 pa_xfree(p);
1614
1615 *ifstate = access(pathname, F_OK) == 0 ? IFSTATE_TRUE : IFSTATE_FALSE;
1616 pa_log_debug("Checking for existance of '%s': %s", pathname, *ifstate == IFSTATE_TRUE ? "success" : "failure");
1617
1618 pa_xfree(pathname);
1619
1620 if (*ifstate == IFSTATE_TRUE)
1621 break;
1622 }
1623 }
1624
1625 }
1626 } else {
1627 pa_strbuf_printf(buf, "Invalid meta command: %s\n", cs);
1628 if (*fail) return -1;
1629 }
1630 }
1631 } else {
1632 const struct command*command;
1633 int unknown = 1;
1634 size_t l;
1635
1636 if (ifstate && *ifstate == IFSTATE_FALSE)
1637 return 0;
1638
1639 l = strcspn(cs, whitespace);
1640
1641 for (command = commands; command->name; command++)
1642 if (strlen(command->name) == l && !strncmp(cs, command->name, l)) {
1643 int ret;
1644 pa_tokenizer *t = pa_tokenizer_new(cs, command->args);
1645 pa_assert(t);
1646 ret = command->proc(c, t, buf, fail);
1647 pa_tokenizer_free(t);
1648 unknown = 0;
1649
1650 if (ret < 0 && *fail)
1651 return -1;
1652
1653 break;
1654 }
1655
1656 if (unknown) {
1657 pa_strbuf_printf(buf, "Unknown command: %s\n", cs);
1658 if (*fail)
1659 return -1;
1660 }
1661 }
1662
1663 return 0;
1664 }
1665
1666 int pa_cli_command_execute_line(pa_core *c, const char *s, pa_strbuf *buf, pa_bool_t *fail) {
1667 return pa_cli_command_execute_line_stateful(c, s, buf, fail, NULL);
1668 }
1669
1670 int pa_cli_command_execute_file_stream(pa_core *c, FILE *f, pa_strbuf *buf, pa_bool_t *fail) {
1671 char line[1024];
1672 int ifstate = IFSTATE_NONE;
1673 int ret = -1;
1674 pa_bool_t _fail = TRUE;
1675
1676 pa_assert(c);
1677 pa_assert(f);
1678 pa_assert(buf);
1679
1680 if (!fail)
1681 fail = &_fail;
1682
1683 while (fgets(line, sizeof(line), f)) {
1684 pa_strip_nl(line);
1685
1686 if (pa_cli_command_execute_line_stateful(c, line, buf, fail, &ifstate) < 0 && *fail)
1687 goto fail;
1688 }
1689
1690 ret = 0;
1691
1692 fail:
1693
1694 return ret;
1695 }
1696
1697 int pa_cli_command_execute_file(pa_core *c, const char *fn, pa_strbuf *buf, pa_bool_t *fail) {
1698 FILE *f = NULL;
1699 int ret = -1;
1700 pa_bool_t _fail = TRUE;
1701
1702 pa_assert(c);
1703 pa_assert(fn);
1704 pa_assert(buf);
1705
1706 if (!fail)
1707 fail = &_fail;
1708
1709 if (!(f = fopen(fn, "r"))) {
1710 pa_strbuf_printf(buf, "open('%s') failed: %s\n", fn, pa_cstrerror(errno));
1711 if (!*fail)
1712 ret = 0;
1713 goto fail;
1714 }
1715
1716 ret = pa_cli_command_execute_file_stream(c, f, buf, fail);
1717
1718 ret = 0;
1719
1720 fail:
1721 if (f)
1722 fclose(f);
1723
1724 return ret;
1725 }
1726
1727 int pa_cli_command_execute(pa_core *c, const char *s, pa_strbuf *buf, pa_bool_t *fail) {
1728 const char *p;
1729 int ifstate = IFSTATE_NONE;
1730 pa_bool_t _fail = TRUE;
1731
1732 pa_assert(c);
1733 pa_assert(s);
1734 pa_assert(buf);
1735
1736 if (!fail)
1737 fail = &_fail;
1738
1739 p = s;
1740 while (*p) {
1741 size_t l = strcspn(p, linebreak);
1742 char *line = pa_xstrndup(p, l);
1743
1744 if (pa_cli_command_execute_line_stateful(c, line, buf, fail, &ifstate) < 0 && *fail) {
1745 pa_xfree(line);
1746 return -1;
1747 }
1748 pa_xfree(line);
1749
1750 p += l;
1751 p += strspn(p, linebreak);
1752 }
1753
1754 return 0;
1755 }