features_config.c File Reference

#include "asterisk.h"
#include "asterisk/features_config.h"
#include "asterisk/config_options.h"
#include "asterisk/datastore.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/app.h"
#include "asterisk/cli.h"
#include "features_config.h"

Include dependency graph for features_config.c:

Go to the source code of this file.

Data Structures
struct	dummy_config
struct	featuregroup
	Featuregroup representation. More...
struct	featuregroup_item
	Entry in the container of featuregroups. More...
struct	features_config
struct	features_global_config
	Configuration from the "general" section of features.conf. More...

Macros
#define	DEFAULT_ATXFER_ABORT   "*1"
#define	DEFAULT_ATXFER_CALLBACK_RETRIES   2
#define	DEFAULT_ATXFER_COMPLETE   "*2"
#define	DEFAULT_ATXFER_DROP_CALL   0
#define	DEFAULT_ATXFER_LOOP_DELAY   10
#define	DEFAULT_ATXFER_SWAP   "*4"
#define	DEFAULT_ATXFER_THREEWAY   "*3"
#define	DEFAULT_COURTESY_TONE   ""
#define	DEFAULT_FEATURE_DIGIT_TIMEOUT   1000
#define	DEFAULT_FEATUREMAP_ATXFER   ""
#define	DEFAULT_FEATUREMAP_AUTOMIXMON   ""
#define	DEFAULT_FEATUREMAP_AUTOMON   ""
#define	DEFAULT_FEATUREMAP_BLINDXFER   "#"
#define	DEFAULT_FEATUREMAP_DISCONNECT   "*"
#define	DEFAULT_FEATUREMAP_PARKCALL   ""
#define	DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER   15
#define	DEFAULT_PICKUPEXTEN   "*8"
#define	DEFAULT_PICKUPFAILSOUND   ""
#define	DEFAULT_PICKUPSOUND   ""
#define	DEFAULT_RECORDING_FAIL_SOUND   ""
#define	DEFAULT_TRANSFER_ANNOUNCE_SOUND   "pbx-transfer"
#define	DEFAULT_TRANSFER_DIAL_ATTEMPTS   3
#define	DEFAULT_TRANSFER_DIGIT_TIMEOUT   3
#define	DEFAULT_TRANSFER_INVALID_SOUND   "privacy-incorrect"
#define	DEFAULT_TRANSFER_RETRY_SOUND   "pbx-invalid"
#define	DEFAULT_XFERFAILSOUND   "beeperr"
#define	DEFAULT_XFERSOUND   "beep"
#define	HFS_FORMAT   "%-25s %-7s %-7s\n"

Functions
static struct features_config *	__features_config_alloc (int allocate_applicationmap)
static int	add_item (void *obj, void *arg, int flags)
	AO2_GLOBAL_OBJ_STATIC (globals)
static struct ao2_container *	applicationmap_alloc (int replace_duplicates)
static int	applicationmap_handler (const struct aco_option *opt, struct ast_variable *var, void *obj)
static struct ast_applicationmap_item *	applicationmap_item_alloc (const char *name, const char *app, const char *app_data, const char *moh_class, const char *dtmf, unsigned int activate_on_self)
static int	applicationmap_sort (const void *obj, const void *arg, int flags)
static void	ast_applicationmap_item_destructor (void *obj)
int	ast_get_builtin_feature (struct ast_channel *chan, const char *feature, char *buf, size_t len)
	Get the DTMF code for a builtin feature.
struct ao2_container *	ast_get_chan_applicationmap (struct ast_channel *chan)
	Get the applicationmap for a given channel.
struct ast_featuremap_config *	ast_get_chan_featuremap_config (struct ast_channel *chan)
	Get the featuremap configuration options for a channel.
char *	ast_get_chan_features_atxferabort (struct ast_channel *chan)
	Get the transfer configuration option atxferabort.
struct ast_features_general_config *	ast_get_chan_features_general_config (struct ast_channel *chan)
	Get the general configuration options for a channel.
struct ast_features_pickup_config *	ast_get_chan_features_pickup_config (struct ast_channel *chan)
	Get the pickup configuration options for a channel.
struct ast_features_xfer_config *	ast_get_chan_features_xfer_config (struct ast_channel *chan)
	Get the transfer configuration options for a channel.
char *	ast_get_chan_features_xferfailsound (struct ast_channel *chan)
	Get the transfer configuration option xferfailsound.
int	ast_get_feature (struct ast_channel *chan, const char *feature, char *buf, size_t len)
	Get the DTMF code for a call feature.
static int	check_featuregroup (void *obj, void *arg, void *data, int flags)
static int	check_featuregroup_item (void *obj, void *arg, void *data, int flags)
	CONFIG_INFO_CORE ("features", cfg_info, globals, features_config_alloc,.files=ACO_FILES(&features_conf),.pre_apply_config=features_pre_apply_config,)
static void	feature_ds_destroy (void *data)
static void *	feature_ds_duplicate (void *data)
static int	feature_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	feature_write (struct ast_channel *chan, const char *cmd, char *data, const char *value)
static void *	featuregroup_alloc (const char *cat)
static int	featuregroup_cmp (void *obj, void *arg, int flags)
static void	featuregroup_destructor (void *obj)
static void *	featuregroup_find (struct ao2_container *group_container, const char *category)
static int	featuregroup_handler (const struct aco_option *opt, struct ast_variable *var, void *obj)
static int	featuregroup_hash (const void *obj, int flags)
static void	featuregroup_item_destructor (void *obj)
static void	featuremap_config_destructor (void *obj)
static void	featuremap_copy (struct ast_featuremap_config *dest, const struct ast_featuremap_config *src)
static int	featuremap_get (struct ast_featuremap_config *featuremap, const char *field, char *buf, size_t len)
static int	featuremap_handler (const struct aco_option *opt, struct ast_variable *var, void *obj)
static int	featuremap_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	featuremap_set (struct ast_featuremap_config *featuremap, const char *name, const char *value)
static int	featuremap_write (struct ast_channel *chan, const char *cmd, char *data, const char *value)
static void *	features_config_alloc (void)
static void	features_config_destructor (void *obj)
static struct features_config *	features_config_dup (const struct features_config *orig)
static void	features_copy (struct features_config *dest, const struct features_config *src)
static int	features_pre_apply_config (void)
static void	general_copy (struct ast_features_general_config *dest, const struct ast_features_general_config *src)
static void	general_destructor (void *obj)
static int	general_get (struct ast_features_general_config *general, const char *field, char *buf, size_t len)
static int	general_handler (const struct aco_option *opt, struct ast_variable *var, void *obj)
static int	general_set (struct ast_features_general_config *general, const char *name, const char *value)
static struct ast_datastore *	get_feature_chan_ds (struct ast_channel *chan)
static struct features_config *	get_feature_ds (struct ast_channel *chan)
static struct features_global_config *	global_config_alloc (void)
static void	global_config_destructor (void *obj)
static void	global_copy (struct features_global_config *dest, const struct features_global_config *src)
static int	group_item_sort (const void *obj, const void *arg, int flags)
static char *	handle_feature_show (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	CLI command to list configured features.
static int	internal_feature_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	internal_feature_write (struct ast_channel *chan, const char *cmd, char *data, const char *value)
static int	internal_featuremap_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	internal_featuremap_write (struct ast_channel *chan, const char *cmd, char *data, const char *value)
static int	load_config (void)
int	load_features_config (void)
static void	pickup_copy (struct ast_features_pickup_config *dest, const struct ast_features_pickup_config *src)
static void	pickup_destructor (void *obj)
static int	pickup_get (struct ast_features_pickup_config *pickup, const char *field, char *buf, size_t len)
static int	pickup_handler (const struct aco_option *opt, struct ast_variable *var, void *obj)
static int	pickup_set (struct ast_features_pickup_config *pickup, const char *name, const char *value)
static int	print_applicationmap (void *obj, void *arg, int flags)
static int	print_featuregroup (void *obj, void *arg, int flags)
static int	print_featuregroups (void *obj, void *arg, int flags)
int	reload_features_config (void)
void	unload_features_config (void)
static int	unsupported_handler (const struct aco_option *opt, struct ast_variable *var, void *obj)
static void	xfer_copy (struct ast_features_xfer_config *dest, const struct ast_features_xfer_config *src)
static void	xfer_destructor (void *obj)
static int	xfer_get (struct ast_features_xfer_config *xfer, const char *field, char *buf, size_t len)
static int	xfer_handler (const struct aco_option *opt, struct ast_variable *var, void *obj)
static int	xfer_set (struct ast_features_xfer_config *xfer, const char *name, const char *value)

Variables
static struct aco_type	applicationmap_option
static struct aco_type *	applicationmap_options [] = ACO_TYPES(&applicationmap_option)
static struct ast_cli_entry	cli_features_config []
static const struct ast_datastore_info	feature_ds_info
static struct ast_custom_function	feature_function
static struct aco_type	featuregroup_option
static struct aco_type *	featuregroup_options [] = ACO_TYPES(&featuregroup_option)
static struct ast_custom_function	featuremap_function
static struct aco_type	featuremap_option
static struct aco_type *	featuremap_options [] = ACO_TYPES(&featuremap_option)
static struct aco_file	features_conf
static struct aco_type	global_option
static struct aco_type *	global_options [] = ACO_TYPES(&global_option)
static int	parking_warning = 0
static struct aco_type	parkinglot_option
static struct aco_type *	parkinglot_options [] = ACO_TYPES(&parkinglot_option)

Macro Definition Documentation

DEFAULT_ATXFER_ABORT

#define DEFAULT_ATXFER_ABORT   "*1"

Definition at line 456 of file features_config.c.

DEFAULT_ATXFER_CALLBACK_RETRIES

#define DEFAULT_ATXFER_CALLBACK_RETRIES   2

Definition at line 453 of file features_config.c.

DEFAULT_ATXFER_COMPLETE

#define DEFAULT_ATXFER_COMPLETE   "*2"

Definition at line 457 of file features_config.c.

DEFAULT_ATXFER_DROP_CALL

#define DEFAULT_ATXFER_DROP_CALL   0

Definition at line 451 of file features_config.c.

DEFAULT_ATXFER_LOOP_DELAY

#define DEFAULT_ATXFER_LOOP_DELAY   10

Definition at line 452 of file features_config.c.

DEFAULT_ATXFER_SWAP

#define DEFAULT_ATXFER_SWAP   "*4"

Definition at line 459 of file features_config.c.

DEFAULT_ATXFER_THREEWAY

#define DEFAULT_ATXFER_THREEWAY   "*3"

Definition at line 458 of file features_config.c.

DEFAULT_COURTESY_TONE

#define DEFAULT_COURTESY_TONE   ""

Definition at line 445 of file features_config.c.

DEFAULT_FEATURE_DIGIT_TIMEOUT

#define DEFAULT_FEATURE_DIGIT_TIMEOUT   1000

Default general options

Definition at line 444 of file features_config.c.

DEFAULT_FEATUREMAP_ATXFER

#define DEFAULT_FEATUREMAP_ATXFER   ""

Definition at line 474 of file features_config.c.

DEFAULT_FEATUREMAP_AUTOMIXMON

#define DEFAULT_FEATUREMAP_AUTOMIXMON   ""

Definition at line 476 of file features_config.c.

DEFAULT_FEATUREMAP_AUTOMON

#define DEFAULT_FEATUREMAP_AUTOMON   ""

Definition at line 473 of file features_config.c.

DEFAULT_FEATUREMAP_BLINDXFER

#define DEFAULT_FEATUREMAP_BLINDXFER   "#"

Default featuremap options

Definition at line 471 of file features_config.c.

DEFAULT_FEATUREMAP_DISCONNECT

#define DEFAULT_FEATUREMAP_DISCONNECT   "*"

Definition at line 472 of file features_config.c.

DEFAULT_FEATUREMAP_PARKCALL

#define DEFAULT_FEATUREMAP_PARKCALL   ""

Definition at line 475 of file features_config.c.

DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER

#define DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER   15

Definition at line 450 of file features_config.c.

DEFAULT_PICKUPEXTEN

#define DEFAULT_PICKUPEXTEN   "*8"

Default pickup options

Definition at line 466 of file features_config.c.

DEFAULT_PICKUPFAILSOUND

#define DEFAULT_PICKUPFAILSOUND   ""

Definition at line 468 of file features_config.c.

DEFAULT_PICKUPSOUND

#define DEFAULT_PICKUPSOUND   ""

Definition at line 467 of file features_config.c.

DEFAULT_RECORDING_FAIL_SOUND

#define DEFAULT_RECORDING_FAIL_SOUND   ""

Definition at line 446 of file features_config.c.

DEFAULT_TRANSFER_ANNOUNCE_SOUND

#define DEFAULT_TRANSFER_ANNOUNCE_SOUND   "pbx-transfer"

Definition at line 463 of file features_config.c.

DEFAULT_TRANSFER_DIAL_ATTEMPTS

#define DEFAULT_TRANSFER_DIAL_ATTEMPTS   3

Definition at line 460 of file features_config.c.

DEFAULT_TRANSFER_DIGIT_TIMEOUT

#define DEFAULT_TRANSFER_DIGIT_TIMEOUT   3

Default xfer options

Definition at line 449 of file features_config.c.

DEFAULT_TRANSFER_INVALID_SOUND

#define DEFAULT_TRANSFER_INVALID_SOUND   "privacy-incorrect"

Definition at line 462 of file features_config.c.

DEFAULT_TRANSFER_RETRY_SOUND

#define DEFAULT_TRANSFER_RETRY_SOUND   "pbx-invalid"

Definition at line 461 of file features_config.c.

DEFAULT_XFERFAILSOUND

#define DEFAULT_XFERFAILSOUND   "beeperr"

Definition at line 455 of file features_config.c.

DEFAULT_XFERSOUND

#define DEFAULT_XFERSOUND   "beep"

Definition at line 454 of file features_config.c.

HFS_FORMAT

#define HFS_FORMAT   "%-25s %-7s %-7s\n"

Definition at line 1979 of file features_config.c.

Function Documentation

__features_config_alloc()

static struct features_config * __features_config_alloc ( int  allocate_applicationmap )

static

Definition at line 810 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
 
    cfg = ao2_alloc(sizeof(*cfg), features_config_destructor);
    if (!cfg) {
        return NULL;
    }
 
    cfg->global = global_config_alloc();
    if (!cfg->global) {
        return NULL;
    }
 
    cfg->featuremap = ao2_alloc(sizeof(*cfg->featuremap), featuremap_config_destructor);
    if (!cfg->featuremap || ast_string_field_init(cfg->featuremap, 32)) {
        return NULL;
    }
 
    cfg->parkinglots = ao2_alloc(sizeof(*cfg->parkinglots), NULL);
    if (!cfg->parkinglots) {
        return NULL;
    }
 
    if (allocate_applicationmap) {
        cfg->applicationmap = applicationmap_alloc(1);
        if (!cfg->applicationmap) {
            return NULL;
        }
 
        cfg->featuregroups = ao2_container_alloc_hash(AO2_ALLOC_OPT_LOCK_NOLOCK, 0, 11,
            featuregroup_hash, NULL, featuregroup_cmp);
        if (!cfg->featuregroups) {
            return NULL;
        }
    }
 
    ao2_ref(cfg, +1);
    return cfg;
 
}

