Tue Mar 2 17:34:41 2010

Asterisk developer's documentation


Module: Dial plan applications

Applications support the dialplan. They register dynamically with. More...

Files

file  app_adsiprog.c
 

Program Asterisk ADSI Scripts into phone.


file  app_alarmreceiver.c
 

Central Station Alarm receiver for Ademco Contact ID.


file  app_authenticate.c
 

Execute arbitrary authenticate commands.


file  app_cdr.c
 

Applications connected with CDR engine.


file  app_chanisavail.c
 

Check if Channel is Available.


file  app_channelredirect.c
 

ChannelRedirect application.


file  app_chanspy.c
 

ChanSpy: Listen in on any channel.


file  app_controlplayback.c
 

Trivial application to control playback of a sound file.


file  app_dahdibarge.c
 

DAHDI Barge support.


file  app_dahdiras.c
 

Execute an ISDN RAS.


file  app_dahdiscan.c
 

DAHDI Scanner.


file  app_db.c
 

Database access functions.


file  app_dial.c
 

dial() & retrydial() - Trivial application to dial a channel and send an URL on answer


file  app_dictate.c
 

Virtual Dictation Machine Application For Asterisk.


file  app_directed_pickup.c
 

Directed Call Pickup Support.


file  app_directory.c
 

Provide a directory of extensions.


file  app_disa.c
 

DISA -- Direct Inward System Access Application.


file  app_dumpchan.c
 

Application to dump channel variables.


file  app_echo.c
 

Echo application -- play back what you hear to evaluate latency.


file  app_exec.c
 

Exec application.


file  app_externalivr.c
 

External IVR application interface.


file  app_festival.c
 

Connect to festival.


file  app_flash.c
 

App to flash a DAHDI trunk.


file  app_followme.c
 

Find-Me Follow-Me application.


file  app_forkcdr.c
 

Fork CDR application.


file  app_getcpeid.c
 

Get ADSI CPE ID.


file  app_ices.c
 

Stream to an icecast server via ICES (see contrib/asterisk-ices.xml).


file  app_image.c
 

App to transmit an image.


file  app_ivrdemo.c
 

IVR Demo application.


file  app_jack.c
 

Jack Application.


file  app_macro.c
 

Dial plan macro Implementation.


file  app_meetme.c
 

Meet me conference bridge and Shared Line Appearances.


file  app_milliwatt.c
 

Digital Milliwatt Test.


file  app_minivm.c
 

MiniVoiceMail - A Minimal Voicemail System for Asterisk.


file  app_mixmonitor.c
 

MixMonitor() - Record a call and mix the audio during the recording.


file  app_morsecode.c
 

Morsecode application.


file  app_mp3.c
 

Silly application to play an MP3 file -- uses mpg123.


file  app_nbscat.c
 

Silly application to play an NBScat file -- uses nbscat8k.


file  app_osplookup.c
 

Open Settlement Protocol (OSP) Applications.


file  app_page.c
 

page() - Paging application


file  app_parkandannounce.c
 

ParkAndAnnounce application for Asterisk.


file  app_playback.c
 

Trivial application to playback a sound file.


file  app_privacy.c
 

Block all calls without Caller*ID, require phone # to be entered.


file  app_queue.c
 

True call queues with optional send URL on answer.


file  app_read.c
 

Trivial application to read a variable.


file  app_readexten.c
 

Trivial application to read an extension into a variable.


file  app_readfile.c
 

ReadFile application -- Reads in a File for you.


file  app_record.c
 

Trivial application to record a sound file.


file  app_sayunixtime.c
 

SayUnixTime application.


file  app_senddtmf.c
 

App to send DTMF digits.


file  app_sendtext.c
 

App to transmit a text message.


file  app_setcallerid.c
 

App to set callerid presentation.


file  app_skel.c
 

Skeleton application.


file  app_sms.c
 

SMS application - ETSI ES 201 912 protocol 1 implementation.


