4 This file is part of PulseAudio.
6 Copyright 2004-2006 Lennart Poettering
7 Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
9 PulseAudio is free software; you can redistribute it and/or modify
10 it under the terms of the GNU Lesser General Public License as published
11 by the Free Software Foundation; either version 2 of the License,
12 or (at your option) any later version.
14 PulseAudio is distributed in the hope that it will be useful, but
15 WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 General Public License for more details.
19 You should have received a copy of the GNU Lesser General Public License
20 along with PulseAudio; if not, write to the Free Software
21 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
33 #include <sys/types.h>
40 #ifdef HAVE_SYS_WAIT_H
44 #ifdef HAVE_SYS_SOCKET_H
45 #include <sys/socket.h>
54 #include "../pulsecore/winsock.h"
56 #include <pulsecore/core-error.h>
57 #include <pulse/version.h>
58 #include <pulse/xmalloc.h>
60 #include <pulsecore/native-common.h>
61 #include <pulsecore/pdispatch.h>
62 #include <pulsecore/pstream.h>
63 #include <pulsecore/dynarray.h>
64 #include <pulsecore/socket-client.h>
65 #include <pulsecore/pstream-util.h>
66 #include <pulsecore/core-util.h>
67 #include <pulsecore/log.h>
68 #include <pulsecore/socket-util.h>
69 #include <pulsecore/creds.h>
73 #include "client-conf.h"
76 #include "client-conf-x11.h"
81 #define AUTOSPAWN_LOCK "autospawn.lock"
83 static const pa_pdispatch_cb_t command_table[PA_COMMAND_MAX] = {
84 [PA_COMMAND_REQUEST] = pa_command_request,
85 [PA_COMMAND_OVERFLOW] = pa_command_overflow_or_underflow,
86 [PA_COMMAND_UNDERFLOW] = pa_command_overflow_or_underflow,
87 [PA_COMMAND_PLAYBACK_STREAM_KILLED] = pa_command_stream_killed,
88 [PA_COMMAND_RECORD_STREAM_KILLED] = pa_command_stream_killed,
89 [PA_COMMAND_SUBSCRIBE_EVENT] = pa_command_subscribe_event
92 static void unlock_autospawn_lock_file(pa_context *c) {
95 if (c->autospawn_lock_fd >= 0) {
97 pa_runtime_path(AUTOSPAWN_LOCK, lf, sizeof(lf));
99 pa_unlock_lockfile(lf, c->autospawn_lock_fd);
100 c->autospawn_lock_fd = -1;
104 static void context_free(pa_context *c);
106 pa_context *pa_context_new(pa_mainloop_api *mainloop, const char *name) {
112 c = pa_xnew(pa_context, 1);
114 c->name = pa_xstrdup(name);
115 c->mainloop = mainloop;
119 c->playback_streams = pa_dynarray_new();
120 c->record_streams = pa_dynarray_new();
122 PA_LLIST_HEAD_INIT(pa_stream, c->streams);
123 PA_LLIST_HEAD_INIT(pa_operation, c->operations);
126 c->state = PA_CONTEXT_UNCONNECTED;
130 c->state_callback = NULL;
131 c->state_userdata = NULL;
133 c->subscribe_callback = NULL;
134 c->subscribe_userdata = NULL;
137 c->server_list = NULL;
139 c->autospawn_lock_fd = -1;
140 memset(&c->spawn_api, 0, sizeof(c->spawn_api));
145 pa_check_signal_is_blocked(SIGPIPE);
149 c->conf = pa_client_conf_new();
150 pa_client_conf_load(c->conf, NULL);
152 pa_client_conf_from_x11(c->conf, NULL);
154 pa_client_conf_env(c->conf);
156 if (!(c->mempool = pa_mempool_new(!c->conf->disable_shm))) {
158 if (!c->conf->disable_shm)
159 c->mempool = pa_mempool_new(0);
170 static void context_free(pa_context *c) {
173 unlock_autospawn_lock_file(c);
175 while (c->operations)
176 pa_operation_cancel(c->operations);
179 pa_stream_set_state(c->streams, PA_STREAM_TERMINATED);
182 pa_socket_client_unref(c->client);
184 pa_pdispatch_unref(c->pdispatch);
186 pa_pstream_close(c->pstream);
187 pa_pstream_unref(c->pstream);
190 if (c->record_streams)
191 pa_dynarray_free(c->record_streams, NULL, NULL);
192 if (c->playback_streams)
193 pa_dynarray_free(c->playback_streams, NULL, NULL);
196 pa_mempool_free(c->mempool);
199 pa_client_conf_free(c->conf);
201 pa_strlist_free(c->server_list);
208 pa_context* pa_context_ref(pa_context *c) {
216 void pa_context_unref(pa_context *c) {
224 void pa_context_set_state(pa_context *c, pa_context_state_t st) {
234 if (c->state_callback)
235 c->state_callback(c, c->state_userdata);
237 if (st == PA_CONTEXT_FAILED || st == PA_CONTEXT_TERMINATED) {
240 s = c->streams ? pa_stream_ref(c->streams) : NULL;
242 pa_stream *n = s->next ? pa_stream_ref(s->next) : NULL;
243 pa_stream_set_state(s, st == PA_CONTEXT_FAILED ? PA_STREAM_FAILED : PA_STREAM_TERMINATED);
249 pa_pdispatch_unref(c->pdispatch);
253 pa_pstream_close(c->pstream);
254 pa_pstream_unref(c->pstream);
259 pa_socket_client_unref(c->client);
266 void pa_context_fail(pa_context *c, int error) {
270 pa_context_set_error(c, error);
271 pa_context_set_state(c, PA_CONTEXT_FAILED);
274 int pa_context_set_error(pa_context *c, int error) {
276 assert(error < PA_ERR_MAX);
284 static void pstream_die_callback(pa_pstream *p, void *userdata) {
285 pa_context *c = userdata;
290 pa_context_fail(c, PA_ERR_CONNECTIONTERMINATED);
293 static void pstream_packet_callback(pa_pstream *p, pa_packet *packet, const pa_creds *creds, void *userdata) {
294 pa_context *c = userdata;
302 if (pa_pdispatch_run(c->pdispatch, packet, creds, c) < 0)
303 pa_context_fail(c, PA_ERR_PROTOCOL);
308 static void pstream_memblock_callback(pa_pstream *p, uint32_t channel, int64_t offset, pa_seek_mode_t seek, const pa_memchunk *chunk, void *userdata) {
309 pa_context *c = userdata;
314 assert(chunk->memblock);
315 assert(chunk->length);
321 if ((s = pa_dynarray_get(c->record_streams, channel))) {
323 assert(seek == PA_SEEK_RELATIVE && offset == 0);
325 pa_memblockq_seek(s->record_memblockq, offset, seek);
326 pa_memblockq_push_align(s->record_memblockq, chunk);
328 if (s->read_callback) {
331 if ((l = pa_memblockq_get_length(s->record_memblockq)) > 0)
332 s->read_callback(s, l, s->read_userdata);
339 int pa_context_handle_error(pa_context *c, uint32_t command, pa_tagstruct *t) {
343 if (command == PA_COMMAND_ERROR) {
346 if (pa_tagstruct_getu32(t, &c->error) < 0) {
347 pa_context_fail(c, PA_ERR_PROTOCOL);
351 } else if (command == PA_COMMAND_TIMEOUT)
352 c->error = PA_ERR_TIMEOUT;
354 pa_context_fail(c, PA_ERR_PROTOCOL);
361 static void setup_complete_callback(pa_pdispatch *pd, uint32_t command, uint32_t tag, pa_tagstruct *t, void *userdata) {
362 pa_context *c = userdata;
366 assert(c->state == PA_CONTEXT_AUTHORIZING || c->state == PA_CONTEXT_SETTING_NAME);
370 if (command != PA_COMMAND_REPLY) {
372 if (pa_context_handle_error(c, command, t) < 0)
373 pa_context_fail(c, PA_ERR_PROTOCOL);
375 pa_context_fail(c, c->error);
380 case PA_CONTEXT_AUTHORIZING: {
383 if (pa_tagstruct_getu32(t, &c->version) < 0 ||
384 !pa_tagstruct_eof(t)) {
385 pa_context_fail(c, PA_ERR_PROTOCOL);
389 /* Minimum supported version */
390 if (c->version < 8) {
391 pa_context_fail(c, PA_ERR_VERSION);
395 /* Enable shared memory support if possible */
396 if (c->version >= 10 &&
397 pa_mempool_is_shared(c->mempool) &&
400 /* Only enable SHM if both sides are owned by the same
401 * user. This is a security measure because otherwise
402 * data private to the user might leak. */
405 const pa_creds *creds;
406 if ((creds = pa_pdispatch_creds(pd)))
407 if (getuid() == creds->uid)
408 pa_pstream_use_shm(c->pstream, 1);
412 reply = pa_tagstruct_command(c, PA_COMMAND_SET_CLIENT_NAME, &tag);
413 pa_tagstruct_puts(reply, c->name);
414 pa_pstream_send_tagstruct(c->pstream, reply);
415 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, setup_complete_callback, c, NULL);
417 pa_context_set_state(c, PA_CONTEXT_SETTING_NAME);
421 case PA_CONTEXT_SETTING_NAME :
422 pa_context_set_state(c, PA_CONTEXT_READY);
433 static void setup_context(pa_context *c, pa_iochannel *io) {
443 c->pstream = pa_pstream_new(c->mainloop, io, c->mempool);
445 pa_pstream_set_die_callback(c->pstream, pstream_die_callback, c);
446 pa_pstream_set_recieve_packet_callback(c->pstream, pstream_packet_callback, c);
447 pa_pstream_set_recieve_memblock_callback(c->pstream, pstream_memblock_callback, c);
449 assert(!c->pdispatch);
450 c->pdispatch = pa_pdispatch_new(c->mainloop, command_table, PA_COMMAND_MAX);
452 if (!c->conf->cookie_valid)
453 pa_log_warn("No cookie loaded. Attempting to connect without.");
455 t = pa_tagstruct_command(c, PA_COMMAND_AUTH, &tag);
456 pa_tagstruct_putu32(t, PA_PROTOCOL_VERSION);
457 pa_tagstruct_put_arbitrary(t, c->conf->cookie, sizeof(c->conf->cookie));
463 if (pa_iochannel_creds_supported(io))
464 pa_iochannel_creds_enable(io);
466 ucred.uid = getuid();
467 ucred.gid = getgid();
469 pa_pstream_send_tagstruct_with_creds(c->pstream, t, &ucred);
472 pa_pstream_send_tagstruct(c->pstream, t);
475 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, setup_complete_callback, c, NULL);
477 pa_context_set_state(c, PA_CONTEXT_AUTHORIZING);
482 static void on_connection(pa_socket_client *client, pa_iochannel*io, void *userdata);
486 static int context_connect_spawn(pa_context *c) {
489 int fds[2] = { -1, -1} ;
494 if (socketpair(AF_UNIX, SOCK_STREAM, 0, fds) < 0) {
495 pa_log("socketpair(): %s", pa_cstrerror(errno));
496 pa_context_fail(c, PA_ERR_INTERNAL);
500 pa_fd_set_cloexec(fds[0], 1);
502 pa_socket_low_delay(fds[0]);
503 pa_socket_low_delay(fds[1]);
505 if (c->spawn_api.prefork)
506 c->spawn_api.prefork();
508 if ((pid = fork()) < 0) {
509 pa_log("fork(): %s", pa_cstrerror(errno));
510 pa_context_fail(c, PA_ERR_INTERNAL);
512 if (c->spawn_api.postfork)
513 c->spawn_api.postfork();
520 const char *state = NULL;
522 const char * argv[MAX_ARGS+1];
525 /* Not required, since fds[0] has CLOEXEC enabled anyway */
528 if (c->spawn_api.atfork)
529 c->spawn_api.atfork();
535 argv[n++] = c->conf->daemon_binary;
536 argv[n++] = "--daemonize=yes";
538 snprintf(t, sizeof(t), "-Lmodule-native-protocol-fd fd=%i", fds[1]);
539 argv[n++] = strdup(t);
541 while (n < MAX_ARGS) {
544 if (!(a = pa_split_spaces(c->conf->extra_arguments, &state)))
552 execv(argv[0], (char * const *) argv);
559 r = waitpid(pid, &status, 0);
561 if (c->spawn_api.postfork)
562 c->spawn_api.postfork();
565 pa_log("waitpid(): %s", pa_cstrerror(errno));
566 pa_context_fail(c, PA_ERR_INTERNAL);
568 } else if (!WIFEXITED(status) || WEXITSTATUS(status) != 0) {
569 pa_context_fail(c, PA_ERR_CONNECTIONREFUSED);
577 io = pa_iochannel_new(c->mainloop, fds[0], fds[0]);
579 setup_context(c, io);
580 unlock_autospawn_lock_file(c);
592 unlock_autospawn_lock_file(c);
599 #endif /* OS_IS_WIN32 */
601 static int try_next_connection(pa_context *c) {
612 c->server_list = pa_strlist_pop(c->server_list, &u);
617 if (c->do_autospawn) {
618 r = context_connect_spawn(c);
623 pa_context_fail(c, PA_ERR_CONNECTIONREFUSED);
627 pa_log_debug("Trying to connect to %s...", u);
630 c->server = pa_xstrdup(u);
632 if (!(c->client = pa_socket_client_new_string(c->mainloop, u, PA_NATIVE_DEFAULT_PORT)))
635 c->is_local = pa_socket_client_is_local(c->client);
636 pa_socket_client_set_callback(c->client, on_connection, c);
648 static void on_connection(pa_socket_client *client, pa_iochannel*io, void *userdata) {
649 pa_context *c = userdata;
653 assert(c->state == PA_CONTEXT_CONNECTING);
657 pa_socket_client_unref(client);
661 /* Try the item in the list */
662 if (errno == ECONNREFUSED || errno == ETIMEDOUT || errno == EHOSTUNREACH) {
663 try_next_connection(c);
667 pa_context_fail(c, PA_ERR_CONNECTIONREFUSED);
671 unlock_autospawn_lock_file(c);
672 setup_context(c, io);
678 int pa_context_connect(
681 pa_context_flags_t flags,
682 const pa_spawn_api *api) {
689 PA_CHECK_VALIDITY(c, c->state == PA_CONTEXT_UNCONNECTED, PA_ERR_BADSTATE);
690 PA_CHECK_VALIDITY(c, !(flags & ~PA_CONTEXT_NOAUTOSPAWN), PA_ERR_INVALID);
691 PA_CHECK_VALIDITY(c, !server || *server, PA_ERR_INVALID);
694 server = c->conf->default_server;
698 assert(!c->server_list);
701 if (!(c->server_list = pa_strlist_parse(server))) {
702 pa_context_fail(c, PA_ERR_INVALIDSERVER);
709 /* Prepend in reverse order */
711 if ((d = getenv("DISPLAY"))) {
714 if ((e = strchr(d, ':')))
718 c->server_list = pa_strlist_prepend(c->server_list, d);
723 c->server_list = pa_strlist_prepend(c->server_list, "tcp6:localhost");
724 c->server_list = pa_strlist_prepend(c->server_list, "tcp4:localhost");
726 /* The system wide instance */
727 c->server_list = pa_strlist_prepend(c->server_list, PA_SYSTEM_RUNTIME_PATH "/" PA_NATIVE_DEFAULT_UNIX_SOCKET);
729 /* The per-user instance */
730 c->server_list = pa_strlist_prepend(c->server_list, pa_runtime_path(PA_NATIVE_DEFAULT_UNIX_SOCKET, ufn, sizeof(ufn)));
732 /* Wrap the connection attempts in a single transaction for sane autospawn locking */
733 if (!(flags & PA_CONTEXT_NOAUTOSPAWN) && c->conf->autospawn) {
736 pa_runtime_path(AUTOSPAWN_LOCK, lf, sizeof(lf));
737 pa_make_secure_parent_dir(lf, 0700, (uid_t)-1, (gid_t)-1);
738 assert(c->autospawn_lock_fd <= 0);
739 c->autospawn_lock_fd = pa_lock_lockfile(lf);
748 pa_context_set_state(c, PA_CONTEXT_CONNECTING);
749 r = try_next_connection(c);
757 void pa_context_disconnect(pa_context *c) {
761 pa_context_set_state(c, PA_CONTEXT_TERMINATED);
764 pa_context_state_t pa_context_get_state(pa_context *c) {
771 int pa_context_errno(pa_context *c) {
778 void pa_context_set_state_callback(pa_context *c, pa_context_notify_cb_t cb, void *userdata) {
782 c->state_callback = cb;
783 c->state_userdata = userdata;
786 int pa_context_is_pending(pa_context *c) {
791 c->state == PA_CONTEXT_CONNECTING ||
792 c->state == PA_CONTEXT_AUTHORIZING ||
793 c->state == PA_CONTEXT_SETTING_NAME ||
794 c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE);
796 return (c->pstream && pa_pstream_is_pending(c->pstream)) ||
797 (c->pdispatch && pa_pdispatch_is_pending(c->pdispatch)) ||
801 static void set_dispatch_callbacks(pa_operation *o);
803 static void pdispatch_drain_callback(PA_GCC_UNUSED pa_pdispatch*pd, void *userdata) {
804 set_dispatch_callbacks(userdata);
807 static void pstream_drain_callback(PA_GCC_UNUSED pa_pstream *s, void *userdata) {
808 set_dispatch_callbacks(userdata);
811 static void set_dispatch_callbacks(pa_operation *o) {
817 assert(o->context->ref >= 1);
818 assert(o->context->state == PA_CONTEXT_READY);
820 pa_pstream_set_drain_callback(o->context->pstream, NULL, NULL);
821 pa_pdispatch_set_drain_callback(o->context->pdispatch, NULL, NULL);
823 if (pa_pdispatch_is_pending(o->context->pdispatch)) {
824 pa_pdispatch_set_drain_callback(o->context->pdispatch, pdispatch_drain_callback, o);
828 if (pa_pstream_is_pending(o->context->pstream)) {
829 pa_pstream_set_drain_callback(o->context->pstream, pstream_drain_callback, o);
835 pa_context_notify_cb_t cb = (pa_context_notify_cb_t) o->callback;
836 cb(o->context, o->userdata);
839 pa_operation_done(o);
840 pa_operation_unref(o);
844 pa_operation* pa_context_drain(pa_context *c, pa_context_notify_cb_t cb, void *userdata) {
850 PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE);
851 PA_CHECK_VALIDITY_RETURN_NULL(c, pa_context_is_pending(c), PA_ERR_BADSTATE);
853 o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata);
854 set_dispatch_callbacks(pa_operation_ref(o));
859 void pa_context_simple_ack_callback(pa_pdispatch *pd, uint32_t command, PA_GCC_UNUSED uint32_t tag, pa_tagstruct *t, void *userdata) {
860 pa_operation *o = userdata;
870 if (command != PA_COMMAND_REPLY) {
871 if (pa_context_handle_error(o->context, command, t) < 0)
875 } else if (!pa_tagstruct_eof(t)) {
876 pa_context_fail(o->context, PA_ERR_PROTOCOL);
881 pa_context_success_cb_t cb = (pa_context_success_cb_t) o->callback;
882 cb(o->context, success, o->userdata);
886 pa_operation_done(o);
887 pa_operation_unref(o);
890 pa_operation* pa_context_exit_daemon(pa_context *c, pa_context_success_cb_t cb, void *userdata) {
898 PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE);
900 o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata);
902 t = pa_tagstruct_command(c, PA_COMMAND_EXIT, &tag);
903 pa_pstream_send_tagstruct(c->pstream, t);
904 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref);
909 pa_operation* pa_context_send_simple_command(pa_context *c, uint32_t command, pa_pdispatch_cb_t internal_cb, pa_operation_cb_t cb, void *userdata) {
917 PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE);
919 o = pa_operation_new(c, NULL, cb, userdata);
921 t = pa_tagstruct_command(c, command, &tag);
922 pa_pstream_send_tagstruct(c->pstream, t);
923 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, internal_cb, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref);
928 pa_operation* pa_context_set_default_sink(pa_context *c, const char *name, pa_context_success_cb_t cb, void *userdata) {
936 PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE);
938 o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata);
940 t = pa_tagstruct_command(c, PA_COMMAND_SET_DEFAULT_SINK, &tag);
941 pa_tagstruct_puts(t, name);
942 pa_pstream_send_tagstruct(c->pstream, t);
943 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref);
948 pa_operation* pa_context_set_default_source(pa_context *c, const char *name, pa_context_success_cb_t cb, void *userdata) {
956 PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE);
958 o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata);
960 t = pa_tagstruct_command(c, PA_COMMAND_SET_DEFAULT_SOURCE, &tag);
961 pa_tagstruct_puts(t, name);
962 pa_pstream_send_tagstruct(c->pstream, t);
963 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref);
968 int pa_context_is_local(pa_context *c) {
974 pa_operation* pa_context_set_name(pa_context *c, const char *name, pa_context_success_cb_t cb, void *userdata) {
983 PA_CHECK_VALIDITY_RETURN_NULL(c, c->state == PA_CONTEXT_READY, PA_ERR_BADSTATE);
985 o = pa_operation_new(c, NULL, (pa_operation_cb_t) cb, userdata);
987 t = pa_tagstruct_command(c, PA_COMMAND_SET_CLIENT_NAME, &tag);
988 pa_tagstruct_puts(t, name);
989 pa_pstream_send_tagstruct(c->pstream, t);
990 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, pa_operation_ref(o), (pa_free_cb_t) pa_operation_unref);
995 const char* pa_get_library_version(void) {
996 return PACKAGE_VERSION;
999 const char* pa_context_get_server(pa_context *c) {
1001 assert(c->ref >= 1);
1006 if (*c->server == '{') {
1007 char *e = strchr(c->server+1, '}');
1008 return e ? e+1 : c->server;
1014 uint32_t pa_context_get_protocol_version(PA_GCC_UNUSED pa_context *c) {
1015 return PA_PROTOCOL_VERSION;
1018 uint32_t pa_context_get_server_protocol_version(pa_context *c) {
1020 assert(c->ref >= 1);
1025 pa_tagstruct *pa_tagstruct_command(pa_context *c, uint32_t command, uint32_t *tag) {
1031 t = pa_tagstruct_new(NULL, 0);
1032 pa_tagstruct_putu32(t, command);
1033 pa_tagstruct_putu32(t, *tag = c->ctag++);