Asterisk - The Open Source Telephony Project GIT-master-2de1a68
Data Structures | Functions | Variables
bridge_roles.c File Reference

Channel Bridging Roles API. More...

#include "asterisk.h"
#include <signal.h>
#include "asterisk/logger.h"
#include "asterisk/channel.h"
#include "asterisk/datastore.h"
#include "asterisk/linkedlists.h"
#include "asterisk/bridge.h"
#include "asterisk/bridge_roles.h"
#include "asterisk/stringfields.h"
Include dependency graph for bridge_roles.c:

Go to the source code of this file.

Data Structures

struct  bridge_role
 
struct  bridge_role_option
 
struct  bridge_roles_datastore
 

Functions

void ast_bridge_channel_clear_roles (struct ast_bridge_channel *bridge_channel)
 Clear all roles from a bridge_channel's role list. More...
 
int ast_bridge_channel_establish_roles (struct ast_bridge_channel *bridge_channel)
 Clone the roles from a bridge_channel's attached ast_channel onto the bridge_channel's role list. More...
 
const char * ast_bridge_channel_get_role_option (struct ast_bridge_channel *bridge_channel, const char *role_name, const char *option)
 Retrieve the value of a requested role option from a bridge channel. More...
 
int ast_bridge_channel_has_role (struct ast_bridge_channel *bridge_channel, const char *role_name)
 Check to see if a bridge channel inherited a specific role from its channel. More...
 
int ast_channel_add_bridge_role (struct ast_channel *chan, const char *role_name)
 Adds a bridge role to a channel. More...
 
void ast_channel_clear_bridge_roles (struct ast_channel *chan)
 Removes all bridge roles currently on a channel. More...
 
const char * ast_channel_get_role_option (struct ast_channel *channel, const char *role_name, const char *option)
 Retrieve the value of a requested role option from a channel. More...
 
int ast_channel_has_role (struct ast_channel *channel, const char *role_name)
 Check if a role exists on a channel. More...
 
void ast_channel_remove_bridge_role (struct ast_channel *chan, const char *role_name)
 Removes a bridge role from a channel. More...
 
int ast_channel_set_bridge_role_option (struct ast_channel *channel, const char *role_name, const char *option, const char *value)
 Set a role option on a channel. More...
 
static void bridge_role_datastore_destroy (void *data)
 
static void bridge_role_destroy (struct bridge_role *role)
 
static struct bridge_roles_datastorefetch_bridge_roles_datastore (struct ast_channel *chan)
 
static struct bridge_roles_datastorefetch_or_create_bridge_roles_datastore (struct ast_channel *chan)
 
static struct bridge_roleget_role_from_channel (struct ast_channel *channel, const char *role_name)
 
static struct bridge_roleget_role_from_datastore (struct bridge_roles_datastore *roles_datastore, const char *role_name)
 
static struct bridge_role_optionget_role_option (struct bridge_role *role, const char *option)
 
static int setup_bridge_role (struct bridge_roles_datastore *roles_datastore, const char *role_name)
 
static int setup_bridge_role_option (struct bridge_role *role, const char *option, const char *value)
 
static struct bridge_roles_datastoresetup_bridge_roles_datastore (struct ast_channel *chan)
 

Variables

static const struct ast_datastore_info bridge_role_info
 

Detailed Description

Channel Bridging Roles API.

Author
Jonathan Rose jrose.nosp@m.@dig.nosp@m.ium.c.nosp@m.om

Definition in file bridge_roles.c.

Function Documentation

◆ ast_bridge_channel_clear_roles()

void ast_bridge_channel_clear_roles ( struct ast_bridge_channel bridge_channel)

Clear all roles from a bridge_channel's role list.

Parameters
bridge_channelthe bridge channel that we are scrubbing

If roles are already established on a bridge channel, ast_bridge_channel_establish_roles will fail unconditionally without changing any roles. In order to update a bridge channel's roles, they must first be cleared from the bridge channel using this function.

Note
ast_bridge_channel_clear_roles also serves as the destructor for the role list of a bridge channel.

Definition at line 491 of file bridge_roles.c.

492{
493 if (bridge_channel->bridge_roles) {
495 bridge_channel->bridge_roles = NULL;
496 }
497}
static void bridge_role_datastore_destroy(void *data)
Definition: bridge_roles.c:86
#define NULL
Definition: resample.c:96
struct bridge_roles_datastore * bridge_roles

