2009-11-03 21:26:28 +00:00
|
|
|
/*
|
|
|
|
* Asterisk -- An open source telephony toolkit.
|
|
|
|
*
|
|
|
|
* Copyright (C) 2009, Digium, Inc.
|
|
|
|
*
|
|
|
|
* David Brooks <dbrooks@digium.com>
|
|
|
|
*
|
|
|
|
* 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 Test AMI hook
|
|
|
|
*
|
|
|
|
* \author David Brooks <dbrooks@digium.com> based off of code written by Russell Bryant <russell@digium.com>
|
|
|
|
*
|
|
|
|
* This is simply an example or test module illustrating the ability for a custom module
|
|
|
|
* to hook into AMI. Registration for AMI events and sending of AMI actions is shown.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/*** MODULEINFO
|
2011-09-29 21:16:07 +00:00
|
|
|
<depend>TEST_FRAMEWORK</depend>
|
2011-08-16 20:15:23 +00:00
|
|
|
<support_level>core</support_level>
|
2009-11-03 21:26:28 +00:00
|
|
|
***/
|
|
|
|
|
|
|
|
#include "asterisk.h"
|
|
|
|
|
|
|
|
#include "asterisk/module.h"
|
|
|
|
#include "asterisk/cli.h"
|
|
|
|
#include "asterisk/utils.h"
|
|
|
|
#include "asterisk/manager.h"
|
|
|
|
|
|
|
|
/* The helper function is required by struct manager_custom_hook. See __manager_event for details */
|
|
|
|
static int amihook_helper(int category, const char *event, char *content)
|
|
|
|
{
|
|
|
|
ast_log(LOG_NOTICE, "AMI Event: \nCategory: %d Event: %s\n%s\n", category, event, content);
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
static struct manager_custom_hook test_hook = {
|
|
|
|
.file = __FILE__,
|
|
|
|
.helper = &amihook_helper,
|
|
|
|
};
|
|
|
|
|
2009-11-06 22:07:22 +00:00
|
|
|
static int hook_send(void) {
|
2009-11-03 21:26:28 +00:00
|
|
|
int res;
|
|
|
|
|
|
|
|
/* Send a test action (core show version) to the AMI */
|
|
|
|
res = ast_hook_send_action(&test_hook, "Action: Command\nCommand: core show version\nActionID: 987654321\n");
|
|
|
|
|
|
|
|
return res;
|
|
|
|
}
|
|
|
|
|
2009-11-06 22:07:22 +00:00
|
|
|
static void register_hook(void) {
|
|
|
|
|
|
|
|
/* Unregister the hook, we don't want a double-registration (Bad Things(tm) happen) */
|
|
|
|
ast_manager_unregister_hook(&test_hook);
|
|
|
|
|
|
|
|
/* Register the hook for AMI events */
|
|
|
|
ast_manager_register_hook(&test_hook);
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
static void unregister_hook(void) {
|
|
|
|
|
|
|
|
/* Unregister the hook */
|
|
|
|
ast_manager_unregister_hook(&test_hook);
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
static char *handle_cli_amihook_send(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
|
|
|
|
{
|
|
|
|
switch (cmd) {
|
|
|
|
case CLI_INIT:
|
|
|
|
e->command = "amihook send";
|
|
|
|
e->usage = ""
|
|
|
|
"Usage: amihook send"
|
|
|
|
"";
|
|
|
|
return NULL;
|
|
|
|
case CLI_GENERATE:
|
|
|
|
return NULL;
|
|
|
|
case CLI_HANDLER:
|
|
|
|
hook_send();
|
|
|
|
return CLI_SUCCESS;
|
|
|
|
}
|
|
|
|
|
|
|
|
return CLI_FAILURE;
|
|
|
|
}
|
|
|
|
|
|
|
|
static char *handle_cli_amihook_register_hook(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
|
2009-11-03 21:26:28 +00:00
|
|
|
{
|
|
|
|
switch (cmd) {
|
|
|
|
case CLI_INIT:
|
2009-11-06 22:07:22 +00:00
|
|
|
e->command = "amihook register";
|
2009-11-03 21:26:28 +00:00
|
|
|
e->usage = ""
|
2009-11-06 22:07:22 +00:00
|
|
|
"Usage: amihook register"
|
2009-11-03 21:26:28 +00:00
|
|
|
"";
|
|
|
|
return NULL;
|
|
|
|
case CLI_GENERATE:
|
|
|
|
return NULL;
|
|
|
|
case CLI_HANDLER:
|
2009-11-06 22:07:22 +00:00
|
|
|
register_hook();
|
|
|
|
return CLI_SUCCESS;
|
|
|
|
}
|
|
|
|
|
|
|
|
return CLI_FAILURE;
|
|
|
|
}
|
|
|
|
|
|
|
|
static char *handle_cli_amihook_unregister_hook(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
|
|
|
|
{
|
|
|
|
switch (cmd) {
|
|
|
|
case CLI_INIT:
|
|
|
|
e->command = "amihook unregister";
|
|
|
|
e->usage = ""
|
|
|
|
"Usage: amihook unregister"
|
|
|
|
"";
|
|
|
|
return NULL;
|
|
|
|
case CLI_GENERATE:
|
|
|
|
return NULL;
|
|
|
|
case CLI_HANDLER:
|
|
|
|
unregister_hook();
|
2009-11-03 21:26:28 +00:00
|
|
|
return CLI_SUCCESS;
|
|
|
|
}
|
|
|
|
|
|
|
|
return CLI_FAILURE;
|
|
|
|
}
|
|
|
|
|
|
|
|
static struct ast_cli_entry cli_amihook_evt[] = {
|
2009-11-06 22:07:22 +00:00
|
|
|
AST_CLI_DEFINE(handle_cli_amihook_send, "Send an AMI event"),
|
|
|
|
AST_CLI_DEFINE(handle_cli_amihook_register_hook, "Register module for AMI hook"),
|
|
|
|
AST_CLI_DEFINE(handle_cli_amihook_unregister_hook, "Unregister module for AMI hook"),
|
2009-11-03 21:26:28 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
static int unload_module(void)
|
|
|
|
{
|
|
|
|
ast_manager_unregister_hook(&test_hook);
|
|
|
|
return ast_cli_unregister_multiple(cli_amihook_evt, ARRAY_LEN(cli_amihook_evt));
|
|
|
|
}
|
|
|
|
|
|
|
|
static int load_module(void)
|
|
|
|
{
|
|
|
|
int res;
|
|
|
|
|
|
|
|
res = ast_cli_register_multiple(cli_amihook_evt, ARRAY_LEN(cli_amihook_evt));
|
|
|
|
|
|
|
|
return res ? AST_MODULE_LOAD_DECLINE : AST_MODULE_LOAD_SUCCESS;
|
|
|
|
}
|
|
|
|
|
|
|
|
AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "AMI Hook Test Module");
|