endpoints.c File Reference

Asterisk endpoint API. More...

#include "asterisk.h"
#include "asterisk/astobj2.h"
#include "asterisk/endpoints.h"
#include "asterisk/stasis.h"
#include "asterisk/stasis_channels.h"
#include "asterisk/stasis_endpoints.h"
#include "asterisk/stringfields.h"
#include "asterisk/_private.h"

Include dependency graph for main/endpoints.c:

Go to the source code of this file.

Data Structures
struct	ast_endpoint

Macros
#define	ENDPOINT_BUCKETS   127
#define	ENDPOINT_CHANNEL_BUCKETS   127
#define	TECH_ENDPOINT_BUCKETS   11

Functions
int	ast_endpoint_add_channel (struct ast_endpoint *endpoint, struct ast_channel *chan)
	Adds a channel to the given endpoint.
struct ast_endpoint *	ast_endpoint_create (const char *tech, const char *resource)
	Create an endpoint struct.
struct ast_endpoint *	ast_endpoint_find_by_id (const char *id)
	Finds the endpoint with the given tech[/resource] id.
const char *	ast_endpoint_get_id (const struct ast_endpoint *endpoint)
	Gets the tech/resource id of the given endpoint.
const char *	ast_endpoint_get_resource (const struct ast_endpoint *endpoint)
	Gets the resource name of the given endpoint.
struct ast_endpoint_snapshot *	ast_endpoint_get_snapshot (struct ast_endpoint *endpoint)
	Gets the latest snapshot of the given endpoint.
enum ast_endpoint_state	ast_endpoint_get_state (const struct ast_endpoint *endpoint)
	Gets the state of the given endpoint.
const char *	ast_endpoint_get_tech (const struct ast_endpoint *endpoint)
	Gets the technology of the given endpoint.
int	ast_endpoint_init (void)
	Endpoint support initialization.
int	ast_endpoint_remove_channel (struct ast_endpoint *endpoint, struct ast_channel *chan)
	Removes a channel from the given endpoint.
void	ast_endpoint_set_max_channels (struct ast_endpoint *endpoint, int max_channels)
	Updates the maximum number of channels an endpoint supports.
void	ast_endpoint_set_state (struct ast_endpoint *endpoint, enum ast_endpoint_state state)
	Updates the state of the given endpoint.
void	ast_endpoint_shutdown (struct ast_endpoint *endpoint)
	Shutsdown an ast_endpoint.
struct ast_endpoint_snapshot *	ast_endpoint_snapshot_create (struct ast_endpoint *endpoint)
	Create a snapshot of an endpoint.
const char *	ast_endpoint_state_to_string (enum ast_endpoint_state state)
	Returns a string representation of the given endpoint state.
struct stasis_topic *	ast_endpoint_topic (struct ast_endpoint *endpoint)
	Returns the topic for a specific endpoint.
struct stasis_topic *	ast_endpoint_topic_cached (struct ast_endpoint *endpoint)
	Returns the topic for a specific endpoint.
static struct stasis_message *	create_endpoint_snapshot_message (struct ast_endpoint *endpoint)
static void	endpoint_cleanup (void)
static void	endpoint_dtor (void *obj)
static struct ast_endpoint *	endpoint_internal_create (const char *tech, const char *resource)
static void	endpoint_publish_snapshot (struct ast_endpoint *endpoint)
static void	endpoint_snapshot_dtor (void *obj)

Variables
static struct ao2_container *	endpoints
static struct ao2_container *	tech_endpoints

Detailed Description

Asterisk endpoint API.

Author

David M. Lee, II dlee@.nosp@m.digi.nosp@m.um.co.nosp@m.m

Definition in file main/endpoints.c.

Macro Definition Documentation

ENDPOINT_BUCKETS

#define ENDPOINT_BUCKETS   127

Buckets for endpoint hash. Keep it prime!

Definition at line 44 of file main/endpoints.c.

ENDPOINT_CHANNEL_BUCKETS

#define ENDPOINT_CHANNEL_BUCKETS   127

Buckets for endpoint->channel mappings. Keep it prime!

