NAME

atmsigd.conf - configuration file for the ATM signaling demon

SYNOPSIS

/etc/atmsigd.conf

DESCRIPTION

atmsigd.conf contains configuration data for atmsigd. atmsigd reads
atmsigd.conf after parsing the command line options, before connecting
to the ATM network.
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.
sig level debug
decreases the logging threshold for messages related to signaling to
the debug level. The following options are recognized:
debugdumppath
Specifies the directory to which atmsigd will write status and
trace dumps. If tracing is not yet enabled, the trace size is
automatically set to a (small) default value.
debuglevellevel
Sets the default debug level to level. level can be any of
debug, info, warn, error, and fatal. Only messages with the same
or a higher priority than the debug level are printed. Note
that the command-line option -d generates even more output (e.g.
hexdumps of all packets passing between atmsigd and the network)
than debugleveldebug.
debuglogpath
Specifies the file to which atmsigd writes logging messages.
When using the special file name syslog, 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
stderr.
debugtrace [number]
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.
iolevellevel
Sets the debug level for IO-related messages to level.
iomax_raterate
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 max_rate does not constrain the rates an
application can explicitly request.)
ioqosqos
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.
iovc [itf.]vpi.vci
Uses the specified VC for signaling messages instead of the
usual 0.0.5.
saallevellevel
Sets the debug level for messages related to SAAL (i.e. SSCF and
SSCOP) to level.
siglevellevel
Sets the debug level for messages related to signaling (Q.2931
or ISP) to level.
sigmodemode
Set the mode of operation. The following modes are available:
user for the user side, network for the network side, and switch
for operation in a switch. The default behaviour is user.
siguni30
Use UNI 3.0 signaling. If specified together with siguni31,
this option sets UNI 3.1 signaling with a few backwards-
compatibility extensions.
siguni31
Use UNI 3.1 signaling. This option can be combined with siguni30 (see above).
siguni40
Use UNI 4.0 signaling. This option can be combined with sigq.2963.1 (see below).
sigq.2963.1
Enable peak cell rate renegotiation. This option is only
available with UNI 4.0 signaling.
sigvpcivpciitfitf
Sets up a very simplistic type of routing. All calls with VPCI
values equal to or greater than vpci will be routed to itf, and
their VPI values will be set to the signaled VPCI minus vpci.
Multiple sigvpci entries can be used to support an arbitrary
number of interfaces. Example: with sigvpci4itf1, 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.
policylevellevel
Sets the debug level for messages related to policy decisions to
level.
policydecisiondirectionaddress
Takes the specified decision for calls from or to address.
decision can be either allow or reject. direction is either from
or to. The address 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
atmsigd.conf until the first match. If no rule matches, the call
is allowed.
entity [itf.]vpi.vci{options...}
Activates a signaling entity on that specific VC. Multiple
entity clauses can appear in the same configuration. When using
entity, the option iovc is not available. entity is optionally
followed by the following options, enclosed in curly braces:
vpci (corresponds to sigvpci), mode (corresponds to sigmode),
qos (corresponds to vcqos), route, and default. The last two
options determine how outbound calls are routed. The route
option is followed by an address in the format used for
addresses in policy. If no route entry matches the called party
number of an outbound call, the entry marked with default is
selected.
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:
debug {
level warn
dump /var/tmp
log syslog
trace 100
}
Line breaks can be inserted in atmsigd.conf wherever spaces or tabs are
allowed. Everything between a ‘#’ and the end of the line is considered
a comment. The ‘#’ character cannot be escaped.
If an option is specified in atmsigd.conf and on the command line, the
command line has priority. Certain options used by past versions of
atmsigd but no longer documented on the man page are still recognized
and supported, but they also yield a warning message. Future versions
of atmsigd will not recognize those options.