A Discrete-Event Network Simulator
API
tcp-linux-reno.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2019 NITK Surathkal
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  * Authors: Apoorva Bhargava <apoorvabhargava13@gmail.com>
18  */
19 
20 // Network topology
21 //
22 // n0 ---------- n1 ---------- n2 ---------- n3
23 // 10 Mbps 1 Mbps 10 Mbps
24 // 1 ms 10 ms 1 ms
25 //
26 // - TCP flow from n0 to n3 using BulkSendApplication.
27 // - The following simulation output is stored in results/ in ns-3 top-level directory:
28 // - cwnd traces are stored in cwndTraces folder
29 // - queue length statistics are stored in queue-size.dat file
30 // - pcaps are stored in pcap folder
31 // - queueTraces folder contain the drop statistics at queue
32 // - queueStats.txt file contains the queue stats and config.txt file contains
33 // the simulation configuration.
34 // - The cwnd and queue length traces obtained from this example were tested against
35 // the respective traces obtained from Linux Reno by using ns-3 Direct Code Execution.
36 // See internet/doc/tcp.rst for more details.
37 
38 #include "ns3/applications-module.h"
39 #include "ns3/core-module.h"
40 #include "ns3/internet-module.h"
41 #include "ns3/network-module.h"
42 #include "ns3/point-to-point-module.h"
43 #include "ns3/traffic-control-module.h"
44 
45 #include <fstream>
46 #include <iostream>
47 #include <string>
48 #include <sys/stat.h>
49 
50 using namespace ns3;
51 std::string dir = "results/";
53 uint32_t segmentSize = 524;
54 
55 // Function to check queue length of Router 1
56 void
58 {
59  uint32_t qSize = queue->GetCurrentSize().GetValue();
60 
61  // Check queue size every 1/100 of a second
63  std::ofstream fPlotQueue(std::stringstream(dir + "queue-size.dat").str(),
64  std::ios::out | std::ios::app);
65  fPlotQueue << Simulator::Now().GetSeconds() << " " << qSize << std::endl;
66  fPlotQueue.close();
67 }
68 
69 // Function to trace change in cwnd at n0
70 static void
71 CwndChange(uint32_t oldCwnd, uint32_t newCwnd)
72 {
73  std::ofstream fPlotQueue(dir + "cwndTraces/n0.dat", std::ios::out | std::ios::app);
74  fPlotQueue << Simulator::Now().GetSeconds() << " " << newCwnd / segmentSize << std::endl;
75  fPlotQueue.close();
76 }
77 
78 // Function to calculate drops in a particular Queue
79 static void
81 {
82  *stream->GetStream() << Simulator::Now().GetSeconds() << " 1" << std::endl;
83 }
84 
85 // Trace Function for cwnd
86 void
87 TraceCwnd(uint32_t node, uint32_t cwndWindow, Callback<void, uint32_t, uint32_t> CwndTrace)
88 {
89  Config::ConnectWithoutContext("/NodeList/" + std::to_string(node) +
90  "/$ns3::TcpL4Protocol/SocketList/" +
91  std::to_string(cwndWindow) + "/CongestionWindow",
92  CwndTrace);
93 }
94 
95 // Function to install BulkSend application
96 void
99  uint16_t port,
100  std::string socketFactory,
101  uint32_t nodeId,
102  uint32_t cwndWindow,
104 {
105  BulkSendHelper source(socketFactory, InetSocketAddress(address, port));
106  source.SetAttribute("MaxBytes", UintegerValue(0));
107  ApplicationContainer sourceApps = source.Install(node);
108  sourceApps.Start(Seconds(10.0));
109  Simulator::Schedule(Seconds(10.0) + Seconds(0.001), &TraceCwnd, nodeId, cwndWindow, CwndTrace);
110  sourceApps.Stop(stopTime);
111 }
112 
113 // Function to install sink application
114 void
115 InstallPacketSink(Ptr<Node> node, uint16_t port, std::string socketFactory)
116 {
118  ApplicationContainer sinkApps = sink.Install(node);
119  sinkApps.Start(Seconds(10.0));
120  sinkApps.Stop(stopTime);
121 }
122 
123 int
124 main(int argc, char* argv[])
125 {
126  uint32_t stream = 1;
127  std::string socketFactory = "ns3::TcpSocketFactory";
128  std::string tcpTypeId = "ns3::TcpLinuxReno";
129  std::string qdiscTypeId = "ns3::FifoQueueDisc";
130  bool isSack = true;
131  uint32_t delAckCount = 1;
132  std::string recovery = "ns3::TcpClassicRecovery";
133 
135  cmd.AddValue("tcpTypeId",
136  "TCP variant to use (e.g., ns3::TcpNewReno, ns3::TcpLinuxReno, etc.)",
137  tcpTypeId);
138  cmd.AddValue("qdiscTypeId", "Queue disc for gateway (e.g., ns3::CoDelQueueDisc)", qdiscTypeId);
139  cmd.AddValue("segmentSize", "TCP segment size (bytes)", segmentSize);
140  cmd.AddValue("delAckCount", "Delayed ack count", delAckCount);
141  cmd.AddValue("enableSack", "Flag to enable/disable sack in TCP", isSack);
142  cmd.AddValue("stopTime",
143  "Stop time for applications / simulation time will be stopTime",
144  stopTime);
145  cmd.AddValue("recovery", "Recovery algorithm type to use (e.g., ns3::TcpPrrRecovery", recovery);
146  cmd.Parse(argc, argv);
147 
148  TypeId qdTid;
150  "TypeId " << qdiscTypeId << " not found");
151 
152  // Set recovery algorithm and TCP variant
153  Config::SetDefault("ns3::TcpL4Protocol::RecoveryType",
154  TypeIdValue(TypeId::LookupByName(recovery)));
155  TypeId tcpTid;
157  "TypeId " << tcpTypeId << " not found");
158  Config::SetDefault("ns3::TcpL4Protocol::SocketType",
159  TypeIdValue(TypeId::LookupByName(tcpTypeId)));
160 
161  // Create nodes
162  NodeContainer leftNodes;
163  NodeContainer rightNodes;
164  NodeContainer routers;
165  routers.Create(2);
166  leftNodes.Create(1);
167  rightNodes.Create(1);
168 
169  std::vector<NetDeviceContainer> leftToRouter;
170  std::vector<NetDeviceContainer> routerToRight;
171 
172  // Create the point-to-point link helpers and connect two router nodes
173  PointToPointHelper pointToPointRouter;
174  pointToPointRouter.SetDeviceAttribute("DataRate", StringValue("1Mbps"));
175  pointToPointRouter.SetChannelAttribute("Delay", StringValue("10ms"));
176  NetDeviceContainer r1r2ND = pointToPointRouter.Install(routers.Get(0), routers.Get(1));
177 
178  // Create the point-to-point link helpers and connect leaf nodes to router
179  PointToPointHelper pointToPointLeaf;
180  pointToPointLeaf.SetDeviceAttribute("DataRate", StringValue("10Mbps"));
181  pointToPointLeaf.SetChannelAttribute("Delay", StringValue("1ms"));
182  leftToRouter.push_back(pointToPointLeaf.Install(leftNodes.Get(0), routers.Get(0)));
183  routerToRight.push_back(pointToPointLeaf.Install(routers.Get(1), rightNodes.Get(0)));
184 
185  InternetStackHelper internetStack;
186 
187  internetStack.Install(leftNodes);
188  internetStack.Install(rightNodes);
189  internetStack.Install(routers);
190 
191  // Assign IP addresses to all the network devices
192  Ipv4AddressHelper ipAddresses("10.0.0.0", "255.255.255.0");
193 
194  Ipv4InterfaceContainer r1r2IPAddress = ipAddresses.Assign(r1r2ND);
195  ipAddresses.NewNetwork();
196 
197  std::vector<Ipv4InterfaceContainer> leftToRouterIPAddress;
198  leftToRouterIPAddress.push_back(ipAddresses.Assign(leftToRouter[0]));
199  ipAddresses.NewNetwork();
200 
201  std::vector<Ipv4InterfaceContainer> routerToRightIPAddress;
202  routerToRightIPAddress.push_back(ipAddresses.Assign(routerToRight[0]));
203 
205 
206  // Set default sender and receiver buffer size as 1MB
207  Config::SetDefault("ns3::TcpSocket::SndBufSize", UintegerValue(1 << 20));
208  Config::SetDefault("ns3::TcpSocket::RcvBufSize", UintegerValue(1 << 20));
209 
210  // Set default initial congestion window as 10 segments
211  Config::SetDefault("ns3::TcpSocket::InitialCwnd", UintegerValue(10));
212 
213  // Set default delayed ack count to a specified value
214  Config::SetDefault("ns3::TcpSocket::DelAckCount", UintegerValue(delAckCount));
215 
216  // Set default segment size of TCP packet to a specified value
217  Config::SetDefault("ns3::TcpSocket::SegmentSize", UintegerValue(segmentSize));
218 
219  // Enable/Disable SACK in TCP
220  Config::SetDefault("ns3::TcpSocketBase::Sack", BooleanValue(isSack));
221 
222  // Create directories to store dat files
223  struct stat buffer;
224  int retVal [[maybe_unused]];
225  if ((stat(dir.c_str(), &buffer)) == 0)
226  {
227  std::string dirToRemove = "rm -rf " + dir;
228  retVal = system(dirToRemove.c_str());
229  NS_ASSERT_MSG(retVal == 0, "Error in return value");
230  }
231  std::string dirToSave = "mkdir -p " + dir;
232  retVal = system(dirToSave.c_str());
233  NS_ASSERT_MSG(retVal == 0, "Error in return value");
234  retVal = system((dirToSave + "/pcap/").c_str());
235  NS_ASSERT_MSG(retVal == 0, "Error in return value");
236  retVal = system((dirToSave + "/queueTraces/").c_str());
237  NS_ASSERT_MSG(retVal == 0, "Error in return value");
238  retVal = system((dirToSave + "/cwndTraces/").c_str());
239  NS_ASSERT_MSG(retVal == 0, "Error in return value");
240 
241  // Set default parameters for queue discipline
242  Config::SetDefault(qdiscTypeId + "::MaxSize", QueueSizeValue(QueueSize("100p")));
243 
244  // Install queue discipline on router
246  tch.SetRootQueueDisc(qdiscTypeId);
248  tch.Uninstall(routers.Get(0)->GetDevice(0));
249  qd.Add(tch.Install(routers.Get(0)->GetDevice(0)).Get(0));
250 
251  // Enable BQL
252  tch.SetQueueLimits("ns3::DynamicQueueLimits");
253 
254  // Calls function to check queue size
256 
257  AsciiTraceHelper asciiTraceHelper;
258  Ptr<OutputStreamWrapper> streamWrapper;
259 
260  // Create dat to store packets dropped and marked at the router
261  streamWrapper = asciiTraceHelper.CreateFileStream(dir + "/queueTraces/drop-0.dat");
262  qd.Get(0)->TraceConnectWithoutContext("Drop", MakeBoundCallback(&DropAtQueue, streamWrapper));
263 
264  // Install packet sink at receiver side
265  uint16_t port = 50000;
266  InstallPacketSink(rightNodes.Get(0), port, "ns3::TcpSocketFactory");
267 
268  // Install BulkSend application
269  InstallBulkSend(leftNodes.Get(0),
270  routerToRightIPAddress[0].GetAddress(1),
271  port,
272  socketFactory,
273  2,
274  0,
276 
277  // Enable PCAP on all the point to point interfaces
278  pointToPointLeaf.EnablePcapAll(dir + "pcap/ns-3", true);
279 
281  Simulator::Run();
282 
283  // Store queue stats in a file
284  std::ofstream myfile;
285  myfile.open(dir + "queueStats.txt", std::fstream::in | std::fstream::out | std::fstream::app);
286  myfile << std::endl;
287  myfile << "Stat for Queue 1";
288  myfile << qd.Get(0)->GetStats();
289  myfile.close();
290 
291  // Store configuration of the simulation in a file
292  myfile.open(dir + "config.txt", std::fstream::in | std::fstream::out | std::fstream::app);
293  myfile << "qdiscTypeId " << qdiscTypeId << "\n";
294  myfile << "stream " << stream << "\n";
295  myfile << "segmentSize " << segmentSize << "\n";
296  myfile << "delAckCount " << delAckCount << "\n";
297  myfile << "stopTime " << stopTime.As(Time::S) << "\n";
298  myfile.close();
299 
301 
302  return 0;
303 }
holds a vector of ns3::Application pointers.
void Start(Time start) const
Start all of the Applications in this container at the start time given as a parameter.
void Stop(Time stop) const
Arrange for all of the Applications in this container to Stop() at the Time given as a parameter.
Manage ASCII trace files for device models.
Definition: trace-helper.h:173
Ptr< OutputStreamWrapper > CreateFileStream(std::string filename, std::ios::openmode filemode=std::ios::out)
Create and initialize an output stream object we'll use to write the traced bits.
AttributeValue implementation for Boolean.
Definition: boolean.h:37
A helper to make it easier to instantiate an ns3::BulkSendApplication on a set of nodes.
void SetAttribute(std::string name, const AttributeValue &value)
Helper function used to set the underlying application attributes, not the socket attributes.
ApplicationContainer Install(NodeContainer c) const
Install an ns3::BulkSendApplication on each node of the input container configured with all the attri...
Callback template class.
Definition: callback.h:443
Parse command-line arguments.
Definition: command-line.h:232
an Inet address class
aggregate IP/TCP/UDP functionality to existing Nodes.
void Install(std::string nodeName) const
Aggregate implementations of the ns3::Ipv4, ns3::Ipv6, ns3::Udp, and ns3::Tcp classes onto the provid...
A helper class to make life easier while doing simple IPv4 address assignment in scripts.
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:43
static Ipv4Address GetAny()
static void PopulateRoutingTables()
Build a routing database and initialize the routing tables of the nodes in the simulation.
holds a vector of std::pair of Ptr<Ipv4> and interface index.
holds a vector of ns3::NetDevice pointers
keep track of a set of node pointers.
void Create(uint32_t n)
Create n nodes and append pointers to them to the end of this NodeContainer.
Ptr< Node > Get(uint32_t i) const
Get the Ptr<Node> stored in this container at a given index.
Ptr< NetDevice > GetDevice(uint32_t index) const
Retrieve the index-th NetDevice associated to this node.
Definition: node.cc:152
bool TraceConnectWithoutContext(std::string name, const CallbackBase &cb)
Connect a TraceSource to a Callback without a context.
Definition: object-base.cc:311
std::ostream * GetStream()
Return a pointer to an ostream previously set in the wrapper.
A helper to make it easier to instantiate an ns3::PacketSinkApplication on a set of nodes.
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 ...
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.
void SetChannelAttribute(std::string name, const AttributeValue &value)
Set an attribute value to be propagated to each Channel created by the helper.
NetDeviceContainer Install(NodeContainer c)
Holds a vector of ns3::QueueDisc pointers.
void Add(QueueDiscContainer other)
Append the contents of another QueueDiscContainer to the end of this container.
Ptr< QueueDisc > Get(std::size_t i) const
Get the Ptr<QueueDisc> stored in this container at a given index.
QueueSize GetCurrentSize()
Get the current size of the queue disc in bytes, if operating in bytes mode, or packets,...
Definition: queue-disc.cc:519
const Stats & GetStats()
Retrieve all the collected statistics.
Definition: queue-disc.cc:416
Class for representing queue sizes.
Definition: queue-size.h:96
uint32_t GetValue() const
Get the underlying value.
Definition: queue-size.cc:183
AttributeValue implementation for QueueSize.
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
Definition: simulator.h:568
static void Destroy()
Execute the events scheduled with ScheduleDestroy().
Definition: simulator.cc:140
static Time Now()
Return the current simulation virtual time.
Definition: simulator.cc:199
static void Run()
Run the simulation.
Definition: simulator.cc:176
static EventId ScheduleNow(FUNC f, Ts &&... args)
Schedule an event to expire Now.
Definition: simulator.h:606
static void Stop()
Tell the Simulator the calling event should be the last one executed.
Definition: simulator.cc:184
Hold variables of type string.
Definition: string.h:56
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
TimeWithUnit As(const Unit unit=Time::AUTO) const
Attach a unit to a Time, to facilitate output in a specific unit.
Definition: time.cc:417
double GetSeconds() const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:402
@ S
second
Definition: nstime.h:116
Build a set of QueueDisc objects.
QueueDiscContainer Install(NetDeviceContainer c)
uint16_t SetRootQueueDisc(const std::string &type, Args &&... args)
Helper function used to set a root queue disc of the given type and with the given attributes.
void SetQueueLimits(std::string type, Args &&... args)
Helper function used to add a queue limits object to the transmission queues of the devices.
void Uninstall(NetDeviceContainer c)
a unique identifier for an interface.
Definition: type-id.h:60
static TypeId LookupByName(std::string name)
Get a TypeId by name.
Definition: type-id.cc:839
static bool LookupByNameFailSafe(std::string name, TypeId *tid)
Get a TypeId by name.
Definition: type-id.cc:848
AttributeValue implementation for TypeId.
Definition: type-id.h:600
Hold an unsigned integer type.
Definition: uinteger.h:45
static void CwndTrace(Ptr< OutputStreamWrapper > stream, uint32_t oldCwnd, uint32_t newCwnd)
uint16_t port
Definition: dsdv-manet.cc:45
void InstallBulkSend(Ptr< Node > node, Ipv4Address address, uint16_t port, std::string socketFactory, uint32_t nodeId, uint32_t cwndWindow, Callback< void, uint32_t, uint32_t > CwndTrace)
void TraceCwnd(uint32_t node, uint32_t cwndWindow, Callback< void, uint32_t, uint32_t > CwndTrace)
uint32_t segmentSize
void InstallPacketSink(Ptr< Node > node, uint16_t port, std::string socketFactory)
static void DropAtQueue(Ptr< OutputStreamWrapper > stream, Ptr< const QueueDiscItem > item)
void CheckQueueSize(Ptr< QueueDisc > queue)
Time stopTime
static void CwndChange(uint32_t oldCwnd, uint32_t newCwnd)
std::string dir
#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
void SetDefault(std::string name, const AttributeValue &value)
Definition: config.cc:891
void ConnectWithoutContext(std::string path, const CallbackBase &cb)
Definition: config.cc:951
#define NS_ABORT_MSG_UNLESS(cond, msg)
Abnormal program termination if a condition is false, with a message.
Definition: abort.h:144
auto MakeBoundCallback(R(*fnPtr)(Args...), BArgs &&... bargs)
Make Callbacks with varying number of bound arguments.
Definition: callback.h:768
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1336
address
Definition: first.py:40
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Callback< R, Args... > MakeCallback(R(T::*memPtr)(Args...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
Definition: callback.h:707
cmd
Definition: second.py:33
Ptr< PacketSink > sink
Pointer to the packet sink application.
Definition: wifi-tcp.cc:55