@ -4,8 +4,8 @@ There are two levels of parameter evaluation done in the Asterisk
dial plan in extensions.conf.
dial plan in extensions.conf.
\begin { enumerate} \begin { enumerate}
\item The first, and most frequently used, is the substitution of variable\item The first, and most frequently used, is the substitution of variable
references with their values.
references with their values.
\item Then there are the evaluations of expressions done in \$ [ .. ] . \item Then there are the evaluations of expressions done in \$ [ .. ] .
This will be discussed below.
This will be discussed below.
\end { enumerate} \end { enumerate}
Asterisk has user-defined variables and standard variables set
Asterisk has user-defined variables and standard variables set
@ -16,69 +16,69 @@ listed at the end of this document.
\begin { verbatim} \begin { verbatim}
exten => s,5,BackGround,blabla
exten => s,5,BackGround,blabla
\end { verbatim} \end { verbatim}
The parameter (blabla) can be quoted ("blabla"). In this case, a
The parameter (blabla) can be quoted ("blabla"). In this case, a
comma does not terminate the field. However, the double quotes
comma does not terminate the field. However, the double quotes
will be passed down to the Background command, in this example.
will be passed down to the Background command, in this example.
Also, characters special to variable substitution, expression evaluation, etc
Also, characters special to variable substitution, expression evaluation, etc
(see below), can be quoted. For example, to literally use a \$ on the
(see below), can be quoted. For example, to literally use a \$ on the
string "\$ 1231", quote it with a preceding \textbackslash . Special characters that must
string "\$ 1231", quote it with a preceding \textbackslash . Special characters that must
be quoted to be used, are [ ] \$ " \textbackslash . (to write \textbackslash itself, use \textbackslash ).
be quoted to be used, are [ ] \$ " \textbackslash . (to write \textbackslash itself, use \textbackslash ).
These Double quotes and escapes are evaluated at the level of the
These Double quotes and escapes are evaluated at the level of the
asterisk config file parser.
asterisk config file parser.
Double quotes can also be used inside expressions, as discussed below.
Double quotes can also be used inside expressions, as discussed below.
\section { Variables} \section { Variables}
Parameter strings can include variables. Variable names are arbitrary strings.
Parameter strings can include variables. Variable names are arbitrary strings.
They are stored in the respective channel structure.
They are stored in the respective channel structure.
To set a variable to a particular value, do:
To set a variable to a particular value, do:
\begin { verbatim} \begin { verbatim}
exten => 1,2,Set(varname=value)
exten => 1,2,Set(varname=value)
\end { verbatim} \end { verbatim}
You can substitute the value of a variable everywhere using \$ { variablename} .
You can substitute the value of a variable everywhere using \$ { variablename} .
For example, to stringwise append \$ lala to \$ blabla and store result in \$ koko,
For example, to stringwise append \$ lala to \$ blabla and store result in \$ koko,
do:
do:
\begin { verbatim} \begin { verbatim}
exten => 1,2,Set(koko=$ { blabla } $ { lala} )
exten => 1,2,Set(koko=$ { blabla } $ { lala} )
\end { verbatim} \end { verbatim}
There are two reference modes - reference by value and reference by name.
There are two reference modes - reference by value and reference by name.
To refer to a variable with its name (as an argument to a function that
To refer to a variable with its name (as an argument to a function that
requires a variable), just write the name. To refer to the variable's value,
requires a variable), just write the name. To refer to the variable's value,
enclose it inside \$ { } . For example, Set takes as the first argument
enclose it inside \$ { } . For example, Set takes as the first argument
(before the =) a variable name, so:
(before the =) a variable name, so:
\begin { verbatim} \begin { verbatim}
exten => 1,2,Set(koko=lala)
exten => 1,2,Set(koko=lala)
exten => 1,3,Set($ { koko } = blabla )
exten => 1,3,Set($ { koko } = blabla )
\end { verbatim} \end { verbatim}
stores to the variable "koko" the value "lala" and to variable "lala" the
stores to the variable "koko" the value "lala" and to variable "lala" the
value "blabla".
value "blabla".
In fact, everything contained \$ { here} is just replaced with the value of
In fact, everything contained \$ { here} is just replaced with the value of
the variable "here".
the variable "here".
\section { Variable Inheritance} \section { Variable Inheritance}
Variable names which are prefixed by "\_ " will be inherited to channels
Variable names which are prefixed by "\_ " will be inherited to channels
that are created in the process of servicing the original channel in
that are created in the process of servicing the original channel in
which the variable was set. When the inheritance takes place, the
which the variable was set. When the inheritance takes place, the
prefix will be removed in the channel inheriting the variable. If the
prefix will be removed in the channel inheriting the variable. If the
name is prefixed by "\_ \_ " in the channel, then the variable is
name is prefixed by "\_ \_ " in the channel, then the variable is
inherited and the "\_ \_ " will remain intact in the new channel.
inherited and the "\_ \_ " will remain intact in the new channel.
In the dialplan, all references to these variables refer to the same
In the dialplan, all references to these variables refer to the same
variable, regardless of having a prefix or not. Note that setting any
variable, regardless of having a prefix or not. Note that setting any
version of the variable removes any other version of the variable,
version of the variable removes any other version of the variable,
regardless of prefix.
regardless of prefix.
\subsection { Example} \subsection { Example}
\begin { verbatim} \begin { verbatim}
Set(_ _ FOO=bar) ; Sets an inherited version of "FOO" variable
Set(_ _ FOO=bar) ; Sets an inherited version of "FOO" variable
Set(FOO=bar) ; Removes the inherited version and sets a local
Set(FOO=bar) ; Removes the inherited version and sets a local
; variable.
; variable.
However,
However,
@ -101,11 +101,11 @@ skip from the beginning of the string to the variable name.
exten => _ 9X.,1,Set(number=$ { EXTEN: 1 } )
exten => _ 9X.,1,Set(number=$ { EXTEN: 1 } )
\end { verbatim} \end { verbatim}
Assuming we've dialed 918005551234, the value saved to the 'number' variable
Assuming we've dialed 918005551234, the value saved to the 'number' variable
would be 18005551234. This is useful in situations when we require users to
would be 18005551234. This is useful in situations when we require users to
dial a number to access an outside line, but do not wish to pass the first
dial a number to access an outside line, but do not wish to pass the first
digit.
digit.
If you use a negative offset number, Asterisk starts counting from the end
If you use a negative offset number, Asterisk starts counting from the end
of the string and then selects everything after the new position. The following
of the string and then selects everything after the new position. The following
example will save the numbers 1234 to the 'number' variable, still assuming
example will save the numbers 1234 to the 'number' variable, still assuming
we've dialed 918005551234.
we've dialed 918005551234.
@ -137,13 +137,13 @@ from the end of the string.
exten => _ XXXX#,1,Set(pin=$ { EXTEN: 0 : - 1 } )
exten => _ XXXX#,1,Set(pin=$ { EXTEN: 0 : - 1 } )
\end { verbatim} \end { verbatim}
\section { Expressions} \section { Expressions}
Everything contained inside a bracket pair prefixed by a \$ (like \$ [this] ) is
Everything contained inside a bracket pair prefixed by a \$ (like \$ [this] ) is
considered as an expression and it is evaluated. Evaluation works similar to
considered as an expression and it is evaluated. Evaluation works similar to
(but is done on a later stage than) variable substitution: the expression
(but is done on a later stage than) variable substitution: the expression
(including the square brackets) is replaced by the result of the expression
(including the square brackets) is replaced by the result of the expression
evaluation.
evaluation.
For example, after the sequence:
For example, after the sequence:
\begin { verbatim} \begin { verbatim}
@ -170,7 +170,7 @@ The double quotes will be counted as part of that lexical token.
As an example:
As an example:
\begin { verbatim} \begin { verbatim}
exten => s,6,GotoIf($ [ " $ { CALLERID(name)} " : "Privacy Manager" ]?callerid-liar|s|1:s| 7)
exten => s,6,GotoIf($ [ " $ { CALLERID(name)} " : "Privacy Manager" ]?callerid-liar,s,1:s, 7)
\end { verbatim} \end { verbatim}
The variable CALLERID(name) could evaluate to "DELOREAN MOTORS" (with a space)
The variable CALLERID(name) could evaluate to "DELOREAN MOTORS" (with a space)
@ -189,7 +189,7 @@ DELOREAN MOTORS : Privacy Manager
\end { verbatim} \end { verbatim}
and will result in syntax errors, because token DELOREAN is immediately
and will result in syntax errors, because token DELOREAN is immediately
followed by token MOTORS and the expression parser will not know how to
followed by token MOTORS and the expression parser will not know how to
evaluate this expression, because it does not match its grammar.
evaluate this expression, because it does not match its grammar.
\subsection { Operators} \subsection { Operators}
@ -246,8 +246,8 @@ with equal precedence are grouped within { } symbols.
regular expression. The regular expression is anchored to the
regular expression. The regular expression is anchored to the
beginning of the string with an implicit `\^ '.
beginning of the string with an implicit `\^ '.
If the match succeeds and the pattern contains at least one regular
If the match succeeds and the pattern contains at least one regular
expression subexpression `\( ... \) ', the string corresponing
expression subexpression `\( ... \) ', the string corresponing
to `\textbackslash 1' is returned; otherwise the matching operator
to `\textbackslash 1' is returned; otherwise the matching operator
returns the number of characters matched. If the match fails and
returns the number of characters matched. If the match fails and
the pattern contains a regular expression subexpression the null
the pattern contains a regular expression subexpression the null
@ -288,13 +288,13 @@ or C derived languages.
In 1.6 and above, we shifted the \$ [...] expressions to be calculated
In 1.6 and above, we shifted the \$ [...] expressions to be calculated
via floating point numbers instead of integers. We use 'long double' numbers
via floating point numbers instead of integers. We use 'long double' numbers
when possible, which provide around 16 digits of precision with 12 byte numbers.
when possible, which provide around 16 digits of precision with 12 byte numbers.
To specify a floating point constant, the number has to have this format: D.D, where D is
To specify a floating point constant, the number has to have this format: D.D, where D is
a string of base 10 digits. So, you can say 0.10, but you can't say .10 or 20.-- we hope
a string of base 10 digits. So, you can say 0.10, but you can't say .10 or 20.-- we hope
this is not an excessive restriction!
this is not an excessive restriction!
Floating point numbers are turned into strings via the '% g'/'
Floating point numbers are turned into strings via the '\% g'/'\
function set. This allows numbers to still 'look' like integers to those counting
function set. This allows numbers to still 'look' like integers to those counting
on integer behavior. If you were counting on 1/4 evaluating to 0, you need to now say
on integer behavior. If you were counting on 1/4 evaluating to 0, you need to now say
TRUNC(1/4). For a list of all the truncation/rounding capabilities, see the next section.
TRUNC(1/4). For a list of all the truncation/rounding capabilities, see the next section.
@ -309,7 +309,7 @@ added to the core of the Expr2 parser. Indeed, dialplan functions can be called
\$ [..] expressions without the \$ \{ ...\} operators. The only trouble might be in the fact that\$ [..] expressions without the \$ \{ ...\} operators. The only trouble might be in the fact that
the arguments to these functions must be specified with a comma. If you try to call
the arguments to these functions must be specified with a comma. If you try to call
the MATH function, for example, and try to say 3 + MATH(7*8), the expression parser will
the MATH function, for example, and try to say 3 + MATH(7*8), the expression parser will
evaluate 7*8 for you into 56, and the MATH function will most likely complain that its
evaluate 7*8 for you into 56, and the MATH function will most likely complain that its
input doesn't make any sense.
input doesn't make any sense.
We also provide access to most of the floating point functions in the C library. (but not all of them).
We also provide access to most of the floating point functions in the C library. (but not all of them).
@ -323,7 +323,7 @@ surround function calls in \$[...] expressions with \$\{...\}. Don't jump to con
though! -- you still need to wrap variable names in curly braces!
though! -- you still need to wrap variable names in curly braces!
\begin { enumerate} \begin { enumerate}
\item COS(x) x is in radians. Results vary from -1 to 1. \item COS(x) x is in radians. Results vary from -1 to 1.
\item SIN(x) x is in radians. Results vary from -1 to 1.\item SIN(x) x is in radians. Results vary from -1 to 1.
\item TAN(x) x is in radians.\item TAN(x) x is in radians.
\item ACOS(x) x should be a value between -1 and 1.\item ACOS(x) x should be a value between -1 and 1.
@ -431,7 +431,6 @@ TRUNC(3.5)
TRUNC(-3.5)
TRUNC(-3.5)
returns -3.
returns -3.
\end { verbatim} \end { verbatim}
\end { astlisting} \end { astlisting}
@ -450,7 +449,7 @@ case.
\subsection { Conditionals} \subsection { Conditionals}
There is one conditional application - the conditional goto :
There is one conditional application - the conditional goto :
\begin { verbatim} \begin { verbatim}
exten => 1,2,GotoIf(condition?label1:label2)
exten => 1,2,GotoIf(condition?label1:label2)
@ -460,21 +459,21 @@ If condition is true go to label1, else go to label2. Labels are interpreted
exactly as in the normal goto command.
exactly as in the normal goto command.
"condition" is just a string. If the string is empty or "0", the condition
"condition" is just a string. If the string is empty or "0", the condition
is considered to be false, if it's anything else, the condition is true.
is considered to be false, if it's anything else, the condition is true.
This is designed to be used together with the expression syntax described
This is designed to be used together with the expression syntax described
above, eg :
above, eg :
\begin { verbatim} \begin { verbatim}
exten => 1,2,GotoIf($ [ $ { CALLERID(all)} = 123456]?2|1:3| 1)
exten => 1,2,GotoIf($ [ $ { CALLERID(all)} = 123456]?2,1:3, 1)
\end { verbatim} \end { verbatim}
Example of use :
Example of use :
\begin { verbatim} \begin { verbatim}
exten => s,2,Set(vara=1)
exten => s,2,Set(vara=1)
exten => s,3,Set(varb=$ [ $ { vara} + 2])
exten => s,3,Set(varb=$ [ $ { vara} + 2])
exten => s,4,Set(varc=$ [ $ { varb} * 2])
exten => s,4,Set(varc=$ [ $ { varb} * 2])
exten => s,5,GotoIf($ [ $ { varc} = 6]?99|1:s| 6)
exten => s,5,GotoIf($ [ $ { varc} = 6]?99,1:s, 6)
\end { verbatim} \end { verbatim}
\subsection { Parse Errors} \subsection { Parse Errors}
@ -483,16 +482,20 @@ Syntax errors are now output with 3 lines.
If the extensions.conf file contains a line like:
If the extensions.conf file contains a line like:
\begin { astlisting}
\begin { verbatim} \begin { verbatim}
exten => s,6,GotoIf($ [ " $ { CALLERID(num)} " = "3071234567" & & "$ { CALLERID ( name ) } " : "Privacy Manager" ] ?callerid - liar |s|1 :s| 7 )
exten => s,6,GotoIf($ [ " $ { CALLERID(num)} " = "3071234567" & & "$ { CALLERID ( name ) } " : "Privacy Manager" ] ?callerid - liar ,s,1 :s, 7 )
\end { verbatim} \end { verbatim}
\end { astlisting}
You may see an error in /var/log/asterisk/messages like this:
You may see an error in /var/log/asterisk/messages like this:
\begin { astlisting}
\begin { verbatim} \begin { verbatim}
Jul 15 21:27:49 WARNING[1251240752]: ast_ yyerror(): syntax error: parse error, unexpected TOK_ AND, expecting TOK_ MINUS or TOK_ LP or TOKEN; Input:
Jul 15 21:27:49 WARNING[1251240752]: ast_ yyerror(): syntax error: parse error, unexpected TOK_ AND, expecting TOK_ MINUS or TOK_ LP or TOKEN; Input:
"3072312154" = "3071234567" & & "Steves Extension" : "Privacy Manager"
"3072312154" = "3071234567" & & "Steves Extension" : "Privacy Manager"
^ ^
\end { verbatim} \end { verbatim}
\end { astlisting}
The log line tells you that a syntax error was encountered. It now
The log line tells you that a syntax error was encountered. It now
also tells you (in grand standard bison format) that it hit an "AND"
also tells you (in grand standard bison format) that it hit an "AND"
@ -506,12 +509,12 @@ marked with the "\^" character.
\subsection { NULL Strings} \subsection { NULL Strings}
Testing to see if a string is null can be done in one of two different ways:
Testing to see if a string is null can be done in one of two different ways:
\begin { verbatim} \begin { verbatim}
exten => _ XX.,1,GotoIf($ [ " $ { calledid} " != ""]?3)
exten => _ XX.,1,GotoIf($ [ " $ { calledid} " != ""]?3)
exten => _ XX.,1,GotoIf($ [ foo $ { calledid} != foo]?3)
exten => _ XX.,1,GotoIf($ [ foo $ { calledid} != foo]?3)
\end { verbatim} \end { verbatim}
The second example above is the way suggested by the WIKI. It will
The second example above is the way suggested by the WIKI. It will
work as long as there are no spaces in the evaluated value.
work as long as there are no spaces in the evaluated value.
The first way should work in all cases, and indeed, might now
The first way should work in all cases, and indeed, might now
@ -529,7 +532,7 @@ Pascal, APL, assembler, etc.
\subsection { Incompatabilities} \subsection { Incompatabilities}
The asterisk expression parser has undergone some evolution. It is hoped
The asterisk expression parser has undergone some evolution. It is hoped
that the changes will be viewed as positive.
that the changes will be viewed as positive.
The "original" expression parser had a simple, hand-written scanner,
The "original" expression parser had a simple, hand-written scanner,
and a simple bison grammar. This was upgraded to a more involved bison
and a simple bison grammar. This was upgraded to a more involved bison
@ -545,7 +548,7 @@ allow it.
If you have not touched your extensions.conf files in a year or so, the
If you have not touched your extensions.conf files in a year or so, the
above upgrades may cause you some heartburn in certain circumstances, as
above upgrades may cause you some heartburn in certain circumstances, as
several changes have been made, and these will affect asterisk's behavior on
several changes have been made, and these will affect asterisk's behavior on
legacy extension.conf constructs. The changes have been engineered
legacy extension.conf constructs. The changes have been engineered
to minimize these conflicts, but there are bound to be problems.
to minimize these conflicts, but there are bound to be problems.
@ -558,21 +561,21 @@ of possible concern with "legacy" extension.conf files:
to the value '2', but '1+1' would evaluate to the string '1+1'. If this
to the value '2', but '1+1' would evaluate to the string '1+1'. If this
behavior was depended on, then the expression evaluation will break. '1+1'
behavior was depended on, then the expression evaluation will break. '1+1'
will now evaluate to '2', and something is not going to work right.
will now evaluate to '2', and something is not going to work right.
To keep such strings from being evaluated, simply wrap them in double
To keep such strings from being evaluated, simply wrap them in double
quotes: ' "1+1" '
quotes: ' "1+1" '
\item The colon operator. In versions previous to double quoting, the\item The colon operator. In versions previous to double quoting, the
colon operator takes the right hand string, and using it as a
colon operator takes the right hand string, and using it as a
regex pattern, looks for it in the left hand string. It is given
regex pattern, looks for it in the left hand string. It is given
an implicit \^ operator at the beginning, meaning the pattern
an implicit \^ operator at the beginning, meaning the pattern
will match only at the beginning of the left hand string.
will match only at the beginning of the left hand string.
If the pattern or the matching string had double quotes around
If the pattern or the matching string had double quotes around
them, these could get in the way of the pattern match. Now,
them, these could get in the way of the pattern match. Now,
the wrapping double quotes are stripped from both the pattern
the wrapping double quotes are stripped from both the pattern
and the left hand string before applying the pattern. This
and the left hand string before applying the pattern. This
was done because it recognized that the new way of
was done because it recognized that the new way of
scanning the expression doesn't use spaces to separate tokens,
scanning the expression doesn't use spaces to separate tokens,
and the average regex expression is full of operators that
and the average regex expression is full of operators that
the scanner will recognize as expression operators. Thus, unless
the scanner will recognize as expression operators. Thus, unless
the pattern is wrapped in double quotes, there will be trouble.
the pattern is wrapped in double quotes, there will be trouble.
For instance, \$ { VAR1} : (Who|What*)+
For instance, \$ { VAR1} : (Who|What*)+
@ -601,7 +604,7 @@ of possible concern with "legacy" extension.conf files:
\item Added the conditional operator 'expr1 ? true\_ expr :: false\_ expr'\item Added the conditional operator 'expr1 ? true\_ expr :: false\_ expr'
First, all 3 exprs are evaluated, and if expr1 is false, the 'false\_ expr'
First, all 3 exprs are evaluated, and if expr1 is false, the 'false\_ expr'
is returned as the result. See above for details.
is returned as the result. See above for details.
\item Unary operators '-' and '!' were made right associative.\item Unary operators '-' and '!' were made right associative.
\end { enumerate} \end { enumerate}
@ -682,7 +685,7 @@ available in each application's help text. All these variables
are in UPPER CASE only.
are in UPPER CASE only.
Variables marked with a * are builtin functions and can't be set,
Variables marked with a * are builtin functions and can't be set,
only read in the dialplan. Writes to such variables are silently
only read in the dialplan. Writes to such variables are silently
ignored.
ignored.
\begin { verbatim} \begin { verbatim}
@ -701,7 +704,7 @@ ${CALLINGTNS} * Transit Network Selector (PRI channels)
$ { CALLINGTON } * Caller Type of Number ( PRI channels ) $ { CALLINGTON } * Caller Type of Number ( PRI channels )
$ { CHANNEL } * Current channel name $ { CHANNEL } * Current channel name
$ { CONTEXT } * Current context $ { CONTEXT } * Current context
$ { DATETIME } * Current date time in the format: DDMMYYYY - HH:MM:SS $ { DATETIME } * Current date time in the format: DDMMYYYY - HH:MM:SS
(Deprecated; use $ { STRFTIME ( $ { EPOCH} ,,% d% m% Y-% H:% M:% S)} )
(Deprecated; use $ { STRFTIME ( $ { EPOCH} ,,% d% m% Y-% H:% M:% S)} )
$ { DB _ RESULT } Result value of DB _ EXISTS ( ) dial plan function $ { DB _ RESULT } Result value of DB _ EXISTS ( ) dial plan function
$ { EPOCH } * Current unix style epoch $ { EPOCH } * Current unix style epoch
@ -719,7 +722,7 @@ ${LANGUAGE} * Current language (Deprecated; use ${LANGUAGE()})
$ { LEN ( VAR ) } * String length of VAR ( integer ) $ { LEN ( VAR ) } * String length of VAR ( integer )
$ { PRIORITY } * Current priority in the dialplan $ { PRIORITY } * Current priority in the dialplan
$ { PRIREDIRECTREASON } Reason for redirect on PRI, if a call was directed $ { PRIREDIRECTREASON } Reason for redirect on PRI, if a call was directed
$ { TIMESTAMP } * Current date time in the format: YYYYMMDD - HHMMSS $ { TIMESTAMP } * Current date time in the format: YYYYMMDD - HHMMSS
(Deprecated; use $ { STRFTIME ( $ { EPOCH} ,,% Y% m% d-% H% M% S)} )
(Deprecated; use $ { STRFTIME ( $ { EPOCH} ,,% Y% m% d-% H% M% S)} )
$ { TRANSFER _ CONTEXT } Context for transferred calls $ { TRANSFER _ CONTEXT } Context for transferred calls
$ { FORWARD _ CONTEXT } Context for forwarded calls $ { FORWARD _ CONTEXT } Context for forwarded calls
@ -791,7 +794,7 @@ ${VPB_GETDTMF} chan_vpb
\subsection { The MeetMe Conference Bridge} \subsection { The MeetMe Conference Bridge}
\begin { verbatim} \begin { verbatim}
$ { MEETME _ RECORDINGFILE } Name of file for recording a conference with $ { MEETME _ RECORDINGFILE } Name of file for recording a conference with
the "r" option
the "r" option
$ { MEETME _ RECORDINGFORMAT } Format of file to be recorded $ { MEETME _ RECORDINGFORMAT } Format of file to be recorded
$ { MEETME _ EXIT _ CONTEXT } Context for exit out of meetme meeting $ { MEETME _ EXIT _ CONTEXT } Context for exit out of meetme meeting
@ -826,14 +829,14 @@ ${DUNDDEST} * The Destination of the result from a call to DUNDiLookup()
\subsection { chan\_ zap} \subsection { chan\_ zap}
\begin { verbatim} \begin { verbatim}
$ { ANI 2 } * The ANI 2 Code provided by the network on the incoming call. $ { ANI 2 } * The ANI 2 Code provided by the network on the incoming call.
(ie, Code 29 identifies call as a Prison/Inmate Call)
(ie, Code 29 identifies call as a Prison/Inmate Call)
$ { CALLTYPE } * Type of call ( Speech, Digital, etc ) $ { CALLTYPE } * Type of call ( Speech, Digital, etc )
$ { CALLEDTON } * Type of number for incoming PRI extension $ { CALLEDTON } * Type of number for incoming PRI extension
i.e. 0=unknown, 1=international, 2=domestic, 3=net_ specific,
i.e. 0=unknown, 1=international, 2=domestic, 3=net_ specific,
4=subscriber, 6=abbreviated, 7=reserved
4=subscriber, 6=abbreviated, 7=reserved
$ { CALLINGSUBADDR } * Called PRI Subaddress $ { CALLINGSUBADDR } * Called PRI Subaddress
$ { FAXEXTEN } * The extension called before being redirected to "fax" $ { FAXEXTEN } * The extension called before being redirected to "fax"
$ { PRIREDIRECTREASON } * Reason for redirect, if a call was directed $ { PRIREDIRECTREASON } * Reason for redirect, if a call was directed
$ { SMDI _ VM _ TYPE } * When an call is received with an SMDI message, the 'type' $ { SMDI _ VM _ TYPE } * When an call is received with an SMDI message, the 'type'
of message 'b' or 'u'
of message 'b' or 'u'
@ -845,7 +848,7 @@ ${SIPCALLID} * SIP Call-ID: header verbatim (for logging or CDR matching
$ { SIPDOMAIN } * SIP destination domain of an inbound call ( if appropriate ) $ { SIPDOMAIN } * SIP destination domain of an inbound call ( if appropriate )
$ { SIPUSERAGENT } * SIP user agent ( deprecated ) $ { SIPUSERAGENT } * SIP user agent ( deprecated )
$ { SIPURI } * SIP uri $ { SIPURI } * SIP uri
$ { SIP _ CODEC } Set the SIP codec for a call $ { SIP _ CODEC } Set the SIP codec for a call
$ { SIP _ URI _ OPTIONS } * additional options to add to the URI for an outgoing call $ { SIP _ URI _ OPTIONS } * additional options to add to the URI for an outgoing call
$ { RTPAUDIOQOS } RTCP QoS report for the audio of this call $ { RTPAUDIOQOS } RTCP QoS report for the audio of this call
$ { RTPVIDEOQOS } RTCP QoS report for the video of this call $ { RTPVIDEOQOS } RTCP QoS report for the video of this call
@ -872,7 +875,7 @@ ${DIALEDPEERNUMBER} * Dialed peer number
$ { DIALEDTIME } * Time for the call ( seconds ) $ { DIALEDTIME } * Time for the call ( seconds )
$ { ANSWEREDTIME } * Time from dial to answer ( seconds ) $ { ANSWEREDTIME } * Time from dial to answer ( seconds )
$ { DIALSTATUS } * Status of the call, one of: $ { DIALSTATUS } * Status of the call, one of:
(CHANUNAVAIL | CONGESTION | BUSY | NOANSWER
(CHANUNAVAIL | CONGESTION | BUSY | NOANSWER
| ANSWER | CANCEL | DONTCALL | TORTURE)
| ANSWER | CANCEL | DONTCALL | TORTURE)
$ { DYNAMIC _ FEATURES } * The list of features ( from the [ applicationmap ] section of $ { DYNAMIC _ FEATURES } * The list of features ( from the [ applicationmap ] section of
features.conf) to activate during the call, with feature
features.conf) to activate during the call, with feature
@ -888,7 +891,7 @@ ${OUTBOUND_GROUP} Default groups for peer channels (as in SetGroup)
\subsection { The chanisavail() application} \subsection { The chanisavail() application}
\begin { verbatim} \begin { verbatim}
$ { AVAILCHAN } * the name of the available channel if one was found $ { AVAILCHAN } * the name of the available channel if one was found
$ { AVAILORIGCHAN } * the canonical channel name that was used to create the channel $ { AVAILORIGCHAN } * the canonical channel name that was used to create the channel
$ { AVAILSTATUS } * Status of requested channel $ { AVAILSTATUS } * Status of requested channel
\end { verbatim} \end { verbatim}
@ -912,7 +915,7 @@ ${SPYGROUP} * A ':' (colon) separated list of group names.
$ { OSPINHANDLE } OSP handle of in _ bound call $ { OSPINHANDLE } OSP handle of in _ bound call
$ { OSPINTIMELIMIT } Duration limit for in _ bound call $ { OSPINTIMELIMIT } Duration limit for in _ bound call
$ { OSPOUTHANDLE } OSP handle of out _ bound call $ { OSPOUTHANDLE } OSP handle of out _ bound call
$ { OSPTECH } OSP technology $ { OSPTECH } OSP technology
$ { OSPDEST } OSP destination $ { OSPDEST } OSP destination
$ { OSPCALLING } OSP calling number $ { OSPCALLING } OSP calling number
$ { OSPOUTTOKEN } OSP token to use for out _ bound call $ { OSPOUTTOKEN } OSP token to use for out _ bound call
Russell Bryant
18 years ago