Bump date for previous (hi antti!). New sentence, new line.

This commit is contained in:
wiz 2003-09-25 09:37:32 +00:00
parent 8ac798e2ed
commit 1d02c95b43
1 changed files with 139 additions and 76 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: isdnd.rc.5,v 1.16 2003/09/25 09:21:48 pooka Exp $
.\" $NetBSD: isdnd.rc.5,v 1.17 2003/09/25 09:37:32 wiz Exp $
.\"
.\" Copyright (c) 1997, 2000 Hellmuth Michaelis. All rights reserved.
.\"
@ -23,13 +23,13 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $Id: isdnd.rc.5,v 1.16 2003/09/25 09:21:48 pooka Exp $
.\" $Id: isdnd.rc.5,v 1.17 2003/09/25 09:37:32 wiz Exp $
.\"
.\" $FreeBSD$
.\"
.\" last edit-date: [Mon Oct 9 13:12:29 2000]
.\"
.Dd October 9, 2000
.Dd September 25, 2003
.Dt ISDND.RC 5
.Os
.Sh NAME
@ -83,15 +83,17 @@ The following keywords are recognized by
.Pp
.Bl -tag -width system -compact
.It Li system
This keyword starts the system configuration section. It must not
have a parameter and may be used only once. The keyword is mandatory.
This keyword starts the system configuration section.
It must not have a parameter and may be used only once.
The keyword is mandatory.
The following keywords are valid in the system configuration section:
.Bl -tag -width useacctfile -compact
.It Li acctall
If this parameter is set to
.Em on ,
accounting information is written even if the local site was not charged
or no charging information is available or is not subscribed. (optional)
or no charging information is available or is not subscribed.
(optional)
.It Li acctfile
Specifies the name of the accounting file which is used when the keyword
.Em useacctfile
@ -99,20 +101,24 @@ Specifies the name of the accounting file which is used when the keyword
.Em on .
See also system keyword
.Em rotatesuffix .
If this keyword is omitted the system default is used. (optional)
If this keyword is omitted the system default is used.
(optional)
.It Li aliasing
If this parameter is set to
.Em on ,
alias processing of telephone-number to name is enabled (see also the
.Em aliasfile
keyword below). The default is off. (optional)
keyword below).
The default is off.
(optional)
.It Li aliasfile
Specifies the name of the telephone number-to-name alias database file shared
with the
.Xr isdntel 8
utility when alias processing is enabled via the
.Em aliasing
keyword. (optional)
keyword.
(optional)
.It Li beepconnect
In full-screen mode, if this parameter is set to
.Em on ,
@ -122,21 +128,26 @@ If this parameter is set to
.Em on ,
the extended caller attributes "screening indicator" and "presentation
indicator" are written to the log-file.
The default is off. (optional)
The default is off.
(optional)
.It Li holidayfile
Specifies the name of the holiday file containing the dates of holidays.
This file is used in conjunction with the
.Em valid
keyword to lookup the dates of holidays. (optional)
keyword to lookup the dates of holidays.
(optional)
.It Li isdntime
If this parameter is set to
.Em on ,
date/time information from the exchange (if provided) is written to the
log-file. The default is off. (optional)
log-file.
The default is off.
(optional)
.It Li mailer
This keyword is used to specify the path/name of a mail program which
which is able to use the "-s" flag to specify a subject on its
command line. In case of a fatal error exit of
command line.
In case of a fatal error exit of
.Nm
this program is used to send mail to an administrator specified by
the keyword
@ -163,7 +174,8 @@ sets the TCP port number for remote monitoring.
This integer parameter is optional and is set to port 451 by default.
.It Li monitor
This keyword specifies a local socket name or a host or network for remote
monitoring. The
monitoring.
The
.Em monitor
specification may either be:
.Pp
@ -182,7 +194,8 @@ example: up-vision-net/24
.It Li monitor-access
This keyword specifies the access rights for a previously used
.Em monitor
keyword. The supported access rights are:
keyword.
The supported access rights are:
.Pp
.Bl -tag -width Ds -compact
.It Ar fullcmd
@ -193,10 +206,12 @@ keyword. The supported access rights are:
.It Ar callout
.El
.It Li ratesfile
Specifies the name of the ratesfile. If this keyword is omitted the system
default is used. (optional)
Specifies the name of the ratesfile.
If this keyword is omitted the system default is used.
(optional)
.It Li regexpr
This keyword is used to specify regular expressions. It can be specified
This keyword is used to specify regular expressions.
It can be specified
more than once up to a compile time dependent value (currently set to 5 by
the MAX_RE definition in the source).
.Pp
@ -227,17 +242,20 @@ expects to find the program below the path
which is prepended to the string specified as a parameter to this keyword.
(optional)
.It Li rotatesuffix
Specifies a suffix for renaming the log- and the accounting-filename. In case
Specifies a suffix for renaming the log- and the accounting-filename.
In case
rotatesuffix is used and a USR1 signal is sent to isdnd, the log-file and the
accounting file is not only closed and reopened but the old log-file is also
renamed to the former filename with the rotatesuffix string appended.
If this keyword is omitted, the log-files are just closed and reopened; this
is also the default behavior. (optional)
is also the default behavior.
(optional)
.\" .It Li rtprio
.\" Specifies the real-time priority
.\" .Nm isdnd
.\" runs at as an integer value in the range 0...31 with 0 being the highest
.\" priority. This keyword is optional; if not specified the process priority of
.\" priority.
.\" This keyword is optional; if not specified the process priority of
.\" .Nm isdnd
.\" is not touched in any way.
.\" ( See also
@ -251,13 +269,14 @@ is also the default behavior. (optional)
If this parameter is set to
.Em on
charging (if available) and accounting information is written to the
accounting file. (optional)
accounting file.
(optional)
.El
.It Li controller
This keyword starts the controller configuration section. It must not
have a parameter and may be used once for every controller. The keyword
is optional. The following keywords are valid in a controller
configuration section:
This keyword starts the controller configuration section.
It must not have a parameter and may be used once for every controller.
The keyword is optional.
The following keywords are valid in a controller configuration section:
.Bl -tag -width useacctfile -compact
.It Li firmware
This keyword is used to specify the path of the firmware file that
@ -267,8 +286,8 @@ is started.
This keyword is useful with active ISDN cards.
.It Li protocol
This keyword is used to set the D-channel protocol for the S0-bus a
controller is connected to. The following parameters are currently
supported:
controller is connected to.
The following parameters are currently supported:
.Pp
.Bl -tag -width calledback -compact -offset
.It Ar dss1
@ -279,7 +298,8 @@ An ISDN leased line with a single B-channel (called D64S in Germany).
.El
.El
.It Li entry
This keyword starts one configuration entry. It must not have a parameter.
This keyword starts one configuration entry.
It must not have a parameter.
This keyword must be used at least once.
The following keywords are valid in an entry section:
.Bl -tag -width unitlengthsrc -compact
@ -287,7 +307,8 @@ The following keywords are valid in an entry section:
This keyword is used to specify the name of a program which is run in
case an incoming telephone connection specified
.Em answer
in its configuration entry. The default name is
in its configuration entry.
The default name is
.Em answer .
.Nm Isdnd
expects to find this program beneath the path
@ -295,10 +316,12 @@ expects to find this program beneath the path
which is prepended to the string specified as a parameter to this keyword.
(optional)
.It Li alert
is used to specify a time in seconds to wait before accepting a call. This
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
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)
.It Li autoupdown
@ -307,10 +330,12 @@ sense to mark the interfaces UP before running
.Nm isdnd .
Typically these interfaces are configured, but marked down, in the respective
.Pa ifconfig.*
file. When starting,
file.
When starting,
.Nm isdnd
recognizes these interfaces (configured with some address, marked down, and
having a matching config entry) and marks them up. On shutdown,
having a matching config entry) and marks them up.
On shutdown,
.Nm isdnd
marks all interfaces changed at startup DOWN again.
.Pp
@ -319,7 +344,8 @@ In this cases add an
.Em autoupdown=no
line to the config file entry.
.It Li b1protocol
The B channel layer 1 protocol used for this connection. The keyword is mandatory.
The B channel layer 1 protocol used for this connection.
The keyword is mandatory.
The currently configurable values are:
.Pp
.Bl -tag -width Ds -compact
@ -329,11 +355,12 @@ HDLC framing.
No framing at all (used for telephony).
.El
.It Li budget-calloutperiod
is used to specify a time period in seconds. Within this period, the number of calls
specified by
is used to specify a time period in seconds.
Within this period, the number of calls specified by
.Em 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)
of the time left in the time period.
(optional)
.It Li budget-calloutncalls
The number of outgoing calls allowed within the time period specified by
.Em budget-calloutperiod .
@ -347,9 +374,11 @@ The format of this file is: start time, last update time, number of calls.
If set to
.Em 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
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)
and the new day's (!) day of month number is appended.
(optional)
.It Li budget-callbackperiod
.It Li budget-callbackncalls
.It Li budget-callbacksfile
@ -359,13 +388,16 @@ See
.Em budget-calloutncalls and
.Em budget-calloutsfile
.Em budget-calloutsfile-rotate
above. These are used to specify the budgets for calling back a remote site.
above.
These are used to specify the budgets for calling back a remote site.
.It Li callbackwait
The time in seconds to wait between hanging up the call from a remote site
and calling back the remote site. (optional)
and calling back the remote site.
(optional)
.It Li 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)
after a call from the local site to the remote site has been made.
(optional)
.It Li connectprog
specifies a program run every time after a connection is established and
address negotiation is complete (i.e.: the connection is usable).
@ -382,7 +414,8 @@ will be "up" if connection just got up, or "down" if interface changed to down
state and
.Em 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)
(optional, only if it can be figured out by isdnd).
(optional)
.It Li dialin-reaction
Used to specify what to do when an incoming connection request is received.
The keyword is mandatory.
@ -453,7 +486,8 @@ the interface is disabled (for
seconds).
(see also the keyword
.Em usedown
further up). This keyword is optional.
further up).
This keyword is optional.
.It Li downtime
is used to configure the time in seconds an interface is disabled
after the configured number of
@ -464,10 +498,12 @@ further up).
This keyword is optional and is set to 60 seconds by default.
.It Li earlyhangup
A (safety) time in seconds which specifies the time to hang up before an
expected next charging unit will occur. (optional)
expected next charging unit will occur.
(optional)
.It Li idle-algorithm-outgoing
The algorithm used to determine when to hang up an outgoing call when the
line becomes idle. The current algorithms are:
line becomes idle.
The current algorithms are:
.Pp
.Bl -tag -width calledback -compact -offset
.It Ar fix-unit-size
@ -493,29 +529,36 @@ In case a channel is explicitly selected here, the SETUP message will request
this channel but mark the request as
.Em preferred
(the indicated channel is preferred) instead of exclusive (only the indicated
channel is acceptable). Thus the exchange is still free to select another
channel is acceptable).
Thus the exchange is still free to select another
than the requested channel!
(mandatory)
.It Li isdntxdel-incoming
How long to delay the transmission of the first packet after a
successful connection is made for
.Em 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
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
.Xr irip 4
IP over raw HDLC ISDN driver. (optional)
IP over raw HDLC ISDN driver.
(optional)
.It Li isdntxdel-outgoing
How long to delay the transmission of the first packet after a
successful connection is made for
.Em 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
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
.Xr irip 4
IP over raw HDLC ISDN driver. (optional)
IP over raw HDLC ISDN driver.
(optional)
.It Li local-phone-dialout
The local telephone number used when the local site dials out. When dialing
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
.Em "Calling Party Number Information Element" .
.Pp
@ -524,8 +567,10 @@ This keyword is mandatory for the
user-land interfaces.
.It Li 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
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
.Em "Called Party Number Information Element"
got from the telephone exchange.
@ -534,9 +579,11 @@ This keyword is mandatory for the
.Em irip
interfaces.
.It Li name
Defines a symbolic name for this configuration entry. Its purpose is to
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)
to a remote site and for accounting purposes.
(mandatory)
.It Li ppp-auth-paranoid
If set to
.Em no ,
@ -573,7 +620,8 @@ The supported methods are:
.Pp
.Bl -tag -width Ds -compact
.It Ar none
Do not require the other side to authenticate. Typical uses are dial-out to an ISP
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.
.It Ar chap
@ -652,13 +700,15 @@ has been set to pap or chap for an
PPP interface.
(optional)
.It Li ratetype
The rate entry used from the rates file. (optional)
The rate entry used from the rates file.
(optional)
.br
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 \*[Am] times per day).
.It Li recoverytime
The time in seconds to wait between dial retries. (optional)
The time in seconds to wait between dial retries.
(optional)
.It Li remdial-handling
is used to specify the dialout behavior in case more than one outgoing
number is specified.
@ -675,18 +725,22 @@ For every new (non-retry) call setup, start with the next number which
follows the last one used.
.El
.It Li remote-phone-dialout
The remote telephone number used when the local site dials out. When dialing
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
.Em "Called Party Number Information Element" .
.Pp
This keyword is mandatory for the
.Em irip
interfaces. It may be specified more than once to try to dial to several
interfaces.
It may be specified more than once to try to dial to several
numbers until one succeeds.
.It Li remote-phone-incoming
The remote telephone number used to verify an incoming call. When a remote site
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
which is herewith authorized to connect into the local system.
This parameter
is compared against the
.Em "Calling Party Number Information Element"
got from the telephone exchange.
@ -695,12 +749,15 @@ This keyword is mandatory for the irip interfaces.
.Pp
This keyword may have a wildcard parameter '*' to permit anyone dialing in.
.It Li 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)
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)
.It Li unitlengthsrc
This keyword is used to specify from which source
.Xr isdnd 8
takes the unitlength for short-hold mode. The currently configurable values are:
takes the unitlength for short-hold mode.
The currently configurable values are:
.Pp
.Bl -tag -width Ds -compact
.It Ar none
@ -716,13 +773,15 @@ file with the keyword
.Em ratetype .
.It Ar 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''
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).
.El
.It Li usrdevicename
Specifies the user-land interface which is used for interfacing ISDN B channel
data to the user-land. The keyword is mandatory.
data to the user-land.
The keyword is mandatory.
This keyword accepts the following parameters:
.Pp
.Bl -tag -width Ds -compact
@ -745,7 +804,8 @@ is used to enable the use of the keywords
.Em downtries
and
.Em downtime
in the entries section(s). It is used in the
in the entries section(s).
It is used in the
.Nm isdnd
daemon to dynamically enable and disable the IP interfaces to avoid excessive
dialing activities in case of transient failures (such as busy lines).
@ -856,10 +916,13 @@ must be \*[Ge] 0 (zero).
.Ed
.Pp
During the unchecked window which is (unitlength - (idle-time+earlyhangup))
in length, no idle check is done. After the unchecked window has ended,
the line is checked for idle-time length if no traffic takes place. In case
in length, no idle check is done.
After the unchecked window has ended,
the line is checked for idle-time length if no traffic takes place.
In case
there was traffic detected in the check-window, the same procedure is restarted
at the beginning of the next unit. In case no traffic was detected during
at the beginning of the next unit.
In case no traffic was detected during
the check-window, the line is closed at the end of the check window.
.Pp
Notice: