[asterisk-dev] Version Dial() comma separation was introduced in?

Philipp Kempgen philipp.kempgen at amooma.de
Mon May 18 13:55:57 CDT 2009


Alistair Cunningham schrieb:
> Does anyone know which stable version(s) of Asterisk introduced using 
> commas rather than "|" to separate the arguments for Dial()? I'd like to 
> run a diff between it and the previous version.

http://www.das-asterisk-buch.de/2.1/applications-dial.html
see unified diff at the bottom of the page
"Differenz des internen Hilfetexts von Asterisk 1.4 zu 1.6:"

---cut---
--- in Asterisk 1.4
+++ in Asterisk 1.6
@@ -4,7 +4,7 @@
   Place a call and connect to the current channel

   [Description]
-    Dial(Technology/resource[&Tech2/resource2...][|timeout][|options][|URL]):
+    Dial(Technology/resource[&Tech2/resource2...][,timeout][,options][,URL]):
   This application will place calls to one or more specified channels. As soon
   as one of the requested channels answers, the originating channel will be
   answered, if it has not already been answered. These two channels will then
@@ -39,6 +39,8 @@
     Options:
       A(x) - Play an announcement to the called party, using 'x' as the file.
       C    - Reset the CDR for this call.
+      c    - If DIAL cancels this call, always set the flag to tell the channel
+             driver that the call is answered elsewhere.
       d    - Allow the calling user to dial a 1 digit extension while waiting for
              a call to be answered. Exit to that extension if it exists in the
              current context, or the context defined in the EXITCONTEXT variable,
@@ -48,10 +50,14 @@
              DTMF string is sent to the called party, and the 'calling' DTMF
              string is sent to the calling party. Both parameters can be used
              alone.
+      e    - execute the 'h' extension for peer after the call ends. This
+             operation will not be performed if the peer was parked
       f    - Force the callerid of the *calling* channel to be set as the
              extension associated with the channel using a dialplan 'hint'.
              For example, some PSTNs do not allow CallerID to be set to anything
              other than the number assigned to the caller.
+      F(context^exten^pri) - When the caller hangs up, transfer the called party
+             to the specified context and extension and continue execution.
       g    - Proceed with dialplan execution at the current extension if the
              destination channel hangs up.
       G(context^exten^pri) - If the call is answered, transfer the calling party to
@@ -59,15 +65,18 @@
              Optionally, an extension, or extension and context may be specified.
              Otherwise, the current extension is used. You cannot use any additional
              action post answer options in conjunction with this option.
-      h    - Allow the called party to hang up by sending the '*' DTMF digit.
-      H    - Allow the calling party to hang up by hitting the '*' DTMF digit.
+      h    - Allow the called party to hang up by sending the '*' DTMF digit, or
+             whatever sequence was defined in the featuremap section for
+             'disconnect' in features.conf
+      H    - Allow the calling party to hang up by hitting the '*' DTMF digit, or
+             whatever sequence was defined in the featuremap section for
+             'disconnect' in features.conf
       i    - Asterisk will ignore any forwarding requests it may receive on this
              dial attempt.
-      j    - Jump to priority n+101 if all of the requested channels were busy.
       k    - Allow the called party to enable parking of the call by sending
-             the DTMF sequence defined for call parking in features.conf.
+             the DTMF sequence defined for call parking in the featuremap section of features.conf.
       K    - Allow the calling party to enable parking of the call by sending
-             the DTMF sequence defined for call parking in features.conf.
+             the DTMF sequence defined for call parking in the featuremap section of features.conf.
       L(x[:y][:z]) - Limit the call to 'x' ms. Play a warning when 'y' ms are
              left. Repeat the warning every 'z' ms. The following special
              variables can be used with this option:
@@ -84,14 +93,12 @@
              specified.
       M(x[^arg]) - Execute the Macro for the *called* channel before connecting
              to the calling channel. Arguments can be specified to the Macro
