DHCP Snooping API [OPENAPI_DHCP_SNOOPING]

Data Structures
struct	OPEN_DHCP_SNOOP_BINDING_s
struct	OPEN_DHCP_V6_SNOOP_BINDING_s

Macros
#define	OPEN_DS_BINDING_DYNAMIC   2
	Dynamic binding.
#define	OPEN_DS_BINDING_STATIC   1
	Static binding.
#define	OPEN_DS_BINDING_TENTATIVE   0
	DHCP snooping binding type. More...
#define	OPEN_DS_BURST_INTERVAL_DEFAULT   -1 /* No burst interval by default */
#define	OPEN_DS_BURST_INTERVAL_MAX   15
#define	OPEN_DS_BURST_INTERVAL_MIN   1
#define	OPEN_DS_CID_INTF_MISMATCH   2
#define	OPEN_DS_CID_MAC_VERIFY   1
	DHCP SNOOPING COUNTERS ID.
#define	OPEN_DS_CID_UNTRUSTED_SRVR_MSG   3
#define	OPEN_DS_DB_MAX_STORE_INTERVAL   86400
#define	OPEN_DS_DB_MIN_STORE_INTERVAL   15
#define	OPEN_DS_RATE_LIMIT_DEFAULT   -1 /* rate-limit disabled */
#define	OPEN_DS_RATE_LIMIT_MAX   300
#define	OPEN_DS_RATE_LIMIT_MIN   0
#define	OPEN_MAC_ADDR_LEN   6

Typedefs
typedef struct OPEN_DHCP_SNOOP_BINDING_s	OPEN_DHCP_SNOOP_BINDING_t
typedef struct OPEN_DHCP_V6_SNOOP_BINDING_s	OPEN_DHCP_V6_SNOOP_BINDING_t

Enumerations
enum	OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_t { OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_DROP = 0, OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_KEEP = 1, OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_UPDATE = 2 }
	DHCP L2 relay option 82 actions. More...

Functions
open_error_t	openapiDhcpSnoopingAdminModeGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, OPEN_CONTROL_t *adminMode)
	Gets the DHCP Snooping Admin mode. More...
open_error_t	openapiDhcpSnoopingDbFileNameGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, open_buffdesc *fileName)
	Get the remote DHCP snooping database file name. More...
open_error_t	openapiDhcpSnoopingDbFileNameMaxLengthGet (openapiClientHandle_t *client_handle, uint32_t *len)
	Get the remote DHCP snooping database file name max length. More...
open_error_t	openapiDhcpSnoopingDbIpAddressGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, open_inet_addr_t *addr)
	Get the remote DHCP snooping database IPv4 Address. More...
open_error_t	openapiDhcpSnoopingDbWriteDelayGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t *delay)
	Get the DHCP snooping database write delay. More...
open_error_t	openapiDhcpSnoopingEnabledVlanRangeNextGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t *vlanStart, uint32_t *vlanEnd)
	Given a VLAN ID, return the endpoints of the next range of VLANs enabled for DHCP snooping. More...
open_error_t	openapiDhcpSnoopingIntfLoggedGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, OPEN_BOOL_t *logged)
	Determines whether DHCP snooping logs invalid packets on an interface. More...
open_error_t	openapiDhcpSnoopingIntfTrustedGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, OPEN_BOOL_t *trusted)
	Determines whether DHCP snooping considers an interface as trusted. More...
open_error_t	openapiDhcpSnoopingPortEnabledGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, OPEN_CONTROL_t *enabled)
	Determines whether DHCP snooping is enabled on a port. More...
open_error_t	openapiDhcpSnoopingVerifySourceMacGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, OPEN_CONTROL_t *sourceMacVerify)
	Gets whether DHCP snooping verifies source MAC addresses. More...
open_error_t	openapiDsAdminModeSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t mode)
	Sets the DHCP Snooping admin mode. More...
open_error_t	openapiDsBindingClear (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, OPEN_BOOL_t clearStaticFlag)
	Clear DHCP snooping bindings. More...
open_error_t	openapiDsBindingGet (openapiClientHandle_t *client_handle, OPEN_DHCP_SNOOP_BINDING_t *dsBinding)
	Get the DHCP snooping binding entry. More...
