class ProtoNode Base class for a protocol node. More... Contains pure virtuals Definition #include <proto_node.hh> Template form ProtoNode<class V> Inherits ProtoUnit [public ] List of all Methods

Annotated List Files Globals Hierarchy Index

Public Methods

•  ProtoNode (int init_family, xorp_module_id init_module_id, EventLoop& init_eventloop)
• virtual  ~ProtoNode ()
• int  start ()
• int  stop ()
• void  enable ()
• void  disable ()
• inline uint16_t  vif_name2vif_index (const string& vif_name) const
• inline uint16_t  find_unused_vif_index () const
• inline V * vif_find_by_name (const string& name) const
• inline V * vif_find_by_addr (const IPvX& ipaddr_test) const
• inline V * vif_find_by_pif_index (uint16_t pif_index) const
• inline V * vif_find_by_vif_index (uint16_t vif_index) const
• inline V * vif_find_direct (const IPvX& ipaddr_test) const
• bool  is_directly_connected (const IPvX& ipaddr_test) const
• bool  is_my_addr (const IPvX& ipaddr_test) const
• inline int  add_vif (V *vif)
• inline int  delete_vif (const V *vif)
• vector<V *>&  proto_vifs ()
• uint16_t  maxvifs () const
• EventLoop&  eventloop ()
• bool  is_vif_setup_completed () const
• void  set_vif_setup_completed (bool v)
• virtual int  proto_recv (const string& src_module_instance_name, xorp_module_id src_module_id, uint16_t vif_index, const IPvX& src, const IPvX& dst, int ip_ttl, int ip_tos, bool router_alert_bool, const uint8_t *rcvbuf, size_t rcvlen)
• virtual int  proto_send (const string& dst_module_instance_name, xorp_module_id dst_module_id, uint16_t vif_index, const IPvX& src, const IPvX& dst, int ip_ttl, int ip_tos, bool router_alert_bool, const uint8_t *sndbuf, size_t sndlen)
• virtual int  signal_message_recv (const string& src_module_instance_name, xorp_module_id src_module_id, int message_type, uint16_t vif_index, const IPvX& src, const IPvX& dst, const uint8_t *rcvbuf, size_t rcvlen)
• virtual int  signal_message_send (const string& dst_module_instance_name, xorp_module_id dst_module_id, int message_type, uint16_t vif_index, const IPvX& src, const IPvX& dst, const uint8_t *sndbuf, size_t sndlen)
• ProcessStatus  node_status () const
• void  set_node_status (ProcessStatus v)
• int  start_config (string& reason)
• int  end_config (string& reason)
• inline uint16_t  find_unused_config_vif_index () const
• int  add_config_vif (const Vif& vif, string& reason)
• int  add_config_vif (const string& vif_name, uint16_t vif_index, string& reason)
• int  delete_config_vif (const string& vif_name, string& reason)
• int  add_config_vif_addr (const string& vif_name, const IPvX& addr, const IPvXNet& subnet, const IPvX& broadcast, const IPvX& peer, string& reason)
• int  delete_config_vif_addr (const string& vif_name, const IPvX& addr, string& reason)
• int  set_config_vif_flags (const string& vif_name, bool is_pim_register, bool is_p2p, bool is_loopback, bool is_multicast, bool is_broadcast, bool is_up, string& reason)
• map<string, Vif>&  configured_vifs ()

Detailed Description

Constructor for a given address family, module ID, and event loop.

Parameters:

init_family	the address family (AF_INET or AF_INET6 for IPv4 and IPv6 respectively).
init_module_id	the module ID XORP_MODULE_* (xorp_module_id).
init_eventloop	the event loop to use.

[virtual]

Destructor

Reimplemented from ProtoState.

Reimplemented from ProtoState.

Reimplemented from ProtoState.

Reimplemented from ProtoState.

[const]

Map a vif name to a vif index.

Parameters:

vif_name

the vif name to map to a vif index.

Returns: the virtual interface index for vif name vif_name.

[const]

Find an unused vif index.

Returns: the smallest unused vif index if there is one available, otherwise return Vif::VIF_INDEX_INVALID.

[const]

Find a virtual interface for a given name.

Parameters:

name	the name to search for.

Returns: the virtual interface with name name if found, otherwise NULL.

[const]

Find a virtual interface for a given address.

Parameters:

ipaddr_test

the address to search for.

Returns: the virtual interface with address ipaddr_test if found, otherwise NULL.

[const]

Find a virtual interface for a given physical interface index.

Parameters:

pif_index

the physical interface index to search for.

Returns: the virtual interface with physical interface index pif_index if found, otherwise NULL.

[const]

Find a virtual interface for a given virtual interface index.

Parameters:

vif_index

the virtual interface index to search for.

Returns: the vvirtual interface with virtual interface index vif_index if found, otherwise NULL.

[const]

Find a virtual interface that is directly connected to the given address.

Parameters:

ipaddr_test

the address to search by.

Returns: the virtual interface that is directly connected to address ipaddr_test if found, otherwise NULL.

[const]

Test if an address is directly connected to one of my virtual interfaces.

Parameters:

ipaddr_test

the address to test.

Returns: true if ipaddr_test is directly connected to one of my virtual interfaces, otherwise false.

[const]

Test if an address belongs to one of my virtual interfaces.

Parameters:

ipaddr_test

the address to test.

Returns: true if ipaddr_test belongs to one of my virtual interfaces, otherwise false.

Add a virtual interface.

Parameters:

vif	a pointer to the virtual interface to add.

Returns: XORP_OK on success, otherwise XORP_ERROR.

Delete a virtual interface.

Note: the vif itself is not deleted, only its place in the array of protocol vifs.

