Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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.

–ssap

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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/network/llc2
Interface Stability
Obsolete

Files

/dev/llc2

clone device

See Also

attributes(7)

Notes

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

This utility might be removed in a future release of Oracle Solaris.