Git does not support the ability to replace a token with a version string during check-in. While it does have support for replacing a token on clone, this is somewhat sub-optimal: the token is replaced with the object hash, which is not particularly easy for human consumption. What's more, in practice, the source file version was often not terribly useful. Generally, when triaging bugs, the overall version of Asterisk is far more useful than an individual SVN version of a file. As a result, this patch removes Asterisk's support for showing source file versions. Specifically, it does the following: * Rename ASTERISK_FILE_VERSION macro to ASTERISK_REGISTER_FILE, and remove passing the version in with the macro. Other facilities than 'core show file version' make use of the file names, such as setting a debug level only on a specific file. As such, the act of registering source files with the Asterisk core still has use. The macro rename now reflects the new macro purpose. * main/asterisk: - Refactor the file_version structure to reflect that it no longer tracks a version field. - Remove the "core show file version" CLI command. Without the file version, it is no longer useful. - Remove the ast_file_version_find function. The file version is no longer tracked. - Rename ast_register_file_version/ast_unregister_file_version to ast_register_file/ast_unregister_file, respectively. * main/manager: Remove value from the Version key of the ModuleCheck Action. The actual key itself has not been removed, as doing so would absolutely constitute a backwards incompatible change. However, since the file version is no longer tracked, there is no need to attempt to include it in the Version key. * UPGRADE: Add notes for: - Modification to the ModuleCheck AMI Action - Removal of the "core show file version" CLI command Change-Id: I6cf0ff280e1668bf4957dc21f32a5ff43444a40e
216 lines
6.6 KiB
C
216 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_REGISTER_FILE()
|
|
|
|
#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_EXTENDED(ASTERISK_GPL_KEY, "Check channel availability");
|
|
|