|
User Commands | llc2_stats(1) |
| llc2_stats - LLC2 Station, SAP, and Connection
Statistics |
SYNOPSIS
| llc2_stats ppa [-r] [-s sap] [-c connection] |
|
The llc2_stats command is used to retrieve statistical
information from the Host-based Logical Link Control Class 2 component of
the LLC2 Driver. Statistics are kept for the station, SAP
(Service Access Point), and connection components.
|
|
The following options are supported:
- -c connection
- Specifies the connection
of interest. Its value is entered in hexadecimal notation with no leading 0x.
- -r
- Resets the
specified counters to zero after reading them. This option is only valid
if the root user is executing the command.
- -s sap
- Specifies the SAP for this request. It
is a single-byte value, expressed in hexadecimal notation with no leading
0x. For example, the NetBIOS sap, 240 (0xf0) would be
entered as: -s f0.
|
|
The following operand is supported:
-
ppa
- The logical number used to address the adapter. The
PPA (Physical Point of Attachment) must be the first argument.
|
| Example 1. Station Statistics
|
The following command will display the station statistics for PPA 4. After the example, a
brief description of each field is presented.
|
example% /usr/lib/llc2/llc2_stats 4
Station values received:
ppa = 0x00000004 clearFlag = 0x00
# of saps (hex) = 0x0002
saps (hex) = 02 aa
state = 0x01
nullSapXidCmdRcvd = 0x00000000
nullSapXidRspSent = 0x00000000
nullSapTestCmdRcvd = 0x00000000
nullSapTestRspSent = 0x00000000
outOfState = 0x00000000
allocFail = 0x00000000
protocolError = 0x00000000
|
The fields are described as follows:
-
ppa
- The logical number used to address
the adapter.
-
clearFlag
- This flag indicates if the statistics will be reset to zero after
reading (set to a 1) or if the statistics are read only (set to 0).
-
# of saps
- The number of SAPs currently bound on this station.
-
saps
- The array of the station's Service Access Point (SAP)
logical interface values between the LLC and its adjacent layers.
-
state
- A number indicating the current state of the station component (0
= down, 1 = up).
-
nullSapXidCmdRcvd
- The number of XID command Protocol Data Units (PDUs) received
for the NULL SAP address (sap = 0x00).
-
nullSapXidRspSent
- The number of XID response PDUs sent in response to XID
command PDUs received for the null SAP address.
-
nullSapTestCmdRcvd
- The number of TEST command PDUs received for the null SAP address.
-
nullSapTestRspSent
- The number of TEST response PDUs sent in response to TEST
command PDUs received for the null SAP address.
-
outOfState
- The number of events received in an invalid state.
-
allocFail
- The number of buffer allocation failures.
-
protocolError
- The number of LLC protocol errors, that is, the receipt
of malformed PDUs or the receipt of frame X when frame Y was expected.
|
Example 2. SAP Statistics
|
In the above display, there are two active SAPs, 0x02 and 0xaa. The following is an example
of a command for retrieving the statistics for SAP 02
and a brief explanation of each field presented.
|
example% /usr/lib/llc2/llc2_stats 4 -s 02
Sap values received:
ppa = 0x00000004 clearFlag = 0x00
sap = 0x02
state = 0x01
# of cons (hex) = 0x0000000a
connections (hex) = 0000 0001 0002 0003 0004 0005 0006 0007 0008 0009
xidCmdSent = 0x00000000
xidCmdRcvd = 0x00000000
xidRspSent = 0x00000000
xidRspRcvd = 0x00000000
testCmdSent = 0x00000000
testCmdRcvd = 0x00000000
testRspSent = 0x00000000
testRspRcvd = 0x00000000
uiSent = 0x00000000
uiRcvd = 0x00000000
outOfState = 0x00000000
allocFail = 0x00000000
protocolError = 0x00000000
|
The fields are described as follows:
-
ppa
- The logical number used to address
the adapter.
-
clearFlag
- This flag indicates if the statistics will be reset to zero after
reading (set to a 1) or if the statistics are read only (set to 0).
-
sap
- The specified Service Access Point (SAP) logical
interface value for the station.
-
state
- A number indicating the current state of the SAP
component (0 = inactive, 1 = active).
-
# of cons
- The number of active connections on this SAP.
-
connections
- The array of active connection indexes.
-
xidCmdSent
- The number of XID command PDUs sent (Source SAP
= this sap).
-
xidCmdRcvd
- The number of XID command PDUs received (Destination SAP = this sap).
-
xidRspSent
- The number of XID response PDUs sent (Source SAP
= this sap).
-
xidRspRcvd
- The number of XID response PDUs received (Source SAP
= this sap).
-
testCmdSent
- The number of TEST command PDUs sent (Source SAP
= this sap).
-
testCmdRcvd
- The number of TEST command PDUs received (Destination SAP = this sap).
-
testRspSent
- The number of TEST response PDUs sent (Source SAP
= this sap).
-
testRspRcvd
- The number of TEST response PDUs received (Source SAP = this sap).
-
uiSent
- The number of Unnumbered Information Frames sent.
-
uiRcvd
- The number of Unnumbered Information Frames received.
-
outOfState
- The number of events received in an invalid state.
-
allocFail
- The number of buffer allocation failures.
-
protocolError
- The number of LLC protocol errors, that is, the receipt
of malformed PDUs or the receipt of frame X when frame Y was expected.
|
Example 3. Connection Statistics
|
Ten established connections are associated with this SAP. To retrieve the statistics for connection 1,
enter the following command:
|
example% /usr/lib/llc2/llc2_stats 4 -s 2 -c 1
Connection values received:
ppa = 0x0004 clearFlag = 0x00
sap = 0x02 con = 0x0001 sid = 0x0201
stateOldest = 0x00 stateOlder = 0x00 stateOld = 0x01
state = 0x08
dl_nodeaddr = 0x0080d84008c2 dl_sap = 0x04
flag = 0x50 dataFlag = 0x00 timerOn = 0x18
vs = 0x29 vr = 0x1e nrRcvd = 0x29 k = 0x14
retryCount = 0x0000 numToBeAcked = 0x0000 numToResend = 0x0000
macOutSave = 0x0000 macOutDump = 0x0000
iSent = 0x0ba9 iRcvd = 0x001e
frmrSent = 0x0000 frmrRcvd = 0x0000
rrSent = 0x016a rrRcvd = 0x00c1
rnrSent = 0x0000 rnrRcvd = 0x06fb
rejSent = 0x0000 rejRcvd = 0x0000
sabmeSent = 0x0000 sabmeRcvd = 0x0001
uaSent = 0x0001 uaRcvd = 0x0000 discSent = 0x0000
outOfState = 0x0000 allocFail = 0x0000 protocolError = 0x0000
localBusy = 0x0000 remoteBusy = 0x00b5 maxRetryFail = 0x0000
ackTimerExp = 0x0000 pollTimerExp = 0x0000 rejTimerExp = 0x0000
remBusyTimerExp = 0x0000
inactTimerExp = 0x0000
sendAckTimerExp = 0x0000
|
-
ppa
- The logical number used to address
the adapter.
-
clearFlag
- This flag indicates if the statistics will be reset to zero after
reading (set to a 1) or if the statistics are read only (set to 0).
-
sap
- The specified Service Access Point (SAP) logical
interface value for the station.
-
con
- The specified connection index value for the SAP.
-
stateOldest
- A number representing the state of the connection component prior
to stateOlder.
-
stateOlder
- A number representing the state of the connection component prior
to stateOld.
-
stateOld
- A number representing the state of the connection component prior
to state.
-
state
- A number representing the most current state of the connection component.
See Table 1.
-
sid
- The Station Identifier composed of the SAP (upper
byte) and connection index (lower byte).
-
dl_nodeaddr
- The Data Link Node Address. This is the destination node's MAC address.
-
dl_sap
- The destination node's SAP.
-
flag
- The connection component processing flag. See Table 3.
-
dataFlag
- A number representing the status of the data units from received I-frame
PDUs (0 = not discarded, 1 = discarded, 2 = busy state entered with REJ
PDU outstanding).
-
timerOn
- A number representing the timer activity flag, with each bit representing
an active timer for this connection. See Table 2 for
timer definitions.
-
vs
- The sequence number of the next I-frame PDU to send.
-
vr
- The expected sequence number of the next I-frame PDU to be received.
-
nrRcvd
- The sequence number plus 1 of the last sent I-frame PDU acknowledged
by the remote node.
-
k
- The transmit window size.
-
retryCount
- The retryCount is incremented whenever a timer
expiration occurs. These timers protect outbound frames.
-
numToBeAcked
- The number of outbound I-frames awaiting acknowledgement.
-
numToResend
- The number of outbound I-frames to be retransmitted.
-
macOutSave
- No longer used.
-
macOutDump
- No longer used.
-
iSent
- The number of I-frames sent.
-
iRcvd
- The number of I-frames received.
-
frmrSent
- The number of Frame Reject PDUs (FRMR) sent.
-
frmrRcvd
- The number of Frame Reject PDUs (FRMR) received.
-
rrSent
- The number of Receiver Ready PDUs (RR) sent.
-
rrRcvd
- The number of Receiver Ready PDUs (RR) received.
-
rnrSent
- The number of Receiver Not Ready PDUs (RNR) sent.
-
rnrRcvd
- The number of Receiver Not Ready PDUs (RNR) received.
-
rejSent
- The number of Reject PDUs (REJ) sent.
-
rejRcvd
- The number of Reject PDUs (REJ) received.
-
sabmeSent
- The number of Set Asynchronous Balanced Mode Extended PDUs (SABME) sent.
-
sabmeRcvd
- The number of Set Asynchronous Balanced Mode Extended PDUs (SABME) received.
-
uaSent
- The number of Unnumbered Acknowledgment PDUs (UA) sent.
-
uaRcvd
- The number of Unnumbered Acknowledgment PDUs (UA) received.
-
discSent
- The number of Disconnect PDUs (DISC) sent.
-
outOfState
- The number of events received in an invalid state.
-
allocFail
- The number of buffer allocation failures.
-
protocolError
- The number of LLC protocol errors, that is, the receipt
of malformed PDUs or the receipt of frame X when frame Y was expected.
-
localBusy
- The number of times this component was in local busy state and could
not accept I-frames.
-
remoteBusy
- The number of times the remote connection component was busy and could
not accept I-frames.
-
maxRetryFail
- The number of failures that occurred because maxRetry was reached.
-
ackTimerExp
- The number of expirations of the Acknowledgement timer.
-
pollTimerExp
- The number of expirations of the Poll timer.
-
rejTimerExp
- The number of expirations of the Reject timer.
-
remBusyTimerExp
- The number of expirations of the Remote Busy timer.
-
inactTimerExp
- The number of expirations of the Inactivity timer.
-
sendAckTimerExp
- The number of expirations of the Send Acknowledgement timer.
Table 1: LLC2 States |
STATION |
~~DOWN | 0x00 |
~~UP | 0x01 |
SAP |
~~INACTIVE | 0x00 |
~~ACTIVE | 0x01 |
CONNECTION |
~~ADM | 0x00 |
~~CONN | 0x01 |
~~RESET_WAIT | 0x02 |
~~RESET_CHECK | 0x03 |
~~SETUP | 0x04 |
~~RESET | 0x05 |
~~D_CONN | 0x06 |
~~ERROR | 0x07 |
~~NORMAL | 0x08 |
~~BUSY | 0x09 |
~~REJECT | 0x0a |
~~AWAIT | 0x0b |
~~AWAIT_BUSY | 0x0c |
~~AWAIT_REJECT | 0x0d |
Table 2: timersOn |
Acknowledgement | 0x80 |
Poll | 0x40 |
Reject | 0x20 |
Remove Busy | 0x10 |
Inactivity | 0x08 |
Send Acknowledgement | 0x04 |
Table 3: LLC2 Flags |
P_FLAG | 0x80 |
F_FLAG | 0x40 |
S_FLAG | 0x20 |
REMOTE_BUSY | 0x10 |
RESEND_PENDING | 0x08 |
|
|
|
See attributes(5)
for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
Availability | SUNWllc |
|
|
For further information on the LLC2 components, states and flags,
see the International Standards Organization document, ISO 8802-2: 1994,
Section 7.
|
| |