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