Parameters:

vif	a pointer to the virtual interface to delete.

Returns: XORP_OK on success, otherwise XORP_ERROR.

Get the array of pointers to the virtual interfaces.

Returns: the array of pointers to the virtual interfaces.

[const]

Get the maximum number of vifs.

Note: the interfaces that are not configured or are down are also included.

Returns: the maximum number of vifs we can have.

Get the event loop this node is added to.

Returns: the event loop this node is added to.

[const]

Test if the vif setup is completed.

Returns: true if the vif setup is completed, otherwise false.

Set/reset the flag that indicates whether the vif setup is completed.

Parameters:

v	if true, set the flag that the vif setup is completed, otherwise reset it.

[pure virtual]

Receive a protocol message.

This is a pure virtual function, and it must be implemented by the particular protocol node class that inherits this base class.

Parameters:

src_module_instance_name	the module instance name of the module-origin of the message.
src_module_id	the module ID (xorp_module_id) of the module-origin of the message.
vif_index	the vif index of the interface used to receive this message.
src	the source address of the message.
dst	the destination address of the message.
ip_ttl	the IP TTL (Time To Live) of the message. If it has a negative value, it should be ignored.
ip_tos	the IP TOS (Type of Service) of the message. If it has a negative value, it should be ignored.
router_alert_bool	if true, the ROUTER_ALERT IP option for the IP packet of the incoming message was set.
rcvbuf	the data buffer with the received message.
rcvlen	the data length in rcvbuf.

Returns: XORP_OK on success, otherwise XORP_ERROR.

[pure virtual]

Send a protocol message.

This is a pure virtual function, and it must be implemented by the particular protocol node class that inherits this base class.

Parameters:

dst_module_instance_name	the module instance name of the module-recepient of the message.
dst_module_id	the module ID (xorp_module_id) of the module-recepient of the message.
vif_index	the vif index of the interface to send this message.
src	the source address of the message.
dst	the destination address of the message.
ip_ttl	the IP TTL of the message. If it has a negative value, the TTL will be set by the lower layers.
ip_tos	the IP TOS of the message. If it has a negative value, the TOS will be set by the lower layers.
router_alert_bool	if true, set the ROUTER_ALERT IP option for the IP packet of the outgoung message.
sndbuf	the data buffer with the outgoing message.
sndlen	the data length in sndbuf.

Returns: XORP_OK on success, otherwise XORP_ERROR.

[pure virtual]

Receive a signal message.

This is a pure virtual function, and it must be implemented by the particular protocol node class that inherits this base class.

Parameters:

src_module_instance_name	the module instance name of the module-origin of the message.
src_module_id	the module ID (xorp_module_id) of the module-origin of the message.
message_type	the message type. The particular values are specific for the origin and recepient of this signal message.
vif_index	the vif index of the related interface (message-specific relation).
src	the source address of the message. The exact meaning of this address is message-specific.
dst	the destination address of the message. The exact meaning of this address is message-specific.
rcvbuf	the data buffer with the additional information in the message.
rcvlen	the data length in rcvbuf.

Returns: XORP_OK on success, otherwise XORP_ERROR.

[pure virtual]

Send a signal message.

This is a pure virtual function, and it must be implemented by the particular protocol node class that inherits this base class.

Parameters:

dst_module_instance_name	the module instance name of the module-recepient of the message.
dst_module_id	the module ID (xorp_module_id) of the module-recepient of the message.
message_type	the message type. The particular values are specific for the origin and recepient of this signal message.
vif_index	the vif index of the related interface (message-specific relation).
src	the source address of the message. The exact meaning of this address is message-specific.
dst	the destination address of the message. The exact meaning of this address is message-specific.
sndbuf	the data buffer with the outgoing message.
sndlen	the data length in sndbuf.

Returns: XORP_OK on success, otherwise XORP_ERROR.

[const]

Get the node status (see ProcessStatus).

Returns: the node status (see ProcessStatus).

Set the node status (see ProcessStatus).

Parameters:

v	the value to set the node status to.

Start a set of configuration changes.

Note that it may change the node status.

Parameters:

reason

return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

End a set of configuration changes.

Note that it may change the node status.

Parameters:

reason

return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

[const]

Find an unused vif index from the set of configured vifs.

Returns: the smallest unused vif index from the set of configured vifs if there is one available, otherwise return Vif::VIF_INDEX_INVALID.

Add a configured vif.

Parameters:

vif	the vif with the information to add.
reason	return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

Add a configured vif.

Parameters:

vif_name	the name of the vif to add.
vif_index	the vif index of the vif to add.
reason	return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

Delete a configured vif.

Parameters:

vif_name	the name of the vif to delete.
reason	return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

Add an address to a configured vif.

Parameters:

vif_name	the name of the vif.
addr	the address to add.
subnet	the subnet address to add.
broadcast	the broadcast address to add.
peer	the peer address to add.
reason	return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

Delete an address from a configured vif.

Parameters:

vif_name	the name of the vif.
addr	the address to delete.
reason	return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

Set the vif flags to a configured vif.

Parameters:

vif_name	the name of the vif.
is_pim_register	true if the vif is a PIM Register interface.
is_p2p	true if the vif is point-to-point interface.
is_loopback	true if the vif is a loopback interface.
is_multicast	true if the vif is multicast capable.
is_broadcast	true if the vif is broadcast capable.
is_up	true if the underlying vif is UP.
reason	return-by-reference string that contains human-readable string with information about the reason for failure (if any).

Returns: XORP_OK on success, otherwise XORP_ERROR.

Get the map with configured vifs.

Returns: a reference for the map with configured vifs.