file  app_softhangup.c
 

SoftHangup application.


file  app_speech_utils.c
 

Speech Recognition Utility Applications.


file  app_stack.c
 

Stack applications Gosub, Return, etc.


file  app_system.c
 

Execute arbitrary system commands.


file  app_talkdetect.c
 

Playback a file with audio detect.


file  app_test.c
 

Applications to test connection and produce report in text file.


file  app_transfer.c
 

Transfer a caller.


file  app_url.c
 

App to transmit a URL.


file  app_userevent.c
 

UserEvent application -- send manager event.


file  app_verbose.c
 

Verbose logging application.


file  app_voicemail.c
 

Comedian Mail - Voicemail System.


file  app_waitforring.c
 

Wait for Ring Application.


file  app_waitforsilence.c
 

Wait for Silence

  • Waits for up to 'x' milliseconds of silence, 'y' times
  • WaitForSilence(500,2) will wait for 1/2 second of silence, twice
  • WaitForSilence(1000,1) will wait for 1 second of silence, once
  • WaitForSilence(300,3,10) will wait for 300ms of silence, 3 times, and return after 10sec
    .

file  app_waituntil.c
 

Sleep until the given epoch.


file  app_while.c
 

While Loop Implementation.


file  app_zapateller.c
 

Playback the special information tone to get rid of telemarketers.


file  res_ael_share.c
 

Shareable AEL code -- mainly between internal and external modules.


file  res_realtime.c
 

RealTime CLI.


Functions

static int iax2_prov_app (struct ast_channel *chan, void *data)
static int pbx_builtin_answer (struct ast_channel *, void *)
static int pbx_builtin_background (struct ast_channel *, void *)
static int pbx_builtin_busy (struct ast_channel *, void *)
static int pbx_builtin_congestion (struct ast_channel *, void *)
static int pbx_builtin_execiftime (struct ast_channel *, void *)
static int pbx_builtin_goto (struct ast_channel *, void *)
static int pbx_builtin_gotoiftime (struct ast_channel *, void *)
static int pbx_builtin_hangup (struct ast_channel *, void *)
static int pbx_builtin_proceeding (struct ast_channel *, void *)
static int pbx_builtin_progress (struct ast_channel *, void *)
static int pbx_builtin_resetcdr (struct ast_channel *, void *)
static int pbx_builtin_ringing (struct ast_channel *, void *)
static int pbx_builtin_setamaflags (struct ast_channel *, void *)
static int pbx_builtin_wait (struct ast_channel *, void *)
static int pbx_builtin_waitexten (struct ast_channel *, void *)

Detailed Description

Applications support the dialplan. They register dynamically with.

Asterisk Dial Plan Applications

See also:
ast_register_application() and unregister with
ast_unregister_application()
See also

Function Documentation

static int iax2_prov_app ( struct ast_channel chan,
void *  data 
) [static]

iax2provision

Definition at line 11201 of file chan_iax2.c.

References iax2_trunk_peer::addr, ast_inet_ntoa(), ast_log(), ast_strdupa, ast_strlen_zero(), ast_verb, iax2_provision(), LOG_NOTICE, PTR_TO_CALLNO, iax2_trunk_peer::sockfd, ast_channel::tech, and ast_channel::tech_pvt.

Referenced by load_module().

11202 {
11203    int res;
11204    char *sdata;
11205    char *opts;
11206    int force =0;
11207    unsigned short callno = PTR_TO_CALLNO(chan->tech_pvt);
11208    if (ast_strlen_zero(data))
11209       data = "default";
11210    sdata = ast_strdupa(data);
11211    opts = strchr(sdata, '|');
11212    if (opts)
11213       *opts='\0';
11214 
11215    if (chan->tech != &iax2_tech) {
11216       ast_log(LOG_NOTICE, "Can't provision a non-IAX device!\n");
11217       return -1;
11218    } 
11219    if (!callno || !iaxs[callno] || !iaxs[callno]->addr.sin_addr.s_addr) {
11220       ast_log(LOG_NOTICE, "Can't provision something with no IP?\n");
11221       return -1;
11222    }
11223    res = iax2_provision(&iaxs[callno]->addr, iaxs[callno]->sockfd, NULL, sdata, force);
11224    ast_verb(3, "Provisioned IAXY at '%s' with '%s'= %d\n",
11225       ast_inet_ntoa(iaxs[callno]->addr.sin_addr),
11226       sdata, res);
11227    return res;
11228 }

