update app to use args parser
[asterisk/asterisk.git] / apps / app_sayunixtime.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (c) 2003 Tilghman Lesher.  All rights reserved.
5  * Copyright (c) 2006 Digium, Inc.
6  *
7  * Tilghman Lesher <app_sayunixtime__200309@the-tilghman.com>
8  *
9  * This code is released by the author with no restrictions on usage.
10  *
11  * See http://www.asterisk.org for more information about
12  * the Asterisk project. Please do not directly contact
13  * any of the maintainers of this project for assistance;
14  * the project provides a web site, mailing lists and IRC
15  * channels for your use.
16  *
17  */
18
19 /*! \file
20  *
21  * \brief SayUnixTime application
22  *
23  * \author Tilghman Lesher <app_sayunixtime__200309@the-tilghman.com>
24  * 
25  * \ingroup applications
26  */
27
28 #include <stdio.h>
29 #include <stdlib.h>
30 #include <unistd.h>
31 #include <string.h>
32
33 #include "asterisk.h"
34
35 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
36
37 #include "asterisk/file.h"
38 #include "asterisk/logger.h"
39 #include "asterisk/options.h"
40 #include "asterisk/channel.h"
41 #include "asterisk/pbx.h"
42 #include "asterisk/module.h"
43 #include "asterisk/say.h"
44 #include "asterisk/app.h"
45
46 static char *tdesc = "Say time";
47
48 static char *app_sayunixtime = "SayUnixTime";
49 static char *app_datetime = "DateTime";
50
51 static char *sayunixtime_synopsis = "Says a specified time in a custom format";
52
53 static char *sayunixtime_descrip =
54 "SayUnixTime([unixtime][|[timezone][|format]])\n"
55 "  unixtime: time, in seconds since Jan 1, 1970.  May be negative.\n"
56 "              defaults to now.\n"
57 "  timezone: timezone, see /usr/share/zoneinfo for a list.\n"
58 "              defaults to machine default.\n"
59 "  format:   a format the time is to be said in.  See voicemail.conf.\n"
60 "              defaults to \"ABdY 'digits/at' IMp\"\n";
61 static char *datetime_descrip =
62 "DateTime([unixtime][|[timezone][|format]])\n"
63 "  unixtime: time, in seconds since Jan 1, 1970.  May be negative.\n"
64 "              defaults to now.\n"
65 "  timezone: timezone, see /usr/share/zoneinfo for a list.\n"
66 "              defaults to machine default.\n"
67 "  format:   a format the time is to be said in.  See voicemail.conf.\n"
68 "              defaults to \"ABdY 'digits/at' IMp\"\n";
69
70 STANDARD_LOCAL_USER;
71
72 LOCAL_USER_DECL;
73
74 static int sayunixtime_exec(struct ast_channel *chan, void *data)
75 {
76         AST_DECLARE_APP_ARGS(args,
77                              AST_APP_ARG(timeval);
78                              AST_APP_ARG(timezone);
79                              AST_APP_ARG(format);
80         );
81         char *parse;
82         int res = 0;
83         struct localuser *u;
84         time_t unixtime;
85         
86         if (!data)
87                 return 0;
88
89         if (!(parse = ast_strdupa(data)))
90                 return -1;
91
92         LOCAL_USER_ADD(u);
93
94         args.format = "c";              /* default datetime */
95
96         AST_STANDARD_APP_ARGS(args, parse);
97
98         ast_get_time_t(args.timeval, &unixtime, time(NULL));
99
100         if (chan->_state != AST_STATE_UP)
101                 res = ast_answer(chan);
102
103         if (!res)
104                 res = ast_say_date_with_format(chan, unixtime, AST_DIGIT_ANY,
105                                                chan->language, args.format, args.timezone);
106
107         LOCAL_USER_REMOVE(u);
108
109         return res;
110 }
111
112 int unload_module(void)
113 {
114         int res;
115         
116         res = ast_unregister_application(app_sayunixtime);
117         res |= ast_unregister_application(app_datetime);
118
119         STANDARD_HANGUP_LOCALUSERS;
120         
121         return res;
122 }
123
124 int load_module(void)
125 {
126         int res;
127         
128         res = ast_register_application(app_sayunixtime, sayunixtime_exec, sayunixtime_synopsis, sayunixtime_descrip);
129         res |= ast_register_application(app_datetime, sayunixtime_exec, sayunixtime_synopsis, datetime_descrip);
130         
131         return res;
132 }
133
134 char *description(void)
135 {
136         return tdesc;
137 }
138
139 int usecount(void)
140 {
141         int res;
142         STANDARD_USECOUNT(res);
143         return res;
144 }
145
146 char *key()
147 {
148         return ASTERISK_GPL_KEY;
149 }