Merge "astobj2: Create function to copy weak proxied objects from container."
[asterisk/asterisk.git] / apps / app_exec.c
index d41bf27..79c1b75 100644 (file)
  * \ingroup applications
  */
 
-#include <stdio.h>
-#include <stdlib.h>
-#include <unistd.h>
-#include <string.h>
-
+/*** MODULEINFO
+       <support_level>core</support_level>
+ ***/
 #include "asterisk.h"
 
-ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
-
 #include "asterisk/file.h"
-#include "asterisk/logger.h"
-#include "asterisk/options.h"
 #include "asterisk/channel.h"
 #include "asterisk/pbx.h"
 #include "asterisk/module.h"
+#include "asterisk/app.h"
+
+/*** DOCUMENTATION
+       <application name="Exec" language="en_US">
+               <synopsis>
+                       Executes dialplan application.
+               </synopsis>
+               <syntax>
+                       <parameter name="appname" required="true" hasparams="true">
+                               <para>Application name and arguments of the dialplan application to execute.</para>
+                               <argument name="arguments" required="true" />
+                       </parameter>
+               </syntax>
+               <description>
+                       <para>Allows an arbitrary application to be invoked even when not
+                       hard coded into the dialplan.  If the underlying application
+                       terminates the dialplan, or if the application cannot be found,
+                       Exec will terminate the dialplan.</para>
+                       <para>To invoke external applications, see the application System.
+                       If you would like to catch any error instead, see TryExec.</para>
+               </description>
+       </application>
+       <application name="TryExec" language="en_US">
+               <synopsis>
+                       Executes dialplan application, always returning.
+               </synopsis>
+               <syntax>
+                       <parameter name="appname" required="true" hasparams="true">
+                               <argument name="arguments" required="true" />
+                       </parameter>
+               </syntax>
+               <description>
+                       <para>Allows an arbitrary application to be invoked even when not
+                       hard coded into the dialplan. To invoke external applications
+                       see the application System.  Always returns to the dialplan.
+                       The channel variable TRYSTATUS will be set to one of:
+                       </para>
+                       <variablelist>
+                               <variable name="TRYSTATUS">
+                                       <value name="SUCCESS">
+                                               If the application returned zero.
+                                       </value>
+                                       <value name="FAILED">
+                                               If the application returned non-zero.
+                                       </value>
+                                       <value name="NOAPP">
+                                               If the application was not found or was not specified.
+                                       </value>
+                               </variable>
+                       </variablelist>
+               </description>
+       </application>
+       <application name="ExecIf" language="en_US">
+               <synopsis>
+                       Executes dialplan application, conditionally.
+               </synopsis>
+               <syntax argsep="?">
+                       <parameter name="expression" required="true" />
+                       <parameter name="execapp" required="true" argsep=":">
+                               <argument name="appiftrue" required="true" hasparams="true">
+                                       <argument name="args" required="true" />
+                               </argument>
+                               <argument name="appiffalse" required="false" hasparams="true">
+                                       <argument name="args" required="true" />
+                               </argument>
+                       </parameter>
+               </syntax>
+               <description>
+                       <para>If <replaceable>expr</replaceable> is true, execute and return the
+                       result of <replaceable>appiftrue(args)</replaceable>.</para>
+                       <para>If <replaceable>expr</replaceable> is true, but <replaceable>appiftrue</replaceable> is not found,
+                       then the application will return a non-zero value.</para>
+               </description>
+       </application>
+ ***/
 
 /* Maximum length of any variable */
-#define MAXRESULT      1024
-
-static char *tdesc = "Executes dialplan applications";
+#define MAXRESULT 1024
 
 /*! Note
  *
@@ -59,157 +126,159 @@ static char *tdesc = "Executes dialplan applications";
  * affecting the dialplan.
  */
 