static int pbx_builtin_answer ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 7946 of file pbx.c.

References __ast_answer(), ast_channel::_state, AST_STATE_UP, and ast_strlen_zero().

07947 {
07948    int delay = 0;
07949 
07950    if ((chan->_state != AST_STATE_UP) && !ast_strlen_zero(data))
07951       delay = atoi(data);
07952 
07953    if (delay < 0) {
07954       delay = 0;
07955    }
07956 
07957    return __ast_answer(chan, delay, 1);
07958 }

static int pbx_builtin_background ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 8215 of file pbx.c.

References ast_channel::_state, ast_answer(), AST_APP_ARG, ast_app_parse_options(), ast_canmatch_extension(), ast_channel_lock, ast_channel_unlock, ast_copy_string(), AST_DECLARE_APP_ARGS, AST_DIGIT_ANY, AST_FLAG_DISABLE_WORKAROUNDS, ast_log(), ast_matchmore_extension(), AST_STANDARD_APP_ARGS, AST_STATE_UP, ast_stopstream(), ast_strdupa, ast_streamfile(), ast_strlen_zero(), ast_test_flag, ast_waitstream(), ast_waitstream_exten(), BACKGROUND_MATCHEXTEN, BACKGROUND_NOANSWER, BACKGROUND_PLAYBACK, BACKGROUND_SKIP, ast_channel::cid, ast_callerid::cid_num, ast_channel::context, ast_channel::exten, ast_flags::flags, LOG_WARNING, parse(), pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), ast_channel::priority, and strsep().

