atmsigd(8)

1ATMSIGD(8)                   Maintenance Commands                   ATMSIGD(8)
2
3
4

NAME

6       atmsigd - ATM signaling demon
7

SYNOPSIS

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

DESCRIPTION

15       atmsigd  implements  the ATM UNI signaling protocol. Requests to estab‐
16       lish, accept, or close ATM SVCs are sent from the kernel (using a  com‐
17       parably  simple  protocol)  to the signaling demon, which then performs
18       the dialog with the network.
19
20       Note that atmsigd is not able to accept or establish connections  until
21       the  local ATM address of the interface is configured by ilmid or manu‐
22       ally using atmaddr.
23
24       The default signaling VC (interface 0, VPI 0, VCI 5) can be  overridden
25       on the command line by specifying a different PVC address.
26
27       When overriding the default VC, optionally a pair of named pipes to use
28       for communicating with the user of signaling  can  be  specified.  Nor‐
29       mally,  the kernel is the user of signaling and atmsigd opens a special
30       socket for communication with it.
31
32       If atmsigd is killed, all system calls requiring  interaction  with  it
33       will return with an error and set errno to EUNATCH.
34

OPTIONS

36       -b     Run  in  background  (i.e. in a forked child process) after ini‐
37              tializing.
38
39       -c config_file
40              Use  the  specified  configuration  file  instead  of  /etc/atm‐
41              sigd.conf  If  an  option is specified in the configuration file
42              and on the command line, the command line has priority.
43
44       -d     Enables (lots of) debugging output. By default, atmsigd is  com‐
45              parably quiet.
46
47       -D dump_dir
48              Specifies  the  directory to which atmsigd will write status and
49              trace dumps. If -D  is  not  specified,  dumps  are  written  to
50              /var/tmp.
51
52       -l logfile
53              Write  diagnostic  messages  to  the specified file. The special
54              name syslog is used to send diagnostics to  the  system  logger,
55              stderr  is  used to send diagnostics to standard error. If -l is
56              absent, the setting in atmsigd.conf is used. If atmsigd  doesn't
57              specify  a  destination either, messages are written to standard
58              error.
59
60       -m mode
61              Set the mode of operation. The following  modes  are  available:
62              user  for  the  user side (the default), network for the network
63              side (useful if you have two PCs but no switch), and switch  for
64              operation with a signaling relay in a switch.
65
66       -n     Prints addresses in numeric format only, i.e. no address to name
67              translation is attempted.
68
69       -q qos Configures the signaling VC to use the specified quality of ser‐
70              vice (see qos(7) for the syntax).  By default, UBR at link speed
71              is used on the signaling VC.
72
73       -t trace_length
74              Sets the number of entries that should be kept in the trace buf‐
75              fer.   -t  0  disables  tracing. If -t is not specified, atmsigd
76              uses a default of 20 trace entries.
77
78       -u uni_version
79              Sets the signaling mode.  The  following  modes  are  supported:
80              uni30  for  UNI  3.0, uni31 for UNI 3.1, uni31+uni30 for UNI 3.1
81              with 3.0 compatibility, uni40 for UNI  4.0,  and  uni40+q.2963.1
82              for UNI 4.0 with Q.2963.1 peak cell rate renegotiation.
83
84       -V     Prints  the  version  number  of  atmsigd on standard output and
85              exits.
86

FILES

88       /etc/atmsigd.conf        default configuration file
89       /var/tmp/atmsigd.pid.status.version
90                                default location of status dumps
91       /var/tmp/atmsigd.pid.trace.version
92                                default location of signaling trace dumps
93

DEBUGGING

95       When receiving a SIGUSR1 signal, atmsigd dumps the list of all internal
96       socket  descriptors.  With  SIGUSR2, it dumps the contents of the trace
97       buffer. If a dump directory was set, dumps are written to files  called
98       atmsigd.pid.status.number  and  atmsigd.pid.trace.number, respectively,
99       with number starting at zero and being incremented for every  dump.  If
100       no dump directory is set, dumps are written to standard error.
101
102       Dumps  are  also  generated  whenever atmsigd detects a fatal error and
103       terminates. No attempt is made to catch signals like SIGSEGV.
104

BUGS

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

AUTHOR

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