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