References ao2_alloc, AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_cleanup, ao2_container_alloc_hash, ao2_ref, applicationmap_alloc(), ast_string_field_init, featuregroup_cmp(), featuregroup_hash(), featuremap_config_destructor(), features_config_destructor(), global_config_alloc(), NULL, and RAII_VAR.

Referenced by features_config_alloc(), and features_config_dup().

add_item()

static int add_item ( void *  obj, void *  arg, int  flags  )

static

Definition at line 1372 of file features_config.c.

{
    struct featuregroup_item *fg_item = obj;
    struct ao2_container *applicationmap = arg;
    RAII_VAR(struct ast_applicationmap_item *, appmap_item, NULL, ao2_cleanup);
 
    /* If there's no DTMF override, then we can just link
     * the applicationmap item directly. Otherwise, we need
     * to create a copy with the DTMF override in place and
     * link that instead
     */
    if (ast_strlen_zero(fg_item->dtmf_override)) {
        ao2_ref(fg_item->appmap_item, +1);
        appmap_item = fg_item->appmap_item;
    } else {
        appmap_item = applicationmap_item_alloc(fg_item->appmap_item_name,
                fg_item->appmap_item->app, fg_item->appmap_item->app_data,
                fg_item->appmap_item->moh_class, fg_item->dtmf_override,
                fg_item->appmap_item->activate_on_self);
    }
 
    if (!appmap_item) {
        return 0;
    }
 
    ao2_link(applicationmap, appmap_item);
    return 0;
}

References ast_applicationmap_item::activate_on_self, ao2_cleanup, ao2_link, ao2_ref, ast_applicationmap_item::app, ast_applicationmap_item::app_data, applicationmap_item_alloc(), featuregroup_item::appmap_item, featuregroup_item::appmap_item_name, ast_strlen_zero(), featuregroup_item::dtmf_override, ast_applicationmap_item::moh_class, NULL, and RAII_VAR.

Referenced by ast_get_chan_applicationmap().

AO2_GLOBAL_OBJ_STATIC()

AO2_GLOBAL_OBJ_STATIC

(

globals

)

applicationmap_alloc()

static struct ao2_container * applicationmap_alloc ( int  replace_duplicates )

static

Definition at line 790 of file features_config.c.

{
    return ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_NOLOCK,
        replace_duplicates ? AO2_CONTAINER_ALLOC_OPT_DUPS_REPLACE : AO2_CONTAINER_ALLOC_OPT_DUPS_ALLOW,
        applicationmap_sort, NULL);
}

References AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_container_alloc_list, AO2_CONTAINER_ALLOC_OPT_DUPS_ALLOW, AO2_CONTAINER_ALLOC_OPT_DUPS_REPLACE, applicationmap_sort(), and NULL.

Referenced by __features_config_alloc(), and ast_get_chan_applicationmap().

applicationmap_handler()

static int applicationmap_handler ( const struct aco_option *  opt, struct ast_variable *  var, void *  obj  )

static

Definition at line 1458 of file features_config.c.

{
    RAII_VAR(struct ast_applicationmap_item *, item, NULL, ao2_cleanup);
    struct ao2_container *applicationmap = obj;
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(dtmf);
        AST_APP_ARG(activate_on);
        AST_APP_ARG(app);
        AST_APP_ARG(app_data);
        AST_APP_ARG(moh_class);
    );
    char *parse = ast_strdupa(var->value);
    char *slash;
    char *paren;
    unsigned int activate_on_self;
 
    AST_STANDARD_APP_ARGS(args, parse);
 
    if (ast_strlen_zero(args.dtmf) ||
            ast_strlen_zero(args.activate_on) ||
            ast_strlen_zero(args.app)) {
        ast_log(LOG_WARNING, "Invalid applicationmap syntax for '%s'. Missing required argument\n", var->name);
        return -1;
    }
 
    /* features.conf used to have an "activated_by" portion
     * in addition to activate_on. Get rid of whatever may be
     * there
     */
    slash = strchr(args.activate_on, '/');
    if (slash) {
        *slash = '\0';
    }
 
    /* Some applications do not require arguments. */
    if (!args.app_data) {
        args.app_data = "";
    }
 
    /* Two syntaxes allowed for applicationmap:
     * Old: foo = *1,self,NoOp,Boo!,default
     * New: foo = *1,self,NoOp(Boo!),default
     *
     * We need to handle both
     */
    paren = strchr(args.app, '(');
    if (paren) {
        /* New syntax */
        char *close_paren;
 
        args.moh_class = args.app_data;
        *paren++ = '\0';
        close_paren = strrchr(paren, ')');
        if (close_paren) {
            *close_paren = '\0';
        }
        args.app_data = paren;
 
        /* Re-check that the application is not empty */
        if (ast_strlen_zero(args.app)) {
            ast_log(LOG_WARNING, "Applicationmap item '%s' does not contain an application name.\n", var->name);
            return -1;
        }
    } else if (strchr(args.app_data, '"')) {
        args.app_data = ast_strip_quoted(args.app_data, "\"", "\"");
    }
 
    /* Allow caller and callee to be specified for backwards compatibility */
    if (!strcasecmp(args.activate_on, "self") || !strcasecmp(args.activate_on, "caller")) {
        activate_on_self = 1;
    } else if (!strcasecmp(args.activate_on, "peer") || !strcasecmp(args.activate_on, "callee")) {
        activate_on_self = 0;
    } else {
        ast_log(LOG_WARNING, "Invalid 'activate_on' value %s for applicationmap item %s\n",
            args.activate_on, var->name);
        return -1;
    }
 
    ast_debug(1, "Allocating applicationmap item: dtmf = %s, app = %s, app_data = %s, moh_class = %s\n",
            args.dtmf, args.app, args.app_data, args.moh_class);
 
    item = applicationmap_item_alloc(var->name, args.app, args.app_data,
            args.moh_class, args.dtmf, activate_on_self);
 
    if (!item) {
        return -1;
    }
 
    if (!ao2_link(applicationmap, item)) {
        return -1;
    }
 
    return 0;
}

References ao2_cleanup, ao2_link, app, applicationmap_item_alloc(), args, AST_APP_ARG, ast_debug, AST_DECLARE_APP_ARGS, ast_log, AST_STANDARD_APP_ARGS, ast_strdupa, ast_strip_quoted(), ast_strlen_zero(), item, LOG_WARNING, NULL, paren, RAII_VAR, and var.

Referenced by load_config().

applicationmap_item_alloc()

static struct ast_applicationmap_item * applicationmap_item_alloc ( const char *  name, const char *  app, const char *  app_data, const char *  moh_class, const char *  dtmf, unsigned int  activate_on_self  )

static

Definition at line 1350 of file features_config.c.

{
    struct ast_applicationmap_item *item;
 
    item = ao2_alloc(sizeof(*item), ast_applicationmap_item_destructor);
 
    if (!item || ast_string_field_init(item, 64)) {
        return NULL;
    }
 
    ast_string_field_set(item, name, name);
    ast_string_field_set(item, app, app);
    ast_string_field_set(item, app_data, app_data);
    ast_string_field_set(item, moh_class, moh_class);
    ast_copy_string(item->dtmf, dtmf, sizeof(item->dtmf));
    item->activate_on_self = activate_on_self;
 
    return item;
}

References ast_applicationmap_item::activate_on_self, ao2_alloc, app, ast_applicationmap_item_destructor(), ast_copy_string(), ast_string_field_init, ast_string_field_set, ast_applicationmap_item::dtmf, item, ast_applicationmap_item::moh_class, name, and NULL.