-             using '^' as a delimeter. The Macro can set the variable
+             using '^' as a delimiter. The Macro can set the variable
              MACRO_RESULT to specify the following actions after the Macro is
              finished executing.
              * ABORT        Hangup both legs of the call.
              * CONGESTION   Behave as if line congestion was encountered.
-             * BUSY         Behave as if a busy signal was encountered. This will also
-                            have the application jump to priority n+101 if the
-                            'j' option is set.
+             * BUSY         Behave as if a busy signal was encountered.
              * CONTINUE     Hangup the called party and allow the calling party
                             to continue dialplan execution at the next priority.
              * GOTO:<context>^<exten>^<priority> - Transfer the call to the
@@ -108,8 +115,8 @@
       o    - Specify that the CallerID that was present on the *calling* channel
              be set as the CallerID on the *called* channel. This was the
              behavior of Asterisk 1.0 and earlier.
-      O([x]) - "Operator Services" mode (Zaptel channel to Zaptel channel
-               only, if specified on non-Zaptel interface, it will be ignored).
+      O([x]) - "Operator Services" mode (DAHDI channel to DAHDI channel
+               only, if specified on non-DAHDI interface, it will be ignored).
                When the destination answers (presumably an operator services
                station), the originator no longer has control of their line.
                They may hang up, but the switch will not release their line
@@ -128,10 +135,35 @@
       S(x) - Hang up the call after 'x' seconds *after* the called party has
              answered the call.
       t    - Allow the called party to transfer the calling party by sending the
-             DTMF sequence defined in features.conf.
+             DTMF sequence defined in the blindxfer setting in the featuremap section
+             of features.conf.
       T    - Allow the calling party to transfer the called party by sending the
-             DTMF sequence defined in features.conf.
+             DTMF sequence defined in the blindxfer setting in the featuremap section
+             of features.conf.
+      U(x[^arg]) - Execute via Gosub the routine 'x' for the *called* channel before connecting
+             to the calling channel. Arguments can be specified to the Gosub
+             using '^' as a delimiter. The Gosub routine can set the variable
+             GOSUB_RESULT to specify the following actions after the Gosub returns.
+             * ABORT        Hangup both legs of the call.
+             * CONGESTION   Behave as if line congestion was encountered.
+             * BUSY         Behave as if a busy signal was encountered.
+             * CONTINUE     Hangup the called party and allow the calling party
+                            to continue dialplan execution at the next priority.
+             * GOTO:<context>^<exten>^<priority> - Transfer the call to the
+                            specified priority. Optionally, an extension, or
+                            extension and priority can be specified.
+             You cannot use any additional action post answer options in conjunction
+             with this option. Also, pbx services are not run on the peer (called) channel,
+             so you will not be able to set timeouts via the TIMEOUT() function in this routine.
       w    - Allow the called party to enable recording of the call by sending
-             the DTMF sequence defined for one-touch recording in features.conf.
+             the DTMF sequence defined in the automon setting in the featuremap section
+             of features.conf.
       W    - Allow the calling party to enable recording of the call by sending
-             the DTMF sequence defined for one-touch recording in features.conf.
+             the DTMF sequence defined in the automon setting in the featuremap section
+             of features.conf.
+      x    - Allow the called party to enable recording of the call by sending
+             the DTMF sequence defined in the automixmon setting in the featuremap section
+             of features.conf.
+      X    - Allow the calling party to enable recording of the call by sending
+             the DTMF sequence defined in the automixmon setting in the featuremap section
+             of features.conf.
---cut---


    Philipp Kempgen
-- 
AMOOMA GmbH - Bachstr. 126 - 56566 Neuwied  ->  http://www.amooma.de
Geschäftsführer: Stefan Wintermeyer, Handelsregister: Neuwied B14998
Asterisk: http://the-asterisk-book.com - http://das-asterisk-buch.de
Videos of the AMOOCON VoIP conference 2009 ->  http://www.amoocon.de
-- 



More information about the asterisk-dev mailing list