Fri Mar 8 17:30:15 2019

Asterisk developer's documentation


Module: Dial plan applications

Applications support the dialplan. They register dynamically with ast_register_application() and unregister with ast_unregister_application(). 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
 

Zap Barge support.


file  app_dahdiras.c
 

Execute an ISDN RAS.


file  app_dahdiscan.c
 

Zap 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_hasnewvoicemail.c
 

HasVoicemail application.


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_lookupblacklist.c
 

App to lookup the callerid number, and see if it is blacklisted.


file  app_lookupcidname.c
 

App to set callerid name from database, based on directory number.


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_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_random.c
 

Random application.


file  app_read.c
 

Trivial application to read a variable.


file  app_readfile.c
 

ReadFile application -- Reads in a File for you.


file  app_realtime.c
 

RealTime App.


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.


file  app_setcdruserfield.c
 

Applictions connected with CDR engine.


file  app_settransfercapability.c
 

App to set the ISDN Transfer Capability.


file  app_skel.c
 

Skeleton application.


file  app_sms.c
 

SMS application - ETSI ES 201 912 protocol 1 implimentation.


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_while.c
 

While Loop Implementation.


file  app_zapateller.c
 

Playback the special information tone to get rid of telemarketers.


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 ast_register_application() and unregister with ast_unregister_application().

Asterisk Dial Plan Applications

See also

Function Documentation

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

iax2provision

Definition at line 10285 of file chan_iax2.c.

References iax2_registry::addr, ast_inet_ntoa(), ast_log(), ast_strdupa, ast_strlen_zero(), ast_verbose(), iax2_registry::callno, iax2_provision(), LOG_NOTICE, option_verbose, PTR_TO_CALLNO, create_addr_info::sockfd, ast_channel::tech, ast_channel::tech_pvt, and VERBOSE_PREFIX_3.

Referenced by load_module().

10286 {
10287    int res;
10288    char *sdata;
10289    char *opts;
10290    int force =0;
10291    unsigned short callno = PTR_TO_CALLNO(chan->tech_pvt);
10292    if (ast_strlen_zero(data))
10293       data = "default";
10294    sdata = ast_strdupa(data);
10295    opts = strchr(sdata, '|');
10296    if (opts)
10297       *opts='\0';
10298 
10299    if (chan->tech != &iax2_tech) {
10300       ast_log(LOG_NOTICE, "Can't provision a non-IAX device!\n");
10301       return -1;
10302    } 
10303    if (!callno || !iaxs[callno] || !iaxs[callno]->addr.sin_addr.s_addr) {
10304       ast_log(LOG_NOTICE, "Can't provision something with no IP?\n");
10305       return -1;
10306    }
10307    res = iax2_provision(&iaxs[callno]->addr, iaxs[callno]->sockfd, NULL, sdata, force);
10308    if (option_verbose > 2)
10309       ast_verbose(VERBOSE_PREFIX_3 "Provisioned IAXY at '%s' with '%s'= %d\n", 
10310       ast_inet_ntoa(iaxs[callno]->addr.sin_addr),
10311       sdata, res);
10312    return res;
10313 }

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

Definition at line 5562 of file pbx.c.

References ast_channel::_state, ast_answer(), ast_safe_sleep(), AST_STATE_UP, and ast_strlen_zero().

05563 {
05564    int delay = 0;
05565    int res;
05566 
05567    if (chan->_state == AST_STATE_UP)
05568       delay = 0;
05569    else if (!ast_strlen_zero(data))
05570       delay = atoi(data);
05571 
05572    res = ast_answer(chan);
05573    if (res)
05574       return res;
05575 
05576    if (delay)
05577       res = ast_safe_sleep(chan, delay);
05578 
05579    return res;
05580 }

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

Definition at line 5795 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(), ast_channel::priority, and strsep().

