Abstract base class for IPv4 routing protocols. More...
#include "ipv4-routing-protocol.h"
Public Types | |
typedef Callback< void, Ptr< const Packet >, const Ipv4Header &, Socket::SocketErrno > | ErrorCallback |
Callback for routing errors (e.g., no route found) More... | |
typedef Callback< void, Ptr< const Packet >, const Ipv4Header &, uint32_t > | LocalDeliverCallback |
Callback for packets to be locally delivered. More... | |
typedef Callback< void, Ptr< Ipv4MulticastRoute >, Ptr< const Packet >, const Ipv4Header & > | MulticastForwardCallback |
Callback for multicast packets to be forwarded. More... | |
typedef Callback< void, Ptr< Ipv4Route >, Ptr< const Packet >, const Ipv4Header & > | UnicastForwardCallback |
Callback for unicast packets to be forwarded. More... | |
Public Member Functions | |
virtual void | NotifyAddAddress (uint32_t interface, Ipv4InterfaceAddress address)=0 |
virtual void | NotifyInterfaceDown (uint32_t interface)=0 |
virtual void | NotifyInterfaceUp (uint32_t interface)=0 |
virtual void | NotifyRemoveAddress (uint32_t interface, Ipv4InterfaceAddress address)=0 |
virtual void | PrintRoutingTable (Ptr< OutputStreamWrapper > stream, Time::Unit unit=Time::S) const =0 |
Print the Routing Table entries. More... | |
virtual bool | RouteInput (Ptr< const Packet > p, const Ipv4Header &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) More... | |
virtual Ptr< Ipv4Route > | RouteOutput (Ptr< Packet > p, const Ipv4Header &header, Ptr< NetDevice > oif, Socket::SocketErrno &sockerr)=0 |
Query routing cache for an existing route, for an outbound packet. More... | |
virtual void | SetIpv4 (Ptr< Ipv4 > ipv4)=0 |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. More... | |
~Object () override | |
Destructor. More... | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. More... | |
void | Dispose () |
Dispose of this Object. More... | |
AggregateIterator | GetAggregateIterator () const |
Get an iterator to the Objects aggregated to this one. More... | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. More... | |
template<typename T > | |
Ptr< T > | GetObject () const |
Get a pointer to the requested aggregated Object. More... | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. More... | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. More... | |
void | Initialize () |
Invoke DoInitialize on all Objects aggregated to this one. More... | |
bool | IsInitialized () const |
Check if the object has been initialized. More... | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. More... | |
SimpleRefCount (const SimpleRefCount &o[[maybe_unused]]) | |
Copy constructor. More... | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= (const SimpleRefCount &o[[maybe_unused]]) |
Assignment operator. More... | |
void | Ref () const |
Increment the reference count. More... | |
void | Unref () const |
Decrement the reference count. More... | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. More... | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. More... | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. More... | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. More... | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. More... | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. More... | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. More... | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. More... | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. More... | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId () |
Register this type. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. More... | |
virtual void | DoDispose () |
Destructor implementation. More... | |
virtual void | DoInitialize () |
Initialize() implementation. More... | |
virtual void | NotifyNewAggregate () |
Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. More... | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. More... | |
Related Functions inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
Abstract base class for IPv4 routing protocols.
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().
Definition at line 57 of file ipv4-routing-protocol.h.
typedef Callback<void, Ptr<const Packet>, const Ipv4Header&, Socket::SocketErrno> ns3::Ipv4RoutingProtocol::ErrorCallback |
Callback for routing errors (e.g., no route found)
Definition at line 78 of file ipv4-routing-protocol.h.
typedef Callback<void, Ptr<const Packet>, const Ipv4Header&, uint32_t> ns3::Ipv4RoutingProtocol::LocalDeliverCallback |
Callback for packets to be locally delivered.
Definition at line 75 of file ipv4-routing-protocol.h.
typedef Callback<void, Ptr<Ipv4MulticastRoute>, Ptr<const Packet>, const Ipv4Header&> ns3::Ipv4RoutingProtocol::MulticastForwardCallback |
Callback for multicast packets to be forwarded.
Definition at line 72 of file ipv4-routing-protocol.h.
typedef Callback<void, Ptr<Ipv4Route>, Ptr<const Packet>, const Ipv4Header&> ns3::Ipv4RoutingProtocol::UnicastForwardCallback |
Callback for unicast packets to be forwarded.
Definition at line 68 of file ipv4-routing-protocol.h.
|
static |
Get the type ID.
Definition at line 31 of file ipv4-routing-protocol.cc.
References ns3::TypeId::SetParent().
|
pure virtual |
interface | the index of the interface we are being notified about |
address | a new address being added to an interface |
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.
Implemented in ns3::olsr::RoutingProtocol, ns3::Ipv4BRouting, ns3::Ipv4ARouting, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, and ns3::aodv::RoutingProtocol.
|
pure virtual |
interface | the index of the interface we are being notified about |
Protocols are expected to implement this method to be notified of the state change of an interface in a node.
Implemented in ns3::olsr::RoutingProtocol, ns3::Ipv4BRouting, ns3::Ipv4ARouting, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, and ns3::aodv::RoutingProtocol.
|
pure virtual |
interface | the index of the interface we are being notified about |
Protocols are expected to implement this method to be notified of the state change of an interface in a node.
Implemented in ns3::olsr::RoutingProtocol, ns3::Ipv4BRouting, ns3::Ipv4ARouting, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, and ns3::aodv::RoutingProtocol.
|
pure virtual |
interface | the index of the interface we are being notified about |
address | a new address being added to an interface |
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.
Implemented in ns3::olsr::RoutingProtocol, ns3::Ipv4BRouting, ns3::Ipv4ARouting, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, and ns3::aodv::RoutingProtocol.
|
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::olsr::RoutingProtocol, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, ns3::aodv::RoutingProtocol, ns3::Ipv4BRouting, and ns3::Ipv4ARouting.
|
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 Ipv4RoutingProtocol, 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::olsr::RoutingProtocol, ns3::Ipv4BRouting, ns3::Ipv4ARouting, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, and ns3::aodv::RoutingProtocol.
|
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()
The header input parameter may have an uninitialized value for the source address, but the destination address should always be properly set by the caller.
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 Netdevice. May be zero, or may be bound via socket options to a particular output interface. |
sockerr | Output parameter; socket errno |
Implemented in ns3::olsr::RoutingProtocol, ns3::Ipv4BRouting, ns3::Ipv4ARouting, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, and ns3::aodv::RoutingProtocol.
ipv4 | the ipv4 object this routing protocol is being associated with |
Typically, invoked directly or indirectly from ns3::Ipv4::SetRoutingProtocol
Implemented in ns3::olsr::RoutingProtocol, ns3::Ipv4BRouting, ns3::Ipv4ARouting, ns3::Rip, ns3::Ipv4StaticRouting, ns3::Ipv4ListRouting, ns3::Ipv4GlobalRouting, ns3::dsdv::RoutingProtocol, ns3::Ipv4ClickRouting, and ns3::aodv::RoutingProtocol.