08216 {
08217    int res = 0;
08218    int mres = 0;
08219    struct ast_flags flags = {0};
08220    char *parse, exten[2] = "";
08221    AST_DECLARE_APP_ARGS(args,
08222       AST_APP_ARG(filename);
08223       AST_APP_ARG(options);
08224       AST_APP_ARG(lang);
08225       AST_APP_ARG(context);
08226    );
08227 
08228    if (ast_strlen_zero(data)) {
08229       ast_log(LOG_WARNING, "Background requires an argument (filename)\n");
08230       return -1;
08231    }
08232 
08233    parse = ast_strdupa(data);
08234 
08235    AST_STANDARD_APP_ARGS(args, parse);
08236 
08237    if (ast_strlen_zero(args.lang))
08238       args.lang = (char *)chan->language; /* XXX this is const */
08239 
08240    if (ast_strlen_zero(args.context)) {
08241       const char *context;
08242       ast_channel_lock(chan);
08243       if ((context = pbx_builtin_getvar_helper(chan, "MACRO_CONTEXT"))) {
08244          args.context = ast_strdupa(context);
08245       } else {
08246          args.context = chan->context;
08247       }
08248       ast_channel_unlock(chan);
08249    }
08250 
08251    if (args.options) {
08252       if (!strcasecmp(args.options, "skip"))
08253          flags.flags = BACKGROUND_SKIP;
08254       else if (!strcasecmp(args.options, "noanswer"))
08255          flags.flags = BACKGROUND_NOANSWER;
08256       else
08257          ast_app_parse_options(background_opts, &flags, NULL, args.options);
08258    }
08259 
08260    /* Answer if need be */
08261    if (chan->_state != AST_STATE_UP) {
08262       if (ast_test_flag(&flags, BACKGROUND_SKIP)) {
08263          goto done;
08264       } else if (!ast_test_flag(&flags, BACKGROUND_NOANSWER)) {
08265          res = ast_answer(chan);
08266       }
08267    }
08268 
08269    if (!res) {
08270       char *back = args.filename;
08271       char *front;
08272 
08273       ast_stopstream(chan);      /* Stop anything playing */
08274       /* Stream the list of files */
08275       while (!res && (front = strsep(&back, "&")) ) {
08276          if ( (res = ast_streamfile(chan, front, args.lang)) ) {
08277             ast_log(LOG_WARNING, "ast_streamfile failed on %s for %s\n", chan->name, (char*)data);
08278             res = 0;
08279             mres = 1;
08280             break;
08281          }
08282          if (ast_test_flag(&flags, BACKGROUND_PLAYBACK)) {
08283             res = ast_waitstream(chan, "");
08284          } else if (ast_test_flag(&flags, BACKGROUND_MATCHEXTEN)) {
08285             res = ast_waitstream_exten(chan, args.context);
08286          } else {
08287             res = ast_waitstream(chan, AST_DIGIT_ANY);
08288          }
08289          ast_stopstream(chan);
08290       }
08291    }
08292 
08293    /*
08294     * If the single digit DTMF is an extension in the specified context, then
08295     * go there and signal no DTMF.  Otherwise, we should exit with that DTMF.
08296     * If we're in Macro, we'll exit and seek that DTMF as the beginning of an
08297     * extension in the Macro's calling context.  If we're not in Macro, then
08298     * we'll simply seek that extension in the calling context.  Previously,
08299     * someone complained about the behavior as it related to the interior of a
08300     * Gosub routine, and the fix (#14011) inadvertently broke FreePBX
08301     * (#14940).  This change should fix both of these situations, but with the
08302     * possible incompatibility that if a single digit extension does not exist
08303     * (but a longer extension COULD have matched), it would have previously
08304     * gone immediately to the "i" extension, but will now need to wait for a
08305     * timeout.
08306     *
08307     * Later, we had to add a flag to disable this workaround, because AGI
08308     * users can EXEC Background and reasonably expect that the DTMF code will
08309     * be returned (see #16434).
08310     */
08311    if (!ast_test_flag(chan, AST_FLAG_DISABLE_WORKAROUNDS) &&
08312          (exten[0] = res) &&
08313          ast_canmatch_extension(chan, args.context, exten, 1, chan->cid.cid_num) &&
08314          !ast_matchmore_extension(chan, args.context, exten, 1, chan->cid.cid_num)) {
08315       snprintf(chan->exten, sizeof(chan->exten), "%c", res);
08316       ast_copy_string(chan->context, args.context, sizeof(chan->context));
08317       chan->priority = 0;
08318       res = 0;
08319    }
08320 done:
08321    pbx_builtin_setvar_helper(chan, "BACKGROUNDSTATUS", mres ? "FAILED" : "SUCCESS");
08322    return res;
08323 }

static int pbx_builtin_busy ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 7916 of file pbx.c.

References ast_channel::_state, ast_cdr_busy(), AST_CONTROL_BUSY, ast_indicate(), ast_setstate(), AST_STATE_BUSY, AST_STATE_UP, ast_channel::cdr, and wait_for_hangup().

Referenced by __ast_pbx_run().

07917 {
07918    ast_indicate(chan, AST_CONTROL_BUSY);
07919    /* Don't change state of an UP channel, just indicate
07920       busy in audio */
07921    if (chan->_state != AST_STATE_UP) {
07922       ast_setstate(chan, AST_STATE_BUSY);
07923       ast_cdr_busy(chan->cdr);
07924    }
07925    wait_for_hangup(chan, data);
07926    return -1;
07927 }

static int pbx_builtin_congestion ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 7932 of file pbx.c.

References ast_channel::_state, AST_CONTROL_CONGESTION, ast_indicate(), ast_setstate(), AST_STATE_BUSY, AST_STATE_UP, and wait_for_hangup().

Referenced by __ast_pbx_run().

