Open Ethernet Networking (OpEN) API Guide and Reference Manual  3.11.1.2
Macros | Functions
This Code Implements The OpEN APIs For GARP [OPENAPI_GARP]

Macros

#define OPEN_GARP_DEF_JOIN_TIME   20 /* centiseconds */
 
#define OPEN_GARP_DEF_LEAVE_ALL_TIME   1000 /* centiseconds */
 
#define OPEN_GARP_DEF_LEAVE_TIME   60 /* centiseconds */
 
#define OPEN_GARP_MAX_JOIN_TIME   100 /* centiseconds */
 
#define OPEN_GARP_MAX_LEAVE_ALL_TIME   6000 /* centiseconds */
 
#define OPEN_GARP_MAX_LEAVE_TIME   600 /* centiseconds */
 
#define OPEN_GARP_MIN_JOIN_TIME   10 /* centiseconds */
 
#define OPEN_GARP_MIN_LEAVE_ALL_TIME   200 /* centiseconds */
 
#define OPEN_GARP_MIN_LEAVE_TIME   20 /* centiseconds */
 

Functions

open_error_t openapiGarpGmrpEnableGet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t *globalGmrpStatus)
 Get the GMRP global status. More...
 
open_error_t openapiGarpGmrpEnableSet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t globalGmrpStatus)
 Set the GMRP global status. More...
 
open_error_t openapiGarpGmrpPortEnableGet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_CONTROL_t *intfGmrpStatus)
 Get the GMRP interface status. More...
 
open_error_t openapiGarpGmrpPortEnableSet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_CONTROL_t intfGmrpStatus)
 Set the GMRP interface status. More...
 
open_error_t openapiGarpGvrpEnableGet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t *globalGvrpStatus)
 Get the GVRP global status. More...
 
open_error_t openapiGarpGvrpEnableSet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t globalGvrpStatus)
 Set the GVRP global status. More...
 
open_error_t openapiGarpGvrpPortEnableGet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_CONTROL_t *intfGvrpStatus)
 Get the GVRP interface status. More...
 
open_error_t openapiGarpGvrpPortEnableSet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_CONTROL_t intfGvrpStatus)
 Set the GVRP interface status. More...
 
open_error_t openapiGarpJoinTimeGet (openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *joinTime)
 Get the GARP Join Time. More...
 
open_error_t openapiGarpJoinTimeSet (openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t joinTime)
 Set the GARP Join Time. More...
 
open_error_t openapiGarpLeaveAllTimeGet (openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *leaveAllTime)
 Get the GARP Leave All Time. More...
 
open_error_t openapiGarpLeaveAllTimeSet (openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t leaveAllTime)
 Set the GARP Leave All Time. More...
 
open_error_t openapiGarpLeaveTimeGet (openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *leaveTime)
 Get the GARP Leave Time. More...
 
open_error_t openapiGarpLeaveTimeSet (openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t leaveTime)
 Set the GARP Leave Time. More...
 

Detailed Description

Function Documentation

open_error_t openapiGarpGmrpEnableGet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t globalGmrpStatus 
)

Get the GMRP global status.

Parameters
[in]client_handleclient handle from registration API
[out]globalGmrpStatusGMRP global status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpGmrpEnableSet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t  globalGmrpStatus 
)

Set the GMRP global status.

Parameters
[in]client_handleclient handle from registration API
[in]globalGmrpStatusGMRP global status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.
Note
Calling this API will change the running configuration of the switch

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpGmrpPortEnableGet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
OPEN_CONTROL_t intfGmrpStatus 
)

Get the GMRP interface status.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[out]intfGmrpStatusGMRP interface status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpGmrpPortEnableSet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
OPEN_CONTROL_t  intfGmrpStatus 
)

Set the GMRP interface status.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[in]intfGmrpStatusGVRP interface status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.
Note
Calling this API will change the running configuration of the switch

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpGvrpEnableGet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t globalGvrpStatus 
)

Get the GVRP global status.

Parameters
[in]client_handleclient handle from registration API
[out]globalGvrpStatusGVRP global status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpGvrpEnableSet ( openapiClientHandle_t client_handle,
OPEN_CONTROL_t  globalGvrpStatus 
)

Set the GVRP global status.

Parameters
[in]client_handleclient handle from registration API
[in]globalGvrpStatusGVRP global status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.
Note
Calling this API will change the running configuration of the switch

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpGvrpPortEnableGet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
OPEN_CONTROL_t intfGvrpStatus 
)

Get the GVRP interface status.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[out]intfGvrpStatusGVRP interface status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpGvrpPortEnableSet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
OPEN_CONTROL_t  intfGvrpStatus 
)

Set the GVRP interface status.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[in]intfGvrpStatusGVRP interface status.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.
Note
Calling this API will change the running configuration of the switch

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpJoinTimeGet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
uint32_t *  joinTime 
)

Get the GARP Join Time.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[out]joinTimeGARP join time in centiseconds.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpJoinTimeSet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
uint32_t  joinTime 
)

Set the GARP Join Time.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[in]joinTimeGARP join time in centiseconds.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.
Note
Calling this API will change the running configuration of the switch
Refer OPEN_GARP_MIN_JOIN_TIME and OPEN_GARP_MAX_JOIN_TIME for minimum and maximum values.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpLeaveAllTimeGet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
uint32_t *  leaveAllTime 
)

Get the GARP Leave All Time.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[out]leaveAllTimeGARP leave All time in centiseconds.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpLeaveAllTimeSet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
uint32_t  leaveAllTime 
)

Set the GARP Leave All Time.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[in]leaveAllTimeGARP leave All time in centiseconds.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.
Note
Calling this API will change the running configuration of the switch
Refer OPEN_GARP_MIN_LEAVE_ALL_TIME and OPEN_GARP_MAX_LEAVE_ALL_TIME for minimum and maximum values.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpLeaveTimeGet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
uint32_t *  leaveTime 
)

Get the GARP Leave Time.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[out]leaveTimeGARP leave time in centiseconds.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.

OpEN API Version: 1.25

Examples:
garp_example.c.
open_error_t openapiGarpLeaveTimeSet ( openapiClientHandle_t client_handle,
uint32_t  ifNum,
uint32_t  leaveTime 
)

Set the GARP Leave Time.

Parameters
[in]client_handleclient handle from registration API
[in]ifNuminterface
[in]leaveTimeGARP leave time in centiseconds.
Return values
OPEN_E_NONEOn success.
OPEN_E_FAILOn failure.
OPEN_E_PARAMInvalid argument.
OPEN_E_UNAVAILFeature not available.
Note
Calling this API will change the running configuration of the switch
Refer OPEN_GARP_MIN_LEAVE_TIME and OPEN_GARP_MAX_LEAVE_TIME for minimum and maximum values.

OpEN API Version: 1.25

Examples:
garp_example.c.