Referenced by add_item(), and applicationmap_handler().

applicationmap_sort()

static int applicationmap_sort ( const void *  obj, const void *  arg, int  flags  )

static

Definition at line 494 of file features_config.c.

{
    const struct ast_applicationmap_item *item1 = obj;
    const struct ast_applicationmap_item *item2;
    const char *key2;
 
    switch(flags & (OBJ_POINTER | OBJ_KEY | OBJ_PARTIAL_KEY)) {
    case OBJ_KEY:
        key2 = arg;
        return strcasecmp(item1->name, key2);
    case OBJ_PARTIAL_KEY:
        key2 = arg;
        return strncasecmp(item1->name, key2, strlen(key2));
    default:
    case OBJ_POINTER:
        item2 = arg;
        return strcasecmp(item1->name, item2->name);
    }
}

References ast_applicationmap_item::name, OBJ_KEY, OBJ_PARTIAL_KEY, and OBJ_POINTER.

Referenced by applicationmap_alloc().

ast_applicationmap_item_destructor()

static void ast_applicationmap_item_destructor ( void *  obj )

static

Definition at line 487 of file features_config.c.

{
    struct ast_applicationmap_item *item = obj;
 
    ast_string_field_free_memory(item);
}

References ast_string_field_free_memory, and item.

Referenced by applicationmap_item_alloc().

ast_get_builtin_feature()

int ast_get_builtin_feature	(	struct ast_channel *	chan,
		const char *	feature,
		char *	buf,
		size_t	len
	)

Get the DTMF code for a builtin feature.

Note

The channel should be locked before calling this function

If no channel is provided, then the global setting for the option is returned.

Parameters

	chan	The channel to get the option from
	feature	The short name of the feature (as it appears in features.conf)
[out]	buf	The buffer to write the DTMF value into
	len	The size of the buffer in bytes

Return values

0	Success
non-zero	Unrecognized builtin feature name

Definition at line 1309 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
 
    if (chan) {
        cfg = get_feature_ds(chan);
    } else {
        cfg = ao2_global_obj_ref(globals);
    }
 
    if (!cfg) {
        return -1;
    }
 
    return featuremap_get(cfg->featuremap, feature, buf, len);
}

References ao2_cleanup, ao2_global_obj_ref, buf, featuremap_get(), get_feature_ds(), globals, len(), NULL, and RAII_VAR.

Referenced by action_atxfer(), ast_get_feature(), attended_transfer_exec(), builtin_feature_get_exten(), detect_disconnect(), and internal_featuremap_read().

ast_get_chan_applicationmap()

struct ao2_container * ast_get_chan_applicationmap

(

struct ast_channel *

chan

)

Get the applicationmap for a given channel.

Note

The channel should be locked before calling this function.

This uses the value of the DYNAMIC_FEATURES channel variable to build a custom applicationmap for this channel. The returned container has applicationmap_items inside.

Parameters

chan	The channel for which applicationmap is being retrieved.

Return values

NULL	An error occurred or the channel has no dynamic features.
non-NULL	A container of applicationmap_items pertaining to the channel.

Definition at line 1401 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, ao2_global_obj_ref(globals), ao2_cleanup);
    struct ao2_container *applicationmap;
    char *group_names;
    char *name;
 
    if (!cfg) {
        return NULL;
    }
 
    if (!chan) {
        if (!cfg->applicationmap || ao2_container_count(cfg->applicationmap) == 0) {
            return NULL;
        }
        ao2_ref(cfg->applicationmap, +1);
        return cfg->applicationmap;
    }
 
    group_names = ast_strdupa(S_OR(pbx_builtin_getvar_helper(chan, "DYNAMIC_FEATURES"), ""));
    if (ast_strlen_zero(group_names)) {
        return NULL;
    }
 
    applicationmap = applicationmap_alloc(0);
    if (!applicationmap) {
        return NULL;
    }
 
    /* global config must be initialized */
    ast_assert(cfg->featuregroups != NULL);
    ast_assert(cfg->applicationmap != NULL);
    while ((name = strsep(&group_names, "#"))) {
        RAII_VAR(struct featuregroup *, group, ao2_find(cfg->featuregroups, name, OBJ_KEY), ao2_cleanup);
 
        if (!group) {
            RAII_VAR(struct ast_applicationmap_item *, item, ao2_find(cfg->applicationmap, name, OBJ_KEY), ao2_cleanup);
 
            if (item) {
                ao2_link(applicationmap, item);
            } else {
                ast_log(LOG_WARNING, "Unknown DYNAMIC_FEATURES item '%s' on channel %s.\n",
                    name, ast_channel_name(chan));
            }
        } else {
            ao2_callback(group->items, 0, add_item, applicationmap);
        }
    }
 
    if (ao2_container_count(applicationmap) == 0) {
        ao2_cleanup(applicationmap);
        return NULL;
    }
 
    return applicationmap;
}

References add_item(), ao2_callback, ao2_cleanup, ao2_container_count(), ao2_find, ao2_global_obj_ref, ao2_link, ao2_ref, applicationmap_alloc(), ast_assert, ast_channel_name(), ast_log, ast_strdupa, ast_strlen_zero(), globals, item, LOG_WARNING, name, NULL, OBJ_KEY, pbx_builtin_getvar_helper(), RAII_VAR, S_OR, and strsep().

Referenced by ast_get_feature(), set_config_flags(), and setup_bridge_features_dynamic().

ast_get_chan_featuremap_config()

struct ast_featuremap_config * ast_get_chan_featuremap_config

(

struct ast_channel *

chan

)

Get the featuremap configuration options for a channel.

Note

The channel should be locked before calling this function.

The returned value has its reference count incremented.

If no channel is provided, then the global featuremap configuration is returned.

Parameters

chan	The channel to get configuration options for

Return values

NULL	Failed to get configuration
non-NULL	The pickup features configuration

Definition at line 1289 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
 
    if (chan) {
        cfg = get_feature_ds(chan);
    } else {
        cfg = ao2_global_obj_ref(globals);
    }
 
    if (!cfg) {
        return NULL;
    }
 
    ast_assert(cfg->featuremap != NULL);
 
    ao2_ref(cfg->featuremap, +1);
    return cfg->featuremap;
}

References ao2_cleanup, ao2_global_obj_ref, ao2_ref, ast_assert, get_feature_ds(), globals, NULL, and RAII_VAR.

Referenced by testsuite_notify_feature_success().

ast_get_chan_features_atxferabort()

char * ast_get_chan_features_atxferabort

(

struct ast_channel *

chan

)

Get the transfer configuration option atxferabort.

Note

The channel should be locked before calling this function.

The returned value has to be freed.

If no channel is provided, then option is pulled from the global transfer configuration.

Parameters

chan	The channel to get configuration options for

Return values

NULL	Failed to get configuration
non-NULL	The atxferabort

Definition at line 1254 of file features_config.c.

{
    char *res;
    struct ast_features_xfer_config *cfg = ast_get_chan_features_xfer_config(chan);
 
    if (!cfg) {
        return NULL;
    }
 
    res = ast_strdup(cfg->atxferabort);
    ao2_ref(cfg, -1);
 
    return res;
}

References ao2_ref, ast_get_chan_features_xfer_config(), ast_strdup, ast_features_xfer_config::atxferabort, and NULL.

Referenced by action_cancel_atxfer().

ast_get_chan_features_general_config()

struct ast_features_general_config * ast_get_chan_features_general_config

(

struct ast_channel *

chan

)

Get the general configuration options for a channel.

Note

The channel should be locked before calling this function.

The returned value has its reference count incremented.

If no channel is provided, then the global features configuration is returned.

Parameters

chan	The channel to get configuration options for

Return values

NULL	Failed to get configuration
non-NULL	The general features configuration

Definition at line 1199 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
 
    if (chan) {
        cfg = get_feature_ds(chan);
    } else {
        cfg = ao2_global_obj_ref(globals);
    }
 
    if (!cfg) {
        return NULL;
    }
 
    ast_assert(cfg->global && cfg->global->general);
 
    ao2_ref(cfg->global->general, +1);
    return cfg->global->general;
}

References ao2_cleanup, ao2_global_obj_ref, ao2_ref, ast_assert, get_feature_ds(), globals, NULL, and RAII_VAR.

Referenced by bridge_channel_feature_digit_timeout(), and feature_automixmonitor().

ast_get_chan_features_pickup_config()

struct ast_features_pickup_config * ast_get_chan_features_pickup_config

(

struct ast_channel *

chan

)

Get the pickup configuration options for a channel.

Note

The channel should be locked before calling this function.

The returned value has its reference count incremented.

If no channel is provided, then the global pickup configuration is returned.

Parameters

chan	The channel to get configuration options for

Return values

NULL	Failed to get configuration
non-NULL	The pickup features configuration

Definition at line 1269 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
 
    if (chan) {
        cfg = get_feature_ds(chan);
    } else {
        cfg = ao2_global_obj_ref(globals);
    }
 
    if (!cfg) {
        return NULL;
    }
 
    ast_assert(cfg->global && cfg->global->pickup);
 
    ao2_ref(cfg->global->pickup, +1);
    return cfg->global->pickup;
}

References ao2_cleanup, ao2_global_obj_ref, ao2_ref, ast_assert, get_feature_ds(), globals, NULL, and RAII_VAR.

Referenced by __analog_ss_thread(), analog_ss_thread(), ast_pickup_call(), call_pickup_incoming_request(), get_destination(), handle_call_outgoing(), and key_main_page().

ast_get_chan_features_xfer_config()

struct ast_features_xfer_config * ast_get_chan_features_xfer_config

(

struct ast_channel *

chan

)

Get the transfer configuration options for a channel.

Note

The channel should be locked before calling this function.

The returned value has its reference count incremented.

If no channel is provided, then the global transfer configuration is returned.

Parameters

chan	The channel to get configuration options for

Return values

NULL	Failed to get configuration
non-NULL	The transfer features configuration

Definition at line 1219 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
 
    if (chan) {
        cfg = get_feature_ds(chan);
    } else {
        cfg = ao2_global_obj_ref(globals);
    }
 
    if (!cfg) {
        return NULL;
    }
 
    ast_assert(cfg->global && cfg->global->xfer);
 
    ao2_ref(cfg->global->xfer, +1);
    return cfg->global->xfer;
}

References ao2_cleanup, ao2_global_obj_ref, ao2_ref, ast_assert, get_feature_ds(), globals, NULL, and RAII_VAR.

Referenced by action_bridge(), add_transferer_role(), ast_get_chan_features_atxferabort(), ast_get_chan_features_xferfailsound(), attended_transfer_properties_alloc(), bridge_exec(), grab_transfer(), and testsuite_notify_feature_success().

ast_get_chan_features_xferfailsound()

char * ast_get_chan_features_xferfailsound

(

struct ast_channel *

chan

)

Get the transfer configuration option xferfailsound.

Note

The channel should be locked before calling this function.

The returned value has to be freed.

If no channel is provided, then option is pulled from the global transfer configuration.

Parameters

chan	The channel to get configuration options for

Return values

NULL	Failed to get configuration
non-NULL	The xferfailsound

Definition at line 1239 of file features_config.c.

{
    char *res;
    struct ast_features_xfer_config *cfg = ast_get_chan_features_xfer_config(chan);
 
    if (!cfg) {
        return NULL;
    }
 
    res = ast_strdup(cfg->xferfailsound);
    ao2_ref(cfg, -1);
 
    return res;
}

