A Discrete-Event Network Simulator
API
fq-cobalt-queue-disc.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2016 Universita' degli Studi di Napoli Federico II
4  * Copyright (c) 2020 NITK Surathkal (adapted for COBALT)
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation;
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18  *
19  * Authors: Pasquale Imputato <p.imputato@gmail.com>
20  * Stefano Avallone <stefano.avallone@unina.it>
21  * Modified by: Bhaskar Kataria <bhaskar.k7920@gmail.com> (for COBALT)
22  * Tom Henderson <tomhend@u.washington.edu>
23  * Mohit P. Tahiliani <tahiliani@nitk.edu.in>
24  * Vivek Jain <jain.vivek.anand@gmail.com>
25  * Ankit Deepak <adadeepak8@gmail.com>
26  */
27 
28 #ifndef FQ_COBALT_QUEUE_DISC
29 #define FQ_COBALT_QUEUE_DISC
30 
31 #include "ns3/queue-disc.h"
32 #include "ns3/object-factory.h"
33 #include <list>
34 #include <map>
35 
36 namespace ns3 {
37 
45 {
46 public:
51  static TypeId GetTypeId (void);
55  FqCobaltFlow ();
56 
57  virtual ~FqCobaltFlow ();
58 
64  {
67  OLD_FLOW
68  };
69 
74  void SetDeficit (uint32_t deficit);
79  int32_t GetDeficit (void) const;
84  void IncreaseDeficit (int32_t deficit);
89  void SetStatus (FlowStatus status);
94  FlowStatus GetStatus (void) const;
99  void SetIndex (uint32_t index);
104  uint32_t GetIndex (void) const;
105 
106 private:
107  int32_t m_deficit;
109  uint32_t m_index;
110 };
111 
112 
120 {
121 public:
126  static TypeId GetTypeId (void);
131 
132  virtual ~FqCobaltQueueDisc ();
133 
139  void SetQuantum (uint32_t quantum);
140 
146  uint32_t GetQuantum (void) const;
147 
148  // Reasons for dropping packets
149  static constexpr const char* UNCLASSIFIED_DROP = "Unclassified drop";
150  static constexpr const char* OVERLIMIT_DROP = "Overlimit drop";
151 
152 private:
153  virtual bool DoEnqueue (Ptr<QueueDiscItem> item);
154  virtual Ptr<QueueDiscItem> DoDequeue (void);
155  virtual bool CheckConfig (void);
156  virtual void InitializeParams (void);
157 
162  uint32_t FqCobaltDrop (void);
163 
171  uint32_t SetAssociativeHash (uint32_t flowHash);
172 
173  std::string m_interval;
174  std::string m_target;
175  uint32_t m_quantum;
176  uint32_t m_flows;
177  uint32_t m_setWays;
178  uint32_t m_dropBatchSize;
179  uint32_t m_perturbation;
180  bool m_useEcn;
183  bool m_useL4s;
184  double m_increment;
185  double m_decrement;
186  double m_Pdrop;
188 
189  std::list<Ptr<FqCobaltFlow> > m_newFlows;
190  std::list<Ptr<FqCobaltFlow> > m_oldFlows;
191 
192  std::map<uint32_t, uint32_t> m_flowsIndices;
193  std::map<uint32_t, uint32_t> m_tags;
194 
197 };
198 
199 } // namespace ns3
200 
201 #endif /* FQ_COBALT_QUEUE_DISC */
202 
ns3::TypeId
a unique identifier for an interface.
Definition: type-id.h:59
ns3::FqCobaltFlow::SetIndex
void SetIndex(uint32_t index)
Set the index for this flow.
Definition: fq-cobalt-queue-disc.cc:100
ns3::FqCobaltFlow::FlowStatus
FlowStatus
Used to determine the status of this flow queue.
Definition: fq-cobalt-queue-disc.h:64
ns3::FqCobaltFlow::IncreaseDeficit
void IncreaseDeficit(int32_t deficit)
Increase the deficit for this flow.
Definition: fq-cobalt-queue-disc.cc:79
ns3::FqCobaltQueueDisc::UNCLASSIFIED_DROP
static constexpr const char * UNCLASSIFIED_DROP
No packet filter able to classify packet.
Definition: fq-cobalt-queue-disc.h:149
ns3::FqCobaltFlow::m_status
FlowStatus m_status
the status of this flow
Definition: fq-cobalt-queue-disc.h:108
ns3::FqCobaltQueueDisc::FqCobaltQueueDisc
FqCobaltQueueDisc()
FqCobaltQueueDisc constructor.
Definition: fq-cobalt-queue-disc.cc:201
ns3::FqCobaltQueueDisc::m_flowFactory
ObjectFactory m_flowFactory
Factory to create a new flow.
Definition: fq-cobalt-queue-disc.h:195
ns3::FqCobaltQueueDisc::GetQuantum
uint32_t GetQuantum(void) const
Get the quantum value.
Definition: fq-cobalt-queue-disc.cc:221
ns3
Every class exported by the ns3 library is enclosed in the ns3 namespace.
ns3::FqCobaltQueueDisc::m_flows
uint32_t m_flows
Number of flow queues.
Definition: fq-cobalt-queue-disc.h:176
ns3::FqCobaltFlow::OLD_FLOW
@ OLD_FLOW
Definition: fq-cobalt-queue-disc.h:67
ns3::QueueDisc
QueueDisc is an abstract base class providing the interface and implementing the operations common to...
Definition: queue-disc.h:181
ns3::FqCobaltQueueDisc::~FqCobaltQueueDisc
virtual ~FqCobaltQueueDisc()
Definition: fq-cobalt-queue-disc.cc:208
ns3::FqCobaltFlow::m_index
uint32_t m_index
the index for this flow
Definition: fq-cobalt-queue-disc.h:109
ns3::FqCobaltFlow::SetDeficit
void SetDeficit(uint32_t deficit)
Set the deficit for this flow.
Definition: fq-cobalt-queue-disc.cc:65
ns3::FqCobaltQueueDisc::m_perturbation
uint32_t m_perturbation
hash perturbation value
Definition: fq-cobalt-queue-disc.h:179
ns3::FqCobaltQueueDisc
A FqCobalt packet queue disc.
Definition: fq-cobalt-queue-disc.h:120
ns3::QueueDiscClass
QueueDiscClass is the base class for classes that are included in a queue disc.
Definition: queue-disc.h:49
ns3::FqCobaltFlow::SetStatus
void SetStatus(FlowStatus status)
Set the status for this flow.
Definition: fq-cobalt-queue-disc.cc:86
ns3::FqCobaltFlow::GetStatus
FlowStatus GetStatus(void) const
Get the status of this flow.
Definition: fq-cobalt-queue-disc.cc:93
ns3::FqCobaltQueueDisc::m_useL4s
bool m_useL4s
True if L4S is used (ECT1 packets are marked at CE threshold)
Definition: fq-cobalt-queue-disc.h:183
ns3::Ptr
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:74
ns3::FqCobaltQueueDisc::OVERLIMIT_DROP
static constexpr const char * OVERLIMIT_DROP
Overlimit dropped packets.
Definition: fq-cobalt-queue-disc.h:150
ns3::FqCobaltQueueDisc::m_interval
std::string m_interval
CoDel interval attribute.
Definition: fq-cobalt-queue-disc.h:173
ns3::FqCobaltQueueDisc::InitializeParams
virtual void InitializeParams(void)
Initialize parameters (if any) before the first packet is enqueued.
Definition: fq-cobalt-queue-disc.cc:478
ns3::FqCobaltQueueDisc::m_setWays
uint32_t m_setWays
size of a set of queues (used by set associative hash)
Definition: fq-cobalt-queue-disc.h:177
ns3::FqCobaltFlow::m_deficit
int32_t m_deficit
the deficit for this flow
Definition: fq-cobalt-queue-disc.h:107
ns3::FqCobaltQueueDisc::m_dropBatchSize
uint32_t m_dropBatchSize
Max number of packets dropped from the fat flow.
Definition: fq-cobalt-queue-disc.h:178
ns3::FqCobaltQueueDisc::FqCobaltDrop
uint32_t FqCobaltDrop(void)
Drop a packet from the head of the queue with the largest current byte count.
Definition: fq-cobalt-queue-disc.cc:494
ns3::ObjectFactory
Instantiate subclasses of ns3::Object.
Definition: object-factory.h:48
ns3::FqCobaltFlow
A flow queue used by the FqCobalt queue disc.
Definition: fq-cobalt-queue-disc.h:45
ns3::FqCobaltQueueDisc::SetAssociativeHash
uint32_t SetAssociativeHash(uint32_t flowHash)
Compute the index of the queue for the flow having the given flowHash, according to the set associati...
Definition: fq-cobalt-queue-disc.cc:227
ns3::FqCobaltFlow::NEW_FLOW
@ NEW_FLOW
Definition: fq-cobalt-queue-disc.h:66
ns3::Time
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:104
ns3::FqCobaltQueueDisc::SetQuantum
void SetQuantum(uint32_t quantum)
Set the quantum value.
Definition: fq-cobalt-queue-disc.cc:214
ns3::FqCobaltFlow::~FqCobaltFlow
virtual ~FqCobaltFlow()
Definition: fq-cobalt-queue-disc.cc:59
ns3::FqCobaltQueueDisc::m_blueThreshold
Time m_blueThreshold
Threshold to enable blue enhancement.
Definition: fq-cobalt-queue-disc.h:187
ns3::FqCobaltQueueDisc::m_increment
double m_increment
increment value for marking probability
Definition: fq-cobalt-queue-disc.h:184
ns3::FqCobaltQueueDisc::m_quantum
uint32_t m_quantum
Deficit assigned to flows at each round.
Definition: fq-cobalt-queue-disc.h:175
ns3::FqCobaltQueueDisc::GetTypeId
static TypeId GetTypeId(void)
Get the type ID.
Definition: fq-cobalt-queue-disc.cc:115
ns3::FqCobaltQueueDisc::m_queueDiscFactory
ObjectFactory m_queueDiscFactory
Factory to create a new queue.
Definition: fq-cobalt-queue-disc.h:196
ns3::FqCobaltQueueDisc::m_target
std::string m_target
CoDel target attribute.
Definition: fq-cobalt-queue-disc.h:174
ns3::FqCobaltQueueDisc::m_useEcn
bool m_useEcn
True if ECN is used (packets are marked instead of being dropped)
Definition: fq-cobalt-queue-disc.h:180
ns3::FqCobaltQueueDisc::m_oldFlows
std::list< Ptr< FqCobaltFlow > > m_oldFlows
The list of old flows.
Definition: fq-cobalt-queue-disc.h:190
ns3::FqCobaltQueueDisc::m_newFlows
std::list< Ptr< FqCobaltFlow > > m_newFlows
The list of new flows.
Definition: fq-cobalt-queue-disc.h:189
ns3::FqCobaltQueueDisc::m_Pdrop
double m_Pdrop
Drop Probability.
Definition: fq-cobalt-queue-disc.h:186
ns3::FqCobaltFlow::FqCobaltFlow
FqCobaltFlow()
FqCobaltFlow constructor.
Definition: fq-cobalt-queue-disc.cc:51
ns3::FqCobaltQueueDisc::DoEnqueue
virtual bool DoEnqueue(Ptr< QueueDiscItem > item)
This function actually enqueues a packet into the queue disc.
Definition: fq-cobalt-queue-disc.cc:256
ns3::FqCobaltFlow::GetIndex
uint32_t GetIndex(void) const
Get the index of this flow.
Definition: fq-cobalt-queue-disc.cc:107
ns3::FqCobaltQueueDisc::m_decrement
double m_decrement
decrement value for marking probability
Definition: fq-cobalt-queue-disc.h:185
ns3::FqCobaltFlow::GetTypeId
static TypeId GetTypeId(void)
Get the type ID.
Definition: fq-cobalt-queue-disc.cc:41
ns3::FqCobaltFlow::INACTIVE
@ INACTIVE
Definition: fq-cobalt-queue-disc.h:65
ns3::FqCobaltQueueDisc::CheckConfig
virtual bool CheckConfig(void)
Check whether the current configuration is correct.
Definition: fq-cobalt-queue-disc.cc:423
ns3::FqCobaltQueueDisc::DoDequeue
virtual Ptr< QueueDiscItem > DoDequeue(void)
This function actually extracts a packet from the queue disc.
Definition: fq-cobalt-queue-disc.cc:339
ns3::FqCobaltQueueDisc::m_enableSetAssociativeHash
bool m_enableSetAssociativeHash
whether to enable set associative hash
Definition: fq-cobalt-queue-disc.h:182
ns3::FqCobaltQueueDisc::m_ceThreshold
Time m_ceThreshold
Threshold above which to CE mark.
Definition: fq-cobalt-queue-disc.h:181
ns3::FqCobaltFlow::GetDeficit
int32_t GetDeficit(void) const
Get the deficit for this flow.
Definition: fq-cobalt-queue-disc.cc:72
ns3::FqCobaltQueueDisc::m_flowsIndices
std::map< uint32_t, uint32_t > m_flowsIndices
Map with the index of class for each flow.
Definition: fq-cobalt-queue-disc.h:192
ns3::FqCobaltQueueDisc::m_tags
std::map< uint32_t, uint32_t > m_tags
Tags used by set associative hash.
Definition: fq-cobalt-queue-disc.h:193