atmsig(8)atmsig(8)NAMEatmsig - Allows the configuration and management of the UNI signaling
module
SYNOPSIS
/usr/sbin/atmsig command arguments
OPTIONS
This section is organized by the tasks you can perform with the atmsig
command. Each task subsection provides the atmsig command syntax and
the arguments to use to complete the tasks.
Enabling an ATM Interface
Syntax: atmsig up driver=driver_name
[ilmi state=on | off [vci=vci# vpi=vpi# vc_options]]
[sig vci=vci# vpi=vpi# vc_options]
[timers [qsaal [qsaal_timers=value...] q93b [q93b_timers=value...]]]
[account [state=on | off]]
[trace [state=on | off] [layer=q93b | qsaal | all]]
[version [uni=3.0 | 3.1]] [wait]
Enables signaling on the interface specified by the next argument. The
default VC used for signaling is VPI 0 and VCI 5. Specifies the inter‐
face. This argument can appear anywhere on the command line. The
vc_options are described in the DESCRIPTION section. Enables (on) and
disables (off) ILMI on the interface. Specify a VCI number and VPI
number, if you do not want to use the default. Enables signaling on a
VC other than the default. Specify a VCI number and VPI number, if you
do not want to use the default. The vc_options are described in the
DESCRIPTION section. Specifies that the Q.SAAL or Q.93B timer values
are to be modified. See Modifying ATM Signaling Timer Values for a
description of timers. Enables (on) and disables (off) accounting
information for a virtual circuit (VC). By default, accounting is dis‐
abled. Enables (on) and disables (off) signaling packet tracing for
the interface.
The layer parameter specifies the level of signaling packet
tracing to be performed when tracing is enabled. Specifying
q93b enables the tracing of Q.93B ATM signaling packets, qsaal
enables the tracing of Q.SAAL ATM signaling packets, and all
enables the tracing of ATM signaling packets for both layers.
If you do not specify this parameter, by default the Q.93B layer
of ATM signaling packets are traced. Specifies the signaling
version to use on the interface. The default is UNI3.0. Forces
the command to wait until an address is registered with the
switch and signaling is actually up on the interface.
For example, the following command disables ILMI, enables packet trac‐
ing, and brings signaling up using VCI 100 and VPI 0 on interface lta0.
atmsig up driver=lta0 ilmi state=off trace state=on sig \ vci=100 vpi=0
Disabling an ATM Interface
Syntax:
atmsig down driver=driver_name
Disables signaling on the driver_name interface. If you disable the
interface using the atmconfig command, signaling on that interface is
also disabled. You must enable signaling again using the up option.
Specifies the interface. This argument can appear anywhere on the com‐
mand line.
Enabling and Disabling ILMI on an ATM Interface
Syntax:
atmsig ilmi driver=driver_name [state=on | off]
[vci=vci# vpi=vpi# vc_options]
Specifies Interim Local Management Interface (ILMI). If no options are
specified, atmsig displays whether ILMI is enabled. Specifies the
interface. This argument can appear anywhere on the command line.
Enables (on) or disables (off) ILMI. By default, ILMI is enabled on
Virtual Path Identifier (VPI) 0 and Virtual Channel Identifier (VCI) 16
when signaling is enabled on that interface. Specifies a VCI number,
if you do not want to use the default. Specifies a VPI number, if you
do not want to use the default. Specifies the traffic contract parame‐
ters (vc_options), which are described in the DESCRIPTION section.
Enabling and Disabling Signaling on an ATM Interface
Syntax: atmsig signaling driver=driver_name [state=on | off]
[timers [qsaal [qsaal_timers=value...] q93b [q93b_timers=value...]]]
[account [state=on | off]]
[trace [state=on | off] [layer=q93b | qsaal | all]]
[vc_options]
Specifies signaling for the interface specified by the next argument.
Specifies the interface. This argument can appear anywhere on the com‐
mand line. Enables (on) or disables (off) signaling. If you do not
specify a state, signaling is enabled. By default, signaling is
enabled on VPI 0 and VCI 5. You cannot enable ILMI by using this com‐
mand. Specifies that the Q.SAAL or Q.93B timer values are to be modi‐
fied. See Modifying ATM Signaling Timer Values for a description of
timers. Enables (on) and disables (off) accounting information for a
virtual circuit (VC). By default, accounting is disabled. Enables
(on) and disables (off) signaling packet tracing for the interface.
The layer parameter specifies the level of signaling packet
tracing to be performed when tracing is enabled. Specifying
q93b enables the tracing of Q.93B ATM signaling packets, qsaal
enables the tracing of Q.SAAL ATM signaling packets, and all
enables the tracing of ATM signaling packets for both layers.
If you do not specify this parameter, by default the Q.93B layer
of ATM signaling packets are traced. Specifies the traffic con‐
tract parameters (vc_options), which are described in the
DESCRIPTION section.
Displaying ATM Interface Signaling State
Syntax:
atmsig state | status driver=driver_name [ilmi qsaal q93b]
Displays the state of Q.93B, Q.SAAL, and ILMI on an interface. The
state and status result in the same behavior. If no options are speci‐
fied, atmsig displays the state of Q.93B, Q.SAAL, and ILMI, and whether
tracing and accounting are enabled. Specifies the interface. This
argument can appear anywhere on the command line. Specifies ILMI.
Specifies Q.SAAL. Q.SAAL is a generic name used to describe the trans‐
port layer for Q.93B. Specifies Q.93B. Q.93B is a generic name for
the signaling protocol employed at the User-Network Interface (UNI) of
an ATM network.
Displaying ATM Interface Signaling Statistics
Syntax:
atmsig stats driver=driver_name [qsaal q93b zero]
Displays statistics for an interface. If no options are specified, the
statistics of Q.93B and Q.SAAL are displayed. Specifies the interface.
This argument can appear anywhere on the command line. Specifies
Q.SAAL statistics. Specifies Q.93B statistics. Clears the counters
after they are read and displayed.
Modifying ATM Signaling Timer Values
Syntax:
atmsig timers driver=driver_name [qsaal [qsaal_timers=value...] q93b
[q93b_timers=value...]]
Specifies that the timer values are to be modified for the interface
specified by the next argument. You must modify timer values before
the signaling module is brought up on a specific interface. If the
interface is already running, disable the signaling module on the
interface before setting the timer values. If the driver on that inter‐
face is down, the timer values cannot be modified. Specifies the
interface. This argument can appear anywhere on the command line.
Specifies Q.SAAL timers. If no timer options are specified, atmsig
displays the timers and their values. Sets a qsaal_timer to value (in
seconds). For 4.5 seconds, use the value 4.5; for 800 milliseconds,
use the value .8. You can specify multiple timers and values, delim‐
ited by a space. The following table shows the Q.SAAL timers that can
be modified:
──────────────────────────────────────
Timer Description
──────────────────────────────────────
tcc Connection control timer
tka Keep alive timer
tnr No response timer
tpl Poll timer
tid Idle timer (For UNI 3.1 only)
──────────────────────────────────────
Specifies Q.93B timer. If no timer options are specified, atm‐
sig displays the timers and their values. Sets a q93b_timer to
value (in seconds). You can specify multiple timers and values,
delimited by a space. The following table shows the Q.93B
timers that can be modified:
────────────────────
Timer Description
────────────────────
t303 T303 timer
t308 T308 timer
t309 T309 timer
t310 T310 timer
t313 T313 timer
t316 T316 timer
t322 T322 timer
t398 T398 timer
t399 T399 timer
────────────────────
For example, to set the T303 timer of Q.93B and the connection
control timer of Q.SAAL on interface lta0 to 5 seconds and 790
milliseconds and 105 milliseconds, respectively, use the follow‐
ing command: atmsig timer driver=lta0 qsaal tcc=0.105 q93b
t303=5.790
Enabling ATM Signaling Packet Tracing
Syntax:
atmsig trace driver=driver_name [state=on | off]
[layer=q93b | qsaal | all] [read] [raw]
Specifies signaling packet tracing on the interface specified by the
next argument. If no options are specified, atmsig displays whether
packet tracing is enabled. Specifies the interface. This argument can
appear anywhere on the command line. Enables (on) and disables (off)
signaling packing tracing. Once packet tracing is enabled, only the
last 24 packets transmitted and received are cached. Specifies the
level of signaling packet tracing to be performed when tracing is
enabled. Specifying q93b enables the tracing of Q.93B ATM signaling
packets, qsaal enables the tracing of Q.SAAL ATM signaling packets, and
all enables the tracing of ATM signaling packets for both layers. If
you do not specify this parameter, by default the Q.93B layer of ATM
signaling packets are traced. Reads the packets. Reading UNI signal‐
ing packets during connection establishment and tear down phases might
be helpful for debugging purposes.
For example, the following command enables packet tracing and
reads the incoming and outgoing packets: atmsig trace
driver=lta0 state=on read
All incoming packets are marked with the string '------->' and
all out going packets are marked with the string '<--------'.
All message types are not currently supported. If a message
type cannot be interpreted, the raw bytes are displayed. Reads
the data as it is received and displays the raw, hexadecimal
data. The data is not translated into packets.
Decoding ATM Signaling Messages
Syntax:
atmsig decode [file=filename]
Decodes UNI 3.0 signaling messages. By default, the atmsig command
expects to read a file named uni3 in the directory from which the com‐
mand is invoked. Specifies an alternative file that contains signaling
messages.
This command enables you to decode UNI 3.0 signaling messages from a
file that you create. If atmsig cannot decode the message, the raw
bytes are displayed.
The file containing the message bytes (hexadecimal values) must adhere
to the following guidelines: Each message must start with the protocol
discriminator 09 (hexadecimal). Each message sequence must be sepa‐
rated by a new line, without any characters or spaces in the line. If
all message bytes consist of both nibbles (for example, a value of 9
represented as 09 hexadecimal), spaces are not required between each
byte. If some message bytes consist of a single nibbles (for example,
a value of 9 represented as 9 hexadecimal), spaces are required between
each byte.
For example, the following is a valid file containing two ATM signaling
messages. Although all message bytes consist of both nibbles, spaces
are included in the example for readability only. Note: The line after
the first message is a new line that does not contain any spaces.
09 03 80 00 02 02 80 00 09 5a 80 00 05 88 00 00 00 21
09 03 80 00 02 07 80 00 0f 58 80 00 0b 05 8c 23 e4 81 23 e4 83 01 84 00
The output of the atmsig decode command for the preceding file is as
follows: Message #1 : Protocol Discriminator: 09 Call Reference
(03 80) Value: 0002 [2] Message Length:
0009 [9] Message Type: CALL PROCEEDING (02 80)
Connection Id (5a 80)
Length : 0005 [5]
Octet 5 (VPAS & P/E): 88
VPI: 0000 [0]
VCI: 0021 [33]
Message #2 : Protocol Discriminator: 09 Call Reference
(03 80) Value: 0002 [2] Message Length:
000f [15] Message Type: CONNECT (07
80)
AAL Parameters (58 80)
Length : 000b [11]
AAL Type : 05
FSDU: 23e4 [9188]
BSDU: 23e4 [9188]
Mode Id: 01
SSCS Type: 00
Displaying and Setting the ATM Signaling Version
Syntax:
atmsig version driver=driver_name [uni=3.0 | 3.1]
Displays or sets the signaling version to use on an interface. If no
version number is specified, atmsig displays the version number. The
default is UNI3.0. Specifies the interface. This argument can appear
anywhere on the command line.
Displaying ILMI Address List for an Interface
Syntax:
atmsig addrlist driver=driver_name
Displays the ATM addresses of the ILMI on the interface specified by
the next argument. Displayed information includes: ILMI state, ATM
prefixes of the User-Network Interface (UNI), and all ATM addresses on
the UNI. Specifies the interface. This argument can appear anywhere
on the command line.
Adding and Deleting an ATM Address Prefix
Syntax:
atmsig prefix driver=driver_name {+addr | -addr }=prefix
Specifies an ATM address prefix on the interface specified by the next
argument. The ATM subsystem uses ILMI to register a new set of
addresses based on the new prefix and existing End System Identifiers
(ESIs). Specifies the interface. This argument can appear anywhere on
the command line. Adds (+addr) or deletes (-addr) an ATM address pre‐
fix. The prefix value is a string in hexadecimal notation.
For example, to add an ATM address prefix, enter: # atmsig prefix
driver=lta0 +addr=0x3999990000000008002BB2C201
To remove the ATM prefix added in the previous example, enter: # atm‐
sig prefix driver=lta0 -addr=0x3999990000000008002BB2C201
Enabling and Disabling VC Accounting Information
Syntax:
atmsig account driver=driver_name [state=on | off]
Specifies accounting information for virtual circuits (VCs). If speci‐
fied with no arguments, it displays whether accounting is enabled for
all VCs. Specifies the interface. This argument can appear anywhere
on the command line. Enables (on) and disables (off) accounting infor‐
mation for all VCs. By default, accounting is disabled. If accounting
is enabled, the source address, the destination address, and the dura‐
tion of the connection is printed on the console when a VC is released.
DESCRIPTION
The atmsig command configures ATM UNI signaling on the end system. It
also displays state information about the signaling module, and can be
used to disable and enable the ILMI and signaling. The various timer
values and statistics for the signaling transport (Q.SAAL) and the sig‐
naling protocol (Q.93B) can be read and modified.
The signaling module is associated with a specified interface at all
times, which is identified by the driver name. If the interface is
disabled, the signaling module is also disabled. The signaling module
must be enabled again when the interface is brought back on line.
Traffic Contract Parameters (vc_options)
The following arguments specify the traffic contract parameters
(vc_options), which describe the characteristics of the cell stream
transferred over the PVC. These parameters are defined in the ATM
Forum User-Network Interface (UNI) Specification. When setting up PVCs
on the network, use the same traffic parameters when configuring the
PVC on switches and the other end system. Specifies the maximum packet
size that can be transmitted and received (mtu), transmitted (fmtu), or
received (bmtu) on the PVC. You can specify one value for both trans‐
mitted and received packets, or specify a value for transmitted and
received packets separately. If none of the mtu arguments are speci‐
fied, a default value is set. Specifies the quality of service
requested in both (qos), the forward/outgoing (fqos), or back‐
ward/incoming (bqos) directions. You can specify one value for both
directions, or specify a value for forward and backward directions sep‐
arately. The class parameter specifies the quality of service required
to meet a given service class's performance objectives. Valid
qos_class values and example service classes are as follows: Unspeci‐
fied (Best Effort). This is the default. Connection oriented constant
bit rate traffic with source/destination timing relationships. Connec‐
tion oriented variable bit rate traffic with source/destination timing
relationships. Connection oriented variable bit rate traffic with no
timing relationships. Connectionless variable bit rate traffic with no
timing relationships. Undefined bit rate traffic. Available bit rate
traffic.
Local significance of quality of service is not fully imple‐
mented. Specifies if the traffic cells congestion bits are to
be set/cleared on both (+tagging/-tagging), on outgoing (+ftag‐
ging/-ftagging), or on incoming (+btagging/-btagging) direc‐
tions. You can specify both directions, or specify the forward
and backward directions separately. By default, tagging is not
set.
Local significance of tagging is not fully implemented. Speci‐
fies that the best effort indicator be set (+bei) or cleared
(-bei). The best effort indicator is used with quality of ser‐
vice class NONE, and applies to both directions.
By default, the best effort indicator is set. Specifies, in
cells per second, an upper bound on the PVC's CLP 0 cell stream
in both directions (peak0), in the outgoing direction (fpeak0),
or in the incoming direction (bpeak0). You can specify one rate
for both directions, or specify a rate for outgoing and incoming
directions separately. By default, the CLP 0 peak cell rate is
set to a minimum value.
Peak cell rates only apply to adapters which support CBR and
cell pacing. Specifies an upper bound (in cells per second) on
the PVC's CLP 0+1 cell stream in both directions (peak1), in the
outgoing direction (fpeak1), or in the incoming direction
(bpeak1). You can specify one rate for both directions, or
specify a rate for outgoing and incoming directions separately.
By default, the CLP 0+1 peak cell rate is set to a minimum
value.
Peak cell rates only apply to adapters that support CBR and cell
pacing. Specifies the Broadband Bearer Capability Traffic Type.
For PVCs, specifying either CBR or pacing causes cells in the
PVC's traffic stream to be inserted into the network at the rate
specified in the peak1 argument. By default, bbtraffic is set
to NONE.
The CBR and pacing options only apply to adapters that support
these modes. Specifies the Broadband Bearer Capability Class of
Bearer (BCOB). By default, bbclass is set to NONE. Specifies
the Broadband Bearer Capability Timing Requirements. By
default, bbtiming is set to NONE.
Local significance of timing is not fully implemented. Speci‐
fies the Cell Loss Priority (CLP) of the PVC's traffic cell
stream. The +bbclipping argument indicates that the cells should
be treated with low priority and should be dropped, if needed,
during periods of congestion (CLP 0). The -bbclipping argument
indicates that the cells should be treated with high priority
and should not be dropped during periods of congestion (CLP 1).
By default, clipping is not set. Local significance of clipping
is not fully implemented.
SEE ALSO
Commands: atmconfig(8)
Files: atm.conf(4)
Asynchronous Transfer Mode
atmsig(8)
