A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ns3::ArpL3Protocol Class Reference

An implementation of the ARP protocol. More...

#include <arp-l3-protocol.h>

+ Inheritance diagram for ns3::ArpL3Protocol:
+ Collaboration diagram for ns3::ArpL3Protocol:

Public Member Functions

 ArpL3Protocol ()
 
virtual ~ArpL3Protocol ()
 
int64_t AssignStreams (int64_t stream)
 Assign a fixed random variable stream number to the random variables used by this model. More...
 
Ptr< ArpCacheCreateCache (Ptr< NetDevice > device, Ptr< Ipv4Interface > interface)
 Create an ARP cache for the device/interface. More...
 
bool Lookup (Ptr< Packet > p, Ipv4Address destination, Ptr< NetDevice > device, Ptr< ArpCache > cache, Address *hardwareDestination)
 Perform an ARP lookup. More...
 
void Receive (Ptr< NetDevice > device, Ptr< const Packet > p, uint16_t protocol, const Address &from, const Address &to, NetDevice::PacketType packetType)
 Receive a packet. More...
 
void SetNode (Ptr< Node > node)
 Set the node the ARP L3 protocol is associated with. More...
 
- Public Member Functions inherited from ns3::Object
 Object ()
 
virtual ~Object ()
 
void AggregateObject (Ptr< Object > other)
 
void Dispose (void)
 Run the DoDispose methods of this object and all the objects aggregated to it. More...
 
AggregateIterator GetAggregateIterator (void) const
 
virtual TypeId GetInstanceTypeId (void) const
 
template<typename T >
Ptr< T > GetObject (void) const
 
template<typename T >
Ptr< T > GetObject (TypeId tid) const
 
void Initialize (void)
 This method calls the virtual DoInitialize method on all the objects aggregated to this object. More...
 
- Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
 SimpleRefCount ()
 Constructor. More...
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor. More...
 
uint32_t GetReferenceCount (void) const
 Get the reference count of the object. More...
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment. More...
 
void Ref (void) const
 Increment the reference count. More...
 
void Unref (void) 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
 
bool GetAttributeFailSafe (std::string name, AttributeValue &attribute) const
 
void SetAttribute (std::string name, const AttributeValue &value)
 
bool SetAttributeFailSafe (std::string name, const AttributeValue &value)
 
bool TraceConnect (std::string name, std::string context, const CallbackBase &cb)
 
bool TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
 
bool TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
 
bool TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
 

Static Public Member Functions

static TypeId GetTypeId (void)
 Get the type ID. More...
 
- Static Public Member Functions inherited from ns3::Object
static TypeId GetTypeId (void)
 Register this type. More...
 
- Static Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
static void Cleanup (void)
 Noop. More...
 
- Static Public Member Functions inherited from ns3::ObjectBase
static TypeId GetTypeId (void)
 Get the type ID. More...
 

Static Public Attributes

static const uint16_t PROT_NUMBER = 0x0806
 ARP protocol number (0x0806) More...
 

Protected Member Functions

virtual void DoDispose (void)
 This method is called by Object::Dispose or by the object's destructor, whichever comes first. More...
 
virtual void NotifyNewAggregate ()
 This method is invoked whenever two sets of objects are aggregated together. More...
 
- Protected Member Functions inherited from ns3::Object
 Object (const Object &o)
 
virtual void DoInitialize (void)
 This method is called only once by Object::Initialize. More...
 
- Protected Member Functions inherited from ns3::ObjectBase
void ConstructSelf (const AttributeConstructionList &attributes)
 
virtual void NotifyConstructionCompleted (void)
 This method is invoked once all member attributes have been initialized. More...
 

Private Types

typedef std::list< Ptr
< ArpCache > > 
CacheList
 container of the ARP caches More...
 

Private Member Functions

 ArpL3Protocol (const ArpL3Protocol &o)
 Copy constructor. More...
 
Ptr< ArpCacheFindCache (Ptr< NetDevice > device)
 Finds the cache associated with a NetDevice. More...
 
ArpL3Protocoloperator= (const ArpL3Protocol &o)
 Copy constructor. More...
 
void SendArpReply (Ptr< const ArpCache > cache, Ipv4Address myIp, Ipv4Address toIp, Address toMac)
 Send an ARP reply to an host. More...
 
void SendArpRequest (Ptr< const ArpCache >cache, Ipv4Address to)
 Send an ARP request to an host. More...
 

Private Attributes

CacheList m_cacheList
 ARP cache container. More...
 
TracedCallback< Ptr< const
Packet > > 
m_dropTrace
 trace for packets dropped by ARP More...
 
Ptr< Nodem_node
 node the ARP L3 protocol is associated with More...
 
Ptr< RandomVariableStreamm_requestJitter
 jitter to de-sync ARP requests More...
 

Detailed Description

An implementation of the ARP protocol.

Config Paths

ns3::ArpL3Protocol is accessible through the following paths with Config::Set and Config::Connect:

  • /NodeList/[i]/$ns3::ArpL3Protocol

Attributes

  • CacheList: The list of ARP caches
  • RequestJitter: The jitter in ms a node is allowed to wait before sending an ARP request. Some jitter aims to prevent collisions. By default, the model will wait for a duration in ms defined by a uniform random-variable between 0 and RequestJitter

TraceSources

  • Drop: Packet dropped because not enough room in pending queue for a specific cache entry.

Definition at line 49 of file arp-l3-protocol.h.

Member Typedef Documentation

container of the ARP caches

Definition at line 119 of file arp-l3-protocol.h.

Constructor & Destructor Documentation

ns3::ArpL3Protocol::ArpL3Protocol ( )

Definition at line 66 of file arp-l3-protocol.cc.

References NS_LOG_FUNCTION.

ns3::ArpL3Protocol::~ArpL3Protocol ( )
virtual

Definition at line 71 of file arp-l3-protocol.cc.

References NS_LOG_FUNCTION.

ns3::ArpL3Protocol::ArpL3Protocol ( const ArpL3Protocol o)
private

Copy constructor.

Defined and unimplemented to avoid misuse

Parameters
o

Member Function Documentation

int64_t ns3::ArpL3Protocol::AssignStreams ( int64_t  stream)

Assign a fixed random variable stream number to the random variables used by this model.

Return the number of streams (possibly zero) that have been assigned.

Parameters
streamfirst stream index to use
Returns
the number of stream indices assigned by this model

Definition at line 77 of file arp-l3-protocol.cc.

References m_requestJitter, NS_LOG_FUNCTION, and ns3::RandomVariableStream::SetStream().

+ Here is the call graph for this function:

Ptr< ArpCache > ns3::ArpL3Protocol::CreateCache ( Ptr< NetDevice device,
Ptr< Ipv4Interface interface 
)

Create an ARP cache for the device/interface.

Parameters
devicethe NetDevice
interfacethe Ipv4Interface
Returns
a smart pointer to the ARP cache

Definition at line 127 of file arp-l3-protocol.cc.

References ns3::ArpCache::Flush(), ns3::Object::GetObject(), m_cacheList, m_node, ns3::MakeCallback(), NS_ASSERT, NS_LOG_FUNCTION, SendArpRequest(), and ns3::ArpCache::SetDevice().

+ Here is the call graph for this function:

void ns3::ArpL3Protocol::DoDispose ( void  )
protectedvirtual

This method is called by Object::Dispose or by the object's destructor, whichever comes first.

Subclasses are expected to implement their real destruction code in an overriden version of this method and chain up to their parent's implementation once they are done. i.e., for simplicity, the destructor of every subclass should be empty and its content should be moved to the associated DoDispose method.

It is safe to call GetObject from within this method.

Reimplemented from ns3::Object.

Definition at line 113 of file arp-l3-protocol.cc.

References ns3::Object::Dispose(), ns3::Object::DoDispose(), m_cacheList, m_node, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

Ptr< ArpCache > ns3::ArpL3Protocol::FindCache ( Ptr< NetDevice device)
private

Finds the cache associated with a NetDevice.

Parameters
devicethe NetDevice
Returns
the ARP cache, or null if no cache is found

Definition at line 141 of file arp-l3-protocol.cc.

References m_cacheList, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by Receive().

+ Here is the caller graph for this function:

TypeId ns3::ArpL3Protocol::GetTypeId ( void  )
static

Get the type ID.

Returns
the object TypeId

Definition at line 45 of file arp-l3-protocol.cc.

References m_cacheList, m_dropTrace, m_requestJitter, ns3::MakeObjectVectorAccessor(), ns3::MakeTraceSourceAccessor(), and ns3::TypeId::SetParent().

+ Here is the call graph for this function:

bool ns3::ArpL3Protocol::Lookup ( Ptr< Packet p,
Ipv4Address  destination,
Ptr< NetDevice device,
Ptr< ArpCache cache,
Address hardwareDestination 
)

Perform an ARP lookup.

Parameters
pthe packet
destinationdestination IP address
deviceoutgoing device
cacheARP cache
hardwareDestinationfilled with the destination MAC address (if the entry exists)
Returns
true if there is a matching ARP Entry

Definition at line 259 of file arp-l3-protocol.cc.

References ns3::ArpCache::Add(), ns3::Node::GetId(), ns3::ArpCache::Entry::GetMacAddress(), ns3::RandomVariableStream::GetValue(), ns3::ArpCache::Entry::IsAlive(), ns3::ArpCache::Entry::IsDead(), ns3::ArpCache::Entry::IsExpired(), ns3::ArpCache::Entry::IsWaitReply(), ns3::ArpCache::Lookup(), m_dropTrace, m_node, m_requestJitter, ns3::ArpCache::Entry::MarkWaitReply(), NS_FATAL_ERROR, NS_LOG_FUNCTION, NS_LOG_LOGIC, ns3::Simulator::Schedule(), SendArpRequest(), and ns3::ArpCache::Entry::UpdateWaitReply().

+ Here is the call graph for this function:

void ns3::ArpL3Protocol::NotifyNewAggregate ( void  )
protectedvirtual

This method is invoked whenever two sets of objects are aggregated together.

This function must be implemented in the stack that needs to notify other stacks connected to the node of their presence in the node.

It is invoked exactly once for each object in both sets. This method can be overriden by subclasses who wish to be notified of aggregation events. These subclasses must chain up to their base class NotifyNewAggregate method. It is safe to call GetObject and AggregateObject from within this method.

Reimplemented from ns3::Object.

Definition at line 96 of file arp-l3-protocol.cc.

References m_node, ns3::Object::NotifyNewAggregate(), NS_LOG_FUNCTION, and SetNode().

+ Here is the call graph for this function:

ArpL3Protocol& ns3::ArpL3Protocol::operator= ( const ArpL3Protocol o)
private

Copy constructor.

Defined and unimplemented to avoid misuse

Parameters
o
Returns
void ns3::ArpL3Protocol::Receive ( Ptr< NetDevice device,
Ptr< const Packet p,
uint16_t  protocol,
const Address from,
const Address to,
NetDevice::PacketType  packetType 
)

Receive a packet.

Parameters
devicethe source NetDevice
pthe packet
protocolthe protocol
fromthe source address
tothe destination address
packetTypetype of packet (i.e., unicast, multicast, etc.)
Internal:
Note: we do not update the ARP cache when we receive an ARP request from an unknown node. See Bug 107

Definition at line 157 of file arp-l3-protocol.cc.

References ns3::Packet::Copy(), ns3::ArpCache::Entry::DequeuePending(), FindCache(), ns3::ArpHeader::GetDestinationHardwareAddress(), ns3::ArpHeader::GetDestinationIpv4Address(), ns3::Node::GetId(), ns3::Packet::GetSize(), ns3::ArpHeader::GetSourceHardwareAddress(), ns3::ArpHeader::GetSourceIpv4Address(), ns3::Ipv4Address::IsEqual(), ns3::ArpHeader::IsReply(), ns3::ArpHeader::IsRequest(), ns3::ArpCache::Entry::IsWaitReply(), m_dropTrace, m_node, ns3::ArpCache::Entry::MarkAlive(), NS_LOG_FUNCTION, NS_LOG_LOGIC, and SendArpReply().

Referenced by ns3::Ipv4L3Protocol::AddInterface().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::ArpL3Protocol::SendArpReply ( Ptr< const ArpCache cache,
Ipv4Address  myIp,
Ipv4Address  toIp,
Address  toMac 
)
private

Send an ARP reply to an host.

Parameters
cachethe ARP cache to use
myIpthe source IP address
toIpthe destination IP
toMacthe destination MAC address

Definition at line 349 of file arp-l3-protocol.cc.

References ns3::Packet::AddHeader(), ns3::Node::GetId(), m_node, NS_LOG_FUNCTION, NS_LOG_LOGIC, PROT_NUMBER, and ns3::ArpHeader::SetReply().

Referenced by Receive().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::ArpL3Protocol::SendArpRequest ( Ptr< const ArpCache cache,
Ipv4Address  to 
)
private

Send an ARP request to an host.

Parameters
cachethe ARP cache to use
tothe destination IP

Definition at line 328 of file arp-l3-protocol.cc.

References ns3::Packet::AddHeader(), ns3::Node::GetId(), ns3::Object::GetObject(), ns3::Ipv4InterfaceAddress::GLOBAL, m_node, NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_LOGIC, PROT_NUMBER, ns3::Ipv4Header::SetDestination(), and ns3::ArpHeader::SetRequest().

Referenced by CreateCache(), and Lookup().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::ArpL3Protocol::SetNode ( Ptr< Node node)

Set the node the ARP L3 protocol is associated with.

Parameters
nodethe node

Definition at line 85 of file arp-l3-protocol.cc.

References m_node, and NS_LOG_FUNCTION.

Referenced by NotifyNewAggregate().

+ Here is the caller graph for this function:

Member Data Documentation

CacheList ns3::ArpL3Protocol::m_cacheList
private

ARP cache container.

Definition at line 158 of file arp-l3-protocol.h.

Referenced by CreateCache(), DoDispose(), FindCache(), and GetTypeId().

TracedCallback<Ptr<const Packet> > ns3::ArpL3Protocol::m_dropTrace
private

trace for packets dropped by ARP

Definition at line 160 of file arp-l3-protocol.h.

Referenced by GetTypeId(), Lookup(), and Receive().

Ptr<Node> ns3::ArpL3Protocol::m_node
private

node the ARP L3 protocol is associated with

Definition at line 159 of file arp-l3-protocol.h.

Referenced by CreateCache(), DoDispose(), Lookup(), NotifyNewAggregate(), Receive(), SendArpReply(), SendArpRequest(), and SetNode().

Ptr<RandomVariableStream> ns3::ArpL3Protocol::m_requestJitter
private

jitter to de-sync ARP requests

Definition at line 161 of file arp-l3-protocol.h.

Referenced by AssignStreams(), GetTypeId(), and Lookup().

const uint16_t ns3::ArpL3Protocol::PROT_NUMBER = 0x0806
static

ARP protocol number (0x0806)

Definition at line 57 of file arp-l3-protocol.h.

Referenced by ns3::Ipv4L3Protocol::AddInterface(), SendArpReply(), and SendArpRequest().


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