lib/libwebsockets.c

   1 /*
   2  * libwebsockets - small server side websockets and web server implementation
   3  *
   4  * Copyright (C) 2010 Andy Green <andy@warmcat.com>
   5  *
   6  *  This library is free software; you can redistribute it and/or
   7  *  modify it under the terms of the GNU Lesser General Public
   8  *  License as published by the Free Software Foundation:
   9  *  version 2.1 of the License.
  10  *
  11  *  This library is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  *  Lesser General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU Lesser General Public
  17  *  License along with this library; if not, write to the Free Software
  18  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
  19  *  MA  02110-1301  USA
  20  */
  21
  22 #include "private-libwebsockets.h"
  23
  24 void
  25 libwebsocket_close_and_free_session(struct libwebsocket *wsi)
  26 {
  27         int n;
  28
  29         if ((unsigned long)wsi < LWS_MAX_PROTOCOLS)
  30                 return;
  31
  32         n = wsi->state;
  33
  34         wsi->state = WSI_STATE_DEAD_SOCKET;
  35
  36         if (wsi->protocol->callback && n == WSI_STATE_ESTABLISHED)
  37                 wsi->protocol->callback(wsi, LWS_CALLBACK_CLOSED,
  38                                                       wsi->user_space, NULL, 0);
  39
  40         for (n = 0; n < WSI_TOKEN_COUNT; n++)
  41                 if (wsi->utf8_token[n].token)
  42                         free(wsi->utf8_token[n].token);
  43
  44 /*      fprintf(stderr, "closing fd=%d\n", wsi->sock); */
  45
  46 #ifdef LWS_OPENSSL_SUPPORT
  47         if (wsi->ssl) {
  48                 n = SSL_get_fd(wsi->ssl);
  49                 SSL_shutdown(wsi->ssl);
  50                 close(n);
  51                 SSL_free(wsi->ssl);
  52         } else {
  53 #endif
  54                 shutdown(wsi->sock, SHUT_RDWR);
  55                 close(wsi->sock);
  56 #ifdef LWS_OPENSSL_SUPPORT
  57         }
  58 #endif
  59         if (wsi->user_space)
  60                 free(wsi->user_space);
  61
  62         free(wsi);
  63 }
  64
  65 static int
  66 libwebsocket_poll_connections(struct libwebsocket_context *this)
  67 {
  68         unsigned char buf[LWS_SEND_BUFFER_PRE_PADDING + MAX_BROADCAST_PAYLOAD +
  69                                                   LWS_SEND_BUFFER_POST_PADDING];
  70         int client = this->count_protocols + 1;
  71         struct libwebsocket *wsi;
  72         int n;
  73         size_t len;
  74
  75         /* check for activity on client sockets */
  76
  77         for (; client < this->fds_count; client++) {
  78
  79                 /* handle session socket closed */
  80
  81                 if (this->fds[client].revents & (POLLERR | POLLHUP)) {
  82
  83                         debug("Session Socket %d %p (fd=%d) dead\n",
  84                                 client, (void *)this->wsi[client],
  85                                                           this->fds[client].fd);
  86
  87                         libwebsocket_close_and_free_session(this->wsi[client]);
  88                         goto nuke_this;
  89                 }
  90
  91                 /* the guy requested a callback when it was OK to write */
  92
  93                 if ((unsigned long)this->wsi[client] > LWS_MAX_PROTOCOLS &&
  94                                           this->fds[client].revents & POLLOUT) {
  95
  96                         this->fds[client].events &= ~POLLOUT;
  97
  98                         this->wsi[client]->protocol->callback(this->wsi[client],
  99                                 LWS_CALLBACK_CLIENT_WRITEABLE,
 100                                 this->wsi[client]->user_space,
 101                                 NULL, 0);
 102                 }
 103
 104                 /* any incoming data ready? */
 105
 106                 if (!(this->fds[client].revents & POLLIN))
 107                         continue;
 108
 109                 /* broadcast? */
 110
 111                 if ((unsigned long)this->wsi[client] < LWS_MAX_PROTOCOLS) {
 112
 113                         /* get the issued broadcast payload from the socket */
 114
 115                         len = read(this->fds[client].fd,
 116                                    buf + LWS_SEND_BUFFER_PRE_PADDING,
 117                                    MAX_BROADCAST_PAYLOAD);
 118
 119                         if (len < 0) {
 120                                 fprintf(stderr,
 121                                            "Error reading broadcast payload\n");
 122                                 continue;
 123                         }
 124
 125                         /* broadcast it to all guys with this protocol index */
 126
 127                         for (n = this->count_protocols + 1;
 128                                                      n < this->fds_count; n++) {
 129
 130                                 wsi = this->wsi[n];
 131
 132                                 if ((unsigned long)wsi < LWS_MAX_PROTOCOLS)
 133                                         continue;
 134
 135                                 /*
 136                                  * never broadcast to non-established
 137                                  * connection
 138                                  */
 139
 140                                 if (wsi->state != WSI_STATE_ESTABLISHED)
 141                                         continue;
 142
 143                                 /* only to clients connected to us */
 144
 145                                 if (wsi->client_mode)
 146                                         continue;
 147
 148                                 /*
 149                                  * only broadcast to connections using
 150                                  * the requested protocol
 151                                  */
 152
 153                                 if (wsi->protocol->protocol_index !=
 154                                           (int)(unsigned long)this->wsi[client])
 155                                         continue;
 156
 157                                 /* broadcast it to this connection */
 158
 159                                 wsi->protocol->callback(wsi,
 160                                         LWS_CALLBACK_BROADCAST,
 161                                         wsi->user_space,
 162                                         buf + LWS_SEND_BUFFER_PRE_PADDING, len);
 163                         }
 164
 165                         continue;
 166                 }
 167
 168 #ifdef LWS_OPENSSL_SUPPORT
 169                 if (this->wsi[client]->ssl)
 170                         n = SSL_read(this->wsi[client]->ssl, buf, sizeof buf);
 171                 else
 172 #endif
 173                         n = recv(this->fds[client].fd, buf, sizeof buf, 0);
 174
 175                 if (n < 0) {
 176                         fprintf(stderr, "Socket read returned %d\n", n);
 177                         continue;
 178                 }
 179                 if (!n) {
 180                         libwebsocket_close_and_free_session(this->wsi[client]);
 181                         goto nuke_this;
 182                 }
 183
 184                 /* service incoming data */
 185
 186                 n = libwebsocket_read(this->wsi[client], buf, n);
 187                 if (n >= 0)
 188                         continue;
 189                 /*
 190                  * it closed and nuked wsi[client], so remove the
 191                  * socket handle and wsi from our service list
 192                  */
 193 nuke_this:
 194
 195                 debug("nuking wsi %p, fsd_count = %d\n",
 196                                 (void *)this->wsi[client], this->fds_count - 1);
 197
 198                 this->fds_count--;
 199                 for (n = client; n < this->fds_count; n++) {
 200                         this->fds[n] = this->fds[n + 1];
 201                         this->wsi[n] = this->wsi[n + 1];
 202                 }
 203
 204                 return 0;
 205
 206         }
 207
 208         return 0;
 209 }
 210
 211 /**
 212  * libwebsocket_context_destroy() - Destroy the websocket context
 213  * @this:       Websocket context
 214  *
 215  *      This function closes any active connections and then frees the
 216  *      context.  After calling this, any further use of the context is
 217  *      undefined.
 218  */
 219 void
 220 libwebsocket_context_destroy(struct libwebsocket_context *this)
 221 {
 222         int client;
 223
 224         /* close listening skt and per-protocol broadcast sockets */
 225         for (client = 0; client < this->fds_count; client++)
 226                 libwebsocket_close_and_free_session(this->wsi[client]);
 227
 228 #ifdef LWS_OPENSSL_SUPPORT
 229         if (this->ssl_ctx)
 230                 SSL_CTX_free(this->ssl_ctx);
 231 #endif
 232
 233         if (this)
 234                 free(this);
 235 }
 236
 237 /**
 238  * libwebsocket_service() - Service any pending websocket activity
 239  * @this:       Websocket context
 240  * @timeout_ms: Timeout for poll; 0 means return immediately if nothing needed
 241  *              service otherwise block and service immediately, returning
 242  *              after the timeout if nothing needed service.
 243  *
 244  *      This function deals with any pending websocket traffic, for three
 245  *      kinds of event.  It handles these events on both server and client
 246  *      types of connection the same.
 247  *
 248  *      1) Accept new connections to our context's server
 249  *
 250  *      2) Perform pending broadcast writes initiated from other forked
 251  *         processes (effectively serializing asynchronous broadcasts)
 252  *
 253  *      3) Call the receive callback for incoming frame data received by
 254  *          server or client connections.
 255  *
 256  *      You need to call this service function periodically to all the above
 257  *      functions to happen; if your application is single-threaded you can
 258  *      just call it in your main event loop.
 259  *
 260  *      Alternatively you can fork a new process that asynchronously handles
 261  *      calling this service in a loop.  In that case you are happy if this
 262  *      call blocks your thread until it needs to take care of something and
 263  *      would call it with a large nonzero timeout.  Your loop then takes no
 264  *      CPU while there is nothing happening.
 265  *
 266  *      If you are calling it in a single-threaded app, you don't want it to
 267  *      wait around blocking other things in your loop from happening, so you
 268  *      would call it with a timeout_ms of 0, so it returns immediately if
 269  *      nothing is pending, or as soon as it services whatever was pending.
 270  */
 271
 272
 273 int
 274 libwebsocket_service(struct libwebsocket_context *this, int timeout_ms)
 275 {
 276         int n;
 277         int client;
 278         unsigned int clilen;
 279         struct sockaddr_in cli_addr;
 280         int fd;
 281
 282         /* stay dead once we are dead */
 283
 284         if (this == NULL)
 285                 return 1;
 286
 287         /* don't check listen socket if we are not listening */
 288
 289         if (this->listen_port)
 290                 n = poll(this->fds, this->fds_count, timeout_ms);
 291         else
 292                 n = poll(&this->fds[1], this->fds_count - 1, timeout_ms);
 293
 294
 295         if (n < 0 || this->fds[0].revents & (POLLERR | POLLHUP)) {
 296                 fprintf(stderr, "Listen Socket dead\n");
 297                 goto fatal;
 298         }
 299         if (n == 0) /* poll timeout */
 300                 return 0;
 301
 302         /* handle accept on listening socket? */
 303
 304         for (client = 0; client < this->count_protocols + 1; client++) {
 305
 306                 if (!this->fds[client].revents & POLLIN)
 307                         continue;
 308
 309                 /* listen socket got an unencrypted connection... */
 310
 311                 clilen = sizeof(cli_addr);
 312                 fd  = accept(this->fds[client].fd,
 313                              (struct sockaddr *)&cli_addr, &clilen);
 314                 if (fd < 0) {
 315                         fprintf(stderr, "ERROR on accept");
 316                         continue;
 317                 }
 318
 319                 if (this->fds_count >= MAX_CLIENTS) {
 320                         fprintf(stderr, "too busy");
 321                         close(fd);
 322                         continue;
 323                 }
 324
 325                 if (client) {
 326                         /*
 327                          * accepting a connection to broadcast socket
 328                          * set wsi to be protocol index not pointer
 329                          */
 330
 331                         this->wsi[this->fds_count] =
 332                               (struct libwebsocket *)(long)(client - 1);
 333
 334                         goto fill_in_fds;
 335                 }
 336
 337                 /* accepting connection to main listener */
 338
 339                 this->wsi[this->fds_count] =
 340                                     malloc(sizeof(struct libwebsocket));
 341                 if (!this->wsi[this->fds_count]) {
 342                         fprintf(stderr, "Out of memory for new connection\n");
 343                         continue;
 344                 }
 345
 346 #ifdef LWS_OPENSSL_SUPPORT
 347                 this->wsi[this->fds_count]->ssl = NULL;
 348
 349                 if (this->use_ssl) {
 350
 351                         this->wsi[this->fds_count]->ssl =
 352                                                          SSL_new(this->ssl_ctx);
 353                         if (this->wsi[this->fds_count]->ssl == NULL) {
 354                                 fprintf(stderr, "SSL_new failed: %s\n",
 355                                     ERR_error_string(SSL_get_error(
 356                                     this->wsi[this->fds_count]->ssl, 0),
 357                                                                  NULL));
 358                                 free(this->wsi[this->fds_count]);
 359                                 continue;
 360                         }
 361
 362                         SSL_set_fd(this->wsi[this->fds_count]->ssl, fd);
 363
 364                         n = SSL_accept(this->wsi[this->fds_count]->ssl);
 365                         if (n != 1) {
 366                                 /*
 367                                  * browsers seem to probe with various
 368                                  * ssl params which fail then retry
 369                                  * and succeed
 370                                  */
 371                                 debug("SSL_accept failed skt %u: %s\n",
 372                                       fd,
 373                                       ERR_error_string(SSL_get_error(
 374                                       this->wsi[this->fds_count]->ssl,
 375                                                              n), NULL));
 376                                 SSL_free(
 377                                        this->wsi[this->fds_count]->ssl);
 378                                 free(this->wsi[this->fds_count]);
 379                                 continue;
 380                         }
 381                         debug("accepted new SSL conn  "
 382                               "port %u on fd=%d SSL ver %s\n",
 383                                 ntohs(cli_addr.sin_port), fd,
 384                                   SSL_get_version(this->wsi[
 385                                                 this->fds_count]->ssl));
 386
 387                 } else
 388 #endif
 389                         debug("accepted new conn  port %u on fd=%d\n",
 390                                           ntohs(cli_addr.sin_port), fd);
 391
 392                 /* intialize the instance struct */
 393
 394                 this->wsi[this->fds_count]->sock = fd;
 395                 this->wsi[this->fds_count]->state = WSI_STATE_HTTP;
 396                 this->wsi[this->fds_count]->name_buffer_pos = 0;
 397                 this->wsi[this->fds_count]->client_mode = 0;
 398
 399                 for (n = 0; n < WSI_TOKEN_COUNT; n++) {
 400                         this->wsi[this->fds_count]->
 401                                              utf8_token[n].token = NULL;
 402                         this->wsi[this->fds_count]->
 403                                             utf8_token[n].token_len = 0;
 404                 }
 405
 406                 /*
 407                  * these can only be set once the protocol is known
 408                  * we set an unestablished connection's protocol pointer
 409                  * to the start of the supported list, so it can look
 410                  * for matching ones during the handshake
 411                  */
 412                 this->wsi[this->fds_count]->protocol = this->protocols;
 413                 this->wsi[this->fds_count]->user_space = NULL;
 414
 415                 /*
 416                  * Default protocol is 76 / 00
 417                  * After 76, there's a header specified to inform which
 418                  * draft the client wants, when that's seen we modify
 419                  * the individual connection's spec revision accordingly
 420                  */
 421                 this->wsi[this->fds_count]->ietf_spec_revision = 0;
 422
 423 fill_in_fds:
 424
 425                 /*
 426                  * make sure NO events are seen yet on this new socket
 427                  * (otherwise we inherit old fds[client].revents from
 428                  * previous socket there and die mysteriously! )
 429                  */
 430                 this->fds[this->fds_count].revents = 0;
 431
 432                 this->fds[this->fds_count].events = POLLIN;
 433                 this->fds[this->fds_count++].fd = fd;
 434
 435         }
 436
 437         /* service anything incoming on websocket connection */
 438
 439         libwebsocket_poll_connections(this);
 440
 441         /* this round is done */
 442
 443         return 0;
 444
 445 fatal:
 446
 447         fprintf(stderr, "service hits fatal\n");
 448
 449         /* close listening skt and per-protocol broadcast sockets */
 450         for (client = 0; client < this->fds_count; client++)
 451                 close(this->fds[0].fd);
 452
 453 #ifdef LWS_OPENSSL_SUPPORT
 454         if (this->ssl_ctx)
 455                 SSL_CTX_free(this->ssl_ctx);
 456 #endif
 457
 458         if (this)
 459                 free(this);
 460
 461         this = NULL;
 462
 463         /* inform caller we are dead */
 464
 465         return 1;
 466 }
 467
 468 /**
 469  * libwebsocket_callback_on_writable() - Request a callback when this socket
 470  *                                       becomes able to be written to without
 471  *                                       blocking
 472  *
 473  * @wsi:        Websocket connection instance to get callback for
 474  */
 475
 476 int
 477 libwebsocket_callback_on_writable(struct libwebsocket *wsi)
 478 {
 479         struct libwebsocket_context *this = wsi->protocol->owning_server;
 480         int n;
 481
 482         for (n = this->count_protocols + 1; n < this->fds_count; n++)
 483                 if (this->wsi[n] == wsi) {
 484                         this->fds[n].events |= POLLOUT;
 485                         return 0;
 486                 }
 487
 488         fprintf(stderr, "libwebsocket_callback_on_writable "
 489                                                         "didn't find socket\n");
 490         return 1;
 491 }
 492
 493 /**
 494  * libwebsocket_callback_on_writable_all_protocol() - Request a callback for
 495  *                      all connections using the given protocol when it
 496  *                      becomes possible to write to each socket without
 497  *                      blocking in turn.
 498  *
 499  * @protocol:   Protocol whose connections will get callbacks
 500  */
 501
 502 int
 503 libwebsocket_callback_on_writable_all_protocol(
 504                                   const struct libwebsocket_protocols *protocol)
 505 {
 506         struct libwebsocket_context *this = protocol->owning_server;
 507         int n;
 508
 509         for (n = this->count_protocols + 1; n < this->fds_count; n++)
 510                 if ((unsigned long)this->wsi[n] > LWS_MAX_PROTOCOLS)
 511                         if (this->wsi[n]->protocol == protocol)
 512                                 this->fds[n].events |= POLLOUT;
 513
 514         return 0;
 515 }
 516
 517 /**
 518  * libwebsocket_rx_flow_control() - Enable and disable socket servicing for
 519  *                              receieved packets.
 520  *
 521  * If the output side of a server process becomes choked, this allows flow
 522  * control for the input side.
 523  *
 524  * @wsi:        Websocket connection instance to get callback for
 525  * @enable:     0 = disable read servicing for this connection, 1 = enable
 526  */
 527
 528 int
 529 libwebsocket_rx_flow_control(struct libwebsocket *wsi, int enable)
 530 {
 531         struct libwebsocket_context *this = wsi->protocol->owning_server;
 532         int n;
 533
 534         for (n = this->count_protocols + 1; n < this->fds_count; n++)
 535                 if (this->wsi[n] == wsi) {
 536                         if (enable)
 537                                 this->fds[n].events |= POLLIN;
 538                         else
 539                                 this->fds[n].events &= ~POLLIN;
 540
 541                         return 0;
 542                 }
 543
 544         fprintf(stderr, "libwebsocket_callback_on_writable "
 545                                                      "unable to find socket\n");
 546         return 1;
 547 }
 548
 549 static void sigpipe_handler(int x)
 550 {
 551 }
 552
 553
 554 /**
 555  * libwebsocket_create_context() - Create the websocket handler
 556  * @port:       Port to listen on... you can use 0 to suppress listening on
 557  *              any port, that's what you want if you are not running a
 558  *              websocket server at all but just using it as a client
 559  * @protocols:  Array of structures listing supported protocols and a protocol-
 560  *              specific callback for each one.  The list is ended with an
 561  *              entry that has a NULL callback pointer.
 562  *              It's not const because we write the owning_server member
 563  * @ssl_cert_filepath:  If libwebsockets was compiled to use ssl, and you want
 564  *                      to listen using SSL, set to the filepath to fetch the
 565  *                      server cert from, otherwise NULL for unencrypted
 566  * @ssl_private_key_filepath: filepath to private key if wanting SSL mode,
 567  *                      else ignored
 568  * @gid:        group id to change to after setting listen socket, or -1.
 569  * @uid:        user id to change to after setting listen socket, or -1.
 570  *
 571  *      This function creates the listening socket and takes care
 572  *      of all initialization in one step.
 573  *
 574  *      After initialization, it returns a struct libwebsocket_context * that
 575  *      represents this server.  After calling, user code needs to take care
 576  *      of calling libwebsocket_service() with the context pointer to get the
 577  *      server's sockets serviced.  This can be done in the same process context
 578  *      or a forked process, or another thread,
 579  *
 580  *      The protocol callback functions are called for a handful of events
 581  *      including http requests coming in, websocket connections becoming
 582  *      established, and data arriving; it's also called periodically to allow
 583  *      async transmission.
 584  *
 585  *      HTTP requests are sent always to the FIRST protocol in @protocol, since
 586  *      at that time websocket protocol has not been negotiated.  Other
 587  *      protocols after the first one never see any HTTP callack activity.
 588  *
 589  *      The server created is a simple http server by default; part of the
 590  *      websocket standard is upgrading this http connection to a websocket one.
 591  *
 592  *      This allows the same server to provide files like scripts and favicon /
 593  *      images or whatever over http and dynamic data over websockets all in
 594  *      one place; they're all handled in the user callback.
 595  */
 596
 597 struct libwebsocket_context *
 598 libwebsocket_create_context(int port,
 599                                struct libwebsocket_protocols *protocols,
 600                                const char *ssl_cert_filepath,
 601                                const char *ssl_private_key_filepath,
 602                                int gid, int uid)
 603 {
 604         int n;
 605         int sockfd = 0;
 606         int fd;
 607         struct sockaddr_in serv_addr, cli_addr;
 608         int opt = 1;
 609         struct libwebsocket_context *this = NULL;
 610         unsigned int slen;
 611
 612 #ifdef LWS_OPENSSL_SUPPORT
 613         SSL_METHOD *method;
 614         char ssl_err_buf[512];
 615 #endif
 616
 617         this = malloc(sizeof(struct libwebsocket_context));
 618         if (!this) {
 619                 fprintf(stderr, "No memory for websocket context\n");
 620                 return NULL;
 621         }
 622         this->protocols = protocols;
 623         this->listen_port = port;
 624
 625         if (port) {
 626
 627 #ifdef LWS_OPENSSL_SUPPORT
 628                 this->use_ssl = ssl_cert_filepath != NULL &&
 629                                                ssl_private_key_filepath != NULL;
 630                 if (this->use_ssl)
 631                         fprintf(stderr, " Compiled with SSL support, "
 632                                                                   "using it\n");
 633                 else
 634                         fprintf(stderr, " Compiled with SSL support, "
 635                                                               "not using it\n");
 636
 637 #else
 638                 if (ssl_cert_filepath != NULL &&
 639                                              ssl_private_key_filepath != NULL) {
 640                         fprintf(stderr, " Not compiled for OpenSSl support!\n");
 641                         return NULL;
 642                 }
 643                 fprintf(stderr, " Compiled without SSL support, "
 644                                                        "serving unencrypted\n");
 645 #endif
 646         }
 647
 648         /* ignore SIGPIPE */
 649
 650         signal(SIGPIPE, sigpipe_handler);
 651
 652
 653 #ifdef LWS_OPENSSL_SUPPORT
 654
 655         /* basic openssl init */
 656
 657         SSL_library_init();
 658
 659         OpenSSL_add_all_algorithms();
 660         SSL_load_error_strings();
 661
 662         /*
 663          * Firefox insists on SSLv23 not SSLv3
 664          * Konq disables SSLv2 by default now, SSLv23 works
 665          */
 666
 667         method = (SSL_METHOD *)SSLv23_server_method();
 668         if (!method) {
 669                 fprintf(stderr, "problem creating ssl method: %s\n",
 670                         ERR_error_string(ERR_get_error(), ssl_err_buf));
 671                 return NULL;
 672         }
 673         this->ssl_ctx = SSL_CTX_new(method);    /* create context */
 674         if (!this->ssl_ctx) {
 675                 fprintf(stderr, "problem creating ssl context: %s\n",
 676                         ERR_error_string(ERR_get_error(), ssl_err_buf));
 677                 return NULL;
 678         }
 679
 680         /* client context */
 681
 682         method = (SSL_METHOD *)SSLv23_client_method();
 683         if (!method) {
 684                 fprintf(stderr, "problem creating ssl method: %s\n",
 685                         ERR_error_string(ERR_get_error(), ssl_err_buf));
 686                 return NULL;
 687         }
 688         this->ssl_client_ctx = SSL_CTX_new(method);     /* create context */
 689         if (!this->ssl_client_ctx) {
 690                 fprintf(stderr, "problem creating ssl context: %s\n",
 691                         ERR_error_string(ERR_get_error(), ssl_err_buf));
 692                 return NULL;
 693         }
 694
 695
 696         /* openssl init for cert verification (used with client sockets) */
 697
 698         if (!SSL_CTX_load_verify_locations(this->ssl_client_ctx, NULL,
 699                                                     LWS_OPENSSL_CLIENT_CERTS)) {
 700                 fprintf(stderr, "Unable to load SSL Client certs from %s "
 701                         "(set by --with-client-cert-dir= in configure) -- "
 702                         " client ssl isn't going to work",
 703                                                       LWS_OPENSSL_CLIENT_CERTS);
 704         }
 705
 706         if (this->use_ssl) {
 707
 708                 /* openssl init for server sockets */
 709
 710                 /* set the local certificate from CertFile */
 711                 n = SSL_CTX_use_certificate_file(this->ssl_ctx,
 712                                         ssl_cert_filepath, SSL_FILETYPE_PEM);
 713                 if (n != 1) {
 714                         fprintf(stderr, "problem getting cert '%s': %s\n",
 715                                 ssl_cert_filepath,
 716                                 ERR_error_string(ERR_get_error(), ssl_err_buf));
 717                         return NULL;
 718                 }
 719                 /* set the private key from KeyFile */
 720                 if (SSL_CTX_use_PrivateKey_file(this->ssl_ctx,
 721                                                 ssl_private_key_filepath,
 722                                                        SSL_FILETYPE_PEM) != 1) {
 723                         fprintf(stderr, "ssl problem getting key '%s': %s\n",
 724                                                 ssl_private_key_filepath,
 725                                 ERR_error_string(ERR_get_error(), ssl_err_buf));
 726                         return NULL;
 727                 }
 728                 /* verify private key */
 729                 if (!SSL_CTX_check_private_key(this->ssl_ctx)) {
 730                         fprintf(stderr, "Private SSL key doesn't match cert\n");
 731                         return NULL;
 732                 }
 733
 734                 /* SSL is happy and has a cert it's content with */
 735         }
 736 #endif
 737
 738         /* selftest */
 739
 740         if (lws_b64_selftest())
 741                 return NULL;
 742
 743         /* set up our external listening socket we serve on */
 744
 745         if (port) {
 746
 747                 sockfd = socket(AF_INET, SOCK_STREAM, 0);
 748                 if (sockfd < 0) {
 749                         fprintf(stderr, "ERROR opening socket");
 750                         return NULL;
 751                 }
 752
 753                 /* allow us to restart even if old sockets in TIME_WAIT */
 754                 setsockopt(sockfd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));
 755
 756                 bzero((char *) &serv_addr, sizeof(serv_addr));
 757                 serv_addr.sin_family = AF_INET;
 758                 serv_addr.sin_addr.s_addr = INADDR_ANY;
 759                 serv_addr.sin_port = htons(port);
 760
 761                 n = bind(sockfd, (struct sockaddr *) &serv_addr,
 762                                                              sizeof(serv_addr));
 763                 if (n < 0) {
 764                         fprintf(stderr, "ERROR on binding to port %d (%d %d)\n",
 765                                                                 port, n, errno);
 766                         return NULL;
 767                 }
 768         }
 769
 770         /* drop any root privs for this process */
 771
 772         if (gid != -1)
 773                 if (setgid(gid))
 774                         fprintf(stderr, "setgid: %s\n", strerror(errno));
 775         if (uid != -1)
 776                 if (setuid(uid))
 777                         fprintf(stderr, "setuid: %s\n", strerror(errno));
 778
 779         /*
 780          * prepare the poll() fd array... it's like this
 781          *
 782          * [0] = external listening socket
 783          * [1 .. this->count_protocols] = per-protocol broadcast sockets
 784          * [this->count_protocols + 1 ... this->fds_count-1] = connection skts
 785          */
 786
 787         this->fds_count = 1;
 788         this->fds[0].fd = sockfd;
 789         this->fds[0].events = POLLIN;
 790         this->count_protocols = 0;
 791
 792         if (port) {
 793                 listen(sockfd, 5);
 794                 fprintf(stderr, " Listening on port %d\n", port);
 795         }
 796
 797         /* set up our internal broadcast trigger sockets per-protocol */
 798
 799         for (; protocols[this->count_protocols].callback;
 800                                                       this->count_protocols++) {
 801                 protocols[this->count_protocols].owning_server = this;
 802                 protocols[this->count_protocols].protocol_index =
 803                                                           this->count_protocols;
 804
 805                 fd = socket(AF_INET, SOCK_STREAM, 0);
 806                 if (fd < 0) {
 807                         fprintf(stderr, "ERROR opening socket");
 808                         return NULL;
 809                 }
 810
 811                 /* allow us to restart even if old sockets in TIME_WAIT */
 812                 setsockopt(fd, SOL_SOCKET, SO_REUSEADDR, &opt, sizeof(opt));
 813
 814                 bzero((char *) &serv_addr, sizeof(serv_addr));
 815                 serv_addr.sin_family = AF_INET;
 816                 serv_addr.sin_addr.s_addr = inet_addr("127.0.0.1");
 817                 serv_addr.sin_port = 0; /* pick the port for us */
 818
 819                 n = bind(fd, (struct sockaddr *) &serv_addr, sizeof(serv_addr));
 820                 if (n < 0) {
 821                         fprintf(stderr, "ERROR on binding to port %d (%d %d)\n",
 822                                                                 port, n, errno);
 823                         return NULL;
 824                 }
 825
 826                 slen = sizeof cli_addr;
 827                 n = getsockname(fd, (struct sockaddr *)&cli_addr, &slen);
 828                 if (n < 0) {
 829                         fprintf(stderr, "getsockname failed\n");
 830                         return NULL;
 831                 }
 832                 protocols[this->count_protocols].broadcast_socket_port =
 833                                                        ntohs(cli_addr.sin_port);
 834                 listen(fd, 5);
 835
 836                 debug("  Protocol %s broadcast socket %d\n",
 837                                 protocols[this->count_protocols].name,
 838                                                       ntohs(cli_addr.sin_port));
 839
 840                 this->fds[this->fds_count].fd = fd;
 841                 this->fds[this->fds_count].events = POLLIN;
 842                 /* wsi only exists for connections, not broadcast listener */
 843                 this->wsi[this->fds_count] = NULL;
 844                 this->fds_count++;
 845         }
 846
 847         return this;
 848 }
 849
 850
 851 #ifndef LWS_NO_FORK
 852
 853 /**
 854  * libwebsockets_fork_service_loop() - Optional helper function forks off
 855  *                                a process for the websocket server loop.
 856  *                              You don't have to use this but if not, you
 857  *                              have to make sure you are calling
 858  *                              libwebsocket_service periodically to service
 859  *                              the websocket traffic
 860  * @this:       server context returned by creation function
 861  */
 862
 863 int
 864 libwebsockets_fork_service_loop(struct libwebsocket_context *this)
 865 {
 866         int client;
 867         int fd;
 868         struct sockaddr_in cli_addr;
 869         int n;
 870
 871         n = fork();
 872         if (n < 0)
 873                 return n;
 874
 875         if (!n) {
 876
 877                 /* main process context */
 878
 879                 for (client = 1; client < this->count_protocols + 1; client++) {
 880                         fd = socket(AF_INET, SOCK_STREAM, 0);
 881                         if (fd < 0) {
 882                                 fprintf(stderr, "Unable to create socket\n");
 883                                 return -1;
 884                         }
 885                         cli_addr.sin_family = AF_INET;
 886                         cli_addr.sin_port = htons(
 887                              this->protocols[client - 1].broadcast_socket_port);
 888                         cli_addr.sin_addr.s_addr = inet_addr("127.0.0.1");
 889                         n = connect(fd, (struct sockaddr *)&cli_addr,
 890                                                                sizeof cli_addr);
 891                         if (n < 0) {
 892                                 fprintf(stderr, "Unable to connect to "
 893                                                 "broadcast socket %d, %s\n",
 894                                                 client, strerror(errno));
 895                                 return -1;
 896                         }
 897
 898                         this->protocols[client - 1].broadcast_socket_user_fd =
 899                                                                              fd;
 900                 }
 901
 902
 903                 return 0;
 904         }
 905
 906         /* we want a SIGHUP when our parent goes down */
 907         prctl(PR_SET_PDEATHSIG, SIGHUP);
 908
 909         /* in this forked process, sit and service websocket connections */
 910
 911         while (1)
 912                 if (libwebsocket_service(this, 1000))
 913                         return -1;
 914
 915         return 0;
 916 }
 917
 918 #endif
 919
 920 /**
 921  * libwebsockets_get_protocol() - Returns a protocol pointer from a websocket
 922  *                                connection.
 923  * @wsi:        pointer to struct websocket you want to know the protocol of
 924  *
 925  *
 926  *      This is useful to get the protocol to broadcast back to from inside
 927  * the callback.
 928  */
 929
 930 const struct libwebsocket_protocols *
 931 libwebsockets_get_protocol(struct libwebsocket *wsi)
 932 {
 933         return wsi->protocol;
 934 }
 935
 936 /**
 937  * libwebsockets_broadcast() - Sends a buffer to the callback for all active
 938  *                                connections of the given protocol.
 939  * @protocol:   pointer to the protocol you will broadcast to all members of
 940  * @buf:  buffer containing the data to be broadcase.  NOTE: this has to be
 941  *              allocated with LWS_SEND_BUFFER_PRE_PADDING valid bytes before
 942  *              the pointer and LWS_SEND_BUFFER_POST_PADDING afterwards in the
 943  *              case you are calling this function from callback context.
 944  * @len:        length of payload data in buf, starting from buf.
 945  *
 946  *      This function allows bulk sending of a packet to every connection using
 947  * the given protocol.  It does not send the data directly; instead it calls
 948  * the callback with a reason type of LWS_CALLBACK_BROADCAST.  If the callback
 949  * wants to actually send the data for that connection, the callback itself
 950  * should call libwebsocket_write().
 951  *
 952  * libwebsockets_broadcast() can be called from another fork context without
 953  * having to take any care about data visibility between the processes, it'll
 954  * "just work".
 955  */
 956
 957
 958 int
 959 libwebsockets_broadcast(const struct libwebsocket_protocols *protocol,
 960                                                  unsigned char *buf, size_t len)
 961 {
 962         struct libwebsocket_context *this = protocol->owning_server;
 963         int n;
 964
 965         if (!protocol->broadcast_socket_user_fd) {
 966                 /*
 967                  * We are either running unforked / flat, or we are being
 968                  * called from poll thread context
 969                  * eg, from a callback.  In that case don't use sockets for
 970                  * broadcast IPC (since we can't open a socket connection to
 971                  * a socket listening on our own thread) but directly do the
 972                  * send action.
 973                  *
 974                  * Locking is not needed because we are by definition being
 975                  * called in the poll thread context and are serialized.
 976                  */
 977
 978                 for (n = this->count_protocols + 1; n < this->fds_count; n++) {
 979
 980                         if ((unsigned long)this->wsi[n] < LWS_MAX_PROTOCOLS)
 981                                 continue;
 982
 983                         /* never broadcast to non-established connection */
 984                         if (this->wsi[n]->state != WSI_STATE_ESTABLISHED)
 985                                 continue;
 986
 987                         /* only broadcast to guys using requested protocol */
 988                         if (this->wsi[n]->protocol != protocol)
 989                                 continue;
 990
 991                         this->wsi[n]->protocol->callback(this->wsi[n],
 992                                          LWS_CALLBACK_BROADCAST,
 993                                          this->wsi[n]->user_space,
 994                                          buf, len);
 995                 }
 996
 997                 return 0;
 998         }
 999
1000         /*
1001          * We're being called from a different process context than the server
1002          * loop.  Instead of broadcasting directly, we send our
1003          * payload on a socket to do the IPC; the server process will serialize
1004          * the broadcast action in its main poll() loop.
1005          *
1006          * There's one broadcast socket listening for each protocol supported
1007          * set up when the websocket server initializes
1008          */
1009
1010         n = send(protocol->broadcast_socket_user_fd, buf, len, MSG_NOSIGNAL);
1011
1012         return n;
1013 }