uri.c File Reference

#include "asterisk.h"
#include "asterisk/astobj2.h"
#include "asterisk/strings.h"
#include "asterisk/uri.h"

Include dependency graph for uri.c:

Go to the source code of this file.

Data Structures
struct	ast_uri
	Stores parsed uri information. More...

Macros
#define	SET_VALUE(param, field, size)
#define	SET_VALUES(value)

Functions
struct ast_uri *	ast_uri_copy_replace (const struct ast_uri *uri, const char *scheme, const char *user_info, const char *host, const char *port, const char *path, const char *query)
	Copy the given uri replacing any value in the new uri with any given.
struct ast_uri *	ast_uri_create (const char *scheme, const char *user_info, const char *host, const char *port, const char *path, const char *query)
	Create a uri with the given parameters.
static struct ast_uri *	ast_uri_create_ (const char *scheme, unsigned int scheme_size, const char *user_info, unsigned int user_info_size, const char *host, unsigned int host_size, const char *port, unsigned int port_size, const char *path, unsigned int path_size, const char *query, unsigned int query_size)
	Construct a uri object with the given values.
const char *	ast_uri_host (const struct ast_uri *uri)
	Retrieve the uri host.
int	ast_uri_is_secure (const struct ast_uri *uri)
	Retrieve if the uri is of a secure type.
char *	ast_uri_make_host_with_port (const struct ast_uri *uri)
	Retrieve a string of the host and port.
struct ast_uri *	ast_uri_parse (const char *uri)
	Parse the given uri into a structure.
struct ast_uri *	ast_uri_parse_http (const char *uri)
	Parse the given http uri into a structure.
struct ast_uri *	ast_uri_parse_websocket (const char *uri)
	Parse the given websocket uri into a structure.
const char *	ast_uri_path (const struct ast_uri *uri)
	Retrieve the uri path.
const char *	ast_uri_port (const struct ast_uri *uri)
	Retrieve the uri port.
const char *	ast_uri_query (const struct ast_uri *uri)
	Retrieve the uri query parameters.
const char *	ast_uri_scheme (const struct ast_uri *uri)
	Retrieve the uri scheme.
const char *	ast_uri_user_info (const struct ast_uri *uri)
	Retrieve the uri user information.
static struct ast_uri *	uri_parse_and_default (const char *uri, const char *scheme, const char *port, const char *secure_port)

Macro Definition Documentation

SET_VALUE

#define SET_VALUE	(		param,
			field,
			size
	)

Value:

    do { if (param) { \
         ast_copy_string(p, param, size); \
         field = p; \
         p += size; } } while (0)

SET_VALUES

#define SET_VALUES

(

value

)

Value:

    value = uri; \
    size_##value = p - uri + 1; \
    uri = p + 1;

Function Documentation

ast_uri_copy_replace()

struct ast_uri * ast_uri_copy_replace	(	const struct ast_uri *	uri,
		const char *	scheme,
		const char *	user_info,
		const char *	host,
		const char *	port,
		const char *	path,
		const char *	query
	)

Copy the given uri replacing any value in the new uri with any given.

Parameters

uri	the uri object to copy
scheme	the uri scheme (ex: http)
user_info	user credentials (ex: <name>@<pass>)
host	host name or ip address
port	the port
path	the path
query	query parameters

Returns

a copy of the given uri with specified values replaced.

Return values

NULL

on error

Since

13

Definition at line 101 of file uri.c.

{
    return ast_uri_create(
        scheme ? scheme : uri->scheme,
        user_info ? user_info : uri->user_info,
        host ? host : uri->host,
        port ? port : uri->port,
        path ? path : uri->path,
        query ? query : uri->query);
}

References ast_uri_create(), ast_uri::host, ast_uri::path, ast_uri::port, ast_uri::query, ast_uri::scheme, ast_uri::uri, and ast_uri::user_info.

Referenced by uri_parse_and_default().

