code.delx.au - pulseaudio/blob - src/modules/module-protocol-stub.c

   1 /***
   2   This file is part of PulseAudio.
   3
   4   Copyright 2004-2006 Lennart Poettering
   5   Copyright 2006 Pierre Ossman <ossman@cendio.se> for Cendio AB
   6
   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.
  11
  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.
  16
  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
  20   USA.
  21 ***/
  22
  23 #ifdef HAVE_CONFIG_H
  24 #include <config.h>
  25 #endif
  26
  27 #include <string.h>
  28 #include <errno.h>
  29 #include <stdio.h>
  30 #include <unistd.h>
  31 #include <limits.h>
  32
  33 #ifdef HAVE_SYS_SOCKET_H
  34 #include <sys/socket.h>
  35 #endif
  36 #ifdef HAVE_ARPA_INET_H
  37 #include <arpa/inet.h>
  38 #endif
  39 #ifdef HAVE_NETINET_IN_H
  40 #include <netinet/in.h>
  41 #endif
  42
  43 #include <pulse/xmalloc.h>
  44
  45 #include <pulsecore/winsock.h>
  46 #include <pulsecore/core-error.h>
  47 #include <pulsecore/module.h>
  48 #include <pulsecore/socket-server.h>
  49 #include <pulsecore/socket-util.h>
  50 #include <pulsecore/core-util.h>
  51 #include <pulsecore/modargs.h>
  52 #include <pulsecore/log.h>
  53 #include <pulsecore/native-common.h>
  54 #include <pulsecore/creds.h>
  55
  56 #ifdef USE_TCP_SOCKETS
  57 #define SOCKET_DESCRIPTION "(TCP sockets)"
  58 #define SOCKET_USAGE "port=<TCP port number> listen=<address to listen on>"
  59 #else
  60 #define SOCKET_DESCRIPTION "(UNIX sockets)"
  61 #define SOCKET_USAGE "socket=<path to UNIX socket>"
  62 #endif
  63
  64 #if defined(USE_PROTOCOL_SIMPLE)
  65 #  include <pulsecore/protocol-simple.h>
  66 #  define TCPWRAP_SERVICE "pulseaudio-simple"
  67 #  define IPV4_PORT 4711
  68 #  define UNIX_SOCKET "simple"
  69 #  define MODULE_ARGUMENTS "rate", "format", "channels", "sink", "source", "playback", "record",
  70
  71 #  if defined(USE_TCP_SOCKETS)
  72 #    include "module-simple-protocol-tcp-symdef.h"
  73 #  else
  74 #    include "module-simple-protocol-unix-symdef.h"
  75 #  endif
  76
  77   PA_MODULE_DESCRIPTION("Simple protocol "SOCKET_DESCRIPTION);
  78   PA_MODULE_USAGE("rate=<sample rate> "
  79                   "format=<sample format> "
  80                   "channels=<number of channels> "
  81                   "sink=<sink to connect to> "
  82                   "source=<source to connect to> "
  83                   "playback=<enable playback?> "
  84                   "record=<enable record?> "
  85                   SOCKET_USAGE);
  86 #elif defined(USE_PROTOCOL_CLI)
  87 #  include <pulsecore/protocol-cli.h>
  88 #  define TCPWRAP_SERVICE "pulseaudio-cli"
  89 #  define IPV4_PORT 4712
  90 #  define UNIX_SOCKET "cli"
  91 #  define MODULE_ARGUMENTS
  92
  93 #  ifdef USE_TCP_SOCKETS
  94 #    include "module-cli-protocol-tcp-symdef.h"
  95 #  else
  96 #   include "module-cli-protocol-unix-symdef.h"
  97 #  endif
  98
  99   PA_MODULE_DESCRIPTION("Command line interface protocol "SOCKET_DESCRIPTION);
 100   PA_MODULE_USAGE(SOCKET_USAGE);
 101 #elif defined(USE_PROTOCOL_HTTP)
 102 #  include <pulsecore/protocol-http.h>
 103 #  define TCPWRAP_SERVICE "pulseaudio-http"
 104 #  define IPV4_PORT 4714
 105 #  define UNIX_SOCKET "http"
 106 #  define MODULE_ARGUMENTS
 107
 108 #  ifdef USE_TCP_SOCKETS
 109 #    include "module-http-protocol-tcp-symdef.h"
 110 #  else
 111 #    include "module-http-protocol-unix-symdef.h"
 112 #  endif
 113
 114   PA_MODULE_DESCRIPTION("HTTP "SOCKET_DESCRIPTION);
 115   PA_MODULE_USAGE(SOCKET_USAGE);
 116 #elif defined(USE_PROTOCOL_NATIVE)
 117 #  include <pulsecore/protocol-native.h>
 118 #  define TCPWRAP_SERVICE "pulseaudio-native"
 119 #  define IPV4_PORT PA_NATIVE_DEFAULT_PORT
 120 #  define UNIX_SOCKET PA_NATIVE_DEFAULT_UNIX_SOCKET
 121 #  define MODULE_ARGUMENTS_COMMON "cookie", "auth-cookie", "auth-cookie-enabled", "auth-anonymous",
 122
 123 #  ifdef USE_TCP_SOCKETS
 124 #    include "module-native-protocol-tcp-symdef.h"
 125 #  else
 126 #    include "module-native-protocol-unix-symdef.h"
 127 #  endif
 128
 129 #  if defined(HAVE_CREDS) && !defined(USE_TCP_SOCKETS)
 130 #    define MODULE_ARGUMENTS MODULE_ARGUMENTS_COMMON "auth-group", "auth-group-enable",
 131 #    define AUTH_USAGE "auth-group=<system group to allow access> auth-group-enable=<enable auth by UNIX group?> "
 132 #  elif defined(USE_TCP_SOCKETS)
 133 #    define MODULE_ARGUMENTS MODULE_ARGUMENTS_COMMON "auth-ip-acl",
 134 #    define AUTH_USAGE "auth-ip-acl=<IP address ACL to allow access> "
 135 #  else
 136 #    define MODULE_ARGUMENTS MODULE_ARGUMENTS_COMMON
 137 #    define AUTH_USAGE
 138 #    endif
 139
 140   PA_MODULE_DESCRIPTION("Native protocol "SOCKET_DESCRIPTION);
 141   PA_MODULE_USAGE("auth-anonymous=<don't check for cookies?> "
 142                   "auth-cookie=<path to cookie file> "
 143                   "auth-cookie-enabled=<enable cookie authentification? "
 144                   AUTH_USAGE
 145                   SOCKET_USAGE);
 146 #elif defined(USE_PROTOCOL_ESOUND)
 147 #  include <pulsecore/protocol-esound.h>
 148 #  include <pulsecore/esound.h>
 149 #  define TCPWRAP_SERVICE "esound"
 150 #  define IPV4_PORT ESD_DEFAULT_PORT
 151 #  define MODULE_ARGUMENTS_COMMON "sink", "source", "auth-anonymous", "cookie", "auth-cookie", "auth-cookie-enabled",
 152
 153 #  ifdef USE_TCP_SOCKETS
 154 #    include "module-esound-protocol-tcp-symdef.h"
 155 #  else
 156 #    include "module-esound-protocol-unix-symdef.h"
 157 #  endif
 158
 159 #  if defined(USE_TCP_SOCKETS)
 160 #    define MODULE_ARGUMENTS MODULE_ARGUMENTS_COMMON "auth-ip-acl",
 161 #    define AUTH_USAGE "auth-ip-acl=<IP address ACL to allow access> "
 162 #  else
 163 #    define MODULE_ARGUMENTS MODULE_ARGUMENTS_COMMON
 164 #    define AUTH_USAGE
 165 #  endif
 166
 167   PA_MODULE_DESCRIPTION("ESOUND protocol "SOCKET_DESCRIPTION);
 168   PA_MODULE_USAGE("sink=<sink to connect to> "
 169                   "source=<source to connect to> "
 170                   "auth-anonymous=<don't verify cookies?> "
 171                   "auth-cookie=<path to cookie file> "
 172                   "auth-cookie-enabled=<enable cookie authentification? "
 173                   AUTH_USAGE
 174                   SOCKET_USAGE);
 175 #else
 176 #  error "Broken build system"
 177 #endif
 178
 179 PA_MODULE_LOAD_ONCE(FALSE);
 180 PA_MODULE_AUTHOR("Lennart Poettering");
 181 PA_MODULE_VERSION(PACKAGE_VERSION);
 182
 183 static const char* const valid_modargs[] = {
 184     MODULE_ARGUMENTS
 185 #if defined(USE_TCP_SOCKETS)
 186     "port",
 187     "listen",
 188 #else
 189     "socket",
 190 #endif
 191     NULL
 192 };
 193
 194 struct userdata {
 195     pa_module *module;
 196
 197 #if defined(USE_PROTOCOL_SIMPLE)
 198     pa_simple_protocol *simple_protocol;
 199     pa_simple_options *simple_options;
 200 #elif defined(USE_PROTOCOL_CLI)
 201     pa_cli_protocol *cli_protocol;
 202 #elif defined(USE_PROTOCOL_HTTP)
 203     pa_http_protocol *http_protocol;
 204 #elif defined(USE_PROTOCOL_NATIVE)
 205     pa_native_protocol *native_protocol;
 206     pa_native_options *native_options;
 207 #else
 208     pa_esound_protocol *esound_protocol;
 209     pa_esound_options *esound_options;
 210 #endif
 211
 212 #if defined(USE_TCP_SOCKETS)
 213     pa_socket_server *socket_server_ipv4;
 214 #  ifdef HAVE_IPV6
 215     pa_socket_server *socket_server_ipv6;
 216 #  endif
 217 #else
 218     pa_socket_server *socket_server_unix;
 219     char *socket_path;
 220 #endif
 221 };
 222
 223 static void socket_server_on_connection_cb(pa_socket_server*s, pa_iochannel *io, void *userdata) {
 224     struct userdata *u = userdata;
 225
 226     pa_assert(s);
 227     pa_assert(io);
 228     pa_assert(u);
 229
 230 #if defined(USE_PROTOCOL_SIMPLE)
 231     pa_simple_protocol_connect(u->simple_protocol, io, u->simple_options);
 232 #elif defined(USE_PROTOCOL_CLI)
 233     pa_cli_protocol_connect(u->cli_protocol, io, u->module);
 234 #elif defined(USE_PROTOCOL_HTTP)
 235     pa_http_protocol_connect(u->http_protocol, io, u->module);
 236 #elif defined(USE_PROTOCOL_NATIVE)
 237     pa_native_protocol_connect(u->native_protocol, io, u->native_options);
 238 #else
 239     pa_esound_protocol_connect(u->esound_protocol, io, u->esound_options);
 240 #endif
 241 }
 242
 243 int pa__init(pa_module*m) {
 244     pa_modargs *ma = NULL;
 245     struct userdata *u = NULL;
 246
 247 #if defined(USE_TCP_SOCKETS)
 248     uint32_t port = IPV4_PORT;
 249     const char *listen_on;
 250 #else
 251     int r;
 252 #endif
 253
 254 #if defined(USE_PROTOCOL_NATIVE)
 255     char t[256];
 256 #endif
 257
 258     pa_assert(m);
 259
 260     if (!(ma = pa_modargs_new(m->argument, valid_modargs))) {
 261         pa_log("Failed to parse module arguments");
 262         goto fail;
 263     }
 264
 265     m->userdata = u = pa_xnew0(struct userdata, 1);
 266     u->module = m;
 267
 268 #if defined(USE_PROTOCOL_SIMPLE)
 269     u->simple_protocol = pa_simple_protocol_get(m->core);
 270
 271     u->simple_options = pa_simple_options_new();
 272     if (pa_simple_options_parse(u->simple_options, m->core, ma) < 0)
 273         goto fail;
 274     u->simple_options->module = m;
 275 #elif defined(USE_PROTOCOL_CLI)
 276     u->cli_protocol = pa_cli_protocol_get(m->core);
 277 #elif defined(USE_PROTOCOL_HTTP)
 278     u->http_protocol = pa_http_protocol_get(m->core);
 279 #elif defined(USE_PROTOCOL_NATIVE)
 280     u->native_protocol = pa_native_protocol_get(m->core);
 281
 282     u->native_options = pa_native_options_new();
 283     if (pa_native_options_parse(u->native_options, m->core, ma) < 0)
 284         goto fail;
 285     u->native_options->module = m;
 286 #else
 287     u->esound_protocol = pa_esound_protocol_get(m->core);
 288
 289     u->esound_options = pa_esound_options_new();
 290     if (pa_esound_options_parse(u->esound_options, m->core, ma) < 0)
 291         goto fail;
 292     u->esound_options->module = m;
 293 #endif
 294
 295 #if defined(USE_TCP_SOCKETS)
 296     if (pa_modargs_get_value_u32(ma, "port", &port) < 0 || port < 1 || port > 0xFFFF) {
 297         pa_log("port= expects a numerical argument between 1 and 65535.");
 298         goto fail;
 299     }
 300
 301     listen_on = pa_modargs_get_value(ma, "listen", NULL);
 302
 303     if (listen_on) {
 304 #  ifdef HAVE_IPV6
 305         u->socket_server_ipv6 = pa_socket_server_new_ipv6_string(m->core->mainloop, listen_on, (uint16_t) port, TCPWRAP_SERVICE);
 306 #  endif
 307         u->socket_server_ipv4 = pa_socket_server_new_ipv4_string(m->core->mainloop, listen_on, (uint16_t) port, TCPWRAP_SERVICE);
 308     } else {
 309 #  ifdef HAVE_IPV6
 310         u->socket_server_ipv6 = pa_socket_server_new_ipv6_any(m->core->mainloop, (uint16_t) port, TCPWRAP_SERVICE);
 311 #  endif
 312         u->socket_server_ipv4 = pa_socket_server_new_ipv4_any(m->core->mainloop, (uint16_t) port, TCPWRAP_SERVICE);
 313     }
 314
 315 #  ifdef HAVE_IPV6
 316     if (!u->socket_server_ipv4 && !u->socket_server_ipv6)
 317 #  else
 318     if (!u->socket_server_ipv4)
 319 #  endif
 320         goto fail;
 321
 322     if (u->socket_server_ipv4)
 323         pa_socket_server_set_callback(u->socket_server_ipv4, socket_server_on_connection_cb, u);
 324 #  ifdef HAVE_IPV6
 325     if (u->socket_server_ipv6)
 326         pa_socket_server_set_callback(u->socket_server_ipv6, socket_server_on_connection_cb, u);
 327 #  endif
 328
 329 #else
 330
 331 #  if defined(USE_PROTOCOL_ESOUND)
 332
 333 #    if defined(USE_PER_USER_ESOUND_SOCKET)
 334     u->socket_path = pa_sprintf_malloc("/tmp/.esd-%lu/socket", (unsigned long) getuid());
 335 #    else
 336     u->socket_path = pa_xstrdup("/tmp/.esd/socket");
 337 #    endif
 338
 339     /* This socket doesn't reside in our own runtime dir but in
 340      * /tmp/.esd/, hence we have to create the dir first */
 341
 342     if (pa_make_secure_parent_dir(u->socket_path, pa_in_system_mode() ? 0755U : 0700U, (uid_t)-1, (gid_t)-1) < 0) {
 343         pa_log("Failed to create socket directory '%s': %s\n", u->socket_path, pa_cstrerror(errno));
 344         goto fail;
 345     }
 346
 347 #  else
 348     if (!(u->socket_path = pa_runtime_path(pa_modargs_get_value(ma, "socket", UNIX_SOCKET)))) {
 349         pa_log("Failed to generate socket path.");
 350         goto fail;
 351     }
 352 #  endif
 353
 354     if ((r = pa_unix_socket_remove_stale(u->socket_path)) < 0) {
 355         pa_log("Failed to remove stale UNIX socket '%s': %s", u->socket_path, pa_cstrerror(errno));
 356         goto fail;
 357     } else if (r > 0)
 358         pa_log_info("Removed stale UNIX socket '%s'.", u->socket_path);
 359
 360     if (!(u->socket_server_unix = pa_socket_server_new_unix(m->core->mainloop, u->socket_path)))
 361         goto fail;
 362
 363     pa_socket_server_set_callback(u->socket_server_unix, socket_server_on_connection_cb, u);
 364
 365 #endif
 366
 367 #if defined(USE_PROTOCOL_NATIVE)
 368 #  if defined(USE_TCP_SOCKETS)
 369     if (u->socket_server_ipv4)
 370         if (pa_socket_server_get_address(u->socket_server_ipv4, t, sizeof(t)))
 371             pa_native_protocol_add_server_string(u->native_protocol, t);
 372
 373 #    ifdef HAVE_IPV6
 374     if (u->socket_server_ipv6)
 375         if (pa_socket_server_get_address(u->socket_server_ipv6, t, sizeof(t)))
 376             pa_native_protocol_add_server_string(u->native_protocol, t);
 377 #    endif
 378 #  else
 379     if (pa_socket_server_get_address(u->socket_server_unix, t, sizeof(t)))
 380         pa_native_protocol_add_server_string(u->native_protocol, t);
 381
 382 #  endif
 383 #endif
 384
 385     if (ma)
 386         pa_modargs_free(ma);
 387
 388     return 0;
 389
 390 fail:
 391
 392     if (ma)
 393         pa_modargs_free(ma);
 394
 395     pa__done(m);
 396
 397     return -1;
 398 }
 399
 400 void pa__done(pa_module*m) {
 401     struct userdata *u;
 402
 403     pa_assert(m);
 404
 405     if (!(u = m->userdata))
 406         return;
 407
 408 #if defined(USE_PROTOCOL_SIMPLE)
 409     if (u->simple_protocol) {
 410         pa_simple_protocol_disconnect(u->simple_protocol, u->module);
 411         pa_simple_protocol_unref(u->simple_protocol);
 412     }
 413     if (u->simple_options)
 414         pa_simple_options_unref(u->simple_options);
 415 #elif defined(USE_PROTOCOL_CLI)
 416     if (u->cli_protocol) {
 417         pa_cli_protocol_disconnect(u->cli_protocol, u->module);
 418         pa_cli_protocol_unref(u->cli_protocol);
 419     }
 420 #elif defined(USE_PROTOCOL_HTTP)
 421     if (u->http_protocol) {
 422         pa_http_protocol_disconnect(u->http_protocol, u->module);
 423         pa_http_protocol_unref(u->http_protocol);
 424     }
 425 #elif defined(USE_PROTOCOL_NATIVE)
 426     if (u->native_protocol) {
 427
 428         char t[256];
 429
 430 #  if defined(USE_TCP_SOCKETS)
 431         if (u->socket_server_ipv4)
 432             if (pa_socket_server_get_address(u->socket_server_ipv4, t, sizeof(t)))
 433                 pa_native_protocol_remove_server_string(u->native_protocol, t);
 434
 435 #    ifdef HAVE_IPV6
 436         if (u->socket_server_ipv6)
 437             if (pa_socket_server_get_address(u->socket_server_ipv6, t, sizeof(t)))
 438                 pa_native_protocol_remove_server_string(u->native_protocol, t);
 439 #    endif
 440 #  else
 441         if (u->socket_server_unix)
 442             if (pa_socket_server_get_address(u->socket_server_unix, t, sizeof(t)))
 443                 pa_native_protocol_remove_server_string(u->native_protocol, t);
 444 #  endif
 445
 446         pa_native_protocol_disconnect(u->native_protocol, u->module);
 447         pa_native_protocol_unref(u->native_protocol);
 448     }
 449     if (u->native_options)
 450         pa_native_options_unref(u->native_options);
 451 #else
 452     if (u->esound_protocol) {
 453         pa_esound_protocol_disconnect(u->esound_protocol, u->module);
 454         pa_esound_protocol_unref(u->esound_protocol);
 455     }
 456     if (u->esound_options)
 457         pa_esound_options_unref(u->esound_options);
 458 #endif
 459
 460 #if defined(USE_TCP_SOCKETS)
 461     if (u->socket_server_ipv4)
 462         pa_socket_server_unref(u->socket_server_ipv4);
 463 #  ifdef HAVE_IPV6
 464     if (u->socket_server_ipv6)
 465         pa_socket_server_unref(u->socket_server_ipv6);
 466 #  endif
 467 #else
 468     if (u->socket_server_unix)
 469         pa_socket_server_unref(u->socket_server_unix);
 470
 471 # if defined(USE_PROTOCOL_ESOUND) && !defined(USE_PER_USER_ESOUND_SOCKET)
 472     if (u->socket_path) {
 473         char *p = pa_parent_dir(u->socket_path);
 474         rmdir(p);
 475         pa_xfree(p);
 476     }
 477 # endif
 478
 479     pa_xfree(u->socket_path);
 480 #endif
 481
 482     pa_xfree(u);
 483 }