Fix some spelling errors, and convert tabs to spaces.
[asterisk/asterisk.git] / configs / chan_dahdi.conf.sample
index 7b4e72f..839300a 100644 (file)
@@ -1,26 +1,21 @@
 ;
-; DAHDI telephony
-;
-; Configuration file
+; DAHDI Telephony Configuration file
 ;
 ; You need to restart Asterisk to re-configure the DAHDI channel
-; CLI> reload chan_dahdi.so 
-;              will reload the configuration file,
-;              but not all configuration options are 
-;              re-configured during a reload (signalling, as well as
-;               PRI and SS7-related settings cannot be changed on a
-;               reload.
+; CLI> reload chan_dahdi.so
+;      will reload the configuration file, but not all configuration options
+;      are re-configured during a reload (signalling, as well as PRI and
+;      SS7-related settings cannot be changed on a reload).
 ; 
-; This file documents many configuration variables.  Normally unless you
-; know what a variable means or that it should be changed, there's no
-; reason to unrem lines.
-;
-; remmed-out examples below (those lines that begin with a ';' but no
-; space afterwards) typically show a value that is not the defauult value,
-; but would make sense under cetain circumstances. The default values
-; are usually sane. Thus you should typically not touch them unless you 
-; know what they mean or you know you should change them.
-
+; This file documents many configuration variables.  Normally unless you know
+; what a variable means or that it should be changed, there's no reason to
+; un-comment those lines.
+;
+; Examples below that are commented out (those lines that begin with a ';' but
+; no space afterwards) typically show a value that is not the default value,
+; but would make sense under certain circumstances. The default values are
+; usually sane. Thus you should typically not touch them unless you know what
+; they mean or you know you should change them.
 
 [trunkgroups]
 ;
@@ -40,7 +35,7 @@
 ; Spanmap: Associates a span with a trunk group
 ;        spanmap => <dahdispan>,<trunkgroup>[,<logicalspan>]
 ;
-;        dahdispan     is the DAHDI span number to associate
+;        dahdispan   is the DAHDI span number to associate
 ;        trunkgroup  is the trunkgroup (specified above) for the mapping
 ;        logicalspan is the logical span number within the trunk group to use.
 ;                    if unspecified, no logical span number is used.
 ;
 ; Switchtype:  Only used for PRI.
 ;
-; national:      National ISDN 2 (default)
-; dms100:        Nortel DMS100
-; 4ess:           AT&T 4ESS
-; 5ess:                  Lucent 5ESS
-; euroisdn:       EuroISDN (common in Europe)
-; ni1:            Old National ISDN 1
-; qsig:           Q.SIG
+; national:    National ISDN 2 (default)
+; dms100:      Nortel DMS100
+; 4ess:        AT&T 4ESS
+; 5ess:        Lucent 5ESS
+; euroisdn:    EuroISDN (common in Europe)
+; ni1:         Old National ISDN 1
+; qsig:        Q.SIG
 ;
 ;switchtype=euroisdn
 ;
 ;
 ;priexclusive = yes
 ;
+;
+; If you need to use the logical channel mapping with your Q.SIG PRI instead
+; of the physical mapping you must use the qsigchannelmapping option.
+;
+; logical:  Use the logical channel mapping
+; physical: Use physical channel mapping (default)
+;
+;qsigchannelmapping=logical
+;
+; If you wish to ignore remote hold indications (and use MOH that is supplied over
+; the B channel) enable this option.
+;
+;discardremoteholdretrieval=yes
+;
 ; ISDN Timers
 ; All of the ISDN timers and counters that are used are configurable.  Specify
 ; the timer name, and its value (in ms for timers).
 ; featdmf_ta:     Feature Group D (The real thing, MF (domestic, US)) through
 ;                 a Tandem Access point
 ; featb:          Feature Group B (MF (domestic, US))
-; fgccama        Feature Group C-CAMA (DP DNIS, MF ANI)
-; fgccamamf      Feature Group C-CAMA MF (MF DNIS, MF ANI)
+; fgccama:        Feature Group C-CAMA (DP DNIS, MF ANI)
+; fgccamamf:      Feature Group C-CAMA MF (MF DNIS, MF ANI)
 ; fxs_ls:         FXS (Loop Start)
 ; fxs_gs:         FXS (Ground Start)
 ; fxs_ks:         FXS (Kewl Start)
 ; pri_net:        PRI signalling, Network side
 ; gr303fxoks_net: GR-303 Signalling, FXO Loopstart, Network side
 ; gr303fxsks_cpe: GR-303 Signalling, FXS Loopstart, CPE side
-; sf:            SF (Inband Tone) Signalling
-; sf_w:                  SF Wink
+; sf:             SF (Inband Tone) Signalling
+; sf_w:           SF Wink
 ; sf_featd:       SF Feature Group D (The fake, Adtran style, DTMF)
 ; sf_featdmf:     SF Feature Group D (The real thing, MF (domestic, US))
 ; sf_featb:       SF Feature Group B (MF (domestic, US))
 ; enable dring detection after caller ID for those countries like Australia
 ; where the ring cadence is changed *after* the caller ID spill:
 ;
-;distinctiveringaftercid=yes   
+;distinctiveringaftercid=yes
 ;
 ; Whether or not to use caller ID:
 ;
@@ -464,13 +473,12 @@ callreturn=yes
 ;
 echocancel=yes
 ;
-; As of Zaptel 1.4.8, some DAHDI echo cancellers (software and hardware)
-; support adjustable parameters; these parameters can be supplied as
-; additional options to the 'echocancel' setting. Note that Asterisk
-; does not attempt to validate the parameters or their values, so if you
-; supply an invalid parameter you will not know the specific reason it
-; failed without checking the kernel message log for the error(s)
-; put there by DAHDI.
+; Some DAHDI echo cancellers (software and hardware) support adjustable
+; parameters; these parameters can be supplied as additional options to
+; the 'echocancel' setting. Note that Asterisk does not attempt to
+; validate the parameters or their values, so if you supply an invalid
+; parameter you will not know the specific reason it failed without
+; checking the kernel message log for the error(s) put there by DAHDI.
 ;
 ;echocancel=128,param1=32,param2=0,param3=14
 ;
@@ -539,7 +547,11 @@ callgroup=1
 pickupgroup=1
 
 ; Channel variable to be set for all calls from this channel
-;setvar=CHANNEL=42             
+;setvar=CHANNEL=42
+;setvar=ATTENDED_TRANSFER_COMPLETE_SOUND=beep   ; This channel variable will
+                                                ; cause the given audio file to
+                                                ; be played upon completion of
+                                                ; an attended transfer.
 
 ;
 ; Specify whether the channel should be answered immediately or if the simple
@@ -704,10 +716,13 @@ pickupgroup=1
 ; passed through as signalling instead of generating hold music locally. This
 ; setting is only valid when used on a channel that uses digital signalling.
 ;
+; This option may be set globally or on a per-channel basis.
+;
 ;mohinterpret=default
 ;
 ; This option specifies which music on hold class to suggest to the peer channel
-; when this channel places the peer on hold. 
+; when this channel places the peer on hold.  This option may be set globally,
+; or on a per-channel basis.
 ;
 ;mohsuggest=default
 ;
@@ -802,7 +817,7 @@ pickupgroup=1
 ; different context and use E & M signalling instead.
 ;
 ;context=remote
-;sigalling=em
+;signaling=em
 ;channel => 15
 ;channel => 16
 
@@ -872,9 +887,9 @@ pickupgroup=1
 ;
 ; unknown:        Unknown
 ; subscriber:     Subscriber
-; national:      National
+; national:       National
 ; international:  International
-; dynamic:       Dynamically selects the appropriate dialplan
+; dynamic:        Dynamically selects the appropriate dialplan
 ;
 ;ss7_called_nai=dynamic
 ;
@@ -882,9 +897,9 @@ pickupgroup=1
 ;
 ; unknown:        Unknown
 ; subscriber:     Subscriber
-; national:      National
+; national:       National
 ; international:  International
-; dynamic:       Dynamically selects the appropriate dialplan
+; dynamic:        Dynamically selects the appropriate dialplan
 ;
 ;ss7_calling_nai=dynamic
 ;