FD.io VPP  v18.07-rc0-415-g6c78436
Vector Packet Processing
VOM::interface Class Reference

A representation of an interface in VPP. More...

+ Inheritance diagram for VOM::interface:
+ Collaboration diagram for VOM::interface:

Data Structures

struct  admin_state_t
 The admin state of the interface. More...
 
class  create_cmd
 A base class for interface Create commands. More...
 
class  delete_cmd
 Base class for intterface Delete commands. More...
 
class  event_listener
 A class that listens to interface Events. More...
 
struct  oper_state_t
 The oper state of the interface. More...
 
class  stat_listener
 A class that listens to interface Stats. More...
 
struct  stats_type_t
 
struct  type_t
 An interface type. More...
 

Public Types

typedef std::string key_t
 The key for interface's key. More...
 
typedef singular_db< const std::string, interface >::const_iterator const_iterator_t
 The iterator type. More...
 

Public Member Functions

 interface (const std::string &name, type_t type, admin_state_t state, const std::string &tag="")
 Construct a new object matching the desried state. More...
 
 interface (const std::string &name, type_t type, admin_state_t state, const route_domain &rd, const std::string &tag="")
 Construct a new object matching the desried state mapped to a specific route_domain. More...
 
virtual ~interface ()
 Destructor. More...
 
 interface (const interface &o)
 Copy Constructor. More...
 
std::shared_ptr< interfacesingular () const
 Return the matching'singular' of the interface. More...
 
virtual std::string to_string (void) const
 convert to string format for debug purposes More...
 
const handle_thandle () const
 Return VPP's handle to this object. More...
 
const type_ttype () const
 Return the interface type. More...
 
const std::string & name () const
 Return the interface type. More...
 
const key_tkey () const
 Return the interface type. More...
 
const l2_address_tl2_address () const
 Return the L2 Address. More...
 
void set (const admin_state_t &state)
 Set the admin state of the interface. More...
 
void set (const l2_address_t &addr)
 Set the L2 Address. More...
 
void set (const oper_state_t &state)
 Set the operational state of the interface, as reported by VPP. More...
 
void set (const std::string &tag)
 Set the tag to the interface. More...
 
virtual bool operator== (const interface &i) const
 Comparison operator - only used for UT. More...
 
void enable_stats (stat_listener &el, const stats_type_t &st=stats_type_t::NORMAL)
 Enable stats for this interface. More...
 

Static Public Member Functions

static const_iterator_t cbegin ()
 
static const_iterator_t cend ()
 
static std::shared_ptr< interfacefind (const handle_t &h)
 The the singular instance of the interface in the DB by handle. More...
 
static std::shared_ptr< interfacefind (const key_t &k)
 The the singular instance of the interface in the DB by key. More...
 
static void dump (std::ostream &os)
 Dump all interfaces into the stream provided. More...
 

Protected Member Functions

void set (const handle_t &handle)
 Set the handle of an interface object. More...
 
virtual std::shared_ptr< interfacesingular_i () const
 Return the matching 'singular' of the interface. More...
 
void release ()
 release/remove an interface form the singular store More...
 
virtual std::queue< cmd * > & mk_create_cmd (std::queue< cmd * > &cmds)
 Virtual functions to construct an interface create commands. More...
 
virtual std::queue< cmd * > & mk_delete_cmd (std::queue< cmd * > &cmds)
 Virtual functions to construct an interface delete commands. More...
 
virtual void sweep (void)
 Sweep/reap the object if still stale. More...
 
- Protected Member Functions inherited from VOM::object_base
 object_base ()=default
 Constructable by derived classes only. More...
 
virtual ~object_base ()=default
 Destructor. More...
 

Static Protected Member Functions

static void add (const key_t &name, const HW::item< handle_t > &item)
 Add an interface to the DB keyed on handle. More...
 
static void remove (const HW::item< handle_t > &item)
 remove an interface from the DB keyed on handle More...
 

Protected Attributes

HW::item< handle_tm_hdl
 The SW interface handle VPP has asigned to the interface. More...
 

Static Protected Attributes

static singular_db< key_t, interfacem_db
 A map of all interfaces key against the interface's name. More...
 

Friends

class interface_factory
 
class OM
 
class singular_db< key_t, interface >
 It's the singular_db class that calls replay() More...
 
template<typename MSG >
class create_cmd
 Create commands are firends so they can add interfaces to the handle store. More...
 
template<typename MSG >
class delete_cmd
 Create commands are firends so they can remove interfaces from the handle store. More...
 

Detailed Description

A representation of an interface in VPP.

Definition at line 41 of file interface.hpp.

Member Typedef Documentation

typedef singular_db<const std::string, interface>::const_iterator VOM::interface::const_iterator_t

The iterator type.

Definition at line 62 of file interface.hpp.

typedef std::string VOM::interface::key_t

The key for interface's key.

Definition at line 56 of file interface.hpp.

Constructor & Destructor Documentation

VOM::interface::interface ( const std::string &  name,
interface::type_t  itf_type,
interface::admin_state_t  itf_state,
const std::string &  tag = "" 
)

Construct a new object matching the desried state.

Definition at line 43 of file interface.cpp.

VOM::interface::interface ( const std::string &  name,
interface::type_t  itf_type,
interface::admin_state_t  itf_state,
const route_domain rd,
const std::string &  tag = "" 
)

Construct a new object matching the desried state mapped to a specific route_domain.

Definition at line 59 of file interface.cpp.

VOM::interface::~interface ( )
virtual

Destructor.

Definition at line 226 of file interface.cpp.