References bridge_role_datastore_destroy(), ast_bridge_channel::bridge_roles, and NULL.

Referenced by agent_alert(), ast_bridge_channel_establish_roles(), and bridge_channel_internal_pull().

◆ ast_bridge_channel_establish_roles()

int ast_bridge_channel_establish_roles ( struct ast_bridge_channel bridge_channel)

Clone the roles from a bridge_channel's attached ast_channel onto the bridge_channel's role list.

Parameters
bridge_channelThe bridge channel that we are preparing
Return values
0on success
-1on failure

This function should always be called when the bridge_channel binds to an ast_channel at some point before the bridge_channel joins or is imparted onto a bridge. Failure to do so will result in an empty role list. While the list remains established, changes to roles on the ast_channel will not propagate to the bridge channel and roles can not be re-established on the bridge channel without first clearing the roles with ast_bridge_roles_bridge_channel_clear_roles.

Definition at line 443 of file bridge_roles.c.

444{
445 struct bridge_roles_datastore *roles_datastore;
446 struct bridge_role *role = NULL;
447 struct bridge_role_option *role_option;
448
449 if (!bridge_channel->chan) {
450 ast_debug(2, "Attempted to set roles on a bridge channel that has no associated channel. That's a bad idea.\n");
451 return -1;
452 }
453
454 if (bridge_channel->bridge_roles) {
455 ast_debug(2, "Attempted to reset roles while roles were already established. Purge existing roles first.\n");
456 return -1;
457 }
458
459 roles_datastore = fetch_bridge_roles_datastore(bridge_channel->chan);
460 if (!roles_datastore) {
461 /* No roles to establish. */
462 return 0;
463 }
464
465 if (!(bridge_channel->bridge_roles = ast_calloc(1, sizeof(*bridge_channel->bridge_roles)))) {
466 return -1;
467 }
468
469 AST_LIST_TRAVERSE(&roles_datastore->role_list, role, list) {
470 struct bridge_role *this_role_copy;
471
472 if (setup_bridge_role(bridge_channel->bridge_roles, role->role)) {
473 /* We need to abandon the copy because we couldn't setup a role */
474 ast_bridge_channel_clear_roles(bridge_channel);
475 return -1;
476 }
477 this_role_copy = AST_LIST_LAST(&bridge_channel->bridge_roles->role_list);
478
479 AST_LIST_TRAVERSE(&role->options, role_option, list) {
480 if (setup_bridge_role_option(this_role_copy, role_option->option, role_option->value)) {
481 /* We need to abandon the copy because we couldn't setup a role option */
482 ast_bridge_channel_clear_roles(bridge_channel);
483 return -1;
484 }
485 }
486 }
487
488 return 0;
489}
#define ast_calloc(num, len)
A wrapper for calloc()
Definition: astmm.h:202
static int setup_bridge_role_option(struct bridge_role *role, const char *option, const char *value)
Definition: bridge_roles.c:287
static struct bridge_roles_datastore * fetch_bridge_roles_datastore(struct ast_channel *chan)
Definition: bridge_roles.c:144
static int setup_bridge_role(struct bridge_roles_datastore *roles_datastore, const char *role_name)
Definition: bridge_roles.c:256
void ast_bridge_channel_clear_roles(struct ast_bridge_channel *bridge_channel)
Clear all roles from a bridge_channel's role list.
Definition: bridge_roles.c:491
#define ast_debug(level,...)
Log a DEBUG message.
#define AST_LIST_LAST(head)
Returns the last entry contained in a list.
Definition: linkedlists.h:429
#define AST_LIST_TRAVERSE(head, var, field)
Loops over (traverses) the entries in a list.
Definition: linkedlists.h:491
struct ast_channel * chan
struct bridge_role_option::@315 list
const ast_string_field option
Definition: bridge_roles.c:49
const ast_string_field value
Definition: bridge_roles.c:49
char role[AST_ROLE_LEN]
Definition: bridge_roles.c:55
struct bridge_role::@316 list
struct bridge_roles_datastore::@318 role_list

