A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
ns3::ArpCache::Entry Class Reference

A record that that holds information about an ArpCache entry. More...

#include "arp-cache.h"

+ Collaboration diagram for ns3::ArpCache::Entry:

Public Member Functions

 Entry (ArpCache *arp)
 Constructor.
 
void ClearPendingPacket ()
 Clear the pending packet list.
 
void ClearRetries ()
 Zero the counter of number of retries for an entry.
 
Ipv4PayloadHeaderPair DequeuePending ()
 
Ipv4Address GetIpv4Address () const
 
Address GetMacAddress () const
 
uint32_t GetRetries () const
 
void IncrementRetries ()
 Increment the counter of number of retries for an entry.
 
bool IsAlive ()
 
bool IsAutoGenerated ()
 
bool IsDead ()
 
bool IsExpired () const
 
bool IsPermanent ()
 
bool IsWaitReply ()
 
void MarkAlive (Address macAddress)
 
void MarkAutoGenerated ()
 Changes the state of this entry to auto-generated.
 
void MarkDead ()
 Changes the state of this entry to dead.
 
void MarkPermanent ()
 Changes the state of this entry to Permanent.
 
void MarkWaitReply (Ipv4PayloadHeaderPair waiting)
 
void SetIpv4Address (Ipv4Address destination)
 
void SetMacAddress (Address macAddress)
 
void UpdateSeen ()
 Update the entry when seeing a packet.
 
bool UpdateWaitReply (Ipv4PayloadHeaderPair waiting)
 

Private Types

enum  ArpCacheEntryState_e {
  ALIVE , WAIT_REPLY , DEAD , PERMANENT ,
  STATIC_AUTOGENERATED
}
 ARP cache entry states. More...
 

Private Member Functions

Time GetTimeout () const
 Returns the entry timeout.
 

Private Attributes

ArpCachem_arp
 pointer to the ARP cache owning the entry
 
Ipv4Address m_ipv4Address
 entry's IP address
 
Time m_lastSeen
 last moment a packet from that address has been seen
 
Address m_macAddress
 entry's MAC address
 
std::list< Ipv4PayloadHeaderPairm_pending
 list of pending packets for the entry's IP
 
uint32_t m_retries
 retry counter
 
ArpCacheEntryState_e m_state
 state of the entry
 

Detailed Description

A record that that holds information about an ArpCache entry.

Definition at line 172 of file arp-cache.h.

Member Enumeration Documentation

◆ ArpCacheEntryState_e

ARP cache entry states.

Enumerator
ALIVE 
WAIT_REPLY 
DEAD 
PERMANENT 
STATIC_AUTOGENERATED 

Definition at line 285 of file arp-cache.h.

Constructor & Destructor Documentation

◆ Entry()

ns3::ArpCache::Entry::Entry ( ArpCache * arp)

Constructor.

Parameters
arpThe ArpCache this entry belongs to

Definition at line 370 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Member Function Documentation

◆ ClearPendingPacket()

void ns3::ArpCache::Entry::ClearPendingPacket ( )

Clear the pending packet list.

Definition at line 562 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::Remove().

+ Here is the caller graph for this function:

◆ ClearRetries()

void ns3::ArpCache::Entry::ClearRetries ( )

Zero the counter of number of retries for an entry.

Definition at line 591 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::HandleWaitReplyTimeout().

+ Here is the caller graph for this function:

◆ DequeuePending()

ArpCache::Ipv4PayloadHeaderPair ns3::ArpCache::Entry::DequeuePending ( )
Returns
0 is no packet is pending, the next packet to send if packets are pending.

Definition at line 545 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::HandleWaitReplyTimeout(), and ns3::ArpL3Protocol::Receive().

+ Here is the caller graph for this function:

◆ GetIpv4Address()

Ipv4Address ns3::ArpCache::Entry::GetIpv4Address ( ) const
Returns
The Ipv4Address for this entry