open_error_t	openapiDsBindingGetNext (openapiClientHandle_t *client_handle, OPEN_DHCP_SNOOP_BINDING_t *dsBinding, OPEN_DHCP_SNOOP_BINDING_t *dsBindingNext)
	Get the next DHCP snooping binding entry. More...
open_error_t	openapiDsDbFileNameGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, open_buffdesc *fileName)
	Get remote file name to store and restore the DHCP SNOOPING database. More...
open_error_t	openapiDsDbFileNameSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, open_buffdesc *fileName)
	Set remote file name to store and restore the DHCP SNOOPING database. More...
open_error_t	openapiDsDbIpAddrGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t *ipAddr)
	Get remote IP Address to store and restore the DHCP SNOOPING database. More...
open_error_t	openapiDsDbIpAddrSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ipAddr)
	Set remote IP Address to store and restore the DHCP SNOOPING database. More...
open_error_t	openapiDsDbStoreIntervalSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t interval)
	Set write delay interval to store the DHCP SNOOPING database. More...
open_error_t	openapiDsIntfBurstIntervalGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, int32_t *interval)
	Get the burst interval value of incoming DHCP packets on untrusted interfaces. More...
open_error_t	openapiDsIntfBurstIntervalSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, int32_t interval)
	Set the burst interval value of incoming DHCP packets on untrusted interfaces. More...
open_error_t	openapiDsIntfLogInvalidSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, OPEN_BOOL_t logMode)
	Set API for whether DHCP snooping logs invalid packets. More...
open_error_t	openapiDsIntfRateLimitGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, int32_t *rate)
	Get the rate limit value of incoming DHCP packets on untrusted interfaces. More...
open_error_t	openapiDsIntfRateLimitSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, int32_t rate)
	Set the rate limit value of incoming DHCP packets on untrusted interfaces. More...
open_error_t	openapiDsIntfStatsGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, uint32_t counterId, uint32_t *value)
	Get DHCP snooping statistics for passed counter Id. More...
open_error_t	openapiDsIntfTrustSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t ifNum, OPEN_BOOL_t trustMode)
	Set API for whether DHCP snooping considers a port trusted. More...
open_error_t	openapiDsIpStaticBindingAdd (openapiClientHandle_t *client_handle, OPEN_AF_t family, open_buffdesc *macAddr, open_buffdesc *ipAddr, uint32_t vlanId, uint32_t ifNum)
	Add a static entry to the DHCP snooping bindings database. More...
open_error_t	openapiDsIpStaticBindingRemove (openapiClientHandle_t *client_handle, OPEN_AF_t family, open_buffdesc *macAddr)
	Remove a static entry from the DHCP snooping bindings database. More...
open_error_t	openapiDsIpv6BindingGet (openapiClientHandle_t *client_handle, OPEN_DHCP_V6_SNOOP_BINDING_t *dsBinding)
	Get the DHCP IPv6 snooping binding entry. More...
open_error_t	openapiDsIpv6BindingGetNext (openapiClientHandle_t *client_handle, OPEN_DHCP_V6_SNOOP_BINDING_t *dsBinding, OPEN_DHCP_V6_SNOOP_BINDING_t *dsBindingNext)
	Get the next DHCP IPv6 snooping binding entry. More...
open_error_t	openapiDsL2RelayAdminModeGet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t *adminMode)
	Gets the DHCP L2 Relay Admin mode. More...
open_error_t	openapiDsL2RelayAdminModeSet (openapiClientHandle_t *client_handle, OPEN_CONTROL_t adminMode)
	Sets the DHCP L2 Relay Admin mode. More...
open_error_t	openapiDsL2RelayCircuitIdGet (openapiClientHandle_t *client_handle, uint32_t vlanNum, OPEN_CONTROL_t *circuitIdMode)
	Gets the DHCP L2 Relay circuit-id mode for a vlan. More...
open_error_t	openapiDsL2RelayCircuitIdSet (openapiClientHandle_t *client_handle, uint32_t vlanNum, OPEN_CONTROL_t circuitIdMode)
	Sets the DHCP L2 Relay circuit-Id mode for a vlan. More...
open_error_t	openapiDsL2RelayIntfModeGet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_CONTROL_t *intfMode)
	Gets the DHCP L2 Relay interface mode. More...