Definition at line 41 of file main/endpoints.c.

TECH_ENDPOINT_BUCKETS

#define TECH_ENDPOINT_BUCKETS   11

Buckets for technology endpoints.

Definition at line 47 of file main/endpoints.c.

Function Documentation

ast_endpoint_add_channel()

int ast_endpoint_add_channel	(	struct ast_endpoint *	endpoint,
		struct ast_channel *	chan
	)

Adds a channel to the given endpoint.

Since

12

This updates the endpoint's statistics, as well as forwarding all of the channel's messages to the endpoint's topic.

The channel is automagically removed from the endpoint when it is disposed of.

Parameters

endpoint
chan	Channel.

Return values

0	on success.
Non-zero	on error.

Definition at line 165 of file main/endpoints.c.

{
    ast_assert(chan != NULL);
    ast_assert(endpoint != NULL);
    ast_assert(!ast_strlen_zero(endpoint->resource));
 
    ast_channel_forward_endpoint(chan, endpoint);
 
    ao2_lock(endpoint);
    ast_str_container_add(endpoint->channel_ids, ast_channel_uniqueid(chan));
    ao2_unlock(endpoint);
 
    endpoint_publish_snapshot(endpoint);
 
    return 0;
}

References ao2_lock, ao2_unlock, ast_assert, ast_channel_forward_endpoint(), ast_channel_uniqueid(), ast_str_container_add(), ast_strlen_zero(), ast_endpoint::channel_ids, endpoint_publish_snapshot(), NULL, and ast_endpoint::resource.

Referenced by ast_channel_endpoint_set(), and AST_TEST_DEFINE().

ast_endpoint_create()

struct ast_endpoint * ast_endpoint_create	(	const char *	tech,
		const char *	resource
	)

Create an endpoint struct.

The endpoint is created with a state of UNKNOWN and max_channels of -1 (unlimited). While ast_endpoint is AO2 managed, you have to shut it down with ast_endpoint_shutdown() to clean up references from subscriptions.

Parameters

tech	Technology for this endpoint.
resource	Name of this endpoint.

Returns

Newly created endpoint.

Return values

NULL

on error.

Since

12

Definition at line 289 of file main/endpoints.c.

{
    if (ast_strlen_zero(tech)) {
        ast_log(LOG_ERROR, "Endpoint tech cannot be empty\n");
        return NULL;
    }
 
    if (ast_strlen_zero(resource)) {
        ast_log(LOG_ERROR, "Endpoint resource cannot be empty\n");
        return NULL;
    }
 
    return endpoint_internal_create(tech, resource);
}

References ast_log, ast_strlen_zero(), endpoint_internal_create(), LOG_ERROR, NULL, ast_endpoint::resource, and ast_endpoint::tech.

Referenced by AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), build_peer(), persistent_endpoint_find_or_create(), and xmpp_client_alloc().

ast_endpoint_find_by_id()

struct ast_endpoint * ast_endpoint_find_by_id

(

const char *

id

)

Finds the endpoint with the given tech[/resource] id.

Endpoints are refcounted, so ao2_cleanup() when you're done.

Note

The resource portion of an ID is optional. If not provided, an aggregate endpoint for the entire technology is returned. These endpoints must not be modified, but can be subscribed to in order to receive updates for all endpoints of a given technology.

Parameters

id	Tech[/resource] id to look for.

Returns

Associated endpoint.

Return values

NULL	if not found.

Since

12

Definition at line 81 of file main/endpoints.c.

{
    struct ast_endpoint *endpoint = ao2_find(endpoints, id, OBJ_KEY);
 
    if (!endpoint) {
        endpoint = ao2_find(tech_endpoints, id, OBJ_KEY);
    }
 
    return endpoint;
}

References ao2_find, endpoints, OBJ_KEY, and tech_endpoints.

Referenced by ast_ari_endpoints_list_by_tech(), endpoint_find(), and messaging_app_unsubscribe_endpoint().

ast_endpoint_get_id()

const char * ast_endpoint_get_id