07933 {
07934    ast_indicate(chan, AST_CONTROL_CONGESTION);
07935    /* Don't change state of an UP channel, just indicate
07936       congestion in audio */
07937    if (chan->_state != AST_STATE_UP)
07938       ast_setstate(chan, AST_STATE_BUSY);
07939    wait_for_hangup(chan, data);
07940    return -1;
07941 }

static int pbx_builtin_execiftime ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 8082 of file pbx.c.

References ast_build_timing(), ast_check_timing(), ast_log(), ast_strdupa, ast_strlen_zero(), LOG_WARNING, pbx_exec(), pbx_findapp(), s, S_OR, and strsep().

08083 {
08084    char *s, *appname;
08085    struct ast_timing timing;
08086    struct ast_app *app;
08087    static const char *usage = "ExecIfTime requires an argument:\n  <time range>,<days of week>,<days of month>,<months>?<appname>[(<appargs>)]";
08088 
08089    if (ast_strlen_zero(data)) {
08090       ast_log(LOG_WARNING, "%s\n", usage);
08091       return -1;
08092    }
08093 
08094    appname = ast_strdupa(data);
08095 
08096    s = strsep(&appname, "?"); /* Separate the timerange and application name/data */
08097    if (!appname) {   /* missing application */
08098       ast_log(LOG_WARNING, "%s\n", usage);
08099       return -1;
08100    }
08101 
08102    if (!ast_build_timing(&timing, s)) {
08103       ast_log(LOG_WARNING, "Invalid Time Spec: %s\nCorrect usage: %s\n", s, usage);
08104       return -1;
08105    }
08106 
08107    if (!ast_check_timing(&timing))  /* outside the valid time window, just return */
08108       return 0;
08109 
08110    /* now split appname(appargs) */
08111    if ((s = strchr(appname, '('))) {
08112       char *e;
08113       *s++ = '\0';
08114       if ((e = strrchr(s, ')')))
08115          *e = '\0';
08116       else
08117          ast_log(LOG_WARNING, "Failed to find closing parenthesis\n");
08118    }
08119       
08120 
08121    if ((app = pbx_findapp(appname))) {
08122       return pbx_exec(chan, app, S_OR(s, ""));
08123    } else {
08124       ast_log(LOG_WARNING, "Cannot locate application %s\n", appname);
08125       return -1;
08126    }
08127 }

static int pbx_builtin_goto ( struct ast_channel chan,
void *  data 
) [static]

Goto

Definition at line 8328 of file pbx.c.

References ast_parseable_goto(), ast_verb, ast_channel::context, ast_channel::exten, and ast_channel::priority.

Referenced by pbx_builtin_gotoif(), and pbx_builtin_gotoiftime().

08329 {
08330    int res = ast_parseable_goto(chan, data);
08331    if (!res)
08332       ast_verb(3, "Goto (%s,%s,%d)\n", chan->context, chan->exten, chan->priority + 1);
08333    return res;
08334 }

static int pbx_builtin_gotoiftime ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 8048 of file pbx.c.

References ast_build_timing(), ast_check_timing(), ast_debug, ast_log(), ast_strdupa, ast_strlen_zero(), LOG_WARNING, pbx_builtin_goto(), s, and strsep().

08049 {
08050    char *s, *ts, *branch1, *branch2, *branch;
08051    struct ast_timing timing;
08052 
08053    if (ast_strlen_zero(data)) {
08054       ast_log(LOG_WARNING, "GotoIfTime requires an argument:\n  <time range>,<days of week>,<days of month>,<months>?'labeliftrue':'labeliffalse'\n");
08055       return -1;
08056    }
08057 
08058    ts = s = ast_strdupa(data);
08059 
08060    /* Separate the Goto path */
08061    strsep(&ts, "?");
08062    branch1 = strsep(&ts,":");
08063    branch2 = strsep(&ts,"");
08064 
08065    /* struct ast_include include contained garbage here, fixed by zeroing it on get_timerange */
08066    if (ast_build_timing(&timing, s) && ast_check_timing(&timing))
08067       branch = branch1;
08068    else
08069       branch = branch2;
08070 
08071    if (ast_strlen_zero(branch)) {
08072       ast_debug(1, "Not taking any branch\n");
08073       return 0;
08074    }
08075 
08076    return pbx_builtin_goto(chan, branch);
08077 }

