Merge "pjproject_bundled: Allow IPv4/IPv6 (Dual Stack) configurations."
[asterisk/asterisk.git] / apps / app_dahdiras.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2005, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  *
21  * \brief Execute an ISDN RAS
22  *
23  * \author Mark Spencer <markster@digium.com>
24  * 
25  * \ingroup applications
26  */
27
28 /*** MODULEINFO
29         <depend>dahdi</depend>
30         <support_level>extended</support_level>
31  ***/
32
33 #include "asterisk.h"
34
35 ASTERISK_REGISTER_FILE()
36
37 #include <sys/ioctl.h>
38 #include <sys/wait.h>
39 #include <signal.h>
40 #include <fcntl.h>
41
42 #include <dahdi/user.h>
43
44 #include "asterisk/lock.h"
45 #include "asterisk/file.h"
46 #include "asterisk/channel.h"
47 #include "asterisk/pbx.h"
48 #include "asterisk/module.h"
49 #include "asterisk/app.h"
50
51 /*** DOCUMENTATION
52         <application name="DAHDIRAS" language="en_US">
53                 <synopsis>
54                         Executes DAHDI ISDN RAS application.
55                 </synopsis>
56                 <syntax>
57                         <parameter name="args" required="true">
58                                 <para>A list of parameters to pass to the pppd daemon,
59                                 separated by <literal>,</literal> characters.</para>
60                         </parameter>
61                 </syntax>
62                 <description>
63                         <para>Executes a RAS server using pppd on the given channel.
64                         The channel must be a clear channel (i.e. PRI source) and a DAHDI
65                         channel to be able to use this function (No modem emulation is included).</para>
66                         <para>Your pppd must be patched to be DAHDI aware.</para>
67                 </description>
68         </application>
69
70  ***/
71
72 static const char app[] = "DAHDIRAS";
73
74 #define PPP_MAX_ARGS    32
75 #define PPP_EXEC        "/usr/sbin/pppd"
76
77 static pid_t spawn_ras(struct ast_channel *chan, char *args)
78 {
79         pid_t pid;
80         char *c;
81
82         char *argv[PPP_MAX_ARGS];
83         int argc = 0;
84         char *stringp=NULL;
85
86         /* Start by forking */
87         pid = ast_safe_fork(1);
88         if (pid) {
89                 return pid;
90         }
91
92         /* Execute RAS on File handles */
93         dup2(ast_channel_fd(chan, 0), STDIN_FILENO);
94
95         /* Drop high priority */
96         if (ast_opt_high_priority)
97                 ast_set_priority(0);
98
99         /* Close other file descriptors */
100         ast_close_fds_above_n(STDERR_FILENO);
101
102         /* Reset all arguments */
103         memset(argv, 0, sizeof(argv));
104
105         /* First argument is executable, followed by standard
106            arguments for DAHDI PPP */
107         argv[argc++] = PPP_EXEC;
108         argv[argc++] = "nodetach";
109
110         /* And all the other arguments */
111         stringp=args;
112         c = strsep(&stringp, ",");
113         while(c && strlen(c) && (argc < (PPP_MAX_ARGS - 4))) {
114                 argv[argc++] = c;
115                 c = strsep(&stringp, ",");
116         }
117
118         argv[argc++] = "plugin";
119         argv[argc++] = "dahdi.so";
120         argv[argc++] = "stdin";
121
122         /* Finally launch PPP */
123         execv(PPP_EXEC, argv);
124         fprintf(stderr, "Failed to exec PPPD!\n");
125         exit(1);
126 }
127
128 static void run_ras(struct ast_channel *chan, char *args)
129 {
130         pid_t pid;
131         int status;
132         int res;
133         int signalled = 0;
134         struct dahdi_bufferinfo savebi;
135         int x;
136         
137         res = ioctl(ast_channel_fd(chan, 0), DAHDI_GET_BUFINFO, &savebi);
138         if(res) {
139                 ast_log(LOG_WARNING, "Unable to check buffer policy on channel %s\n", ast_channel_name(chan));
140                 return;
141         }
142
143         pid = spawn_ras(chan, args);
144         if (pid < 0) {
145                 ast_log(LOG_WARNING, "Failed to spawn RAS\n");
146         } else {
147                 for (;;) {
148                         res = waitpid(pid, &status, WNOHANG);
149                         if (!res) {
150                                 /* Check for hangup */
151                                 if (ast_check_hangup(chan) && !signalled) {
152                                         ast_debug(1, "Channel '%s' hungup.  Signalling RAS at %d to die...\n", ast_channel_name(chan), pid);
153                                         kill(pid, SIGTERM);
154                                         signalled=1;
155                                 }
156                                 /* Try again */
157                                 sleep(1);
158                                 continue;
159                         }
160                         if (res < 0) {
161                                 ast_log(LOG_WARNING, "waitpid returned %d: %s\n", res, strerror(errno));
162                         }
163                         if (WIFEXITED(status)) {
164                                 ast_verb(3, "RAS on %s terminated with status %d\n", ast_channel_name(chan), WEXITSTATUS(status));
165                         } else if (WIFSIGNALED(status)) {
166                                 ast_verb(3, "RAS on %s terminated with signal %d\n", 
167                                          ast_channel_name(chan), WTERMSIG(status));
168                         } else {
169                                 ast_verb(3, "RAS on %s terminated weirdly.\n", ast_channel_name(chan));
170                         }
171                         /* Throw back into audio mode */
172                         x = 1;
173                         ioctl(ast_channel_fd(chan, 0), DAHDI_AUDIOMODE, &x);
174
175                         /* Restore saved values */
176                         res = ioctl(ast_channel_fd(chan, 0), DAHDI_SET_BUFINFO, &savebi);
177                         if (res < 0) {
178                                 ast_log(LOG_WARNING, "Unable to set buffer policy on channel %s\n", ast_channel_name(chan));
179                         }
180                         break;
181                 }
182         }
183         ast_safe_fork_cleanup();
184 }
185
186 static int dahdiras_exec(struct ast_channel *chan, const char *data)
187 {
188         int res=-1;
189         char *args;
190         struct dahdi_params dahdip;
191
192         if (!data) 
193                 data = "";
194
195         args = ast_strdupa(data);
196         
197         /* Answer the channel if it's not up */
198         if (ast_channel_state(chan) != AST_STATE_UP)
199                 ast_answer(chan);
200         if (strcasecmp(ast_channel_tech(chan)->type, "DAHDI")) {
201                 /* If it's not a DAHDI channel, we're done.  Wait a couple of
202                    seconds and then hangup... */
203                 ast_verb(2, "Channel %s is not a DAHDI channel\n", ast_channel_name(chan));
204                 sleep(2);
205         } else {
206                 memset(&dahdip, 0, sizeof(dahdip));
207                 if (ioctl(ast_channel_fd(chan, 0), DAHDI_GET_PARAMS, &dahdip)) {
208                         ast_log(LOG_WARNING, "Unable to get DAHDI parameters\n");
209                 } else if (dahdip.sigtype != DAHDI_SIG_CLEAR) {
210                         ast_verb(2, "Channel %s is not a clear channel\n", ast_channel_name(chan));
211                 } else {
212                         /* Everything should be okay.  Run PPP. */
213                         ast_verb(3, "Starting RAS on %s\n", ast_channel_name(chan));
214                         /* Execute RAS */
215                         run_ras(chan, args);
216                 }
217         }
218         return res;
219 }
220
221 static int unload_module(void) 
222 {
223         return ast_unregister_application(app);
224 }
225
226 static int load_module(void)
227 {
228         return ((ast_register_application_xml(app, dahdiras_exec)) ? AST_MODULE_LOAD_FAILURE : AST_MODULE_LOAD_SUCCESS);
229 }
230
231 AST_MODULE_INFO_STANDARD_EXTENDED(ASTERISK_GPL_KEY, "DAHDI ISDN Remote Access Server");
232
233