eth_intf module reference

namespace eos

class eth_intf_handler

#include <eth_intf.h>

Event handler for ethernet interface specific events.

Handles events on ethernet interfaces. Includes physical interfaces and LAGs (port-channels) among other interface types.

Public Functions

eth_intf_handler(eth_intf_mgr *)

eth_intf_mgr * get_eth_intf_mgr() const

void watch_all_eth_intfs(bool)

Registers to receive updates on changes to the interface.

Parameters

• bool -

  Signifies whether notifications should be propagated to this handler instance or not.

void watch_eth_intf(intf_id_t, bool)

Registers this class to receive change updates on the given interface.

Parameters

• intf_id_t -

  Signifies which interface to subscribe to.

• bool -

  Signifies whether notifications should be propagated to this handler instance or not.

virtual void on_eth_intf_create(intf_id_t)

Handler called when an ethernet interface is created.

virtual void on_eth_intf_delete(intf_id_t)

Handler called when an ethernet interface is deleted.

virtual void on_eth_addr(intf_id_t, eth_addr_t)

Handler called when the mac address of an interface changes.

class eth_intf_iter_t

#include <eth_intf.h>

Iterator type for ethernet interfaces.

Private Functions

eth_intf_iter_t(eth_intf_iter_impl * const)

Friends

friend class eth_intf_iter_impl

class eth_intf_mgr

#include <eth_intf.h>

The ethernet interface manager.

Public Functions

virtual ~eth_intf_mgr()

virtual eth_intf_iter_t eth_intf_iter() const = 0

virtual bool exists(intf_id_t) const = 0

virtual eth_addr_t eth_addr(intf_id_t) const = 0

Returns the operational ethernet address of the interface.

virtual eth_addr_t configured_eth_addr(intf_id_t) const = 0

Returns the currently configured ethernet address.

virtual void eth_addr_is(intf_id_t, eth_addr_t) = 0

Configures the ethernet address of the interface

Parameters

• intf_id_t -

  The interface ID of the interface to change the address of

• eth_addr_t -

  The address to set

virtual switchport_mode_t switchport_mode(intf_id_t) const = 0

Returns the currently configured mode of operation of a given interface. Note that only Ethernet and Port-Channel interfaces can be switchports, using any other type of interface will lead to a panic.

virtual void switchport_mode_is(intf_id_t, switchport_mode_t) = 0

Configures the mode of operation of a given interface. Note that only Ethernet and Port-Channel interfaces can be switchports, using any other type of interface will lead to a panic.

virtual vlan_id_t default_vlan(intf_id_t) const = 0

Returns the ‘default’ VLAN of a given interface. The ‘default’ VLAN depends on the switchport mode of the interface. If the interface is in access mode, then the access VLAN is returned. If the interface is in tap or trunk mode, then the native VLAN is returned. If no native VLAN is configured, then 0 is returned.

virtual void default_vlan_is(intf_id_t, vlan_id_t) = 0

Configures the ‘default’ VLAN of a given interface. The ‘default’ VLAN depends on the switchport mode of the interface. If the interface is in access mode, then the access VLAN is configured. If the interface is in tap or trunk mode, then the native VLAN is configured.

virtual vlan_set trunk_vlans(intf_id_t) const = 0

Returns the set of VLANs trunked on this interface. Note that by default all VLANs are trunked on all interfaces.

virtual void trunk_vlan_set(intf_id_t, vlan_id_t) = 0

Adds a VLAN to the set of allowed VLANs when in trunk mode. If the interface isn’t in trunk mode, then the configuration is changed nevertheless, but the configuration won’t take effect until the interface is switched to trunk mode.

virtual void trunk_vlan_is(intf_id_t, vlan_set const & vlans) = 0

Configures the set of allowed VLANs when in trunk mode. If the interface isn’t in trunk mode, then the configuration is changed nevertheless, but the configuration won’t take effect until the interface is switched to trunk mode.

virtual void trunk_vlan_del(intf_id_t, vlan_id_t) = 0

Removes a VLAN to the set of allowed VLANs when in trunk mode. If the interface isn’t in trunk mode, then the configuration is changed nevertheless, but the configuration won’t take effect until the interface is switched to trunk mode.

Protected Functions

eth_intf_mgr()

Private Members

eth_intf_mgr

Friends

friend class eth_intf_handler

eth_intf type definitions

namespace eos

Enums

switchport_mode_t enum

The mode of operation of a switch port.

Values:

• SWITCHPORT_MODE_ACCESS -

  Interface only has access to its access VLAN.

• SWITCHPORT_MODE_TRUNK -

  Interface is in 802.1q mode (“trunk mode”).

• SWITCHPORT_MODE_DOT1Q_TUNNEL -

  Interface is in 802.1ad mode (“QinQ mode”).

• SWITCHPORT_MODE_TAP -

  Interface is in tap mode (“span mode”).

• SWITCHPORT_MODE_TOOL -

  Interface is a tool port (egress for a tap).

• SWITCHPORT_MODE_ROUTED -

  Interface is routed (“no switchport”).