Definition at line 502 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::HandleWaitReplyTimeout().

+ Here is the caller graph for this function:

◆ GetMacAddress()

Address ns3::ArpCache::Entry::GetMacAddress ( ) const
Returns
The MacAddress of this entry

Definition at line 488 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Lookup(), ns3::ArpCache::LookupInverse(), ns3::aodv::Neighbors::LookupMacAddress(), and ns3::dsr::DsrRouteCache::LookupMacAddress().

+ Here is the caller graph for this function:

◆ GetRetries()

uint32_t ns3::ArpCache::Entry::GetRetries ( ) const
Returns
number of retries that have been sent for an ArpRequest in WaitReply state.

Definition at line 576 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::HandleWaitReplyTimeout().

+ Here is the caller graph for this function:

◆ GetTimeout()

Time ns3::ArpCache::Entry::GetTimeout ( ) const
private

Returns the entry timeout.

Returns
the entry timeout

Definition at line 516 of file arp-cache.cc.

References ALIVE, DEAD, ns3::Time::Max(), NS_LOG_FUNCTION, PERMANENT, STATIC_AUTOGENERATED, and WAIT_REPLY.

+ Here is the call graph for this function:

◆ IncrementRetries()

void ns3::ArpCache::Entry::IncrementRetries ( )

Increment the counter of number of retries for an entry.

Definition at line 583 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::HandleWaitReplyTimeout().

+ Here is the caller graph for this function:

◆ IsAlive()

bool ns3::ArpCache::Entry::IsAlive ( )
Returns
True if the state of this entry is alive; false otherwise.

Definition at line 386 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Lookup(), ns3::aodv::Neighbors::LookupMacAddress(), ns3::dsr::DsrRouteCache::LookupMacAddress(), and ns3::Ipv4L3Protocol::Receive().

+ Here is the caller graph for this function:

◆ IsAutoGenerated()

bool ns3::ArpCache::Entry::IsAutoGenerated ( )
Returns
True if the state of this entry is auto-generated; false otherwise.

Definition at line 407 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Lookup().

+ Here is the caller graph for this function:

◆ IsDead()

bool ns3::ArpCache::Entry::IsDead ( )
Returns
True if the state of this entry is dead; false otherwise.

Definition at line 379 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Lookup().

+ Here is the caller graph for this function:

◆ IsExpired()

bool ns3::ArpCache::Entry::IsExpired ( ) const
Returns
True if this entry has timed out; false otherwise.

This function returns true if the time elapsed strictly exceeds the timeout value (i.e., is not less than or equal to the timeout).

Definition at line 535 of file arp-cache.cc.

References ns3::Simulator::Now(), NS_LOG_DEBUG, NS_LOG_FUNCTION, and timeout.

Referenced by ns3::ArpL3Protocol::Lookup(), ns3::aodv::Neighbors::LookupMacAddress(), and ns3::dsr::DsrRouteCache::LookupMacAddress().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ IsPermanent()

bool ns3::ArpCache::Entry::IsPermanent ( )
Returns
True if the state of this entry is permanent; false otherwise.

Definition at line 400 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Lookup(), ns3::aodv::Neighbors::LookupMacAddress(), and ns3::dsr::DsrRouteCache::LookupMacAddress().

+ Here is the caller graph for this function:

◆ IsWaitReply()

bool ns3::ArpCache::Entry::IsWaitReply ( )
Returns
True if the state of this entry is wait_reply; false otherwise.

Definition at line 393 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::HandleWaitReplyTimeout(), ns3::ArpL3Protocol::Lookup(), and ns3::ArpL3Protocol::Receive().

+ Here is the caller graph for this function:

◆ MarkAlive()

void ns3::ArpCache::Entry::MarkAlive ( Address macAddress)
Parameters
macAddress

Definition at line 424 of file arp-cache.cc.

References NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Receive().