-static char *app_exec = "Exec";
-static char *exec_synopsis = "Executes dialplan application";
-static char *exec_descrip =
-"Usage: Exec(appname(arguments))\n"
-"  Allows an arbitrary application to be invoked even when not\n"
-"hardcoded into the dialplan.  If the underlying application\n"
-"terminates the dialplan, or if the application cannot be found,\n"
-"Exec will terminate the dialplan.\n"
-"  To invoke external applications, see the application System.\n"
-"  If you would like to catch any error instead, see TryExec.\n";
-
-static char *app_tryexec = "TryExec";
-static char *tryexec_synopsis = "Executes dialplan application, always returning";
-static char *tryexec_descrip =
-"Usage: TryExec(appname(arguments))\n"
-"  Allows an arbitrary application to be invoked even when not\n"
-"hardcoded into the dialplan. To invoke external applications\n"
-"see the application System.  Always returns to the dialplan.\n"
-"The channel variable TRYSTATUS will be set to:\n"
-"    SUCCESS   if the application returned zero\n"
-"    FAILED    if the application returned non-zero\n"
-"    NOAPP     if the application was not found or was not specified\n"
-"    NOMEMORY  if there was not enough memory to execute.\n";
-
-static char *app_execif = "ExecIf";
-static char *execif_synopsis = "Executes dialplan application, conditionally";
-static char *execif_descrip = 
-"Usage:  ExecIF (<expr>|<app>|<data>)\n"
-"If <expr> is true, execute and return the result of <app>(<data>).\n"
-"If <expr> is true, but <app> is not found, then the application\n"
-"will return a non-zero value.\n";
-
-LOCAL_USER_DECL;
-
-static int exec_exec(struct ast_channel *chan, void *data)
+static const char app_exec[] = "Exec";
+static const char app_tryexec[] = "TryExec";
+static const char app_execif[] = "ExecIf";
+
+static int exec_exec(struct ast_channel *chan, const char *data)
 {
-       int res=0;
-       struct localuser *u;
-       char *s, *appname, *endargs, args[MAXRESULT] = "";
+       int res = 0;
+       char *s, *appname, *endargs;
        struct ast_app *app;
-
-       LOCAL_USER_ADD(u);
-
-       /* Check and parse arguments */
-       if (data) {
-               if ((s = ast_strdupa(data))) {
-                       appname = strsep(&s, "(");
-                       if (s) {
-                               endargs = strrchr(s, ')');
-                               if (endargs)
-                                       *endargs = '\0';
-                               pbx_substitute_variables_helper(chan, s, args, MAXRESULT - 1);
-                       }
-                       if (appname) {
-                               app = pbx_findapp(appname);
-                               if (app) {
-                                       res = pbx_exec(chan, app, args);
-                               } else {
-                                       ast_log(LOG_WARNING, "Could not find application (%s)\n", appname);
-                                       res = -1;
-                               }
-                       }
-               } else
+       struct ast_str *args = NULL;
+
+       if (ast_strlen_zero(data))
+               return 0;
+
+       s = ast_strdupa(data);
+       appname = strsep(&s, "(");
+       if (s) {
+               endargs = strrchr(s, ')');
+               if (endargs)
+                       *endargs = '\0';
+               if ((args = ast_str_create(16))) {
+                       ast_str_substitute_variables(&args, 0, chan, s);
+               }
+       }
+       if (appname) {
+               app = pbx_findapp(appname);
+               if (app) {
+                       res = pbx_exec(chan, app, args ? ast_str_buffer(args) : NULL);
+               } else {
+                       ast_log(LOG_WARNING, "Could not find application (%s)\n", appname);
                        res = -1;
+               }
        }
 
-       LOCAL_USER_REMOVE(u);
+       ast_free(args);
        return res;
 }
 
-static int tryexec_exec(struct ast_channel *chan, void *data)
+static int tryexec_exec(struct ast_channel *chan, const char *data)
 {
-       int res=0;
-       struct localuser *u;
-       char *s, *appname, *endargs, args[MAXRESULT] = "";
+       int res = 0;
+       char *s, *appname, *endargs;
        struct ast_app *app;
-
-       LOCAL_USER_ADD(u);
-
-       /* Check and parse arguments */
-       if (data) {
-               if ((s = ast_strdupa(data))) {
-                       appname = strsep(&s, "(");
-                       if (s) {
-                               endargs = strrchr(s, ')');
-                               if (endargs)
-                                       *endargs = '\0';
-                               pbx_substitute_variables_helper(chan, s, args, MAXRESULT - 1);
-                       }
-                       if (appname) {
-                               app = pbx_findapp(appname);
-                               if (app) {
-                                       res = pbx_exec(chan, app, args);
-                                       pbx_builtin_setvar_helper(chan, "TRYSTATUS", res ? "FAILED" : "SUCCESS");
-                               } else {
-                                       ast_log(LOG_WARNING, "Could not find application (%s)\n", appname);
-                                       pbx_builtin_setvar_helper(chan, "TRYSTATUS", "NOAPP");
-                               }
-                       }
+       struct ast_str *args = NULL;
+
+       if (ast_strlen_zero(data))
+               return 0;
+
+       s = ast_strdupa(data);
+       appname = strsep(&s, "(");
+       if (s) {
+               endargs = strrchr(s, ')');
+               if (endargs)
+                       *endargs = '\0';
+               if ((args = ast_str_create(16))) {
+                       ast_str_substitute_variables(&args, 0, chan, s);
+               }
+       }
+       if (appname) {
+               app = pbx_findapp(appname);
+               if (app) {
+                       res = pbx_exec(chan, app, args ? ast_str_buffer(args) : NULL);
+                       pbx_builtin_setvar_helper(chan, "TRYSTATUS", res ? "FAILED" : "SUCCESS");
                } else {
-                       ast_log(LOG_ERROR, "Out of memory\n");
-                       pbx_builtin_setvar_helper(chan, "TRYSTATUS", "NOMEMORY");
+                       ast_log(LOG_WARNING, "Could not find application (%s)\n", appname);
+                       pbx_builtin_setvar_helper(chan, "TRYSTATUS", "NOAPP");
                }
        }
 
-       LOCAL_USER_REMOVE(u);
+       ast_free(args);
        return 0;
 }
 
-static int execif_exec(struct ast_channel *chan, void *data) {
-       int res=0;
-       struct localuser *u;
-       char *myapp = NULL;
-       char *mydata = NULL;
-       char *expr = NULL;
+static int execif_exec(struct ast_channel *chan, const char *data)
+{
+       int res = 0;
+       char *truedata = NULL, *falsedata = NULL, *end, *firstcomma, *firstquestion;
        struct ast_app *app = NULL;
+       AST_DECLARE_APP_ARGS(expr,
+               AST_APP_ARG(expr);
+               AST_APP_ARG(remainder);
+       );
+       AST_DECLARE_APP_ARGS(apps,
+               AST_APP_ARG(t);
+               AST_APP_ARG(f);
+       );
+       char *parse = ast_strdupa(data);
+
+       firstcomma = strchr(parse, ',');
+       firstquestion = strchr(parse, '?');
+
+       if ((firstcomma != NULL && firstquestion != NULL && firstcomma < firstquestion) || (firstquestion == NULL)) {
+               /* Deprecated syntax */
+               AST_DECLARE_APP_ARGS(depr,
+                       AST_APP_ARG(expr);
+                       AST_APP_ARG(appname);
+                       AST_APP_ARG(appargs);
+               );
+               AST_STANDARD_APP_ARGS(depr, parse);
+
+               ast_log(LOG_WARNING, "Deprecated syntax found.  Please upgrade to using ExecIf(<expr>?%s(%s))\n", depr.appname, depr.appargs);
+
+               /* Make the two syntaxes look the same */
+               expr.expr = depr.expr;
+               apps.t = depr.appname;
+               apps.f = NULL;
+               truedata = depr.appargs;
+       } else {
+               /* Preferred syntax */
 
-       LOCAL_USER_ADD(u);
+               AST_NONSTANDARD_RAW_ARGS(expr, parse, '?');
+               if (ast_strlen_zero(expr.remainder)) {
+                       ast_log(LOG_ERROR, "Usage: ExecIf(<expr>?<appiftrue>(<args>)[:<appiffalse>(<args)])\n");
+                       return -1;
+               }
 
-       if (!(expr = ast_strdupa(data))) {
-               LOCAL_USER_REMOVE(u);
-               return -1;
-       }
+               AST_NONSTANDARD_RAW_ARGS(apps, expr.remainder, ':');
 
-       if ((myapp = strchr(expr,'|'))) {
-               *myapp = '\0';
-               myapp++;
-               if ((mydata = strchr(myapp,'|'))) {
-                       *mydata = '\0';
-                       mydata++;
-               } else
-                       mydata = "";
-
-               if (pbx_checkcondition(expr)) { 
-                       if ((app = pbx_findapp(myapp))) {
-                               res = pbx_exec(chan, app, mydata);
-                       } else {
-                               ast_log(LOG_WARNING, "Count not find application! (%s)\n", myapp);
-                               res = -1;
+               if (apps.t && (truedata = strchr(apps.t, '('))) {
+                       *truedata++ = '\0';
+                       if ((end = strrchr(truedata, ')'))) {
+                               *end = '\0';
                        }
                }
-       } else {
-               ast_log(LOG_ERROR,"Invalid Syntax.\n");
-               res = -1;
+
+               if (apps.f && (falsedata = strchr(apps.f, '('))) {
+                       *falsedata++ = '\0';
+                       if ((end = strrchr(falsedata, ')'))) {
+                               *end = '\0';
+                       }
+               }
+       }
+
+       if (pbx_checkcondition(expr.expr)) {
+               if (!ast_strlen_zero(apps.t) && (app = pbx_findapp(apps.t))) {
+                       res = pbx_exec(chan, app, S_OR(truedata, ""));
+               } else {
+                       ast_log(LOG_WARNING, "Could not find application! (%s)\n", apps.t);
+                       res = -1;
+               }
+       } else if (!ast_strlen_zero(apps.f)) {
+               if ((app = pbx_findapp(apps.f))) {
+                       res = pbx_exec(chan, app, S_OR(falsedata, ""));
+               } else {
+                       ast_log(LOG_WARNING, "Could not find application! (%s)\n", apps.f);
+                       res = -1;
+               }
        }
-               
-       LOCAL_USER_REMOVE(u);
+
        return res;
 }
 
-static int unload_module(void *mod)
+static int unload_module(void)
 {
        int res;
 
@@ -217,27 +286,15 @@ static int unload_module(void *mod)
        res |= ast_unregister_application(app_tryexec);
        res |= ast_unregister_application(app_execif);
 
-       STANDARD_HANGUP_LOCALUSERS;
-
        return res;
 }
 
-static int load_module(void *mod)
+static int load_module(void)
 {
-       int res = ast_register_application(app_exec, exec_exec, exec_synopsis, exec_descrip);
-       res |= ast_register_application(app_tryexec, tryexec_exec, tryexec_synopsis, tryexec_descrip);
-       res |= ast_register_application(app_execif, execif_exec, execif_synopsis, execif_descrip);
+       int res = ast_register_application_xml(app_exec, exec_exec);
+       res |= ast_register_application_xml(app_tryexec, tryexec_exec);
+       res |= ast_register_application_xml(app_execif, execif_exec);
        return res;
 }
 
-static const char *description(void)
-{
-       return tdesc;
-}
-
-static const char *key(void)
-{
-       return ASTERISK_GPL_KEY;
-}
-
-STD_MOD1;
+AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Executes dialplan applications");