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
50using namespace ns3;
51std::string dir = "results/";
54
55// Function to check queue length of Router 1
56void
58{
59 uint32_t qSize = queue->GetCurrentSize().GetValue();
60
61 // Check queue size every 1/100 of a second
62 Simulator::Schedule(Seconds(0.001), &CheckQueueSize, queue);
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
70static void
71CwndChange(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
79static void
81{
82 *stream->GetStream() << Simulator::Now().GetSeconds() << " 1" << std::endl;
83}
84
85// Trace Function for cwnd
86void
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
96void
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
114void
115InstallPacketSink(Ptr<Node> node, uint16_t port, std::string socketFactory)
116{
117 PacketSinkHelper sink(socketFactory, InetSocketAddress(Ipv4Address::GetAny(), port));
118 ApplicationContainer sinkApps = sink.Install(node);
119 sinkApps.Start(Seconds(10.0));
120 sinkApps.Stop(stopTime);
121}
122
123int
124main(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;
149 NS_ABORT_MSG_UNLESS(TypeId::LookupByNameFailSafe(qdiscTypeId, &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 if (tcpTypeId == "ns3::TcpWestwoodPlus")
156 {
157 // TcpWestwoodPlus is not an actual TypeId name; we need TcpWestwood here
158 Config::SetDefault("ns3::TcpL4Protocol::SocketType", TypeIdValue(TcpWestwood::GetTypeId()));
159 // the default protocol type in ns3::TcpWestwood is WESTWOOD
160 Config::SetDefault("ns3::TcpWestwood::ProtocolType", EnumValue(TcpWestwood::WESTWOODPLUS));
161 }
162 else
163 {
164 TypeId tcpTid;
165 NS_ABORT_MSG_UNLESS(TypeId::LookupByNameFailSafe(tcpTypeId, &tcpTid),
166 "TypeId " << tcpTypeId << " not found");
167 Config::SetDefault("ns3::TcpL4Protocol::SocketType",
168 TypeIdValue(TypeId::LookupByName(tcpTypeId)));
169 }
170
171 // Create nodes
172 NodeContainer leftNodes;
173 NodeContainer rightNodes;
174 NodeContainer routers;
175 routers.Create(2);
176 leftNodes.Create(1);
177 rightNodes.Create(1);
178
179 std::vector<NetDeviceContainer> leftToRouter;
180 std::vector<NetDeviceContainer> routerToRight;
181
182 // Create the point-to-point link helpers and connect two router nodes
183 PointToPointHelper pointToPointRouter;
184 pointToPointRouter.SetDeviceAttribute("DataRate", StringValue("1Mbps"));
185 pointToPointRouter.SetChannelAttribute("Delay", StringValue("10ms"));
186 NetDeviceContainer r1r2ND = pointToPointRouter.Install(routers.Get(0), routers.Get(1));
187
188 // Create the point-to-point link helpers and connect leaf nodes to router
189 PointToPointHelper pointToPointLeaf;
190 pointToPointLeaf.SetDeviceAttribute("DataRate", StringValue("10Mbps"));
191 pointToPointLeaf.SetChannelAttribute("Delay", StringValue("1ms"));
192 leftToRouter.push_back(pointToPointLeaf.Install(leftNodes.Get(0), routers.Get(0)));
193 routerToRight.push_back(pointToPointLeaf.Install(routers.Get(1), rightNodes.Get(0)));
194
195 InternetStackHelper internetStack;
196
197 internetStack.Install(leftNodes);
198 internetStack.Install(rightNodes);
199 internetStack.Install(routers);
200
201 // Assign IP addresses to all the network devices
202 Ipv4AddressHelper ipAddresses("10.0.0.0", "255.255.255.0");
203
204 Ipv4InterfaceContainer r1r2IPAddress = ipAddresses.Assign(r1r2ND);
205 ipAddresses.NewNetwork();
206
207 std::vector<Ipv4InterfaceContainer> leftToRouterIPAddress;
208 leftToRouterIPAddress.push_back(ipAddresses.Assign(leftToRouter[0]));
209 ipAddresses.NewNetwork();
210
211 std::vector<Ipv4InterfaceContainer> routerToRightIPAddress;
212 routerToRightIPAddress.push_back(ipAddresses.Assign(routerToRight[0]));
213
214 Ipv4GlobalRoutingHelper::PopulateRoutingTables();
215
216 // Set default sender and receiver buffer size as 1MB
217 Config::SetDefault("ns3::TcpSocket::SndBufSize", UintegerValue(1 << 20));
218 Config::SetDefault("ns3::TcpSocket::RcvBufSize", UintegerValue(1 << 20));
219
220 // Set default initial congestion window as 10 segments
221 Config::SetDefault("ns3::TcpSocket::InitialCwnd", UintegerValue(10));
222
223 // Set default delayed ack count to a specified value
224 Config::SetDefault("ns3::TcpSocket::DelAckCount", UintegerValue(delAckCount));
225
226 // Set default segment size of TCP packet to a specified value
227 Config::SetDefault("ns3::TcpSocket::SegmentSize", UintegerValue(segmentSize));
228
229 // Enable/Disable SACK in TCP
230 Config::SetDefault("ns3::TcpSocketBase::Sack", BooleanValue(isSack));
231
232 // Create directories to store dat files
233 struct stat buffer;
234 int retVal [[maybe_unused]];
235 if ((stat(dir.c_str(), &buffer)) == 0)
236 {
237 std::string dirToRemove = "rm -rf " + dir;
238 retVal = system(dirToRemove.c_str());
239 NS_ASSERT_MSG(retVal == 0, "Error in return value");
240 }
241 std::string dirToSave = "mkdir -p " + dir;
242 retVal = system(dirToSave.c_str());
243 NS_ASSERT_MSG(retVal == 0, "Error in return value");
244 retVal = system((dirToSave + "/pcap/").c_str());
245 NS_ASSERT_MSG(retVal == 0, "Error in return value");
246 retVal = system((dirToSave + "/queueTraces/").c_str());
247 NS_ASSERT_MSG(retVal == 0, "Error in return value");
248 retVal = system((dirToSave + "/cwndTraces/").c_str());
249 NS_ASSERT_MSG(retVal == 0, "Error in return value");
250
251 // Set default parameters for queue discipline
252 Config::SetDefault(qdiscTypeId + "::MaxSize", QueueSizeValue(QueueSize("100p")));
253
254 // Install queue discipline on router
256 tch.SetRootQueueDisc(qdiscTypeId);
258 tch.Uninstall(routers.Get(0)->GetDevice(0));
259 qd.Add(tch.Install(routers.Get(0)->GetDevice(0)).Get(0));
260
261 // Enable BQL
262 tch.SetQueueLimits("ns3::DynamicQueueLimits");
263
264 // Calls function to check queue size
265 Simulator::ScheduleNow(&CheckQueueSize, qd.Get(0));
266
267 AsciiTraceHelper asciiTraceHelper;
268 Ptr<OutputStreamWrapper> streamWrapper;
269
270 // Create dat to store packets dropped and marked at the router
271 streamWrapper = asciiTraceHelper.CreateFileStream(dir + "/queueTraces/drop-0.dat");
272 qd.Get(0)->TraceConnectWithoutContext("Drop", MakeBoundCallback(&DropAtQueue, streamWrapper));
273
274 // Install packet sink at receiver side
275 uint16_t port = 50000;
276 InstallPacketSink(rightNodes.Get(0), port, "ns3::TcpSocketFactory");
277
278 // Install BulkSend application
279 InstallBulkSend(leftNodes.Get(0),
280 routerToRightIPAddress[0].GetAddress(1),
281 port,
282 socketFactory,
283 2,
284 0,
286
287 // Enable PCAP on all the point to point interfaces
288 pointToPointLeaf.EnablePcapAll(dir + "pcap/ns-3", true);
289
290 Simulator::Stop(stopTime);
291 Simulator::Run();
292
293 // Store queue stats in a file
294 std::ofstream myfile;
295 myfile.open(dir + "queueStats.txt", std::fstream::in | std::fstream::out | std::fstream::app);
296 myfile << std::endl;
297 myfile << "Stat for Queue 1";
298 myfile << qd.Get(0)->GetStats();
299 myfile.close();
300
301 // Store configuration of the simulation in a file
302 myfile.open(dir + "config.txt", std::fstream::in | std::fstream::out | std::fstream::app);
303 myfile << "qdiscTypeId " << qdiscTypeId << "\n";
304 myfile << "stream " << stream << "\n";
305 myfile << "segmentSize " << segmentSize << "\n";
306 myfile << "delAckCount " << delAckCount << "\n";
307 myfile << "stopTime " << stopTime.As(Time::S) << "\n";
308 myfile.close();
309
310 Simulator::Destroy();
311
312 return 0;
313}
holds a vector of ns3::Application pointers.
void Start(Time start)
Arrange for all of the Applications in this container to Start() at the Time given as a parameter.
void Stop(Time stop)
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
Hold variables of type enum.
Definition: enum.h:56
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
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:369
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.
Hold variables of type string.
Definition: string.h:42
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
double GetSeconds() const
Get an approximation of the time stored in this instance in the indicated unit.
Definition: nstime.h:402
TimeWithUnit As(const enum Unit unit=Time::AUTO) const
Attach a unit to a Time, to facilitate output in a specific unit.
Definition: time.cc:417
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
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:752
Time Now()
create an ns3::Time instance which contains the current simulation time.
Definition: simulator.cc:296
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1338
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:691
cmd
Definition: second.py:33
Ptr< PacketSink > sink
Pointer to the packet sink application.
Definition: wifi-tcp.cc:55