References ao2_ref, ast_get_chan_features_xfer_config(), ast_strdup, NULL, and ast_features_xfer_config::xferfailsound.

Referenced by play_failsound(), and stream_failsound().

ast_get_feature()

int ast_get_feature	(	struct ast_channel *	chan,
		const char *	feature,
		char *	buf,
		size_t	len
	)

Get the DTMF code for a call feature.

Note

The channel should be locked before calling this function

If no channel is provided, then the global setting for the option is returned.

This function is like ast_get_builtin_feature except that it will also check the applicationmap in addition to the builtin features.

Parameters

	chan	The channel to get the option from
	feature	The short name of the feature
[out]	buf	The buffer to write the DTMF value into
	len	The size of the buffer in bytes

Return values

0	Success
non-zero	Unrecognized feature name

Definition at line 1326 of file features_config.c.

{
    RAII_VAR(struct ao2_container *, applicationmap, NULL, ao2_cleanup);
    RAII_VAR(struct ast_applicationmap_item *, item, NULL, ao2_cleanup);
 
    if (!ast_get_builtin_feature(chan, feature, buf, len)) {
        return 0;
    }
 
    /* Dang, must be in the application map */
    applicationmap = ast_get_chan_applicationmap(chan);
    if (!applicationmap) {
        return -1;
    }
 
    item = ao2_find(applicationmap, feature, OBJ_KEY);
    if (!item) {
        return -1;
    }
 
    ast_copy_string(buf, item->dtmf, len);
    return 0;
}

References ao2_cleanup, ao2_find, ast_copy_string(), ast_get_builtin_feature(), ast_get_chan_applicationmap(), buf, item, len(), NULL, OBJ_KEY, and RAII_VAR.

Referenced by handle_incoming_request().

check_featuregroup()

static int check_featuregroup ( void *  obj, void *  arg, void *  data, int  flags  )

static

Definition at line 1643 of file features_config.c.

{
    struct featuregroup *group = obj;
    int *err = arg;
 
    ao2_callback_data(group->items, 0, check_featuregroup_item, arg, data);
 
    if (*err) {
        ast_log(LOG_WARNING, "Featuregroup %s refers to non-existent applicationmap item\n",
                group->name);
    }
 
    return *err ? CMP_STOP : 0;
}

References ao2_callback_data, ast_log, check_featuregroup_item(), CMP_STOP, LOG_WARNING, and group::name.

Referenced by features_pre_apply_config().

check_featuregroup_item()

static int check_featuregroup_item ( void *  obj, void *  arg, void *  data, int  flags  )

static

Definition at line 1625 of file features_config.c.

{
    struct ast_applicationmap_item *appmap_item;
    struct featuregroup_item *fg_item = obj;
    int *err = arg;
    struct ao2_container *applicationmap = data;
 
    appmap_item = ao2_find(applicationmap, fg_item->appmap_item_name, OBJ_KEY);
    if (!appmap_item) {
        *err = 1;
        return CMP_STOP;
    }
 
    fg_item->appmap_item = appmap_item;
 
    return 0;
}

References ao2_find, featuregroup_item::appmap_item, featuregroup_item::appmap_item_name, CMP_STOP, and OBJ_KEY.

Referenced by check_featuregroup().

CONFIG_INFO_CORE()

CONFIG_INFO_CORE	(	"features"	,
		cfg_info	,
		globals	,
		features_config_alloc	,
		.	files = ACO_FILES(&features_conf),
		.	pre_apply_config = features_pre_apply_config
	)

feature_ds_destroy()

static void feature_ds_destroy ( void *  data )

static

Definition at line 1122 of file features_config.c.

{
    struct features_config *cfg = data;
    ao2_cleanup(cfg);
}

References ao2_cleanup.

feature_ds_duplicate()

static void * feature_ds_duplicate ( void *  data )

static

Definition at line 1128 of file features_config.c.

{
    struct features_config *old_cfg = data;
 
    return features_config_dup(old_cfg);
}

References features_config_dup().

feature_read()

static int feature_read ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1778 of file features_config.c.

{
    if (!chan) {
        ast_log(LOG_WARNING, "No channel was provided to %s function.\n", cmd);
        return -1;
    }
 
    return internal_feature_read(chan, cmd, data, buf, len);
}

References ast_log, buf, ast_datastore::data, internal_feature_read(), len(), and LOG_WARNING.

feature_write()

static int feature_write ( struct ast_channel *  chan, const char *  cmd, char *  data, const char *  value  )

static

Definition at line 1789 of file features_config.c.

{
    if (!chan) {
        ast_log(LOG_WARNING, "No channel was provided to %s function.\n", cmd);
        return -1;
    }
 
    return internal_feature_write(chan, cmd, data, value);
}

References ast_log, ast_datastore::data, internal_feature_write(), LOG_WARNING, and value.

featuregroup_alloc()

static void * featuregroup_alloc ( const char *  cat )

static

Definition at line 620 of file features_config.c.

{
    struct featuregroup *group;
 
    group = ao2_alloc(sizeof(*group), featuregroup_destructor);
    if (!group) {
        return NULL;
    }
 
    group->name = ast_strdup(cat);
    if (!group->name) {
        ao2_cleanup(group);
        return NULL;
    }
 
    group->items = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_NOLOCK,
        AO2_CONTAINER_ALLOC_OPT_DUPS_REPLACE, group_item_sort, NULL);
    if (!group->items) {
        ao2_cleanup(group);
        return NULL;
    }
 
    return group;
}

References ao2_alloc, AO2_ALLOC_OPT_LOCK_NOLOCK, ao2_cleanup, ao2_container_alloc_list, AO2_CONTAINER_ALLOC_OPT_DUPS_REPLACE, ast_strdup, featuregroup_destructor(), group_item_sort(), group::name, and NULL.

featuregroup_cmp()

static int featuregroup_cmp ( void *  obj, void *  arg, int  flags  )

static

Definition at line 586 of file features_config.c.

{
    struct featuregroup *group1 = obj;
    struct featuregroup *group2;
    const char *key2;
 
    switch(flags & (OBJ_POINTER | OBJ_KEY | OBJ_PARTIAL_KEY)) {
    case OBJ_KEY:
        key2 = arg;
        return strcasecmp(group1->name, key2) ? 0 : CMP_MATCH;
    case OBJ_PARTIAL_KEY:
        key2 = arg;
        return strncasecmp(group1->name, key2, strlen(key2)) ? 0 : CMP_MATCH;
    case OBJ_POINTER:
        group2 = arg;
        return strcasecmp(group1->name, group2->name) ? 0 : CMP_MATCH;
    default:
        return CMP_STOP;
    }
}

References CMP_MATCH, CMP_STOP, featuregroup::name, OBJ_KEY, OBJ_PARTIAL_KEY, and OBJ_POINTER.

Referenced by __features_config_alloc().

featuregroup_destructor()

static void featuregroup_destructor ( void *  obj )

static

Definition at line 612 of file features_config.c.

{
    struct featuregroup *group = obj;
 
    ast_free((char *) group->name);
    ao2_cleanup(group->items);
}

References ao2_cleanup, ast_free, and group::name.

Referenced by featuregroup_alloc().

featuregroup_find()

static void * featuregroup_find ( struct ao2_container *  group_container, const char *  category  )

static

Definition at line 607 of file features_config.c.

{
    return ao2_find(group_container, category, OBJ_KEY);
}

References ao2_find, group_container, and OBJ_KEY.

featuregroup_handler()

static int featuregroup_handler ( const struct aco_option *  opt, struct ast_variable *  var, void *  obj  )

static

Definition at line 1554 of file features_config.c.

{
    RAII_VAR(struct featuregroup_item *, item, NULL, ao2_cleanup);
    struct featuregroup *group = obj;
 
    item = ao2_alloc(sizeof(*item), featuregroup_item_destructor);
    if (!item || ast_string_field_init(item, 32)) {
        return -1;
    }
 
    ast_string_field_set(item, appmap_item_name, var->name);
    ast_string_field_set(item, dtmf_override, var->value);
 
    if (!ao2_link(group->items, item)) {
        return -1;
    }
 
    /* We wait to look up the application map item in the preapply callback */
 
    return 0;
}

References ao2_alloc, ao2_cleanup, ao2_link, ast_string_field_init, ast_string_field_set, featuregroup_item_destructor(), item, aco_type::name, NULL, RAII_VAR, and var.

Referenced by load_config().

featuregroup_hash()

static int featuregroup_hash ( const void *  obj, int  flags  )

static

Definition at line 567 of file features_config.c.

{
    const struct featuregroup *group;
    const char *key;
 
    switch (flags & (OBJ_POINTER | OBJ_KEY | OBJ_PARTIAL_KEY)) {
    case OBJ_KEY:
        key = obj;
        return ast_str_case_hash(key);
    case OBJ_PARTIAL_KEY:
        ast_assert(0);
        return 0;
    case OBJ_POINTER:
    default:
        group = obj;
        return ast_str_case_hash(group->name);
    }
}

References ast_assert, ast_str_case_hash(), group::name, OBJ_KEY, OBJ_PARTIAL_KEY, and OBJ_POINTER.

Referenced by __features_config_alloc().

featuregroup_item_destructor()

static void featuregroup_item_destructor ( void *  obj )

static

Definition at line 528 of file features_config.c.

{
    struct featuregroup_item *item = obj;
 
    ast_string_field_free_memory(item);
    ao2_cleanup(item->appmap_item);
}

References ao2_cleanup, ast_string_field_free_memory, and item.

Referenced by featuregroup_handler().

featuremap_config_destructor()

static void featuremap_config_destructor ( void *  obj )

static

Definition at line 725 of file features_config.c.

{
    struct ast_featuremap_config *cfg = obj;
 
    ast_string_field_free_memory(cfg);
}

References ast_string_field_free_memory.

Referenced by __features_config_alloc().

featuremap_copy()

static void featuremap_copy ( struct ast_featuremap_config *  dest, const struct ast_featuremap_config *  src  )

static

Definition at line 886 of file features_config.c.

{
    ast_string_fields_copy(dest, src);
}

References ast_string_fields_copy.

Referenced by features_copy().

featuremap_get()

static int featuremap_get ( struct ast_featuremap_config *  featuremap, const char *  field, char *  buf, size_t  len  )

static