(

const struct ast_endpoint *

endpoint

)

Gets the tech/resource id of the given endpoint.

This is unique across all endpoints, and immutable.

Parameters

endpoint

The endpoint.

Returns

Tech/resource id of the endpoint.

Return values

NULL	if endpoint is NULL.

Since

12

Definition at line 358 of file main/endpoints.c.

{
    if (!endpoint) {
        return NULL;
    }
    return endpoint->id;
}

References ast_endpoint::id, and NULL.

Referenced by app_subscribe_endpoint(), forwards_create_endpoint(), get_or_create_subscription(), get_subscription(), messaging_app_subscribe_endpoint(), and messaging_app_unsubscribe_endpoint().

ast_endpoint_get_resource()

const char * ast_endpoint_get_resource

(

const struct ast_endpoint *

endpoint

)

Gets the resource name of the given endpoint.

This is unique for the endpoint's technology, and immutable.

Note

If the endpoint being queried is a technology aggregate endpoint, this will be an empty string.

Parameters

endpoint

The endpoint.

Returns

Resource name of the endpoint.

Return values

NULL	if endpoint is NULL.

Since

12

Definition at line 350 of file main/endpoints.c.

{
    if (!endpoint) {
        return NULL;
    }
    return endpoint->resource;
}

References NULL, and ast_endpoint::resource.

Referenced by add_to_regcontext(), ast_sip_get_endpoint_snapshot(), ast_sip_persistent_endpoint_publish_contact_state(), ast_sip_persistent_endpoint_update_state(), AST_TEST_DEFINE(), endpoint_deleted_observer(), get_or_create_subscription(), get_subscription(), messaging_app_unsubscribe_endpoint(), persistent_endpoint_cmp(), and persistent_endpoint_hash().

ast_endpoint_get_snapshot()

struct ast_endpoint_snapshot * ast_endpoint_get_snapshot

(

struct ast_endpoint *

endpoint

)

Gets the latest snapshot of the given endpoint.

Parameters

endpoint

The endpoint.

Returns

Latest snapshot of the endpoint.

Return values

NULL	if endpoint is NULL.

Since

20.19.0

22.9.0

23.3.0

Definition at line 374 of file main/endpoints.c.

{
    struct ast_endpoint_snapshot *snapshot;
 
    if (!endpoint) {
        return NULL;
    }
 
    ao2_lock(endpoint);
    snapshot = ao2_bump(endpoint->snapshot);
    ao2_unlock(endpoint);
 
    return snapshot;
}

References ao2_bump, ao2_lock, ao2_unlock, NULL, and ast_endpoint::snapshot.

Referenced by chan_pjsip_devicestate().

ast_endpoint_get_state()

enum ast_endpoint_state ast_endpoint_get_state

(

const struct ast_endpoint *

endpoint

)

Gets the state of the given endpoint.

Parameters

endpoint

The endpoint.

Returns

state.

Return values

AST_ENDPOINT_UNKNOWN

if endpoint is NULL.

Since

13.4

Definition at line 366 of file main/endpoints.c.

{
    if (!endpoint) {
        return AST_ENDPOINT_UNKNOWN;
    }
    return endpoint->state;
}

References AST_ENDPOINT_UNKNOWN, and ast_endpoint::state.

Referenced by add_to_regcontext(), and ast_sip_persistent_endpoint_update_state().

ast_endpoint_get_tech()

const char * ast_endpoint_get_tech

(

const struct ast_endpoint *

endpoint

)

Gets the technology of the given endpoint.

This is an immutable string describing the channel provider technology (SIP, IAX2, etc.).

Parameters

endpoint

The endpoint.

Returns

Tec of the endpoint.

Return values

NULL	if endpoint is NULL.

Since

12

Definition at line 342 of file main/endpoints.c.

{
    if (!endpoint) {
        return NULL;
    }
    return endpoint->tech;
}

References NULL, and ast_endpoint::tech.

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

ast_endpoint_init()

int ast_endpoint_init

(

void

)

Endpoint support initialization.

Returns

0 on success.

Non-zero on error.

