llc2_stats(1)
NAME
llc2_stats - LLC2 Station, SAP, and Connection Statistics
SYNOPSIS
llc2_stats ppa [-r] [-s sap] [-c connection]
DESCRIPTION
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 com-
ponents.
OPTIONS
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.
OPERANDS
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.
EXAMPLES
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 adja-
cent 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 retriev-
ing 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 com-
ponent (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 follow-
ing 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 com-
ponent prior to stateOlder.
stateOlder
A number representing the state of the connection com-
ponent prior to stateOld.
stateOld
A number representing the state of the connection com-
ponent 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 out-
standing).
timerOn
A number representing the timer activity flag, with
each bit representing an active timer for this connec-
tion. 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 expira-
tion occurs. These timers protect outbound frames.
numToBeAcked
The number of outbound I-frames awaiting acknowledge-
ment.
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 |
|___________________________________________________________|
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWllc |
|_____________________________|_____________________________|
FILES
/dev/llc2
clone device
SEE ALSO
attributes(5)
NOTES
For further information on the LLC2 components, states and
flags, see the International Standards Organization docu-
ment, ISO 8802-2: 1994, Section 7.
Man(1) output converted with
man2html