man pages section 1: User Commands

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 components.

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 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

Attributes

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWllc

Files

/dev/llc2: clone device

Notes

For further information on the LLC2 components, states and flags, see the International Standards Organization document, ISO 8802-2: 1994, Section 7.

SunOS 5.10 Last Revised 18 May 1999