open_error_t	openapiDsL2RelayIntfModeSet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_CONTROL_t intfMode)
	Sets the DHCP L2 Relay interface mode. More...
open_error_t	openapiDsL2RelayIntfStatsClear (openapiClientHandle_t *client_handle, uint32_t ifNum)
	Clears the DHCP L2 Relay interface specific statistics. More...
open_error_t	openapiDsL2RelayIntfStatsGet (openapiClientHandle_t *client_handle, uint32_t ifNum, uint32_t *untrustedSrvMsgsWithOpt82, uint32_t *untrustedCliMsgsWithOpt82, uint32_t *trustedSrvMsgsWithoutOpt82, uint32_t *trustedCliMsgsWithoutOpt82)
	Gets the DHCP L2 Relay interface specific statistics. More...
open_error_t	openapiDsL2RelayIntfTrustGet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_BOOL_t *trustMode)
	Get API for whether DHCP L2 relay considers a port trusted. More...
open_error_t	openapiDsL2RelayIntfTrustNoOption82ActionGet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_t *action)
	Fetch configured no-option-82 action on L2 relay trusted interfaces. More...
open_error_t	openapiDsL2RelayIntfTrustNoOption82ActionSet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_t action)
	Configure action for packets received without option-82 on L2 relay trusted interfaces. More...
open_error_t	openapiDsL2RelayIntfTrustSet (openapiClientHandle_t *client_handle, uint32_t ifNum, OPEN_BOOL_t trustMode)
	Set API to configure a port in desired trust mode for DHCP l2 relay. More...
open_error_t	openapiDsL2RelayRemoteIdGet (openapiClientHandle_t *client_handle, uint32_t vlanNum, open_buffdesc *remoteId)
	Gets the DHCP L2 Relay remote-id string for a vlan. More...
open_error_t	openapiDsL2RelayRemoteIdSet (openapiClientHandle_t *client_handle, uint32_t vlanNum, open_buffdesc *remoteId)
	Sets the DHCP L2 Relay remote-Id string for a vlan. More...
open_error_t	openapiDsL2RelaySubscriptionCircuitIdModeGet (openapiClientHandle_t *client_handle, uint32_t ifNum, open_buffdesc *subscriptionName, OPEN_CONTROL_t *l2RelayCIdMode)
	Gets the DHCP L2 Relay Circuit-id mode for a given subscription on an interface. More...
open_error_t	openapiDsL2RelaySubscriptionCircuitIdModeSet (openapiClientHandle_t *client_handle, uint32_t ifNum, open_buffdesc *subscriptionName, OPEN_CONTROL_t l2RelayCIdMode)
	Sets the DHCP L2 Relay Circuit-id mode for a given subscription on an interface. More...
open_error_t	openapiDsL2RelaySubscriptionModeGet (openapiClientHandle_t *client_handle, uint32_t ifNum, open_buffdesc *subscriptionName, OPEN_CONTROL_t *l2RelaySubMode)
	Gets the DHCP L2 Relay mode for a given subscription on an interface. More...
open_error_t	openapiDsL2RelaySubscriptionModeSet (openapiClientHandle_t *client_handle, uint32_t ifNum, open_buffdesc *subscriptionName, OPEN_CONTROL_t l2RelaySubMode)
	Sets the DHCP L2 Relay mode for a given subscription on an interface. More...
open_error_t	openapiDsL2RelaySubscriptionRemoteIdGet (openapiClientHandle_t *client_handle, uint32_t ifNum, open_buffdesc *subscriptionName, open_buffdesc *remoteId)
	Gets the DHCP L2 Relay Remote-id string for a given subscription on an interface. More...
open_error_t	openapiDsL2RelaySubscriptionRemoteIdSet (openapiClientHandle_t *client_handle, uint32_t ifNum, open_buffdesc *subscriptionName, open_buffdesc *remoteId)
	Sets the DHCP L2 Relay Remote-id string for a given subscription on an interface. More...
open_error_t	openapiDsL2RelayVlanModeGet (openapiClientHandle_t *client_handle, uint32_t vlanNum, OPEN_CONTROL_t *l2RelayMode)
	Gets the DHCP L2 Relay mode for a VLAN. More...
