code.delx.au - pulseaudio/blob - 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 && t);
 234
 235     if (command == PA_COMMAND_ERROR) {
 236         if (pa_tagstruct_getu32(t, &c->error) < 0) {
 237             pa_context_fail(c, PA_ERROR_PROTOCOL);
 238             return -1;
 239
 240         }
 241     } else if (command == PA_COMMAND_TIMEOUT)
 242         c->error = PA_ERROR_TIMEOUT;
 243     else {
 244         pa_context_fail(c, PA_ERROR_PROTOCOL);
 245         return -1;
 246     }
 247
 248     return 0;
 249 }
 250
 251 static void setup_complete_callback(struct pa_pdispatch *pd, uint32_t command, uint32_t tag, struct pa_tagstruct *t, void *userdata) {
 252     struct pa_context *c = userdata;
 253     assert(pd && c && (c->state == PA_CONTEXT_AUTHORIZING || c->state == PA_CONTEXT_SETTING_NAME));
 254
 255     pa_context_ref(c);
 256
 257     if (command != PA_COMMAND_REPLY) {
 258
 259         if (pa_context_handle_error(c, command, t) < 0)
 260             pa_context_fail(c, PA_ERROR_PROTOCOL);
 261
 262         pa_context_fail(c, c->error);
 263         goto finish;
 264     }
 265
 266     switch(c->state) {
 267         case PA_CONTEXT_AUTHORIZING: {
 268             struct pa_tagstruct *t;
 269             t = pa_tagstruct_new(NULL, 0);
 270             assert(t);
 271             pa_tagstruct_putu32(t, PA_COMMAND_SET_CLIENT_NAME);
 272             pa_tagstruct_putu32(t, tag = c->ctag++);
 273             pa_tagstruct_puts(t, c->name);
 274             pa_pstream_send_tagstruct(c->pstream, t);
 275             pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, setup_complete_callback, c);
 276
 277             pa_context_set_state(c, PA_CONTEXT_SETTING_NAME);
 278             break;
 279         }
 280
 281         case PA_CONTEXT_SETTING_NAME :
 282             pa_context_set_state(c, PA_CONTEXT_READY);
 283             break;
 284
 285         default:
 286             assert(0);
 287     }
 288
 289 finish:
 290     pa_context_unref(c);
 291 }
 292
 293 static void setup_context(struct pa_context *c, struct pa_iochannel *io) {
 294     struct pa_tagstruct *t;
 295     uint32_t tag;
 296     assert(c && io);
 297
 298     pa_context_ref(c);
 299
 300     assert(!c->pstream);
 301     c->pstream = pa_pstream_new(c->mainloop, io, c->memblock_stat);
 302     assert(c->pstream);
 303
 304     pa_pstream_set_die_callback(c->pstream, pstream_die_callback, c);
 305     pa_pstream_set_recieve_packet_callback(c->pstream, pstream_packet_callback, c);
 306     pa_pstream_set_recieve_memblock_callback(c->pstream, pstream_memblock_callback, c);
 307
 308     assert(!c->pdispatch);
 309     c->pdispatch = pa_pdispatch_new(c->mainloop, command_table, PA_COMMAND_MAX);
 310     assert(c->pdispatch);
 311
 312     if (pa_authkey_load_from_home(PA_NATIVE_COOKIE_FILE, c->auth_cookie, sizeof(c->auth_cookie)) < 0) {
 313         pa_context_fail(c, PA_ERROR_AUTHKEY);
 314         goto finish;
 315     }
 316
 317     t = pa_tagstruct_new(NULL, 0);
 318     assert(t);
 319     pa_tagstruct_putu32(t, PA_COMMAND_AUTH);
 320     pa_tagstruct_putu32(t, tag = c->ctag++);
 321     pa_tagstruct_put_arbitrary(t, c->auth_cookie, sizeof(c->auth_cookie));
 322     pa_pstream_send_tagstruct(c->pstream, t);
 323     pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, setup_complete_callback, c);
 324
 325     pa_context_set_state(c, PA_CONTEXT_AUTHORIZING);
 326
 327 finish:
 328
 329     pa_context_unref(c);
 330 }
 331
 332 static void on_connection(struct pa_socket_client *client, struct pa_iochannel*io, void *userdata) {
 333     struct pa_context *c = userdata;
 334     assert(client && c && c->state == PA_CONTEXT_CONNECTING);
 335
 336     pa_context_ref(c);
 337
 338     pa_socket_client_unref(client);
 339     c->client = NULL;
 340
 341     if (!io) {
 342         pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
 343         goto finish;
 344     }
 345
 346     setup_context(c, io);
 347
 348 finish:
 349     pa_context_unref(c);
 350 }
 351
 352 static int default_server_is_running(void) {
 353     struct stat st;
 354
 355     if (DEFAULT_SERVER[0] != '/')
 356         return 1;
 357
 358     if (stat(DEFAULT_SERVER, &st) < 0)
 359         return 0;
 360
 361     return 1;
 362 }
 363 static int context_connect_spawn(struct pa_context *c, const struct pa_spawn_api *api) {
 364     pid_t pid;
 365     int status, r;
 366     int fds[2] = { -1, -1} ;
 367     struct pa_iochannel *io;
 368
 369     pa_context_ref(c);
 370
 371     if (socketpair(AF_UNIX, SOCK_STREAM, 0, fds) < 0) {
 372         pa_log(__FILE__": socketpair() failed: %s\n", strerror(errno));
 373         pa_context_fail(c, PA_ERROR_INTERNAL);
 374         goto fail;
 375     }
 376
 377     if (api && api->prefork)
 378         api->prefork();
 379
 380     if ((pid = fork()) < 0) {
 381         pa_log(__FILE__": fork() failed: %s\n", strerror(errno));
 382         pa_context_fail(c, PA_ERROR_INTERNAL);
 383
 384         if (api && api->postfork)
 385             api->postfork();
 386
 387         goto fail;
 388     } else if (!pid) {
 389         /* Child */
 390
 391         char t[128];
 392         const char *state = NULL;
 393 #define MAX_ARGS 64
 394         char *argv[MAX_ARGS+1];
 395         int n;
 396
 397         close(fds[0]);
 398
 399         if (api && api->atfork)
 400             api->atfork();
 401
 402         /* Setup argv */
 403
 404         n = 0;
 405
 406         argv[n++] = c->conf->daemon_binary;
 407         argv[n++] = "--daemonize=yes";
 408
 409         snprintf(t, sizeof(t), "-Lmodule-native-protocol-fd fd=%i", fds[1]);
 410         argv[n++] = strdup(t);
 411
 412         while (n < MAX_ARGS) {
 413             char *a;
 414
 415             if (!(a = pa_split_spaces(c->conf->extra_arguments, &state)))
 416                 break;
 417
 418             argv[n++] = a;
 419         }
 420
 421         argv[n++] = NULL;
 422
 423         execv(argv[0], argv);
 424         _exit(1);
 425     }
 426
 427     /* Parent */
 428
 429     r = waitpid(pid, &status, 0);
 430
 431     if (api && api->postfork)
 432         api->postfork();
 433
 434     if (r < 0) {
 435         pa_log(__FILE__": waitpid() failed: %s\n", strerror(errno));
 436         pa_context_fail(c, PA_ERROR_INTERNAL);
 437         goto fail;
 438     } else if (!WIFEXITED(status) || WEXITSTATUS(status) != 0) {
 439         pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
 440         goto fail;
 441     }
 442
 443     close(fds[1]);
 444
 445     c->local = 1;
 446
 447     io = pa_iochannel_new(c->mainloop, fds[0], fds[0]);
 448     setup_context(c, io);
 449
 450     pa_context_unref(c);
 451
 452     return 0;
 453
 454 fail:
 455     if (fds[0] != -1)
 456         close(fds[0]);
 457     if (fds[1] != -1)
 458         close(fds[1]);
 459
 460     pa_context_unref(c);
 461
 462     return -1;
 463 }
 464
 465 int pa_context_connect(struct pa_context *c, const char *server, int spawn, const struct pa_spawn_api *api) {
 466     int r = -1;
 467     assert(c && c->ref >= 1 && c->state == PA_CONTEXT_UNCONNECTED);
 468
 469     if (!server)
 470         server = c->conf->default_server;
 471
 472     if (!server && spawn && c->conf->autospawn) {
 473         int lock_fd = pa_lock_lockfile(AUTOSPAWN_LOCK);
 474
 475         if (!default_server_is_running()) {
 476             int r = context_connect_spawn(c, api);
 477
 478             if (lock_fd >= 0)
 479                 pa_unlock_lockfile(lock_fd);
 480             return r;
 481         }
 482
 483         if (lock_fd >= 0)
 484             pa_unlock_lockfile(lock_fd);
 485     }
 486
 487     if (!server)
 488         server = DEFAULT_SERVER;
 489
 490     pa_context_ref(c);
 491
 492     assert(!c->client);
 493
 494     if (*server == '/') {
 495         if (!(c->client = pa_socket_client_new_unix(c->mainloop, server))) {
 496             pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
 497             goto finish;
 498         }
 499
 500         c->local = 1;
 501     } else {
 502         struct sockaddr* sa;
 503         size_t sa_len;
 504
 505         if (!(sa = pa_resolve_server(server, &sa_len, PA_NATIVE_DEFAULT_PORT))) {
 506             pa_context_fail(c, PA_ERROR_INVALIDSERVER);
 507             goto finish;
 508         }
 509
 510         c->client = pa_socket_client_new_sockaddr(c->mainloop, sa, sa_len);
 511         pa_xfree(sa);
 512
 513         if (!c->client) {
 514             pa_context_fail(c, PA_ERROR_CONNECTIONREFUSED);
 515             goto finish;
 516         }
 517
 518         c->local = 0;
 519     }
 520
 521     pa_socket_client_set_callback(c->client, on_connection, c);
 522     pa_context_set_state(c, PA_CONTEXT_CONNECTING);
 523
 524     r = 0;
 525
 526 finish:
 527     pa_context_unref(c);
 528
 529     return r;
 530 }
 531
 532 void pa_context_disconnect(struct pa_context *c) {
 533     assert(c);
 534     pa_context_set_state(c, PA_CONTEXT_TERMINATED);
 535 }
 536
 537 enum pa_context_state pa_context_get_state(struct pa_context *c) {
 538     assert(c && c->ref >= 1);
 539     return c->state;
 540 }
 541
 542 int pa_context_errno(struct pa_context *c) {
 543     assert(c && c->ref >= 1);
 544     return c->error;
 545 }
 546
 547 void pa_context_set_state_callback(struct pa_context *c, void (*cb)(struct pa_context *c, void *userdata), void *userdata) {
 548     assert(c && c->ref >= 1);
 549     c->state_callback = cb;
 550     c->state_userdata = userdata;
 551 }
 552
 553 int pa_context_is_pending(struct pa_context *c) {
 554     assert(c && c->ref >= 1);
 555
 556 /*     pa_log("pstream: %i\n", pa_pstream_is_pending(c->pstream)); */
 557 /*     pa_log("pdispatch: %i\n", pa_pdispatch_is_pending(c->pdispatch)); */
 558
 559     return (c->pstream && pa_pstream_is_pending(c->pstream)) || (c->pdispatch && pa_pdispatch_is_pending(c->pdispatch)) || c->client;
 560 }
 561
 562 static void set_dispatch_callbacks(struct pa_operation *o);
 563
 564 static void pdispatch_drain_callback(struct pa_pdispatch*pd, void *userdata) {
 565     set_dispatch_callbacks(userdata);
 566 }
 567
 568 static void pstream_drain_callback(struct pa_pstream *s, void *userdata) {
 569     set_dispatch_callbacks(userdata);
 570 }
 571
 572 static void set_dispatch_callbacks(struct pa_operation *o) {
 573     int done = 1;
 574     assert(o && o->context && o->context->ref >= 1 && o->ref >= 1 && o->context->state == PA_CONTEXT_READY);
 575
 576     pa_pstream_set_drain_callback(o->context->pstream, NULL, NULL);
 577     pa_pdispatch_set_drain_callback(o->context->pdispatch, NULL, NULL);
 578
 579     if (pa_pdispatch_is_pending(o->context->pdispatch)) {
 580         pa_pdispatch_set_drain_callback(o->context->pdispatch, pdispatch_drain_callback, o);
 581         done = 0;
 582     }
 583
 584     if (pa_pstream_is_pending(o->context->pstream)) {
 585         pa_pstream_set_drain_callback(o->context->pstream, pstream_drain_callback, o);
 586         done = 0;
 587     }
 588
 589     if (!done)
 590         pa_operation_ref(o);
 591     else {
 592         if (o->callback) {
 593             void (*cb)(struct pa_context *c, void *userdata);
 594             cb = (void (*)(struct pa_context*, void*)) o->callback;
 595             cb(o->context, o->userdata);
 596         }
 597
 598         pa_operation_done(o);
 599     }
 600
 601     pa_operation_unref(o);
 602 }
 603
 604 struct pa_operation* pa_context_drain(struct pa_context *c, void (*cb) (struct pa_context*c, void *userdata), void *userdata) {
 605     struct pa_operation *o;
 606     assert(c && c->ref >= 1);
 607
 608     if (c->state != PA_CONTEXT_READY)
 609         return NULL;
 610
 611     if (!pa_context_is_pending(c))
 612         return NULL;
 613
 614     o = pa_operation_new(c, NULL);
 615     assert(o);
 616     o->callback = cb;
 617     o->userdata = userdata;
 618
 619     set_dispatch_callbacks(pa_operation_ref(o));
 620
 621     return o;
 622 }
 623
 624 void pa_context_exit_daemon(struct pa_context *c) {
 625     struct pa_tagstruct *t;
 626     assert(c && c->ref >= 1);
 627
 628     t = pa_tagstruct_new(NULL, 0);
 629     assert(t);
 630     pa_tagstruct_putu32(t, PA_COMMAND_EXIT);
 631     pa_tagstruct_putu32(t, c->ctag++);
 632     pa_pstream_send_tagstruct(c->pstream, t);
 633 }
 634
 635 void pa_context_simple_ack_callback(struct pa_pdispatch *pd, uint32_t command, uint32_t tag, struct pa_tagstruct *t, void *userdata) {
 636     struct pa_operation *o = userdata;
 637     int success = 1;
 638     assert(pd && o && o->context && o->ref >= 1);
 639
 640     if (command != PA_COMMAND_REPLY) {
 641         if (pa_context_handle_error(o->context, command, t) < 0)
 642             goto finish;
 643
 644         success = 0;
 645     } else if (!pa_tagstruct_eof(t)) {
 646         pa_context_fail(o->context, PA_ERROR_PROTOCOL);
 647         goto finish;
 648     }
 649
 650     if (o->callback) {
 651         void (*cb)(struct pa_context *c, int success, void *userdata) = o->callback;
 652         cb(o->context, success, o->userdata);
 653     }
 654
 655 finish:
 656     pa_operation_done(o);
 657     pa_operation_unref(o);
 658 }
 659
 660 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) {
 661     struct pa_tagstruct *t;
 662     struct pa_operation *o;
 663     uint32_t tag;
 664     assert(c && cb);
 665
 666     o = pa_operation_new(c, NULL);
 667     o->callback = cb;
 668     o->userdata = userdata;
 669
 670     t = pa_tagstruct_new(NULL, 0);
 671     pa_tagstruct_putu32(t, command);
 672     pa_tagstruct_putu32(t, tag = c->ctag++);
 673     pa_pstream_send_tagstruct(c->pstream, t);
 674     pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT, internal_callback, o);
 675
 676     return pa_operation_ref(o);
 677 }
 678
 679 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) {
 680     struct pa_tagstruct *t;
 681     struct pa_operation *o;
 682     uint32_t tag;
 683     assert(c && cb);
 684
 685     o = pa_operation_new(c, NULL);
 686     o->callback = cb;
 687     o->userdata = userdata;
 688
 689     t = pa_tagstruct_new(NULL, 0);
 690     pa_tagstruct_putu32(t, PA_COMMAND_SET_DEFAULT_SINK);
 691     pa_tagstruct_putu32(t, tag = c->ctag++);
 692     pa_tagstruct_puts(t, name);
 693     pa_pstream_send_tagstruct(c->pstream, t);
 694     pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT,  pa_context_simple_ack_callback, o);
 695
 696     return pa_operation_ref(o);
 697 }
 698
 699 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) {
 700     struct pa_tagstruct *t;
 701     struct pa_operation *o;
 702     uint32_t tag;
 703     assert(c && cb);
 704
 705     o = pa_operation_new(c, NULL);
 706     o->callback = cb;
 707     o->userdata = userdata;
 708
 709     t = pa_tagstruct_new(NULL, 0);
 710     pa_tagstruct_putu32(t, PA_COMMAND_SET_DEFAULT_SOURCE);
 711     pa_tagstruct_putu32(t, tag = c->ctag++);
 712     pa_tagstruct_puts(t, name);
 713     pa_pstream_send_tagstruct(c->pstream, t);
 714     pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT,  pa_context_simple_ack_callback, o);
 715
 716     return pa_operation_ref(o);
 717 }
 718
 719 int pa_context_is_local(struct pa_context *c) {
 720     assert(c);
 721     return c->local;
 722 }
 723
 724 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) {
 725     struct pa_tagstruct *t;
 726     struct pa_operation *o;
 727     uint32_t tag;
 728     assert(c && name && cb);
 729
 730     o = pa_operation_new(c, NULL);
 731     o->callback = cb;
 732     o->userdata = userdata;
 733
 734     t = pa_tagstruct_new(NULL, 0);
 735     pa_tagstruct_putu32(t, PA_COMMAND_SET_CLIENT_NAME);
 736     pa_tagstruct_putu32(t, tag = c->ctag++);
 737     pa_tagstruct_puts(t, name);
 738     pa_pstream_send_tagstruct(c->pstream, t);
 739     pa_pdispatch_register_reply(c->pdispatch, tag, DEFAULT_TIMEOUT,  pa_context_simple_ack_callback, o);
 740
 741     return pa_operation_ref(o);
 742 }
 743
 744 const char* pa_get_library_version(void) {
 745     return PACKAGE_VERSION;
 746 }
 747