Definition at line 478 of file main/endpoints.c.

{
    ast_register_cleanup(endpoint_cleanup);
 
    endpoints = ao2_container_alloc_hash(AO2_ALLOC_OPT_LOCK_MUTEX, 0, ENDPOINT_BUCKETS,
        ast_endpoint_hash_fn, NULL, ast_endpoint_cmp_fn);
    if (!endpoints) {
        return -1;
    }
 
    tech_endpoints = ao2_container_alloc_hash(AO2_ALLOC_OPT_LOCK_MUTEX, 0,
        TECH_ENDPOINT_BUCKETS, ast_endpoint_hash_fn, NULL, ast_endpoint_cmp_fn);
    if (!tech_endpoints) {
        return -1;
    }
 
    return 0;
}

References AO2_ALLOC_OPT_LOCK_MUTEX, ao2_container_alloc_hash, ast_register_cleanup(), ENDPOINT_BUCKETS, endpoint_cleanup(), endpoints, NULL, TECH_ENDPOINT_BUCKETS, and tech_endpoints.

Referenced by asterisk_daemon().

ast_endpoint_remove_channel()

int ast_endpoint_remove_channel	(	struct ast_endpoint *	endpoint,
		struct ast_channel *	chan
	)

Removes a channel from the given endpoint.

Since

23.1.0

22.7.0

20.17.0

Parameters

endpoint
chan	Channel.

Return values

0	on success.
Non-zero	on error.

Definition at line 183 of file main/endpoints.c.

{
    ast_assert(chan != NULL);
    ast_assert(endpoint != NULL);
    ast_assert(!ast_strlen_zero(endpoint->resource));
 
    ao2_lock(endpoint);
    ast_str_container_remove(endpoint->channel_ids, ast_channel_uniqueid(chan));
    ao2_unlock(endpoint);
 
    endpoint_publish_snapshot(endpoint);
 
    return 0;
}

References ao2_lock, ao2_unlock, ast_assert, ast_channel_uniqueid(), ast_str_container_remove(), ast_strlen_zero(), ast_endpoint::channel_ids, endpoint_publish_snapshot(), NULL, and ast_endpoint::resource.

Referenced by ast_channel_endpoint_set(), and AST_TEST_DEFINE().

ast_endpoint_set_max_channels()

void ast_endpoint_set_max_channels	(	struct ast_endpoint *	endpoint,
		int	max_channels
	)

Updates the maximum number of channels an endpoint supports.

Set to -1 for unlimited channels.

Parameters

endpoint	Endpoint to modify.
max_channels	Maximum number of concurrent channels this endpoint supports.

Definition at line 401 of file main/endpoints.c.

{
    ast_assert(endpoint != NULL);
    ast_assert(!ast_strlen_zero(endpoint->resource));
 
    ao2_lock(endpoint);
    endpoint->max_channels = max_channels;
    ao2_unlock(endpoint);
    endpoint_publish_snapshot(endpoint);
}

References ao2_lock, ao2_unlock, ast_assert, ast_strlen_zero(), endpoint_publish_snapshot(), ast_endpoint_snapshot::max_channels, ast_endpoint::max_channels, NULL, and ast_endpoint::resource.

Referenced by AST_TEST_DEFINE(), and AST_TEST_DEFINE().

ast_endpoint_set_state()

void ast_endpoint_set_state	(	struct ast_endpoint *	endpoint,
		enum ast_endpoint_state	state
	)

Updates the state of the given endpoint.

Parameters

endpoint	Endpoint to modify.
state	New state.

Since

12

Definition at line 389 of file main/endpoints.c.

{
    ast_assert(endpoint != NULL);
    ast_assert(!ast_strlen_zero(endpoint->resource));
 
    ao2_lock(endpoint);
    endpoint->state = state;
    ao2_unlock(endpoint);
    endpoint_publish_snapshot(endpoint);
}

References ao2_lock, ao2_unlock, ast_assert, ast_strlen_zero(), endpoint_publish_snapshot(), NULL, ast_endpoint::resource, ast_endpoint_snapshot::state, and ast_endpoint::state.