open_error_t	openapiDsL2RelayVlanModeSet (openapiClientHandle_t *client_handle, uint32_t vlanNum, OPEN_CONTROL_t l2RelayMode)
	Sets the DHCP L2 Relay mode for a vlan. More...
open_error_t	openapiDsL2RelayVlanRangeCircuitIdSet (openapiClientHandle_t *client_handle, uint32_t vlanStart, uint32_t vlanEnd, OPEN_CONTROL_t circuitIdMode)
	Sets the DHCP L2 Relay circuit-Id mode for a vlan range. More...
open_error_t	openapiDsL2RelayVlanRangeModeSet (openapiClientHandle_t *client_handle, uint32_t vlanStart, uint32_t vlanEnd, OPEN_CONTROL_t l2RelayMode)
	Sets the DHCP L2 Relay mode for a vlan range. More...
open_error_t	openapiDsL2RelayVlanRangeRemoteIdSet (openapiClientHandle_t *client_handle, uint32_t vlanStart, uint32_t vlanEnd, open_buffdesc *remoteId)
	Sets the DHCP L2 Relay remote-Id string for a vlan range. More...
open_error_t	openapiDsStaticBindingCountGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t *count)
	Get the number of DHCP snooping static bindings. More...
open_error_t	openapiDsVerifyMacSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, OPEN_BOOL_t status)
	Set API for whether DHCP snooping verifies source MAC addresses. More...
open_error_t	openapiDsVlanConfigGet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t vlanId, uint32_t *mode)
	Get API for whether DHCP snooping is enabled or disabled on a VLAN. More...
open_error_t	openapiDsVlanConfigSet (openapiClientHandle_t *client_handle, OPEN_AF_t family, uint32_t vlanStart, uint32_t vlanEnd, uint32_t mode)
	Set API to enable or disable DHCP snooping on a VLAN. More...

Detailed Description

Macro Definition Documentation

#define OPEN_DS_BINDING_TENTATIVE   0

DHCP snooping binding type.

Tentative binding

Definition at line 54 of file openapi_dhcp_snooping.h.

Enumeration Type Documentation

enum OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_t

DHCP L2 relay option 82 actions.

Enumerator
OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_DROP	Drop action.
OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_KEEP	This action is not supported.
OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_UPDATE	Update action.

Definition at line 46 of file openapi_dhcp_snooping.h.

Function Documentation

open_error_t openapiDhcpSnoopingAdminModeGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		OPEN_CONTROL_t *	adminMode
	)

Gets the DHCP Snooping Admin mode.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[out]	adminMode	DHCP snooping admin mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	IPv6 requested but support is unavailable

Note

Use this function to determine if DHCP snooping is enabled.

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingDbFileNameGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		open_buffdesc *	fileName
	)

Get the remote DHCP snooping database file name.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[out]	fileName	Remote DHCP snooping DB file name
	-	Minimum allowed value of buffer length is iobtainable by calling openapiDhcpSnoopingFileNameMaxLengthGet()

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingDbFileNameMaxLengthGet	(	openapiClientHandle_t *	client_handle,
		uint32_t *	len
	)

Get the remote DHCP snooping database file name max length.

Parameters

[in]	client_handle	Client handle from registration API
[out]	len	Maximum length of filename including NULL.

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingDbIpAddressGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		open_inet_addr_t *	addr
	)

Get the remote DHCP snooping database IPv4 Address.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[out]	addr	Remote DHCP snooping DB IP Address

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingDbWriteDelayGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t *	delay
	)

Get the DHCP snooping database write delay.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[out]	delay	Write delay in seconds.

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingEnabledVlanRangeNextGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t *	vlanStart,
		uint32_t *	vlanEnd
	)

Given a VLAN ID, return the endpoints of the next range of VLANs enabled for DHCP snooping.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[out]	vlanStart	Low end of VLAN range
[in,out]	vlanEnd	High end of VLAN range

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_NOT_FOUND	No further VLANs beyond vlanEnd
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	IPv6 requested but support is unavailable

Note

Search for next range starts at vlanEnd + 1. To begin a search, set vlanEnd to 0. To search the next following range, vlanEnd should be set to the vlanEnd returned by the previous call. See example code for more details.

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingIntfLoggedGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		OPEN_BOOL_t *	logged
	)

