- answerprog
-
This keyword is used to specify the name of a program which is run in
case an incoming telephone connection specified
answer
in its configuration entry.
The default name is
answer
Isdnd
expects to find this program beneath the path
/etc/isdn
which is prepended to the string specified as a parameter to this keyword.
(optional)
- alert
-
is used to specify a time in seconds to wait before accepting a call.
This
keyword is only usable for incoming telephone calls (dialin-reaction = answer).
It is used to have a chance to accept an incoming call on the phone before
the answering machine starts to run.
The minimum value for the alert parameter
is 5 seconds and the maximum parameter allowed is 180 seconds.
(optional)
- b1protocol
-
The B channel layer 1 protocol used for this connection.
The keyword is mandatory.
The currently configurable values are:
- hdlc
-
HDLC framing.
- raw
-
No framing at all (used for telephony).
- bcap
-
Use a special bearer capability for this connection.
The keyword is optional.
Any other value than
dov
sets the bearer capability as configured by the
b1protocol
keyword (see above).
The currently configurable values are:
- dov
-
This connection is a
Dov (Data over Voice)
connection.
The b1protocol keyword must be set to
hdlc
This feature is experimental and does work on outgoing calls only.
- budget-calloutperiod
-
is used to specify a time period in seconds.
Within this period, the number of calls
specified by
budget-calloutncalls
are allowed to succeed, any further attempt to call out will be blocked for the rest
of the time left in the time period.
(optional)
- budget-calloutncalls
-
The number of outgoing calls allowed within the time period specified by
budget-calloutperiod
(optional)
- budget-calloutsfile
-
A path/filename to which the number of successful callouts are written.
The contents of the file is preserved when it exists during startup of isdnd.
The format of this file is: start time, last update time, number of calls.
(optional)
- budget-calloutsfile-rotate
-
If set to
on
rotate budget-calloutsfile every night when an attempt is made to update
the file on a new day.
The statistics for the previous day are written to
a file with the filename specified by budget-calloutsfile to which a hyphen
and the new day's (!) day of month number is appended.
(optional)
- budget-callbackperiod
-
- budget-callbackncalls
-
- budget-callbacksfile
-
- budget-calloutsfile-rotate
-
See
budget-calloutperiod
budget-calloutncalls
budget-calloutsfile
and
budget-calloutsfile-rotate
above.
These are used to specify the budgets for calling back a remote site.
- callbackwait
-
The time in seconds to wait between hanging up the call from a remote site
and calling back the remote site.
(optional)
- calledbackwait
-
The time in seconds to wait for a remote site calling back the local site
after a call from the local site to the remote site has been made.
(optional)
- clone
-
This causes the contents of the specified entry to be copied from the
existing named entry to the current one.
When using this feature at least a new entry specific
`name'
and
`usrdeviceunit'
value should be specified for the current entry.
- connectprog
-
specifies a program run every time after a connection is established and
address negotiation is complete (i.e.: the connection is usable).
Isdnd
expects to find the program below the path
/etc/isdn
which is prepended to the string specified as a parameter to this keyword.
The programs specified by connect and disconnect will get the following
command line arguments: -d (device) -f (flag) [ -a (addr) ] where
device
is the name of device, e.g. "isp0",
flag
will be "up" if connection just got up, or "down" if interface changed to down
state and
addr
the address that got assigned to the interface as a dotted-quad ip address
(optional, only if it can be figured out by isdnd).
(optional)
- dialin-reaction
-
Used to specify what to do when an incoming connection request is received.
The keyword is mandatory.
The currently supported parameters are:
- accept
-
Accept an incoming call.
- reject
-
Reject an incoming call.
- ignore
-
Ignore an incoming call.
- answer
-
Start telephone answering for an incoming voice call.
- callback
-
When a remote site calls, hang up and call back the remote site.
- dialout-type
-
This keyword is used to configure what type of dialout mode is used.
The keyword is mandatory.
The currently supported parameters are:
- normal
-
Normal behavior, call the remote site which is supposed to accept the call.
- calledback
-
Callback behavior, call the remote side which rejects the call and calls
us back.
- dialrandincr
-
When dialing or re-dialing and this parameter is set to
on
the dial retry time is added with a random value (currently 0...3 seconds)
to minimize the chance of two sites dialing synchronously so each gets a busy
each time it dials because the other side is also dialing.
- dialretries
-
The number of dialing retries before giving up.
Setting this to
-1
gives an unlimited number of retries!
(optional)
- direction
-
This keyword is used to configure if incoming and outgoing, incoming-only or
outgoing only connections are possible.
The keyword is optional, the default is
inout
The currently supported parameters are:
- inout
-
Normal behavior, connection establishment is possible from remote and local.
- in
-
Only incoming connections are possible.
- out
-
Only outgoing connections are possible.
- disconnectprog
-
specifies a program run every time after a connection was shut down.
Isdnd
expects to find the program below the path
/etc/isdn
which is prepended to the string specified as a parameter to this keyword.
(optional)
- downtries
-
is used to configure the number of unsuccessful tries (= retry cycles!) before
the interface is disabled (for
downtime
seconds).
(see also the keyword
usedown
further up).
This keyword is optional.
- downtime
-
is used to configure the time in seconds an interface is disabled
after the configured number of
downtries
(see also the keyword
usedown
further up).
This keyword is optional and is set to 60 seconds by default.
- earlyhangup
-
A (safety) time in seconds which specifies the time to hang up before an
expected next charging unit will occur.
(optional)
- idle-algorithm-outgoing
-
The algorithm used to determine when to hang up an outgoing call when the
line becomes idle.
The current algorithms are:
- fix-unit-size
-
idle algorithm which assumes fixed sized charging units during the whole call.
- var-unit-size
-
idle algorithm which assumes that the charging is time based after the first
units time has expired.
- idletime-outgoing
-
The time in seconds an outgoing connection must be idle before hanging up.
An idle timeout of zero disables this functionality.
(optional)
- idletime-incoming
-
The time in seconds an incoming connection must be idle before hanging up.
An idle timeout of zero disables this functionality.
(optional)
- isdncontroller
-
The ISDN controller number to be used for connections for this entry.
(mandatory)
- isdnchannel
-
The ISDN controller channel number to be used for connections for this entry.
In case a channel is explicitly selected here, the SETUP message will request
this channel but mark the request as
preferred
(the indicated channel is preferred) instead of exclusive (only the indicated
channel is acceptable).
Thus the exchange is still free to select another
than the requested channel!
(mandatory)
- isdntxdel-incoming
-
A delay value suitable for the
timeout(9)
kernel subroutine to delay the transmission of the first packet after a
successful connection is made by this value for
incoming
ISDN connections.
The specification unit is 1/100 second.
A zero (0) disables
this feature and is the default value.
This feature is implemented (and makes
sense only) for the
i4bipr(4)
IP over raw HDLC ISDN driver.
(optional)
- isdntxdel-outgoing
-
A delay value suitable for the
timeout(9)
kernel subroutine to delay the transmission of the first packet after a
successful connection is made by this value for
outgoing
ISDN connections.
The specification unit is 1/100 second.
A zero (0) disables
this feature and is the default value.
This feature is implemented (and makes
sense only) for the
i4bipr(4)
IP over raw HDLC ISDN driver.
(optional)
- local-phone-dialout
-
The local telephone number used when the local site dials out.
When dialing
out to a remote site, the number specified here is put into the
Calling Party Number Information Element
This keyword is mandatory for the
ipr
user-land interfaces.
- local-subaddr-dialout
-
The local subaddress used when the local site dials out.
When dialing
out to a remote site, the subaddress specified here is put into the
Calling Party Subaddress Information Element
This keyword is mandatory for the
ipr
user-land interfaces.
- local-phone-incoming
-
The local telephone number used for verifying the destination of incoming
calls.
When a remote site dials in, this number is used to verify that it
is the local site which the remote site wants to connect to.
It is compared
with the
Called Party Number Information Element
got from the telephone exchange.
This keyword is mandatory for the
ipr
interfaces.
- local-subaddr-incoming
-
The local subaddress used for verifying the destination of incoming
calls.
When a remote site dials in, this subaddress is used to verify that it
is the local site which the remote site wants to connect to.
It is compared
with the
Called Party Subaddress Information Element
got from the telephone exchange.
This keyword is mandatory for the
ipr
interfaces.
- name
-
Defines a symbolic name for this configuration entry.
Its purpose is to
use this name in the full-screen display for easy identification of a link
to a remote site and for accounting purposes.
(mandatory)
- maxconnecttime
-
Specify a maximum connection time in seconds.
Use this to define an absolute
upper limit for a connection on the B-channel to last.
CAUTION:
This feature is used to limit the connection time, _not_ number of attempts
to establish a connection: when using this please take care to also enable
the use of budgets to limit the connection establish attempts (otherwise
the line will cycle thru an endless loop of connections and reconnections
which will have an undesired effect on your telco bill)!
- ppp-auth-paranoid
-
If set to
no
the remote site is not required to prove its authentity for connections
that are initiated by the local site.
The default is
yes
and requires the remote site to always authenticate.
This keyword is only used if
ppp-send-auth
has been set to pap or chap for an
isp
PPP interface.
(optional)
- ppp-auth-rechallenge
-
Set to
no
if the other side does not support re-challenging for chap.
The default is
yes
which causes verification of the remote site's authentity once in a while.
This keyword is only used if
ppp-expect-auth
has been set to chap for an
isp
PPP interface.
(optional)
- ppp-expect-auth
-
The local site expects the authentity of the remote site to be proved by
the specified method.
The supported methods are:
- none
-
Do not require the other side to authenticate.
Typical uses are dial-out to an ISP
(many ISPs do not authenticate themselves to clients)
or offering anonymous dial-in at the local site.
- chap
-
The preferred authentication method, which does not require a password to be sent
in the clear.
- pap
-
The unprotected authentication method, which allows anybody watching the wire
to grab name and password.
If
ppp-auth-paranoid
is set to
no
(the default is
yes
outgoing connections will not require the remote site to authenticate itself.
This keyword is only used for the
isp
PPP interfaces.
(optional)
- ppp-expect-name
-
The name that has to be provided by the remote site to prove its authentity.
This keyword is only used if
ppp-expect-auth
has been set to pap or chap for an
isp
PPP interface.
(optional)
- ppp-expect-password
-
The secret that has to be provided by the remote site to prove its authentity.
This keyword is only used if
ppp-expect-auth
has been set to pap or chap for an
isp
PPP interface.
(optional)
- ppp-send-auth
-
The authentication method required by the remote site.
The currently supported parameters are:
- none
-
The remote site does not expect or support authentication.
- chap
-
The preferred authentication method, which does not require a password to be sent
in the clear.
- pap
-
The unprotected authentication method, which allows anybody watching the wire
to grab name and password.
This keyword is only used for the
isp
PPP interfaces.
(optional)
- ppp-send-name
-
The authentication name sent to the remote site.
This keyword is only used if
ppp-send-auth
has been set to pap or chap for an
isp
PPP interface.
(optional)
- ppp-send-password
-
The secret used to prove the local site's authentity to the remote site.
This keyword is only used if
ppp-send-auth
has been set to pap or chap for an
isp
PPP interface.
(optional)
- ratetype
-
The rate entry used from the rates file.
(optional)
For example, ratetype=0 selects lines beginning "ra0" in /etc/isdn/isdnd.rates;
(typically ra0 lines are a set of tables for local call rates on different
days of the week & times per day).
- recoverytime
-
The time in seconds to wait between dial retries.
(optional)
- remdial-handling
-
is used to specify the dialout behavior in case more than one outgoing
number is specified.
The currently supported parameters are:
- first
-
For every new (non-retry) call setup, start with the first number.
- last
-
For every new (non-retry) call setup, start with the last number with
which a successful connection was made.
- next
-
For every new (non-retry) call setup, start with the next number which
follows the last one used.
- remote-phone-dialout
-
The remote telephone number used when the local site dials out.
When dialing
out to a remote site, the number specified here is put into the
Called Party Number Information Element
This keyword is mandatory for the
ipr
interfaces.
It may be specified more than once to try to dial to several
numbers until one succeeds.
- remote-subaddr-dialout
-
The remote subaddress used when the local site dials out.
When dialing
out to a remote site, the subaddress specified here is put into the
Called Party Subaddress Information Element
This keyword is mandatory for the
ipr
interfaces.
It may be specified more than once to linked it to the
remote-phone-dialout numbers until one succeeds.
- remote-phone-incoming
-
The remote telephone number used to verify an incoming call.
When a remote site
dials in, this number is used to verify that it is the correct remote site
which is herewith authorized to connect into the local system.
This parameter
is compared against the
Calling Party Number Information Element
got from the telephone exchange.
This keyword is mandatory for the ipr interfaces.
This keyword may have a wildcard parameter '*' to permit anyone dialing in.
- remote-subaddr-incoming
-
The remote subaddress used to verify an incoming call.
When a remote site
dials in, this subaddress is used to verify that it is the correct remote site
which is herewith authorized to connect into the local system.
This parameter
is compared against the
Calling Party Subaddress Information Element
got from the telephone exchange.
This keyword is mandatory for the ipr interfaces.
This keyword may have a wildcard parameter '*' to permit anyone dialing in.
- unitlength
-
The length of a charging unit in seconds.
This is used in conjunction with
the idletime to decide when to hang up a connection.
(optional)
- unitlengthsrc
-
This keyword is used to specify from which source
isdnd(8)
takes the unitlength for short-hold mode.
The currently configurable values are:
- none
-
Then unitlength is not specified anywhere.
- cmdl
-
Use the unitlength specified on the command line.
- conf
-
Use the unitlength specified in the configuration file with the keyword
unitlength
- rate
-
Use the unitlength from the ratesfile specified in the configuration
file with the keyword
ratetype
- aocd
-
Use a dynamically calculated unitlength in case AOCD is subscribed on
the ISDN line.
(AOCD is an acronym for ``Advice Of Charge During the call''
which is a service provided by the telecommunications (ie phone) provider,
to indicate billable units).
- usrdevicename
-
Specifies the user-land interface which is used for interfacing ISDN B channel
data to the user-land.
The keyword is mandatory.
This keyword accepts the following parameters:
- ipr
-
This parameter configures a raw HDLC IP over ISDN interface.
- isp
-
This parameter configures a synchronous PPP over ISDN interface.
- rbch
-
This specifies a Raw B CHannel access interface.
- tel
-
ISDN telephony.
- ing
-
configures an ISDN B-channel to NetGraph interface.
- usrdeviceunit
-
Specifies the unit number for the device which is specified with
usrdevicename.
- usedown
-
is used to enable the use of the keywords
downtries
and
downtime
in the entries section(s).
It is used in the
isdnd
daemon to dynamically enable and disable the IP interfaces to avoid excessive
dialing activities in case of transient failures (such as busy lines).
This parameter is optional and is set to
off
by default.
- usesubaddr
-
is used to enable the use of subaddresses.
This parameter is optional and is set to
off
by default.
- valid
-
Note
this feature is considered experimental!
The parameter to this keyword is a string specifying a time range within
which this entry is valid.
The time specification consists of a list of weekdays and/or a holiday
indicator ( see also the
holidayfile
keyword in the system section ) separated by commas followed by an optional
daytime range specification in the form hh:mm-hh:mm.
The weekdays are specified as numbers from 0 to 6 and the number 7 for
holidays:
- 0
-
Sunday
- 1
-
Monday
- 2
-
Tuesday
- 3
-
Wednesday
- 4
-
Thursday
- 5
-
Friday
- 6
-
Saturday
- 7
-
a Holiday
The following examples describe the "T-ISDN xxl" tariff of the german Telekom:
- 1,2,3,4,5,6,09:00-18:00
-
Monday through Saturday, daytime 9:00 to 18:00
- 1,2,3,4,5,6,18:00-9:00
-
Monday through Saturday, nighttime 18:00 to 9:00
- 0,7
-
Sunday and on holidays, all 24 hours
The use of this keyword is optional.
