]> code.delx.au - pulseaudio/blob - polyp/polyplib-context.c
cf1a8e60c73ced97eab4d7b941bee8b4cce97b69
[pulseaudio] / polyp / polyplib-context.c
1 /* $Id$ */
2
3 /***
4 This file is part of polypaudio.
5
6 polypaudio is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published
8 by the Free Software Foundation; either version 2 of the License,
9 or (at your option) any later version.
10
11 polypaudio is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 General Public License for more details.
15
16 You should have received a copy of the GNU General Public License
17 along with polypaudio; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19 USA.
20 ***/
21
22 #ifdef HAVE_CONFIG_H
23 #include <config.h>
24 #endif
25
26 #include <stdio.h>
27 #include <assert.h>
28 #include <stdlib.h>
29 #include <string.h>
30 #include <sys/types.h>
31 #include <sys/socket.h>
32 #include <netdb.h>
33 #include <unistd.h>
34 #include <sys/stat.h>
35 #include <errno.h>
36 #include <sys/wait.h>
37
38 #include "polyplib-internal.h"
39 #include "polyplib-context.h"
40 #include "native-common.h"
41 #include "pdispatch.h"
42 #include "pstream.h"
43 #include "dynarray.h"
44 #include "socket-client.h"
45 #include "pstream-util.h"
46 #include "authkey.h"
47 #include "util.h"
48 #include "xmalloc.h"
49 #include "log.h"
50 #include "client-conf.h"
51 #include "socket-util.h"
52
53 #define DEFAULT_SERVER "/tmp/polypaudio/native"
54 #define AUTOSPAWN_LOCK "/tmp/polypaudio/autospawn.lock"
55
56 static const struct pa_pdispatch_command command_table[PA_COMMAND_MAX] = {
57 [PA_COMMAND_REQUEST] = { pa_command_request },
58 [PA_COMMAND_PLAYBACK_STREAM_KILLED] = { pa_command_stream_killed },
59 [PA_COMMAND_RECORD_STREAM_KILLED] = { pa_command_stream_killed },
60 [PA_COMMAND_SUBSCRIBE_EVENT] = { pa_command_subscribe_event },
61 };
62
63 struct pa_context *pa_context_new(struct pa_mainloop_api *mainloop, const char *name) {
64 struct pa_context *c;
65 assert(mainloop && name);
66
67 c = pa_xmalloc(sizeof(struct pa_context));
68 c->ref = 1;
69 c->name = pa_xstrdup(name);
70 c->mainloop = mainloop;
71 c->client = NULL;
72 c->pstream = NULL;
73 c->pdispatch = NULL;
74 c->playback_streams = pa_dynarray_new();
75 c->record_streams = pa_dynarray_new();
76 assert(c->playback_streams && c->record_streams);
77
78 PA_LLIST_HEAD_INIT(struct pa_stream, c->streams);
79 PA_LLIST_HEAD_INIT(struct pa_operation, c->operations);
80
81 c->error = PA_ERROR_OK;
82 c->state = PA_CONTEXT_UNCONNECTED;
83 c->ctag = 0;
84
85 c->state_callback = NULL;
86 c->state_userdata = NULL;
87
88 c->subscribe_callback = NULL;
89 c->subscribe_userdata = NULL;
90
91 c->memblock_stat = pa_memblock_stat_new();
92 c->local = -1;
93
94 pa_check_signal_is_blocked(SIGPIPE);
95
96 c->conf = pa_client_conf_new();
97 pa_client_conf_load(c->conf, NULL);
98 pa_client_conf_env(c->conf);
99
100 return c;
101 }
102
103 static void context_free(struct pa_context *c) {
104 assert(c);
105
106 while (c->operations)
107 pa_operation_cancel(c->operations);
108
109 while (c->streams)
110 pa_stream_set_state(c->streams, PA_STREAM_TERMINATED);
111
112 if (c->client)
113 pa_socket_client_unref(c->client);
114 if (c->pdispatch)
115 pa_pdispatch_unref(c->pdispatch);
116 if (c->pstream) {
117 pa_pstream_close(c->pstream);
118 pa_pstream_unref(c->pstream);
119 }
120
121 if (c->record_streams)
122 pa_dynarray_free(c->record_streams, NULL, NULL);
123 if (c->playback_streams)
124 pa_dynarray_free(c->playback_streams, NULL, NULL);
125
126 pa_memblock_stat_unref(c->memblock_stat);
127
128 if (c->conf)
129 pa_client_conf_free(c->conf);
130
131 pa_xfree(c->name);
132 pa_xfree(c);
133 }
134
135 struct pa_context* pa_context_ref(struct pa_context *c) {
136 assert(c && c->ref >= 1);
137 c->ref++;
138 return c;
139 }
140
141 void pa_context_unref(struct pa_context *c) {
142 assert(c && c->ref >= 1);
143
144 if ((--(c->ref)) == 0)
145 context_free(c);
146 }
147
148 void pa_context_set_state(struct pa_context *c, enum pa_context_state st) {
149 assert(c);
150
151 if (c->state == st)
152 return;
153
154 pa_context_ref(c);
155
156 if (st == PA_CONTEXT_FAILED || st == PA_CONTEXT_TERMINATED) {
157 struct pa_stream *s;
158
159 s = c->streams ? pa_stream_ref(c->streams) : NULL;
160 while (s) {
161 struct pa_stream *n = s->next ? pa_stream_ref(s->next) : NULL;
162 pa_stream_set_state(s, st == PA_CONTEXT_FAILED ? PA_STREAM_FAILED : PA_STREAM_TERMINATED);
163 pa_stream_unref(s);
164 s = n;
165 }
166
167 if (c->pdispatch)
168 pa_pdispatch_unref(c->pdispatch);
169 c->pdispatch = NULL;
170
171 if (c->pstream) {
172 pa_pstream_close(c->pstream);
173 pa_pstream_unref(c->pstream);
174 }
175 c->pstream = NULL;
176
177 if (c->client)
178 pa_socket_client_unref(c->client);
179 c->client = NULL;
180 }
181
182 c->state = st;
183 if (c->state_callback)
184 c->state_callback(c, c->state_userdata);
185
186 pa_context_unref(c);
187 }
188
189 void pa_context_fail(struct pa_context *c, int error) {
190 assert(c);
191 c->error = error;
192 pa_context_set_state(c, PA_CONTEXT_FAILED);
193 }
194
195 static void pstream_die_callback(struct pa_pstream *p, void *userdata) {
196 struct pa_context *c = userdata;
197 assert(p && c);
198 pa_context_fail(c, PA_ERROR_CONNECTIONTERMINATED);
199 }
200
201 static void pstream_packet_callback(struct pa_pstream *p, struct pa_packet *packet, void *userdata) {
202 struct pa_context *c = userdata;
203 assert(p && packet && c);
204
205 pa_context_ref(c);
206
207 if (pa_pdispatch_run(c->pdispatch, packet, c) < 0) {
208 pa_log(__FILE__": invalid packet.\n");
209 pa_context_fail(c, PA_ERROR_PROTOCOL);
210 }
211
212 pa_context_unref(c);
213 }
214
215 static void pstream_memblock_callback(struct pa_pstream *p, uint32_t channel, uint32_t delta, const struct pa_memchunk *chunk, void *userdata) {
216 struct pa_context *c = userdata;
217 struct pa_stream *s;
218 assert(p && chunk && c && chunk->memblock && chunk->memblock->data);
219
220 pa_context_ref(c);
221
222 if ((s = pa_dynarray_get(c->record_streams, channel))) {
223 if (s->read_callback) {
224 s->read_callback(s, (uint8_t*) chunk->memblock->data + chunk->index, chunk->length, s->read_userdata);
225 s->counter += chunk->length;
226 }
227 }
228
229 pa_context_unref(c);
230 }
231
232 int pa_context_handle_error(struct pa_context *c, uint32_t command, struct pa_tagstruct *t) {
233 assert(c);
234
235 if (command == PA_COMMAND_ERROR) {
236 assert(t);
237
238 if (pa_tagstruct_getu32(t, &c->error) < 0) {
239 pa_context_fail(c, PA_ERROR_PROTOCOL);
240 return -1;
241
242 }
243 } else if (command == PA_COMMAND_TIMEOUT)
244 c->error = PA_ERROR_TIMEOUT;
245 else {
246 pa_context_fail(c, PA_ERROR_PROTOCOL);
247 return -1;
248 }
249
250 return 0;
251 }
252
253 static void setup_complete_callback(struct pa_pdispatch *pd, uint32_t command, uint32_t tag, struct pa_tagstruct *t, void *userdata) {
254 struct pa_context *c = userdata;
255 assert(pd && c && (c->state == PA_CONTEXT_AUTHORIZING || c->state == PA_CONTEXT_SETTING_NAME));
256
257 pa_context_ref(c);
258
259 if (command != PA_COMMAND_REPLY) {
260
261 if (pa_context_handle_error(c, command, t) < 0)
262 pa_context_fail(c, PA_ERROR_PROTOCOL);
263
264 pa_context_fail(c, c->error);
265 goto finish;
266 }
267
268 switch(c->state) {
269 case PA_CONTEXT_AUTHORIZING: {
270 struct pa_tagstruct *t;
271 t = pa_tagstruct_new(NULL, 0);
272 assert(t);
273 pa_tagstruct_putu32(t, PA_COMMAND_SET_CLIENT_NAME);
274 pa_tagstruct_putu32(t, tag = c->ctag++);
275 pa_tagstruct_puts(t, c->name);
276 pa_pstream_send_tagstruct(c->pstream, t);
277 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, setup_complete_callback, c);
278
279 pa_context_set_state(c, PA_CONTEXT_SETTING_NAME);
280 break;
281 }
282
283 case PA_CONTEXT_SETTING_NAME :
284 pa_context_set_state(c, PA_CONTEXT_READY);
285 break;
286
287 default:
288 assert(0);
289 }
290
291 finish:
292 pa_context_unref(c);
293 }
294
295 static void setup_context(struct pa_context *c, struct pa_iochannel *io) {
296 struct pa_tagstruct *t;
297 uint32_t tag;
298 assert(c && io);
299
300 pa_context_ref(c);
301
302 assert(!c->pstream);
303 c->pstream = pa_pstream_new(c->mainloop, io, c->memblock_stat);
304 assert(c->pstream);
305
306 pa_pstream_set_die_callback(c->pstream, pstream_die_callback, c);
307 pa_pstream_set_recieve_packet_callback(c->pstream, pstream_packet_callback, c);
308 pa_pstream_set_recieve_memblock_callback(c->pstream, pstream_memblock_callback, c);
309
310 assert(!c->pdispatch);
311 c->pdispatch = pa_pdispatch_new(c->mainloop, command_table, PA_COMMAND_MAX);
312 assert(c->pdispatch);
313
314 if (pa_authkey_load_from_home(PA_NATIVE_COOKIE_FILE, c->auth_cookie, sizeof(c->auth_cookie)) < 0) {
315 pa_context_fail(c, PA_ERROR_AUTHKEY);
316 goto finish;
317 }
318
319 t = pa_tagstruct_new(NULL, 0);
320 assert(t);
321 pa_tagstruct_putu32(t, PA_COMMAND_AUTH);
322 pa_tagstruct_putu32(t, tag = c->ctag++);
323 pa_tagstruct_put_arbitrary(t, c->auth_cookie, sizeof(c->auth_cookie));
324 pa_pstream_send_tagstruct(c->pstream, t);
325 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, setup_complete_callback, c);
326
327 pa_context_set_state(c, PA_CONTEXT_AUTHORIZING);
328
329 finish:
330
331 pa_context_unref(c);
332 }
333
334 static void on_connection(struct pa_socket_client *client, struct pa_iochannel*io, void *userdata) {
335 struct pa_context *c = userdata;
336 assert(client && c && c->state == PA_CONTEXT_CONNECTING);
337
338 pa_context_ref(c);
339
340 pa_socket_client_unref(client);
341 c->client = NULL;
342
343 if (!io) {
344 pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
345 goto finish;
346 }
347
348 setup_context(c, io);
349
350 finish:
351 pa_context_unref(c);
352 }
353
354 static int default_server_is_running(void) {
355 struct stat st;
356
357 if (DEFAULT_SERVER[0] != '/')
358 return 1;
359
360 if (stat(DEFAULT_SERVER, &st) < 0)
361 return 0;
362
363 return 1;
364 }
365 static int context_connect_spawn(struct pa_context *c, const struct pa_spawn_api *api) {
366 pid_t pid;
367 int status, r;
368 int fds[2] = { -1, -1} ;
369 struct pa_iochannel *io;
370
371 pa_context_ref(c);
372
373 if (socketpair(AF_UNIX, SOCK_STREAM, 0, fds) < 0) {
374 pa_log(__FILE__": socketpair() failed: %s\n", strerror(errno));
375 pa_context_fail(c, PA_ERROR_INTERNAL);
376 goto fail;
377 }
378
379 if (api && api->prefork)
380 api->prefork();
381
382 if ((pid = fork()) < 0) {
383 pa_log(__FILE__": fork() failed: %s\n", strerror(errno));
384 pa_context_fail(c, PA_ERROR_INTERNAL);
385
386 if (api && api->postfork)
387 api->postfork();
388
389 goto fail;
390 } else if (!pid) {
391 /* Child */
392
393 char t[128];
394 const char *state = NULL;
395 #define MAX_ARGS 64
396 char *argv[MAX_ARGS+1];
397 int n;
398
399 close(fds[0]);
400
401 if (api && api->atfork)
402 api->atfork();
403
404 /* Setup argv */
405
406 n = 0;
407
408 argv[n++] = c->conf->daemon_binary;
409 argv[n++] = "--daemonize=yes";
410
411 snprintf(t, sizeof(t), "-Lmodule-native-protocol-fd fd=%i", fds[1]);
412 argv[n++] = strdup(t);
413
414 while (n < MAX_ARGS) {
415 char *a;
416
417 if (!(a = pa_split_spaces(c->conf->extra_arguments, &state)))
418 break;
419
420 argv[n++] = a;
421 }
422
423 argv[n++] = NULL;
424
425 execv(argv[0], argv);
426 _exit(1);
427 }
428
429 /* Parent */
430
431 r = waitpid(pid, &status, 0);
432
433 if (api && api->postfork)
434 api->postfork();
435
436 if (r < 0) {
437 pa_log(__FILE__": waitpid() failed: %s\n", strerror(errno));
438 pa_context_fail(c, PA_ERROR_INTERNAL);
439 goto fail;
440 } else if (!WIFEXITED(status) || WEXITSTATUS(status) != 0) {
441 pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
442 goto fail;
443 }
444
445 close(fds[1]);
446
447 c->local = 1;
448
449 io = pa_iochannel_new(c->mainloop, fds[0], fds[0]);
450 setup_context(c, io);
451
452 pa_context_unref(c);
453
454 return 0;
455
456 fail:
457 if (fds[0] != -1)
458 close(fds[0]);
459 if (fds[1] != -1)
460 close(fds[1]);
461
462 pa_context_unref(c);
463
464 return -1;
465 }
466
467 int pa_context_connect(struct pa_context *c, const char *server, int spawn, const struct pa_spawn_api *api) {
468 int r = -1;
469 assert(c && c->ref >= 1 && c->state == PA_CONTEXT_UNCONNECTED);
470
471 if (!server)
472 server = c->conf->default_server;
473
474 if (!server && spawn && c->conf->autospawn) {
475 int lock_fd = pa_lock_lockfile(AUTOSPAWN_LOCK);
476
477 if (!default_server_is_running()) {
478 int r = context_connect_spawn(c, api);
479
480 if (lock_fd >= 0)
481 pa_unlock_lockfile(lock_fd);
482 return r;
483 }
484
485 if (lock_fd >= 0)
486 pa_unlock_lockfile(lock_fd);
487 }
488
489 if (!server)
490 server = DEFAULT_SERVER;
491
492 pa_context_ref(c);
493
494 assert(!c->client);
495
496 if (*server == '/') {
497 if (!(c->client = pa_socket_client_new_unix(c->mainloop, server))) {
498 pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
499 goto finish;
500 }
501
502 c->local = 1;
503 } else {
504 struct sockaddr* sa;
505 size_t sa_len;
506
507 if (!(sa = pa_resolve_server(server, &sa_len, PA_NATIVE_DEFAULT_PORT))) {
508 pa_context_fail(c, PA_ERROR_INVALIDSERVER);
509 goto finish;
510 }
511
512 c->client = pa_socket_client_new_sockaddr(c->mainloop, sa, sa_len);
513 pa_xfree(sa);
514
515 if (!c->client) {
516 pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
517 goto finish;
518 }
519
520 c->local = 0;
521 }
522
523 pa_socket_client_set_callback(c->client, on_connection, c);
524 pa_context_set_state(c, PA_CONTEXT_CONNECTING);
525
526 r = 0;
527
528 finish:
529 pa_context_unref(c);
530
531 return r;
532 }
533
534 void pa_context_disconnect(struct pa_context *c) {
535 assert(c);
536 pa_context_set_state(c, PA_CONTEXT_TERMINATED);
537 }
538
539 enum pa_context_state pa_context_get_state(struct pa_context *c) {
540 assert(c && c->ref >= 1);
541 return c->state;
542 }
543
544 int pa_context_errno(struct pa_context *c) {
545 assert(c && c->ref >= 1);
546 return c->error;
547 }
548
549 void pa_context_set_state_callback(struct pa_context *c, void (*cb)(struct pa_context *c, void *userdata), void *userdata) {
550 assert(c && c->ref >= 1);
551 c->state_callback = cb;
552 c->state_userdata = userdata;
553 }
554
555 int pa_context_is_pending(struct pa_context *c) {
556 assert(c && c->ref >= 1);
557
558 /* pa_log("pstream: %i\n", pa_pstream_is_pending(c->pstream)); */
559 /* pa_log("pdispatch: %i\n", pa_pdispatch_is_pending(c->pdispatch)); */
560
561 return (c->pstream && pa_pstream_is_pending(c->pstream)) || (c->pdispatch && pa_pdispatch_is_pending(c->pdispatch)) || c->client;
562 }
563
564 static void set_dispatch_callbacks(struct pa_operation *o);
565
566 static void pdispatch_drain_callback(struct pa_pdispatch*pd, void *userdata) {
567 set_dispatch_callbacks(userdata);
568 }
569
570 static void pstream_drain_callback(struct pa_pstream *s, void *userdata) {
571 set_dispatch_callbacks(userdata);
572 }
573
574 static void set_dispatch_callbacks(struct pa_operation *o) {
575 int done = 1;
576 assert(o && o->context && o->context->ref >= 1 && o->ref >= 1 && o->context->state == PA_CONTEXT_READY);
577
578 pa_pstream_set_drain_callback(o->context->pstream, NULL, NULL);
579 pa_pdispatch_set_drain_callback(o->context->pdispatch, NULL, NULL);
580
581 if (pa_pdispatch_is_pending(o->context->pdispatch)) {
582 pa_pdispatch_set_drain_callback(o->context->pdispatch, pdispatch_drain_callback, o);
583 done = 0;
584 }
585
586 if (pa_pstream_is_pending(o->context->pstream)) {
587 pa_pstream_set_drain_callback(o->context->pstream, pstream_drain_callback, o);
588 done = 0;
589 }
590
591 if (!done)
592 pa_operation_ref(o);
593 else {
594 if (o->callback) {
595 void (*cb)(struct pa_context *c, void *userdata);
596 cb = (void (*)(struct pa_context*, void*)) o->callback;
597 cb(o->context, o->userdata);
598 }
599
600 pa_operation_done(o);
601 }
602
603 pa_operation_unref(o);
604 }
605
606 struct pa_operation* pa_context_drain(struct pa_context *c, void (*cb) (struct pa_context*c, void *userdata), void *userdata) {
607 struct pa_operation *o;
608 assert(c && c->ref >= 1);
609
610 if (c->state != PA_CONTEXT_READY)
611 return NULL;
612
613 if (!pa_context_is_pending(c))
614 return NULL;
615
616 o = pa_operation_new(c, NULL);
617 assert(o);
618 o->callback = cb;
619 o->userdata = userdata;
620
621 set_dispatch_callbacks(pa_operation_ref(o));
622
623 return o;
624 }
625
626 void pa_context_exit_daemon(struct pa_context *c) {
627 struct pa_tagstruct *t;
628 assert(c && c->ref >= 1);
629
630 t = pa_tagstruct_new(NULL, 0);
631 assert(t);
632 pa_tagstruct_putu32(t, PA_COMMAND_EXIT);
633 pa_tagstruct_putu32(t, c->ctag++);
634 pa_pstream_send_tagstruct(c->pstream, t);
635 }
636
637 void pa_context_simple_ack_callback(struct pa_pdispatch *pd, uint32_t command, uint32_t tag, struct pa_tagstruct *t, void *userdata) {
638 struct pa_operation *o = userdata;
639 int success = 1;
640 assert(pd && o && o->context && o->ref >= 1);
641
642 if (command != PA_COMMAND_REPLY) {
643 if (pa_context_handle_error(o->context, command, t) < 0)
644 goto finish;
645
646 success = 0;
647 } else if (!pa_tagstruct_eof(t)) {
648 pa_context_fail(o->context, PA_ERROR_PROTOCOL);
649 goto finish;
650 }
651
652 if (o->callback) {
653 void (*cb)(struct pa_context *c, int success, void *userdata) = o->callback;
654 cb(o->context, success, o->userdata);
655 }
656
657 finish:
658 pa_operation_done(o);
659 pa_operation_unref(o);
660 }
661
662 struct pa_operation* pa_context_send_simple_command(struct pa_context *c, uint32_t command, void (*internal_callback)(struct pa_pdispatch *pd, uint32_t command, uint32_t tag, struct pa_tagstruct *t, void *userdata), void (*cb)(), void *userdata) {
663 struct pa_tagstruct *t;
664 struct pa_operation *o;
665 uint32_t tag;
666 assert(c && cb);
667
668 o = pa_operation_new(c, NULL);
669 o->callback = cb;
670 o->userdata = userdata;
671
672 t = pa_tagstruct_new(NULL, 0);
673 pa_tagstruct_putu32(t, command);
674 pa_tagstruct_putu32(t, tag = c->ctag++);
675 pa_pstream_send_tagstruct(c->pstream, t);
676 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, internal_callback, o);
677
678 return pa_operation_ref(o);
679 }
680
681 struct pa_operation* pa_context_set_default_sink(struct pa_context *c, const char *name, void(*cb)(struct pa_context*c, int success, void *userdata), void *userdata) {
682 struct pa_tagstruct *t;
683 struct pa_operation *o;
684 uint32_t tag;
685 assert(c && cb);
686
687 o = pa_operation_new(c, NULL);
688 o->callback = cb;
689 o->userdata = userdata;
690
691 t = pa_tagstruct_new(NULL, 0);
692 pa_tagstruct_putu32(t, PA_COMMAND_SET_DEFAULT_SINK);
693 pa_tagstruct_putu32(t, tag = c->ctag++);
694 pa_tagstruct_puts(t, name);
695 pa_pstream_send_tagstruct(c->pstream, t);
696 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, o);
697
698 return pa_operation_ref(o);
699 }
700
701 struct pa_operation* pa_context_set_default_source(struct pa_context *c, const char *name, void(*cb)(struct pa_context*c, int success, void *userdata), void *userdata) {
702 struct pa_tagstruct *t;
703 struct pa_operation *o;
704 uint32_t tag;
705 assert(c && cb);
706
707 o = pa_operation_new(c, NULL);
708 o->callback = cb;
709 o->userdata = userdata;
710
711 t = pa_tagstruct_new(NULL, 0);
712 pa_tagstruct_putu32(t, PA_COMMAND_SET_DEFAULT_SOURCE);
713 pa_tagstruct_putu32(t, tag = c->ctag++);
714 pa_tagstruct_puts(t, name);
715 pa_pstream_send_tagstruct(c->pstream, t);
716 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, o);
717
718 return pa_operation_ref(o);
719 }
720
721 int pa_context_is_local(struct pa_context *c) {
722 assert(c);
723 return c->local;
724 }
725
726 struct pa_operation* pa_context_set_name(struct pa_context *c, const char *name, void(*cb)(struct pa_context*c, int success, void *userdata), void *userdata) {
727 struct pa_tagstruct *t;
728 struct pa_operation *o;
729 uint32_t tag;
730 assert(c && name && cb);
731
732 o = pa_operation_new(c, NULL);
733 o->callback = cb;
734 o->userdata = userdata;
735
736 t = pa_tagstruct_new(NULL, 0);
737 pa_tagstruct_putu32(t, PA_COMMAND_SET_CLIENT_NAME);
738 pa_tagstruct_putu32(t, tag = c->ctag++);
739 pa_tagstruct_puts(t, name);
740 pa_pstream_send_tagstruct(c->pstream, t);
741 pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, pa_context_simple_ack_callback, o);
742
743 return pa_operation_ref(o);
744 }
745
746 const char* pa_get_library_version(void) {
747 return PACKAGE_VERSION;
748 }
749