Referenced by __expire_registry(), __iax2_poke_noanswer(), ast_sip_persistent_endpoint_update_state(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), persistent_endpoint_find_or_create(), socket_process_helper(), update_registry(), and xmpp_client_change_state().

ast_endpoint_shutdown()

void ast_endpoint_shutdown

(

struct ast_endpoint *

endpoint

)

Shutsdown an ast_endpoint.

Parameters

endpoint

Endpoint to shut down.

Since

12

Definition at line 320 of file main/endpoints.c.

{
    RAII_VAR(struct stasis_message *, clear_msg, NULL, ao2_cleanup);
 
    if (endpoint == NULL) {
        return;
    }
 
    ao2_unlink(endpoints, endpoint);
    endpoint->tech_forward = stasis_forward_cancel(endpoint->tech_forward);
 
    clear_msg = create_endpoint_snapshot_message(endpoint);
    if (clear_msg) {
        RAII_VAR(struct stasis_message *, message, NULL, ao2_cleanup);
        message = stasis_cache_clear_create(clear_msg);
        if (message) {
            stasis_publish(ast_endpoint_topic(endpoint), message);
        }
    }
    ao2_ref(endpoint, -1);
}

References ao2_cleanup, ao2_ref, ao2_unlink, ast_endpoint_topic(), create_endpoint_snapshot_message(), endpoints, NULL, RAII_VAR, stasis_cache_clear_create(), stasis_forward_cancel(), stasis_publish(), and ast_endpoint::tech_forward.

Referenced by AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), AST_TEST_DEFINE(), peer_destructor(), persistent_endpoint_destroy(), and xmpp_client_destructor().

ast_endpoint_state_to_string()

const char * ast_endpoint_state_to_string

(

enum ast_endpoint_state

state

)

Returns a string representation of the given endpoint state.

Parameters

state

Endpoint state.

Returns

String representation of state.

Return values

?	if state isn't in ast_endpoint_state.

Definition at line 108 of file main/endpoints.c.

{
    switch (state) {
    case AST_ENDPOINT_UNKNOWN:
        return "unknown";
    case AST_ENDPOINT_OFFLINE:
        return "offline";
    case AST_ENDPOINT_ONLINE:
        return "online";
    }
    return "?";
}

References AST_ENDPOINT_OFFLINE, AST_ENDPOINT_ONLINE, and AST_ENDPOINT_UNKNOWN.

Referenced by ast_endpoint_snapshot_to_json().

create_endpoint_snapshot_message()

static struct stasis_message * create_endpoint_snapshot_message ( struct ast_endpoint *  endpoint )

static

Definition at line 304 of file main/endpoints.c.

{
    RAII_VAR(struct ast_endpoint_snapshot *, snapshot, NULL, ao2_cleanup);
 
    if (!ast_endpoint_snapshot_type()) {
        return NULL;
    }
 
    snapshot = ast_endpoint_snapshot_create(endpoint);
    if (!snapshot) {
        return NULL;
    }
 
    return stasis_message_create(ast_endpoint_snapshot_type(), snapshot);
}

References ao2_cleanup, ast_endpoint_snapshot_create(), ast_endpoint_snapshot_type(), NULL, RAII_VAR, and stasis_message_create().

Referenced by ast_endpoint_shutdown().

endpoint_cleanup()

static void endpoint_cleanup ( void  )

static

Definition at line 469 of file main/endpoints.c.

{
    ao2_cleanup(endpoints);
    endpoints = NULL;
 
    ao2_cleanup(tech_endpoints);
    tech_endpoints = NULL;
}

References ao2_cleanup, endpoints, NULL, and tech_endpoints.

Referenced by ast_endpoint_init().

endpoint_dtor()

static void endpoint_dtor ( void *  obj )

static

Definition at line 148 of file main/endpoints.c.

{
    struct ast_endpoint *endpoint = obj;
 
    stasis_cp_single_unsubscribe(endpoint->topics);
    endpoint->topics = NULL;
 
    ao2_cleanup(endpoint->channel_ids);
    endpoint->channel_ids = NULL;
 
    ao2_cleanup(endpoint->snapshot);
    endpoint->snapshot = NULL;
 
    ast_string_field_free_memory(endpoint);
}