References ast_bridge_channel_clear_roles(), ast_calloc, ast_debug, AST_LIST_LAST, AST_LIST_TRAVERSE, ast_bridge_channel::bridge_roles, ast_bridge_channel::chan, fetch_bridge_roles_datastore(), bridge_role_option::list, bridge_role::list, NULL, bridge_role_option::option, bridge_role::role, bridge_roles_datastore::role_list, setup_bridge_role(), setup_bridge_role_option(), and bridge_role_option::value.

Referenced by agent_alert(), and bridge_channel_internal_push_full().

◆ ast_bridge_channel_get_role_option()

const char * ast_bridge_channel_get_role_option ( struct ast_bridge_channel bridge_channel,
const char *  role_name,
const char *  option 
)

Retrieve the value of a requested role option from a bridge channel.

Parameters
bridge_channelThe bridge channel we are retrieving the option from
role_nameName of the role the option will be retrieved from
optionName of the option we are retrieving the value of
Return values
NULLIf either the role does not exist on the bridge_channel or the role does exist but the option has not been set
Thevalue of the option
Note
See ast_channel_set_role_option note about the need to call ast_bridge_channel_establish_roles.
The returned character pointer is only valid as long as the bridge_channel is guaranteed to be alive and hasn't had ast_bridge_channel_clear_roles called against it (as this will free all roles and role options in the bridge channel). If you need this value after one of these destruction events occurs, you must make a local copy while it is still valid.

Definition at line 423 of file bridge_roles.c.

424{
425 struct bridge_role *role;
426 struct bridge_role_option *role_option = NULL;
427
428 if (!bridge_channel->bridge_roles) {
429 return NULL;
430 }
431
432 role = get_role_from_datastore(bridge_channel->bridge_roles, role_name);
433
434 if (!role) {
435 return NULL;
436 }
437
438 role_option = get_role_option(role, option);
439
440 return role_option ? role_option->value : NULL;
441}
static struct bridge_role * get_role_from_datastore(struct bridge_roles_datastore *roles_datastore, const char *role_name)
Definition: bridge_roles.c:193
static struct bridge_role_option * get_role_option(struct bridge_role *role, const char *option)
Definition: bridge_roles.c:234

References ast_bridge_channel::bridge_roles, get_role_from_datastore(), get_role_option(), NULL, bridge_role_option::option, bridge_role::role, and bridge_role_option::value.

Referenced by bridge_parking_push(), participant_entertainment_start(), and participant_idle_mode_setup().

◆ ast_bridge_channel_has_role()

int ast_bridge_channel_has_role ( struct ast_bridge_channel bridge_channel,
const char *  role_name 
)

Check to see if a bridge channel inherited a specific role from its channel.

Parameters
bridge_channelThe bridge channel being checked
role_nameName of the role being checked
Return values
0The bridge channel does not have the requested role
1The bridge channel does have the requested role
Note
Before a bridge_channel can effectively check roles against a bridge, ast_bridge_channel_establish_roles should be called on the bridge_channel so that roles and their respective role options can be copied from the channel datastore into the bridge_channel roles list. Otherwise this function will just return 0 because the list will be NULL.

Definition at line 414 of file bridge_roles.c.

415{
416 if (!bridge_channel->bridge_roles) {
417 return 0;
418 }
419
420 return get_role_from_datastore(bridge_channel->bridge_roles, role_name) ? 1 : 0;
421}

References ast_bridge_channel::bridge_roles, and get_role_from_datastore().

Referenced by bridge_parking_push(), and holding_bridge_join().

◆ ast_channel_add_bridge_role()

int ast_channel_add_bridge_role ( struct ast_channel chan,
const char *  role_name 
)

Adds a bridge role to a channel.

Parameters
chanAcquirer of the requested role
role_nameName of the role being attached
Return values
0on success
-1on failure

Definition at line 313 of file bridge_roles.c.

314{
316
317 if (!roles_datastore) {
318 ast_log(LOG_WARNING, "Unable to set up bridge role datastore on channel %s\n", ast_channel_name(chan));
319 return -1;
320 }
321
322 /* Check to make sure we aren't adding a redundant role */
323 if (get_role_from_datastore(roles_datastore, role_name)) {
324 ast_debug(2, "Bridge role %s is already applied to the channel %s\n", role_name, ast_channel_name(chan));
325 return 0;
326 }
327
328 /* It wasn't already there, so we can just finish setting it up now. */
329 return setup_bridge_role(roles_datastore, role_name);
330}
#define ast_log
Definition: astobj2.c:42
static struct bridge_roles_datastore * fetch_or_create_bridge_roles_datastore(struct ast_channel *chan)
Definition: bridge_roles.c:168
const char * ast_channel_name(const struct ast_channel *chan)
#define LOG_WARNING

