app_dial.c: Factor out a connected line update routine.
[asterisk/asterisk.git] / apps / app_sendtext.c
index 46660e4..3b7f0ca 100644 (file)
  *
  * \ingroup applications
  */
+
+/*** MODULEINFO
+       <support_level>core</support_level>
+ ***/
  
 #include "asterisk.h"
 
-ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
+ASTERISK_REGISTER_FILE()
 
-#include "asterisk/lock.h"
 #include "asterisk/file.h"
 #include "asterisk/channel.h"
 #include "asterisk/pbx.h"
 #include "asterisk/module.h"
-#include "asterisk/translate.h"
-#include "asterisk/image.h"
-#include "asterisk/options.h"
 #include "asterisk/app.h"
 
-static const char *app = "SendText";
-
-static const char *synopsis = "Send a Text Message";
+/*** DOCUMENTATION
+       <application name="SendText" language="en_US">
+               <synopsis>
+                       Send a Text Message.
+               </synopsis>
+               <syntax>
+                       <parameter name="text" required="true" />
+               </syntax>
+               <description>
+                       <para>Sends <replaceable>text</replaceable> to current channel (callee).</para>
+                       <para>Result of transmission will be stored in the <variable>SENDTEXTSTATUS</variable></para>
+                       <variablelist>
+                               <variable name="SENDTEXTSTATUS">
+                                       <value name="SUCCESS">
+                                               Transmission succeeded.
+                                       </value>
+                                       <value name="FAILURE">
+                                               Transmission failed.
+                                       </value>
+                                       <value name="UNSUPPORTED">
+                                               Text transmission not supported by channel.
+                                       </value>
+                               </variable>
+                       </variablelist>
+                       <note><para>At this moment, text is supposed to be 7 bit ASCII in most channels.</para></note>
+               </description>
+               <see-also>
+                       <ref type="application">SendImage</ref>
+                       <ref type="application">SendURL</ref>
+               </see-also>
+       </application>
+ ***/
 
-static const char *descrip = 
-"  SendText(text[,options]): Sends text to current channel (callee).\n"
-"Result of transmission will be stored in the SENDTEXTSTATUS\n"
-"channel variable:\n"
-"      SUCCESS      Transmission succeeded\n"
-"      FAILURE      Transmission failed\n"
-"      UNSUPPORTED  Text transmission not supported by channel\n"
-"\n"
-"At this moment, text is supposed to be 7 bit ASCII in most channels.\n";
+static const char * const app = "SendText";
 
-static int sendtext_exec(struct ast_channel *chan, void *data)
+static int sendtext_exec(struct ast_channel *chan, const char *data)
 {
-       int res = 0;
        char *status = "UNSUPPORTED";
-       char *parse = NULL;
-       AST_DECLARE_APP_ARGS(args,
-               AST_APP_ARG(text);
-               AST_APP_ARG(options);
-       );
+       struct ast_str *str;
 
-       if (ast_strlen_zero(data)) {
-               ast_log(LOG_WARNING, "SendText requires an argument (text[,options])\n");
+       /* NOT ast_strlen_zero, because some protocols (e.g. SIP) MUST be able to
+        * send a zero-length message. */
+       if (!data) {
+               ast_log(LOG_WARNING, "SendText requires an argument (text)\n");
                return -1;
-       } else
-               parse = ast_strdupa(data);
-       
-       AST_STANDARD_APP_ARGS(args, parse);
+       }
 
-       if (args.options) {
+       if (!(str = ast_str_alloca(strlen(data) + 1))) {
+               return -1;
        }
 
+       ast_str_get_encoded_str(&str, -1, data);
+
        ast_channel_lock(chan);
-       if (!chan->tech->send_text) {
+       if (!ast_channel_tech(chan)->send_text) {
                ast_channel_unlock(chan);
                /* Does not support transport */
+               pbx_builtin_setvar_helper(chan, "SENDTEXTSTATUS", status);
                return 0;
        }
        status = "FAILURE";
-       ast_channel_unlock(chan);
-       res = ast_sendtext(chan, args.text);
-       if (!res)
+       if (!ast_sendtext(chan, ast_str_buffer(str))) {
                status = "SUCCESS";
+       }
+       ast_channel_unlock(chan);
        pbx_builtin_setvar_helper(chan, "SENDTEXTSTATUS", status);
        return 0;
 }
@@ -98,7 +117,7 @@ static int unload_module(void)
 
 static int load_module(void)
 {
-       return ast_register_application(app, sendtext_exec, synopsis, descrip);
+       return ast_register_application_xml(app, sendtext_exec);
 }
 
 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Send Text Applications");