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.
| ||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||
| ||||||||||||
See attributes(5) for descriptions of the following attributes:
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWllc |
/dev/llc2 clone device
attributes(5)
For further information on the LLC2 components, states and flags, see the International Standards Organization document, ISO 8802-2: 1994, Section 7.