diff --git a/usr.sbin/isdn/isdnd/isdnd.rc.5 b/usr.sbin/isdn/isdnd/isdnd.rc.5 index bd64dc29a2c0..f9d3f52e822c 100644 --- a/usr.sbin/isdn/isdnd/isdnd.rc.5 +++ b/usr.sbin/isdn/isdnd/isdnd.rc.5 @@ -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: