A Discrete-Event Network Simulator
API
arp-cache.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2006 INRIA
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2 as
7  * published by the Free Software Foundation;
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17  *
18  * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19  */
20 #ifndef ARP_CACHE_H
21 #define ARP_CACHE_H
22 
23 #include <stdint.h>
24 #include <list>
25 #include "ns3/simulator.h"
26 #include "ns3/callback.h"
27 #include "ns3/packet.h"
28 #include "ns3/nstime.h"
29 #include "ns3/net-device.h"
30 #include "ns3/ipv4-address.h"
31 #include "ns3/address.h"
32 #include "ns3/ptr.h"
33 #include "ns3/object.h"
34 #include "ns3/traced-callback.h"
35 #include "ns3/sgi-hashmap.h"
36 #include "ns3/output-stream-wrapper.h"
37 
38 namespace ns3 {
39 
40 class NetDevice;
41 class Ipv4Interface;
42 class Ipv4Header;
43 
51 class ArpCache : public Object
52 {
53 private:
59  ArpCache (ArpCache const &);
66  ArpCache& operator= (ArpCache const &);
67 
68 public:
73  static TypeId GetTypeId (void);
74  class Entry;
75  ArpCache ();
76  ~ArpCache ();
77 
84  void SetDevice (Ptr<NetDevice> device, Ptr<Ipv4Interface> interface);
89  Ptr<NetDevice> GetDevice (void) const;
94  Ptr<Ipv4Interface> GetInterface (void) const;
95 
100  void SetAliveTimeout (Time aliveTimeout);
105  void SetDeadTimeout (Time deadTimeout);
110  void SetWaitReplyTimeout (Time waitReplyTimeout);
111 
116  Time GetAliveTimeout (void) const;
121  Time GetDeadTimeout (void) const;
126  Time GetWaitReplyTimeout (void) const;
127 
136  Ipv4Address> arpRequestCallback);
142  void StartWaitReplyTimer (void);
149  ArpCache::Entry *Lookup (Ipv4Address destination);
156  std::list<ArpCache::Entry *> LookupInverse (Address destination);
165  void Remove (ArpCache::Entry *entry);
169  void Flush (void);
170 
177 
181  typedef std::pair<Ptr<Packet>, Ipv4Header> Ipv4PayloadHeaderPair;
182 
186  class Entry {
187 public:
192  Entry (ArpCache *arp);
193 
197  void MarkDead (void);
201  void MarkAlive (Address macAddress);
205  void MarkWaitReply (Ipv4PayloadHeaderPair waiting);
211  void MarkPermanent (void);
216  bool UpdateWaitReply (Ipv4PayloadHeaderPair waiting);
220  bool IsDead (void);
224  bool IsAlive (void);
228  bool IsWaitReply (void);
232  bool IsPermanent (void);
236  Address GetMacAddress (void) const;
240  Ipv4Address GetIpv4Address (void) const;
244  void SetMacAddresss (Address macAddress);
248  void SetIpv4Address (Ipv4Address destination);
255  bool IsExpired (void) const;
260  Ipv4PayloadHeaderPair DequeuePending (void);
264  void ClearPendingPacket (void);
269  uint32_t GetRetries (void) const;
273  void IncrementRetries (void);
277  void ClearRetries (void);
278 
282  void UpdateSeen (void);
283 
284 private:
293  };
294 
299  Time GetTimeout (void) const;
300 
306  std::list<Ipv4PayloadHeaderPair> m_pending;
307  uint32_t m_retries;
308  };
309 
310 private:
314  typedef sgi::hash_map<Ipv4Address, ArpCache::Entry *, Ipv4AddressHash> Cache;
318  typedef sgi::hash_map<Ipv4Address, ArpCache::Entry *, Ipv4AddressHash>::iterator CacheI;
319 
320  virtual void DoDispose (void);
321 
329  uint32_t m_maxRetries;
330 
336  void HandleWaitReplyTimeout (void);
338  Cache m_arpCache;
340 };
341 
342 
343 } // namespace ns3
344 
345 #endif /* ARP_CACHE_H */
uint32_t m_retries
rerty counter
Definition: arp-cache.h:307
ArpCacheEntryState_e m_state
state of the entry
Definition: arp-cache.h:302
void SetDevice(Ptr< NetDevice > device, Ptr< Ipv4Interface > interface)
Set the NetDevice and Ipv4Interface associated with the ArpCache.
Definition: arp-cache.cc:114
uint32_t m_maxRetries
max retries for a resolution
Definition: arp-cache.h:329
void StartWaitReplyTimer(void)
This method will schedule a timeout at WaitReplyTimeout interval in the future, unless a timer is alr...
Definition: arp-cache.cc:182
void MarkPermanent(void)
Changes the state of this entry to Permanent.
Definition: arp-cache.cc:414
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:102
void SetArpRequestCallback(Callback< void, Ptr< const ArpCache >, Ipv4Address > arpRequestCallback)
This callback is set when the ArpCache is set up and allows the cache to generate an Arp request when...
Definition: arp-cache.cc:174
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:73
Callback template class.
Definition: callback.h:1176
ArpCache::Entry * Add(Ipv4Address to)
Add an Ipv4Address to this ARP cache.
Definition: arp-cache.cc:330
virtual void DoDispose(void)
Destructor implementation.
Definition: arp-cache.cc:100
static TypeId GetTypeId(void)
Get the type ID.
Definition: arp-cache.cc:41
void PrintArpCache(Ptr< OutputStreamWrapper > stream)
Print the ARP cache entries.
Definition: arp-cache.cc:260
void SetMacAddresss(Address macAddress)
Definition: arp-cache.cc:460
ArpCache::Entry * Lookup(Ipv4Address destination)
Do lookup in the ARP cache against an IP address.
Definition: arp-cache.cc:318
Forward calls to a chain of Callback.
bool IsPermanent(void)
Definition: arp-cache.cc:387
Callback< void, Ptr< const ArpCache >, Ipv4Address > m_arpRequestCallback
reply timeout callback
Definition: arp-cache.h:328
Time GetDeadTimeout(void) const
Get the time the entry will be in DEAD state before being removed.
Definition: arp-cache.cc:161
Ptr< NetDevice > GetDevice(void) const
Returns the NetDevice that this ARP cache is associated with.
Definition: arp-cache.cc:122
Address m_macAddress
entry's MAC address
Definition: arp-cache.h:304
ArpCache * m_arp
pointer to the ARP cache owning the entry
Definition: arp-cache.h:301
bool IsAlive(void)
Definition: arp-cache.cc:375
EventId m_waitReplyTimer
cache alive state timer
Definition: arp-cache.h:327
ArpCacheEntryState_e
ARP cache entry states.
Definition: arp-cache.h:288
a polymophic address class
Definition: address.h:90
Packet header for IPv4.
Definition: ipv4-header.h:33
Cache m_arpCache
the ARP cache
Definition: arp-cache.h:338
void SetIpv4Address(Ipv4Address destination)
Definition: arp-cache.cc:472
void HandleWaitReplyTimeout(void)
This function is an event handler for the event that the ArpCache wants to check whether it must retr...
Definition: arp-cache.cc:195
uint32_t GetRetries(void) const
Definition: arp-cache.cc:538
bool IsDead(void)
Definition: arp-cache.cc:369
Ptr< Ipv4Interface > m_interface
Ipv4Interface associated with the cache.
Definition: arp-cache.h:323
bool IsExpired(void) const
Definition: arp-cache.cc:497
Ipv4Address GetIpv4Address(void) const
Definition: arp-cache.cc:466
void MarkWaitReply(Ipv4PayloadHeaderPair waiting)
Definition: arp-cache.cc:440
Time m_waitReplyTimeout
cache reply state timeout
Definition: arp-cache.h:326
Address GetMacAddress(void) const
Definition: arp-cache.cc:454
void SetDeadTimeout(Time deadTimeout)
Set the time the entry will be in DEAD state before being removed.
Definition: arp-cache.cc:142
void SetAliveTimeout(Time aliveTimeout)
Set the time the entry will be in ALIVE state (unless refreshed)
Definition: arp-cache.cc:136
Ptr< Ipv4Interface > GetInterface(void) const
Returns the Ipv4Interface that this ARP cache is associated with.
Definition: arp-cache.cc:129
void IncrementRetries(void)
Increment the counter of number of retries for an entry.
Definition: arp-cache.cc:544
Every class exported by the ns3 library is enclosed in the ns3 namespace.
void ClearPendingPacket(void)
Clear the pending packet list.
Definition: arp-cache.cc:526
void MarkAlive(Address macAddress)
Definition: arp-cache.cc:404
Time GetAliveTimeout(void) const
Get the time the entry will be in ALIVE state (unless refreshed)
Definition: arp-cache.cc:155
A record that that holds information about an ArpCache entry.
Definition: arp-cache.h:186
void Flush(void)
Clear the ArpCache of all entries.
Definition: arp-cache.cc:244
void Remove(ArpCache::Entry *entry)
Remove an entry.
Definition: arp-cache.cc:342
Entry(ArpCache *arp)
Constructor.
Definition: arp-cache.cc:359
Time GetTimeout(void) const
Returns the entry timeout.
Definition: arp-cache.cc:478
void UpdateSeen(void)
Update the entry when seeing a packet.
Definition: arp-cache.cc:532
TracedCallback< Ptr< const Packet > > m_dropTrace
trace for packets dropped by the ARP cache queue
Definition: arp-cache.h:339
bool UpdateWaitReply(Ipv4PayloadHeaderPair waiting)
Definition: arp-cache.cc:424
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:40
Ipv4PayloadHeaderPair DequeuePending(void)
Definition: arp-cache.cc:510
An identifier for simulation events.
Definition: event-id.h:53
sgi::hash_map< Ipv4Address, ArpCache::Entry *, Ipv4AddressHash >::iterator CacheI
ARP Cache container iterator.
Definition: arp-cache.h:318
std::pair< Ptr< Packet >, Ipv4Header > Ipv4PayloadHeaderPair
Pair of a packet and an Ipv4 header.
Definition: arp-cache.h:181
bool IsWaitReply(void)
Definition: arp-cache.cc:381
An ARP cache.
Definition: arp-cache.h:51
std::list< Ipv4PayloadHeaderPair > m_pending
list of pending packets for the entry's IP
Definition: arp-cache.h:306
Time GetWaitReplyTimeout(void) const
Get the time the entry will be in WAIT_REPLY state.
Definition: arp-cache.cc:167
void ClearRetries(void)
Zero the counter of number of retries for an entry.
Definition: arp-cache.cc:551
Ptr< NetDevice > m_device
NetDevice associated with the cache.
Definition: arp-cache.h:322
std::list< ArpCache::Entry * > LookupInverse(Address destination)
Do lookup in the ARP cache against a MAC address.
Definition: arp-cache.cc:300
void MarkDead(void)
Changes the state of this entry to dead.
Definition: arp-cache.cc:395
Time m_deadTimeout
cache dead state timeout
Definition: arp-cache.h:325
A base class which provides memory management and object aggregation.
Definition: object.h:87
Time m_lastSeen
last moment a packet from that address has been seen
Definition: arp-cache.h:303
uint32_t m_pendingQueueSize
number of packets waiting for a resolution
Definition: arp-cache.h:337
void SetWaitReplyTimeout(Time waitReplyTimeout)
Set the time the entry will be in WAIT_REPLY state.
Definition: arp-cache.cc:148
Time m_aliveTimeout
cache alive state timeout
Definition: arp-cache.h:324
a unique identifier for an interface.
Definition: type-id.h:58
ArpCache & operator=(ArpCache const &)
Copy constructor.
sgi::hash_map< Ipv4Address, ArpCache::Entry *, Ipv4AddressHash > Cache
ARP Cache container.
Definition: arp-cache.h:314
Ipv4Address m_ipv4Address
entry's IP address
Definition: arp-cache.h:305