References ast_channel_name(), ast_debug, ast_log, fetch_or_create_bridge_roles_datastore(), get_role_from_datastore(), LOG_WARNING, and setup_bridge_role().

Referenced by add_transferer_role(), announce_request(), app_control_add_role(), bridge_agent_hold_push(), bridge_stasis_push(), media_request_helper(), parking_channel_set_roles(), process_options(), and rec_request().

◆ ast_channel_clear_bridge_roles()

void ast_channel_clear_bridge_roles ( struct ast_channel chan)

Removes all bridge roles currently on a channel.

Parameters
chanChannel the roles are being removed from

Definition at line 356 of file bridge_roles.c.

357{
358 struct bridge_roles_datastore *roles_datastore = fetch_bridge_roles_datastore(chan);
359 struct bridge_role *role;
360
361 if (!roles_datastore) {
362 /* The roles datastore didn't already exist, so there is no need to remove any roles */
363 ast_debug(2, "Roles did not exist on channel %s\n", ast_channel_name(chan));
364 return;
365 }
366
367 AST_LIST_TRAVERSE_SAFE_BEGIN(&roles_datastore->role_list, role, list) {
368 ast_debug(2, "Removing bridge role %s from channel %s\n", role->role, ast_channel_name(chan));
371 }
373}
static void bridge_role_destroy(struct bridge_role *role)
Definition: bridge_roles.c:69
#define AST_LIST_TRAVERSE_SAFE_END
Closes a safe loop traversal block.
Definition: linkedlists.h:615
#define AST_LIST_TRAVERSE_SAFE_BEGIN(head, var, field)
Loops safely over (traverses) the entries in a list.
Definition: linkedlists.h:529
#define AST_LIST_REMOVE_CURRENT(field)
Removes the current entry from a list during a traversal.
Definition: linkedlists.h:557

References ast_channel_name(), ast_debug, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, bridge_role_destroy(), fetch_bridge_roles_datastore(), bridge_role::list, bridge_role::role, and bridge_roles_datastore::role_list.

Referenced by app_control_clear_roles(), and bridge_stasis_pull().

◆ ast_channel_get_role_option()

const char * ast_channel_get_role_option ( struct ast_channel channel,
const char *  role_name,
const char *  option 
)

Retrieve the value of a requested role option from a channel.

Parameters
channelThe channel to retrieve the requested option from
role_nameThe role to which the option belongs
optionThe name of the option to retrieve
Return values
NULLThe option does not exist
non-NULLThe value of the option

This is an alternative to ast_bridge_channel_get_role_option that is useful if bridge roles have not yet been established on a channel's bridge_channel. A possible example of when this could be used is in a bridge v_table's push() callback.

Definition at line 399 of file bridge_roles.c.

400{
401 struct bridge_role *role;
402 struct bridge_role_option *role_option;
403
404 role = get_role_from_channel(channel, role_name);
405 if (!role) {
406 return NULL;
407 }
408
409 role_option = get_role_option(role, option);
410
411 return role_option ? role_option->value : NULL;
412}
static struct bridge_role * get_role_from_channel(struct ast_channel *channel, const char *role_name)
Definition: bridge_roles.c:217

References get_role_from_channel(), get_role_option(), NULL, bridge_role_option::option, bridge_role::role, and bridge_role_option::value.

Referenced by bridge_personality_atxfer_push().

◆ ast_channel_has_role()

int ast_channel_has_role ( struct ast_channel channel,
const char *  role_name 
)

Check if a role exists on a channel.

Parameters
channelThe channel to check
role_nameThe name of the role to search for
Return values
0The requested role does not exist on the channel
1The requested role exists on the channel

This is an alternative to ast_bridge_channel_has_role that is useful if bridge roles have not yet been established on a channel's bridge_channel. A possible example of when this could be used is in a bridge v_table's push() callback.

Definition at line 394 of file bridge_roles.c.

395{
396 return get_role_from_channel(channel, role_name) ? 1 : 0;
397}

References get_role_from_channel().

Referenced by bridge_personality_atxfer_push(), bridge_stasis_push(), and handle_hangup().

