git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@199479 65c4cc65-6c06-0410-ace0-fbb531ad65f3
205 lines
6.2 KiB
C
205 lines
6.2 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 1999 - 2005, Digium, Inc.
|
|
*
|
|
* Mark Spencer <markster@digium.com>
|
|
* James Golovich <james@gnuinter.net>
|
|
*
|
|
* See http://www.asterisk.org for more information about
|
|
* the Asterisk project. Please do not directly contact
|
|
* any of the maintainers of this project for assistance;
|
|
* the project provides a web site, mailing lists and IRC
|
|
* channels for your use.
|
|
*
|
|
* This program is free software, distributed under the terms of
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
* at the top of the source tree.
|
|
*/
|
|
|
|
/*! \file
|
|
*
|
|
* \brief Check if Channel is Available
|
|
*
|
|
* \author Mark Spencer <markster@digium.com>
|
|
* \author James Golovich <james@gnuinter.net>
|
|
|
|
* \ingroup applications
|
|
*/
|
|
|
|
#include "asterisk.h"
|
|
|
|
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
|
|
|
|
#include <sys/ioctl.h>
|
|
|
|
#include "asterisk/lock.h"
|
|
#include "asterisk/file.h"
|
|
#include "asterisk/channel.h"
|
|
#include "asterisk/pbx.h"
|
|
#include "asterisk/module.h"
|
|
#include "asterisk/app.h"
|
|
#include "asterisk/devicestate.h"
|
|
|
|
static const char app[] = "ChanIsAvail";
|
|
|
|
/*** DOCUMENTATION
|
|
<application name="ChanIsAvail" language="en_US">
|
|
<synopsis>
|
|
Check channel availability
|
|
</synopsis>
|
|
<syntax>
|
|
<parameter name="Technology/Resource" required="true" argsep="&">
|
|
<argument name="Technology2/Resource2" multiple="true">
|
|
<para>Optional extra devices to check</para>
|
|
<para>If you need more then one enter them as
|
|
Technology2/Resource2&Technology3/Resourse3&.....</para>
|
|
</argument>
|
|
<para>Specification of the device(s) to check. These must be in the format of
|
|
<literal>Technology/Resource</literal>, where <replaceable>Technology</replaceable>
|
|
represents a particular channel driver, and <replaceable>Resource</replaceable>
|
|
represents a resource available to that particular channel driver.</para>
|
|
</parameter>
|
|
<parameter name="options" required="false">
|
|
<optionlist>
|
|
<option name="a">
|
|
<para>Check for all available channels, not only the first one</para>
|
|
</option>
|
|
<option name="s">
|
|
<para>Consider the channel unavailable if the channel is in use at all</para>
|
|
</option>
|
|
<option name="t" implies="s">
|
|
<para>Simply checks if specified channels exist in the channel list</para>
|
|
</option>
|
|
</optionlist>
|
|
</parameter>
|
|
</syntax>
|
|
<description>
|
|
<para>This application will check to see if any of the specified channels are available.</para>
|
|
<para>This application sets the following channel variables:</para>
|
|
<variablelist>
|
|
<variable name="AVAILCHAN">
|
|
<para>The name of the available channel, if one exists</para>
|
|
</variable>
|
|
<variable name="AVAILORIGCHAN">
|
|
<para>The canonical channel name that was used to create the channel</para>
|
|
</variable>
|
|
<variable name="AVAILSTATUS">
|
|
<para>The status code for the available channel</para>
|
|
</variable>
|
|
</variablelist>
|
|
</description>
|
|
</application>
|
|
***/
|
|
|
|
static int chanavail_exec(struct ast_channel *chan, const char *data)
|
|
{
|
|
int inuse=-1, option_state=0, string_compare=0, option_all_avail=0;
|
|
int status;
|
|
char *info, tmp[512], trychan[512], *peers, *tech, *number, *rest, *cur;
|
|
struct ast_str *tmp_availchan = ast_str_alloca(2048);
|
|
struct ast_str *tmp_availorig = ast_str_alloca(2048);
|
|
struct ast_str *tmp_availstat = ast_str_alloca(2048);
|
|
struct ast_channel *tempchan;
|
|
AST_DECLARE_APP_ARGS(args,
|
|
AST_APP_ARG(reqchans);
|
|
AST_APP_ARG(options);
|
|
);
|
|
|
|
if (ast_strlen_zero(data)) {
|
|
ast_log(LOG_WARNING, "ChanIsAvail requires an argument (DAHDI/1&DAHDI/2)\n");
|
|
return -1;
|
|
}
|
|
|
|
info = ast_strdupa(data);
|
|
|
|
AST_STANDARD_APP_ARGS(args, info);
|
|
|
|
if (args.options) {
|
|
if (strchr(args.options, 'a')) {
|
|
option_all_avail = 1;
|
|
}
|
|
if (strchr(args.options, 's')) {
|
|
option_state = 1;
|
|
}
|
|
if (strchr(args.options, 't')) {
|
|
string_compare = 1;
|
|
}
|
|
}
|
|
peers = args.reqchans;
|
|
if (peers) {
|
|
cur = peers;
|
|
do {
|
|
/* remember where to start next time */
|
|
rest = strchr(cur, '&');
|
|
if (rest) {
|
|
*rest = 0;
|
|
rest++;
|
|
}
|
|
tech = cur;
|
|
number = strchr(tech, '/');
|
|
if (!number) {
|
|
ast_log(LOG_WARNING, "ChanIsAvail argument takes format ([technology]/[device])\n");
|
|
return -1;
|
|
}
|
|
*number = '\0';
|
|
number++;
|
|
|
|
if (string_compare) {
|
|
/* ast_parse_device_state checks for "SIP/1234" as a channel name.
|
|
ast_device_state will ask the SIP driver for the channel state. */
|
|
|
|
snprintf(trychan, sizeof(trychan), "%s/%s",cur,number);
|
|
status = inuse = ast_parse_device_state(trychan);
|
|
} else if (option_state) {
|
|
/* If the pbx says in use then don't bother trying further.
|
|
This is to permit testing if someone's on a call, even if the
|
|
channel can permit more calls (ie callwaiting, sip calls, etc). */
|
|
|
|
snprintf(trychan, sizeof(trychan), "%s/%s",cur,number);
|
|
status = inuse = ast_device_state(trychan);
|
|
}
|
|
if ((inuse <= 1) && (tempchan = ast_request(tech, chan->nativeformats, number, &status))) {
|
|
ast_str_append(&tmp_availchan, 0, "%s%s", ast_str_strlen(tmp_availchan) ? "&" : "", tempchan->name);
|
|
|
|
snprintf(tmp, sizeof(tmp), "%s/%s", tech, number);
|
|
ast_str_append(&tmp_availorig, 0, "%s%s", ast_str_strlen(tmp_availorig) ? "&" : "", tmp);
|
|
|
|
snprintf(tmp, sizeof(tmp), "%d", status);
|
|
ast_str_append(&tmp_availstat, 0, "%s%s", ast_str_strlen(tmp_availstat) ? "&" : "", tmp);
|
|
|
|
ast_hangup(tempchan);
|
|
tempchan = NULL;
|
|
|
|
if (!option_all_avail) {
|
|
break;
|
|
}
|
|
} else {
|
|
snprintf(tmp, sizeof(tmp), "%d", status);
|
|
ast_str_append(&tmp_availstat, 0, "%s%s", ast_str_strlen(tmp_availstat) ? "&" : "", tmp);
|
|
}
|
|
cur = rest;
|
|
} while (cur);
|
|
}
|
|
|
|
pbx_builtin_setvar_helper(chan, "AVAILCHAN", ast_str_buffer(tmp_availchan));
|
|
/* Store the originally used channel too */
|
|
pbx_builtin_setvar_helper(chan, "AVAILORIGCHAN", ast_str_buffer(tmp_availorig));
|
|
pbx_builtin_setvar_helper(chan, "AVAILSTATUS", ast_str_buffer(tmp_availstat));
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int unload_module(void)
|
|
{
|
|
return ast_unregister_application(app);
|
|
}
|
|
|
|
static int load_module(void)
|
|
{
|
|
return ast_register_application_xml(app, chanavail_exec) ?
|
|
AST_MODULE_LOAD_DECLINE : AST_MODULE_LOAD_SUCCESS;
|
|
}
|
|
|
|
AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Check channel availability");
|