Determines whether DHCP snooping logs invalid packets on an interface.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[in]	ifNum	Internal interface number
[out]	logged	OPEN_TRUE if invalid packets logged for interface, else OPEN_FALSE

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	IPv6 requested but support is unavailable

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingIntfTrustedGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		OPEN_BOOL_t *	trusted
	)

Determines whether DHCP snooping considers an interface as trusted.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[in]	ifNum	Internal interface number
[out]	trusted	OPEN_TRUE if trusted, else OPEN_FALSE

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	IPv6 requested but support is unavailable

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingPortEnabledGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		OPEN_CONTROL_t *	enabled
	)

Determines whether DHCP snooping is enabled on a port.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[in]	ifNum	Internal interface number
[out]	enabled	OPEN_ENABLE if DHCP snooping is enabled on port, else OPEN_DISABLE

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	IPv6 requested but support is unavailable

Note

DHCP snooping is considered enabled on a port if DHCP snooping is enabled on one or more VLANs the port participates in.

OpEN API Version: 1.18

open_error_t openapiDhcpSnoopingVerifySourceMacGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		OPEN_CONTROL_t *	sourceMacVerify
	)

Gets whether DHCP snooping verifies source MAC addresses.

Parameters

[in]	client_handle	Client handle from registration API
[in]	family	OPEN_AF_INET or OPEN_AF_INET6
[out]	sourceMacVerify	If OPEN_ENABLE, source MAC addresses verified, otherwise OPEN_DISABLE

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	IPv6 requested but support is unavailable

Note

When MAC verify is enabled (and port security is enabled on the interface), DHCP snooping tells the hardware to drop any incoming frames on the interface if the source MAC is not the MAC address for a DHCP client who has been leased an IP address.

OpEN API Version: 1.18

open_error_t openapiDsAdminModeSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	mode
	)

Sets the DHCP Snooping admin mode.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	mode	DHCP snooping admin mode

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsBindingClear	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		OPEN_BOOL_t	clearStaticFlag
	)

Clear DHCP snooping bindings.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[in]	clearStaticFlag	If set, static entries also will be cleared

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsBindingGet	(	openapiClientHandle_t *	client_handle,
		OPEN_DHCP_SNOOP_BINDING_t *	dsBinding
	)

Get the DHCP snooping binding entry.

Parameters

[in]	client_handle	client handle from registration API
[in,out]	dsBinding	DHCP snooping binding table entry.

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

User of the API needs to pass the MAC address to get the details of the snooping entry corresponding to MAC address.

OpEN API Version: 1.26

open_error_t openapiDsBindingGetNext	(	openapiClientHandle_t *	client_handle,
		OPEN_DHCP_SNOOP_BINDING_t *	dsBinding,
		OPEN_DHCP_SNOOP_BINDING_t *	dsBindingNext
	)

Get the next DHCP snooping binding entry.

Parameters

[in]	client_handle	client handle from registration API
[in]	dsBinding	DHCP snooping binding table entry. MAC address is mandatorily needs to be filled.
[out]	dsBindingNext	Next DHCP snooping binding table entry.

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsDbFileNameGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		open_buffdesc *	fileName
	)

Get remote file name to store and restore the DHCP SNOOPING database.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[out]	fileName	File Name

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsDbFileNameSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		open_buffdesc *	fileName
	)

Set remote file name to store and restore the DHCP SNOOPING database.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	fileName	File Name

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsDbIpAddrGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t *	ipAddr
	)

Get remote IP Address to store and restore the DHCP SNOOPING database.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[out]	ipAddr	Remote IP address

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsDbIpAddrSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ipAddr
	)

Set remote IP Address to store and restore the DHCP SNOOPING database.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ipAddr	Remote IP address

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsDbStoreIntervalSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	interval
	)

Set write delay interval to store the DHCP SNOOPING database.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	interval	Periodic store interval

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsIntfBurstIntervalGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		int32_t *	interval
	)

Get the burst interval value of incoming DHCP packets on untrusted interfaces.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[out]	interval	Consecutive interval in seconds, over which the interface is monitored for a high rate of DHCP packets.

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsIntfBurstIntervalSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		int32_t	interval
	)

Set the burst interval value of incoming DHCP packets on untrusted interfaces.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[in]	interval	Consecutive interval in seconds, over which the interface is monitored for a high rate of DHCP packets.

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsIntfLogInvalidSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		OPEN_BOOL_t	logMode
	)

