A Discrete-Event Network Simulator
API
ipv4-interface.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2005,2006,2007 INRIA
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation;
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU General Public License for more details.
12  *
13  * You should have received a copy of the GNU General Public License
14  * along with this program; if not, write to the Free Software
15  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16  *
17  * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
18  */
19 
20 #include "ipv4-interface.h"
21 
22 #include "arp-cache.h"
23 #include "arp-l3-protocol.h"
24 #include "ipv4-l3-protocol.h"
25 #include "ipv4-queue-disc-item.h"
26 #include "loopback-net-device.h"
27 
28 #include "ns3/log.h"
29 #include "ns3/net-device.h"
30 #include "ns3/node.h"
31 #include "ns3/packet.h"
32 #include "ns3/pointer.h"
33 #include "ns3/traffic-control-layer.h"
34 
35 namespace ns3
36 {
37 
38 NS_LOG_COMPONENT_DEFINE("Ipv4Interface");
39 
40 NS_OBJECT_ENSURE_REGISTERED(Ipv4Interface);
41 
42 TypeId
44 {
45  static TypeId tid = TypeId("ns3::Ipv4Interface")
46  .SetParent<Object>()
47  .SetGroupName("Internet")
48  .AddAttribute("ArpCache",
49  "The arp cache for this ipv4 interface",
50  PointerValue(nullptr),
53  MakePointerChecker<ArpCache>());
54  ;
55  return tid;
56 }
57 
64  : m_ifup(false),
65  m_forwarding(true),
66  m_metric(1),
67  m_node(nullptr),
68  m_device(nullptr),
69  m_tc(nullptr),
70  m_cache(nullptr)
71 {
72  NS_LOG_FUNCTION(this);
73 }
74 
76 {
77  NS_LOG_FUNCTION(this);
78 }
79 
80 void
82 {
83  NS_LOG_FUNCTION(this);
84  m_node = nullptr;
85  m_device = nullptr;
86  m_tc = nullptr;
87  m_cache = nullptr;
89 }
90 
91 void
93 {
94  NS_LOG_FUNCTION(this << node);
95  m_node = node;
96  DoSetup();
97 }
98 
99 void
101 {
102  NS_LOG_FUNCTION(this << device);
103  m_device = device;
104  DoSetup();
105 }
106 
107 void
109 {
110  NS_LOG_FUNCTION(this << tc);
111  m_tc = tc;
112 }
113 
114 void
116 {
117  NS_LOG_FUNCTION(this);
118  if (!m_node || !m_device)
119  {
120  return;
121  }
122  if (!m_device->NeedsArp())
123  {
124  return;
125  }
127  m_cache = arp->CreateCache(m_device, this);
128 }
129 
132 {
133  NS_LOG_FUNCTION(this);
134  return m_device;
135 }
136 
137 void
138 Ipv4Interface::SetMetric(uint16_t metric)
139 {
140  NS_LOG_FUNCTION(this << metric);
141  m_metric = metric;
142 }
143 
144 uint16_t
146 {
147  NS_LOG_FUNCTION(this);
148  return m_metric;
149 }
150 
151 void
153 {
154  NS_LOG_FUNCTION(this << a);
155  m_cache = a;
156 }
157 
160 {
161  NS_LOG_FUNCTION(this);
162  return m_cache;
163 }
164 
170 bool
172 {
173  NS_LOG_FUNCTION(this);
174  return m_ifup;
175 }
176 
177 bool
179 {
180  NS_LOG_FUNCTION(this);
181  return !m_ifup;
182 }
183 
184 void
186 {
187  NS_LOG_FUNCTION(this);
188  m_ifup = true;
189 }
190 
191 void
193 {
194  NS_LOG_FUNCTION(this);
195  m_ifup = false;
196 }
197 
198 bool
200 {
201  NS_LOG_FUNCTION(this);
202  return m_forwarding;
203 }
204 
205 void
207 {
208  NS_LOG_FUNCTION(this << val);
209  m_forwarding = val;
210 }
211 
212 void
214 {
215  NS_LOG_FUNCTION(this << *p << dest);
216  if (!IsUp())
217  {
218  return;
219  }
220 
221  // Check for a loopback device, if it's the case we don't pass through
222  // traffic control layer
223  if (DynamicCast<LoopbackNetDevice>(m_device))
224  {
227  p->AddHeader(hdr);
228  m_device->Send(p, m_device->GetBroadcast(), Ipv4L3Protocol::PROT_NUMBER);
229  return;
230  }
231 
232  NS_ASSERT(m_tc);
233 
234  // is this packet aimed at a local interface ?
235  for (Ipv4InterfaceAddressListCI i = m_ifaddrs.begin(); i != m_ifaddrs.end(); ++i)
236  {
237  if (dest == (*i).GetLocal())
238  {
239  p->AddHeader(hdr);
240  m_tc->Receive(m_device,
241  p,
243  m_device->GetBroadcast(),
244  m_device->GetBroadcast(),
246  return;
247  }
248  }
249  if (m_device->NeedsArp())
250  {
251  NS_LOG_LOGIC("Needs ARP"
252  << " " << dest);
254  Address hardwareDestination;
255  bool found = false;
256  if (dest.IsBroadcast())
257  {
258  NS_LOG_LOGIC("All-network Broadcast");
259  hardwareDestination = m_device->GetBroadcast();
260  found = true;
261  }
262  else if (dest.IsMulticast())
263  {
264  NS_LOG_LOGIC("IsMulticast");
265  NS_ASSERT_MSG(m_device->IsMulticast(),
266  "ArpIpv4Interface::SendTo (): Sending multicast packet over "
267  "non-multicast device");
268 
269  hardwareDestination = m_device->GetMulticast(dest);
270  found = true;
271  }
272  else
273  {
274  for (Ipv4InterfaceAddressListCI i = m_ifaddrs.begin(); i != m_ifaddrs.end(); ++i)
275  {
276  if (dest.IsSubnetDirectedBroadcast((*i).GetMask()))
277  {
278  NS_LOG_LOGIC("Subnetwork Broadcast");
279  hardwareDestination = m_device->GetBroadcast();
280  found = true;
281  break;
282  }
283  }
284  if (!found)
285  {
286  NS_LOG_LOGIC("ARP Lookup");
287  found = arp->Lookup(p, hdr, dest, m_device, m_cache, &hardwareDestination);
288  }
289  }
290 
291  if (found)
292  {
293  NS_LOG_LOGIC("Address Resolved. Send.");
294  m_tc->Send(m_device,
295  Create<Ipv4QueueDiscItem>(p,
296  hardwareDestination,
298  hdr));
299  }
300  }
301  else
302  {
303  NS_LOG_LOGIC("Doesn't need ARP");
304  m_tc->Send(m_device,
305  Create<Ipv4QueueDiscItem>(p,
306  m_device->GetBroadcast(),
308  hdr));
309  }
310 }
311 
312 uint32_t
314 {
315  NS_LOG_FUNCTION(this);
316  return m_ifaddrs.size();
317 }
318 
319 bool
321 {
322  NS_LOG_FUNCTION(this << addr);
323  m_ifaddrs.push_back(addr);
324  if (!m_addAddressCallback.IsNull())
325  {
326  m_addAddressCallback(this, addr);
327  }
328  return true;
329 }
330 
332 Ipv4Interface::GetAddress(uint32_t index) const
333 {
334  NS_LOG_FUNCTION(this << index);
335  if (index < m_ifaddrs.size())
336  {
337  uint32_t tmp = 0;
338  for (Ipv4InterfaceAddressListCI i = m_ifaddrs.begin(); i != m_ifaddrs.end(); i++)
339  {
340  if (tmp == index)
341  {
342  return *i;
343  }
344  ++tmp;
345  }
346  }
347  else
348  {
349  NS_FATAL_ERROR("index " << index << " out of bounds");
350  }
352  return (addr); // quiet compiler
353 }
354 
357 {
358  NS_LOG_FUNCTION(this << index);
359  if (index >= m_ifaddrs.size())
360  {
361  NS_FATAL_ERROR("Bug in Ipv4Interface::RemoveAddress");
362  }
364  uint32_t tmp = 0;
365  while (i != m_ifaddrs.end())
366  {
367  if (tmp == index)
368  {
369  Ipv4InterfaceAddress addr = *i;
370  m_ifaddrs.erase(i);
371  if (!m_removeAddressCallback.IsNull())
372  {
373  m_removeAddressCallback(this, addr);
374  }
375  return addr;
376  }
377  ++tmp;
378  ++i;
379  }
380  NS_FATAL_ERROR("Address " << index << " not found");
382  return (addr); // quiet compiler
383 }
384 
387 {
388  NS_LOG_FUNCTION(this << address);
389 
391  {
392  NS_LOG_WARN("Cannot remove loopback address.");
393  return Ipv4InterfaceAddress();
394  }
395 
396  for (Ipv4InterfaceAddressListI it = m_ifaddrs.begin(); it != m_ifaddrs.end(); it++)
397  {
398  if ((*it).GetLocal() == address)
399  {
400  Ipv4InterfaceAddress ifAddr = *it;
401  m_ifaddrs.erase(it);
402  if (!m_removeAddressCallback.IsNull())
403  {
404  m_removeAddressCallback(this, ifAddr);
405  }
406  return ifAddr;
407  }
408  }
409  return Ipv4InterfaceAddress();
410 }
411 
412 void
414  Callback<void, Ptr<Ipv4Interface>, Ipv4InterfaceAddress> removeAddressCallback)
415 {
416  NS_LOG_FUNCTION(this << &removeAddressCallback);
417  m_removeAddressCallback = removeAddressCallback;
418 }
419 
420 void
422  Callback<void, Ptr<Ipv4Interface>, Ipv4InterfaceAddress> addAddressCallback)
423 {
424  NS_LOG_FUNCTION(this << &addAddressCallback);
425  m_addAddressCallback = addAddressCallback;
426 }
427 
428 } // namespace ns3
a polymophic address class
Definition: address.h:100
An implementation of the ARP protocol.
Callback template class.
Definition: callback.h:443
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:43
static Ipv4Address GetLoopback()
bool IsMulticast() const
bool IsSubnetDirectedBroadcast(const Ipv4Mask &mask) const
Generate subnet-directed broadcast address corresponding to mask.
bool IsBroadcast() const
Packet header for IPv4.
Definition: ipv4-header.h:34
a class to store IPv4 address information on an interface
static TypeId GetTypeId()
Get the type ID.
uint32_t GetNAddresses() const
Ptr< Node > m_node
The associated node.
void SetArpCache(Ptr< ArpCache > arpCache)
Set ARP cache used by this interface.
Ipv4Interface()
By default, Ipv4 interface are created in the "down" state with no IP addresses.
~Ipv4Interface() override
void RemoveAddressCallback(Callback< void, Ptr< Ipv4Interface >, Ipv4InterfaceAddress > removeAddressCallback)
This callback is set when an address is removed from an interface with auto-generated Arp cache and i...
void SetNode(Ptr< Node > node)
Set node associated with interface.
Ipv4InterfaceAddress GetAddress(uint32_t index) const
Ptr< TrafficControlLayer > m_tc
The associated TrafficControlLayer.
bool AddAddress(Ipv4InterfaceAddress address)
void SetTrafficControl(Ptr< TrafficControlLayer > tc)
Set the TrafficControlLayer.
bool m_forwarding
Forwarding state.
std::list< Ipv4InterfaceAddress >::const_iterator Ipv4InterfaceAddressListCI
Container Iterator for the Ipv4InterfaceAddresses.
uint16_t GetMetric() const
Ptr< NetDevice > m_device
The associated NetDevice.
bool IsUp() const
These are IP interface states and may be distinct from NetDevice states, such as found in real implem...
void SetUp()
Enable this interface.
Ptr< ArpCache > GetArpCache() const
void SetDevice(Ptr< NetDevice > device)
Set the NetDevice.
void DoSetup()
Initialize interface.
Ptr< NetDevice > GetDevice() const
Ipv4InterfaceAddressList m_ifaddrs
Address list.
Callback< void, Ptr< Ipv4Interface >, Ipv4InterfaceAddress > m_addAddressCallback
add address callback
uint16_t m_metric
Interface metric.
void SetDown()
Disable this interface.
bool IsForwarding() const
void AddAddressCallback(Callback< void, Ptr< Ipv4Interface >, Ipv4InterfaceAddress > addAddressCallback)
This callback is set when an address is added from an interface with auto-generated Arp cache and it ...
void DoDispose() override
Destructor implementation.
Ptr< ArpCache > m_cache
ARP cache.
Callback< void, Ptr< Ipv4Interface >, Ipv4InterfaceAddress > m_removeAddressCallback
remove address callback
void Send(Ptr< Packet > p, const Ipv4Header &hdr, Ipv4Address dest)
bool m_ifup
The state of this interface.
std::list< Ipv4InterfaceAddress >::iterator Ipv4InterfaceAddressListI
Const Container Iterator for the Ipv4InterfaceAddresses.
void SetForwarding(bool val)
void SetMetric(uint16_t metric)
Ipv4InterfaceAddress RemoveAddress(uint32_t index)
static const uint16_t PROT_NUMBER
Protocol number (0x0800)
@ PACKET_HOST
Packet addressed to us.
Definition: net-device.h:301
A base class which provides memory management and object aggregation.
Definition: object.h:89
Ptr< T > GetObject() const
Get a pointer to the requested aggregated Object.
Definition: object.h:471
virtual void DoDispose()
Destructor implementation.
Definition: object.cc:353
void AddHeader(const Header &header)
Add header to this packet.
Definition: packet.cc:268
Hold objects of type Ptr<T>.
Definition: pointer.h:37
a unique identifier for an interface.
Definition: type-id.h:60
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:935
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
Definition: assert.h:66
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
Definition: assert.h:86
Ptr< const AttributeAccessor > MakePointerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
Definition: pointer.h:231
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:179
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:202
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
Definition: log.h:282
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
Definition: log.h:261
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:46
address
Definition: first.py:40
Every class exported by the ns3 library is enclosed in the ns3 namespace.