transport_websocket.c File Reference

#include "asterisk.h"
#include "asterisk/http_websocket.h"
#include "asterisk/utils.h"
#include "logger.h"
#include "transport.h"
#include "transport_websocket.h"

Include dependency graph for transport_websocket.c:

Go to the source code of this file.

Data Structures
struct	aeap_transport_websocket

Macros
#define	log_error(obj, fmt, ...)   aeap_error(obj, "websocket", fmt, ##__VA_ARGS__)

Functions
struct aeap_transport_websocket *	aeap_transport_websocket_create (void)
	Creates (heap allocated), and initializes a transport websocket.
static int	transport_websocket_init (struct aeap_transport_websocket *transport)
	Initialize a transport websocket object, and set its virtual table.
static struct aeap_transport_vtable *	transport_websocket_vtable (void)
static int	websocket_connect (struct aeap_transport *self, const char *url, const char *protocol, int timeout)
static void	websocket_destroy (struct aeap_transport *self)
static int	websocket_disconnect (struct aeap_transport *self)
static intmax_t	websocket_read (struct aeap_transport *self, void *buf, intmax_t size, enum AST_AEAP_DATA_TYPE *rtype)
static intmax_t	websocket_write (struct aeap_transport *self, const void *buf, intmax_t size, enum AST_AEAP_DATA_TYPE wtype)

Macro Definition Documentation

log_error