ast_uri_create()

struct ast_uri * ast_uri_create	(	const char *	scheme,
		const char *	user_info,
		const char *	host,
		const char *	port,
		const char *	path,
		const char *	query
	)

Create a uri with the given parameters.

Parameters

scheme	the uri scheme (ex: http)
user_info	user credentials (ex: <name>@<pass>)
host	host name or ip address
port	the port
path	the path
query	query parameters

Returns

a structure containing parsed uri data.

Return values

NULL

on error

Since

13

Definition at line 88 of file uri.c.

{
    return ast_uri_create_(
        scheme, scheme ? strlen(scheme) + 1 : 0,
        user_info, user_info ? strlen(user_info) + 1 : 0,
        host, host ? strlen(host) + 1 : 0,
        port, port ? strlen(port) + 1 : 0,
        path, path ? strlen(path) + 1 : 0,
        query, query ? strlen(query) + 1 : 0);
}

References ast_uri_create_(), ast_uri::host, ast_uri::path, ast_uri::port, ast_uri::query, ast_uri::scheme, and ast_uri::user_info.

Referenced by ast_uri_copy_replace().

ast_uri_create_()

static struct ast_uri * ast_uri_create_ ( const char *  scheme, unsigned int  scheme_size, const char *  user_info, unsigned int  user_info_size, const char *  host, unsigned int  host_size, const char *  port, unsigned int  port_size, const char *  path, unsigned int  path_size, const char *  query, unsigned int  query_size  )

static

Construct a uri object with the given values.

Note

The size parameters [should] include room for the string terminator (strlen(<param>) + 1). For instance, if a scheme of 'http' is given then the 'scheme_size' should be equal to 5.

Definition at line 54 of file uri.c.

{
#define SET_VALUE(param, field, size) \
    do { if (param) { \
         ast_copy_string(p, param, size); \
         field = p; \
         p += size; } } while (0)
 
    char *p;
    struct ast_uri *res = ao2_alloc(
        sizeof(*res) + scheme_size + user_info_size + host_size +
        port_size + path_size + query_size, NULL);
 
    if (!res) {
        ast_log(LOG_ERROR, "Unable to create URI object\n");
        return NULL;
    }
 
    p = res->uri;
    SET_VALUE(scheme, res->scheme, scheme_size);
    SET_VALUE(user_info, res->user_info, user_info_size);
    SET_VALUE(host, res->host, host_size);
    SET_VALUE(port, res->port, port_size);
    SET_VALUE(path, res->path, path_size);
    SET_VALUE(query, res->query, query_size);
    return res;
}

References ao2_alloc, ast_log, ast_uri::host, LOG_ERROR, NULL, ast_uri::path, ast_uri::port, ast_uri::query, ast_uri::scheme, SET_VALUE, ast_uri::uri, and ast_uri::user_info.

Referenced by ast_uri_create(), and ast_uri_parse().

ast_uri_host()

const char * ast_uri_host

(

const struct ast_uri *

uri

)

Retrieve the uri host.

Returns

the uri host.

Since

13

Definition at line 125 of file uri.c.

{
    return uri->host;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), and ast_uri_make_host_with_port().

ast_uri_is_secure()

int ast_uri_is_secure

(

const struct ast_uri *

uri

)

Retrieve if the uri is of a secure type.

Note

Secure types are recognized by an 's' at the end of the scheme.

Return values

True	if secure.
False	otherwise.

Since

13

Definition at line 145 of file uri.c.

{
    return ast_strlen_zero(uri->scheme) ? 0 :
        *(uri->scheme + strlen(uri->scheme) - 1) == 's';
}

References ast_strlen_zero(), and ast_uri::uri.

Referenced by AST_TEST_DEFINE(), AST_TEST_DEFINE(), and uri_parse_and_default().

ast_uri_make_host_with_port()

char * ast_uri_make_host_with_port