◆ ast_channel_remove_bridge_role()

void ast_channel_remove_bridge_role ( struct ast_channel chan,
const char *  role_name 
)

Removes a bridge role from a channel.

Parameters
chanChannel the role is being removed from
role_nameName of the role being removed

Definition at line 332 of file bridge_roles.c.

333{
334 struct bridge_roles_datastore *roles_datastore = fetch_bridge_roles_datastore(chan);
335 struct bridge_role *role;
336
337 if (!roles_datastore) {
338 /* The roles datastore didn't already exist, so there is no need to remove a role */
339 ast_debug(2, "Role %s did not exist on channel %s\n", role_name, ast_channel_name(chan));
340 return;
341 }
342
343 AST_LIST_TRAVERSE_SAFE_BEGIN(&roles_datastore->role_list, role, list) {
344 if (!strcmp(role->role, role_name)) {
345 ast_debug(2, "Removing bridge role %s from channel %s\n", role_name, ast_channel_name(chan));
348 return;
349 }
350 }
352
353 ast_debug(2, "Role %s did not exist on channel %s\n", role_name, ast_channel_name(chan));
354}

References ast_channel_name(), ast_debug, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, bridge_role_destroy(), fetch_bridge_roles_datastore(), bridge_role::list, bridge_role::role, and bridge_roles_datastore::role_list.

Referenced by attended_transfer_properties_shutdown(), bridge_agent_hold_pull(), and bridge_agent_hold_push().

◆ ast_channel_set_bridge_role_option()

int ast_channel_set_bridge_role_option ( struct ast_channel channel,
const char *  role_name,
const char *  option,
const char *  value 
)

Set a role option on a channel.

Parameters
channelChannel receiving the role option
role_nameRole the role option is applied to
optionName of the option
valueValue of the option
Return values
0on success
-1on failure

Definition at line 375 of file bridge_roles.c.

376{
377 struct bridge_role *role = get_role_from_channel(channel, role_name);
378 struct bridge_role_option *role_option;
379
380 if (!role) {
381 return -1;
382 }
383
384 role_option = get_role_option(role, option);
385
386 if (role_option) {
387 ast_string_field_set(role_option, value, value);
388 return 0;
389 }
390
392}
#define ast_string_field_set(x, field, data)
Set a field to a simple string value.
Definition: stringfields.h:521
int value
Definition: syslog.c:37

References ast_string_field_set, get_role_from_channel(), get_role_option(), bridge_role_option::option, bridge_role::role, setup_bridge_role_option(), and value.

Referenced by add_transferer_role(), agent_alert(), apply_option_entertainment(), apply_option_moh(), bridge_agent_hold_push(), bridge_stasis_push(), park_common_setup2(), and parking_channel_set_roles().

◆ bridge_role_datastore_destroy()

static void bridge_role_datastore_destroy ( void *  data)
static

Definition at line 86 of file bridge_roles.c.

87{
88 struct bridge_roles_datastore *roles_datastore = data;
89 struct bridge_role *role;
90
91 while ((role = AST_LIST_REMOVE_HEAD(&roles_datastore->role_list, list))) {
93 }
94
95 ast_free(roles_datastore);
96}
#define ast_free(a)
Definition: astmm.h:180
#define AST_LIST_REMOVE_HEAD(head, field)
Removes and returns the head entry from a list.
Definition: linkedlists.h:833

References ast_free, AST_LIST_REMOVE_HEAD, bridge_role_destroy(), bridge_role::list, bridge_role::role, and bridge_roles_datastore::role_list.

Referenced by ast_bridge_channel_clear_roles().

◆ bridge_role_destroy()

static void bridge_role_destroy ( struct bridge_role role)
static

Definition at line 69 of file bridge_roles.c.

70{
71 struct bridge_role_option *role_option;
72 while ((role_option = AST_LIST_REMOVE_HEAD(&role->options, list))) {
74 ast_free(role_option);
75 }
76 ast_free(role);
77}
#define ast_string_field_free_memory(x)
free all memory - to be called before destroying the object
Definition: stringfields.h:374
struct bridge_role::@317 options

References ast_free, AST_LIST_REMOVE_HEAD, ast_string_field_free_memory, bridge_role_option::list, and bridge_role::options.

