Open Ethernet Networking (OpEN) API Guide and Reference Manual  3.4.4.5
openapi_dot1s.h
Go to the documentation of this file.
1 
9 /*********************************************************************
10 *
11 * Copyright 2016-2018 Broadcom.
12 *
13 * Licensed under the Apache License, Version 2.0 (the "License");
14 * you may not use this file except in compliance with the License.
15 * You may obtain a copy of the License at
16 *
17 * http://www.apache.org/licenses/LICENSE-2.0
18 *
19 * Unless required by applicable law or agreed to in writing, software
20 * distributed under the License is distributed on an "AS IS" BASIS,
21 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
22 * See the License for the specific language governing permissions and
23 * limitations under the License.
24 *
25 **********************************************************************
26 *
27 * @filename openapi_dot1s.h
28 *
29 * @purpose Spanning Tree Configuration and Status
30 *
31 * @component OPEN
32 *
33 * @create 10/25/2012
34 *
35 * @end
36 *
37 **********************************************************************/
38 #ifndef OPENAPI_DOT1S_H_INCLUDED
39 #define OPENAPI_DOT1S_H_INCLUDED
40 
41 #include "openapi_common.h"
42 
43 typedef enum
44 {
45  OPEN_DOT1S_FORCE_VERSION_DOT1D = 0,
46  OPEN_DOT1S_FORCE_VERSION_UNUSED = 1,
47  OPEN_DOT1S_FORCE_VERSION_DOT1W = 2,
48  OPEN_DOT1S_FORCE_VERSION_DOT1S = 3,
49  OPEN_DOT1S_FORCE_VERSION_LAST
50 }OPEN_DOT1S_FORCE_VERSION_t;
51 
52 typedef enum
53 {
54  OPEN_DOT1S_PORT_GUARD_LOOP = 0,
55  OPEN_DOT1S_PORT_GUARD_ROOT = 1,
56  OPEN_DOT1S_PORT_GUARD_NONE = 2
57 }OPEN_DOT1S_PORT_GUARD_t;
58 
59 typedef enum
60 {
61  OPEN_DOT1S_MGMT_STR_CONFIG_NAME = 0
62 }OPEN_DOT1S_MGMT_STR_t;
63 
64 typedef enum
65 {
66  OPEN_DOT1S_PORT_DISCARDING = 1,
67  OPEN_DOT1S_PORT_LEARNING = 2,
68  OPEN_DOT1S_PORT_FORWARDING = 3,
69  OPEN_DOT1S_PORT_DISABLED = 4,
70  OPEN_DOT1S_PORT_MANUAL_FWD = 5,
71  OPEN_DOT1S_PORT_NOT_PARTICIPATE = 6
72 }OPEN_DOT1S_PORT_FWD_STATE_t;
73 
74 typedef enum
75 {
76  OPEN_DOT1S_ROLE_DISABLED = 0,
77  OPEN_DOT1S_ROLE_ROOT = 1,
78  OPEN_DOT1S_ROLE_DESIGNATED = 2,
79  OPEN_DOT1S_ROLE_ALTERNATE = 3,
80  OPEN_DOT1S_ROLE_BACKUP = 4,
81  OPEN_DOT1S_ROLE_MASTER = 5
83 }OPEN_DOT1S_PORT_ROLE_t;
84 
85 #define OPENAPI_DOT1S_CST_ID 0
86 #define OPENAPI_DOT1S_MSTID_MAX 4094
87 
88 #define OPEN_DOT1S_VLAN_ID_LEN 2
89 #define OPEN_DOT1S_MAC_ID_LEN OPEN_MAC_ADDR_LEN
90 #define OPEN_DOT1S_VID_MAC_ADDR_LEN (OPEN_DOT1S_VLAN_ID_LEN + OPEN_DOT1S_MAC_ID_LEN)
91 
96 typedef struct
97 {
98  uint8_t octets[OPEN_DOT1S_VID_MAC_ADDR_LEN];
99 } OPEN_DOT1S_BRIDGEID_t;
100 
101 
102 /*****************************************************************/
118 open_error_t openapiDot1sMgmtStrLenGet(openapiClientHandle_t *client_handle,
119  OPEN_DOT1S_MGMT_STR_t strType,
120  uint32_t *strLen);
121 
122 /*****************************************************************/
135 open_error_t openapiDot1VlanMaxGet(openapiClientHandle_t *client_handle,
136  uint32_t *vlanMax);
137 
138 /*****************************************************************/
154 open_error_t openapiDot1SModeSet(openapiClientHandle_t *client_handle,
155  OPEN_CONTROL_t dot1sMode);
156 
157 /*****************************************************************/
172 open_error_t openapiDot1SModeGet(openapiClientHandle_t *client_handle,
173  OPEN_CONTROL_t *dot1sMode);
174 
175 /*****************************************************************/
192 open_error_t openapiDot1SIntfBPDUFilterModeSet(openapiClientHandle_t *client_handle,
193  uint32_t ifNum,
194  OPEN_CONTROL_t dot1sBPDUFilterMode);
195 
196 /*****************************************************************/
212 open_error_t openapiDot1SIntfBPDUFilterModeGet(openapiClientHandle_t *client_handle,
213  uint32_t ifNum,
214  OPEN_CONTROL_t *dot1sBPDUFilterMode);
215 
216 /*****************************************************************/
233 open_error_t openapiDot1SIntfBPDUFloodModeSet(openapiClientHandle_t *client_handle,
234  uint32_t ifNum,
235  OPEN_CONTROL_t dot1sBPDUFloodMode);
236 
237 /*****************************************************************/
253 open_error_t openapiDot1SIntfBPDUFloodModeGet(openapiClientHandle_t *client_handle,
254  uint32_t ifNum,
255  OPEN_CONTROL_t *dot1sBPDUFloodMode);
256 
257 /*****************************************************************/
272 open_error_t openapiDot1SBPDUGuardModeSet(openapiClientHandle_t *client_handle,
273  OPEN_CONTROL_t dot1sBPDUGuard);
274 
275 /*****************************************************************/
289 open_error_t openapiDot1SBPDUGuardModeGet(openapiClientHandle_t *client_handle,
290  OPEN_CONTROL_t *dot1sBPDUGuard);
291 
292 /*****************************************************************/
307 open_error_t openapiDot1SBPDUFilterModeSet(openapiClientHandle_t *client_handle,
308  OPEN_CONTROL_t dot1sBPDUFilter);
309 
310 /*****************************************************************/
324 open_error_t openapiDot1SBPDUFilterModeGet(openapiClientHandle_t *client_handle,
325  OPEN_CONTROL_t *dot1sBPDUFilter);
326 
327 /*****************************************************************/
345 open_error_t openapiDot1SConfigNameSet(openapiClientHandle_t *client_handle,
346  open_buffdesc *dot1sConfigName);
347 
348 /*****************************************************************/
364 open_error_t openapiDot1SConfigNameGet(openapiClientHandle_t *client_handle,
365  open_buffdesc *dot1sConfigName);
366 
367 /*****************************************************************/
384 open_error_t openapiDot1SConfigRevisionSet(openapiClientHandle_t *client_handle,
385  uint32_t dot1sConfigRev);
386 
387 /*****************************************************************/
401 open_error_t openapiDot1SConfigRevisionGet(openapiClientHandle_t *client_handle,
402  uint32_t *dot1sConfigRev);
403 
404 /*****************************************************************/
419 open_error_t openapiDot1SForceVersionSet(openapiClientHandle_t *client_handle,
420  OPEN_DOT1S_FORCE_VERSION_t dot1sForceVersion);
421 
422 /*****************************************************************/
436 open_error_t openapiDot1SForceVersionGet(openapiClientHandle_t *client_handle,
437  OPEN_DOT1S_FORCE_VERSION_t *dot1sForceVersion);
438 
439 /*****************************************************************/
455 open_error_t openapiDot1SIntfGuardModeSet(openapiClientHandle_t *client_handle, uint32_t ifNum,
456  OPEN_DOT1S_PORT_GUARD_t dot1sGuardMode);
457 
458 /*****************************************************************/
474 open_error_t openapiDot1SIntfGuardModeGet(openapiClientHandle_t *client_handle,
475  uint32_t ifNum,
476  OPEN_DOT1S_PORT_GUARD_t *dot1sGuardMode);
477 
478 /*****************************************************************/
496 open_error_t openapiDot1SMSTInstanceSet(openapiClientHandle_t *client_handle,
497  uint32_t dot1sMSTInstanceId,
498  OPEN_ACTION_t action);
499 
500 /*****************************************************************/
514 open_error_t openapiDot1SMSTInstanceFirstGet(openapiClientHandle_t *client_handle,
515  uint32_t *instanceId);
516 
517 /*****************************************************************/
532 open_error_t openapiDot1SMSTInstanceNextGet(openapiClientHandle_t *client_handle,
533  uint32_t currInstance,
534  uint32_t *nextInstance);
535 
536 /*****************************************************************/
556 open_error_t openapiDot1SMSTInstancePrioritySet(openapiClientHandle_t *client_handle,
557  uint32_t dot1sMSTInstance,
558  uint32_t priority);
559 
560 /*****************************************************************/
575 open_error_t openapiDot1SMSTInstancePriorityGet(openapiClientHandle_t *client_handle,
576  uint32_t dot1sMSTInstance,
577  uint16_t *priority);
578 
579 /*****************************************************************/
600 open_error_t openapiDot1SMSTInstanceVLANSet(openapiClientHandle_t *client_handle,
601  uint32_t dot1sMSTInstance,
602  uint32_t vlan,
603  OPEN_ACTION_t action);
604 /*****************************************************************/
619 open_error_t openapiDot1SMSTInstanceFirstVLANGet(openapiClientHandle_t *client_handle,
620  uint32_t dot1sInstance,
621  uint32_t *VLANId);
622 
623 /*****************************************************************/
639 open_error_t openapiDot1SMSTInstanceNextVLANGet(openapiClientHandle_t *client_handle,
640  uint32_t dot1sInstance,
641  uint32_t currVLANId, uint32_t *nextVLANId);
642 
643 /*****************************************************************/
658 open_error_t openapiDot1SMSTInstanceFirstFIdGet(openapiClientHandle_t *client_handle,
659  uint32_t dot1sInstance,
660  uint32_t *FId);
661 
662 /*****************************************************************/
678 open_error_t openapiDot1SMSTInstanceNextFIdGet(openapiClientHandle_t *client_handle,
679  uint32_t dot1sInstance,
680  uint32_t currFId, uint32_t *nextFId);
681 
682 /*************************************************************************/
701 open_error_t openapiDot1sMSTInstanceBridgeIdentifierGet(openapiClientHandle_t *client_handle,
702  uint32_t dot1sMSTInstance,
703  OPEN_DOT1S_BRIDGEID_t *id);
704 
705 /*************************************************************************/
724 open_error_t openapiDot1sMSTInstanceTimeSinceTopologyChangeGet(openapiClientHandle_t *client_handle,
725  uint32_t dot1sMSTInstance,
726  uint32_t *timeVal);
727 
728 /*************************************************************************/
747 open_error_t openapiDot1sMSTInstanceTopologyChangeCountGet(openapiClientHandle_t *client_handle,
748  uint32_t mstId,
749  uint32_t *count);
750 
751 /*************************************************************************/
771 open_error_t openapiDot1sMSTInstanceTopologyChangeStateGet(openapiClientHandle_t *client_handle,
772  uint32_t dot1sMSTInstance,
773  OPEN_BOOL_t *change);
774 
775 /*************************************************************************/
794 open_error_t openapiDot1sMSTInstanceDesignatedRootIDGet(openapiClientHandle_t *client_handle,
795  uint32_t dot1sMSTInstance,
796  OPEN_DOT1S_BRIDGEID_t *rootId);
797 
798 /*************************************************************************/
817 open_error_t openapiDot1sMSTInstanceRootPathCostGet(openapiClientHandle_t *client_handle,
818  uint32_t dot1sMSTInstance,
819  uint32_t *cost);
820 
821 /*************************************************************************/
840 open_error_t openapiDot1sMSTInstanceRootPortIDGet(openapiClientHandle_t *client_handle,
841  uint32_t dot1sMSTInstance,
842  uint32_t *port);
843 
844 /*************************************************************************/
858 open_error_t openapiDot1sCISTMaxAgeGet(openapiClientHandle_t *client_handle,
859  uint32_t *age);
860 
861 /*************************************************************************/
875 open_error_t openapiDot1sBridgeMaxHopGet(openapiClientHandle_t *client_handle,
876  uint32_t *count);
877 
878 /*************************************************************************/
892 open_error_t openapiDot1sBridgeTxHoldCountGet(openapiClientHandle_t *client_handle,
893  uint32_t *count);
894 
895 /*************************************************************************/
909 open_error_t openapiDot1sCISTRootFwdDelayGet(openapiClientHandle_t *client_handle,
910  uint32_t *delay);
911 
912 /*************************************************************************/
927 open_error_t openapiDot1sCISTHelloTimeGet(openapiClientHandle_t *client_handle,
928  uint32_t ifNum,
929  uint32_t *helloTime);
930 
931 /*************************************************************************/
945 open_error_t openapiDot1sCISTBridgeHoldTimeGet(openapiClientHandle_t *client_handle,
946  uint32_t *holdTime);
947 
948 /*************************************************************************/
962 open_error_t openapiDot1sCISTRegionalRootIDGet(openapiClientHandle_t *client_handle,
963  OPEN_DOT1S_BRIDGEID_t *rootId);
964 
965 /*************************************************************************/
979 open_error_t openapiDot1sCISTRegionalRootPathCostGet(openapiClientHandle_t *client_handle,
980  uint32_t *cost);
981 
982 /*****************************************************************/
998 open_error_t openapiDot1SIntfModeSet(openapiClientHandle_t *client_handle,
999  uint32_t ifNum,
1000  OPEN_CONTROL_t dot1sMode);
1001 
1002 /*****************************************************************/
1017 open_error_t openapiDot1SIntfModeGet(openapiClientHandle_t *client_handle,
1018  uint32_t ifNum,
1019  OPEN_CONTROL_t *dot1sMode);
1020 
1021 /*****************************************************************/
1037 open_error_t openapiDot1SIntfPortFwdStateGet(openapiClientHandle_t *client_handle,
1038  uint32_t ifNum,
1039  uint32_t dot1sInstance,
1040  OPEN_DOT1S_PORT_FWD_STATE_t *dot1sPortFwdState);
1041 
1042 /*****************************************************************/
1058 open_error_t openapiDot1SIntfPortRoleGet(openapiClientHandle_t *client_handle,
1059  uint32_t ifNum,
1060  uint32_t dot1sInstance,
1061  OPEN_DOT1S_PORT_ROLE_t *dot1sPortRole);
1062 
1063 /*****************************************************************/
1080 open_error_t openapiDot1SIntfPortLoopInconsistentStateGet(openapiClientHandle_t *client_handle,
1081  uint32_t ifNum,
1082  uint32_t dot1sInstance,
1083  OPEN_BOOL_t *loopInconsistentState);
1084 
1085 /*****************************************************************/
1101 open_error_t openapiDot1SIntfEdgePortModeSet(openapiClientHandle_t *client_handle,
1102  uint32_t ifNum,
1103  OPEN_CONTROL_t dot1sEdgePortMode);
1104 
1105 /*****************************************************************/
1122 open_error_t openapiDot1SIntfEdgePortModeGet(openapiClientHandle_t *client_handle,
1123  uint32_t ifNum,
1124  uint32_t *dot1sEdgePortMode);
1125 
1126 #endif /* OPENAPI_DOT1S_H_INCLUDED */
1127