Definition at line 1099 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(field, "blindxfer")) {
        ast_copy_string(buf, featuremap->blindxfer, len);
    } else if (!strcasecmp(field, "disconnect")) {
        ast_copy_string(buf, featuremap->disconnect, len);
    } else if (!strcasecmp(field, "atxfer")) {
        ast_copy_string(buf, featuremap->atxfer, len);
    } else if (!strcasecmp(field, "automixmon")) {
        ast_copy_string(buf, featuremap->automixmon, len);
    } else if (!strcasecmp(field, "parkcall")) {
        ast_copy_string(buf, featuremap->parkcall, len);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_copy_string(), ast_featuremap_config::atxfer, ast_featuremap_config::automixmon, ast_featuremap_config::blindxfer, buf, ast_featuremap_config::disconnect, features_config::featuremap, len(), and ast_featuremap_config::parkcall.

Referenced by ast_get_builtin_feature().

featuremap_handler()

static int featuremap_handler ( const struct aco_option *  opt, struct ast_variable *  var, void *  obj  )

static

Definition at line 1617 of file features_config.c.

{
    struct ast_featuremap_config *featuremap = obj;
 
    return featuremap_set(featuremap, var->name, var->value);
}

References featuremap_set(), and var.

Referenced by load_config().

featuremap_read()

static int featuremap_read ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1800 of file features_config.c.

{
    if (!chan) {
        ast_log(LOG_WARNING, "No channel was provided to %s function.\n", cmd);
        return -1;
    }
 
    return internal_featuremap_read(chan, cmd, data, buf, len);
}

References ast_log, buf, ast_datastore::data, internal_featuremap_read(), len(), and LOG_WARNING.

featuremap_set()

static int featuremap_set ( struct ast_featuremap_config *  featuremap, const char *  name, const char *  value  )

static

Definition at line 1076 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(name, "blindxfer")) {
        ast_string_field_set(featuremap, blindxfer, value);
    } else if (!strcasecmp(name, "disconnect")) {
        ast_string_field_set(featuremap, disconnect, value);
    } else if (!strcasecmp(name, "atxfer")) {
        ast_string_field_set(featuremap, atxfer, value);
    } else if (!strcasecmp(name, "automixmon")) {
        ast_string_field_set(featuremap, automixmon, value);
    } else if (!strcasecmp(name, "parkcall")) {
        ast_string_field_set(featuremap, parkcall, value);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_string_field_set, features_config::featuremap, name, and value.

Referenced by featuremap_handler(), and internal_featuremap_write().

featuremap_write()

static int featuremap_write ( struct ast_channel *  chan, const char *  cmd, char *  data, const char *  value  )

static

Definition at line 1811 of file features_config.c.

{
    if (!chan) {
        ast_log(LOG_WARNING, "No channel was provided to %s function.\n", cmd);
        return -1;
    }
 
    return internal_featuremap_write(chan, cmd, data, value);
}

References ast_log, ast_datastore::data, internal_featuremap_write(), LOG_WARNING, and value.

features_config_alloc()

static void * features_config_alloc ( void  )

static

Definition at line 852 of file features_config.c.

{
    return __features_config_alloc(1);
}

References __features_config_alloc().

Referenced by load_config().

features_config_destructor()

static void features_config_destructor ( void *  obj )

static

Definition at line 714 of file features_config.c.

{
    struct features_config *cfg = obj;
 
    ao2_cleanup(cfg->global);
    ao2_cleanup(cfg->featuremap);
    ao2_cleanup(cfg->parkinglots);
    ao2_cleanup(cfg->applicationmap);
    ao2_cleanup(cfg->featuregroups);
}

References ao2_cleanup, features_config::applicationmap, features_config::featuregroups, features_config::featuremap, features_config::global, and features_config::parkinglots.

Referenced by __features_config_alloc().

features_config_dup()

static struct features_config * features_config_dup ( const struct features_config *  orig )

static

Definition at line 902 of file features_config.c.

{
    struct features_config *dup;
 
    dup = __features_config_alloc(0);
    if (!dup) {
        return NULL;
    }
 
    features_copy(dup, orig);
 
    return dup;
}

References __features_config_alloc(), features_copy(), and NULL.

Referenced by feature_ds_duplicate(), and get_feature_ds().

features_copy()

static void features_copy ( struct features_config *  dest, const struct features_config *  src  )

static

Definition at line 891 of file features_config.c.

{
    global_copy(dest->global, src->global);
    featuremap_copy(dest->featuremap, src->featuremap);
 
    /* applicationmap and featuregroups are purposely not copied. A channel's applicationmap
     * is produced on the fly when ast_get_chan_applicationmap() is called
     * NOTE: This does not apply to the global cfg->applicationmap and cfg->featuregroups
     */
}

References features_config::featuremap, featuremap_copy(), features_config::global, and global_copy().

Referenced by features_config_dup().

features_pre_apply_config()

static int features_pre_apply_config ( void  )

static

Definition at line 1665 of file features_config.c.

{
    struct features_config *cfg = aco_pending_config(&cfg_info);
    int err = 0;
 
    /* Now that the entire config has been processed, we can check that the featuregroup
     * items refer to actual applicationmap items.
     */
 
    /* global config must be initialized */
    ast_assert(cfg->featuregroups != NULL);
    ast_assert(cfg->applicationmap != NULL);
    ao2_callback_data(cfg->featuregroups, 0, check_featuregroup, &err, cfg->applicationmap);
 
    return err;
}

References aco_pending_config(), ao2_callback_data, features_config::applicationmap, ast_assert, check_featuregroup(), features_config::featuregroups, and NULL.

general_copy()

static void general_copy ( struct ast_features_general_config *  dest, const struct ast_features_general_config *  src  )

static

Definition at line 857 of file features_config.c.

{
    ast_string_fields_copy(dest, src);
    dest->featuredigittimeout = src->featuredigittimeout;
}

References ast_string_fields_copy, and ast_features_general_config::featuredigittimeout.

Referenced by global_copy().

general_destructor()

static void general_destructor ( void *  obj )

static

Definition at line 741 of file features_config.c.

{
    struct ast_features_general_config *cfg = obj;
 
    ast_string_field_free_memory(cfg);
}

References ast_string_field_free_memory.

Referenced by global_config_alloc().

general_get()

static int general_get ( struct ast_features_general_config *  general, const char *  field, char *  buf, size_t  len  )

static

Definition at line 935 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(field, "featuredigittimeout")) {
        snprintf(buf, len, "%u", general->featuredigittimeout);
    } else if (!strcasecmp(field, "courtesytone")) {
        ast_copy_string(buf, general->courtesytone, len);
    } else if (!strcasecmp(field, "recordingfailsound")) {
        ast_copy_string(buf, general->recordingfailsound, len);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_copy_string(), buf, ast_features_general_config::courtesytone, ast_features_general_config::featuredigittimeout, len(), and ast_features_general_config::recordingfailsound.

Referenced by internal_feature_read().

general_handler()

static int general_handler ( const struct aco_option *  opt, struct ast_variable *  var, void *  obj  )

static

Definition at line 1577 of file features_config.c.

{
    struct features_global_config *global = obj;
    struct ast_features_general_config *general = global->general;
 
    return general_set(general, var->name, var->value);
}

References general_set(), global, and var.

Referenced by load_config().

general_set()

static int general_set ( struct ast_features_general_config *  general, const char *  name, const char *  value  )

static

Definition at line 916 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(name, "featuredigittimeout")) {
        res = ast_parse_arg(value, PARSE_INT32, &general->featuredigittimeout);
    } else if (!strcasecmp(name, "courtesytone")) {
        ast_string_field_set(general, courtesytone, value);
    } else if (!strcasecmp(name, "recordingfailsound")) {
        ast_string_field_set(general, recordingfailsound, value);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_parse_arg(), ast_string_field_set, ast_features_general_config::featuredigittimeout, name, PARSE_INT32, and value.

Referenced by general_handler(), and internal_feature_write().

get_feature_chan_ds()

static struct ast_datastore * get_feature_chan_ds ( struct ast_channel *  chan )

static

Definition at line 1185 of file features_config.c.

{
    struct ast_datastore *ds;
 
    if (!(ds = ast_channel_datastore_find(chan, &feature_ds_info, NULL))) {
        /* Hasn't been created yet.  Trigger creation. */
        ao2_cleanup(get_feature_ds(chan));
 
        ds = ast_channel_datastore_find(chan, &feature_ds_info, NULL);
    }
 
    return ds;
}

References ao2_cleanup, ast_channel_datastore_find(), feature_ds_info, get_feature_ds(), and NULL.

Referenced by internal_feature_read(), and internal_feature_write().

get_feature_ds()

static struct features_config * get_feature_ds ( struct ast_channel *  chan )

static

Definition at line 1149 of file features_config.c.

{
    RAII_VAR(struct features_config *, orig, NULL, ao2_cleanup);
    struct features_config *cfg;
    struct ast_datastore *ds;
 
    if ((ds = ast_channel_datastore_find(chan, &feature_ds_info, NULL))) {
        cfg = ds->data;
        ao2_ref(cfg, +1);
        return cfg;
    }
 
    orig = ao2_global_obj_ref(globals);
    if (!orig) {
        return NULL;
    }
 
    cfg = features_config_dup(orig);
    if (!cfg) {
        return NULL;
    }
 
    if (!(ds = ast_datastore_alloc(&feature_ds_info, NULL))) {
        ao2_cleanup(cfg);
        return NULL;
    }
 
    /* Give the datastore a reference to the config */
    ao2_ref(cfg, +1);
    ds->data = cfg;
 
    ast_channel_datastore_add(chan, ds);
 
    return cfg;
}

References ao2_cleanup, ao2_global_obj_ref, ao2_ref, ast_channel_datastore_add(), ast_channel_datastore_find(), ast_datastore_alloc, ast_datastore::data, feature_ds_info, features_config_dup(), globals, NULL, and RAII_VAR.

Referenced by ast_get_builtin_feature(), ast_get_chan_featuremap_config(), ast_get_chan_features_general_config(), ast_get_chan_features_pickup_config(), ast_get_chan_features_xfer_config(), get_feature_chan_ds(), internal_feature_read(), internal_feature_write(), and internal_featuremap_write().

global_config_alloc()

static struct features_global_config * global_config_alloc ( void  )

static

Definition at line 762 of file features_config.c.

{
    RAII_VAR(struct features_global_config *, cfg, NULL, ao2_cleanup);
 
    cfg = ao2_alloc(sizeof(*cfg), global_config_destructor);
    if (!cfg) {
        return NULL;
    }
 
    cfg->general = ao2_alloc(sizeof(*cfg->general), general_destructor);
    if (!cfg->general || ast_string_field_init(cfg->general, 32)) {
        return NULL;
    }
 
    cfg->xfer = ao2_alloc(sizeof(*cfg->xfer), xfer_destructor);
    if (!cfg->xfer || ast_string_field_init(cfg->xfer, 32)) {
        return NULL;
    }
 
    cfg->pickup = ao2_alloc(sizeof(*cfg->pickup), pickup_destructor);
    if (!cfg->pickup || ast_string_field_init(cfg->pickup, 32)) {
        return NULL;
    }
 
    ao2_ref(cfg, +1);
    return cfg;
}

References ao2_alloc, ao2_cleanup, ao2_ref, ast_string_field_init, general_destructor(), global_config_destructor(), NULL, pickup_destructor(), RAII_VAR, and xfer_destructor().

Referenced by __features_config_alloc().

global_config_destructor()

static void global_config_destructor ( void *  obj )

static

Definition at line 732 of file features_config.c.

{
    struct features_global_config *cfg = obj;
 
    ao2_cleanup(cfg->general);
    ao2_cleanup(cfg->xfer);
    ao2_cleanup(cfg->pickup);
}

References ao2_cleanup, features_global_config::general, features_global_config::pickup, and features_global_config::xfer.

Referenced by global_config_alloc().

global_copy()

static void global_copy ( struct features_global_config *  dest, const struct features_global_config *  src  )

static

Definition at line 879 of file features_config.c.

{
    general_copy(dest->general, src->general);
    xfer_copy(dest->xfer, src->xfer);
    pickup_copy(dest->pickup, src->pickup);
}

References features_global_config::general, general_copy(), features_global_config::pickup, pickup_copy(), features_global_config::xfer, and xfer_copy().

Referenced by features_copy().

group_item_sort()

static int group_item_sort ( const void *  obj, const void *  arg, int  flags  )

static

Definition at line 536 of file features_config.c.

{
    const struct featuregroup_item *item1 = obj;
    const struct featuregroup_item *item2;
    const char *key2;
 
    switch(flags & (OBJ_POINTER | OBJ_KEY | OBJ_PARTIAL_KEY)) {
    case OBJ_KEY:
        key2 = arg;
        return strcasecmp(item1->appmap_item_name, key2);
    case OBJ_PARTIAL_KEY:
        key2 = arg;
        return strncasecmp(item1->appmap_item_name, key2, strlen(key2));
    case OBJ_POINTER:
        item2 = arg;
        return strcasecmp(item1->appmap_item_name, item2->appmap_item_name);
    default:
        return CMP_STOP;
    }
}

References featuregroup_item::appmap_item_name, CMP_STOP, OBJ_KEY, OBJ_PARTIAL_KEY, and OBJ_POINTER.

Referenced by featuregroup_alloc().

handle_feature_show()

static char * handle_feature_show ( struct ast_cli_entry *  e, int  cmd, struct ast_cli_args *  a  )

static

CLI command to list configured features.

Parameters

e
cmd
a

Return values

CLI_SUCCESS	on success.
NULL	when tab completion is used.

Definition at line 1999 of file features_config.c.

{
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
 
    switch (cmd) {
 
    case CLI_INIT:
        e->command = "features show";
        e->usage =
            "Usage: features show\n"
            "       Lists configured features\n";
        return NULL;
    case CLI_GENERATE:
        return NULL;
    }
 
    cfg = ao2_global_obj_ref(globals);
 
    ast_cli(a->fd, HFS_FORMAT, "Builtin Feature", "Default", "Current");
    ast_cli(a->fd, HFS_FORMAT, "---------------", "-------", "-------");
 
    ast_cli(a->fd, HFS_FORMAT, "Pickup", DEFAULT_PICKUPEXTEN, cfg->global->pickup->pickupexten);
    ast_cli(a->fd, HFS_FORMAT, "Blind Transfer", DEFAULT_FEATUREMAP_BLINDXFER, cfg->featuremap->blindxfer);
    ast_cli(a->fd, HFS_FORMAT, "Attended Transfer", DEFAULT_FEATUREMAP_ATXFER, cfg->featuremap->atxfer);
    ast_cli(a->fd, HFS_FORMAT, "Disconnect Call", DEFAULT_FEATUREMAP_DISCONNECT, cfg->featuremap->disconnect);
    ast_cli(a->fd, HFS_FORMAT, "Park Call", DEFAULT_FEATUREMAP_PARKCALL, cfg->featuremap->parkcall);
    ast_cli(a->fd, HFS_FORMAT, "One Touch MixMonitor", DEFAULT_FEATUREMAP_AUTOMIXMON, cfg->featuremap->automixmon);
 
    ast_cli(a->fd, "\n");
    ast_cli(a->fd, HFS_FORMAT, "Dynamic Feature", "Default", "Current");
    ast_cli(a->fd, HFS_FORMAT, "---------------", "-------", "-------");
    if (!cfg->applicationmap || ao2_container_count(cfg->applicationmap) == 0) {
        ast_cli(a->fd, "(none)\n");
    } else {
        ao2_callback(cfg->applicationmap, 0, print_applicationmap, a);
    }
 
    ast_cli(a->fd, "\nFeature Groups:\n");
    ast_cli(a->fd, "---------------\n");
    if (!cfg->featuregroups || ao2_container_count(cfg->featuregroups) == 0) {
        ast_cli(a->fd, "(none)\n");
    } else {
        ao2_callback(cfg->featuregroups, 0, print_featuregroups, a);
    }
 
    return CLI_SUCCESS;
}

References a, ao2_callback, ao2_cleanup, ao2_container_count(), ao2_global_obj_ref, ast_cli(), CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, DEFAULT_FEATUREMAP_ATXFER, DEFAULT_FEATUREMAP_AUTOMIXMON, DEFAULT_FEATUREMAP_BLINDXFER, DEFAULT_FEATUREMAP_DISCONNECT, DEFAULT_FEATUREMAP_PARKCALL, DEFAULT_PICKUPEXTEN, globals, HFS_FORMAT, NULL, print_applicationmap(), print_featuregroups(), RAII_VAR, and ast_cli_entry::usage.

internal_feature_read()

static int internal_feature_read ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1682 of file features_config.c.

{
    int res;
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
    SCOPED_CHANNELLOCK(lock, chan);
 
    if (!strcasecmp(data, "inherit")) {
        struct ast_datastore *ds = get_feature_chan_ds(chan);
        unsigned int inherit = ds ? ds->inheritance : 0;
 
        snprintf(buf, len, "%s", inherit ? "yes" : "no");
        return 0;
    }
 
    cfg = get_feature_ds(chan);
    if (!cfg) {
        return -1;
    }
 
    res = general_get(cfg->global->general, data, buf, len) &&
        xfer_get(cfg->global->xfer, data, buf, len) &&
        pickup_get(cfg->global->pickup, data, buf, len);
 
    if (res) {
        ast_log(LOG_WARNING, "Invalid argument '%s' to FEATURE()\n", data);
    }
 
    return res;
}

References ao2_cleanup, ast_log, buf, ast_datastore::data, general_get(), get_feature_chan_ds(), get_feature_ds(), ast_datastore::inheritance, len(), lock, LOG_WARNING, NULL, pickup_get(), RAII_VAR, SCOPED_CHANNELLOCK, and xfer_get().

Referenced by feature_read().

internal_feature_write()

static int internal_feature_write ( struct ast_channel *  chan, const char *  cmd, char *  data, const char *  value  )

static

Definition at line 1713 of file features_config.c.

{
    int res;
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
    SCOPED_CHANNELLOCK(lock, chan);
 
    if (!strcasecmp(data, "inherit")) {
        struct ast_datastore *ds = get_feature_chan_ds(chan);
        if (ds) {
            ds->inheritance = ast_true(value) ? DATASTORE_INHERIT_FOREVER : 0;
        }
        return 0;
    }
 
    if (!(cfg = get_feature_ds(chan))) {
        return -1;
    }
 
    res = general_set(cfg->global->general, data, value) &&
        xfer_set(cfg->global->xfer, data, value) &&
        pickup_set(cfg->global->pickup, data, value);
 
    if (res) {
        ast_log(LOG_WARNING, "Invalid argument '%s' to FEATURE()\n", data);
    }
 
    return res;
}

References ao2_cleanup, ast_log, ast_true(), ast_datastore::data, DATASTORE_INHERIT_FOREVER, general_set(), get_feature_chan_ds(), get_feature_ds(), ast_datastore::inheritance, lock, LOG_WARNING, NULL, pickup_set(), RAII_VAR, SCOPED_CHANNELLOCK, value, and xfer_set().

Referenced by feature_write().

internal_featuremap_read()

static int internal_featuremap_read ( struct ast_channel *  chan, const char *  cmd, char *  data, char *  buf, size_t  len  )

static

Definition at line 1743 of file features_config.c.

{
    int res;
    SCOPED_CHANNELLOCK(lock, chan);
 
    res = ast_get_builtin_feature(chan, data, buf, len);
 
    if (res) {
        ast_log(LOG_WARNING, "Invalid argument '%s' to FEATUREMAP()\n", data);
    }
 
    return res;
}

References ast_get_builtin_feature(), ast_log, buf, ast_datastore::data, len(), lock, LOG_WARNING, and SCOPED_CHANNELLOCK.

Referenced by featuremap_read().

internal_featuremap_write()

static int internal_featuremap_write ( struct ast_channel *  chan, const char *  cmd, char *  data, const char *  value  )

static

Definition at line 1758 of file features_config.c.

{
    int res;
    RAII_VAR(struct features_config *, cfg, NULL, ao2_cleanup);
    SCOPED_CHANNELLOCK(lock, chan);
 
    if (!(cfg = get_feature_ds(chan))) {
        return -1;
    }
 
    res = featuremap_set(cfg->featuremap, data, value);
    if (res) {
        ast_log(LOG_WARNING, "Invalid argument '%s' to FEATUREMAP()\n", data);
        return -1;
    }
 
    return 0;
}

References ao2_cleanup, ast_log, ast_datastore::data, featuremap_set(), get_feature_ds(), lock, LOG_WARNING, NULL, RAII_VAR, SCOPED_CHANNELLOCK, and value.

Referenced by featuremap_write().

load_config()

static int load_config ( void  )

static

Definition at line 1834 of file features_config.c.

{
    if (aco_info_init(&cfg_info)) {
        ast_log(LOG_ERROR, "Unable to initialize configuration info for features\n");
        return -1;
    }
 
    aco_option_register_custom(&cfg_info, "featuredigittimeout", ACO_EXACT, global_options,
            __stringify(DEFAULT_FEATURE_DIGIT_TIMEOUT), general_handler, 0);
    aco_option_register_custom(&cfg_info, "recordingfailsound", ACO_EXACT, global_options,
            DEFAULT_RECORDING_FAIL_SOUND, general_handler, 0);
    aco_option_register_custom(&cfg_info, "courtesytone", ACO_EXACT, global_options,
            DEFAULT_COURTESY_TONE, general_handler, 0);
 
    aco_option_register_custom(&cfg_info, "transferdigittimeout", ACO_EXACT, global_options,
            __stringify(DEFAULT_TRANSFER_DIGIT_TIMEOUT), xfer_handler, 0)
    aco_option_register_custom(&cfg_info, "atxfernoanswertimeout", ACO_EXACT, global_options,
            __stringify(DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER), xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "atxferdropcall", ACO_EXACT, global_options,
            __stringify(DEFAULT_ATXFER_DROP_CALL), xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "atxferloopdelay", ACO_EXACT, global_options,
            __stringify(DEFAULT_ATXFER_LOOP_DELAY), xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "atxfercallbackretries", ACO_EXACT, global_options,
            __stringify(DEFAULT_ATXFER_CALLBACK_RETRIES), xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "xfersound", ACO_EXACT, global_options,
            DEFAULT_XFERSOUND, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "xferfailsound", ACO_EXACT, global_options,
            DEFAULT_XFERFAILSOUND, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "atxferabort", ACO_EXACT, global_options,
            DEFAULT_ATXFER_ABORT, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "atxfercomplete", ACO_EXACT, global_options,
            DEFAULT_ATXFER_COMPLETE, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "atxferthreeway", ACO_EXACT, global_options,
            DEFAULT_ATXFER_THREEWAY, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "atxferswap", ACO_EXACT, global_options,
            DEFAULT_ATXFER_SWAP, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "transferdialattempts", ACO_EXACT, global_options,
            __stringify(DEFAULT_TRANSFER_DIAL_ATTEMPTS), xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "transferretrysound", ACO_EXACT, global_options,
            DEFAULT_TRANSFER_RETRY_SOUND, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "transferinvalidsound", ACO_EXACT, global_options,
            DEFAULT_TRANSFER_INVALID_SOUND, xfer_handler, 0);
    aco_option_register_custom(&cfg_info, "transferannouncesound", ACO_EXACT, global_options,
            DEFAULT_TRANSFER_ANNOUNCE_SOUND, xfer_handler, 0);
 
    aco_option_register_custom(&cfg_info, "pickupexten", ACO_EXACT, global_options,
            DEFAULT_PICKUPEXTEN, pickup_handler, 0);
    aco_option_register_custom(&cfg_info, "pickupsound", ACO_EXACT, global_options,
            DEFAULT_PICKUPSOUND, pickup_handler, 0);
    aco_option_register_custom(&cfg_info, "pickupfailsound", ACO_EXACT, global_options,
            DEFAULT_PICKUPFAILSOUND, pickup_handler, 0);
 
    aco_option_register_custom_nodoc(&cfg_info, "context", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkext", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkext_exclusive", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkinghints", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkedmusicclass", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkingtime", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkpos", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "findslot", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkedcalltransfers", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkedcallreparking", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkedcallhangup", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkedcallrecording", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "comebackcontext", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "comebacktoorigin", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "comebackdialtime", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "parkeddynamic", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
    aco_option_register_custom_nodoc(&cfg_info, "adsipark", ACO_EXACT, global_options,
            "", unsupported_handler, 0);
 
    aco_option_register_custom(&cfg_info, "blindxfer", ACO_EXACT, featuremap_options,
            DEFAULT_FEATUREMAP_BLINDXFER, featuremap_handler, 0);
    aco_option_register_custom(&cfg_info, "disconnect", ACO_EXACT, featuremap_options,
            DEFAULT_FEATUREMAP_DISCONNECT, featuremap_handler, 0);
    aco_option_register_custom(&cfg_info, "atxfer", ACO_EXACT, featuremap_options,
            DEFAULT_FEATUREMAP_ATXFER, featuremap_handler, 0);
    aco_option_register_custom(&cfg_info, "parkcall", ACO_EXACT, featuremap_options,
            DEFAULT_FEATUREMAP_PARKCALL, featuremap_handler, 0);
    aco_option_register_custom(&cfg_info, "automixmon", ACO_EXACT, featuremap_options,
            DEFAULT_FEATUREMAP_AUTOMIXMON, featuremap_handler, 0);
 
    aco_option_register_custom(&cfg_info, "", ACO_PREFIX, applicationmap_options,
            "", applicationmap_handler, 0);
 
    aco_option_register_custom(&cfg_info, "", ACO_PREFIX, featuregroup_options,
            "", featuregroup_handler, 0);
 
    aco_option_register_custom_nodoc(&cfg_info, "", ACO_PREFIX, parkinglot_options,
            "", unsupported_handler, 0);
 
    if (aco_process_config(&cfg_info, 0) == ACO_PROCESS_ERROR) {
        RAII_VAR(struct features_config *, features_cfg, features_config_alloc(), ao2_cleanup);
 
        if (aco_set_defaults(&global_option, "general", features_cfg->global) ||
            aco_set_defaults(&featuremap_option, "featuremap", features_cfg->featuremap)) {
            ast_log(LOG_ERROR, "Failed to load features.conf and failed to initialize defaults.\n");
            return -1;
        }
 
        ast_log(LOG_NOTICE, "Could not load features config; using defaults\n");
        ao2_global_obj_replace_unref(globals, features_cfg);
    }
 
    return 0;
}

References __stringify, ACO_EXACT, aco_info_init(), aco_option_register_custom, aco_option_register_custom_nodoc, ACO_PREFIX, aco_process_config(), ACO_PROCESS_ERROR, aco_set_defaults(), ao2_cleanup, ao2_global_obj_replace_unref, applicationmap_handler(), applicationmap_options, ast_log, DEFAULT_ATXFER_ABORT, DEFAULT_ATXFER_CALLBACK_RETRIES, DEFAULT_ATXFER_COMPLETE, DEFAULT_ATXFER_DROP_CALL, DEFAULT_ATXFER_LOOP_DELAY, DEFAULT_ATXFER_SWAP, DEFAULT_ATXFER_THREEWAY, DEFAULT_COURTESY_TONE, DEFAULT_FEATURE_DIGIT_TIMEOUT, DEFAULT_FEATUREMAP_ATXFER, DEFAULT_FEATUREMAP_AUTOMIXMON, DEFAULT_FEATUREMAP_BLINDXFER, DEFAULT_FEATUREMAP_DISCONNECT, DEFAULT_FEATUREMAP_PARKCALL, DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER, DEFAULT_PICKUPEXTEN, DEFAULT_PICKUPFAILSOUND, DEFAULT_PICKUPSOUND, DEFAULT_RECORDING_FAIL_SOUND, DEFAULT_TRANSFER_ANNOUNCE_SOUND, DEFAULT_TRANSFER_DIAL_ATTEMPTS, DEFAULT_TRANSFER_DIGIT_TIMEOUT, DEFAULT_TRANSFER_INVALID_SOUND, DEFAULT_TRANSFER_RETRY_SOUND, DEFAULT_XFERFAILSOUND, DEFAULT_XFERSOUND, featuregroup_handler(), featuregroup_options, featuremap_handler(), featuremap_option, featuremap_options, features_config_alloc(), general_handler(), global_option, global_options, globals, LOG_ERROR, LOG_NOTICE, parkinglot_options, pickup_handler(), RAII_VAR, unsupported_handler(), and xfer_handler().

Referenced by load_features_config().

load_features_config()

int load_features_config

(

void

)

Definition at line 2071 of file features_config.c.

{
    int res;
 
    res = load_config();
    res |= __ast_custom_function_register(&feature_function, NULL);
    res |= __ast_custom_function_register(&featuremap_function, NULL);
    res |= ast_cli_register_multiple(cli_features_config, ARRAY_LEN(cli_features_config));
 
    return res;
}

References __ast_custom_function_register(), ARRAY_LEN, ast_cli_register_multiple, cli_features_config, feature_function, featuremap_function, load_config(), and NULL.

Referenced by load_module().

pickup_copy()

static void pickup_copy ( struct ast_features_pickup_config *  dest, const struct ast_features_pickup_config *  src  )

static

Definition at line 874 of file features_config.c.

{
    ast_string_fields_copy(dest, src);
}

References ast_string_fields_copy.

Referenced by global_copy().

pickup_destructor()

static void pickup_destructor ( void *  obj )

static

Definition at line 755 of file features_config.c.

{
    struct ast_features_pickup_config *cfg = obj;
 
    ast_string_field_free_memory(cfg);
}

References ast_string_field_free_memory.

Referenced by global_config_alloc().

pickup_get()

static int pickup_get ( struct ast_features_pickup_config *  pickup, const char *  field, char *  buf, size_t  len  )

static

Definition at line 1057 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(field, "pickupsound")) {
        ast_copy_string(buf, pickup->pickupsound, len);
    } else if (!strcasecmp(field, "pickupfailsound")) {
        ast_copy_string(buf, pickup->pickupfailsound, len);
    } else if (!strcasecmp(field, "pickupexten")) {
        ast_copy_string(buf, pickup->pickupexten, len);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_copy_string(), buf, len(), ast_features_pickup_config::pickupexten, ast_features_pickup_config::pickupfailsound, and ast_features_pickup_config::pickupsound.

Referenced by internal_feature_read().

pickup_handler()

static int pickup_handler ( const struct aco_option *  opt, struct ast_variable *  var, void *  obj  )

static

Definition at line 1595 of file features_config.c.

{
    struct features_global_config *global = obj;
    struct ast_features_pickup_config *pickup = global->pickup;
 
    return pickup_set(pickup, var->name, var->value);
}

References global, pickup_set(), and var.

Referenced by load_config().

pickup_set()

static int pickup_set ( struct ast_features_pickup_config *  pickup, const char *  name, const char *  value  )

static

Definition at line 1038 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(name, "pickupsound")) {
        ast_string_field_set(pickup, pickupsound, value);
    } else if (!strcasecmp(name, "pickupfailsound")) {
        ast_string_field_set(pickup, pickupfailsound, value);
    } else if (!strcasecmp(name, "pickupexten")) {
        ast_string_field_set(pickup, pickupexten, value);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_string_field_set, name, and value.

Referenced by internal_feature_write(), and pickup_handler().

print_applicationmap()

static int print_applicationmap ( void *  obj, void *  arg, int  flags  )

static

Definition at line 1981 of file features_config.c.

{
    struct ast_applicationmap_item *item = obj;
    struct ast_cli_args *a = arg;
 
    ast_cli(a->fd, HFS_FORMAT, item->name, "no def", item->dtmf);
    return 0;
}

References a, ast_cli(), HFS_FORMAT, item, and aco_type::name.

Referenced by handle_feature_show().

print_featuregroup()

static int print_featuregroup ( void *  obj, void *  arg, int  flags  )

static

Definition at line 1957 of file features_config.c.

{
    struct featuregroup_item *item = obj;
    struct ast_cli_args *a = arg;
 
    ast_cli(a->fd, "===> --> %s (%s)\n", item->appmap_item_name,
            S_OR(item->dtmf_override, item->appmap_item->dtmf));
 
    return 0;
}

References a, ast_cli(), item, and S_OR.

Referenced by print_featuregroups().

print_featuregroups()

static int print_featuregroups ( void *  obj, void *  arg, int  flags  )

static

Definition at line 1968 of file features_config.c.

{
    struct featuregroup *group = obj;
    struct ast_cli_args *a = arg;
 
    ast_cli(a->fd, "===> Group: %s\n", group->name);
 
    ao2_callback(group->items, 0, print_featuregroup, a);
    return 0;
}

References a, ao2_callback, ast_cli(), group::name, and print_featuregroup().

Referenced by handle_feature_show().

reload_features_config()

int reload_features_config

(

void

)

Definition at line 2060 of file features_config.c.

{
    /* Rearm the parking config options have moved warning. */
    parking_warning = 0;
 
    if (aco_process_config(&cfg_info, 1) == ACO_PROCESS_ERROR) {
        return -1;
    }
    return 0;
}

References aco_process_config(), ACO_PROCESS_ERROR, and parking_warning.

unload_features_config()

void unload_features_config

(

void

)

Definition at line 2051 of file features_config.c.

{
    ast_custom_function_unregister(&featuremap_function);
    ast_custom_function_unregister(&feature_function);
    ast_cli_unregister_multiple(cli_features_config, ARRAY_LEN(cli_features_config));
    aco_info_destroy(&cfg_info);
    ao2_global_obj_release(globals);
}

References aco_info_destroy(), ao2_global_obj_release, ARRAY_LEN, ast_cli_unregister_multiple(), ast_custom_function_unregister(), cli_features_config, feature_function, featuremap_function, and globals.

Referenced by unload_module().

unsupported_handler()

static int unsupported_handler ( const struct aco_option *  opt, struct ast_variable *  var, void *  obj  )

static

Definition at line 1605 of file features_config.c.

{
    if (!parking_warning) {
        ast_log(LOG_WARNING, "Parkinglots are no longer configurable in features.conf; "
            "parking is now handled by res_parking.conf\n");
        parking_warning = 1;
    }
    ast_log(LOG_WARNING, "The option '%s' is no longer configurable in features.conf.\n", var->name);
    return 0;
}

References ast_log, LOG_WARNING, parking_warning, and var.

Referenced by load_config().

xfer_copy()

static void xfer_copy ( struct ast_features_xfer_config *  dest, const struct ast_features_xfer_config *  src  )

static

Definition at line 863 of file features_config.c.

{
    ast_string_fields_copy(dest, src);
    dest->transferdigittimeout = src->transferdigittimeout;
    dest->atxfernoanswertimeout = src->atxfernoanswertimeout;
    dest->atxferloopdelay = src->atxferloopdelay;
    dest->atxfercallbackretries = src->atxfercallbackretries;
    dest->atxferdropcall = src->atxferdropcall;
    dest->transferdialattempts = src->transferdialattempts;
}

References ast_string_fields_copy, ast_features_xfer_config::atxfercallbackretries, ast_features_xfer_config::atxferdropcall, ast_features_xfer_config::atxferloopdelay, ast_features_xfer_config::atxfernoanswertimeout, ast_features_xfer_config::transferdialattempts, and ast_features_xfer_config::transferdigittimeout.

Referenced by global_copy().

xfer_destructor()

static void xfer_destructor ( void *  obj )

static

Definition at line 748 of file features_config.c.

{
    struct ast_features_xfer_config *cfg = obj;
 
    ast_string_field_free_memory(cfg);
}

References ast_string_field_free_memory.

Referenced by global_config_alloc().

xfer_get()

static int xfer_get ( struct ast_features_xfer_config *  xfer, const char *  field, char *  buf, size_t  len  )

static

Definition at line 997 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(field, "transferdigittimeout")) {
        snprintf(buf, len, "%u", xfer->transferdigittimeout);
    } else if (!strcasecmp(field, "atxfernoanswertimeout")) {
        snprintf(buf, len, "%u", xfer->atxfernoanswertimeout);
    } else if (!strcasecmp(field, "atxferloopdelay")) {
        snprintf(buf, len, "%u", xfer->atxferloopdelay);
    } else if (!strcasecmp(field, "atxfercallbackretries")) {
        snprintf(buf, len, "%u", xfer->atxfercallbackretries);
    } else if (!strcasecmp(field, "atxferdropcall")) {
        snprintf(buf, len, "%u", xfer->atxferdropcall);
    } else if (!strcasecmp(field, "xfersound")) {
        ast_copy_string(buf, xfer->xfersound, len);
    } else if (!strcasecmp(field, "xferfailsound")) {
        ast_copy_string(buf, xfer->xferfailsound, len);
    } else if (!strcasecmp(field, "atxferabort")) {
        ast_copy_string(buf, xfer->atxferabort, len);
    } else if (!strcasecmp(field, "atxfercomplete")) {
        ast_copy_string(buf, xfer->atxfercomplete, len);
    } else if (!strcasecmp(field, "atxferthreeway")) {
        ast_copy_string(buf, xfer->atxferthreeway, len);
    } else if (!strcasecmp(field, "atxferswap")) {
        ast_copy_string(buf, xfer->atxferswap, len);
    } else if (!strcasecmp(field, "transferdialattempts")) {
        snprintf(buf, len, "%u", xfer->transferdialattempts);
    } else if (!strcasecmp(field, "transferretrysound")) {
        ast_copy_string(buf, xfer->transferretrysound, len);
    } else if (!strcasecmp(field, "transferinvalidsound")) {
        ast_copy_string(buf, xfer->transferinvalidsound, len);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_copy_string(), ast_features_xfer_config::atxferabort, ast_features_xfer_config::atxfercallbackretries, ast_features_xfer_config::atxfercomplete, ast_features_xfer_config::atxferdropcall, ast_features_xfer_config::atxferloopdelay, ast_features_xfer_config::atxfernoanswertimeout, ast_features_xfer_config::atxferswap, ast_features_xfer_config::atxferthreeway, buf, len(), ast_features_xfer_config::transferdialattempts, ast_features_xfer_config::transferdigittimeout, ast_features_xfer_config::transferinvalidsound, ast_features_xfer_config::transferretrysound, ast_features_xfer_config::xferfailsound, and ast_features_xfer_config::xfersound.

Referenced by internal_feature_read().

xfer_handler()

static int xfer_handler ( const struct aco_option *  opt, struct ast_variable *  var, void *  obj  )

static

Definition at line 1586 of file features_config.c.

{
    struct features_global_config *global = obj;
    struct ast_features_xfer_config *xfer = global->xfer;
 
    return xfer_set(xfer, var->name, var->value);
}

References global, var, and xfer_set().

Referenced by load_config().

xfer_set()

static int xfer_set ( struct ast_features_xfer_config *  xfer, const char *  name, const char *  value  )

static

Definition at line 954 of file features_config.c.

{
    int res = 0;
 
    if (!strcasecmp(name, "transferdigittimeout")) {
        res = ast_parse_arg(value, PARSE_INT32, &xfer->transferdigittimeout);
    } else if (!strcasecmp(name, "atxfernoanswertimeout")) {
        res = ast_parse_arg(value, PARSE_INT32, &xfer->atxfernoanswertimeout);
    } else if (!strcasecmp(name, "atxferloopdelay")) {
        res = ast_parse_arg(value, PARSE_INT32, &xfer->atxferloopdelay);
    } else if (!strcasecmp(name, "atxfercallbackretries")) {
        res = ast_parse_arg(value, PARSE_INT32, &xfer->atxfercallbackretries);
    } else if (!strcasecmp(name, "atxferdropcall")) {
        xfer->atxferdropcall = ast_true(value);
    } else if (!strcasecmp(name, "xfersound")) {
        ast_string_field_set(xfer, xfersound, value);
    } else if (!strcasecmp(name, "xferfailsound")) {
        ast_string_field_set(xfer, xferfailsound, value);
    } else if (!strcasecmp(name, "atxferabort")) {
        ast_string_field_set(xfer, atxferabort, value);
    } else if (!strcasecmp(name, "atxfercomplete")) {
        ast_string_field_set(xfer, atxfercomplete, value);
    } else if (!strcasecmp(name, "atxferthreeway")) {
        ast_string_field_set(xfer, atxferthreeway, value);
    } else if (!strcasecmp(name, "atxferswap")) {
        ast_string_field_set(xfer, atxferswap, value);
    } else if (!strcasecmp(name, "transferdialattempts")) {
        res = ast_parse_arg(value, PARSE_INT32, &xfer->transferdialattempts);
    } else if (!strcasecmp(name, "transferretrysound")) {
        ast_string_field_set(xfer, transferretrysound, value);
    } else if (!strcasecmp(name, "transferinvalidsound")) {
        ast_string_field_set(xfer, transferinvalidsound, value);
    } else if (!strcasecmp(name, "transferannouncesound")) {
        ast_string_field_set(xfer, transferannouncesound, value);
    } else {
        /* Unrecognized option */
        res = -1;
    }
 
    return res;
}

References ast_parse_arg(), ast_string_field_set, ast_true(), ast_features_xfer_config::atxfercallbackretries, ast_features_xfer_config::atxferdropcall, ast_features_xfer_config::atxferloopdelay, ast_features_xfer_config::atxfernoanswertimeout, name, PARSE_INT32, ast_features_xfer_config::transferdialattempts, ast_features_xfer_config::transferdigittimeout, and value.

Referenced by internal_feature_write(), and xfer_handler().

Variable Documentation

applicationmap_option

struct aco_type applicationmap_option

static

Definition at line 674 of file features_config.c.

                                               {
    .type = ACO_GLOBAL,
    .name = "applicationmap",
    .category_match = ACO_WHITELIST_EXACT,
    .category = "applicationmap",
    .item_offset = offsetof(struct features_config, applicationmap),
};

applicationmap_options

struct aco_type* applicationmap_options[] = ACO_TYPES(&applicationmap_option)

static

Definition at line 703 of file features_config.c.

Referenced by load_config().

cli_features_config

struct ast_cli_entry cli_features_config[]

static

Initial value:

= {
    { .handler =  handle_feature_show , .summary =  "Lists configured features" ,},
}

Definition at line 2047 of file features_config.c.

                                                    {
    AST_CLI_DEFINE(handle_feature_show, "Lists configured features"),
};

Referenced by load_features_config(), and unload_features_config().

feature_ds_info

const struct ast_datastore_info feature_ds_info

static

Initial value:

= {
    .type = "FEATURE",
    .destroy = feature_ds_destroy,
    .duplicate = feature_ds_duplicate,
}

Definition at line 1135 of file features_config.c.

                                                         {
    .type = "FEATURE",
    .destroy = feature_ds_destroy,
    .duplicate = feature_ds_duplicate,
};

Referenced by get_feature_chan_ds(), and get_feature_ds().

feature_function

struct ast_custom_function feature_function

static

Initial value:

= {
    .name = "FEATURE",
    .read = feature_read,
    .write = feature_write
}

Definition at line 1822 of file features_config.c.

                                                     {
    .name = "FEATURE",
    .read = feature_read,
    .write = feature_write
};

Referenced by load_features_config(), and unload_features_config().

featuregroup_option

struct aco_type featuregroup_option

static

Definition at line 682 of file features_config.c.

                                             {
    .type = ACO_ITEM,
    .name = "featuregroup",
    .category_match = ACO_BLACKLIST,
    .category = "^(general|featuremap|applicationmap|parkinglot_.*)$",
    .item_offset = offsetof(struct features_config, featuregroups),
    .item_alloc = featuregroup_alloc,
    .item_find = featuregroup_find,
};

featuregroup_options

struct aco_type* featuregroup_options[] = ACO_TYPES(&featuregroup_option)

static

Definition at line 704 of file features_config.c.

Referenced by load_config().

featuremap_function

struct ast_custom_function featuremap_function

static

Initial value:

= {
    .name = "FEATUREMAP",
    .read = featuremap_read,
    .write = featuremap_write
}

Definition at line 1828 of file features_config.c.

                                                        {
    .name = "FEATUREMAP",
    .read = featuremap_read,
    .write = featuremap_write
};

Referenced by load_features_config(), and unload_features_config().

featuremap_option

struct aco_type featuremap_option

static

Definition at line 666 of file features_config.c.

                                           {
    .type = ACO_GLOBAL,
    .name = "featuremap",
    .category_match = ACO_WHITELIST_EXACT,
    .category = "featuremap",
    .item_offset = offsetof(struct features_config, featuremap),
};

Referenced by load_config().

featuremap_options

struct aco_type* featuremap_options[] = ACO_TYPES(&featuremap_option)

static

Definition at line 702 of file features_config.c.

Referenced by load_config().

features_conf

struct aco_file features_conf

static

Initial value:

= {
    .filename = "features.conf",
    .types = ACO_TYPES(&global_option, &featuremap_option, &applicationmap_option, &featuregroup_option, &parkinglot_option),
}

Definition at line 707 of file features_config.c.

                                       {
    .filename = "features.conf",
    .types = ACO_TYPES(&global_option, &featuremap_option, &applicationmap_option, &featuregroup_option, &parkinglot_option),
};

global_option

struct aco_type global_option

static

Definition at line 658 of file features_config.c.

                                       {
    .type = ACO_GLOBAL,
    .name = "globals",
    .category_match = ACO_WHITELIST_EXACT,
    .category = "general",
    .item_offset = offsetof(struct features_config, global),
};

Referenced by load_config().

global_options

struct aco_type* global_options[] = ACO_TYPES(&global_option)

static

Definition at line 701 of file features_config.c.

Referenced by load_config().

parking_warning

int parking_warning = 0

static

Definition at line 1604 of file features_config.c.

Referenced by reload_features_config(), and unsupported_handler().

parkinglot_option

struct aco_type parkinglot_option

static

Definition at line 692 of file features_config.c.

                                           {
    .type = ACO_GLOBAL,
    .name = "parkinglot",
    .category_match = ACO_WHITELIST,
    .category = "^parkinglot_.*$",
    .item_offset = offsetof(struct features_config, parkinglots),
    .hidden = 1,
};

parkinglot_options

struct aco_type* parkinglot_options[] = ACO_TYPES(&parkinglot_option)

static

Definition at line 705 of file features_config.c.

Referenced by load_config().