Much needed was a way to assign id to objects on creation, and much change was necessary to accomplish it. Channel uniqueids and linkedids are split into separate string and creation time components without breaking linkedid propgation. This allowed the uniqueid to be specified by the user interface - and those values are now carried through to channel creation, adding the assignedids value to every function in the chain including the channel drivers. For local channels, the second channel can be specified or left to default to a ;2 suffix of first. In ARI, bridge, playback, and snoop objects can also be created with a specified uniqueid. Along the way, the args order to allocating channels was fixed in chan_mgcp and chan_gtalk, and linkedid is no longer lost as masquerade occurs. (closes issue ASTERISK-23120) Review: https://reviewboard.asterisk.org/r/3191/ ........ Merged revisions 410157 from http://svn.asterisk.org/svn/asterisk/branches/12 git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@410158 65c4cc65-6c06-0410-ace0-fbb531ad65f3
215 lines
6.6 KiB
C
215 lines
6.6 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
|
|
*/
|
|
|
|
/*** MODULEINFO
|
|
<support_level>extended</support_level>
|
|
***/
|
|
|
|
#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 device state for the device</para>
|
|
</variable>
|
|
<variable name="AVAILCAUSECODE">
|
|
<para>The cause code returned when requesting the 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_str *tmp_availcause = 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++;
|
|
|
|
status = AST_DEVICE_UNKNOWN;
|
|
|
|
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);
|
|
}
|
|
snprintf(tmp, sizeof(tmp), "%d", status);
|
|
ast_str_append(&tmp_availstat, 0, "%s%s", ast_str_strlen(tmp_availstat) ? "&" : "", tmp);
|
|
if ((inuse <= 1) && (tempchan = ast_request(tech, ast_channel_nativeformats(chan), NULL, chan, number, &status))) {
|
|
ast_str_append(&tmp_availchan, 0, "%s%s", ast_str_strlen(tmp_availchan) ? "&" : "", ast_channel_name(tempchan));
|
|
|
|
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_availcause, 0, "%s%s", ast_str_strlen(tmp_availcause) ? "&" : "", tmp);
|
|
|
|
ast_hangup(tempchan);
|
|
tempchan = NULL;
|
|
|
|
if (!option_all_avail) {
|
|
break;
|
|
}
|
|
}
|
|
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));
|
|
pbx_builtin_setvar_helper(chan, "AVAILCAUSECODE", ast_str_buffer(tmp_availcause));
|
|
|
|
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");
|