2000-01-02 20:59:00 +00:00
|
|
|
/*
|
2005-09-14 20:46:50 +00:00
|
|
|
* Asterisk -- An open source telephony toolkit.
|
2000-01-02 20:59:00 +00:00
|
|
|
*
|
2005-01-21 07:06:25 +00:00
|
|
|
* Copyright (C) 1999 - 2005, Digium, Inc.
|
2000-01-02 20:59:00 +00:00
|
|
|
*
|
2004-09-18 14:14:15 +00:00
|
|
|
* Mark Spencer <markster@digium.com>
|
2000-01-02 20:59:00 +00:00
|
|
|
*
|
2005-09-14 20:46:50 +00:00
|
|
|
* 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.
|
|
|
|
*
|
2000-01-02 20:59:00 +00:00
|
|
|
* This program is free software, distributed under the terms of
|
2005-09-14 20:46:50 +00:00
|
|
|
* the GNU General Public License Version 2. See the LICENSE file
|
|
|
|
* at the top of the source tree.
|
|
|
|
*/
|
|
|
|
|
2005-10-24 20:12:06 +00:00
|
|
|
/*! \file
|
2005-09-14 20:46:50 +00:00
|
|
|
*
|
2005-10-24 20:12:06 +00:00
|
|
|
* \brief Execute arbitrary system commands
|
2005-12-30 21:18:06 +00:00
|
|
|
*
|
|
|
|
* \author Mark Spencer <markster@digium.com>
|
2005-09-14 20:46:50 +00:00
|
|
|
*
|
2005-11-06 15:09:47 +00:00
|
|
|
* \ingroup applications
|
2000-01-02 20:59:00 +00:00
|
|
|
*/
|
|
|
|
|
2006-06-07 18:54:56 +00:00
|
|
|
#include "asterisk.h"
|
|
|
|
|
|
|
|
ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
|
|
|
|
|
2005-06-06 22:39:32 +00:00
|
|
|
#include <stdlib.h>
|
2005-11-08 04:48:00 +00:00
|
|
|
#include <stdio.h>
|
2005-06-06 22:39:32 +00:00
|
|
|
#include <unistd.h>
|
|
|
|
#include <string.h>
|
|
|
|
#include <errno.h>
|
|
|
|
|
2005-04-21 06:02:45 +00:00
|
|
|
#include "asterisk/lock.h"
|
|
|
|
#include "asterisk/file.h"
|
|
|
|
#include "asterisk/logger.h"
|
|
|
|
#include "asterisk/channel.h"
|
|
|
|
#include "asterisk/pbx.h"
|
|
|
|
#include "asterisk/module.h"
|
|
|
|
#include "asterisk/app.h"
|
2005-09-07 18:52:54 +00:00
|
|
|
#include "asterisk/options.h"
|
2000-01-02 20:59:00 +00:00
|
|
|
|
|
|
|
static char *app = "System";
|
|
|
|
|
2004-09-18 14:14:15 +00:00
|
|
|
static char *app2 = "TrySystem";
|
|
|
|
|
2001-04-10 17:18:04 +00:00
|
|
|
static char *synopsis = "Execute a system command";
|
|
|
|
|
2004-09-18 14:14:15 +00:00
|
|
|
static char *synopsis2 = "Try executing a system command";
|
|
|
|
|
2005-09-07 18:52:54 +00:00
|
|
|
static char *chanvar = "SYSTEMSTATUS";
|
|
|
|
|
2001-04-10 17:18:04 +00:00
|
|
|
static char *descrip =
|
2005-11-07 22:01:22 +00:00
|
|
|
" System(command): Executes a command by using system(). If the command\n"
|
|
|
|
"fails, the console should report a fallthrough. \n"
|
2005-09-07 18:52:54 +00:00
|
|
|
"Result of execution is returned in the SYSTEMSTATUS channel variable:\n"
|
|
|
|
" FAILURE Could not execute the specified command\n"
|
2007-06-12 15:58:28 +00:00
|
|
|
" SUCCESS Specified command successfully executed\n";
|
2001-04-10 17:18:04 +00:00
|
|
|
|
2004-09-18 14:14:15 +00:00
|
|
|
static char *descrip2 =
|
2005-11-07 22:01:22 +00:00
|
|
|
" TrySystem(command): Executes a command by using system().\n"
|
2005-09-07 18:52:54 +00:00
|
|
|
"on any situation.\n"
|
|
|
|
"Result of execution is returned in the SYSTEMSTATUS channel variable:\n"
|
|
|
|
" FAILURE Could not execute the specified command\n"
|
|
|
|
" SUCCESS Specified command successfully executed\n"
|
2007-06-12 15:58:28 +00:00
|
|
|
" APPERROR Specified command successfully executed, but returned error code\n";
|
2000-01-02 20:59:00 +00:00
|
|
|
|
2004-09-18 14:14:15 +00:00
|
|
|
static int system_exec_helper(struct ast_channel *chan, void *data, int failmode)
|
2000-01-02 20:59:00 +00:00
|
|
|
{
|
2007-07-16 14:39:29 +00:00
|
|
|
int res = 0;
|
2005-10-19 18:19:02 +00:00
|
|
|
|
2005-10-26 19:48:14 +00:00
|
|
|
if (ast_strlen_zero(data)) {
|
2000-01-02 20:59:00 +00:00
|
|
|
ast_log(LOG_WARNING, "System requires an argument(command)\n");
|
2005-09-07 18:52:54 +00:00
|
|
|
pbx_builtin_setvar_helper(chan, chanvar, "FAILURE");
|
2004-09-18 14:14:15 +00:00
|
|
|
return failmode;
|
2000-01-02 20:59:00 +00:00
|
|
|
}
|
2005-10-19 18:19:02 +00:00
|
|
|
|
2000-01-02 20:59:00 +00:00
|
|
|
/* Do our thing here */
|
2004-03-22 17:34:21 +00:00
|
|
|
res = ast_safe_system((char *)data);
|
2004-02-27 06:56:08 +00:00
|
|
|
if ((res < 0) && (errno != ECHILD)) {
|
2002-06-21 01:40:13 +00:00
|
|
|
ast_log(LOG_WARNING, "Unable to execute '%s'\n", (char *)data);
|
2005-09-07 18:52:54 +00:00
|
|
|
pbx_builtin_setvar_helper(chan, chanvar, "FAILURE");
|
2004-09-18 14:14:15 +00:00
|
|
|
res = failmode;
|
2000-01-02 20:59:00 +00:00
|
|
|
} else if (res == 127) {
|
2002-06-21 01:40:13 +00:00
|
|
|
ast_log(LOG_WARNING, "Unable to execute '%s'\n", (char *)data);
|
2005-09-07 18:52:54 +00:00
|
|
|
pbx_builtin_setvar_helper(chan, chanvar, "FAILURE");
|
2004-09-18 14:14:15 +00:00
|
|
|
res = failmode;
|
2000-01-02 20:59:00 +00:00
|
|
|
} else {
|
2005-09-07 18:52:54 +00:00
|
|
|
if (res < 0)
|
2004-02-27 06:56:08 +00:00
|
|
|
res = 0;
|
2005-09-07 18:52:54 +00:00
|
|
|
if (res != 0)
|
|
|
|
pbx_builtin_setvar_helper(chan, chanvar, "APPERROR");
|
|
|
|
else
|
|
|
|
pbx_builtin_setvar_helper(chan, chanvar, "SUCCESS");
|
2000-01-02 20:59:00 +00:00
|
|
|
res = 0;
|
2005-09-07 18:52:54 +00:00
|
|
|
}
|
|
|
|
|
2000-01-02 20:59:00 +00:00
|
|
|
return res;
|
|
|
|
}
|
|
|
|
|
2004-09-18 14:14:15 +00:00
|
|
|
static int system_exec(struct ast_channel *chan, void *data)
|
|
|
|
{
|
|
|
|
return system_exec_helper(chan, data, -1);
|
|
|
|
}
|
|
|
|
|
|
|
|
static int trysystem_exec(struct ast_channel *chan, void *data)
|
|
|
|
{
|
|
|
|
return system_exec_helper(chan, data, 0);
|
|
|
|
}
|
|
|
|
|
2006-08-21 02:11:39 +00:00
|
|
|
static int unload_module(void)
|
2000-01-02 20:59:00 +00:00
|
|
|
{
|
2005-10-18 22:52:21 +00:00
|
|
|
int res;
|
|
|
|
|
|
|
|
res = ast_unregister_application(app);
|
|
|
|
res |= ast_unregister_application(app2);
|
|
|
|
|
|
|
|
return res;
|
2000-01-02 20:59:00 +00:00
|
|
|
}
|
|
|
|
|
2006-08-21 02:11:39 +00:00
|
|
|
static int load_module(void)
|
2000-01-02 20:59:00 +00:00
|
|
|
{
|
2005-10-18 22:52:21 +00:00
|
|
|
int res;
|
|
|
|
|
|
|
|
res = ast_register_application(app2, trysystem_exec, synopsis2, descrip2);
|
|
|
|
res |= ast_register_application(app, system_exec, synopsis, descrip);
|
|
|
|
|
|
|
|
return res;
|
2000-01-02 20:59:00 +00:00
|
|
|
}
|
|
|
|
|
2006-08-21 02:11:39 +00:00
|
|
|
AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Generic System() application");
|