unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

llc2_stats(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  argu-
                       ment.



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 sta-
                               tion.



       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)  logi-
                               cal 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 (Desti-
                               nation 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 (Des-
                               tination 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)  logi-
                               cal interface value for the station.



       con                     The  specified  connection  index value for the
                               SAP.



       stateOldest             A number representing the state of the  connec-
                               tion component prior to stateOlder.



       stateOlder              A  number representing the state of the connec-
                               tion component prior to stateOld.



       stateOld                A number representing the state of the  connec-
                               tion 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 desti-
                               nation 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  dis-
                               carded,  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  defini-
                               tions.



       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 out-
                               bound frames.



       numToBeAcked            The  number  of  outbound   I-frames   awaiting
                               acknowledgement.



       numToResend             The  number of outbound I-frames to be retrans-
                               mitted.



       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  com-
                               ponent 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  Acknowledge-
                               ment 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 Acknowl-
                               edgement timer.




       tab() box;  cw(2.750000i)  sw(2.750000i)  lw(2.750000i)  cw(2.750000i).
       Table  1:  LLC2  States  STATION ~~DOWN0x00 ~~UP0x01 SAP ~~INACTIVE0x00
       ~~ACTIVE0x01   CONNECTION   ~~ADM0x00    ~~CONN0x01    ~~RESET_WAIT0x02
       ~~RESET_CHECK0x03   ~~SETUP0x04  ~~RESET0x05  ~~D_CONN0x06  ~~ERROR0x07
       ~~NORMAL0x08  ~~BUSY0x09  ~~REJECT0x0a   ~~AWAIT0x0b   ~~AWAIT_BUSY0x0c
       ~~AWAIT_REJECT0x0d



       tab()  box;  cw(2.750000i)  sw(2.750000i)  lw(2.750000i) cw(2.750000i).
       Table  2:  timersOn  Acknowledgement0x80  Poll0x40  Reject0x20   Remove
       Busy0x10 Inactivity0x08 Send Acknowledgement0x04



       tab()  box;  cw(2.750000i)  sw(2.750000i)  lw(2.750000i) cw(2.750000i).
       Table 3: LLC2 Flags P_FLAG0x80  F_FLAG0x40  S_FLAG0x20  REMOTE_BUSY0x10
       RESEND_PENDING0x08


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


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWllc


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 document, ISO 8802-2: 1994,
       Section 7.



SunOS 5.10                        18 May 1999                    llc2_stats(1)