References ao2_cleanup, ast_string_field_free_memory, ast_endpoint::channel_ids, NULL, ast_endpoint::snapshot, stasis_cp_single_unsubscribe(), and ast_endpoint::topics.

Referenced by endpoint_internal_create().

endpoint_internal_create()

static struct ast_endpoint * endpoint_internal_create ( const char *  tech, const char *  resource  )

static

Definition at line 199 of file main/endpoints.c.

{
    RAII_VAR(struct ast_endpoint *, endpoint, NULL, ao2_cleanup);
    RAII_VAR(struct ast_endpoint *, tech_endpoint, NULL, ao2_cleanup);
 
    /* Get/create the technology endpoint */
    if (!ast_strlen_zero(resource)) {
        tech_endpoint = ao2_find(tech_endpoints, tech, OBJ_KEY);
        if (!tech_endpoint) {
            tech_endpoint = endpoint_internal_create(tech, NULL);
            if (!tech_endpoint) {
                return NULL;
            }
        }
    }
 
    endpoint = ao2_alloc(sizeof(*endpoint), endpoint_dtor);
    if (!endpoint) {
        return NULL;
    }
 
    endpoint->max_channels = -1;
    endpoint->state = AST_ENDPOINT_UNKNOWN;
 
    if (ast_string_field_init(endpoint, 80) != 0) {
        return NULL;
    }
    ast_string_field_set(endpoint, tech, tech);
    ast_string_field_set(endpoint, resource, S_OR(resource, ""));
    ast_string_field_build(endpoint, id, "%s%s%s",
        tech,
        !ast_strlen_zero(resource) ? "/" : "",
        S_OR(resource, ""));
 
    /* All access to channel_ids should be covered by the endpoint's
     * lock; no extra lock needed. */
    endpoint->channel_ids = ast_str_container_alloc_options(
        AO2_ALLOC_OPT_LOCK_NOLOCK, ENDPOINT_CHANNEL_BUCKETS);
    if (!endpoint->channel_ids) {
        return NULL;
    }
 
    if (!ast_strlen_zero(resource)) {
        char *topic_name;
        int ret;
 
        ret = ast_asprintf(&topic_name, "endpoint:%s", endpoint->id);
        if (ret < 0) {
            return NULL;
        }
 
        endpoint->topics = stasis_cp_single_create(ast_endpoint_cache_all(),
            topic_name);
        ast_free(topic_name);
        if (!endpoint->topics) {
            return NULL;
        }
        stasis_cp_single_accept_message_type(endpoint->topics, ast_endpoint_snapshot_type());
        stasis_cp_single_set_filter(endpoint->topics, STASIS_SUBSCRIPTION_FILTER_SELECTIVE);
 
        endpoint->tech_forward = stasis_forward_all(stasis_cp_single_topic(endpoint->topics),
            stasis_cp_single_topic(tech_endpoint->topics));
 
        endpoint_publish_snapshot(endpoint);
        ao2_link(endpoints, endpoint);
    } else {
        char *topic_name;
        int ret;
 
        ret = ast_asprintf(&topic_name, "endpoint:%s", endpoint->id);
        if (ret < 0) {
            return NULL;
        }
 
        endpoint->topics = stasis_cp_sink_create(ast_endpoint_cache_all(),
            topic_name);
        ast_free(topic_name);
        if (!endpoint->topics) {
            return NULL;
        }
        stasis_cp_single_accept_message_type(endpoint->topics, ast_endpoint_snapshot_type());
        stasis_cp_single_set_filter(endpoint->topics, STASIS_SUBSCRIPTION_FILTER_SELECTIVE);
 
        ao2_link(tech_endpoints, endpoint);
    }
 
    ao2_ref(endpoint, +1);
    return endpoint;
}

