138 lines
6.3 KiB
Groff
138 lines
6.3 KiB
Groff
.TH ATMSIGD.CONF 4 "March 19, 2000" "Linux" "File Formats"
|
|
.SH NAME
|
|
atmsigd.conf \- configuration file for the ATM signaling demon
|
|
.SH SYNOPSIS
|
|
.B /etc/atmsigd.conf
|
|
.SH DESCRIPTION
|
|
\fBatmsigd.conf\fP contains configuration data for \fBatmsigd\fP.
|
|
\fBatmsigd\fP reads \fBatmsigd.conf\fP after parsing the command
|
|
line options, before connecting to the ATM network.
|
|
.P
|
|
Configuration parameters are arranged in functional groups. In order to
|
|
set a parameter, the name of the group, the name of the parameter, and
|
|
the parameter value(s) have to be specified, e.g.
|
|
.nf
|
|
.sp
|
|
sig level debug
|
|
.sp
|
|
.fi
|
|
decreases the logging threshold for messages related to signaling to the
|
|
\fBdebug\fP level. The following options are recognized:
|
|
.IP \fBdebug\ dump\ \fIpath\fP
|
|
Specifies the directory to which \fBatmsigd\fP will write status and trace
|
|
dumps. If tracing is not yet enabled, the trace size is automatically
|
|
set to a (small) default value.
|
|
.IP \fBdebug\ level\ \fIlevel\fP
|
|
Sets the default debug level to \fIlevel\fP. \fIlevel\fP can be any of
|
|
\fBdebug\fP, \fBinfo\fP, \fBwarn\fP, \fBerror\fP, and \fBfatal\fP. Only
|
|
messages with the same or a higher priority than the debug level are printed.
|
|
Note that
|
|
the command-line option \fB\-d\fP generates even more output (e.g. hexdumps
|
|
of all packets passing between \fBatmsigd\fP and the network) than
|
|
\fBdebug level debug\fP.
|
|
.IP \fBdebug\ log\ \fIpath\fP
|
|
Specifies the file to which \fBatmsigd\fP writes logging messages. When
|
|
using the special file name \fBsyslog\fP, messages are send to the
|
|
system logger instead. Log messages are written to standard output if no log
|
|
file is specified. Writing to standard output can also be explicitly requested
|
|
by using the special file name \fBstderr\fP.
|
|
.IP \fBdebug\ trace\ \fP[\fInumber\fP]
|
|
Enables tracing and optionally sets the number of entries that should be
|
|
kept in the trace buffer. A (small) default is used if the number is
|
|
omitted.
|
|
.IP \fBio\ level\ \fIlevel\fP
|
|
Sets the debug level for IO-related messages to \fIlevel\fP.
|
|
.IP \fBio\ max_rate\ \fIrate\fP
|
|
Sets the rate to signal if an application requests the "maximum". See qos(7)
|
|
for the syntax to use for expressing the rate. The default maximum rate is
|
|
353207 cells/second (OC3). (Note that the value of \fBmax_rate\fP does not
|
|
constrain the rates an application can explicitly request.)
|
|
.IP \fBio\ qos\ \fIqos\fP
|
|
Configures the signaling VC to use the specified QOS (see qos(7) for the
|
|
syntax). By default, UBR at link speed is used on the signaling VC.
|
|
.IP \fBio\ vc\ \fP[\fIitf\fB.\fP]\fIvpi\fB.\fIvci\fP
|
|
Uses the specified VC for signaling messages instead of the usual 0.0.5.
|
|
.IP \fBsaal\ level\ \fIlevel\fP
|
|
Sets the debug level for messages related to SAAL (i.e. SSCF and SSCOP) to
|
|
\fIlevel\fP.
|
|
.IP \fBsig\ level\ \fIlevel\fP
|
|
Sets the debug level for messages related to signaling (Q.2931 or ISP) to
|
|
\fIlevel\fP.
|
|
.IP \fBsig\ mode\ \fImode\fP
|
|
Set the mode of operation. The following modes are available: \fBuser\fP for
|
|
the user side, \fBnetwork\fP for the network side, and \fBswitch\fP for
|
|
operation in a switch. The default behaviour is \fBuser\fP.
|
|
.IP \fBsig\ uni30\fP
|
|
Use UNI 3.0 signaling. If specified together with \fBsig uni31\fP, this
|
|
option sets UNI 3.1 signaling with a few backwards-compatibility extensions.
|
|
.IP \fBsig\ uni31\fP
|
|
Use UNI 3.1 signaling. This option can be combined with \fBsig uni30\fP (see
|
|
above).
|
|
.IP \fBsig\ uni40\fP
|
|
Use UNI 4.0 signaling. This option can be combined with \fBsig q.2963.1\fP
|
|
(see below).
|
|
.IP \fBsig\ q.2963.1\fP
|
|
Enable peak cell rate renegotiation. This option is only available with
|
|
UNI 4.0 signaling.
|
|
.IP \fBsig\ vpci\ \fIvpci\fB\ itf\ \fIitf\fP
|
|
Sets up a very simplistic type of routing. All calls with VPCI values
|
|
equal to or greater than \fIvpci\fP will be routed to \fIitf\fP, and their
|
|
VPI values will be set to the signaled VPCI minus \fIvpci\fP. Multiple
|
|
\fBsig vpci\fP entries can be used to support an arbitrary number of
|
|
interfaces.
|
|
Example: with \fBsig vpci 4 itf 1\fP, a call signaled for
|
|
VPCI/VCI 0.x is routed to 0.0.x, a call signaled for 6.y is routed to
|
|
1.2.y, etc.
|
|
.IP \fBpolicy\ level\ \fIlevel\fP
|
|
Sets the debug level for messages related to policy decisions to \fIlevel\fP.
|
|
.IP \fBpolicy\ \fIdecision\ direction\ address\fP
|
|
Takes the specified \fIdecision\fP for calls from or to \fIaddress\fP.
|
|
\fIdecision\fP can be either \fBallow\fP or \fBreject\fP. \fIdirection\fP is
|
|
either \fBfrom\fP or \fBto\fP. The \fIaddress\fP may be wildcarded by
|
|
prepending a slash and the number of significant bits (NSAP) or digits (E.164).
|
|
The rules are searched in the order in which they appear in \fBatmsigd.conf\fP
|
|
until the first match. If no rule matches, the call is allowed.
|
|
.IP \fBentity\ \fP[\fIitf\fB.\fP]\fIvpi\fB.\fIvci\fP\ {\ \fIoptions\ ...\fP\ }
|
|
Activates a signaling entity on that specific VC. Multiple \fBentity\fP
|
|
clauses can appear in the same configuration. When using \fBentity\fP,
|
|
the option \fBio vc\fP is not available.
|
|
\fBentity\fP is optionally followed by the following options, enclosed in
|
|
curly braces: \fBvpci\fP (corresponds to \fBsig vpci\fP),
|
|
\fBmode\fP (corresponds to \fBsig mode\fP), \fBqos\fP (corresponds to \fBvc
|
|
qos\fP), \fBroute\fP, and \fBdefault\fP. The last two options determine how
|
|
outbound calls are routed. The \fBroute\fP option is followed by an address
|
|
in the format used for addresses in \fBpolicy\fP. If no route entry matches
|
|
the called party number of an outbound call, the entry marked with
|
|
\fBdefault\fP is selected.
|
|
.P
|
|
When setting multiple parameters in the same group, the group name doesn't
|
|
have to be repeated if it is followed by the parameters in curly braces.
|
|
Example:
|
|
.nf
|
|
.sp
|
|
debug {
|
|
level warn
|
|
dump /var/tmp
|
|
log syslog
|
|
trace 100
|
|
}
|
|
.sp
|
|
.fi
|
|
.P
|
|
Line breaks can be inserted in \fBatmsigd.conf\fP wherever spaces or tabs
|
|
are allowed. Everything between a `#' and the end of the line is considered
|
|
a comment. The `#' character cannot be escaped.
|
|
.P
|
|
If an option is specified in \fBatmsigd.conf\fP and on the command
|
|
line, the command line has priority.
|
|
.COMPATIBILITY
|
|
Certain options used by past versions of \fBatmsigd\fP but no longer documented
|
|
on the man page are still recognized and supported, but they also yield a
|
|
warning message. Future versions of \fBatmsigd\fP will not recognize those
|
|
options.
|
|
.SH AUTHOR
|
|
Werner Almesberger, EPFL ICA <Werner.Almesberger@epfl.ch>
|
|
.SH "SEE ALSO"
|
|
atmsigd(8), qos(7), syslogd(8)
|
|
.\"{{{}}}
|