Interface for L2 mesh routing protocol and mesh point communication. More...
#include "mesh-l2-routing-protocol.h"
Public Types | |
typedef Callback< void, bool, Ptr< Packet >, Mac48Address, Mac48Address, uint16_t, uint32_t > | RouteReplyCallback |
Callback to be invoked when route discovery procedure is completed. More... | |
Public Member Functions | |
~MeshL2RoutingProtocol () override | |
virtual D-tor for subclasses More... | |
Ptr< MeshPointDevice > | GetMeshPoint () const |
Each mesh protocol must be installed on the mesh point to work. More... | |
virtual bool | RemoveRoutingStuff (uint32_t fromIface, const Mac48Address source, const Mac48Address destination, Ptr< Packet > packet, uint16_t &protocolType)=0 |
When packet is ready to go to upper layer, protocol must remove all its information: tags, header, etc. More... | |
virtual bool | RequestRoute (uint32_t sourceIface, const Mac48Address source, const Mac48Address destination, Ptr< const Packet > packet, uint16_t protocolType, RouteReplyCallback routeReply)=0 |
Request routing information, all packets must go through this request. More... | |
void | SetMeshPoint (Ptr< MeshPointDevice > mp) |
Set host mesh point, analog of SetNode (...) methods for upper layer protocols. More... | |
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... | |
Protected Attributes | |
Ptr< MeshPointDevice > | m_mp |
Host mesh point. 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... | |
Interface for L2 mesh routing protocol and mesh point communication.
Every mesh routing protocol must implement this interface. Each mesh point (MeshPointDevice) is supposed to know single L2RoutingProtocol to work with, see MeshPointDevice::SetRoutingProtocol ().
This interface is similar to ipv4 routing protocol base class.
Definition at line 45 of file mesh-l2-routing-protocol.h.
typedef Callback<void, bool, Ptr<Packet>, Mac48Address, Mac48Address, uint16_t, uint32_t > ns3::MeshL2RoutingProtocol::RouteReplyCallback |
Callback to be invoked when route discovery procedure is completed.
flag | indicating whether a route was actually found and all needed information is added to the packet successfully |
packet | for which the route was resolved. All routing information for MAC layer must be stored in proper tags (like in case of HWMP, when WifiMacHeader needs address of next hop), or must be added as a packet header (if MAC does not need any additional information). So, the packet is returned back to MeshPointDevice looks like a pure packet with ethernet header (i.e data + src +dst + protocol). The only special information addressed to MeshPointDevice is an outcoming interface ID. |
src | source address of the packet |
dst | destination address of the packet |
protocol | ethernet 'Protocol' field, needed to form a proper MAC-layer header |
uint32_t | outcoming interface to use or 0xffffffff if packet should be sent by ALL interfaces |
Definition at line 86 of file mesh-l2-routing-protocol.h.
|
override |
virtual D-tor for subclasses
Definition at line 42 of file mesh-l2-routing-protocol.cc.
References m_mp.
Ptr< MeshPointDevice > ns3::MeshL2RoutingProtocol::GetMeshPoint | ( | ) | const |
Each mesh protocol must be installed on the mesh point to work.
Definition at line 54 of file mesh-l2-routing-protocol.cc.
References m_mp.
Referenced by ns3::dot11s::HwmpProtocol::ForwardPathError(), ns3::dot11s::HwmpProtocol::ForwardUnicast(), ns3::dot11s::HwmpProtocol::ReceivePrep(), ns3::dot11s::HwmpProtocol::ReceivePreq(), and ns3::dot11s::HwmpProtocol::RequestRoute().
|
static |
Get the type ID.
Definition at line 35 of file mesh-l2-routing-protocol.cc.
References ns3::TypeId::SetParent().
|
pure virtual |
When packet is ready to go to upper layer, protocol must remove all its information: tags, header, etc.
So, MeshPointDevice must call this method when passing a packet to upper layer.
fromIface | the incoming interface of the packet |
source | source address |
destination | destination address |
packet | the packet to be handled |
protocolType | protocol ID, needed to form a proper MAC-layer header |
Implemented in ns3::flame::FlameProtocol, and ns3::dot11s::HwmpProtocol.
|
pure virtual |
Request routing information, all packets must go through this request.
Note that route discovery works async. – RequestRoute returns immediately, while reply callback will be called when routing information will be available.
sourceIface | the incoming interface of the packet |
source | source address |
destination | destination address |
packet | the packet to be resolved (needed the whole packet, because routing information is added as tags or headers). The packet will be returned to reply callback. |
protocolType | protocol ID, needed to form a proper MAC-layer header |
routeReply | callback to be invoked after route discovery procedure, supposed to really send packet using routing information. |
Implemented in ns3::flame::FlameProtocol, and ns3::dot11s::HwmpProtocol.
void ns3::MeshL2RoutingProtocol::SetMeshPoint | ( | Ptr< MeshPointDevice > | mp | ) |
Set host mesh point, analog of SetNode (...) methods for upper layer protocols.
mp | the mesh point device |
Definition at line 48 of file mesh-l2-routing-protocol.cc.
References m_mp.
|
protected |
Host mesh point.
Definition at line 143 of file mesh-l2-routing-protocol.h.
Referenced by ~MeshL2RoutingProtocol(), ns3::dot11s::HwmpProtocol::DoDispose(), ns3::flame::FlameProtocol::DoDispose(), GetMeshPoint(), ns3::dot11s::HwmpProtocol::Install(), ns3::flame::FlameProtocol::Install(), ns3::flame::FlameProtocol::RemoveRoutingStuff(), ns3::flame::FlameProtocol::RequestRoute(), and SetMeshPoint().