static int pbx_builtin_hangup ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 8018 of file pbx.c.

References AST_CAUSE_NORMAL_CLEARING, ast_log(), ast_str2cause(), ast_strlen_zero(), ast_channel::hangupcause, and LOG_WARNING.

08019 {
08020    if (!ast_strlen_zero(data)) {
08021       int cause;
08022       char *endptr;
08023 
08024       if ((cause = ast_str2cause(data)) > -1) {
08025          chan->hangupcause = cause;
08026          return -1;
08027       }
08028       
08029       cause = strtol((const char *) data, &endptr, 10);
08030       if (cause != 0 || (data != endptr)) {
08031          chan->hangupcause = cause;
08032          return -1;
08033       }
08034          
08035       ast_log(LOG_WARNING, "Invalid cause given to Hangup(): \"%s\"\n", (char *) data);
08036    }
08037 
08038    if (!chan->hangupcause) {
08039       chan->hangupcause = AST_CAUSE_NORMAL_CLEARING;
08040    }
08041 
08042    return -1;
08043 }

static int pbx_builtin_proceeding ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 7889 of file pbx.c.

References AST_CONTROL_PROCEEDING, and ast_indicate().

07890 {
07891    ast_indicate(chan, AST_CONTROL_PROCEEDING);
07892    return 0;
07893 }

static int pbx_builtin_progress ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 7898 of file pbx.c.

References AST_CONTROL_PROGRESS, and ast_indicate().

07899 {
07900    ast_indicate(chan, AST_CONTROL_PROGRESS);
07901    return 0;
07902 }

static int pbx_builtin_resetcdr ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 7990 of file pbx.c.

References ast_app_parse_options(), ast_cdr_reset(), ast_strdupa, ast_strlen_zero(), and ast_channel::cdr.

07991 {
07992    char *args;
07993    struct ast_flags flags = { 0 };
07994 
07995    if (!ast_strlen_zero(data)) {
07996       args = ast_strdupa(data);
07997       ast_app_parse_options(resetcdr_opts, &flags, NULL, args);
07998    }
07999 
08000    ast_cdr_reset(chan->cdr, &flags);
08001 
08002    return 0;
08003 }

static int pbx_builtin_ringing ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 7907 of file pbx.c.

References AST_CONTROL_RINGING, and ast_indicate().

07908 {
07909    ast_indicate(chan, AST_CONTROL_RINGING);
07910    return 0;
07911 }

static int pbx_builtin_setamaflags ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 8008 of file pbx.c.

References ast_cdr_setamaflags().

08009 {
08010    /* Copy the AMA Flags as specified */
08011    ast_cdr_setamaflags(chan, data ? data : "");
08012    return 0;
08013 }

static int pbx_builtin_wait ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 8132 of file pbx.c.

References ast_safe_sleep(), and s.

08133 {
08134    double s;
08135    int ms;
08136 
08137    /* Wait for "n" seconds */
08138    if (data && (s = atof(data)) > 0.0) {
08139       ms = s * 1000.0;
08140       return ast_safe_sleep(chan, ms);
08141    }
08142    return 0;
08143 }

static int pbx_builtin_waitexten ( struct ast_channel chan,
void *  data 
) [static]

Definition at line 8148 of file pbx.c.