(

const struct ast_uri *

uri

)

Retrieve a string of the host and port.

Combine the host and port (<host>:<port>) if the port is available, otherwise just return the host.

Note

Caller is responsible for release the returned string.

Parameters

uri	the uri object

Returns

a string value of the host and optional port.

Since

13

Definition at line 300 of file uri.c.

{
    char *res;
 
    if (ast_asprintf(&res, "%s%s%s",
            ast_uri_host(uri) ?: "",
            ast_uri_port(uri) ? ":" : "",
            ast_uri_port(uri) ?: "") == -1) {
        return NULL;
    }
 
    return res;
}

References ast_asprintf, ast_uri_host(), ast_uri_port(), NULL, and ast_uri::uri.

Referenced by websocket_client_parse_uri().

ast_uri_parse()

struct ast_uri * ast_uri_parse

(

const char *

uri

)

Parse the given uri into a structure.

Note

Expects the following form:

<scheme>://[user:pass@]<host>[:port][/<path>] 

Parameters

uri	a string uri to parse

Returns

a structure containing parsed uri data.

Return values

NULL

on error

Since

13

Definition at line 195 of file uri.c.

{
#define SET_VALUES(value) \
    value = uri; \
    size_##value = p - uri + 1; \
    uri = p + 1;
 
    const char *p, *scheme = NULL, *user_info = NULL, *host = NULL;
    const char *port = NULL, *path = NULL, *query = NULL;
    unsigned int size_scheme = 0, size_user_info = 0, size_host = 0;
    unsigned int size_port = 0, size_path = 0, size_query = 0;
 
    if ((p = strstr(uri, "://"))) {
        scheme = uri;
        size_scheme = p - uri + 1;
        uri = p + 3;
    }
 
    if ((p = strchr(uri, '@'))) {
        SET_VALUES(user_info);
    }
 
    if ((p = strchr(uri, ':'))) {
        SET_VALUES(host);
    }
 
    if ((p = strchr(uri, '/'))) {
        if (!host) {
            SET_VALUES(host);
        } else {
            SET_VALUES(port);
        }
    }
 
    if ((p = strchr(uri, '?'))) {
        query = p + 1;
        size_query = strlen(query) + 1;
    } else {
        p = uri + strlen(uri);
    }
 
    if (!host) {
        SET_VALUES(host);
    } else if (*(uri - 1) == ':') {
        SET_VALUES(port);
    } else if (*(uri - 1) == '/') {
        SET_VALUES(path);
    }
 
    return ast_uri_create_(scheme, size_scheme,
                   user_info, size_user_info,
                   host, size_host,
                   port, size_port,
                   path, size_path,
                   query, size_query);
}

References ast_uri_create_(), ast_uri::host, NULL, ast_uri::path, ast_uri::port, ast_uri::query, ast_uri::scheme, SET_VALUES, ast_uri::uri, and ast_uri::user_info.

Referenced by AST_TEST_DEFINE(), file_extension_from_url_path(), and uri_parse_and_default().

ast_uri_parse_http()

struct ast_uri * ast_uri_parse_http

(

const char *

uri

)

Parse the given http uri into a structure.

Note

Expects the following form:

[http[s]://][user:pass@]<host>[:port][/<path>] 

If no scheme is given it defaults to 'http' and if no port is specified it will default to 443 if marked secure, otherwise to 80.

Parameters

uri	an http string uri to parse

Returns

a structure containing parsed http uri data.

Return values

NULL

on error

Since

13

Definition at line 290 of file uri.c.

{
    return uri_parse_and_default(uri, "http", "80", "443");
}

References ast_uri::uri, and uri_parse_and_default().

Referenced by AST_TEST_DEFINE(), and AST_TEST_DEFINE().

ast_uri_parse_websocket()

struct ast_uri * ast_uri_parse_websocket

(

const char *

uri

)

Parse the given websocket uri into a structure.

Note

Expects the following form:

If no scheme is given it defaults to 'ws' and if no port is specified it will default to 443 if marked secure, otherwise to 80.

Parameters

uri	a websocket string uri to parse

Returns

a structure containing parsed http uri data.

Return values

NULL

on error

Since

13

Definition at line 295 of file uri.c.

{
    return uri_parse_and_default(uri, "ws", "80", "443");
}

References ast_uri::uri, and uri_parse_and_default().

Referenced by websocket_client_parse_uri().

ast_uri_path()

const char * ast_uri_path

(

const struct ast_uri *

uri

)

Retrieve the uri path.

Returns

the uri path.

Since

13

Definition at line 135 of file uri.c.

{
    return uri->path;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), file_extension_from_url_path(), and websocket_client_parse_uri().

ast_uri_port()

const char * ast_uri_port

(

const struct ast_uri *

uri

)

Retrieve the uri port.

Returns

the uri port.

Since

13

Definition at line 130 of file uri.c.

{
    return uri->port;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), ast_uri_make_host_with_port(), and uri_parse_and_default().

ast_uri_query()

const char * ast_uri_query

(

const struct ast_uri *

uri

)

Retrieve the uri query parameters.

Returns

the uri query parameters.

Since

13

Definition at line 140 of file uri.c.

{
    return uri->query;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), and websocket_client_parse_uri().

ast_uri_scheme()

const char * ast_uri_scheme

(

const struct ast_uri *

uri

)

Retrieve the uri scheme.

Returns

the uri scheme.

Since

13

Definition at line 115 of file uri.c.

{
    return uri->scheme;
}

References ast_uri::scheme, and ast_uri::uri.

Referenced by AST_TEST_DEFINE(), AST_TEST_DEFINE(), and AST_TEST_DEFINE().

ast_uri_user_info()

const char * ast_uri_user_info

(

const struct ast_uri *

uri

)

Retrieve the uri user information.

Returns

the uri user information.

Since

13

Definition at line 120 of file uri.c.

{
    return uri->user_info;
}

References ast_uri::uri.

Referenced by AST_TEST_DEFINE(), and websocket_client_parse_uri().

uri_parse_and_default()

static struct ast_uri * uri_parse_and_default ( const char *  uri, const char *  scheme, const char *  port, const char *  secure_port  )

static

Definition at line 253 of file uri.c.

{
    struct ast_uri *res;
    int len = strlen(scheme);
 
    if (!strncmp(uri, scheme, len)) {
        res = ast_uri_parse(uri);
    } else {
        /* make room for <scheme>:// */
        char *with_scheme = ast_malloc(len + strlen(uri) + 4);
        if (!with_scheme) {
            ast_log(LOG_ERROR, "Unable to allocate uri '%s' with "
                "scheme '%s'", uri, scheme);
            return NULL;
        }
 
        /* safe - 'with_scheme' created with size equal to len of
           scheme plus length of uri plus space for extra characters
           '://' and terminator */
        sprintf(with_scheme, "%s://%s", scheme, uri);
        res = ast_uri_parse(with_scheme);
        ast_free(with_scheme);
    }
 
    if (res && ast_strlen_zero(ast_uri_port(res))) {
        /* default the port if not given */
        struct ast_uri *tmp = ast_uri_copy_replace(
            res, NULL, NULL, NULL,
            ast_uri_is_secure(res) ? secure_port : port,
            NULL, NULL);
        ao2_ref(res, -1);
        res = tmp;
    }
    return res;
}

References ao2_ref, ast_free, ast_log, ast_malloc, ast_strlen_zero(), ast_uri_copy_replace(), ast_uri_is_secure(), ast_uri_parse(), ast_uri_port(), len(), LOG_ERROR, NULL, ast_uri::port, ast_uri::scheme, and ast_uri::uri.

Referenced by ast_uri_parse_http(), and ast_uri_parse_websocket().