Devices llc2(7D)
NAME
llc2 - Class II logical link control driver
DESCRIPTION
The llc2 logical link control driver interfaces network
software (NetBIOS, SNA, OSI, and so on) running under theSolaris operating environment to a physical LAN network con-
trolled by one of the supported communications adapters. Thellc2 driver, which appears as a STREAMS driver to the net-
work software, resides in the kernel and is accessed by standard UNIX STREAMS functions.This version of the llc2 driver includes support for both
connectionless and connection-oriented logical link control
class II (llc2) operations for Ethernet, Token Ring, and
FDDI adapters when accessed through the appropriate Solaris MAC layer driver. The Data Link Provider Interface (DLPI) tothe llc2 driver enables multiple and different protocol
stacks, (including NetBIOS and SNA), to operate simultane-
ously over one or more local area networks.To start the llc2 driver by default, rename file
/etc/llc2/llc2_start.default to /etc/llc2/llc2_start. This
allows the /etc/rc2.d/S40llc2 script to build up the confi-
guration file for each ppa interface in/etc/llc2/default/llc2.* and start llc2 on each interface.
To verify the configuration files, manually run/usr/lib/llc2/llc2_autoconfig.
For more information on the llc2 driver, see the IEEE stan-
dard 802.2 Logical Link Control. OBTAINING LLC2 STATISTICS You can obtain LLC2 statistics or reset the statisticscounter to zero using the ILD_LLC2 ioctl. The ILD_LLC2 ioctl
has a number of subcommands. The following retrieve LLC2 statistics: Name | Function_________________________|________________________________
LLC2_GET_STA_STATS | Get station statistics
LLC2_GET_SAP_STATS | Get SAP statistics
LLC2_GET_CON_STATS | Get connection statistics
SunOS 5.11 Last change: 12 Aug 1999 1
Devices llc2(7D)
The structure used depends on the subcommand sent.LLC2_GET_STA_ STATS
The LLC2_GET_STA_STATS command retrieves statistics on a
particular Physical Point of Attachment (PPA).When sending the LLC2_GET_STA_STATS command, the
llc2GetStaStats structure is used:
typedef struct llc2GetStaStats {
uint_t ppa;
uint_t cmd;
uchar_t clearFlag;
uchar_t state;
ushort_t numSaps;
uchar_t saps[LLC2_MAX_SAPS];
uint_t nullSapXidCmdRcvd;
uint_t nullSapXidRspSent;
uint_t nullSapTestCmdRcvd;
uint_t nullSapTestRspSent;
uint_t outOfState;
uint_t allocFail;
uint_t protocolError;
} llc2GetStaStats_t;
The members of the structure are: Member | Description_______________________|_________________________________________
cmd | LLC2_GET_STA_STATS
clearFlag | Clear counters flag. Set this to 0 to | retreive statistics and to 1 to reset | all counters to 0. state | Station component state. Possible values | are ????? numSaps | Number of active SAPs in the saps array saps | An array of active SAP values nullSapXidCmdRcvd | Number of NULL SAP XID commands received nullSapXidRspSent | Number of NULL SAP XID responses sent nullSapTestCmdRcvd | Number of NULL SAP TEST commands | received nullSapTestRspSent | Number of NULL SAP TEST responses sent outOfState | Number of invalid events received allocFail | Number of buffer allocation failures protocolError | Number of protocol errorsSunOS 5.11 Last change: 12 Aug 1999 2
Devices llc2(7D)
LLC2_GET_SAP_ STATS
The LLC2_GET_SAP_STATS command retrieves statistics related
to a particular SAP. When sending the LLC2_GET_SAP_STATS
command, the llc2GetSapStats structure is used:
typedef struct llc2GetSapStats {
uint_t ppa;
uint_t cmd;
uchar_t sap;
uchar_t clearFlag;
uchar_t state;
uint_t numCons;
ushort_t cons[LLC2_MAX_CONS];
uint_t xidCmdSent;
uint_t xidCmdRcvd;
uint_t xidRspSent;
uint_t xidRspRcvd;
uint_t testCmdSent;
uint_t testCmdRcvd;
uint_t testRspSent;
uint_t testRspRcvd;
uint_t uiSent;
uint_t uiRcvd;
uint_t outOfState;
uint_t allocFail;
uint_t protocolError;
} llc2GetSapStats_t;
The members are: Member Description__________________________________________________________
ppa Physical Point of Attachment numbercmd LLC2_GET_SAP_STATS
sap SAP value clearFlag Clear counters flag. Set this to 0 to retreive statistics and to 1 to reset all counters to 0. state SAP component state numCons Number of active connections in the cons array cons Array of active connection indexes xidCmdSent Number of XID commands sent xidCmdRcvd Number of XID responses received xidRspSent Number of XID responses sent xidRspRcvd Number of XID responses received testCmdSent Number of TEST commands sent testCmdRcvd Number of TEST commands receivedSunOS 5.11 Last change: 12 Aug 1999 3
Devices llc2(7D)
testRspSent Number of TEST responses sent testRspRcvd Number of TEST responses received uiSent Number of UI frames sent uiRcvd Number of UI frames received outOfState Number of invalid events received allocFail Number of buffer allocation failures protocolError Number of protocol errors | |LLC2_GET_CON_STATS |
The LLC2_GET_CON|_STATS command retrieves statistics related
to a particul|ar connection component. When sending theLLC2_GET_CON_STA|TS command, the llc2GetConStats structure is
used: | |typedef struct|llc2GetConStats {
uint_t ppa; |
uint_t cmd; |
uchar_t sap; |
ushort_t con; |
uchar_t clearF|lag;
uchar_t stateO|ldest;
uchar_t stateO|lder;
uchar_t stateO|ld;
uchar_t state;|
ushort_t sid; |
dlsap_t rem; |
ushort_t flag;|
uchar_t dataFl|ag;
uchar_t k; |
uchar_t vs; |
uchar_t vr; |
uchar_t nrRcvd|;
ushort_t retry|Count;
uint_t numToBeAcked;
uint_t numToResend;
uint_t macOutSave;
uint_t macOutDump;
uchar_t timerOn;
uint_t iSent;
uint_t iRcvd;
uint_t frmrSent;
uint_t frmrRcvd;
uint_t rrSent;
uint_t rrRcvd;
uint_t rnrSent;
uint_t rnrRcvd;
uint_t rejSent;
uint_t rejRcvd;
uint_t sabmeSent;
uint_t sabmeRcvd;
uint_t uaSent;
SunOS 5.11 Last change: 12 Aug 1999 4
Devices llc2(7D)
uint_t uaRcvd;
uint_t discSent;
uint_t outOfState;
uint_t allocFail;
uint_t protocolError;
uint_t localBusy;
uint_t remoteBusy;
uint_t maxRetryFail;
uint_t ackTimerExp;
uint_t pollTimerExp;
uint_t rejTimerExp;
uint_t remBusyTimerExp;
uint_t inactTimerExp;
uint_t sendAckTimerExp;
} llc2GetConStats_t;
The members of the structure are: Member Description__________________________________________________________________________________
ppa Physical Point of Attachment numbercmd LLC2_GET_CON_STATS
sap SAP value con Connection index clearFlag Clear counters flag. Set this to 0 to retreive statistics and to 1 to reset all counters to 0. stateOldest, stateOlder, stateOld, state The four previous dlpi states of the connection sid SAP value and connection indexdlsap_t rem Structure containing the remote MAC
address and SAP flag Connection component processing flagdataFlag DATA_FLAG
k transmit window sizevs Sequence number of the next I-frame to
sendvr Sequence number of the next I-frame
expectednrRcvd Sequence number of the last I-frame
acknowledged by the remote node retryCount Number of timer expirationsnumToBeAcked Number of outbound I-frames to be ack-
nowledgednumToResend Number of outbound I-frames to be re-
sentSunOS 5.11 Last change: 12 Aug 1999 5
Devices llc2(7D)
macOutSave Number of outbound I-frames held by the
MAC driver to be saved on return to LLC2macOutDump Number of outbound I-frames held by the
MAC driver to be dumped on return to LLC2 timerOn Timer activity flagiSent Number of I-frames sent
iRcvd Number of I-frames received
frmrSent Number of frame rejects sent frmrRcvd Number of frame rejects received rrSent Number of RRs sent rrRcvd Number of RRs received rnrRcvd Number of RNRs received rejSent Number of rejects sent rejRcvd Number of rejects received sabmeSent Number of SABMEs sent sabmeRcvd Number of SABMEs received uaSent Number of UAs sent uaRcvd Number of UAs received discSent Number of DISCs sent outOfState Number of invalid events received allocFail | Number of buffer allocation failures protocolError | Number of protocol errors localBusy | Number of times in a local busy state remoteBusy | Number of times in a remote busy statemaxRetryFail | Number of failures due to reaching max-
| Retry ackTimerExp | Number of ack timer expirationspollTimerExp | Number of P-timer expirations
rejTimerExp | Number of reject timer expirations remBusyTimerExp | Number of remote busy timer expirations inactTimerExp | Number of inactivity timer expirations sendAckTimerExp | Number of send ack timer expirations | FILES/dev/llc2 Clone device used to access the driver
/etc/llc2/default/llc2.? configuration files
(One file per ppa interface.)ATTRIBUTES
See attributes(5) for a description of the following attri-
bute:SunOS 5.11 Last change: 12 Aug 1999 6
Devices llc2(7D)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | driver/network/llc2 |
|_____________________________|_____________________________|
SEE ALSO
llc2_autoconfig(1), llc2_config(1), llc2(4)
SunOS 5.11 Last change: 12 Aug 1999 7