+ Here is the call graph for this function:

VOM::interface::interface ( const interface o)

Copy Constructor.

Definition at line 77 of file interface.cpp.

Member Function Documentation

void VOM::interface::add ( const key_t name,
const HW::item< handle_t > &  item 
)
staticprotected

Add an interface to the DB keyed on handle.

Definition at line 469 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

interface::const_iterator_t VOM::interface::cbegin ( )
static

Definition at line 150 of file interface.cpp.

+ Here is the caller graph for this function:

interface::const_iterator_t VOM::interface::cend ( )
static

Definition at line 156 of file interface.cpp.

+ Here is the caller graph for this function:

void VOM::interface::dump ( std::ostream &  os)
static

Dump all interfaces into the stream provided.

Definition at line 485 of file interface.cpp.

+ Here is the call graph for this function:

void VOM::interface::enable_stats ( interface::stat_listener el,
const stats_type_t st = stats_type_t::NORMAL 
)

Enable stats for this interface.

Definition at line 439 of file interface.cpp.

+ Here is the call graph for this function:

std::shared_ptr< interface > VOM::interface::find ( const handle_t h)
static

The the singular instance of the interface in the DB by handle.

Definition at line 463 of file interface.cpp.

+ Here is the caller graph for this function:

std::shared_ptr< interface > VOM::interface::find ( const key_t k)
static

The the singular instance of the interface in the DB by key.

Definition at line 457 of file interface.cpp.

const handle_t & VOM::interface::handle ( ) const

Return VPP's handle to this object.

Definition at line 132 of file interface.cpp.

+ Here is the call graph for this function:

const interface::key_t & VOM::interface::key ( ) const

Return the interface type.

Definition at line 270 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

const l2_address_t & VOM::interface::l2_address ( ) const

Return the L2 Address.

Definition at line 144 of file interface.cpp.

std::queue< cmd * > & VOM::interface::mk_create_cmd ( std::queue< cmd * > &  cmds)
protectedvirtual

Virtual functions to construct an interface create commands.

Overridden in derived classes like the sub_interface

Definition at line 276 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

std::queue< cmd * > & VOM::interface::mk_delete_cmd ( std::queue< cmd * > &  cmds)
protectedvirtual

Virtual functions to construct an interface delete commands.

Overridden in derived classes like the sub_interface

Definition at line 303 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

const std::string & VOM::interface::name ( ) const

Return the interface type.

Definition at line 264 of file interface.cpp.

+ Here is the caller graph for this function:

bool VOM::interface::operator== ( const interface i) const
virtual

Comparison operator - only used for UT.

Definition at line 92 of file interface.cpp.

+ Here is the call graph for this function:

void VOM::interface::release ( )
protected

release/remove an interface form the singular store

Definition at line 233 of file interface.cpp.

+ Here is the caller graph for this function:

void VOM::interface::remove ( const HW::item< handle_t > &  item)
staticprotected

remove an interface from the DB keyed on handle

Definition at line 479 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void VOM::interface::set ( const admin_state_t state)

Set the admin state of the interface.

Definition at line 392 of file interface.cpp.

+ Here is the caller graph for this function:

void VOM::interface::set ( const l2_address_t addr)

Set the L2 Address.

Definition at line 398 of file interface.cpp.

void VOM::interface::set ( const oper_state_t state)

Set the operational state of the interface, as reported by VPP.

Definition at line 412 of file interface.cpp.

void VOM::interface::set ( const std::string &  tag)

Set the tag to the interface.

Definition at line 418 of file interface.cpp.

+ Here is the call graph for this function:

void VOM::interface::set ( const handle_t handle)
protected

Set the handle of an interface object.

Only called by the interface factory during the populate

Definition at line 406 of file interface.cpp.

std::shared_ptr< interface > VOM::interface::singular ( ) const

Return the matching'singular' of the interface.

Definition at line 451 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

std::shared_ptr< interface > VOM::interface::singular_i ( ) const
protectedvirtual

Return the matching 'singular' of the interface.

Definition at line 445 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void VOM::interface::sweep ( void  )
protectedvirtual

Sweep/reap the object if still stale.

Implements VOM::object_base.

Definition at line 162 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

std::string VOM::interface::to_string ( void  ) const
virtual

convert to string format for debug purposes

Implements VOM::object_base.

Reimplemented in VOM::bond_interface, and VOM::vxlan_tunnel.

Definition at line 240 of file interface.cpp.

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

const interface::type_t & VOM::interface::type ( ) const

Return the interface type.

Definition at line 126 of file interface.cpp.

Friends And Related Function Documentation

template<typename MSG >
friend class create_cmd
friend

Create commands are firends so they can add interfaces to the handle store.

Definition at line 642 of file interface.hpp.

template<typename MSG >
friend class delete_cmd
friend

Create commands are firends so they can remove interfaces from the handle store.

Definition at line 649 of file interface.hpp.

friend class interface_factory
friend

Definition at line 468 of file interface.hpp.

friend class OM
friend

Definition at line 568 of file interface.hpp.

friend class singular_db< key_t, interface >
friend

It's the singular_db class that calls replay()

Definition at line 573 of file interface.hpp.

Field Documentation

singular_db< interface::key_t, interface > VOM::interface::m_db
staticprotected

A map of all interfaces key against the interface's name.

A DB of all the interfaces, key on the name.

Definition at line 505 of file interface.hpp.

HW::item<handle_t> VOM::interface::m_hdl
protected

The SW interface handle VPP has asigned to the interface.

Definition at line 473 of file interface.hpp.


The documentation for this class was generated from the following files: