How the AGI Interface Is Implemented in Asterisk

is one of the oldest and most stable telecommunication products ever openly released along with and . One of the reasons which make asterisk so awesome is its power to execute the scripts written in PHP, Perl, Shell, or some other languages. Asterisk Kamailio SIP Server Freeswitch Asterisk does so with the help of its AGI interface. AGI stands for Asterisk Gateway Interface. AGI provides an interface between the Asterisk dial plan and an external program that wants to manipulate a channel in the dial plan. In general, the interface is synchronous - actions are taken on a channel from an AGI block and do not return until the action is completed. AGI can be run on the local machine as well as remote machine. The support for different protocols is listed , just in case. here Basically, AGI in the asterisk console can be debugged using the command agi set debug on The debugging for the same can be disabled by agi set debug off AGI while launching a script goes through a series of tasks - First, we check whether the file we are trying to execute actually exists or not. 1- Then, we retrieve information about the script file pointed to by its pathname through the stat function. 2- struct stat st; if (stat(script, &st)) { } Then, we create a pipe that sends data into Asterisk from the script using the following command - 3- if (pipe( )) // sends data into asterisk as per the Linux man page creates a unidirectional data channel that can be used for interprocess communication. The array pipefd is used to return two file descriptors referring to the ends of the pipe. pipefd[0] refers to the read end of the pipe. pipefd[1] refers to the write end of the pipe. Data written to the write end of the pipe is buffered by the kernel until it is read from the read end of the pipe Pipe function Then, we create a pipe that sends data out of the script into Asterisk using the following command - 4- if (pipe( )) // sends data out of asterisk In case of failure, simply close the 2 FDs that are opened by the command above and return. Then, we create a pipe that sends data out linear PCMA audio. 5- If the audio pipe is successfully created, then we try the file access mode and the file status flags. 6- res = fcntl( [1], F_GETFL); where - Return the file access mode and the file status flags; F_GETFL and - the write end of the pipe [1] If success is returned, 7- res = fcntl( [1], F_SETFL, res | O_NONBLOCK); is used to manipulate/operate on file descriptors. In case of failure of any step, just close the FDs opened in its previous step. fcntl Once everything is set in place, we go for the execution of the script. The execution will be done by forking the process, and the child process will take the task of executing the script while the parent process will continue with its original task. To fork a process, we simply go for 8- pid = fork(); Once forked, we pass the paths to the AGI via the environmental variables. 9- setenv("AST_CONFIG_DIR", , 1); We duplicate the file descriptor to redirect stdin, stdout or to provide an enhanced audio channel. 10- dup2(fromast[0], STDIN_FILENO); dup2(toast[1], STDOUT_FILENO); We close the remaining FDs other than corresponding to that of stdin/out/error. So, it is basically closing all the FDs starting from 3 as 11- 0 → STDIN 1 → STDOUT 2 → STD_ERROR We then execute the script on the forked process. 12- execv(script, argv); Where consists of the arguments passed over to the script through AGI. argv Once the process is over, we just exit the forked process and close all the remaining opened FDs. 13- exit(1); Conclusion Needless to say, the devil is in the details. The more you will get into the technical side, the more knowledge can be gained. However, this is enough for you to grasp how the AGI interface is implemented in the asterisk and how it works with respect to a technical side. It’s all about small things, small implementations that make a big difference