atmsigd



ATMSIGD(8)                   Maintenance Commands                   ATMSIGD(8)




NAME

       atmsigd - ATM signaling demon


SYNOPSIS

       atmsigd [-b] [-c config_file] [-d] [-D dump_dir] [-l logfile] [-m mode]
       [-n]   [-q qos]   [-t trace_length]   [-u uni_version]   [[itf.]vpi.vci
       [input output]]
       atmsigd -V


DESCRIPTION

       atmsigd  implements  the ATM UNI signaling protocol. Requests to estab-
       lish, accept, or close ATM SVCs are sent from the kernel (using a  com-
       parably  simple  protocol)  to the signaling demon, which then performs
       the dialog with the network.

       Note that atmsigd is not able to accept or establish connections  until
       the  local ATM address of the interface is configured by ilmid or manu-
       ally using atmaddr.

       The default signaling VC (interface 0, VPI 0, VCI 5) can be  overridden
       on the command line by specifying a different PVC address.

       When overriding the default VC, optionally a pair of named pipes to use
       for communicating with the user of signaling  can  be  specified.  Nor-
       mally,  the kernel is the user of signaling and atmsigd opens a special
       socket for communication with it.

       If atmsigd is killed, all system calls requiring  interaction  with  it
       will return with an error and set errno to EUNATCH.


OPTIONS

       -b     Run  in  background  (i.e. in a forked child process) after ini-
              tializing.

       -c config_file
              Use  the  specified  configuration  file  instead  of  /etc/atm-
              sigd.conf  If  an  option is specified in the configuration file
              and on the command line, the command line has priority.

       -d     Enables (lots of) debugging output. By default, atmsigd is  com-
              parably quiet.

       -D dump_dir
              Specifies  the  directory to which atmsigd will write status and
              trace dumps. If -D  is  not  specified,  dumps  are  written  to
              /var/tmp.

       -l logfile
              Write  diagnostic  messages  to  the specified file. The special
              name syslog is used to send diagnostics to  the  system  logger,
              stderr  is  used to send diagnostics to standard error. If -l is
              absent, the setting in atmsigd.conf is used. If atmsigd  doesn’t
              specify  a  destination either, messages are written to standard
              error.

       -m mode
              Set the mode of operation. The following  modes  are  available:
              user  for  the  user side (the default), network for the network
              side (useful if you have two PCs but no switch), and switch  for
              operation with a signaling relay in a switch.

       -n     Prints addresses in numeric format only, i.e. no address to name
              translation is attempted.

       -q qos Configures the signaling VC to use the specified quality of ser-
              vice (see qos(7) for the syntax).  By default, UBR at link speed
              is used on the signaling VC.

       -t trace_length
              Sets the number of entries that should  be  kept  in  the  trace
              buffer.   -t 0 disables tracing. If -t is not specified, atmsigd
              uses a default of 20 trace entries.

       -u uni_version
              Sets the signaling mode.  The  following  modes  are  supported:
              uni30  for  UNI  3.0, uni31 for UNI 3.1, uni31+uni30 for UNI 3.1
              with 3.0 compatibility, uni40 for UNI  4.0,  and  uni40+q.2963.1
              for UNI 4.0 with Q.2963.1 peak cell rate renegotiation.

       -V     Prints  the  version  number  of  atmsigd on standard output and
              exits.


FILES

       /etc/atmsigd.conf        default configuration file
       /var/tmp/atmsigd.pid.status.version
                                default location of status dumps
       /var/tmp/atmsigd.pid.trace.version
                                default location of signaling trace dumps


DEBUGGING

       When receiving a SIGUSR1 signal, atmsigd dumps the list of all internal
       socket  descriptors.  With  SIGUSR2, it dumps the contents of the trace
       buffer. If a dump directory was set, dumps are written to files  called
       atmsigd.pid.status.number  and  atmsigd.pid.trace.number, respectively,
       with number starting at zero and being incremented for every  dump.  If
       no dump directory is set, dumps are written to standard error.

       Dumps  are  also  generated  whenever atmsigd detects a fatal error and
       terminates. No attempt is made to catch signals like SIGSEGV.


BUGS

       The generation of traces is a comparably slow process which may already
       take  several  seconds for only 100 trace entries.  To generate a trace
       dump, atmsigd therefore forks a child process that runs in parallel  to
       the signaling demon.


AUTHOR

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


SEE ALSO

       atmaddr(8), atmsigd.conf(4), ilmid(8), qos(7)



Linux                           April 26, 2000                      ATMSIGD(8)

Man(1) output converted with man2html