Provided by: atm-tools_2.5.1-1.3_i386 bug

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 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 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. Writing to  standard  output
              can  also be explicitly requested by using the special file name
              stderr.

       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 max_rate rate
              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.)

       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 mode mode
              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.

       sig uni30
              Use  UNI  3.0  signaling.  If specified together with sig uni31,
              this option  sets  UNI  3.1  signaling  with  a  few  backwards-
              compatibility extensions.

       sig uni31
              Use  UNI  3.1  signaling.  This  option can be combined with sig
              uni30 (see above).

       sig uni40
              Use UNI 4.0 signaling. This option  can  be  combined  with  sig
              q.2963.1 (see below).

       sig q.2963.1
              Enable  peak  cell  rate  renegotiation.  This  option  is  only
              available with UNI 4.0 signaling.

       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.

       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 io vc is not available.  entity is optionally
              followed by the following options,  enclosed  in  curly  braces:
              vpci  (corresponds to sig vpci), mode (corresponds to sig mode),
              qos (corresponds to vc qos), 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.

COMPATIBILITY

       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.

AUTHOR

       Werner Almesberger, EPFL ICA <Werner.Almesberger@epfl.ch>

SEE ALSO

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