Abstract base class for IPv6 routing protocols. More...
#include "ipv6-routing-protocol.h"
Public Types | |
typedef Callback< void, Ptr< const Packet >, const Ipv6Header &, Socket::SocketErrno > | ErrorCallback |
Callback for routing errors (e.g., no route found) | |
typedef Callback< void, Ptr< const Packet >, const Ipv6Header &, uint32_t > | LocalDeliverCallback |
Callback for packets to be locally delivered. | |
typedef Callback< void, Ptr< const NetDevice >, Ptr< Ipv6MulticastRoute >, Ptr< const Packet >, const Ipv6Header & > | MulticastForwardCallback |
Callback for multicast packets to be forwarded. | |
typedef Callback< void, Ptr< const NetDevice >, Ptr< Ipv6Route >, Ptr< const Packet >, const Ipv6Header & > | UnicastForwardCallback |
Callback for unicast packets to be forwarded. | |
Public Member Functions | |
virtual void | NotifyAddAddress (uint32_t interface, Ipv6InterfaceAddress address)=0 |
Notify when specified interface add an address. | |
virtual void | NotifyAddRoute (Ipv6Address dst, Ipv6Prefix mask, Ipv6Address nextHop, uint32_t interface, Ipv6Address prefixToUse=Ipv6Address::GetZero())=0 |
Notify a new route. | |
virtual void | NotifyInterfaceDown (uint32_t interface)=0 |
Notify when specified interface goes DOWN. | |
virtual void | NotifyInterfaceUp (uint32_t interface)=0 |
Notify when specified interface goes UP. | |
virtual void | NotifyRemoveAddress (uint32_t interface, Ipv6InterfaceAddress address)=0 |
Notify when specified interface add an address. | |
virtual void | NotifyRemoveRoute (Ipv6Address dst, Ipv6Prefix mask, Ipv6Address nextHop, uint32_t interface, Ipv6Address prefixToUse=Ipv6Address::GetZero())=0 |
Notify route removing. | |
virtual void | PrintRoutingTable (Ptr< OutputStreamWrapper > stream, Time::Unit unit=Time::S) const =0 |
Print the Routing Table entries. | |
virtual bool | RouteInput (Ptr< const Packet > p, const Ipv6Header &header, Ptr< const NetDevice > idev, const UnicastForwardCallback &ucb, const MulticastForwardCallback &mcb, const LocalDeliverCallback &lcb, const ErrorCallback &ecb)=0 |
Route an input packet (to be forwarded or locally delivered) | |
virtual Ptr< Ipv6Route > | RouteOutput (Ptr< Packet > p, const Ipv6Header &header, Ptr< NetDevice > oif, Socket::SocketErrno &sockerr)=0 |
Query routing cache for an existing route, for an outbound packet. | |
virtual void | SetIpv6 (Ptr< Ipv6 > ipv6)=0 |
Typically, invoked directly or indirectly from ns3::Ipv6::SetRoutingProtocol. | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. | |
~Object () override | |
Destructor. | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. | |
void | Dispose () |
Dispose of this Object. | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. | |
bool | IsInitialized () const |
Check if the object has been initialized. | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. | |
virtual TypeId | GetInstanceTypeId () const =0 |
Get the most derived TypeId for this Object. | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId () |
Register this type. | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. | |
virtual void | DoDispose () |
Destructor implementation. | |
virtual void | DoInitialize () |
Initialize() implementation. | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. | |
Related Functions inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. | |
Abstract base class for IPv6 routing protocols.
Introspection did not find any typical Config paths.
Defines two virtual functions for packet routing and forwarding. The first, RouteOutput (), is used for locally originated packets, and the second, RouteInput (), is used for forwarding and/or delivering received packets. Also defines the signatures of four callbacks used in RouteInput ().
No Attributes are defined for this type.
No TraceSources are defined for this type.
Size of this type is 32 bytes (on a 64-bit architecture).
Definition at line 59 of file ipv6-routing-protocol.h.
typedef Callback<void, Ptr<const Packet>, const Ipv6Header&, Socket::SocketErrno> ns3::Ipv6RoutingProtocol::ErrorCallback |
Callback for routing errors (e.g., no route found)
Definition at line 88 of file ipv6-routing-protocol.h.
typedef Callback<void, Ptr<const Packet>, const Ipv6Header&, uint32_t> ns3::Ipv6RoutingProtocol::LocalDeliverCallback |
Callback for packets to be locally delivered.
Definition at line 85 of file ipv6-routing-protocol.h.
typedef Callback<void, Ptr<const NetDevice>, Ptr<Ipv6MulticastRoute>, Ptr<const Packet>, const Ipv6Header&> ns3::Ipv6RoutingProtocol::MulticastForwardCallback |
Callback for multicast packets to be forwarded.
Definition at line 82 of file ipv6-routing-protocol.h.
typedef Callback<void, Ptr<const NetDevice>, Ptr<Ipv6Route>, Ptr<const Packet>, const Ipv6Header&> ns3::Ipv6RoutingProtocol::UnicastForwardCallback |
Callback for unicast packets to be forwarded.
Definition at line 74 of file ipv6-routing-protocol.h.
|
static |
Get the type ID.
Definition at line 30 of file ipv6-routing-protocol.cc.
References ns3::TypeId::SetParent().
|
pure virtual |
Notify when specified interface add an address.
Protocols are expected to implement this method to be notified whenever a new address is added to an interface. Typically used to add a 'network route' on an interface. Can be invoked on an up or down interface.
interface | the index of the interface we are being notified about |
address | a new address being added to an interface |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.
|
pure virtual |
Notify a new route.
Typically this is used to add another route from IPv6 stack (i.e. ICMPv6 redirect case, ...).
dst | destination address |
mask | destination mask |
nextHop | nextHop for this destination |
interface | output interface |
prefixToUse | prefix to use as source with this route |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.
|
pure virtual |
Notify when specified interface goes DOWN.
Protocols are expected to implement this method to be notified of the state change of an interface in a node.
interface | the index of the interface we are being notified about |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.
|
pure virtual |
Notify when specified interface goes UP.
Protocols are expected to implement this method to be notified of the state change of an interface in a node.
interface | the index of the interface we are being notified about |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.
|
pure virtual |
Notify when specified interface add an address.
Protocols are expected to implement this method to be notified whenever a new address is removed from an interface. Typically used to remove the 'network route' of an interface. Can be invoked on an up or down interface.
interface | the index of the interface we are being notified about |
address | a new address being added to an interface |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.
|
pure virtual |
Notify route removing.
dst | destination address |
mask | destination mask |
nextHop | nextHop for this destination |
interface | output interface |
prefixToUse | prefix to use as source with this route |
Implemented in ns3::Ipv6ARouting, ns3::Ipv6BRouting, ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, and ns3::RipNg.
|
pure virtual |
Print the Routing Table entries.
stream | The ostream the Routing table is printed to |
unit | The time unit to be used in the report |
Implemented in ns3::Ipv6ARouting, ns3::Ipv6BRouting, ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, and ns3::RipNg.
|
pure virtual |
Route an input packet (to be forwarded or locally delivered)
This lookup is used in the forwarding process. The packet is handed over to the Ipv6RoutingProtocol, and will get forwarded onward by one of the callbacks. The Linux equivalent is ip_route_input (). There are four valid outcomes, and a matching callbacks to handle each.
p | received packet |
header | input parameter used to form a search key for a route |
idev | Pointer to ingress network device |
ucb | Callback for the case in which the packet is to be forwarded as unicast |
mcb | Callback for the case in which the packet is to be forwarded as multicast |
lcb | Callback for the case in which the packet is to be locally delivered |
ecb | Callback to call if there is an error in forwarding |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.
|
pure virtual |
Query routing cache for an existing route, for an outbound packet.
This lookup is used by transport protocols. It does not cause any packet to be forwarded, and is synchronous. Can be used for multicast or unicast. The Linux equivalent is ip_route_output ()
p | packet to be routed. Note that this method may modify the packet. Callers may also pass in a null pointer. |
header | input parameter (used to form key to search for the route) |
oif | Output interface device. May be zero, or may be bound via socket options to a particular output interface. |
sockerr | Output parameter; socket errno |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.
Typically, invoked directly or indirectly from ns3::Ipv6::SetRoutingProtocol.
ipv6 | the ipv6 object this routing protocol is being associated with |
Implemented in ns3::Ipv6ListRouting, ns3::Ipv6StaticRouting, ns3::RipNg, ns3::Ipv6ARouting, and ns3::Ipv6BRouting.