ATMSIGD(8) Maintenance Commands ATMSIGD(8)
NAME
atmsigd(4,8) - ATM signaling demon
SYNOPSIS
atmsigd(4,8) [-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(4,8) -V
DESCRIPTION
atmsigd(4,8) implements the ATM UNI signaling protocol. Requests to estab-
lish, accept(2,8), or close(2,7,n) ATM SVCs are sent from the kernel (using a com-
parably simple protocol) to the signaling demon, which then performs
the dialog(1,3,n) with the network.
Note that atmsigd(4,8) is not able to accept(2,8) 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(5,8) pipes to use
for communicating with the user of signaling can be specified. Nor-
mally, the kernel is the user of signaling and atmsigd(4,8) opens a special
socket(2,7,n) for communication with it.
If atmsigd(4,8) is killed, all system calls requiring interaction with it
will return with an error(8,n) and set(7,n,1 builtins) errno to EUNATCH.
OPTIONS
-b Run in(1,8) background (i.e. in(1,8) a forked child process) after ini-
tializing.
-c config_file
Use the specified configuration file(1,n) instead of /etc/atm-
sigd.conf If an option is specified in(1,8) the configuration file(1,n)
and on the command line, the command line has priority.
-d Enables (lots of) debugging output. By default, atmsigd(4,8) is com-
parably quiet.
-D dump_dir
Specifies the directory to which atmsigd(4,8) will write(1,2) status and
trace(3x,n,3x _nc_tracebits) 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(2,3,5,3 Sys::Syslog) is used to send(2,n) diagnostics to the system logger,
stderr is used to send(2,n) diagnostics to standard error. If -l is
absent, the setting in(1,8) atmsigd.conf is used. If atmsigd(4,8) 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(3,n) you have two PCs but no switch(1,n)), and switch(1,n) for
operation with a signaling relay in(1,8) a switch.
-n Prints addresses in(1,8) 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(1,2) speed
is used on the signaling VC.
-t trace_length
Sets the number of entries that should be kept in(1,8) the trace(3x,n,3x _nc_tracebits)
buffer. -t 0 disables tracing. If -t is not specified, atmsigd(4,8)
uses a default of 20 trace(3x,n,3x _nc_tracebits) 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(1,3,5) number of atmsigd(4,8) on standard output and
exits.
FILES
/etc/atmsigd.conf default configuration file(1,n)
/var/tmp/atmsigd.pid.status.version(1,3,5)
default location of status dumps
/var/tmp/atmsigd.pid.trace.version(1,3,5)
default location of signaling trace(3x,n,3x _nc_tracebits) dumps
DEBUGGING
When receiving a SIGUSR1 signal(2,7), atmsigd(4,8) dumps the list of all internal
socket(2,7,n) descriptors. With SIGUSR2, it dumps the contents of the trace(3x,n,3x _nc_tracebits)
buffer. If a dump directory was set(7,n,1 builtins), 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(7,n,1 builtins), dumps are written to standard error.
Dumps are also generated whenever atmsigd(4,8) detects a fatal error(8,n) 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(3x,n,3x _nc_tracebits) entries. To generate a trace(3x,n,3x _nc_tracebits)
dump, atmsigd(4,8) therefore forks a child process that runs in(1,8) 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)