Referenced by ast_channel_clear_bridge_roles(), ast_channel_remove_bridge_role(), and bridge_role_datastore_destroy().

◆ fetch_bridge_roles_datastore()

static struct bridge_roles_datastore * fetch_bridge_roles_datastore ( struct ast_channel chan)
static

Definition at line 144 of file bridge_roles.c.

145{
146 struct ast_datastore *datastore = NULL;
147
148 ast_channel_lock(chan);
149 if (!(datastore = ast_channel_datastore_find(chan, &bridge_role_info, NULL))) {
150 ast_channel_unlock(chan);
151 return NULL;
152 }
153 ast_channel_unlock(chan);
154
155 return datastore->data;
156}
static const struct ast_datastore_info bridge_role_info
Definition: bridge_roles.c:98
#define ast_channel_lock(chan)
Definition: channel.h:2922
#define ast_channel_unlock(chan)
Definition: channel.h:2923
struct ast_datastore * ast_channel_datastore_find(struct ast_channel *chan, const struct ast_datastore_info *info, const char *uid)
Find a datastore on a channel.
Definition: channel.c:2399
Structure for a data store object.
Definition: datastore.h:64
void * data
Definition: datastore.h:66

References ast_channel_datastore_find(), ast_channel_lock, ast_channel_unlock, bridge_role_info, ast_datastore::data, and NULL.

Referenced by ast_bridge_channel_establish_roles(), ast_channel_clear_bridge_roles(), ast_channel_remove_bridge_role(), fetch_or_create_bridge_roles_datastore(), and get_role_from_channel().

◆ fetch_or_create_bridge_roles_datastore()

static struct bridge_roles_datastore * fetch_or_create_bridge_roles_datastore ( struct ast_channel chan)
static

Definition at line 168 of file bridge_roles.c.

169{
170 struct bridge_roles_datastore *roles_datastore;
171
172 ast_channel_lock(chan);
173 roles_datastore = fetch_bridge_roles_datastore(chan);
174 if (!roles_datastore) {
175 roles_datastore = setup_bridge_roles_datastore(chan);
176 }
177 ast_channel_unlock(chan);
178
179 return roles_datastore;
180}
static struct bridge_roles_datastore * setup_bridge_roles_datastore(struct ast_channel *chan)
Definition: bridge_roles.c:113

References ast_channel_lock, ast_channel_unlock, fetch_bridge_roles_datastore(), and setup_bridge_roles_datastore().

Referenced by ast_channel_add_bridge_role().

◆ get_role_from_channel()

static struct bridge_role * get_role_from_channel ( struct ast_channel channel,
const char *  role_name 
)
static

Definition at line 217 of file bridge_roles.c.

218{
219 struct bridge_roles_datastore *roles_datastore = fetch_bridge_roles_datastore(channel);
220 return roles_datastore ? get_role_from_datastore(roles_datastore, role_name) : NULL;
221}

References fetch_bridge_roles_datastore(), get_role_from_datastore(), and NULL.

Referenced by ast_channel_get_role_option(), ast_channel_has_role(), and ast_channel_set_bridge_role_option().

◆ get_role_from_datastore()

static struct bridge_role * get_role_from_datastore ( struct bridge_roles_datastore roles_datastore,
const char *  role_name 
)
static

Definition at line 193 of file bridge_roles.c.

194{
195 struct bridge_role *role;
196
197 AST_LIST_TRAVERSE(&roles_datastore->role_list, role, list) {
198 if (!strcmp(role->role, role_name)) {
199 return role;
200 }
201 }
202
203 return NULL;
204}

References AST_LIST_TRAVERSE, bridge_role::list, NULL, bridge_role::role, and bridge_roles_datastore::role_list.

Referenced by ast_bridge_channel_get_role_option(), ast_bridge_channel_has_role(), ast_channel_add_bridge_role(), and get_role_from_channel().

◆ get_role_option()

static struct bridge_role_option * get_role_option ( struct bridge_role role,
const char *  option 
)
static

Definition at line 234 of file bridge_roles.c.

235{
236 struct bridge_role_option *role_option = NULL;
237 AST_LIST_TRAVERSE(&role->options, role_option, list) {
238 if (!strcmp(role_option->option, option)) {
239 return role_option;
240 }
241 }
242 return NULL;
243}

References AST_LIST_TRAVERSE, bridge_role_option::list, NULL, bridge_role_option::option, and bridge_role::options.