#define log_error	(		obj,
			fmt,
			...
	)		aeap_error(obj, "websocket", fmt, ##__VA_ARGS__)

Definition at line 28 of file transport_websocket.c.

Function Documentation

aeap_transport_websocket_create()

struct aeap_transport_websocket * aeap_transport_websocket_create

(

void

)

Creates (heap allocated), and initializes a transport websocket.

Returns

A transport websocket object, or NULL on error

Definition at line 238 of file transport_websocket.c.

{
    struct aeap_transport_websocket *transport;
 
    transport = ast_calloc(1, sizeof(*transport));
    if (!transport) {
        ast_log(LOG_ERROR, "AEAP websocket: unable to create transport websocket");
        return NULL;
    }
 
    if (transport_websocket_init(transport)) {
        ast_free(transport);
        return NULL;
    }
 
    return transport;
}

References ast_calloc, ast_free, ast_log, LOG_ERROR, NULL, and transport_websocket_init().

Referenced by aeap_transport_create().

transport_websocket_init()

static int transport_websocket_init ( struct aeap_transport_websocket *  transport )

static

Initialize a transport websocket object, and set its virtual table.

Parameters

transport

The transport to initialize

Returns

0 on success, -1 on error

Definition at line 229 of file transport_websocket.c.

{
    transport->ws = NULL;
 
    ((struct aeap_transport *)transport)->vtable = transport_websocket_vtable();
 
    return 0;
}

References NULL, transport_websocket_vtable(), and aeap_transport_websocket::ws.

Referenced by aeap_transport_websocket_create().

transport_websocket_vtable()

static struct aeap_transport_vtable * transport_websocket_vtable ( void  )

static

Definition at line 209 of file transport_websocket.c.

{
    static struct aeap_transport_vtable websocket_vtable = {
        .connect = websocket_connect,
        .disconnect = websocket_disconnect,
        .destroy = websocket_destroy,
        .read = websocket_read,
        .write = websocket_write,
    };
 
    return &websocket_vtable;
}

References aeap_transport_vtable::connect, websocket_connect(), websocket_destroy(), websocket_disconnect(), websocket_read(), and websocket_write().

Referenced by transport_websocket_init().

websocket_connect()

static int websocket_connect ( struct aeap_transport *  self, const char *  url, const char *  protocol, int  timeout  )

static

Definition at line 37 of file transport_websocket.c.

{
    struct aeap_transport_websocket *transport = (struct aeap_transport_websocket *)self;
    enum ast_websocket_result ws_result;
    struct ast_websocket_client_options ws_options = {
        .uri = url,
        .protocols = protocol,
        .timeout = timeout,
        .tls_cfg = NULL,
    };
 
    transport->ws = ast_websocket_client_create_with_options(&ws_options, &ws_result);
    if (ws_result != WS_OK) {
        log_error(self, "connect failure (%d)", (int)ws_result);
        return -1;
    }
 
    return 0;
}

References ast_websocket_client_create_with_options(), log_error, NULL, ast_websocket_client_options::timeout, ast_websocket_client_options::uri, url, aeap_transport_websocket::ws, and WS_OK.

Referenced by transport_websocket_vtable().

websocket_destroy()

static void websocket_destroy ( struct aeap_transport *  self )

static

Definition at line 70 of file transport_websocket.c.

{
    /*
     * Disconnect takes care of cleaning up the websocket. Note, disconnect
     * was called by the base/dispatch interface prior to calling this
     * function so nothing to do here.
     */
}

Referenced by transport_websocket_vtable().

websocket_disconnect()

static int websocket_disconnect ( struct aeap_transport *  self )

static

Definition at line 58 of file transport_websocket.c.

{
    struct aeap_transport_websocket *transport = (struct aeap_transport_websocket *)self;
 
    if (transport->ws) {
        ast_websocket_unref(transport->ws);
        transport->ws = NULL;
    }
 
    return 0;
}

References ast_websocket_unref(), NULL, and aeap_transport_websocket::ws.

Referenced by transport_websocket_vtable().

websocket_read()

static intmax_t websocket_read ( struct aeap_transport *  self, void *  buf, intmax_t  size, enum AST_AEAP_DATA_TYPE *  rtype  )

static

Definition at line 79 of file transport_websocket.c.

{
    struct aeap_transport_websocket *transport = (struct aeap_transport_websocket *)self;
 
    char *payload;
    uint64_t bytes_read = 0;
    uint64_t total_bytes_read = 0;
    enum ast_websocket_opcode opcode;
    int fragmented = 0;
 
    *rtype = AST_AEAP_DATA_TYPE_NONE;
 
    if (ast_websocket_fd(transport->ws) < 0) {
        log_error(self, "unavailable for reading");
        /* Ensure this transport is in a disconnected state */
        aeap_transport_disconnect(self);
        return -1;
    }
 
    /*
     * This function is called with the read_lock locked. However, the lock needs to be
     * unlocked while waiting for input otherwise a deadlock can occur during disconnect
     * (disconnect attempts to grab the lock but can't because read holds it here). So
     * unlock it prior to waiting.
     */
    ast_mutex_unlock(&transport->base.read_lock);
    while (ast_websocket_wait_for_input(transport->ws, -1) <= 0) {
        /* If this was poll getting interrupted just go back to waiting */
        if (errno == EINTR || errno == EAGAIN) {
            continue;
        }
 
        ast_mutex_lock(&transport->base.read_lock);
        log_error(self, "poll failure: %s", strerror(errno));
        /* Ensure this transport is in a disconnected state */
        aeap_transport_disconnect(self);
        return -1;
    }
    ast_mutex_lock(&transport->base.read_lock);
 
    if (!transport->ws) {
        /*
         * It's possible the transport was told to disconnect while waiting for input.
         * If so then the websocket will be NULL, so we don't want to continue.
         */
        return 0;
    }
 
    do {
        if (ast_websocket_read(transport->ws, &payload, &bytes_read, &opcode,
                &fragmented) != 0) {
            log_error(self, "read failure (%d): %s", opcode, strerror(errno));
            return -1;
        }
 
        if (!bytes_read) {
            continue;
        }
 
        if (total_bytes_read + bytes_read > size) {
            log_error(self, "attempted to read too many bytes into (%jd) sized buffer", size);
            return -1;
        }
 
        memcpy(buf + total_bytes_read, payload, bytes_read);
        total_bytes_read += bytes_read;
 
    } while (opcode == AST_WEBSOCKET_OPCODE_CONTINUATION);
 
    switch (opcode) {
    case AST_WEBSOCKET_OPCODE_CLOSE:
        log_error(self, "closed");
        return -1;
    case AST_WEBSOCKET_OPCODE_BINARY:
        *rtype = AST_AEAP_DATA_TYPE_BINARY;
        break;
    case AST_WEBSOCKET_OPCODE_TEXT:
        *rtype = AST_AEAP_DATA_TYPE_STRING;
 
        /* Append terminator, but check for overflow first */
        if (total_bytes_read == size) {
            log_error(self, "unable to write string terminator");
            return -1;
        }
 
        *((char *)(buf + total_bytes_read)) = '\0';
        break;
    default:
        /* Ignore all other message types */
        return 0;
    }
 
    return total_bytes_read;
}

References aeap_transport_disconnect(), AST_AEAP_DATA_TYPE_BINARY, AST_AEAP_DATA_TYPE_NONE, AST_AEAP_DATA_TYPE_STRING, ast_mutex_lock, ast_mutex_unlock, ast_websocket_fd(), AST_WEBSOCKET_OPCODE_BINARY, AST_WEBSOCKET_OPCODE_CLOSE, AST_WEBSOCKET_OPCODE_CONTINUATION, AST_WEBSOCKET_OPCODE_TEXT, ast_websocket_read(), ast_websocket_wait_for_input(), aeap_transport_websocket::base, buf, errno, log_error, aeap_transport::read_lock, and aeap_transport_websocket::ws.

Referenced by transport_websocket_vtable().

websocket_write()

static intmax_t websocket_write ( struct aeap_transport *  self, const void *  buf, intmax_t  size, enum AST_AEAP_DATA_TYPE  wtype  )

static

Definition at line 175 of file transport_websocket.c.

{
    struct aeap_transport_websocket *transport = (struct aeap_transport_websocket *)self;
    intmax_t res = 0;
 
    switch (wtype) {
    case AST_AEAP_DATA_TYPE_BINARY:
        res = ast_websocket_write(transport->ws, AST_WEBSOCKET_OPCODE_BINARY,
            (char *)buf, size);
        break;
    case AST_AEAP_DATA_TYPE_STRING:
        res = ast_websocket_write(transport->ws, AST_WEBSOCKET_OPCODE_TEXT,
            (char *)buf, size);
        break;
    default:
        break;
    }
 
    if (res < 0) {
        log_error(self, "problem writing to websocket (closed)");
 
        /*
         * If the underlying socket is closed then ensure the
         * transport is in a disconnected state as well.
         */
        aeap_transport_disconnect(self);
 
        return res;
    }
 
    return size;
}

References aeap_transport_disconnect(), AST_AEAP_DATA_TYPE_BINARY, AST_AEAP_DATA_TYPE_STRING, AST_WEBSOCKET_OPCODE_BINARY, AST_WEBSOCKET_OPCODE_TEXT, ast_websocket_write(), buf, log_error, and aeap_transport_websocket::ws.

Referenced by transport_websocket_vtable().