102 static const char astdb_family[] =
"CustomDevstate";
104 static int devstate_read(
struct ast_channel *chan,
const char *cmd,
char *data,
char *buf,
size_t len)
111 static int devstate_write(
struct ast_channel *chan,
const char *cmd,
char *data,
const char *value)
113 size_t len = strlen(
"Custom:");
116 if (strncasecmp(data,
"Custom:", len)) {
117 ast_log(LOG_WARNING,
"The DEVICE_STATE function can only be used to set 'Custom:' device state!\n");
121 if (ast_strlen_zero(data)) {
122 ast_log(LOG_WARNING,
"DEVICE_STATE function called with no custom device name!\n");
129 ast_log(LOG_ERROR,
"DEVICE_STATE function given invalid state value '%s'\n", value);
141 HINT_OPT_NAME = (1 << 0),
148 static int hint_read(
struct ast_channel *chan,
const char *cmd,
char *data,
char *buf,
size_t len)
150 char *exten, *context;
158 if (ast_strlen_zero(data)) {
159 ast_log(LOG_WARNING,
"The HINT function requires an extension\n");
165 if (ast_strlen_zero(args.exten)) {
166 ast_log(LOG_WARNING,
"The HINT function requires an extension\n");
170 context = exten = args.exten;
171 strsep(&context,
"@");
172 if (ast_strlen_zero(context))
175 if (!ast_strlen_zero(args.options))
178 if (ast_test_flag(&opts, HINT_OPT_NAME))
179 res =
ast_get_hint(NULL, 0, buf, len, chan, context, exten);
181 res =
ast_get_hint(buf, len, NULL, 0, chan, context, exten);
191 ast_db_get(astdb_family, data, buf,
sizeof(buf));
204 "Usage: devstate list\n"
205 " List all custom device states that have been set by using\n"
206 " the DEVICE_STATE dialplan function.\n";
212 if (a->argc != e->
args)
213 return CLI_SHOWUSAGE;
216 "---------------------------------------------------------------------\n"
217 "--- Custom Device States --------------------------------------------\n"
218 "---------------------------------------------------------------------\n"
222 for (; db_entry; db_entry = db_entry->next) {
223 const char *dev_name = strrchr(db_entry->key,
'/') + 1;
224 if (dev_name <= (
const char *) 1)
226 ast_cli(a->fd,
"--- Name: 'Custom:%s' State: '%s'\n"
227 "---\n", dev_name, db_entry->data);
233 "---------------------------------------------------------------------\n"
234 "---------------------------------------------------------------------\n"
243 const char *dev, *
state;
248 e->
command =
"devstate change";
250 "Usage: devstate change <device> <state>\n"
251 " Change a custom device to a new state.\n"
252 " The possible values for the state are:\n"
253 "UNKNOWN | NOT_INUSE | INUSE | BUSY | INVALID | UNAVAILABLE | RINGING\n"
254 "RINGINUSE | ONHOLD\n"
257 " devstate change Custom:mystate1 INUSE\n"
258 " devstate change Custom:mystate1 NOT_INUSE\n"
263 static const char *
const cmds[] = {
"UNKNOWN",
"NOT_INUSE",
"INUSE",
"BUSY",
264 "UNAVAILABLE",
"RINGING",
"RINGINUSE",
"ONHOLD", NULL };
266 if (a->pos == e->
args + 1)
273 if (a->argc != e->
args + 2)
274 return CLI_SHOWUSAGE;
276 len = strlen(
"Custom:");
277 dev = a->argv[e->
args];
278 state = a->argv[e->
args + 1];
280 if (strncasecmp(dev,
"Custom:", len)) {
281 ast_cli(a->fd,
"The devstate command can only be used to set 'Custom:' device state!\n");
286 if (ast_strlen_zero(dev))
287 return CLI_SHOWUSAGE;
292 return CLI_SHOWUSAGE;
294 ast_cli(a->fd,
"Changing %s to %s\n", dev, state);
304 AST_CLI_DEFINE(handle_cli_devstate_list,
"List currently known custom device states"),
305 AST_CLI_DEFINE(handle_cli_devstate_change,
"Change a custom device state"),
309 .
name =
"DEVICE_STATE",
310 .read = devstate_read,
311 .write = devstate_write,
319 static int unload_module(
void)
331 static int load_module(
void)
339 for (; db_entry; db_entry = db_entry->next) {
340 const char *dev_name = strrchr(db_entry->key,
'/') + 1;
341 if (dev_name <= (
const char *) 1)
357 AST_MODULE_INFO(
ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER,
"Gets or sets a device state in the dialplan",
358 .support_level = AST_MODULE_SUPPORT_CORE,
360 .unload = unload_module,
int ast_get_hint(char *hint, int hintsize, char *name, int namesize, struct ast_channel *c, const char *context, const char *exten)
If an extension hint exists, return non-zero.
Main Channel structure associated with a channel.
ast_device_state
Device States.
Asterisk main include file. File version handling, generic pbx functions.
int ast_cli_unregister_multiple(struct ast_cli_entry *e, int len)
Unregister multiple commands.
#define AST_STANDARD_APP_ARGS(args, parse)
Performs the 'standard' argument separation process for an application.
descriptor for a cli entry.
void ast_db_freetree(struct ast_db_entry *entry)
Free structure created by ast_db_gettree()
int ast_devstate_prov_del(const char *label)
Remove device state provider.
#define ast_cli_register_multiple(e, len)
Register multiple commands.
int ast_devstate_prov_add(const char *label, ast_devstate_prov_cb_type callback)
Add device state provider.
int ast_custom_function_unregister(struct ast_custom_function *acf)
Unregister a custom function.
int args
This gets set in ast_cli_register()
char * ast_cli_complete(const char *word, const char *const choices[], int pos)
#define AST_APP_OPTIONS(holder, options...)
Declares an array of options for an application.
int ast_devstate_changed(enum ast_device_state state, enum ast_devstate_cache cachable, const char *fmt,...)
Tells Asterisk the State for Device is changed.
enum ast_device_state ast_devstate_val(const char *val)
Convert device state from text to integer value.
General Asterisk PBX channel definitions.
Data structure associated with a custom dialplan function.
A set of macros to manage forward-linked lists.
int ast_app_parse_options(const struct ast_app_option *options, struct ast_flags *flags, char **args, char *optstr)
Parses a string containing application options and sets flags/arguments.
Core PBX routines and definitions.
const char * ast_devstate_str(enum ast_device_state devstate) attribute_pure
Convert device state to text string that is easier to parse.
struct ast_db_entry * ast_db_gettree(const char *family, const char *keytree)
Get a list of values within the astdb tree.
int ast_db_get(const char *family, const char *key, char *value, int valuelen)
Get key value specified by family/key.
Structure used to handle boolean flags.
Standard Command Line Interface.
void ast_copy_string(char *dst, const char *src, size_t size)
Size-limited null-terminating string copy.
int ast_db_put(const char *family, const char *key, const char *value)
Store value addressed by family/key.
#define AST_APP_OPTION(option, flagno)
Declares an application option that does not accept an argument.
#define ASTERISK_GPL_KEY
The text the key() function should return.
Asterisk module definitions.
Persistent data storage (akin to *doze registry)
#define AST_DECLARE_APP_ARGS(name, arglist)
Declare a structure to hold an application's arguments.
Application convenience functions, designed to give consistent look and feel to Asterisk apps...
#define ast_custom_function_register(acf)
Register a custom function.
#define AST_APP_ARG(name)
Define an application argument.