05796 {
05797    int res = 0;
05798    struct ast_flags flags = {0};
05799    char *parse, exten[2] = "";
05800    AST_DECLARE_APP_ARGS(args,
05801       AST_APP_ARG(filename);
05802       AST_APP_ARG(options);
05803       AST_APP_ARG(lang);
05804       AST_APP_ARG(context);
05805    );
05806 
05807    if (ast_strlen_zero(data)) {
05808       ast_log(LOG_WARNING, "Background requires an argument (filename)\n");
05809       return -1;
05810    }
05811 
05812    parse = ast_strdupa(data);
05813 
05814    AST_STANDARD_APP_ARGS(args, parse);
05815 
05816    if (ast_strlen_zero(args.lang))
05817       args.lang = (char *)chan->language; /* XXX this is const */
05818 
05819    if (ast_strlen_zero(args.context)) {
05820       const char *context;
05821       ast_channel_lock(chan);
05822       if ((context = pbx_builtin_getvar_helper(chan, "MACRO_CONTEXT"))) {
05823          args.context = ast_strdupa(context);
05824       } else {
05825          args.context = chan->context;
05826       }
05827       ast_channel_unlock(chan);
05828    }
05829 
05830    if (args.options) {
05831       if (!strcasecmp(args.options, "skip"))
05832          flags.flags = BACKGROUND_SKIP;
05833       else if (!strcasecmp(args.options, "noanswer"))
05834          flags.flags = BACKGROUND_NOANSWER;
05835       else
05836          ast_app_parse_options(background_opts, &flags, NULL, args.options);
05837    }
05838 
05839    /* Answer if need be */
05840    if (chan->_state != AST_STATE_UP) {
05841       if (ast_test_flag(&flags, BACKGROUND_SKIP)) {
05842          return 0;
05843       } else if (!ast_test_flag(&flags, BACKGROUND_NOANSWER)) {
05844          res = ast_answer(chan);
05845       }
05846    }
05847 
05848    if (!res) {
05849       char *back = args.filename;
05850       char *front;
05851       ast_stopstream(chan);      /* Stop anything playing */
05852       /* Stream the list of files */
05853       while (!res && (front = strsep(&back, "&")) ) {
05854          if ( (res = ast_streamfile(chan, front, args.lang)) ) {
05855             ast_log(LOG_WARNING, "ast_streamfile failed on %s for %s\n", chan->name, (char*)data);
05856             res = 0;
05857             break;
05858          }
05859          if (ast_test_flag(&flags, BACKGROUND_PLAYBACK)) {
05860             res = ast_waitstream(chan, "");
05861          } else if (ast_test_flag(&flags, BACKGROUND_MATCHEXTEN)) {
05862             res = ast_waitstream_exten(chan, args.context);
05863          } else {
05864             res = ast_waitstream(chan, AST_DIGIT_ANY);
05865          }
05866          ast_stopstream(chan);
05867       }
05868    }
05869 
05870    /*
05871     * If the single digit DTMF is an extension in the specified context, then
05872     * go there and signal no DTMF.  Otherwise, we should exit with that DTMF.
05873     * If we're in Macro, we'll exit and seek that DTMF as the beginning of an
05874     * extension in the Macro's calling context.  If we're not in Macro, then
05875     * we'll simply seek that extension in the calling context.  Previously,
05876     * someone complained about the behavior as it related to the interior of a
05877     * Gosub routine, and the fix (#14011) inadvertently broke FreePBX
05878     * (#14940).  This change should fix both of these situations, but with the
05879     * possible incompatibility that if a single digit extension does not exist
05880     * (but a longer extension COULD have matched), it would have previously
05881     * gone immediately to the "i" extension, but will now need to wait for a
05882     * timeout.
05883     *
05884     * Later, we had to add a flag to disable this workaround, because AGI
05885     * users can EXEC Background and reasonably expect that the DTMF code will
05886     * be returned (see #16434).
05887     */
05888    if (!ast_test_flag(chan, AST_FLAG_DISABLE_WORKAROUNDS) &&
05889          (exten[0] = res) &&
05890          ast_canmatch_extension(chan, args.context, exten, 1, chan->cid.cid_num) &&
05891          !ast_matchmore_extension(chan, args.context, exten, 1, chan->cid.cid_num)) {
05892       snprintf(chan->exten, sizeof(chan->exten), "%c", res);
05893       ast_copy_string(chan->context, args.context, sizeof(chan->context));
05894       chan->priority = 0;
05895       res = 0;
05896    }
05897    return res;
05898 }

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

Definition at line 5532 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().

05533 {
05534    ast_indicate(chan, AST_CONTROL_BUSY);
05535    /* Don't change state of an UP channel, just indicate
05536       busy in audio */
05537    if (chan->_state != AST_STATE_UP) {
05538       ast_setstate(chan, AST_STATE_BUSY);
05539       ast_cdr_busy(chan->cdr);
05540    }
05541    wait_for_hangup(chan, data);
05542    return -1;
05543 }

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

Definition at line 5548 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().

05549 {
05550    ast_indicate(chan, AST_CONTROL_CONGESTION);
05551    /* Don't change state of an UP channel, just indicate
05552       congestion in audio */
05553    if (chan->_state != AST_STATE_UP)
05554       ast_setstate(chan, AST_STATE_BUSY);
05555    wait_for_hangup(chan, data);
05556    return -1;
05557 }

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

