func_devstate.c File Reference

Manually controlled blinky lights. More...

#include "asterisk.h"
#include "asterisk/module.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/utils.h"
#include "asterisk/linkedlists.h"
#include "asterisk/devicestate.h"
#include "asterisk/cli.h"
#include "asterisk/astdb.h"
#include "asterisk/app.h"

Include dependency graph for func_devstate.c:

Go to the source code of this file.

Enumerations
enum	{ HINT_OPT_NAME = (1 << 0) }

Functions
static void	__reg_module (void)
static void	__unreg_module (void)
struct ast_module *	AST_MODULE_SELF_SYM (void)
static enum ast_device_state	custom_devstate_callback (const char *data)
static int	devstate_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	devstate_write (struct ast_channel *chan, const char *cmd, char *data, const char *value)
static char *	handle_cli_devstate_change (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_cli_devstate_list (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static int	hint_read (struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t len)
static int	load_module (void)
static int	unload_module (void)

Variables
static struct ast_module_info	__mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Gets or sets a device state in the dialplan" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .support_level = AST_MODULE_SUPPORT_CORE, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEVSTATE_PROVIDER, }
static const struct ast_module_info *	ast_module_info = &__mod_info
static const char	astdb_family [] = "CustomDevstate"
static struct ast_cli_entry	cli_funcdevstate []
static struct ast_custom_function	devstate_function
static struct ast_custom_function	hint_function
static const struct ast_app_option	hint_options [128] = { [ 'n' ] = { .flag = HINT_OPT_NAME }, }

Detailed Description

Manually controlled blinky lights.

Author

Russell Bryant russe.nosp@m.ll@d.nosp@m.igium.nosp@m..com

Todo:

Delete the entry from AstDB when set to nothing like Set(DEVICE_STATE(Custom:lamp1)=)

Note

Props go out to Ahrimanes in #asterisk for requesting this at 4:30 AM when I couldn't sleep. :)

Definition in file func_devstate.c.

Enumeration Type Documentation

anonymous enum

anonymous enum

Enumerator
HINT_OPT_NAME

Definition at line 140 of file func_devstate.c.

     {
    HINT_OPT_NAME = (1 << 0),
};

Function Documentation

__reg_module()

static void __reg_module ( void  )

static

Definition at line 362 of file func_devstate.c.

__unreg_module()

static void __unreg_module ( void  )

static

Definition at line 362 of file func_devstate.c.

AST_MODULE_SELF_SYM()

struct ast_module * AST_MODULE_SELF_SYM

(

void

)

Definition at line 362 of file func_devstate.c.

custom_devstate_callback()

static enum ast_device_state custom_devstate_callback ( const char *  data )

static

Definition at line 186 of file func_devstate.c.

{
    char buf[256] = "";
 
    /* Ignore check_return warning from Coverity fow ast_db_get below */
    ast_db_get(astdb_family, data, buf, sizeof(buf));
 
    return ast_devstate_val(buf);
}

References ast_db_get(), ast_devstate_val(), astdb_family, and buf.

Referenced by load_module().

devstate_read()

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

static

Definition at line 104 of file func_devstate.c.

{
    ast_copy_string(buf, ast_devstate_str(ast_device_state(data)), len);
 
    return 0;
}

References ast_copy_string(), ast_devstate_str(), buf, and len().

devstate_write()

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

static

Definition at line 111 of file func_devstate.c.

{
    size_t len = strlen("Custom:");
    enum ast_device_state state_val;
 
    if (strncasecmp(data, "Custom:", len)) {
        ast_log(LOG_WARNING, "The DEVICE_STATE function can only be used to set 'Custom:' device state!\n");
        return -1;
    }
    data += len;
    if (ast_strlen_zero(data)) {
        ast_log(LOG_WARNING, "DEVICE_STATE function called with no custom device name!\n");
        return -1;
    }
 
    state_val = ast_devstate_val(value);
 
    if (state_val == AST_DEVICE_UNKNOWN) {
        ast_log(LOG_ERROR, "DEVICE_STATE function given invalid state value '%s'\n", value);
        return -1;
    }
 
    ast_db_put(astdb_family, data, value);
 
    ast_devstate_changed(state_val, AST_DEVSTATE_CACHABLE, "Custom:%s", data);
 
    return 0;
}

References ast_db_put(), AST_DEVICE_UNKNOWN, AST_DEVSTATE_CACHABLE, ast_devstate_changed(), ast_devstate_val(), ast_log, ast_strlen_zero(), astdb_family, len(), LOG_ERROR, LOG_WARNING, and value.

handle_cli_devstate_change()

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

static

Definition at line 240 of file func_devstate.c.

{
    size_t len;
    const char *dev, *state;
    enum ast_device_state state_val;
 
    switch (cmd) {
    case CLI_INIT:
        e->command = "devstate change";
        e->usage =
            "Usage: devstate change <device> <state>\n"
            "       Change a custom device to a new state.\n"
            "       The possible values for the state are:\n"
            "UNKNOWN | NOT_INUSE | INUSE | BUSY | INVALID | UNAVAILABLE | RINGING\n"
            "RINGINUSE | ONHOLD\n"
            "\n"
            "Examples:\n"
            "       devstate change Custom:mystate1 INUSE\n"
            "       devstate change Custom:mystate1 NOT_INUSE\n"
            "       \n";
        return NULL;
    case CLI_GENERATE:
    {
        static const char * const cmds[] = { "UNKNOWN", "NOT_INUSE", "INUSE", "BUSY",
                             "UNAVAILABLE", "RINGING", "RINGINUSE", "ONHOLD", NULL };
 
        if (a->pos == e->args + 1)
            return ast_cli_complete(a->word, cmds, a->n);
 
        return NULL;
    }
    }
 
    if (a->argc != e->args + 2)
        return CLI_SHOWUSAGE;
 
    len = strlen("Custom:");
    dev = a->argv[e->args];
    state = a->argv[e->args + 1];
 
    if (strncasecmp(dev, "Custom:", len)) {
        ast_cli(a->fd, "The devstate command can only be used to set 'Custom:' device state!\n");
        return CLI_FAILURE;
    }
 
    dev += len;
    if (ast_strlen_zero(dev))
        return CLI_SHOWUSAGE;
 
    state_val = ast_devstate_val(state);
 
    if (state_val == AST_DEVICE_UNKNOWN)
        return CLI_SHOWUSAGE;
 
    ast_cli(a->fd, "Changing %s to %s\n", dev, state);
 
    ast_db_put(astdb_family, dev, state);
 
    ast_devstate_changed(state_val, AST_DEVSTATE_CACHABLE, "Custom:%s", dev);
 
    return CLI_SUCCESS;
}

References a, ast_cli_entry::args, ast_cli(), ast_cli_complete(), ast_db_put(), AST_DEVICE_UNKNOWN, AST_DEVSTATE_CACHABLE, ast_devstate_changed(), ast_devstate_val(), ast_strlen_zero(), astdb_family, CLI_FAILURE, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, len(), NULL, state, and ast_cli_entry::usage.

handle_cli_devstate_list()

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

static

Definition at line 196 of file func_devstate.c.

{
    struct ast_db_entry *db_entry, *db_tree;
 
    switch (cmd) {
    case CLI_INIT:
        e->command = "devstate list";
        e->usage =
            "Usage: devstate list\n"
            "       List all custom device states that have been set by using\n"
            "       the DEVICE_STATE dialplan function.\n";
        return NULL;
    case CLI_GENERATE:
        return NULL;
    }
 
    if (a->argc != e->args)
        return CLI_SHOWUSAGE;
 
    ast_cli(a->fd, "\n"
            "---------------------------------------------------------------------\n"
            "--- Custom Device States --------------------------------------------\n"
            "---------------------------------------------------------------------\n"
            "---\n");
 
    db_entry = db_tree = ast_db_gettree(astdb_family, NULL);
    for (; db_entry; db_entry = db_entry->next) {
        const char *dev_name = strrchr(db_entry->key, '/') + 1;
        if (dev_name <= (const char *) 1)
            continue;
        ast_cli(a->fd, "--- Name: 'Custom:%s'  State: '%s'\n"
                       "---\n", dev_name, db_entry->data);
    }
    ast_db_freetree(db_tree);
    db_tree = NULL;
 
    ast_cli(a->fd,
            "---------------------------------------------------------------------\n"
            "---------------------------------------------------------------------\n"
            "\n");
 
    return CLI_SUCCESS;
}

References a, ast_cli_entry::args, ast_cli(), ast_db_freetree(), ast_db_gettree(), astdb_family, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, ast_db_entry::data, ast_db_entry::key, ast_db_entry::next, NULL, and ast_cli_entry::usage.

hint_read()

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

static

Definition at line 148 of file func_devstate.c.

{
    char *exten, *context;
    AST_DECLARE_APP_ARGS(args,
        AST_APP_ARG(exten);
        AST_APP_ARG(options);
    );
    struct ast_flags opts = { 0, };
    int res;
 
    if (ast_strlen_zero(data)) {
        ast_log(LOG_WARNING, "The HINT function requires an extension\n");
        return -1;
    }
 
    AST_STANDARD_APP_ARGS(args, data);
 
    if (ast_strlen_zero(args.exten)) {
        ast_log(LOG_WARNING, "The HINT function requires an extension\n");
        return -1;
    }
 
    context = exten = args.exten;
    strsep(&context, "@");
    if (ast_strlen_zero(context))
        context = "default";
 
    if (!ast_strlen_zero(args.options))
        ast_app_parse_options(hint_options, &opts, NULL, args.options);
 
    if (ast_test_flag(&opts, HINT_OPT_NAME))
        res = ast_get_hint(NULL, 0, buf, len, chan, context, exten);
    else
        res = ast_get_hint(buf, len, NULL, 0, chan, context, exten);
 
    return !res; /* ast_get_hint returns non-zero on success */
}

References args, AST_APP_ARG, ast_app_parse_options(), AST_DECLARE_APP_ARGS, ast_get_hint(), ast_log, AST_STANDARD_APP_ARGS, ast_strlen_zero(), ast_test_flag, buf, voicemailpwcheck::context, HINT_OPT_NAME, hint_options, len(), LOG_WARNING, NULL, options, and strsep().

load_module()

static int load_module ( void  )

static

Definition at line 331 of file func_devstate.c.

{
    int res = 0;
    struct ast_db_entry *db_entry, *db_tree;
 
    /* Populate the device state cache on the system with all of the currently
     * known custom device states. */
    db_entry = db_tree = ast_db_gettree(astdb_family, NULL);
    for (; db_entry; db_entry = db_entry->next) {
        const char *dev_name = strrchr(db_entry->key, '/') + 1;
        if (dev_name <= (const char *) 1)
            continue;
        ast_devstate_changed(ast_devstate_val(db_entry->data),
            AST_DEVSTATE_CACHABLE, "Custom:%s", dev_name);
    }
    ast_db_freetree(db_tree);
    db_tree = NULL;
 
    res |= ast_custom_function_register(&devstate_function);
    res |= ast_custom_function_register(&hint_function);
    res |= ast_devstate_prov_add("Custom", custom_devstate_callback);
    res |= ast_cli_register_multiple(cli_funcdevstate, ARRAY_LEN(cli_funcdevstate));
 
    return res;
}

References ARRAY_LEN, ast_cli_register_multiple, ast_custom_function_register, ast_db_freetree(), ast_db_gettree(), AST_DEVSTATE_CACHABLE, ast_devstate_changed(), ast_devstate_prov_add(), ast_devstate_val(), astdb_family, cli_funcdevstate, custom_devstate_callback(), ast_db_entry::data, devstate_function, hint_function, ast_db_entry::key, ast_db_entry::next, and NULL.

unload_module()

static int unload_module ( void  )

static

Definition at line 319 of file func_devstate.c.

{
    int res = 0;
 
    res |= ast_custom_function_unregister(&devstate_function);
    res |= ast_custom_function_unregister(&hint_function);
    res |= ast_devstate_prov_del("Custom");
    res |= ast_cli_unregister_multiple(cli_funcdevstate, ARRAY_LEN(cli_funcdevstate));
 
    return res;
}

References ARRAY_LEN, ast_cli_unregister_multiple(), ast_custom_function_unregister(), ast_devstate_prov_del(), cli_funcdevstate, devstate_function, and hint_function.

Variable Documentation

__mod_info

struct ast_module_info __mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_LOAD_ORDER , .description = "Gets or sets a device state in the dialplan" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = AST_BUILDOPT_SUM, .support_level = AST_MODULE_SUPPORT_CORE, .load = load_module, .unload = unload_module, .load_pri = AST_MODPRI_DEVSTATE_PROVIDER, }

static

Definition at line 362 of file func_devstate.c.

ast_module_info

const struct ast_module_info* ast_module_info = &__mod_info

static

Definition at line 362 of file func_devstate.c.

astdb_family

const char astdb_family[] = "CustomDevstate"

static

Definition at line 102 of file func_devstate.c.

Referenced by custom_devstate_callback(), devstate_write(), handle_cli_devstate_change(), handle_cli_devstate_list(), and load_module().

cli_funcdevstate

struct ast_cli_entry cli_funcdevstate[]

static

Initial value:

= {
    { .handler =  handle_cli_devstate_list , .summary =  "List currently known custom device states" ,},
    { .handler =  handle_cli_devstate_change , .summary =  "Change a custom device state" ,},
}

Definition at line 303 of file func_devstate.c.

Referenced by load_module(), and unload_module().

devstate_function

struct ast_custom_function devstate_function

static

Initial value:

= {
    .name = "DEVICE_STATE",
    .read = devstate_read,
    .write = devstate_write,
}

Definition at line 308 of file func_devstate.c.

Referenced by load_module(), and unload_module().

hint_function

struct ast_custom_function hint_function

static

Initial value:

= {
    .name = "HINT",
    .read = hint_read,
}

Definition at line 314 of file func_devstate.c.

Referenced by load_module(), and unload_module().

hint_options

const struct ast_app_option hint_options[128] = { [ 'n' ] = { .flag = HINT_OPT_NAME }, }

static

Definition at line 146 of file func_devstate.c.

Referenced by hint_read().