Set API for whether DHCP snooping logs invalid packets.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[in]	logMode	Log mode

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsIntfRateLimitGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		int32_t *	rate
	)

Get the rate limit value of incoming DHCP packets on untrusted interfaces.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[out]	rate	Upper limit for number of incoming packets processed per second

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsIntfRateLimitSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		int32_t	rate
	)

Set the rate limit value of incoming DHCP packets on untrusted interfaces.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[in]	rate	Upper limit for number of incoming packets processed per second

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsIntfStatsGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		uint32_t	counterId,
		uint32_t *	value
	)

Get DHCP snooping statistics for passed counter Id.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[in]	counterId	Counter ID
[out]	value	Statistics value

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Refer OPEN_DS_CID_MAC_VERIFY, OPEN_DS_CID_INTF_MISMATCH, OPEN_DS_CID_UNTRUSTED_SRVR_MSG for counter ID

OpEN API Version: 1.26

open_error_t openapiDsIntfTrustSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	ifNum,
		OPEN_BOOL_t	trustMode
	)

Set API for whether DHCP snooping considers a port trusted.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	ifNum	interface
[in]	trustMode	Trust mode

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsIpStaticBindingAdd	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		open_buffdesc *	macAddr,
		open_buffdesc *	ipAddr,
		uint32_t	vlanId,
		uint32_t	ifNum
	)

Add a static entry to the DHCP snooping bindings database.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	macAddr	MAC address
[in]	ipAddr	IP address
[in]	vlanId	Vlan Id
[in]	ifNum	interface

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsIpStaticBindingRemove	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		open_buffdesc *	macAddr
	)

Remove a static entry from the DHCP snooping bindings database.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	macAddr	MAC address

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsIpv6BindingGet	(	openapiClientHandle_t *	client_handle,
		OPEN_DHCP_V6_SNOOP_BINDING_t *	dsBinding
	)

Get the DHCP IPv6 snooping binding entry.

Parameters

[in]	client_handle	client handle from registration API
[out]	dsBinding	DHCP IPv6 snooping binding table entry.

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsIpv6BindingGetNext	(	openapiClientHandle_t *	client_handle,
		OPEN_DHCP_V6_SNOOP_BINDING_t *	dsBinding,
		OPEN_DHCP_V6_SNOOP_BINDING_t *	dsBindingNext
	)

Get the next DHCP IPv6 snooping binding entry.

Parameters

[in]	client_handle	client handle from registration API
[in]	dsBinding	DHCP IPV6 snooping binding table entry. MAC address is mandatoryneeds to be filled.
[out]	dsBindingNext	Next DHCP IPV6 snooping binding table entry.

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsL2RelayAdminModeGet	(	openapiClientHandle_t *	client_handle,
		OPEN_CONTROL_t *	adminMode
	)

Gets the DHCP L2 Relay Admin mode.

Parameters

[in]	client_handle	client handle from registration API
[out]	adminMode	DHCP L2 relay admin mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available
OPEN_E_INTERNAL	Other Internal Failure.

OpEN API Version: 1.25

open_error_t openapiDsL2RelayAdminModeSet	(	openapiClientHandle_t *	client_handle,
		OPEN_CONTROL_t	adminMode
	)

Sets the DHCP L2 Relay Admin mode.

Parameters

[in]	client_handle	client handle from registration API
[in]	adminMode	DHCP L2 relay admin mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayCircuitIdGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanNum,
		OPEN_CONTROL_t *	circuitIdMode
	)

Gets the DHCP L2 Relay circuit-id mode for a vlan.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanNum	VLAN number
[out]	circuitIdMode	DHCP L2 Relay Circuit-Id mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available
OPEN_E_INTERNAL	Other Internal Failure.

OpEN API Version: 1.25

open_error_t openapiDsL2RelayCircuitIdSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanNum,
		OPEN_CONTROL_t	circuitIdMode
	)

Sets the DHCP L2 Relay circuit-Id mode for a vlan.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanNum	VLAN number
[in]	circuitIdMode	DHCP L2 Relay Circuit-Id mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfModeGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		OPEN_CONTROL_t *	intfMode
	)

