app_flash.c

Go to the documentation of this file.

/*
 * Asterisk -- An open source telephony toolkit.
 *
 * Copyright (C) 1999 - 2005, Digium, Inc.
 *
 * Mark Spencer <[email protected]>
 *
 * See http://www.asterisk.org for more information about
 * the Asterisk project. Please do not directly contact
 * any of the maintainers of this project for assistance;
 * the project provides a web site, mailing lists and IRC
 * channels for your use.
 *
 * This program is free software, distributed under the terms of
 * the GNU General Public License Version 2. See the LICENSE file
 * at the top of the source tree.
 */

/*! \file
 *
 * \brief App to flash a DAHDI trunk
 *
 * \author Mark Spencer <[email protected]>
 *
 * \ingroup applications
 */

/*** MODULEINFO
 <depend>dahdi</depend>
 <support_level>core</support_level>
 ***/

#include "asterisk.h"

#include <dahdi/user.h>

#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"

/*** DOCUMENTATION
 <application name="Flash" language="en_US">
 <synopsis>
 Flashes a DAHDI Trunk.
 </synopsis>
 <syntax />
 <description>
 <para>Performs a flash on a DAHDI trunk. This can be used to access features
 provided on an incoming analogue circuit such as conference and call waiting.
 Use with SendDTMF() to perform external transfers.</para>
 </description>
 <see-also>
 <ref type="application">SendDTMF</ref>
 </see-also>
 </application>
 ***/

static char *app = "Flash";

static inline int dahdi_wait_event(int fd)
{
 /* Avoid the silly dahdi_waitevent which ignores a bunch of events */
 int i,j=0;
 i = DAHDI_IOMUX_SIGEVENT;
 if (ioctl(fd, DAHDI_IOMUX, &i) == -1) return -1;
 if (ioctl(fd, DAHDI_GETEVENT, &j) == -1) return -1;
 return j;
}

static int flash_exec(struct ast_channel *chan, const char *data)
{
 int res = -1;
 int x;
 struct dahdi_params dahdip;

 if (strcasecmp(ast_channel_tech(chan)->type, "DAHDI")) {
 ast_log(LOG_WARNING, "%s is not a DAHDI channel\n", ast_channel_name(chan));
 return -1;
 }

 memset(&dahdip, 0, sizeof(dahdip));
 res = ioctl(ast_channel_fd(chan, 0), DAHDI_GET_PARAMS, &dahdip);
 if (!res) {
 if (dahdip.sigtype & __DAHDI_SIG_FXS) {
 x = DAHDI_FLASH;
 res = ioctl(ast_channel_fd(chan, 0), DAHDI_HOOK, &x);
 if (!res || (errno == EINPROGRESS)) {
 if (res) {
 /* Wait for the event to finish */
 dahdi_wait_event(ast_channel_fd(chan, 0));
 }
 res = ast_safe_sleep(chan, 1000);
 ast_verb(3, "Flashed channel %s\n", ast_channel_name(chan));
 } else
 ast_log(LOG_WARNING, "Unable to flash channel %s: %s\n", ast_channel_name(chan), strerror(errno));
 } else
 ast_log(LOG_WARNING, "%s is not an FXO Channel\n", ast_channel_name(chan));
 } else
 ast_log(LOG_WARNING, "Unable to get parameters of %s: %s\n", ast_channel_name(chan), strerror(errno));

 return res;
}

static int unload_module(void)
{
 return ast_unregister_application(app);
}

static int load_module(void)
{
 return ast_register_application_xml(app, flash_exec);
}

AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Flash channel application");