atmsig - Allows the configuration and management of the
UNI signaling module
/usr/sbin/atmsig command arguments
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 [Toc] [Back]
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 interface. 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 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 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 tracing, 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 [Toc] [Back]
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 command
line.
Enabling and Disabling ILMI on an ATM Interface [Toc] [Back]
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 parameters
(vc_options), which are described in the DESCRIPTION
section.
Enabling and Disabling Signaling on an ATM Interface [Toc] [Back]
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 command 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
command. 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 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 contract
parameters (vc_options), which are described in the
DESCRIPTION section.
Displaying ATM Interface Signaling State [Toc] [Back]
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 specified, 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 transport 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 [Toc] [Back]
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 [Toc] [Back]
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 interface
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, delimited 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, atmsig 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 following command:
atmsig timer driver=lta0 qsaal tcc=0.105 q93b
t303=5.790
Enabling ATM Signaling Packet Tracing [Toc] [Back]
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 signaling 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 [Toc] [Back]
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 command 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 separated 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 [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
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
prefix. 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: # atmsig prefix driver=lta0
-addr=0x3999990000000008002BB2C201
Enabling and Disabling VC Accounting Information [Toc] [Back]
Syntax:
atmsig account driver=driver_name [state=on | off]
Specifies accounting information for virtual circuits
(VCs). If specified 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
information for all VCs. By default, accounting is disabled.
If accounting is enabled, the source address, the
destination address, and the duration of the connection is
printed on the console when a VC is released.
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 signaling
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) [Toc] [Back]
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 transmitted
and received packets, or specify a value for transmitted
and received packets separately. If none of the mtu arguments
are specified, a default value is set. Specifies
the quality of service requested in both (qos), the forward/outgoing
(fqos), or backward/incoming (bqos) directions.
You can specify one value for both directions, or
specify a value for forward and backward directions separately.
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: Unspecified (Best Effort). This is
the default. Connection oriented constant bit rate traffic
with source/destination timing relationships. Connection
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 implemented. Specifies if the traffic cells
congestion bits are to be set/cleared on both
(+tagging/-tagging), on outgoing (+ftagging/-ftagging),
or on incoming (+btagging/-btagging) directions.
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.
Specifies that the best effort indicator
be set (+bei) or cleared (-bei). The best effort
indicator is used with quality of service 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.
Specifies 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.
Commands: atmconfig(8)
Files: atm.conf(4)
Asynchronous Transfer Mode
atmsig(8)
[ Back ] |
