ATMSIGD.CONF(4)

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:

debug dump path
    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.

debug level level
    Sets the default debug level to level. level can be any of debug, info, warn, error, and fatal. Only messages with 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 debug level debug.

debug log path
    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.

debug trace [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.

io level level
    Sets the debug level for IO-related messages to level.

io qos qos
    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.

io vc [itf.]vpi.vci
    Uses the specified VC for signaling messages instead of the usual 0.0.5.

saal level level
    Sets the debug level for messages related to SAAL (i.e. SSCF and SSCOP) to level.

sig level level
    Sets the debug level for messages related to signaling (Q.2931 or ISP) to level.

sig network
    Assume the role of the network side of the UNI.

sig uni30
    Use UNI 3.0 signaling. This option is not implemented. The signaling mode must be configured at compile time.

sig uni31
    Use UNI 3.1 signaling. This option is not implemented. The signaling mode must be configured at compile time.

sig vpci vpci itf itf
    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 sig vpci entries can be used to support an arbitrary number of interfaces. Example: with sig vpci 4 itf 1, 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.

policy level level
    Sets the debug level for messages related to policy decisions to level.

policy decision direction address
    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.

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. For historical reasons, synonyms (e.g. abbreviated or long forms) exist for most keywords. Future versions of atmsigd will only recognize the syntax described on this man page.

AUTHOR
Werner Almesberger, EPFL LRC <werner.almesberger@lrc.di.epfl.ch>

SEE ALSO
atmsigd(8), qos(7), syslogd(8)