References ao2_alloc, AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_cleanup, ao2_find, ao2_link, ao2_ref, ast_asprintf, ast_endpoint_cache_all(), ast_endpoint_snapshot_type(), AST_ENDPOINT_UNKNOWN, ast_free, ast_str_container_alloc_options(), ast_string_field_build, ast_string_field_init, ast_string_field_set, ast_strlen_zero(), ENDPOINT_CHANNEL_BUCKETS, endpoint_dtor(), endpoint_internal_create(), endpoint_publish_snapshot(), endpoints, NULL, OBJ_KEY, RAII_VAR, ast_endpoint::resource, S_OR, stasis_cp_single_accept_message_type(), stasis_cp_single_create(), stasis_cp_single_set_filter(), stasis_cp_single_topic(), stasis_cp_sink_create(), stasis_forward_all(), STASIS_SUBSCRIPTION_FILTER_SELECTIVE, ast_endpoint::tech, and tech_endpoints.

Referenced by ast_endpoint_create(), and endpoint_internal_create().

endpoint_publish_snapshot()

static void endpoint_publish_snapshot ( struct ast_endpoint *  endpoint )

static

Definition at line 121 of file main/endpoints.c.

{
    RAII_VAR(struct ast_endpoint_snapshot *, snapshot, NULL, ao2_cleanup);
    RAII_VAR(struct stasis_message *, message, NULL, ao2_cleanup);
 
    ast_assert(endpoint != NULL);
    ast_assert(endpoint->topics != NULL);
 
    if (!ast_endpoint_snapshot_type()) {
        return;
    }
 
    snapshot = ast_endpoint_snapshot_create(endpoint);
    if (!snapshot) {
        return;
    }
    message = stasis_message_create(ast_endpoint_snapshot_type(), snapshot);
    if (!message) {
        return;
    }
    stasis_publish(ast_endpoint_topic(endpoint), message);
 
    ao2_lock(endpoint);
    ao2_replace(endpoint->snapshot, snapshot);
    ao2_unlock(endpoint);
}

References ao2_cleanup, ao2_lock, ao2_replace, ao2_unlock, ast_assert, ast_endpoint_snapshot_create(), ast_endpoint_snapshot_type(), ast_endpoint_topic(), NULL, RAII_VAR, ast_endpoint::snapshot, stasis_message_create(), stasis_publish(), and ast_endpoint::topics.

Referenced by ast_endpoint_add_channel(), ast_endpoint_remove_channel(), ast_endpoint_set_max_channels(), ast_endpoint_set_state(), and endpoint_internal_create().

endpoint_snapshot_dtor()

static void endpoint_snapshot_dtor ( void *  obj )

static

Definition at line 413 of file main/endpoints.c.

{
    struct ast_endpoint_snapshot *snapshot = obj;
    int channel;
 
    ast_assert(snapshot != NULL);
 
    for (channel = 0; channel < snapshot->num_channels; channel++) {
        ao2_ref(snapshot->channel_ids[channel], -1);
    }
 
    ast_string_field_free_memory(snapshot);
}

References ao2_ref, ast_assert, ast_string_field_free_memory, ast_endpoint_snapshot::channel_ids, NULL, and ast_endpoint_snapshot::num_channels.

Referenced by ast_endpoint_snapshot_create().

Variable Documentation

endpoints

struct ao2_container* endpoints

static

Definition at line 49 of file main/endpoints.c.

Referenced by ami_registrations_endpoints(), ami_show_endpoints(), app_to_json(), ast_endpoint_find_by_id(), ast_endpoint_init(), ast_endpoint_shutdown(), ast_sip_get_endpoints(), cli_complete_endpoint(), create_mwi_subscriptions(), endpoint_cleanup(), endpoint_internal_create(), endpoints_scrape_cb(), load_all_endpoints(), load_module(), load_module(), sip_options_aor_observer_modified_task(), stasis_app_to_cli(), and unload_module().

tech_endpoints

struct ao2_container* tech_endpoints

static

Definition at line 51 of file main/endpoints.c.

Referenced by ast_endpoint_find_by_id(), ast_endpoint_init(), endpoint_cleanup(), and endpoint_internal_create().