Gets the DHCP L2 Relay interface mode.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	Internal interface number
[out]	intfMode	DHCP L2 Relay interface mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available
OPEN_E_INTERNAL	Other Internal Failure.

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfModeSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		OPEN_CONTROL_t	intfMode
	)

Sets the DHCP L2 Relay interface mode.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	Internal interface number
[in]	intfMode	DHCP L2 Relay interface mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfStatsClear	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum
	)

Clears the DHCP L2 Relay interface specific statistics.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfStatsGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		uint32_t *	untrustedSrvMsgsWithOpt82,
		uint32_t *	untrustedCliMsgsWithOpt82,
		uint32_t *	trustedSrvMsgsWithoutOpt82,
		uint32_t *	trustedCliMsgsWithoutOpt82
	)

Gets the DHCP L2 Relay interface specific statistics.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[out]	untrustedSrvMsgsWithOpt82	L2 Relay un trusted server statistics.
[out]	untrustedCliMsgsWithOpt82	L2 Relay un trusted client statistics.
[out]	trustedSrvMsgsWithoutOpt82	L2 Relay trusted server statistics.
[out]	trustedCliMsgsWithoutOpt82	L2 Relay trusted client statistics.

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfTrustGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		OPEN_BOOL_t *	trustMode
	)

Get API for whether DHCP L2 relay considers a port trusted.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	Internal interface number
[out]	trustMode	OPEN_TRUE if port is trusted

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available
OPEN_E_INTERNAL	Other Internal Failure.

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfTrustNoOption82ActionGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_t *	action
	)

Fetch configured no-option-82 action on L2 relay trusted interfaces.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[out]	action	drop/keep/update

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfTrustNoOption82ActionSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		OPEN_DHCP_L2RELAY_NO_OPTION_82_ACTION_t	action
	)

Configure action for packets received without option-82 on L2 relay trusted interfaces.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[in]	action	drop/keep/update

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayIntfTrustSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		OPEN_BOOL_t	trustMode
	)

Set API to configure a port in desired trust mode for DHCP l2 relay.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	Internal interface number
[in]	trustMode	OPEN_TRUE if port is trusted

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayRemoteIdGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanNum,
		open_buffdesc *	remoteId
	)

Gets the DHCP L2 Relay remote-id string for a vlan.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanNum	VLAN number
[out]	remoteId	DHCP L2 Relay remote Id string

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayRemoteIdSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanNum,
		open_buffdesc *	remoteId
	)

Sets the DHCP L2 Relay remote-Id string for a vlan.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanNum	VLAN number
[in]	remoteId	DHCP L2 Relay remote Id string

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelaySubscriptionCircuitIdModeGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		open_buffdesc *	subscriptionName,
		OPEN_CONTROL_t *	l2RelayCIdMode
	)

Gets the DHCP L2 Relay Circuit-id mode for a given subscription on an interface.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[in]	subscriptionName	subscription name
[out]	l2RelayCIdMode	DHCP L2 Relay circuit-id mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available
OPEN_E_INTERNAL	Other Internal Failure.

OpEN API Version: 1.25

open_error_t openapiDsL2RelaySubscriptionCircuitIdModeSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		open_buffdesc *	subscriptionName,
		OPEN_CONTROL_t	l2RelayCIdMode
	)

Sets the DHCP L2 Relay Circuit-id mode for a given subscription on an interface.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[in]	subscriptionName	subscription name
[in]	l2RelayCIdMode	DHCP L2 Relay circuit-id mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelaySubscriptionModeGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		open_buffdesc *	subscriptionName,
		OPEN_CONTROL_t *	l2RelaySubMode
	)

Gets the DHCP L2 Relay mode for a given subscription on an interface.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[in]	subscriptionName	subscription name
[out]	l2RelaySubMode	DHCP L2 Relay mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available
OPEN_E_INTERNAL	Other Internal Failure.

OpEN API Version: 1.25

open_error_t openapiDsL2RelaySubscriptionModeSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		open_buffdesc *	subscriptionName,
		OPEN_CONTROL_t	l2RelaySubMode
	)

Sets the DHCP L2 Relay mode for a given subscription on an interface.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[in]	subscriptionName	subscription name
[in]	l2RelaySubMode	DHCP L2 Relay mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelaySubscriptionRemoteIdGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		open_buffdesc *	subscriptionName,
		open_buffdesc *	remoteId
	)