Definition at line 5675 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().

05676 {
05677    char *s, *appname;
05678    struct ast_timing timing;
05679    struct ast_app *app;
05680    static const char *usage = "ExecIfTime requires an argument:\n  <time range>|<days of week>|<days of month>|<months>?<appname>[|<appargs>]";
05681 
05682    if (ast_strlen_zero(data)) {
05683       ast_log(LOG_WARNING, "%s\n", usage);
05684       return -1;
05685    }
05686 
05687    appname = ast_strdupa(data);
05688 
05689    s = strsep(&appname,"?");  /* Separate the timerange and application name/data */
05690    if (!appname) {   /* missing application */
05691       ast_log(LOG_WARNING, "%s\n", usage);
05692       return -1;
05693    }
05694 
05695    if (!ast_build_timing(&timing, s)) {
05696       ast_log(LOG_WARNING, "Invalid Time Spec: %s\nCorrect usage: %s\n", s, usage);
05697       return -1;
05698    }
05699 
05700    if (!ast_check_timing(&timing))  /* outside the valid time window, just return */
05701       return 0;
05702 
05703    /* now split appname|appargs */
05704    if ((s = strchr(appname, '|')))
05705       *s++ = '\0';
05706 
05707    if ((app = pbx_findapp(appname))) {
05708       return pbx_exec(chan, app, S_OR(s, ""));
05709    } else {
05710       ast_log(LOG_WARNING, "Cannot locate application %s\n", appname);
05711       return -1;
05712    }
05713 }

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

Goto

Definition at line 5903 of file pbx.c.

References ast_parseable_goto(), ast_verbose(), ast_channel::context, ast_channel::exten, option_verbose, ast_channel::priority, and VERBOSE_PREFIX_3.

Referenced by pbx_builtin_gotoif(), and pbx_builtin_gotoiftime().

05904 {
05905    int res = ast_parseable_goto(chan, data);
05906    if (!res && (option_verbose > 2))
05907       ast_verbose( VERBOSE_PREFIX_3 "Goto (%s,%s,%d)\n", chan->context,chan->exten, chan->priority+1);
05908    return res;
05909 }

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

Definition at line 5649 of file pbx.c.

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

05650 {
05651    int res=0;
05652    char *s, *ts;
05653    struct ast_timing timing;
05654 
05655    if (ast_strlen_zero(data)) {
05656       ast_log(LOG_WARNING, "GotoIfTime requires an argument:\n  <time range>|<days of week>|<days of month>|<months>?[[context|]extension|]priority\n");
05657       return -1;
05658    }
05659 
05660    ts = s = ast_strdupa(data);
05661 
05662    /* Separate the Goto path */
05663    strsep(&ts,"?");
05664 
05665    /* struct ast_include include contained garbage here, fixed by zeroing it on get_timerange */
05666    if (ast_build_timing(&timing, s) && ast_check_timing(&timing))
05667       res = pbx_builtin_goto(chan, ts);
05668    
05669    return res;
05670 }

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

Definition at line 5619 of file pbx.c.

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

05620 {
05621    if (!ast_strlen_zero(data)) {
05622       int cause;
05623       char *endptr;
05624 
05625       if ((cause = ast_str2cause(data)) > -1) {
05626          chan->hangupcause = cause;
05627          return -1;
05628       }
05629       
05630       cause = strtol((const char *) data, &endptr, 10);
05631       if (cause != 0 || (data != endptr)) {
05632          chan->hangupcause = cause;
05633          return -1;
05634       }
05635          
05636       ast_log(LOG_NOTICE, "Invalid cause given to Hangup(): \"%s\"\n", (char *) data);
05637    }
05638 
05639    if (!chan->hangupcause) {
05640       chan->hangupcause = AST_CAUSE_NORMAL_CLEARING;
05641    }
05642 
05643    return -1;
05644 }

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

Definition at line 5505 of file pbx.c.

References AST_CONTROL_PROCEEDING, and ast_indicate().

05506 {
05507    ast_indicate(chan, AST_CONTROL_PROCEEDING);
05508    return 0;
05509 }

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

Definition at line 5514 of file pbx.c.

References AST_CONTROL_PROGRESS, and ast_indicate().

05515 {
05516    ast_indicate(chan, AST_CONTROL_PROGRESS);
05517    return 0;
05518 }

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

Definition at line 5591 of file pbx.c.

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

05592 {
05593    char *args;
05594    struct ast_flags flags = { 0 };
05595 
05596    if (!ast_strlen_zero(data)) {
05597       args = ast_strdupa(data);
05598       ast_app_parse_options(resetcdr_opts, &flags, NULL, args);
05599    }
05600 
05601    ast_cdr_reset(chan->cdr, &flags);
05602 
05603    return 0;
05604 }

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

