skrlmt.h
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:16k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. /******************************************************************************
  2.  *
  3.  * Name: skrlmt.h
  4.  * Project: GEnesis, PCI Gigabit Ethernet Adapter
  5.  * Version: $Revision: 1.32 $
  6.  * Date: $Date: 2001/02/14 14:06:31 $
  7.  * Purpose: Header file for Redundant Link ManagemenT.
  8.  *
  9.  ******************************************************************************/
  10. /******************************************************************************
  11.  *
  12.  * (C)Copyright 1998-2001 SysKonnect GmbH.
  13.  *
  14.  * This program is free software; you can redistribute it and/or modify
  15.  * it under the terms of the GNU General Public License as published by
  16.  * the Free Software Foundation; either version 2 of the License, or
  17.  * (at your option) any later version.
  18.  *
  19.  * The information in this file is provided "AS IS" without warranty.
  20.  *
  21.  ******************************************************************************/
  22. /******************************************************************************
  23.  *
  24.  * History:
  25.  *
  26.  * $Log: skrlmt.h,v $
  27.  * Revision 1.32  2001/02/14 14:06:31  rassmann
  28.  * Editorial changes.
  29.  *
  30.  * Revision 1.31  2001/02/05 14:25:26  rassmann
  31.  * Prepared RLMT for transparent operation.
  32.  *
  33.  * Revision 1.30  2001/01/22 13:41:39  rassmann
  34.  * Supporting two nets on dual-port adapters.
  35.  *
  36.  * Revision 1.29  2000/11/17 08:58:00  rassmann
  37.  * Moved CheckSwitch from SK_RLMT_PACKET_RECEIVED to SK_RLMT_TIM event.
  38.  *
  39.  * Revision 1.28  2000/11/09 12:24:34  rassmann
  40.  * Editorial changes.
  41.  *
  42.  * Revision 1.27  1999/11/22 13:59:56  cgoos
  43.  * Changed license header to GPL.
  44.  *
  45.  * Revision 1.26  1999/10/04 14:01:19  rassmann
  46.  * Corrected reaction to reception of BPDU frames (#10441).
  47.  *
  48.  * Revision 1.25  1999/07/20 12:53:39  rassmann
  49.  * Fixed documentation errors for lookahead macros.
  50.  *
  51.  * Revision 1.24  1999/05/28 11:15:56  rassmann
  52.  * Changed behaviour to reflect Design Spec v1.2.
  53.  * Controlling Link LED(s).
  54.  * Introduced RLMT Packet Version field in RLMT Packet.
  55.  * Newstyle lookahead macros (checking meta-information before looking at
  56.  *   the packet).
  57.  *
  58.  * Revision 1.23  1999/01/28 12:50:42  rassmann
  59.  * Not using broadcast time stamps in CheckLinkState mode.
  60.  *
  61.  * Revision 1.22  1999/01/27 14:13:04  rassmann
  62.  * Monitoring broadcast traffic.
  63.  * Switching more reliably and not too early if switch is
  64.  *  configured for spanning tree.
  65.  *
  66.  * Revision 1.21  1998/12/08 13:11:25  rassmann
  67.  * Stopping SegTimer at RlmtStop.
  68.  *
  69.  * Revision 1.20  1998/11/24 12:37:33  rassmann
  70.  * Implemented segmentation check.
  71.  *
  72.  * Revision 1.19  1998/11/17 13:43:06  rassmann
  73.  * Handling (logical) tx failure.
  74.  * Sending packet on logical address after PORT_SWITCH.
  75.  *
  76.  * Revision 1.18  1998/11/13 16:56:56  rassmann
  77.  * Added macro version of SkRlmtLookaheadPacket.
  78.  *
  79.  * Revision 1.17  1998/11/06 18:06:05  rassmann
  80.  * Corrected timing when RLMT checks fail.
  81.  * Clearing tx counter earlier in periodical checks.
  82.  *
  83.  * Revision 1.16  1998/11/03 13:53:50  rassmann
  84.  * RLMT should switch now (at least in mode 3).
  85.  *
  86.  * Revision 1.15  1998/10/22 11:39:52  rassmann
  87.  * Corrected signed/unsigned mismatches.
  88.  * Corrected receive list handling and address recognition.
  89.  *
  90.  * Revision 1.14  1998/10/15 15:16:36  rassmann
  91.  * Finished Spanning Tree checking.
  92.  * Checked with lint.
  93.  *
  94.  * Revision 1.13  1998/09/24 19:16:08  rassmann
  95.  * Code cleanup.
  96.  * Introduced Timer for PORT_DOWN due to no RX.
  97.  *
  98.  * Revision 1.12  1998/09/16 11:09:52  rassmann
  99.  * Syntax corrections.
  100.  *
  101.  * Revision 1.11  1998/09/15 11:28:50  rassmann
  102.  * Syntax corrections.
  103.  *
  104.  * Revision 1.10  1998/09/14 17:07:38  rassmann
  105.  * Added code for port checking via LAN.
  106.  * Changed Mbuf definition.
  107.  *
  108.  * Revision 1.9  1998/09/07 11:14:15  rassmann
  109.  * Syntax corrections.
  110.  *
  111.  * Revision 1.8  1998/09/07 09:06:08  rassmann
  112.  * Syntax corrections.
  113.  *
  114.  * Revision 1.7  1998/09/04 19:41:34  rassmann
  115.  * Syntax corrections.
  116.  * Started entering code for checking local links.
  117.  *
  118.  * Revision 1.6  1998/09/04 12:14:28  rassmann
  119.  * Interface cleanup.
  120.  *
  121.  * Revision 1.5  1998/09/02 16:55:29  rassmann
  122.  * Updated to reflect new DRV/HWAC/RLMT interface.
  123.  *
  124.  * Revision 1.4  1998/09/02 07:26:02  afischer
  125.  * typedef for SK_RLMT_PORT
  126.  *
  127.  * Revision 1.3  1998/08/27 14:29:03  rassmann
  128.  * Code cleanup.
  129.  *
  130.  * Revision 1.2  1998/08/27 14:26:25  rassmann
  131.  * Updated interface.
  132.  *
  133.  * Revision 1.1  1998/08/21 08:29:10  rassmann
  134.  * First public version.
  135.  *
  136.  ******************************************************************************/
  137. /******************************************************************************
  138.  *
  139.  * Description:
  140.  *
  141.  * This is the header file for Redundant Link ManagemenT.
  142.  *
  143.  * Include File Hierarchy:
  144.  *
  145.  * "skdrv1st.h"
  146.  * ...
  147.  * "sktypes.h"
  148.  * "skqueue.h"
  149.  * "skaddr.h"
  150.  * "skrlmt.h"
  151.  * ...
  152.  * "skdrv2nd.h"
  153.  *
  154.  ******************************************************************************/
  155. #ifndef __INC_SKRLMT_H
  156. #define __INC_SKRLMT_H
  157. #ifdef __cplusplus
  158. #error C++ is not yet supported.
  159. extern "C" {
  160. #endif /* cplusplus */
  161. /* defines ********************************************************************/
  162. #define SK_RLMT_NET_DOWN_TEMP 1 /* NET_DOWN due to last port down. */
  163. #define SK_RLMT_NET_DOWN_FINAL 2 /* NET_DOWN due to RLMT_STOP. */
  164. /* ----- Default queue sizes - must be multiples of 8 KB ----- */
  165. /* Less than 8 KB free in RX queue => pause frames. */
  166. #define SK_RLMT_STANDBY_QRXSIZE 128 /* Size of rx standby queue in KB. */
  167. #define SK_RLMT_STANDBY_QXASIZE 32 /* Size of async standby queue in KB. */
  168. #define SK_RLMT_STANDBY_QXSSIZE 0 /* Size of sync standby queue in KB. */
  169. #define SK_RLMT_MAX_TX_BUF_SIZE 60 /* Maximum RLMT transmit size. */
  170. /* ----- PORT states ----- */
  171. #define SK_RLMT_PS_INIT 0 /* Port state: Init. */
  172. #define SK_RLMT_PS_LINK_DOWN 1 /* Port state: Link down. */
  173. #define SK_RLMT_PS_DOWN 2 /* Port state: Port down. */
  174. #define SK_RLMT_PS_GOING_UP 3 /* Port state: Going up. */
  175. #define SK_RLMT_PS_UP 4 /* Port state: Up. */
  176. /* ----- RLMT states ----- */
  177. #define SK_RLMT_RS_INIT 0 /* RLMT state: Init. */
  178. #define SK_RLMT_RS_NET_DOWN 1 /* RLMT state: Net down. */
  179. #define SK_RLMT_RS_NET_UP 2 /* RLMT state: Net up. */
  180. /* ----- PORT events ----- */
  181. #define SK_RLMT_LINK_UP 1001 /* Link came up. */
  182. #define SK_RLMT_LINK_DOWN 1002 /* Link went down. */
  183. #define SK_RLMT_PORT_ADDR 1003 /* Port address changed. */
  184. /* ----- RLMT events ----- */
  185. #define SK_RLMT_START 2001 /* Start RLMT. */
  186. #define SK_RLMT_STOP 2002 /* Stop RLMT. */
  187. #define SK_RLMT_PACKET_RECEIVED 2003 /* Packet was received for RLMT. */
  188. #define SK_RLMT_STATS_CLEAR 2004 /* Clear statistics. */
  189. #define SK_RLMT_STATS_UPDATE 2005 /* Update statistics. */
  190. #define SK_RLMT_PREFPORT_CHANGE 2006 /* Change preferred port. */
  191. #define SK_RLMT_MODE_CHANGE 2007 /* New RlmtMode. */
  192. #define SK_RLMT_SET_NETS 2008 /* Number of Nets (1 or 2). */
  193. /* ----- RLMT mode bits ----- */
  194. /*
  195.  * CAUTION: These defines are private to RLMT.
  196.  * Please use the RLMT mode defines below.
  197.  */
  198. #define SK_RLMT_CHECK_LINK   1 /* Check Link. */
  199. #define SK_RLMT_CHECK_LOC_LINK   2 /* Check other link on same adapter. */
  200. #define SK_RLMT_CHECK_SEG   4 /* Check segmentation. */
  201. #ifndef RLMT_CHECK_REMOTE
  202. #define SK_RLMT_CHECK_OTHERS SK_RLMT_CHECK_LOC_LINK
  203. #else /* RLMT_CHECK_REMOTE */
  204. #define SK_RLMT_CHECK_REM_LINK   8 /* Check link(s) on other adapter(s). */
  205. #define SK_RLMT_MAX_REMOTE_PORTS_CHECKED 3
  206. #define SK_RLMT_CHECK_OTHERS
  207. (SK_RLMT_CHECK_LOC_LINK | SK_RLMT_CHECK_REM_LINK)
  208. #endif /* RLMT_CHECK_REMOTE */
  209. #ifndef SK_RLMT_ENABLE_TRANSPARENT
  210. #define SK_RLMT_TRANSPARENT   0 /* RLMT transparent - inactive. */
  211. #else /* SK_RLMT_ENABLE_TRANSPARENT */
  212. #define SK_RLMT_TRANSPARENT 128 /* RLMT transparent. */
  213. #endif /* SK_RLMT_ENABLE_TRANSPARENT */
  214. /* ----- RLMT modes ----- */
  215. /* Check Link State. */
  216. #define SK_RLMT_MODE_CLS (SK_RLMT_CHECK_LINK)
  217. /* Check Local Ports: check other links on the same adapter. */
  218. #define SK_RLMT_MODE_CLP (SK_RLMT_CHECK_LINK | SK_RLMT_CHECK_LOC_LINK)
  219. /* Check Local Ports and Segmentation Status. */
  220. #define SK_RLMT_MODE_CLPSS
  221. (SK_RLMT_CHECK_LINK | SK_RLMT_CHECK_LOC_LINK | SK_RLMT_CHECK_SEG)
  222. #ifdef RLMT_CHECK_REMOTE
  223. /* Check Local and Remote Ports: check links (local or remote). */
  224. Name of define TBD!
  225. #define SK_RLMT_MODE_CRP
  226. (SK_RLMT_CHECK_LINK | SK_RLMT_CHECK_LOC_LINK | SK_RLMT_CHECK_REM_LINK)
  227. /* Check Local and Remote Ports and Segmentation Status. */
  228. Name of define TBD!
  229. #define SK_RLMT_MODE_CRPSS
  230. (SK_RLMT_CHECK_LINK | SK_RLMT_CHECK_LOC_LINK | 
  231. SK_RLMT_CHECK_REM_LINK | SK_RLMT_CHECK_SEG)
  232. #endif /* RLMT_CHECK_REMOTE */
  233. /* ----- RLMT lookahead result bits ----- */
  234. #define SK_RLMT_RX_RLMT 1 /* Give packet to RLMT. */
  235. #define SK_RLMT_RX_PROTOCOL 2 /* Give packet to protocol. */
  236. /* Macros */
  237. #if 0
  238. SK_AC *pAC /* adapter context */
  239. SK_U32 PortNum /* receiving port */
  240. unsigned PktLen /* received packet's length */
  241. SK_BOOL IsBc /* Flag: packet is broadcast */
  242. unsigned *pOffset /* offs. of bytes to present to SK_RLMT_LOOKAHEAD */
  243. unsigned *pNumBytes /* #Bytes to present to SK_RLMT_LOOKAHEAD */
  244. #endif /* 0 */
  245. #define SK_RLMT_PRE_LOOKAHEAD(pAC,PortNum,PktLen,IsBc,pOffset,pNumBytes) { 
  246. SK_AC *_pAC; 
  247. SK_U32 _PortNum; 
  248. _pAC = (pAC); 
  249. _PortNum = (SK_U32)(PortNum); 
  250. /* _pAC->Rlmt.Port[_PortNum].PacketsRx++; */ 
  251. _pAC->Rlmt.Port[_PortNum].PacketsPerTimeSlot++; 
  252. if ((_pAC->Rlmt.Port[_PortNum].Net->RlmtMode & SK_RLMT_TRANSPARENT) != 0) { 
  253. *(pNumBytes) = 0; 
  254. else if (IsBc) { 
  255. if (_pAC->Rlmt.Port[_PortNum].Net->RlmtMode != SK_RLMT_MODE_CLS) { 
  256. *(pNumBytes) = 6; 
  257. *(pOffset) = 6; 
  258. else { 
  259. *(pNumBytes) = 0; 
  260. else { 
  261. if ((PktLen) > SK_RLMT_MAX_TX_BUF_SIZE) { 
  262. /* _pAC->Rlmt.Port[_PortNum].DataPacketsPerTimeSlot++; */ 
  263. *(pNumBytes) = 0; 
  264. else { 
  265. *(pNumBytes) = 6; 
  266. *(pOffset) = 0; 
  267. }
  268. #if 0
  269. SK_AC *pAC /* adapter context */
  270. SK_U32 PortNum /* receiving port */
  271. SK_U8 *pLaPacket, /* received packet's data (points to pOffset) */
  272. SK_BOOL IsBc /* Flag: packet is broadcast */
  273. SK_BOOL IsMc /* Flag: packet is multicast */
  274. unsigned *pForRlmt /* Result: bits SK_RLMT_RX_RLMT, SK_RLMT_RX_PROTOCOL */
  275. SK_RLMT_LOOKAHEAD() expects *pNumBytes from
  276. packet offset *pOffset (s.a.) at *pLaPacket.
  277. If you use SK_RLMT_LOOKAHEAD in a path where you already know if the packet is
  278. BC, MC, or UC, you should use constants for IsBc and IsMc, so that your compiler
  279. can trash unneeded parts of the if construction.
  280. #endif /* 0 */
  281. #define SK_RLMT_LOOKAHEAD(pAC,PortNum,pLaPacket,IsBc,IsMc,pForRlmt) { 
  282. SK_AC *_pAC; 
  283. SK_U32 _PortNum; 
  284. SK_U8 *_pLaPacket; 
  285. _pAC = (pAC); 
  286. _PortNum = (SK_U32)(PortNum); 
  287. _pLaPacket = (SK_U8 *)(pLaPacket); 
  288. if (IsBc) {
  289. if (!SK_ADDR_EQUAL(_pLaPacket, _pAC->Addr.Net[_pAC->Rlmt.Port[ 
  290. _PortNum].Net->NetNumber].CurrentMacAddress.a)) { 
  291. _pAC->Rlmt.Port[_PortNum].BcTimeStamp = SkOsGetTime(_pAC); 
  292. _pAC->Rlmt.CheckSwitch = SK_TRUE; 
  293. /* _pAC->Rlmt.Port[_PortNum].DataPacketsPerTimeSlot++; */ 
  294. *(pForRlmt) = SK_RLMT_RX_PROTOCOL; 
  295. else if (IsMc) { 
  296. if (SK_ADDR_EQUAL(_pLaPacket, BridgeMcAddr.a)) { 
  297. _pAC->Rlmt.Port[_PortNum].BpduPacketsPerTimeSlot++; 
  298. if (_pAC->Rlmt.Port[_PortNum].Net->RlmtMode & SK_RLMT_CHECK_SEG) { 
  299. *(pForRlmt) = SK_RLMT_RX_RLMT | SK_RLMT_RX_PROTOCOL; 
  300. else { 
  301. *(pForRlmt) = SK_RLMT_RX_PROTOCOL; 
  302. else if (SK_ADDR_EQUAL(_pLaPacket, SkRlmtMcAddr.a)) { 
  303. *(pForRlmt) = SK_RLMT_RX_RLMT; 
  304. else { 
  305. /* _pAC->Rlmt.Port[_PortNum].DataPacketsPerTimeSlot++; */ 
  306. *(pForRlmt) = SK_RLMT_RX_PROTOCOL; 
  307. else { 
  308. if (SK_ADDR_EQUAL( 
  309. _pLaPacket, 
  310. _pAC->Addr.Port[_PortNum].CurrentMacAddress.a)) { 
  311. *(pForRlmt) = SK_RLMT_RX_RLMT; 
  312. else { 
  313. /* _pAC->Rlmt.Port[_PortNum].DataPacketsPerTimeSlot++; */ 
  314. *(pForRlmt) = SK_RLMT_RX_PROTOCOL; 
  315. }
  316. #ifdef SK_RLMT_FAST_LOOKAHEAD
  317. Error: SK_RLMT_FAST_LOOKAHEAD no longer used. Use new macros for lookahead.
  318. #endif /* SK_RLMT_FAST_LOOKAHEAD */
  319. #ifdef SK_RLMT_SLOW_LOOKAHEAD
  320. Error: SK_RLMT_SLOW_LOOKAHEAD no longer used. Use new macros for lookahead.
  321. #endif /* SK_RLMT_SLOW_LOOKAHEAD */
  322. /* typedefs *******************************************************************/
  323. #ifdef SK_RLMT_MBUF_PRIVATE
  324. typedef struct s_RlmtMbuf {
  325. some content
  326. } SK_RLMT_MBUF;
  327. #endif /* SK_RLMT_MBUF_PRIVATE */
  328. #ifdef SK_LA_INFO
  329. typedef struct s_Rlmt_PacketInfo {
  330. unsigned PacketLength; /* Length of packet. */
  331. unsigned PacketType; /* Directed/Multicast/Broadcast. */
  332. } SK_RLMT_PINFO;
  333. #endif /* SK_LA_INFO */
  334. typedef struct s_RootId {
  335. SK_U8 Id[8]; /* Root Bridge Id. */
  336. } SK_RLMT_ROOT_ID;
  337. typedef struct s_port {
  338. SK_MAC_ADDR CheckAddr;
  339. SK_BOOL SuspectTx;
  340. } SK_PORT_CHECK;
  341. typedef struct s_RlmtNet SK_RLMT_NET;
  342. typedef struct s_RlmtPort {
  343. /* ----- Public part (read-only) ----- */
  344. SK_U8 PortState; /* Current state of this port. */
  345. /* For PNMI */
  346. SK_BOOL LinkDown;
  347. SK_BOOL PortDown;
  348. SK_U8 Align01;
  349. SK_U32 PortNumber; /* Number of port on adapter. */
  350. SK_RLMT_NET * Net; /* Net port belongs to. */
  351. SK_U64 TxHelloCts;
  352. SK_U64 RxHelloCts;
  353. SK_U64 TxSpHelloReqCts;
  354. SK_U64 RxSpHelloCts;
  355. /* ----- Private part ----- */
  356. /* SK_U64 PacketsRx; */ /* Total packets received. */
  357. SK_U32 PacketsPerTimeSlot; /* Packets rxed between TOs. */
  358. /* SK_U32 DataPacketsPerTimeSlot; */ /* Data packets ... */
  359. SK_U32 BpduPacketsPerTimeSlot; /* BPDU packets rxed in TS. */
  360. SK_U64 BcTimeStamp; /* Time of last BC receive. */
  361. SK_U64 GuTimeStamp; /* Time of entering GOING_UP. */
  362. SK_TIMER UpTimer; /* Timer struct Link/Port up. */
  363. SK_TIMER DownRxTimer; /* Timer struct down rx. */
  364. SK_TIMER DownTxTimer; /* Timer struct down tx. */
  365. SK_U32 CheckingState; /* Checking State. */
  366. SK_ADDR_PORT * AddrPort;
  367. SK_U8 Random[4]; /* Random value. */
  368. unsigned PortsChecked; /* #ports checked. */
  369. unsigned PortsSuspect; /* #ports checked that are s. */
  370. SK_PORT_CHECK PortCheck[1];
  371. /* SK_PORT_CHECK PortCheck[SK_MAX_MACS - 1]; */
  372. SK_BOOL PortStarted; /* Port is started. */
  373. SK_BOOL PortNoRx; /* NoRx for >= 1 time slot. */
  374. SK_BOOL RootIdSet;
  375. SK_RLMT_ROOT_ID Root; /* Root Bridge Id. */
  376. } SK_RLMT_PORT;
  377. struct s_RlmtNet {
  378. /* ----- Public part (read-only) ----- */
  379. SK_U32 NetNumber; /* Number of net. */
  380. SK_RLMT_PORT * Port[SK_MAX_MACS]; /* Ports that belong to this net. */
  381. SK_U32 NumPorts; /* Number of ports. */
  382. SK_U32 PrefPort; /* Preferred port. */
  383. /* For PNMI */
  384. SK_U32 RlmtMode; /* Check ... */
  385. SK_U32 ActivePort; /* Active port. */
  386. SK_U32 Preference; /* 0xFFFFFFFF: Automatic. */
  387. SK_U8 RlmtState; /* Current RLMT state. */
  388. /* ----- Private part ----- */
  389. SK_BOOL RootIdSet;
  390. SK_U16 Align01;
  391. int LinksUp; /* #Links up. */
  392. int PortsUp; /* #Ports up. */
  393. SK_U32 TimeoutValue; /* RLMT timeout value. */
  394. SK_U32 CheckingState; /* Checking State. */
  395. SK_RLMT_ROOT_ID Root; /* Root Bridge Id. */
  396. SK_TIMER LocTimer; /* Timer struct. */
  397. SK_TIMER SegTimer; /* Timer struct. */
  398. };
  399. typedef struct s_Rlmt {
  400. /* ----- Public part (read-only) ----- */
  401. SK_U32 NumNets; /* Number of nets. */
  402. SK_U32 NetsStarted; /* Number of nets started. */
  403. SK_RLMT_NET Net[SK_MAX_NETS]; /* Array of available nets. */
  404. SK_RLMT_PORT Port[SK_MAX_MACS]; /* Array of available ports. */
  405. /* ----- Private part ----- */
  406. SK_BOOL CheckSwitch;
  407. SK_U8 Align01;
  408. SK_U16 Align02;
  409. } SK_RLMT;
  410. extern SK_MAC_ADDR BridgeMcAddr;
  411. extern SK_MAC_ADDR SkRlmtMcAddr;
  412. /* function prototypes ********************************************************/
  413. #ifndef SK_KR_PROTO
  414. /* Functions provided by SkRlmt */
  415. /* ANSI/C++ compliant function prototypes */
  416. extern void SkRlmtInit(
  417. SK_AC *pAC,
  418. SK_IOC IoC,
  419. int Level);
  420. extern int SkRlmtEvent(
  421. SK_AC *pAC,
  422. SK_IOC IoC,
  423. SK_U32 Event,
  424. SK_EVPARA Para);
  425. #else /* defined(SK_KR_PROTO) */
  426. /* Non-ANSI/C++ compliant function prototypes */
  427. #error KR-style function prototypes are not yet provided.
  428. #endif /* defined(SK_KR_PROTO)) */
  429. #ifdef __cplusplus
  430. }
  431. #endif /* __cplusplus */
  432. #endif /* __INC_SKRLMT_H */