References ast_channel::_softhangup, AST_APP_ARG, ast_app_parse_options(), AST_CONTROL_HOLD, AST_CONTROL_UNHOLD, AST_DECLARE_APP_ARGS, ast_exists_extension(), ast_get_indication_tone(), ast_indicate(), ast_indicate_data(), ast_log(), ast_playtones_start(), ast_playtones_stop(), AST_SOFTHANGUP_TIMEOUT, AST_STANDARD_APP_ARGS, ast_strdupa, ast_strlen_zero(), ast_test_flag, ast_tonepair_start(), ast_verb, ast_waitfordigit(), ast_channel::cid, ast_callerid::cid_num, ast_channel::context, tone_zone_sound::data, ast_channel::exten, LOG_WARNING, parse(), ast_channel::pbx, ast_channel::priority, ast_pbx::rtimeoutms, s, S_OR, set_ext_pri(), WAITEXTEN_DIALTONE, WAITEXTEN_MOH, and ast_channel::zone.

08149 {
08150    int ms, res;
08151    double s;
08152    struct ast_flags flags = {0};
08153    char *opts[1] = { NULL };
08154    char *parse;
08155    AST_DECLARE_APP_ARGS(args,
08156       AST_APP_ARG(timeout);
08157       AST_APP_ARG(options);
08158    );
08159 
08160    if (!ast_strlen_zero(data)) {
08161       parse = ast_strdupa(data);
08162       AST_STANDARD_APP_ARGS(args, parse);
08163    } else
08164       memset(&args, 0, sizeof(args));
08165 
08166    if (args.options)
08167       ast_app_parse_options(waitexten_opts, &flags, opts, args.options);
08168    
08169    if (ast_test_flag(&flags, WAITEXTEN_MOH) && !opts[0] ) {
08170       ast_log(LOG_WARNING, "The 'm' option has been specified for WaitExten without a class.\n"); 
08171    } else if (ast_test_flag(&flags, WAITEXTEN_MOH)) {
08172       ast_indicate_data(chan, AST_CONTROL_HOLD, S_OR(opts[0], NULL), strlen(opts[0]));
08173    } else if (ast_test_flag(&flags, WAITEXTEN_DIALTONE)) {
08174       const struct tone_zone_sound *ts = ast_get_indication_tone(chan->zone, "dial");
08175       if (ts)
08176          ast_playtones_start(chan, 0, ts->data, 0);
08177       else
08178          ast_tonepair_start(chan, 350, 440, 0, 0);
08179    }
08180    /* Wait for "n" seconds */
08181    if (args.timeout && (s = atof(args.timeout)) > 0)
08182        ms = s * 1000.0;
08183    else if (chan->pbx)
08184       ms = chan->pbx->rtimeoutms;
08185    else
08186       ms = 10000;
08187 
08188    res = ast_waitfordigit(chan, ms);
08189    if (!res) {
08190       if (ast_exists_extension(chan, chan->context, chan->exten, chan->priority + 1, chan->cid.cid_num)) {
08191          ast_verb(3, "Timeout on %s, continuing...\n", chan->name);
08192       } else if (chan->_softhangup == AST_SOFTHANGUP_TIMEOUT) {
08193          ast_verb(3, "Call timeout on %s, checking for 'T'\n", chan->name);
08194          res = -1;
08195       } else if (ast_exists_extension(chan, chan->context, "t", 1, chan->cid.cid_num)) {
08196          ast_verb(3, "Timeout on %s, going to 't'\n", chan->name);
08197          set_ext_pri(chan, "t", 0); /* 0 will become 1, next time through the loop */
08198       } else {
08199          ast_log(LOG_WARNING, "Timeout but no rule 't' in context '%s'\n", chan->context);
08200          res = -1;
08201       }
08202    }
08203 
08204    if (ast_test_flag(&flags, WAITEXTEN_MOH))
08205       ast_indicate(chan, AST_CONTROL_UNHOLD);
08206    else if (ast_test_flag(&flags, WAITEXTEN_DIALTONE))
08207       ast_playtones_stop(chan);
08208 
08209    return res;
08210 }


Generated on 2 Mar 2010 for Asterisk - the Open Source PBX by  doxygen 1.6.1