A Discrete-Event Network Simulator
API
virtual-net-device.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * This program is free software; you can redistribute it and/or modify
4  * it under the terms of the GNU General Public License version 2 as
5  * published by the Free Software Foundation;
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
10  * GNU General Public License for more details.
11  *
12  * You should have received a copy of the GNU General Public License
13  * along with this program; if not, write to the Free Software
14  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
15  *
16  * Based on simple-global-routing.cc
17  * The Tunnel class adds two tunnels, n0<=>n3 and n1<=>n3
18  */
19 
20 // Network topology
21 //
22 // n0
23 // \ 5 Mb/s, 2ms
24 // \ 1.5Mb/s, 10ms
25 // n2 -------------------------n3
26 // /
27 // / 5 Mb/s, 2ms
28 // n1
29 //
30 // - all links are point-to-point links with indicated one-way BW/delay
31 // - Tracing of queues and packet receptions to file "virtual-net-device.tr"
32 
33 // Tunneling changes (relative to the simple-global-routing example):
34 // - n0 will receive an extra virtual interface with hardcoded inner-tunnel address 11.0.0.1
35 // - n1 will also receive an extra virtual interface with the same inner-tunnel address 11.0.0.1
36 // - n3 will receive an extra virtual interface with inner-tunnel address 11.0.0.254
37 // - The flows will be between 11.0.0.x (inner-tunnel) addresses instead of 10.1.x.y ones
38 // - n3 will decide, on a per-packet basis, via random number, whether to
39 // send the packet to n0 or to n1.
40 //
41 // Note: here we create a tunnel where IP packets are tunneled over
42 // UDP/IP, but tunneling directly IP-over-IP would also be possible;
43 // see src/node/ipv4-raw-socket-factory.h.
44 
45 #include <iostream>
46 #include <fstream>
47 #include <string>
48 #include <cassert>
49 
50 #include "ns3/core-module.h"
51 #include "ns3/network-module.h"
52 #include "ns3/internet-module.h"
53 #include "ns3/point-to-point-module.h"
54 #include "ns3/applications-module.h"
55 #include "ns3/virtual-net-device.h"
56 
57 using namespace ns3;
58 
59 NS_LOG_COMPONENT_DEFINE ("VirtualNetDeviceExample");
60 
61 class Tunnel
62 {
73 
74 
75  bool
76  N0VirtualSend (Ptr<Packet> packet, const Address& source, const Address& dest, uint16_t protocolNumber)
77  {
78  NS_LOG_DEBUG ("Send to " << m_n3Address << ": " << *packet);
79  m_n0Socket->SendTo (packet, 0, InetSocketAddress (m_n3Address, 667));
80  return true;
81  }
82 
83  bool
84  N1VirtualSend (Ptr<Packet> packet, const Address& source, const Address& dest, uint16_t protocolNumber)
85  {
86  NS_LOG_DEBUG ("Send to " << m_n3Address << ": " << *packet);
87  m_n1Socket->SendTo (packet, 0, InetSocketAddress (m_n3Address, 667));
88  return true;
89  }
90 
91  bool
92  N3VirtualSend (Ptr<Packet> packet, const Address& source, const Address& dest, uint16_t protocolNumber)
93  {
94  if (m_rng->GetValue () < 0.25)
95  {
96  NS_LOG_DEBUG ("Send to " << m_n0Address << ": " << *packet);
97  m_n3Socket->SendTo (packet, 0, InetSocketAddress (m_n0Address, 667));
98  }
99  else
100  {
101  NS_LOG_DEBUG ("Send to " << m_n1Address << ": " << *packet);
102  m_n3Socket->SendTo (packet, 0, InetSocketAddress (m_n1Address, 667));
103  }
104  return true;
105  }
106 
107  void N3SocketRecv (Ptr<Socket> socket)
108  {
109  Ptr<Packet> packet = socket->Recv (65535, 0);
110  NS_LOG_DEBUG ("N3SocketRecv: " << *packet);
111  m_n3Tap->Receive (packet, 0x0800, m_n3Tap->GetAddress (), m_n3Tap->GetAddress (), NetDevice::PACKET_HOST);
112  }
113 
114  void N0SocketRecv (Ptr<Socket> socket)
115  {
116  Ptr<Packet> packet = socket->Recv (65535, 0);
117  NS_LOG_DEBUG ("N0SocketRecv: " << *packet);
118  m_n0Tap->Receive (packet, 0x0800, m_n0Tap->GetAddress (), m_n0Tap->GetAddress (), NetDevice::PACKET_HOST);
119  }
120 
121  void N1SocketRecv (Ptr<Socket> socket)
122  {
123  Ptr<Packet> packet = socket->Recv (65535, 0);
124  NS_LOG_DEBUG ("N1SocketRecv: " << *packet);
125  m_n1Tap->Receive (packet, 0x0800, m_n1Tap->GetAddress (), m_n1Tap->GetAddress (), NetDevice::PACKET_HOST);
126  }
127 
128 public:
129 
131  Ipv4Address n3Addr, Ipv4Address n0Addr, Ipv4Address n1Addr)
132  : m_n3Address (n3Addr), m_n0Address (n0Addr), m_n1Address (n1Addr)
133  {
134  m_rng = CreateObject<UniformRandomVariable> ();
135  m_n3Socket = Socket::CreateSocket (n3, TypeId::LookupByName ("ns3::UdpSocketFactory"));
136  m_n3Socket->Bind (InetSocketAddress (Ipv4Address::GetAny (), 667));
137  m_n3Socket->SetRecvCallback (MakeCallback (&Tunnel::N3SocketRecv, this));
138 
139  m_n0Socket = Socket::CreateSocket (n0, TypeId::LookupByName ("ns3::UdpSocketFactory"));
140  m_n0Socket->Bind (InetSocketAddress (Ipv4Address::GetAny (), 667));
141  m_n0Socket->SetRecvCallback (MakeCallback (&Tunnel::N0SocketRecv, this));
142 
143  m_n1Socket = Socket::CreateSocket (n1, TypeId::LookupByName ("ns3::UdpSocketFactory"));
144  m_n1Socket->Bind (InetSocketAddress (Ipv4Address::GetAny (), 667));
145  m_n1Socket->SetRecvCallback (MakeCallback (&Tunnel::N1SocketRecv, this));
146 
147  // n0 tap device
148  m_n0Tap = CreateObject<VirtualNetDevice> ();
149  m_n0Tap->SetAddress (Mac48Address ("11:00:01:02:03:01"));
151  n0->AddDevice (m_n0Tap);
152  Ptr<Ipv4> ipv4 = n0->GetObject<Ipv4> ();
153  uint32_t i = ipv4->AddInterface (m_n0Tap);
154  ipv4->AddAddress (i, Ipv4InterfaceAddress (Ipv4Address ("11.0.0.1"), Ipv4Mask ("255.255.255.0")));
155  ipv4->SetUp (i);
156 
157  // n1 tap device
158  m_n1Tap = CreateObject<VirtualNetDevice> ();
159  m_n1Tap->SetAddress (Mac48Address ("11:00:01:02:03:02"));
161  n1->AddDevice (m_n1Tap);
162  ipv4 = n1->GetObject<Ipv4> ();
163  i = ipv4->AddInterface (m_n1Tap);
164  ipv4->AddAddress (i, Ipv4InterfaceAddress (Ipv4Address ("11.0.0.1"), Ipv4Mask ("255.255.255.0")));
165  ipv4->SetUp (i);
166 
167  // n3 tap device
168  m_n3Tap = CreateObject<VirtualNetDevice> ();
169  m_n3Tap->SetAddress (Mac48Address ("11:00:01:02:03:04"));
171  n3->AddDevice (m_n3Tap);
172  ipv4 = n3->GetObject<Ipv4> ();
173  i = ipv4->AddInterface (m_n3Tap);
174  ipv4->AddAddress (i, Ipv4InterfaceAddress (Ipv4Address ("11.0.0.254"), Ipv4Mask ("255.255.255.0")));
175  ipv4->SetUp (i);
176 
177  }
178 
179 
180 };
181 
182 
183 
184 int
185 main (int argc, char *argv[])
186 {
187  // Users may find it convenient to turn on explicit logging
188  // for selected modules; the below lines suggest how to do this
189 #if 0
190  LogComponentEnable ("VirtualNetDeviceExample", LOG_LEVEL_INFO);
191 #endif
193 
194 
195  // Set up some default values for the simulation. Use the
196  Config::SetDefault ("ns3::OnOffApplication::PacketSize", UintegerValue (210));
197  Config::SetDefault ("ns3::OnOffApplication::DataRate", StringValue ("448kb/s"));
198 
199  // Allow the user to override any of the defaults and the above
200  // Config::SetDefault ()s at run-time, via command-line arguments
201  CommandLine cmd (__FILE__);
202  cmd.Parse (argc, argv);
203 
204  NS_LOG_INFO ("Create nodes.");
205  NodeContainer c;
206  c.Create (4);
207  NodeContainer n0n2 = NodeContainer (c.Get (0), c.Get (2));
208  NodeContainer n1n2 = NodeContainer (c.Get (1), c.Get (2));
209  NodeContainer n3n2 = NodeContainer (c.Get (3), c.Get (2));
210 
211  InternetStackHelper internet;
212  internet.Install (c);
213 
214  // We create the channels first without any IP addressing information
215  NS_LOG_INFO ("Create channels.");
216  PointToPointHelper p2p;
217  p2p.SetDeviceAttribute ("DataRate", StringValue ("5Mbps"));
218  p2p.SetChannelAttribute ("Delay", StringValue ("2ms"));
219  NetDeviceContainer d0d2 = p2p.Install (n0n2);
220 
221  NetDeviceContainer d1d2 = p2p.Install (n1n2);
222 
223  p2p.SetDeviceAttribute ("DataRate", StringValue ("1500kbps"));
224  p2p.SetChannelAttribute ("Delay", StringValue ("10ms"));
225  NetDeviceContainer d3d2 = p2p.Install (n3n2);
226 
227  // Later, we add IP addresses.
228  NS_LOG_INFO ("Assign IP Addresses.");
229  Ipv4AddressHelper ipv4;
230  ipv4.SetBase ("10.1.1.0", "255.255.255.0");
231  Ipv4InterfaceContainer i0i2 = ipv4.Assign (d0d2);
232 
233  ipv4.SetBase ("10.1.2.0", "255.255.255.0");
234  Ipv4InterfaceContainer i1i2 = ipv4.Assign (d1d2);
235 
236  ipv4.SetBase ("10.1.3.0", "255.255.255.0");
237  Ipv4InterfaceContainer i3i2 = ipv4.Assign (d3d2);
238 
239  // Create router nodes, initialize routing database and set up the routing
240  // tables in the nodes.
242 
243  // Add the tunnels n0<=>n3 and n1<=>n3
244  Tunnel tunnel (c.Get (3), c.Get (0), c.Get (1),
245  i3i2.GetAddress (0), i0i2.GetAddress (0), i1i2.GetAddress (0));
246 
247  // Create the OnOff application to send UDP datagrams of size
248  // 210 bytes at a rate of 448 Kb/s
249  NS_LOG_INFO ("Create Applications.");
250  uint16_t port = 9; // Discard port (RFC 863)
251  OnOffHelper onoff ("ns3::UdpSocketFactory",
252  Address (InetSocketAddress (Ipv4Address ("11.0.0.254"), port)));
253  onoff.SetConstantRate (DataRate ("448kb/s"));
254  ApplicationContainer apps = onoff.Install (c.Get (0));
255  apps.Start (Seconds (1.0));
256  apps.Stop (Seconds (10.0));
257 
258  // Create a packet sink to receive these packets
259  PacketSinkHelper sink ("ns3::UdpSocketFactory",
261  apps = sink.Install (c.Get (3));
262  apps.Start (Seconds (1.0));
263  //apps.Stop (Seconds (10.0));
264 
265  // Create a similar flow from n3 to n1, starting at time 1.1 seconds
266  onoff.SetAttribute ("Remote",
267  AddressValue (InetSocketAddress (Ipv4Address ("11.0.0.1"), port)));
268  apps = onoff.Install (c.Get (3));
269  apps.Start (Seconds (1.1));
270  apps.Stop (Seconds (10.0));
271 
272  // Create a packet sink to receive these packets
273  apps = sink.Install (c.Get (1));
274  apps.Start (Seconds (1.1));
275  //apps.Stop (Seconds (10.0));
276 
277  AsciiTraceHelper ascii;
278  p2p.EnableAsciiAll (ascii.CreateFileStream ("virtual-net-device.tr"));
279  p2p.EnablePcapAll ("virtual-net-device");
280 
281  NS_LOG_INFO ("Run Simulation.");
282  Simulator::Run ();
284  NS_LOG_INFO ("Done.");
285 
286  return 0;
287 }
Ptr< PacketSink > sink
Definition: wifi-tcp.cc:56
holds a vector of ns3::Application pointers.
virtual uint32_t AddInterface(Ptr< NetDevice > device)=0
Manage ASCII trace files for device models.
Definition: trace-helper.h:162
an Inet address class
static Ipv4Address GetAny(void)
Ipv4Address m_n1Address
holds a vector of std::pair of Ptr<Ipv4> and interface index.
static void PopulateRoutingTables(void)
Build a routing database and initialize the routing tables of the nodes in the simulation.
Ptr< UniformRandomVariable > m_rng
Hold variables of type string.
Definition: string.h:41
NetDeviceContainer Install(NodeContainer c)
a class to represent an Ipv4 address mask
Definition: ipv4-address.h:269
Ptr< VirtualNetDevice > m_n0Tap
Ipv4InterfaceContainer i1i2
void N3SocketRecv(Ptr< Socket > socket)
static void Run(void)
Run the simulation.
Definition: simulator.cc:172
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:205
aggregate IP/TCP/UDP functionality to existing Nodes.
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:281
Ipv4Address m_n3Address
A helper to make it easier to instantiate an ns3::PacketSinkApplication on a set of nodes...
cmd
Definition: second.py:35
bool Receive(Ptr< Packet > packet, uint16_t protocol, const Address &source, const Address &destination, PacketType packetType)
Ptr< OutputStreamWrapper > CreateFileStream(std::string filename, std::ios::openmode filemode=std::ios::out)
Create and initialize an output stream object we&#39;ll use to write the traced bits. ...
Build a set of PointToPointNetDevice objects.
void SetDeviceAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each NetDevice created by the helper.
A helper to make it easier to instantiate an ns3::OnOffApplication on a set of nodes.
Definition: on-off-helper.h:42
uint16_t port
Definition: dsdv-manet.cc:45
a polymophic address class
Definition: address.h:90
Ptr< Socket > m_n1Socket
Class for representing data rates.
Definition: data-rate.h:88
Ptr< Socket > m_n3Socket
void LogComponentEnable(char const *name, enum LogLevel level)
Enable the logging output associated with that log component.
Definition: log.cc:361
void EnablePcapAll(std::string prefix, bool promiscuous=false)
Enable pcap output on each device (which is of the appropriate type) in the set of all nodes created ...
static void EnablePrinting(void)
Enable printing packets metadata.
Definition: packet.cc:572
Ipv4Address GetAddress(uint32_t i, uint32_t j=0) const
virtual void SetUp(uint32_t interface)=0
Hold an unsigned integer type.
Definition: uinteger.h:44
virtual void SetAddress(Address address)
Set the address of this interface.
LOG_INFO and above.
Definition: log.h:107
holds a vector of ns3::NetDevice pointers
Ptr< VirtualNetDevice > m_n1Tap
static Ptr< Socket > CreateSocket(Ptr< Node > node, TypeId tid)
This method wraps the creation of sockets that is performed on a given node by a SocketFactory specif...
Definition: socket.cc:71
void Start(Time start)
Arrange for all of the Applications in this container to Start() at the Time given as a parameter...
Parse command-line arguments.
Definition: command-line.h:227
static void Destroy(void)
Execute the events scheduled with ScheduleDestroy().
Definition: simulator.cc:136
bool N0VirtualSend(Ptr< Packet > packet, const Address &source, const Address &dest, uint16_t protocolNumber)
Access to the IPv4 forwarding table, interfaces, and configuration.
Definition: ipv4.h:76
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:470
virtual int Bind(const Address &address)=0
Allocate a local endpoint for this socket.
void SetRecvCallback(Callback< void, Ptr< Socket > > receivedData)
Notify application when new data is available to be read.
Definition: socket.cc:128
Every class exported by the ns3 library is enclosed in the ns3 namespace.
keep track of a set of node pointers.
virtual Ptr< Packet > Recv(uint32_t maxSize, uint32_t flags)=0
Read data from the socket.
double GetValue(double min, double max)
Get the next random value, as a double in the specified range .
an EUI-48 address
Definition: mac48-address.h:43
virtual Address GetAddress(void) const
bool N3VirtualSend(Ptr< Packet > packet, const Address &source, const Address &dest, uint16_t protocolNumber)
Ipv4InterfaceContainer i0i2
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper.
Ptr< VirtualNetDevice > m_n3Tap
void Install(std::string nodeName) const
Aggregate implementations of the ns3::Ipv4, ns3::Ipv6, ns3::Udp, and ns3::Tcp classes onto the provid...
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:41
AttributeValue implementation for Address.
Definition: address.h:278
void Stop(Time stop)
Arrange for all of the Applications in this container to Stop() at the Time given as a parameter...
Ipv4InterfaceContainer Assign(const NetDeviceContainer &c)
Assign IP addresses to the net devices specified in the container based on the current network prefix...
uint32_t AddDevice(Ptr< NetDevice > device)
Associate a NetDevice to this node.
Definition: node.cc:130
a class to store IPv4 address information on an interface
Packet addressed oo us.
Definition: net-device.h:298
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:273
Ptr< Socket > m_n0Socket
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1289
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:849
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
virtual bool AddAddress(uint32_t interface, Ipv4InterfaceAddress address)=0
virtual int SendTo(Ptr< Packet > p, uint32_t flags, const Address &toAddress)=0
Send data to a specified peer.
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
void EnableAsciiAll(std::string prefix)
Enable ascii trace output on each device (which is of the appropriate type) in the set of all nodes c...
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Tunnel(Ptr< Node > n3, Ptr< Node > n0, Ptr< Node > n1, Ipv4Address n3Addr, Ipv4Address n0Addr, Ipv4Address n1Addr)
Ipv4Address m_n0Address
void N0SocketRecv(Ptr< Socket > socket)
NodeContainer n0n2
void SetSendCallback(SendCallback transmitCb)
Set the user callback to be called when a L2 packet is to be transmitted.
void N1SocketRecv(Ptr< Socket > socket)
Callback< R, Ts... > MakeCallback(R(T::*memPtr)(Ts...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
Definition: callback.h:1642
NodeContainer n1n2
void SetBase(Ipv4Address network, Ipv4Mask mask, Ipv4Address base="0.0.0.1")
Set the base network number, network mask and base address.
static TypeId LookupByName(std::string name)
Get a TypeId by name.
Definition: type-id.cc:830
bool N1VirtualSend(Ptr< Packet > packet, const Address &source, const Address &dest, uint16_t protocolNumber)