Content-type: text/html
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.
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.
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
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 flag. Specifies the interface. This argument can appear anywhere on the command line.
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.
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.
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.
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.
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) |
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 |
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.
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
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.
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.
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
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.
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.
Commands: atmconfig(8)
Files: atm.conf(4)
Asynchronous Transfer Mode delim off