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
386 lines
11 KiB
C
386 lines
11 KiB
C
/*
|
|
* Asterisk -- An open source telephony toolkit.
|
|
*
|
|
* Copyright (C) 2008 - 2009, Digium, Inc.
|
|
*
|
|
* Steve Murphy <murf@digium.com>
|
|
* who freely borrowed code from the cdr equivalents
|
|
* (see cdr/cdr_manager.c)
|
|
*
|
|
* 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 Asterisk Channel Event records.
|
|
*
|
|
* See also
|
|
* \arg \ref AstCDR
|
|
* \arg \ref AstAMI
|
|
* \arg \ref Config_ami
|
|
* \ingroup cel_drivers
|
|
*/
|
|
|
|
/*** MODULEINFO
|
|
<support_level>core</support_level>
|
|
***/
|
|
|
|
/*** DOCUMENTATION
|
|
<managerEvent language="en_US" name="CEL">
|
|
<managerEventInstance class="EVENT_FLAG_CEL">
|
|
<synopsis>Raised when a Channel Event Log is generated for a channel.</synopsis>
|
|
<syntax>
|
|
<parameter name="EventName">
|
|
<para>
|
|
The name of the CEL event being raised. This can include
|
|
both the system defined CEL events, as well as user defined
|
|
events.
|
|
</para>
|
|
<note>
|
|
<para>All events listed here may not be raised, depending
|
|
on the configuration in <filename>cel.conf</filename>.</para>
|
|
</note>
|
|
<enumlist>
|
|
<enum name="CHAN_START">
|
|
<para>A channel was created.</para>
|
|
</enum>
|
|
<enum name="CHAN_END">
|
|
<para>A channel was terminated.</para>
|
|
</enum>
|
|
<enum name="ANSWER">
|
|
<para>A channel answered.</para>
|
|
</enum>
|
|
<enum name="HANGUP">
|
|
<para>A channel was hung up.</para>
|
|
</enum>
|
|
<enum name="BRIDGE_ENTER">
|
|
<para>A channel entered a bridge.</para>
|
|
</enum>
|
|
<enum name="BRIDGE_EXIT">
|
|
<para>A channel left a bridge.</para>
|
|
</enum>
|
|
<enum name="APP_START">
|
|
<para>A channel entered into a tracked application.</para>
|
|
</enum>
|
|
<enum name="APP_END">
|
|
<para>A channel left a tracked application.</para>
|
|
</enum>
|
|
<enum name="PARK_START">
|
|
<para>A channel was parked.</para>
|
|
</enum>
|
|
<enum name="PARK_END">
|
|
<para>A channel was unparked.</para>
|
|
</enum>
|
|
<enum name="BLINDTRANSFER">
|
|
<para>A channel initiated a blind transfer.</para>
|
|
</enum>
|
|
<enum name="ATTENDEDTRANSFER">
|
|
<para>A channel initiated an attended transfer.</para>
|
|
</enum>
|
|
<enum name="PICKUP">
|
|
<para>A channel initated a call pickup.</para>
|
|
</enum>
|
|
<enum name="FORWARD">
|
|
<para>A channel is being forwarded to another destination.</para>
|
|
</enum>
|
|
<enum name="LINKEDID_END">
|
|
<para>The linked ID associated with this channel is being retired.</para>
|
|
</enum>
|
|
<enum name="LOCAL_OPTIMIZE">
|
|
<para>A Local channel optimization has occurred.</para>
|
|
</enum>
|
|
<enum name="USER_DEFINED">
|
|
<para>A user defined type.</para>
|
|
<note>
|
|
<para>
|
|
This event is only present if <literal>show_user_defined</literal>
|
|
in <filename>cel.conf</filename> is <literal>True</literal>. Otherwise,
|
|
the user defined event will be placed directly in the
|
|
<replaceable>EventName</replaceable> field.
|
|
</para>
|
|
</note>
|
|
</enum>
|
|
</enumlist>
|
|
</parameter>
|
|
<parameter name="AccountCode">
|
|
<para>The channel's account code.</para>
|
|
</parameter>
|
|
<parameter name="CallerIDnum">
|
|
<para>The Caller ID number.</para>
|
|
</parameter>
|
|
<parameter name="CallerIDname">
|
|
<para>The Caller ID name.</para>
|
|
</parameter>
|
|
<parameter name="CallerIDani">
|
|
<para>The Caller ID Automatic Number Identification.</para>
|
|
</parameter>
|
|
<parameter name="CallerIDrdnis">
|
|
<para>The Caller ID Redirected Dialed Number Identification Service.</para>
|
|
</parameter>
|
|
<parameter name="CallerIDdnid">
|
|
<para>The Caller ID Dialed Number Identifier.</para>
|
|
</parameter>
|
|
<parameter name="Exten">
|
|
<para>The dialplan extension the channel is currently executing in.</para>
|
|
</parameter>
|
|
<parameter name="Context">
|
|
<para>The dialplan context the channel is currently executing in.</para>
|
|
</parameter>
|
|
<parameter name="Application">
|
|
<para>The dialplan application the channel is currently executing.</para>
|
|
</parameter>
|
|
<parameter name="AppData">
|
|
<para>The arguments passed to the dialplan <replaceable>Application</replaceable>.</para>
|
|
</parameter>
|
|
<parameter name="EventTime">
|
|
<para>The time the CEL event occurred.</para>
|
|
</parameter>
|
|
<parameter name="AMAFlags">
|
|
<para>A flag that informs a billing system how to treat the CEL.</para>
|
|
<enumlist>
|
|
<enum name="OMIT">
|
|
<para>This event should be ignored.</para>
|
|
</enum>
|
|
<enum name="BILLING">
|
|
<para>This event contains valid billing data.</para>
|
|
</enum>
|
|
<enum name="DOCUMENTATION">
|
|
<para>This event is for documentation purposes.</para>
|
|
</enum>
|
|
</enumlist>
|
|
</parameter>
|
|
<parameter name="UniqueID">
|
|
<para>The unique ID of the channel.</para>
|
|
</parameter>
|
|
<parameter name="LinkedID">
|
|
<para>The linked ID of the channel, which ties this event to other related channel's events.</para>
|
|
</parameter>
|
|
<parameter name="UserField">
|
|
<para>
|
|
A user defined field set on a channel, containing arbitrary
|
|
application specific data.
|
|
</para>
|
|
</parameter>
|
|
<parameter name="Peer">
|
|
<para>
|
|
If this channel is in a bridge, the channel that it is in
|
|
a bridge with.
|
|
</para>
|
|
</parameter>
|
|
<parameter name="PeerAccount">
|
|
<para>
|
|
If this channel is in a bridge, the accountcode of the
|
|
channel it is in a bridge with.
|
|
</para>
|
|
</parameter>
|
|
<parameter name="Extra">
|
|
<para>
|
|
Some events will have event specific data that accompanies the CEL record.
|
|
This extra data is JSON encoded, and is dependent on the event in
|
|
question.
|
|
</para>
|
|
</parameter>
|
|
</syntax>
|
|
</managerEventInstance>
|
|
</managerEvent>
|
|
***/
|
|
|
|
#include "asterisk.h"
|
|
|
|
ASTERISK_REGISTER_FILE()
|
|
|
|
#include "asterisk/channel.h"
|
|
#include "asterisk/cel.h"
|
|
#include "asterisk/module.h"
|
|
#include "asterisk/logger.h"
|
|
#include "asterisk/utils.h"
|
|
#include "asterisk/manager.h"
|
|
#include "asterisk/config.h"
|
|
|
|
static const char DATE_FORMAT[] = "%Y-%m-%d %T";
|
|
|
|
static const char CONF_FILE[] = "cel.conf";
|
|
|
|
/*! \brief AMI CEL is off by default */
|
|
#define CEL_AMI_ENABLED_DEFAULT 0
|
|
|
|
static int enablecel;
|
|
|
|
/*! \brief show_user_def is off by default */
|
|
#define CEL_SHOW_USERDEF_DEFAULT 0
|
|
|
|
#define MANAGER_BACKEND_NAME "Manager Event Logging"
|
|
|
|
/*! TRUE if we should set the EventName header to USER_DEFINED on user events. */
|
|
static unsigned char cel_show_user_def;
|
|
|
|
static void manager_log(struct ast_event *event)
|
|
{
|
|
struct ast_tm timeresult;
|
|
char start_time[80] = "";
|
|
char user_defined_header[160];
|
|
const char *event_name;
|
|
struct ast_cel_event_record record = {
|
|
.version = AST_CEL_EVENT_RECORD_VERSION,
|
|
};
|
|
|
|
if (!enablecel) {
|
|
return;
|
|
}
|
|
|
|
if (ast_cel_fill_record(event, &record)) {
|
|
return;
|
|
}
|
|
|
|
ast_localtime(&record.event_time, &timeresult, NULL);
|
|
ast_strftime(start_time, sizeof(start_time), DATE_FORMAT, &timeresult);
|
|
|
|
event_name = record.event_name;
|
|
user_defined_header[0] = '\0';
|
|
if (record.event_type == AST_CEL_USER_DEFINED) {
|
|
if (cel_show_user_def) {
|
|
snprintf(user_defined_header, sizeof(user_defined_header),
|
|
"UserDefType: %s\r\n", record.user_defined_name);
|
|
} else {
|
|
event_name = record.user_defined_name;
|
|
}
|
|
}
|
|
|
|
manager_event(EVENT_FLAG_CALL, "CEL",
|
|
"EventName: %s\r\n"
|
|
"AccountCode: %s\r\n"
|
|
"CallerIDnum: %s\r\n"
|
|
"CallerIDname: %s\r\n"
|
|
"CallerIDani: %s\r\n"
|
|
"CallerIDrdnis: %s\r\n"
|
|
"CallerIDdnid: %s\r\n"
|
|
"Exten: %s\r\n"
|
|
"Context: %s\r\n"
|
|
"Channel: %s\r\n"
|
|
"Application: %s\r\n"
|
|
"AppData: %s\r\n"
|
|
"EventTime: %s\r\n"
|
|
"AMAFlags: %s\r\n"
|
|
"UniqueID: %s\r\n"
|
|
"LinkedID: %s\r\n"
|
|
"Userfield: %s\r\n"
|
|
"Peer: %s\r\n"
|
|
"PeerAccount: %s\r\n"
|
|
"%s"
|
|
"Extra: %s\r\n",
|
|
event_name,
|
|
record.account_code,
|
|
record.caller_id_num,
|
|
record.caller_id_name,
|
|
record.caller_id_ani,
|
|
record.caller_id_rdnis,
|
|
record.caller_id_dnid,
|
|
record.extension,
|
|
record.context,
|
|
record.channel_name,
|
|
record.application_name,
|
|
record.application_data,
|
|
start_time,
|
|
ast_channel_amaflags2string(record.amaflag),
|
|
record.unique_id,
|
|
record.linked_id,
|
|
record.user_field,
|
|
record.peer,
|
|
record.peer_account,
|
|
user_defined_header,
|
|
record.extra);
|
|
}
|
|
|
|
static int load_config(int reload)
|
|
{
|
|
const char *cat = NULL;
|
|
struct ast_config *cfg;
|
|
struct ast_flags config_flags = { reload ? CONFIG_FLAG_FILEUNCHANGED : 0 };
|
|
struct ast_variable *v;
|
|
int newenablecel = CEL_AMI_ENABLED_DEFAULT;
|
|
int new_cel_show_user_def = CEL_SHOW_USERDEF_DEFAULT;
|
|
|
|
cfg = ast_config_load(CONF_FILE, config_flags);
|
|
if (cfg == CONFIG_STATUS_FILEUNCHANGED) {
|
|
return 0;
|
|
}
|
|
|
|
if (cfg == CONFIG_STATUS_FILEINVALID) {
|
|
ast_log(LOG_WARNING, "Configuration file '%s' is invalid. CEL manager Module not activated.\n",
|
|
CONF_FILE);
|
|
enablecel = 0;
|
|
return -1;
|
|
} else if (!cfg) {
|
|
ast_log(LOG_WARNING, "Failed to load configuration file. CEL manager Module not activated.\n");
|
|
enablecel = 0;
|
|
return -1;
|
|
}
|
|
|
|
while ((cat = ast_category_browse(cfg, cat))) {
|
|
if (strcasecmp(cat, "manager")) {
|
|
continue;
|
|
}
|
|
|
|
for (v = ast_variable_browse(cfg, cat); v; v = v->next) {
|
|
if (!strcasecmp(v->name, "enabled")) {
|
|
newenablecel = ast_true(v->value) ? 1 : 0;
|
|
} else if (!strcasecmp(v->name, "show_user_defined")) {
|
|
new_cel_show_user_def = ast_true(v->value) ? 1 : 0;
|
|
} else {
|
|
ast_log(LOG_NOTICE, "Unknown option '%s' specified "
|
|
"for cel_manager.\n", v->name);
|
|
}
|
|
}
|
|
}
|
|
|
|
ast_config_destroy(cfg);
|
|
|
|
cel_show_user_def = new_cel_show_user_def;
|
|
if (enablecel && !newenablecel) {
|
|
ast_cel_backend_unregister(MANAGER_BACKEND_NAME);
|
|
} else if (!enablecel && newenablecel) {
|
|
if (ast_cel_backend_register(MANAGER_BACKEND_NAME, manager_log)) {
|
|
ast_log(LOG_ERROR, "Unable to register Asterisk Call Manager CEL handling\n");
|
|
}
|
|
}
|
|
enablecel = newenablecel;
|
|
|
|
return 0;
|
|
}
|
|
|
|
static int unload_module(void)
|
|
{
|
|
ast_cel_backend_unregister(MANAGER_BACKEND_NAME);
|
|
return 0;
|
|
}
|
|
|
|
static int load_module(void)
|
|
{
|
|
if (load_config(0)) {
|
|
return AST_MODULE_LOAD_DECLINE;
|
|
}
|
|
|
|
return AST_MODULE_LOAD_SUCCESS;
|
|
}
|
|
|
|
static int reload(void)
|
|
{
|
|
return load_config(1);
|
|
}
|
|
|
|
AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Asterisk Manager Interface CEL Backend",
|
|
.support_level = AST_MODULE_SUPPORT_CORE,
|
|
.load = load_module,
|
|
.unload = unload_module,
|
|
.reload = reload,
|
|
.load_pri = AST_MODPRI_CDR_DRIVER,
|
|
);
|