Referenced by ast_bridge_channel_get_role_option(), ast_channel_get_role_option(), and ast_channel_set_bridge_role_option().

◆ setup_bridge_role()

static int setup_bridge_role ( struct bridge_roles_datastore roles_datastore,
const char *  role_name 
)
static

Definition at line 256 of file bridge_roles.c.

257{
258 struct bridge_role *role;
259 role = ast_calloc(1, sizeof(*role));
260
261 if (!role) {
262 return -1;
263 }
264
266
267 ast_copy_string(role->role, role_name, sizeof(role->role));
268
269 AST_LIST_INSERT_TAIL(&roles_datastore->role_list, role, list);
270 ast_debug(3, "Set role '%s'\n", role_name);
271
272 return 0;
273}
#define AST_LIST_HEAD_INIT_NOLOCK(head)
Initializes a list head structure.
Definition: linkedlists.h:681
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:731
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
Definition: strings.h:425

References ast_calloc, ast_copy_string(), ast_debug, AST_LIST_HEAD_INIT_NOLOCK, AST_LIST_INSERT_TAIL, bridge_role::list, bridge_role::role, and bridge_roles_datastore::role_list.

Referenced by ast_bridge_channel_establish_roles(), and ast_channel_add_bridge_role().

◆ setup_bridge_role_option()

static int setup_bridge_role_option ( struct bridge_role role,
const char *  option,
const char *  value 
)
static

Definition at line 287 of file bridge_roles.c.

288{
289 struct bridge_role_option *role_option;
290
291 if (!value) {
292 value = "";
293 }
294
295 role_option = ast_calloc(1, sizeof(*role_option));
296 if (!role_option) {
297 return -1;
298 }
299
300 if (ast_string_field_init(role_option, 32)) {
301 ast_free(role_option);
302 return -1;
303 }
304
305 ast_string_field_set(role_option, option, option);
306 ast_string_field_set(role_option, value, value);
307
308 AST_LIST_INSERT_TAIL(&role->options, role_option, list);
309
310 return 0;
311}
#define ast_string_field_init(x, size)
Initialize a field pool and fields.
Definition: stringfields.h:359

References ast_calloc, ast_free, AST_LIST_INSERT_TAIL, ast_string_field_init, ast_string_field_set, bridge_role_option::list, bridge_role_option::option, bridge_role::options, and value.

Referenced by ast_bridge_channel_establish_roles(), and ast_channel_set_bridge_role_option().

◆ setup_bridge_roles_datastore()

static struct bridge_roles_datastore * setup_bridge_roles_datastore ( struct ast_channel chan)
static

Definition at line 113 of file bridge_roles.c.

114{
115 struct ast_datastore *datastore = NULL;
116 struct bridge_roles_datastore *roles_datastore = NULL;
117
118 if (!(datastore = ast_datastore_alloc(&bridge_role_info, NULL))) {
119 return NULL;
120 }
121
122 if (!(roles_datastore = ast_calloc(1, sizeof(*roles_datastore)))) {
123 ast_datastore_free(datastore);
124 return NULL;
125 }
126
127 AST_LIST_HEAD_INIT_NOLOCK(&roles_datastore->role_list);
128
129 datastore->data = roles_datastore;
130 ast_channel_datastore_add(chan, datastore);
131 return roles_datastore;
132}
int ast_channel_datastore_add(struct ast_channel *chan, struct ast_datastore *datastore)
Add a datastore to a channel.
Definition: channel.c:2385
#define ast_datastore_alloc(info, uid)
Definition: datastore.h:85
int ast_datastore_free(struct ast_datastore *datastore)
Free a data store object.
Definition: datastore.c:68

References ast_calloc, ast_channel_datastore_add(), ast_datastore_alloc, ast_datastore_free(), AST_LIST_HEAD_INIT_NOLOCK, bridge_role_info, ast_datastore::data, NULL, and bridge_roles_datastore::role_list.

Referenced by fetch_or_create_bridge_roles_datastore().

Variable Documentation

◆ bridge_role_info

const struct ast_datastore_info bridge_role_info
static
Initial value:
= {
.type = "bridge roles",
}

Definition at line 98 of file bridge_roles.c.

Referenced by fetch_bridge_roles_datastore(), and setup_bridge_roles_datastore().