Definition at line 5523 of file pbx.c.

References AST_CONTROL_RINGING, and ast_indicate().

05524 {
05525    ast_indicate(chan, AST_CONTROL_RINGING);
05526    return 0;
05527 }

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

Definition at line 5609 of file pbx.c.

References ast_cdr_setamaflags().

05610 {
05611    /* Copy the AMA Flags as specified */
05612    ast_cdr_setamaflags(chan, data ? data : "");
05613    return 0;
05614 }

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

Definition at line 5718 of file pbx.c.

References ast_safe_sleep(), and s.

05719 {
05720    double s;
05721    int ms;
05722 
05723    /* Wait for "n" seconds */
05724    if (data && (s = atof(data)) > 0) {
05725       ms = s * 1000.0;
05726       return ast_safe_sleep(chan, ms);
05727    }
05728    return 0;
05729 }

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

Definition at line 5734 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_indicate(), ast_indicate_data(), ast_log(), AST_SOFTHANGUP_TIMEOUT, AST_STANDARD_APP_ARGS, ast_strdupa, ast_strlen_zero(), ast_test_flag, ast_verbose(), ast_waitfordigit(), ast_channel::cid, ast_callerid::cid_num, ast_channel::context, ast_channel::exten, LOG_WARNING, option_verbose, parse(), ast_channel::pbx, ast_channel::priority, ast_pbx::rtimeout, S_OR, set_ext_pri(), VERBOSE_PREFIX_3, and WAITEXTEN_MOH.

05735 {
05736    int ms, res;
05737    double sec;
05738    struct ast_flags flags = {0};
05739    char *opts[1] = { NULL };
05740    char *parse;
05741    AST_DECLARE_APP_ARGS(args,
05742       AST_APP_ARG(timeout);
05743       AST_APP_ARG(options);
05744    );
05745 
05746    if (!ast_strlen_zero(data)) {
05747       parse = ast_strdupa(data);
05748       AST_STANDARD_APP_ARGS(args, parse);
05749    } else
05750       memset(&args, 0, sizeof(args));
05751 
05752    if (args.options)
05753       ast_app_parse_options(waitexten_opts, &flags, opts, args.options);
05754    
05755    if (ast_test_flag(&flags, WAITEXTEN_MOH) && !opts[0] ) {
05756       ast_log(LOG_WARNING, "The 'm' option has been specified for WaitExten without a class.\n"); 
05757    } else if (ast_test_flag(&flags, WAITEXTEN_MOH))
05758       ast_indicate_data(chan, AST_CONTROL_HOLD, S_OR(opts[0], NULL), strlen(opts[0]));
05759 
05760    /* Wait for "n" seconds */
05761    if (args.timeout && (sec = atof(args.timeout)) > 0.0)
05762       ms = 1000 * sec;
05763    else if (chan->pbx)
05764       ms = chan->pbx->rtimeout * 1000;
05765    else
05766       ms = 10000;
05767    res = ast_waitfordigit(chan, ms);
05768    if (!res) {
05769       if (ast_exists_extension(chan, chan->context, chan->exten, chan->priority + 1, chan->cid.cid_num)) {
05770          if (option_verbose > 2)
05771             ast_verbose(VERBOSE_PREFIX_3 "Timeout on %s, continuing...\n", chan->name);
05772       } else if (chan->_softhangup & AST_SOFTHANGUP_TIMEOUT) {
05773          if (option_verbose > 2)
05774             ast_verbose(VERBOSE_PREFIX_3 "Call timeout on %s, checking for 'T'\n", chan->name);
05775          res = -1;
05776       } else if (ast_exists_extension(chan, chan->context, "t", 1, chan->cid.cid_num)) {
05777          if (option_verbose > 2)
05778             ast_verbose(VERBOSE_PREFIX_3 "Timeout on %s, going to 't'\n", chan->name);
05779          set_ext_pri(chan, "t", 0); /* 0 will become 1, next time through the loop */
05780       } else {
05781          ast_log(LOG_WARNING, "Timeout but no rule 't' in context '%s'\n", chan->context);
05782          res = -1;
05783       }
05784    }
05785 
05786    if (ast_test_flag(&flags, WAITEXTEN_MOH))
05787       ast_indicate(chan, AST_CONTROL_UNHOLD);
05788 
05789    return res;
05790 }


Generated on 8 Mar 2019 for Asterisk - the Open Source PBX by  doxygen 1.6.1