+ Here is the caller graph for this function:

◆ MarkAutoGenerated()

void ns3::ArpCache::Entry::MarkAutoGenerated ( )

Changes the state of this entry to auto-generated.

The entry must have a valid MacAddress.

Definition at line 446 of file arp-cache.cc.

References NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by ns3::NeighborCacheHelper::AddEntry().

+ Here is the caller graph for this function:

◆ MarkDead()

void ns3::ArpCache::Entry::MarkDead ( )

Changes the state of this entry to dead.

Definition at line 414 of file arp-cache.cc.

References NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by ns3::ArpCache::HandleWaitReplyTimeout().

+ Here is the caller graph for this function:

◆ MarkPermanent()

void ns3::ArpCache::Entry::MarkPermanent ( )

Changes the state of this entry to Permanent.

The entry must have a valid MacAddress.

Definition at line 435 of file arp-cache.cc.

References NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by EpcS1uUlTestCase::DoRun(), and FlushTest::DoRun().

+ Here is the caller graph for this function:

◆ MarkWaitReply()

void ns3::ArpCache::Entry::MarkWaitReply ( Ipv4PayloadHeaderPair waiting)
Parameters
waiting

Definition at line 474 of file arp-cache.cc.

References NS_ASSERT, NS_ASSERT_MSG, and NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Lookup().

+ Here is the caller graph for this function:

◆ SetIpv4Address()

void ns3::ArpCache::Entry::SetIpv4Address ( Ipv4Address destination)
Parameters
destinationThe Ipv4Address for this entry

Definition at line 509 of file arp-cache.cc.

References NS_LOG_FUNCTION.

◆ SetMacAddress()

void ns3::ArpCache::Entry::SetMacAddress ( Address macAddress)
Parameters
macAddressThe MacAddress for this entry

Definition at line 495 of file arp-cache.cc.

References NS_LOG_FUNCTION.

Referenced by ns3::NeighborCacheHelper::AddEntry(), EpcS1uUlTestCase::DoRun(), and FlushTest::DoRun().

+ Here is the caller graph for this function:

◆ UpdateSeen()

void ns3::ArpCache::Entry::UpdateSeen ( )

Update the entry when seeing a packet.

Definition at line 569 of file arp-cache.cc.

References ns3::Simulator::Now(), and NS_LOG_FUNCTION.

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

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ UpdateWaitReply()

bool ns3::ArpCache::Entry::UpdateWaitReply ( Ipv4PayloadHeaderPair waiting)
Parameters
waiting
Returns

Definition at line 457 of file arp-cache.cc.

References NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by ns3::ArpL3Protocol::Lookup().

+ Here is the caller graph for this function:

Member Data Documentation

◆ m_arp

ArpCache* ns3::ArpCache::Entry::m_arp
private

pointer to the ARP cache owning the entry

Definition at line 300 of file arp-cache.h.

◆ m_ipv4Address

Ipv4Address ns3::ArpCache::Entry::m_ipv4Address
private

entry's IP address

Definition at line 304 of file arp-cache.h.

◆ m_lastSeen

Time ns3::ArpCache::Entry::m_lastSeen
private

last moment a packet from that address has been seen

Definition at line 302 of file arp-cache.h.

◆ m_macAddress

Address ns3::ArpCache::Entry::m_macAddress
private

entry's MAC address

Definition at line 303 of file arp-cache.h.

◆ m_pending

std::list<Ipv4PayloadHeaderPair> ns3::ArpCache::Entry::m_pending
private

list of pending packets for the entry's IP

Definition at line 305 of file arp-cache.h.

◆ m_retries

uint32_t ns3::ArpCache::Entry::m_retries
private

retry counter

Definition at line 306 of file arp-cache.h.

◆ m_state

ArpCacheEntryState_e ns3::ArpCache::Entry::m_state
private

state of the entry

Definition at line 301 of file arp-cache.h.


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