Gets the DHCP L2 Relay Remote-id string for a given subscription on an interface.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[in]	subscriptionName	subscription name
[out]	remoteId	DHCP L2 Relay remote-id string

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelaySubscriptionRemoteIdSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	ifNum,
		open_buffdesc *	subscriptionName,
		open_buffdesc *	remoteId
	)

Sets the DHCP L2 Relay Remote-id string for a given subscription on an interface.

Parameters

[in]	client_handle	client handle from registration API
[in]	ifNum	internal interface number
[in]	subscriptionName	subscription name
[in]	remoteId	DHCP L2 Relay remote-id string

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayVlanModeGet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanNum,
		OPEN_CONTROL_t *	l2RelayMode
	)

Gets the DHCP L2 Relay mode for a VLAN.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanNum	VLAN number
[out]	l2RelayMode	DHCP L2 Relay mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available
OPEN_E_INTERNAL	Other Internal Failure.

OpEN API Version: 1.25

open_error_t openapiDsL2RelayVlanModeSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanNum,
		OPEN_CONTROL_t	l2RelayMode
	)

Sets the DHCP L2 Relay mode for a vlan.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanNum	VLAN number
[in]	l2RelayMode	DHCP L2 Relay mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayVlanRangeCircuitIdSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanStart,
		uint32_t	vlanEnd,
		OPEN_CONTROL_t	circuitIdMode
	)

Sets the DHCP L2 Relay circuit-Id mode for a vlan range.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanStart	Starting Vlan number
[in]	vlanEnd	Ending Vlan number
[in]	circuitIdMode	DHCP L2 Relay Circuit-Id mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayVlanRangeModeSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanStart,
		uint32_t	vlanEnd,
		OPEN_CONTROL_t	l2RelayMode
	)

Sets the DHCP L2 Relay mode for a vlan range.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanStart	Starting Vlan number
[in]	vlanEnd	Ending Vlan number
[in]	l2RelayMode	DHCP L2 Relay mode

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsL2RelayVlanRangeRemoteIdSet	(	openapiClientHandle_t *	client_handle,
		uint32_t	vlanStart,
		uint32_t	vlanEnd,
		open_buffdesc *	remoteId
	)

Sets the DHCP L2 Relay remote-Id string for a vlan range.

Parameters

[in]	client_handle	client handle from registration API
[in]	vlanStart	Starting Vlan number
[in]	vlanEnd	Ending Vlan number
[in]	remoteId	DHCP L2 Relay remote Id string

Return values

OPEN_E_NONE	On success
OPEN_E_PARAM	Invalid parameter
OPEN_E_FAIL	On failure
OPEN_E_UNAVAIL	Feature not available

OpEN API Version: 1.25

open_error_t openapiDsStaticBindingCountGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t *	count
	)

Get the number of DHCP snooping static bindings.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[out]	count	Number of dhcp snooping static bindings.

Return values

OPEN_E_UNAVAIL	Feature not available
OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsVerifyMacSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		OPEN_BOOL_t	status
	)

Set API for whether DHCP snooping verifies source MAC addresses.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	status	State 1 or 0

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26

open_error_t openapiDsVlanConfigGet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	vlanId,
		uint32_t *	mode
	)

Get API for whether DHCP snooping is enabled or disabled on a VLAN.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	vlanId	Vlan Id
[out]	mode	DHCP snooping state on the VLAN

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

OpEN API Version: 1.26

open_error_t openapiDsVlanConfigSet	(	openapiClientHandle_t *	client_handle,
		OPEN_AF_t	family,
		uint32_t	vlanStart,
		uint32_t	vlanEnd,
		uint32_t	mode
	)

Set API to enable or disable DHCP snooping on a VLAN.

Parameters

[in]	client_handle	client handle from registration API
[in]	family	Address family. IPV4 or IPV6
[in]	vlanStart	Starting Vlan number
[in]	vlanEnd	Ending Vlan number
[in]	mode	DHCP snooping state on the VLAN

Return values

OPEN_E_NONE	On success.
OPEN_E_FAIL	On failure.
OPEN_E_PARAM	Invalid argument.

Note

Calling this API will change the running configuration of the switch

OpEN API Version: 1.26