2 This file is part of PulseAudio.
4 Copyright 2004-2006 Lennart Poettering
5 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
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.
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.
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
34 #include <pulse/xmalloc.h>
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/autoload.h>
51 #include <pulsecore/sound-file-stream.h>
52 #include <pulsecore/shared.h>
53 #include <pulsecore/core-util.h>
54 #include <pulsecore/core-error.h>
56 #include "cli-command.h"
60 int (*proc
) (pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
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"
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_autoload_list(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
111 static int pa_cli_command_autoload_add(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
112 static int pa_cli_command_autoload_remove(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
113 static int pa_cli_command_dump(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
114 static int pa_cli_command_list_shared_props(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
115 static int pa_cli_command_move_sink_input(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
116 static int pa_cli_command_move_source_output(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
117 static int pa_cli_command_vacuum(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
118 static int pa_cli_command_suspend_sink(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
119 static int pa_cli_command_suspend_source(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
120 static int pa_cli_command_suspend(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
121 static int pa_cli_command_log_level(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
122 static int pa_cli_command_log_meta(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
123 static int pa_cli_command_log_time(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
124 static int pa_cli_command_log_backtrace(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
125 static int pa_cli_command_update_sink_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
126 static int pa_cli_command_update_source_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
127 static int pa_cli_command_update_sink_input_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
128 static int pa_cli_command_update_source_output_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
);
130 /* A method table for all available commands */
132 static const struct command commands
[] = {
133 { "exit", pa_cli_command_exit
, "Terminate the daemon", 1 },
134 { "help", pa_cli_command_help
, "Show this help", 1 },
135 { "list-modules", pa_cli_command_modules
, "List loaded modules", 1 },
136 { "list-sinks", pa_cli_command_sinks
, "List loaded sinks", 1 },
137 { "list-sources", pa_cli_command_sources
, "List loaded sources", 1 },
138 { "list-clients", pa_cli_command_clients
, "List loaded clients", 1 },
139 { "list-sink-inputs", pa_cli_command_sink_inputs
, "List sink inputs", 1 },
140 { "list-source-outputs", pa_cli_command_source_outputs
, "List source outputs", 1 },
141 { "list-cards", pa_cli_command_cards
, "List cards", 1 },
142 { "stat", pa_cli_command_stat
, "Show memory block statistics", 1 },
143 { "info", pa_cli_command_info
, "Show comprehensive status", 1 },
144 { "ls", pa_cli_command_info
, NULL
, 1 },
145 { "list", pa_cli_command_info
, NULL
, 1 },
146 { "load-module", pa_cli_command_load
, "Load a module (args: name, arguments)", 3},
147 { "unload-module", pa_cli_command_unload
, "Unload a module (args: index)", 2},
148 { "describe-module", pa_cli_command_describe
, "Describe a module (arg: name)", 2},
149 { "set-sink-volume", pa_cli_command_sink_volume
, "Set the volume of a sink (args: index|name, volume)", 3},
150 { "set-sink-input-volume", pa_cli_command_sink_input_volume
, "Set the volume of a sink input (args: index, volume)", 3},
151 { "set-source-volume", pa_cli_command_source_volume
, "Set the volume of a source (args: index|name, volume)", 3},
152 { "set-sink-mute", pa_cli_command_sink_mute
, "Set the mute switch of a sink (args: index|name, bool)", 3},
153 { "set-sink-input-mute", pa_cli_command_sink_input_mute
, "Set the mute switch of a sink input (args: index, bool)", 3},
154 { "set-source-mute", pa_cli_command_source_mute
, "Set the mute switch of a source (args: index|name, bool)", 3},
155 { "update-sink-proplist", pa_cli_command_update_sink_proplist
, "Update the properties of a sink (args: index|name, properties)", 3},
156 { "update-source-proplist", pa_cli_command_update_source_proplist
, "Update the properties of a source (args: index|name, properties)", 3},
157 { "update-sink-input-proplist", pa_cli_command_update_sink_input_proplist
, "Update the properties of a sink input (args: index, properties)", 3},
158 { "update-source-output-proplist", pa_cli_command_update_source_output_proplist
, "Update the properties of a source_output (args: index, properties)", 3},
159 { "set-default-sink", pa_cli_command_sink_default
, "Set the default sink (args: index|name)", 2},
160 { "set-default-source", pa_cli_command_source_default
, "Set the default source (args: index|name)", 2},
161 { "kill-client", pa_cli_command_kill_client
, "Kill a client (args: index)", 2},
162 { "kill-sink-input", pa_cli_command_kill_sink_input
, "Kill a sink input (args: index)", 2},
163 { "kill-source-output", pa_cli_command_kill_source_output
, "Kill a source output (args: index)", 2},
164 { "list-samples", pa_cli_command_scache_list
, "List all entries in the sample cache", 1},
165 { "play-sample", pa_cli_command_scache_play
, "Play a sample from the sample cache (args: name, sink|index)", 3},
166 { "remove-sample", pa_cli_command_scache_remove
, "Remove a sample from the sample cache (args: name)", 2},
167 { "load-sample", pa_cli_command_scache_load
, "Load a sound file into the sample cache (args: name, filename)", 3},
168 { "load-sample-lazy", pa_cli_command_scache_load
, "Lazily load a sound file into the sample cache (args: name, filename)", 3},
169 { "load-sample-dir-lazy", pa_cli_command_scache_load_dir
, "Lazily load all files in a directory into the sample cache (args: pathname)", 2},
170 { "play-file", pa_cli_command_play_file
, "Play a sound file (args: filename, sink|index)", 3},
171 { "list-autoload", pa_cli_command_autoload_list
, "List autoload entries", 1},
172 { "add-autoload-sink", pa_cli_command_autoload_add
, NULL
/*"Add autoload entry for a sink (args: sink, module name, arguments)"*/, 4},
173 { "add-autoload-source", pa_cli_command_autoload_add
, NULL
/*"Add autoload entry for a source (args: source, module name, arguments)"*/, 4},
174 { "remove-autoload-sink", pa_cli_command_autoload_remove
, NULL
/*"Remove autoload entry for a sink (args: name)"*/, 2},
175 { "remove-autoload-source", pa_cli_command_autoload_remove
, NULL
/*"Remove autoload entry for a source (args: name)"*/, 2},
176 { "dump", pa_cli_command_dump
, "Dump daemon configuration", 1},
177 { "shared", pa_cli_command_list_shared_props
, NULL
, 1},
178 { "move-sink-input", pa_cli_command_move_sink_input
, "Move sink input to another sink (args: index, sink)", 3},
179 { "move-source-output", pa_cli_command_move_source_output
, "Move source output to another source (args: index, source)", 3},
180 { "vacuum", pa_cli_command_vacuum
, NULL
, 1},
181 { "suspend-sink", pa_cli_command_suspend_sink
, "Suspend sink (args: index|name, bool)", 3},
182 { "suspend-source", pa_cli_command_suspend_source
, "Suspend source (args: index|name, bool)", 3},
183 { "suspend", pa_cli_command_suspend
, "Suspend all sinks and all sources (args: bool)", 2},
184 { "set-log-level", pa_cli_command_log_level
, "Change the log level (args: numeric level)", 2},
185 { "set-log-meta", pa_cli_command_log_meta
, "Show source code location in log messages (args: bool)", 2},
186 { "set-log-time", pa_cli_command_log_time
, "Show timestamps in log messages (args: bool)", 2},
187 { "set-log-backtrace", pa_cli_command_log_backtrace
, "Show bakctrace in log messages (args: frames)", 2},
188 { NULL
, NULL
, NULL
, 0 }
191 static const char whitespace
[] = " \t\n\r";
192 static const char linebreak
[] = "\n\r";
194 static uint32_t parse_index(const char *n
) {
197 if (pa_atou(n
, &idx
) < 0)
198 return (uint32_t) PA_IDXSET_INVALID
;
203 static int pa_cli_command_exit(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
204 pa_core_assert_ref(c
);
209 if (pa_core_exit(c
, FALSE
, 0) < 0)
210 pa_strbuf_puts(buf
, "Not allowed to terminate daemon.\n");
215 static int pa_cli_command_help(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
216 const struct command
*command
;
218 pa_core_assert_ref(c
);
223 pa_strbuf_puts(buf
, "Available commands:\n");
225 for (command
= commands
; command
->name
; command
++)
227 pa_strbuf_printf(buf
, " %-25s %s\n", command
->name
, command
->help
);
231 static int pa_cli_command_modules(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
234 pa_core_assert_ref(c
);
239 pa_assert_se(s
= pa_module_list_to_string(c
));
240 pa_strbuf_puts(buf
, s
);
245 static int pa_cli_command_clients(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
248 pa_core_assert_ref(c
);
253 pa_assert_se(s
= pa_client_list_to_string(c
));
254 pa_strbuf_puts(buf
, s
);
259 static int pa_cli_command_cards(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
262 pa_core_assert_ref(c
);
267 pa_assert_se(s
= pa_card_list_to_string(c
));
268 pa_strbuf_puts(buf
, s
);
273 static int pa_cli_command_sinks(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
276 pa_core_assert_ref(c
);
281 pa_assert_se(s
= pa_sink_list_to_string(c
));
282 pa_strbuf_puts(buf
, s
);
287 static int pa_cli_command_sources(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
290 pa_core_assert_ref(c
);
295 pa_assert_se(s
= pa_source_list_to_string(c
));
296 pa_strbuf_puts(buf
, s
);
301 static int pa_cli_command_sink_inputs(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
304 pa_core_assert_ref(c
);
309 pa_assert_se(s
= pa_sink_input_list_to_string(c
));
310 pa_strbuf_puts(buf
, s
);
315 static int pa_cli_command_source_outputs(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
318 pa_core_assert_ref(c
);
323 pa_assert_se(s
= pa_source_output_list_to_string(c
));
324 pa_strbuf_puts(buf
, s
);
329 static int pa_cli_command_stat(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
331 const pa_mempool_stat
*stat
;
333 const char *def_sink
, *def_source
;
335 static const char* const type_table
[PA_MEMBLOCK_TYPE_MAX
] = {
336 [PA_MEMBLOCK_POOL
] = "POOL",
337 [PA_MEMBLOCK_POOL_EXTERNAL
] = "POOL_EXTERNAL",
338 [PA_MEMBLOCK_APPENDED
] = "APPENDED",
339 [PA_MEMBLOCK_USER
] = "USER",
340 [PA_MEMBLOCK_FIXED
] = "FIXED",
341 [PA_MEMBLOCK_IMPORTED
] = "IMPORTED",
344 pa_core_assert_ref(c
);
349 stat
= pa_mempool_get_stat(c
->mempool
);
351 pa_strbuf_printf(buf
, "Memory blocks currently allocated: %u, size: %s.\n",
352 (unsigned) pa_atomic_load(&stat
->n_allocated
),
353 pa_bytes_snprint(s
, sizeof(s
), (unsigned) pa_atomic_load(&stat
->allocated_size
)));
355 pa_strbuf_printf(buf
, "Memory blocks allocated during the whole lifetime: %u, size: %s.\n",
356 (unsigned) pa_atomic_load(&stat
->n_accumulated
),
357 pa_bytes_snprint(s
, sizeof(s
), (unsigned) pa_atomic_load(&stat
->accumulated_size
)));
359 pa_strbuf_printf(buf
, "Memory blocks imported from other processes: %u, size: %s.\n",
360 (unsigned) pa_atomic_load(&stat
->n_imported
),
361 pa_bytes_snprint(s
, sizeof(s
), (unsigned) pa_atomic_load(&stat
->imported_size
)));
363 pa_strbuf_printf(buf
, "Memory blocks exported to other processes: %u, size: %s.\n",
364 (unsigned) pa_atomic_load(&stat
->n_exported
),
365 pa_bytes_snprint(s
, sizeof(s
), (unsigned) pa_atomic_load(&stat
->exported_size
)));
367 pa_strbuf_printf(buf
, "Total sample cache size: %s.\n",
368 pa_bytes_snprint(s
, sizeof(s
), (unsigned) pa_scache_total_size(c
)));
370 pa_strbuf_printf(buf
, "Default sample spec: %s\n",
371 pa_sample_spec_snprint(s
, sizeof(s
), &c
->default_sample_spec
));
373 def_sink
= pa_namereg_get_default_sink_name(c
);
374 def_source
= pa_namereg_get_default_source_name(c
);
375 pa_strbuf_printf(buf
, "Default sink name: %s\n"
376 "Default source name: %s\n",
377 def_sink
? def_sink
: "none",
378 def_source
? def_source
: "none");
380 for (k
= 0; k
< PA_MEMBLOCK_TYPE_MAX
; k
++)
381 pa_strbuf_printf(buf
,
382 "Memory blocks of type %s: %u allocated/%u accumulated.\n",
384 (unsigned) pa_atomic_load(&stat
->n_allocated_by_type
[k
]),
385 (unsigned) pa_atomic_load(&stat
->n_accumulated_by_type
[k
]));
390 static int pa_cli_command_info(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
391 pa_core_assert_ref(c
);
396 pa_cli_command_stat(c
, t
, buf
, fail
);
397 pa_cli_command_modules(c
, t
, buf
, fail
);
398 pa_cli_command_sinks(c
, t
, buf
, fail
);
399 pa_cli_command_sources(c
, t
, buf
, fail
);
400 pa_cli_command_clients(c
, t
, buf
, fail
);
401 pa_cli_command_cards(c
, t
, buf
, fail
);
402 pa_cli_command_sink_inputs(c
, t
, buf
, fail
);
403 pa_cli_command_source_outputs(c
, t
, buf
, fail
);
404 pa_cli_command_scache_list(c
, t
, buf
, fail
);
405 /* pa_cli_command_autoload_list(c, t, buf, fail); */
409 static int pa_cli_command_load(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
413 pa_core_assert_ref(c
);
418 if (!(name
= pa_tokenizer_get(t
, 1))) {
419 pa_strbuf_puts(buf
, "You need to specify the module name and optionally arguments.\n");
423 if (!(m
= pa_module_load(c
, name
, pa_tokenizer_get(t
, 2)))) {
424 pa_strbuf_puts(buf
, "Module load failed.\n");
431 static int pa_cli_command_unload(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
437 pa_core_assert_ref(c
);
442 if (!(i
= pa_tokenizer_get(t
, 1))) {
443 pa_strbuf_puts(buf
, "You need to specify the module index.\n");
447 idx
= (uint32_t) strtoul(i
, &e
, 10);
448 if (*e
|| !(m
= pa_idxset_get_by_index(c
->modules
, idx
))) {
449 pa_strbuf_puts(buf
, "Invalid module index.\n");
453 pa_module_unload_request(m
, FALSE
);
457 static int pa_cli_command_describe(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
461 pa_core_assert_ref(c
);
466 if (!(name
= pa_tokenizer_get(t
, 1))) {
467 pa_strbuf_puts(buf
, "You need to specify the module name.\n");
471 if ((i
= pa_modinfo_get_by_name(name
))) {
473 pa_strbuf_printf(buf
, "Name: %s\n", name
);
475 if (!i
->description
&& !i
->version
&& !i
->author
&& !i
->usage
)
476 pa_strbuf_printf(buf
, "No module information available\n");
479 pa_strbuf_printf(buf
, "Version: %s\n", i
->version
);
481 pa_strbuf_printf(buf
, "Description: %s\n", i
->description
);
483 pa_strbuf_printf(buf
, "Author: %s\n", i
->author
);
485 pa_strbuf_printf(buf
, "Usage: %s\n", i
->usage
);
486 pa_strbuf_printf(buf
, "Load Once: %s\n", pa_yes_no(i
->load_once
));
491 pa_strbuf_puts(buf
, "Failed to open module.\n");
496 static int pa_cli_command_sink_volume(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
502 pa_core_assert_ref(c
);
507 if (!(n
= pa_tokenizer_get(t
, 1))) {
508 pa_strbuf_puts(buf
, "You need to specify a sink either by its name or its index.\n");
512 if (!(v
= pa_tokenizer_get(t
, 2))) {
513 pa_strbuf_puts(buf
, "You need to specify a volume >= 0. (0 is muted, 0x10000 is normal volume)\n");
517 if (pa_atou(v
, &volume
) < 0) {
518 pa_strbuf_puts(buf
, "Failed to parse volume.\n");
522 if (!(sink
= pa_namereg_get(c
, n
, PA_NAMEREG_SINK
, 1))) {
523 pa_strbuf_puts(buf
, "No sink found by this name or index.\n");
527 pa_cvolume_set(&cvolume
, sink
->sample_spec
.channels
, volume
);
528 pa_sink_set_volume(sink
, &cvolume
);
532 static int pa_cli_command_sink_input_volume(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
539 pa_core_assert_ref(c
);
544 if (!(n
= pa_tokenizer_get(t
, 1))) {
545 pa_strbuf_puts(buf
, "You need to specify a sink input by its index.\n");
549 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
550 pa_strbuf_puts(buf
, "Failed to parse index.\n");
554 if (!(v
= pa_tokenizer_get(t
, 2))) {
555 pa_strbuf_puts(buf
, "You need to specify a volume >= 0. (0 is muted, 0x10000 is normal volume)\n");
559 if (pa_atou(v
, &volume
) < 0) {
560 pa_strbuf_puts(buf
, "Failed to parse volume.\n");
564 if (!(si
= pa_idxset_get_by_index(c
->sink_inputs
, (uint32_t) idx
))) {
565 pa_strbuf_puts(buf
, "No sink input found with this index.\n");
569 pa_cvolume_set(&cvolume
, si
->sample_spec
.channels
, volume
);
570 pa_sink_input_set_volume(si
, &cvolume
);
574 static int pa_cli_command_source_volume(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
580 pa_core_assert_ref(c
);
585 if (!(n
= pa_tokenizer_get(t
, 1))) {
586 pa_strbuf_puts(buf
, "You need to specify a source either by its name or its index.\n");
590 if (!(v
= pa_tokenizer_get(t
, 2))) {
591 pa_strbuf_puts(buf
, "You need to specify a volume >= 0. (0 is muted, 0x10000 is normal volume)\n");
595 if (pa_atou(v
, &volume
) < 0) {
596 pa_strbuf_puts(buf
, "Failed to parse volume.\n");
600 if (!(source
= pa_namereg_get(c
, n
, PA_NAMEREG_SOURCE
, 1))) {
601 pa_strbuf_puts(buf
, "No source found by this name or index.\n");
605 pa_cvolume_set(&cvolume
, source
->sample_spec
.channels
, volume
);
606 pa_source_set_volume(source
, &cvolume
);
610 static int pa_cli_command_sink_mute(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
615 pa_core_assert_ref(c
);
620 if (!(n
= pa_tokenizer_get(t
, 1))) {
621 pa_strbuf_puts(buf
, "You need to specify a sink either by its name or its index.\n");
625 if (!(m
= pa_tokenizer_get(t
, 2))) {
626 pa_strbuf_puts(buf
, "You need to specify a mute switch setting (0/1).\n");
630 if ((mute
= pa_parse_boolean(m
)) < 0) {
631 pa_strbuf_puts(buf
, "Failed to parse mute switch.\n");
635 if (!(sink
= pa_namereg_get(c
, n
, PA_NAMEREG_SINK
, 1))) {
636 pa_strbuf_puts(buf
, "No sink found by this name or index.\n");
640 pa_sink_set_mute(sink
, mute
);
644 static int pa_cli_command_source_mute(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
649 pa_core_assert_ref(c
);
654 if (!(n
= pa_tokenizer_get(t
, 1))) {
655 pa_strbuf_puts(buf
, "You need to specify a source either by its name or its index.\n");
659 if (!(m
= pa_tokenizer_get(t
, 2))) {
660 pa_strbuf_puts(buf
, "You need to specify a mute switch setting (0/1).\n");
664 if ((mute
= pa_parse_boolean(m
)) < 0) {
665 pa_strbuf_puts(buf
, "Failed to parse mute switch.\n");
669 if (!(source
= pa_namereg_get(c
, n
, PA_NAMEREG_SOURCE
, 1))) {
670 pa_strbuf_puts(buf
, "No sink found by this name or index.\n");
674 pa_source_set_mute(source
, mute
);
678 static int pa_cli_command_update_sink_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
683 pa_core_assert_ref(c
);
688 if (!(n
= pa_tokenizer_get(t
, 1))) {
689 pa_strbuf_puts(buf
, "You need to specify a sink either by its name or its index.\n");
693 if (!(s
= pa_tokenizer_get(t
, 2))) {
694 pa_strbuf_puts(buf
, "You need to specify a \"key=value\" argument.\n");
698 if (!(sink
= pa_namereg_get(c
, n
, PA_NAMEREG_SINK
, 1))) {
699 pa_strbuf_puts(buf
, "No sink found by this name or index.\n");
703 p
= pa_proplist_from_string(s
);
705 pa_sink_update_proplist(sink
, PA_UPDATE_REPLACE
, p
);
712 static int pa_cli_command_update_source_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
717 pa_core_assert_ref(c
);
722 if (!(n
= pa_tokenizer_get(t
, 1))) {
723 pa_strbuf_puts(buf
, "You need to specify a source either by its name or its index.\n");
727 if (!(s
= pa_tokenizer_get(t
, 2))) {
728 pa_strbuf_puts(buf
, "You need to specify a \"key=value\" argument.\n");
732 if (!(source
= pa_namereg_get(c
, n
, PA_NAMEREG_SOURCE
, 1))) {
733 pa_strbuf_puts(buf
, "No source found by this name or index.\n");
737 p
= pa_proplist_from_string(s
);
739 pa_source_update_proplist(source
, PA_UPDATE_REPLACE
, p
);
746 static int pa_cli_command_update_sink_input_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
752 pa_core_assert_ref(c
);
757 if (!(n
= pa_tokenizer_get(t
, 1))) {
758 pa_strbuf_puts(buf
, "You need to specify a sink input either by index.\n");
762 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
763 pa_strbuf_puts(buf
, "Failed to parse index.\n");
767 if (!(s
= pa_tokenizer_get(t
, 2))) {
768 pa_strbuf_puts(buf
, "You need to specify a \"key=value\" argument.\n");
772 if (!(si
= pa_idxset_get_by_index(c
->sink_inputs
, (uint32_t) idx
))) {
773 pa_strbuf_puts(buf
, "No sink input found with this index.\n");
777 p
= pa_proplist_from_string(s
);
779 pa_sink_input_update_proplist(si
, PA_UPDATE_REPLACE
, p
);
786 static int pa_cli_command_update_source_output_proplist(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
788 pa_source_output
*so
;
792 pa_core_assert_ref(c
);
797 if (!(n
= pa_tokenizer_get(t
, 1))) {
798 pa_strbuf_puts(buf
, "You need to specify a source output by its index.\n");
802 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
803 pa_strbuf_puts(buf
, "Failed to parse index.\n");
807 if (!(s
= pa_tokenizer_get(t
, 2))) {
808 pa_strbuf_puts(buf
, "You need to specify a \"key=value\" argument.\n");
812 if (!(so
= pa_idxset_get_by_index(c
->source_outputs
, (uint32_t) idx
))) {
813 pa_strbuf_puts(buf
, "No source output found with this index.\n");
817 p
= pa_proplist_from_string(s
);
819 pa_source_output_update_proplist(so
, PA_UPDATE_REPLACE
, p
);
826 static int pa_cli_command_sink_input_mute(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
832 pa_core_assert_ref(c
);
837 if (!(n
= pa_tokenizer_get(t
, 1))) {
838 pa_strbuf_puts(buf
, "You need to specify a sink input by its index.\n");
842 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
843 pa_strbuf_puts(buf
, "Failed to parse index.\n");
847 if (!(v
= pa_tokenizer_get(t
, 2))) {
848 pa_strbuf_puts(buf
, "You need to specify a mute switch setting (0/1).\n");
852 if ((mute
= pa_parse_boolean(v
)) < 0) {
853 pa_strbuf_puts(buf
, "Failed to parse mute switch.\n");
857 if (!(si
= pa_idxset_get_by_index(c
->sink_inputs
, (uint32_t) idx
))) {
858 pa_strbuf_puts(buf
, "No sink input found with this index.\n");
862 pa_sink_input_set_mute(si
, mute
);
866 static int pa_cli_command_sink_default(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
869 pa_core_assert_ref(c
);
874 if (!(n
= pa_tokenizer_get(t
, 1))) {
875 pa_strbuf_puts(buf
, "You need to specify a sink either by its name or its index.\n");
879 pa_namereg_set_default(c
, n
, PA_NAMEREG_SINK
);
883 static int pa_cli_command_source_default(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
886 pa_core_assert_ref(c
);
891 if (!(n
= pa_tokenizer_get(t
, 1))) {
892 pa_strbuf_puts(buf
, "You need to specify a source either by its name or its index.\n");
896 pa_namereg_set_default(c
, n
, PA_NAMEREG_SOURCE
);
900 static int pa_cli_command_kill_client(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
905 pa_core_assert_ref(c
);
910 if (!(n
= pa_tokenizer_get(t
, 1))) {
911 pa_strbuf_puts(buf
, "You need to specify a client by its index.\n");
915 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
916 pa_strbuf_puts(buf
, "Failed to parse index.\n");
920 if (!(client
= pa_idxset_get_by_index(c
->clients
, idx
))) {
921 pa_strbuf_puts(buf
, "No client found by this index.\n");
925 pa_client_kill(client
);
929 static int pa_cli_command_kill_sink_input(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
931 pa_sink_input
*sink_input
;
934 pa_core_assert_ref(c
);
939 if (!(n
= pa_tokenizer_get(t
, 1))) {
940 pa_strbuf_puts(buf
, "You need to specify a sink input by its index.\n");
944 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
945 pa_strbuf_puts(buf
, "Failed to parse index.\n");
949 if (!(sink_input
= pa_idxset_get_by_index(c
->sink_inputs
, idx
))) {
950 pa_strbuf_puts(buf
, "No sink input found by this index.\n");
954 pa_sink_input_kill(sink_input
);
958 static int pa_cli_command_kill_source_output(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
960 pa_source_output
*source_output
;
963 pa_core_assert_ref(c
);
968 if (!(n
= pa_tokenizer_get(t
, 1))) {
969 pa_strbuf_puts(buf
, "You need to specify a source output by its index.\n");
973 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
974 pa_strbuf_puts(buf
, "Failed to parse index.\n");
978 if (!(source_output
= pa_idxset_get_by_index(c
->source_outputs
, idx
))) {
979 pa_strbuf_puts(buf
, "No source output found by this index.\n");
983 pa_source_output_kill(source_output
);
987 static int pa_cli_command_scache_list(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
990 pa_core_assert_ref(c
);
995 pa_assert_se(s
= pa_scache_list_to_string(c
));
996 pa_strbuf_puts(buf
, s
);
1002 static int pa_cli_command_scache_play(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1003 const char *n
, *sink_name
;
1007 pa_core_assert_ref(c
);
1012 if (!(n
= pa_tokenizer_get(t
, 1)) || !(sink_name
= pa_tokenizer_get(t
, 2))) {
1013 pa_strbuf_puts(buf
, "You need to specify a sample name and a sink name.\n");
1017 if (!(sink
= pa_namereg_get(c
, sink_name
, PA_NAMEREG_SINK
, 1))) {
1018 pa_strbuf_puts(buf
, "No sink by that name.\n");
1022 if (pa_scache_play_item(c
, n
, sink
, PA_VOLUME_NORM
, NULL
, &idx
) < 0) {
1023 pa_strbuf_puts(buf
, "Failed to play sample.\n");
1027 pa_strbuf_printf(buf
, "Playing on sink input #%i\n", idx
);
1032 static int pa_cli_command_scache_remove(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1035 pa_core_assert_ref(c
);
1040 if (!(n
= pa_tokenizer_get(t
, 1))) {
1041 pa_strbuf_puts(buf
, "You need to specify a sample name.\n");
1045 if (pa_scache_remove_item(c
, n
) < 0) {
1046 pa_strbuf_puts(buf
, "Failed to remove sample.\n");
1053 static int pa_cli_command_scache_load(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1054 const char *fname
, *n
;
1057 pa_core_assert_ref(c
);
1062 if (!(fname
= pa_tokenizer_get(t
, 2)) || !(n
= pa_tokenizer_get(t
, 1))) {
1063 pa_strbuf_puts(buf
, "You need to specify a file name and a sample name.\n");
1067 if (strstr(pa_tokenizer_get(t
, 0), "lazy"))
1068 r
= pa_scache_add_file_lazy(c
, n
, fname
, NULL
);
1070 r
= pa_scache_add_file(c
, n
, fname
, NULL
);
1073 pa_strbuf_puts(buf
, "Failed to load sound file.\n");
1078 static int pa_cli_command_scache_load_dir(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1081 pa_core_assert_ref(c
);
1086 if (!(pname
= pa_tokenizer_get(t
, 1))) {
1087 pa_strbuf_puts(buf
, "You need to specify a path name.\n");
1091 if (pa_scache_add_directory_lazy(c
, pname
) < 0) {
1092 pa_strbuf_puts(buf
, "Failed to load directory.\n");
1099 static int pa_cli_command_play_file(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1100 const char *fname
, *sink_name
;
1103 pa_core_assert_ref(c
);
1108 if (!(fname
= pa_tokenizer_get(t
, 1)) || !(sink_name
= pa_tokenizer_get(t
, 2))) {
1109 pa_strbuf_puts(buf
, "You need to specify a file name and a sink name.\n");
1113 if (!(sink
= pa_namereg_get(c
, sink_name
, PA_NAMEREG_SINK
, 1))) {
1114 pa_strbuf_puts(buf
, "No sink by that name.\n");
1119 return pa_play_file(sink
, fname
, NULL
);
1122 static int pa_cli_command_autoload_add(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1125 pa_core_assert_ref(c
);
1130 pa_log_warn("Autoload will no longer be implemented by future versions of the PulseAudio server.");
1132 if (!(a
= pa_tokenizer_get(t
, 1)) || !(b
= pa_tokenizer_get(t
, 2))) {
1133 pa_strbuf_puts(buf
, "You need to specify a device name, a filename or a module name and optionally module arguments\n");
1137 pa_autoload_add(c
, a
, strstr(pa_tokenizer_get(t
, 0), "sink") ? PA_NAMEREG_SINK
: PA_NAMEREG_SOURCE
, b
, pa_tokenizer_get(t
, 3), NULL
);
1142 static int pa_cli_command_autoload_remove(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1145 pa_core_assert_ref(c
);
1150 pa_log_warn("Autoload will no longer be implemented by future versions of the PulseAudio server.");
1152 if (!(name
= pa_tokenizer_get(t
, 1))) {
1153 pa_strbuf_puts(buf
, "You need to specify a device name\n");
1157 if (pa_autoload_remove_by_name(c
, name
, strstr(pa_tokenizer_get(t
, 0), "sink") ? PA_NAMEREG_SINK
: PA_NAMEREG_SOURCE
) < 0) {
1158 pa_strbuf_puts(buf
, "Failed to remove autload entry\n");
1165 static int pa_cli_command_autoload_list(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1168 pa_core_assert_ref(c
);
1173 pa_log_warn("Autoload will no longer be implemented by future versions of the PulseAudio server.");
1175 pa_assert_se(s
= pa_autoload_list_to_string(c
));
1176 pa_strbuf_puts(buf
, s
);
1182 static int pa_cli_command_list_shared_props(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1183 pa_core_assert_ref(c
);
1188 pa_shared_dump(c
, buf
);
1192 static int pa_cli_command_vacuum(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1193 pa_core_assert_ref(c
);
1198 pa_mempool_vacuum(c
->mempool
);
1203 static int pa_cli_command_move_sink_input(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1209 pa_core_assert_ref(c
);
1214 if (!(n
= pa_tokenizer_get(t
, 1))) {
1215 pa_strbuf_puts(buf
, "You need to specify a sink input by its index.\n");
1219 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
1220 pa_strbuf_puts(buf
, "Failed to parse index.\n");
1224 if (!(k
= pa_tokenizer_get(t
, 2))) {
1225 pa_strbuf_puts(buf
, "You need to specify a sink.\n");
1229 if (!(si
= pa_idxset_get_by_index(c
->sink_inputs
, (uint32_t) idx
))) {
1230 pa_strbuf_puts(buf
, "No sink input found with this index.\n");
1234 if (!(sink
= pa_namereg_get(c
, k
, PA_NAMEREG_SINK
, 1))) {
1235 pa_strbuf_puts(buf
, "No sink found by this name or index.\n");
1239 if (pa_sink_input_move_to(si
, sink
) < 0) {
1240 pa_strbuf_puts(buf
, "Moved failed.\n");
1246 static int pa_cli_command_move_source_output(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1248 pa_source_output
*so
;
1252 pa_core_assert_ref(c
);
1257 if (!(n
= pa_tokenizer_get(t
, 1))) {
1258 pa_strbuf_puts(buf
, "You need to specify a source output by its index.\n");
1262 if ((idx
= parse_index(n
)) == PA_IDXSET_INVALID
) {
1263 pa_strbuf_puts(buf
, "Failed to parse index.\n");
1267 if (!(k
= pa_tokenizer_get(t
, 2))) {
1268 pa_strbuf_puts(buf
, "You need to specify a source.\n");
1272 if (!(so
= pa_idxset_get_by_index(c
->source_outputs
, (uint32_t) idx
))) {
1273 pa_strbuf_puts(buf
, "No source output found with this index.\n");
1277 if (!(source
= pa_namereg_get(c
, k
, PA_NAMEREG_SOURCE
, 1))) {
1278 pa_strbuf_puts(buf
, "No source found by this name or index.\n");
1282 if (pa_source_output_move_to(so
, source
) < 0) {
1283 pa_strbuf_puts(buf
, "Moved failed.\n");
1289 static int pa_cli_command_suspend_sink(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1294 pa_core_assert_ref(c
);
1299 if (!(n
= pa_tokenizer_get(t
, 1))) {
1300 pa_strbuf_puts(buf
, "You need to specify a sink either by its name or its index.\n");
1304 if (!(m
= pa_tokenizer_get(t
, 2))) {
1305 pa_strbuf_puts(buf
, "You need to specify a suspend switch setting (0/1).\n");
1309 if ((suspend
= pa_parse_boolean(m
)) < 0) {
1310 pa_strbuf_puts(buf
, "Failed to parse suspend switch.\n");
1314 if (!(sink
= pa_namereg_get(c
, n
, PA_NAMEREG_SINK
, 1))) {
1315 pa_strbuf_puts(buf
, "No sink found by this name or index.\n");
1319 pa_sink_suspend(sink
, suspend
);
1323 static int pa_cli_command_suspend_source(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1328 pa_core_assert_ref(c
);
1333 if (!(n
= pa_tokenizer_get(t
, 1))) {
1334 pa_strbuf_puts(buf
, "You need to specify a source either by its name or its index.\n");
1338 if (!(m
= pa_tokenizer_get(t
, 2))) {
1339 pa_strbuf_puts(buf
, "You need to specify a suspend switch setting (0/1).\n");
1343 if ((suspend
= pa_parse_boolean(m
)) < 0) {
1344 pa_strbuf_puts(buf
, "Failed to parse suspend switch.\n");
1348 if (!(source
= pa_namereg_get(c
, n
, PA_NAMEREG_SOURCE
, 1))) {
1349 pa_strbuf_puts(buf
, "No source found by this name or index.\n");
1353 pa_source_suspend(source
, suspend
);
1357 static int pa_cli_command_suspend(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1362 pa_core_assert_ref(c
);
1367 if (!(m
= pa_tokenizer_get(t
, 1))) {
1368 pa_strbuf_puts(buf
, "You need to specify a suspend switch setting (0/1).\n");
1372 if ((suspend
= pa_parse_boolean(m
)) < 0) {
1373 pa_strbuf_puts(buf
, "Failed to parse suspend switch.\n");
1377 ret
= - (pa_sink_suspend_all(c
, suspend
) < 0);
1378 if (pa_source_suspend_all(c
, suspend
) < 0)
1382 pa_strbuf_puts(buf
, "Failed to resume/suspend all sinks/sources.\n");
1387 static int pa_cli_command_log_level(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1391 pa_core_assert_ref(c
);
1396 if (!(m
= pa_tokenizer_get(t
, 1))) {
1397 pa_strbuf_puts(buf
, "You need to specify a log level (0..4).\n");
1401 if (pa_atou(m
, &level
) < 0 || level
>= PA_LOG_LEVEL_MAX
) {
1402 pa_strbuf_puts(buf
, "Failed to parse log level.\n");
1406 pa_log_set_maximal_level(level
);
1411 static int pa_cli_command_log_meta(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1415 pa_core_assert_ref(c
);
1420 if (!(m
= pa_tokenizer_get(t
, 1))) {
1421 pa_strbuf_puts(buf
, "You need to specify a boolean.\n");
1425 if ((b
= pa_parse_boolean(m
)) < 0) {
1426 pa_strbuf_puts(buf
, "Failed to parse log meta switch.\n");
1430 pa_log_set_show_meta(b
);
1435 static int pa_cli_command_log_time(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1439 pa_core_assert_ref(c
);
1444 if (!(m
= pa_tokenizer_get(t
, 1))) {
1445 pa_strbuf_puts(buf
, "You need to specify a boolean.\n");
1449 if ((b
= pa_parse_boolean(m
)) < 0) {
1450 pa_strbuf_puts(buf
, "Failed to parse log meta switch.\n");
1454 pa_log_set_show_time(b
);
1459 static int pa_cli_command_log_backtrace(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1463 pa_core_assert_ref(c
);
1468 if (!(m
= pa_tokenizer_get(t
, 1))) {
1469 pa_strbuf_puts(buf
, "You need to specify a backtrace level.\n");
1473 if (pa_atou(m
, &nframes
) < 0 || nframes
>= 1000) {
1474 pa_strbuf_puts(buf
, "Failed to parse backtrace level.\n");
1478 pa_log_set_show_backtrace(nframes
);
1483 static int pa_cli_command_dump(pa_core
*c
, pa_tokenizer
*t
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1493 pa_autoload_entry
*a
;
1495 pa_core_assert_ref(c
);
1503 pa_strbuf_printf(buf
, "### Configuration dump generated at %s\n", ctime_r(&now
, txt
));
1505 pa_strbuf_printf(buf
, "### Configuration dump generated at %s\n", ctime(&now
));
1508 for (m
= pa_idxset_first(c
->modules
, &idx
); m
; m
= pa_idxset_next(c
->modules
, &idx
)) {
1512 pa_strbuf_printf(buf
, "load-module %s", m
->name
);
1515 pa_strbuf_printf(buf
, " %s", m
->argument
);
1517 pa_strbuf_puts(buf
, "\n");
1522 for (sink
= pa_idxset_first(c
->sinks
, &idx
); sink
; sink
= pa_idxset_next(c
->sinks
, &idx
)) {
1523 if (sink
->module
&& sink
->module
->auto_unload
)
1527 pa_strbuf_puts(buf
, "\n");
1531 pa_strbuf_printf(buf
, "set-sink-volume %s 0x%03x\n", sink
->name
, pa_cvolume_avg(pa_sink_get_volume(sink
, FALSE
)));
1532 pa_strbuf_printf(buf
, "set-sink-mute %s %s\n", sink
->name
, pa_yes_no(pa_sink_get_mute(sink
, FALSE
)));
1533 pa_strbuf_printf(buf
, "suspend-sink %s %s\n", sink
->name
, pa_yes_no(pa_sink_get_state(sink
) == PA_SINK_SUSPENDED
));
1536 for (source
= pa_idxset_first(c
->sources
, &idx
); source
; source
= pa_idxset_next(c
->sources
, &idx
)) {
1537 if (source
->module
&& source
->module
->auto_unload
)
1541 pa_strbuf_puts(buf
, "\n");
1545 pa_strbuf_printf(buf
, "set-source-volume %s 0x%03x\n", source
->name
, pa_cvolume_avg(pa_source_get_volume(source
, FALSE
)));
1546 pa_strbuf_printf(buf
, "set-source-mute %s %s\n", source
->name
, pa_yes_no(pa_source_get_mute(source
, FALSE
)));
1547 pa_strbuf_printf(buf
, "suspend-source %s %s\n", source
->name
, pa_yes_no(pa_source_get_state(source
) == PA_SOURCE_SUSPENDED
));
1551 if (c
->autoload_hashmap
) {
1555 while ((a
= pa_hashmap_iterate(c
->autoload_hashmap
, &i
, NULL
))) {
1558 pa_strbuf_puts(buf
, "\n");
1562 pa_strbuf_printf(buf
, "add-autoload-%s %s %s", a
->type
== PA_NAMEREG_SINK
? "sink" : "source", a
->name
, a
->module
);
1565 pa_strbuf_printf(buf
, " %s", a
->argument
);
1567 pa_strbuf_puts(buf
, "\n");
1573 if ((p
= pa_namereg_get_default_sink_name(c
))) {
1575 pa_strbuf_puts(buf
, "\n");
1578 pa_strbuf_printf(buf
, "set-default-sink %s\n", p
);
1581 if ((p
= pa_namereg_get_default_source_name(c
))) {
1583 pa_strbuf_puts(buf
, "\n");
1586 pa_strbuf_printf(buf
, "set-default-source %s\n", p
);
1589 pa_strbuf_puts(buf
, "\n### EOF\n");
1594 int pa_cli_command_execute_line_stateful(pa_core
*c
, const char *s
, pa_strbuf
*buf
, pa_bool_t
*fail
, int *ifstate
) {
1601 cs
= s
+strspn(s
, whitespace
);
1603 if (*cs
== '#' || !*cs
)
1605 else if (*cs
== '.') {
1606 if (!strcmp(cs
, META_ELSE
)) {
1607 if (!ifstate
|| *ifstate
== IFSTATE_NONE
) {
1608 pa_strbuf_printf(buf
, "Meta command %s is not valid in this context\n", cs
);
1610 } else if (*ifstate
== IFSTATE_TRUE
)
1611 *ifstate
= IFSTATE_FALSE
;
1613 *ifstate
= IFSTATE_TRUE
;
1615 } else if (!strcmp(cs
, META_ENDIF
)) {
1616 if (!ifstate
|| *ifstate
== IFSTATE_NONE
) {
1617 pa_strbuf_printf(buf
, "Meta command %s is not valid in this context\n", cs
);
1620 *ifstate
= IFSTATE_NONE
;
1623 if (ifstate
&& *ifstate
== IFSTATE_FALSE
)
1625 if (!strcmp(cs
, META_FAIL
))
1627 else if (!strcmp(cs
, META_NOFAIL
))
1631 l
= strcspn(cs
, whitespace
);
1633 if (l
== sizeof(META_INCLUDE
)-1 && !strncmp(cs
, META_INCLUDE
, l
)) {
1634 const char *filename
= cs
+l
+strspn(cs
+l
, whitespace
);
1635 if (pa_cli_command_execute_file(c
, filename
, buf
, fail
) < 0)
1638 } else if (l
== sizeof(META_IFEXISTS
)-1 && !strncmp(cs
, META_IFEXISTS
, l
)) {
1640 pa_strbuf_printf(buf
, "Meta command %s is not valid in this context\n", cs
);
1642 } else if (*ifstate
!= IFSTATE_NONE
) {
1643 pa_strbuf_printf(buf
, "Nested %s commands not supported\n", cs
);
1646 const char *filename
= cs
+l
+strspn(cs
+l
, whitespace
);
1648 /* Search DL_SEARCH_PATH unless the filename is absolute */
1649 if (filename
[0] == PA_PATH_SEP_CHAR
) {
1651 *ifstate
= access(filename
, F_OK
) == 0 ? IFSTATE_TRUE
: IFSTATE_FALSE
;
1652 pa_log_debug("Checking for existance of '%s': %s", filename
, *ifstate
== IFSTATE_TRUE
? "success" : "failure");
1655 const char *paths
, *state
= NULL
;
1658 if (!(paths
= lt_dlgetsearchpath()))
1661 while ((p
= pa_split(paths
, ":", &state
))) {
1664 pathname
= pa_sprintf_malloc("%s" PA_PATH_SEP
"%s", p
, filename
);
1667 *ifstate
= access(pathname
, F_OK
) == 0 ? IFSTATE_TRUE
: IFSTATE_FALSE
;
1668 pa_log_debug("Checking for existance of '%s': %s", pathname
, *ifstate
== IFSTATE_TRUE
? "success" : "failure");
1672 if (*ifstate
== IFSTATE_TRUE
)
1679 pa_strbuf_printf(buf
, "Invalid meta command: %s\n", cs
);
1680 if (*fail
) return -1;
1684 const struct command
*command
;
1688 if (ifstate
&& *ifstate
== IFSTATE_FALSE
)
1691 l
= strcspn(cs
, whitespace
);
1693 for (command
= commands
; command
->name
; command
++)
1694 if (strlen(command
->name
) == l
&& !strncmp(cs
, command
->name
, l
)) {
1696 pa_tokenizer
*t
= pa_tokenizer_new(cs
, command
->args
);
1698 ret
= command
->proc(c
, t
, buf
, fail
);
1699 pa_tokenizer_free(t
);
1702 if (ret
< 0 && *fail
)
1709 pa_strbuf_printf(buf
, "Unknown command: %s\n", cs
);
1718 int pa_cli_command_execute_line(pa_core
*c
, const char *s
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1719 return pa_cli_command_execute_line_stateful(c
, s
, buf
, fail
, NULL
);
1722 int pa_cli_command_execute_file_stream(pa_core
*c
, FILE *f
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1724 int ifstate
= IFSTATE_NONE
;
1726 pa_bool_t _fail
= TRUE
;
1735 while (fgets(line
, sizeof(line
), f
)) {
1738 if (pa_cli_command_execute_line_stateful(c
, line
, buf
, fail
, &ifstate
) < 0 && *fail
)
1749 int pa_cli_command_execute_file(pa_core
*c
, const char *fn
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1752 pa_bool_t _fail
= TRUE
;
1761 if (!(f
= fopen(fn
, "r"))) {
1762 pa_strbuf_printf(buf
, "open('%s') failed: %s\n", fn
, pa_cstrerror(errno
));
1768 ret
= pa_cli_command_execute_file_stream(c
, f
, buf
, fail
);
1779 int pa_cli_command_execute(pa_core
*c
, const char *s
, pa_strbuf
*buf
, pa_bool_t
*fail
) {
1781 int ifstate
= IFSTATE_NONE
;
1782 pa_bool_t _fail
= TRUE
;
1793 size_t l
= strcspn(p
, linebreak
);
1794 char *line
= pa_xstrndup(p
, l
);
1796 if (pa_cli_command_execute_line_stateful(c
, line
, buf
, fail
, &ifstate
) < 0 && *fail
) {
1803 p
+= strspn(p
, linebreak
);