A Discrete-Event Network Simulator
API
ipv6-flow-probe.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 //
3 // Copyright (c) 2009 INESC Porto
4 //
5 // This program is free software; you can redistribute it and/or modify
6 // it under the terms of the GNU General Public License version 2 as
7 // published by the Free Software Foundation;
8 //
9 // This program is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with this program; if not, write to the Free Software
16 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 //
18 // Author: Gustavo J. A. M. Carneiro <gjc@inescporto.pt> <gjcarneiro@gmail.com>
19 // Modifications: Tommaso Pecorella <tommaso.pecorella@unifi.it>
20 //
21 
22 #include "ns3/ipv6-flow-probe.h"
23 #include "ns3/ipv6-flow-classifier.h"
24 #include "ns3/node.h"
25 #include "ns3/packet.h"
26 #include "ns3/flow-monitor.h"
27 #include "ns3/log.h"
28 #include "ns3/pointer.h"
29 #include "ns3/config.h"
30 #include "ns3/flow-id-tag.h"
31 
32 namespace ns3 {
33 
34 NS_LOG_COMPONENT_DEFINE ("Ipv6FlowProbe");
35 
37 // Ipv6FlowProbeTag class implementation //
39 
49 class Ipv6FlowProbeTag : public Tag
50 {
51 public:
56  static TypeId GetTypeId (void);
57  virtual TypeId GetInstanceTypeId (void) const;
58  virtual uint32_t GetSerializedSize (void) const;
59  virtual void Serialize (TagBuffer buf) const;
60  virtual void Deserialize (TagBuffer buf);
61  virtual void Print (std::ostream &os) const;
69  Ipv6FlowProbeTag (uint32_t flowId, uint32_t packetId, uint32_t packetSize);
74  void SetFlowId (uint32_t flowId);
79  void SetPacketId (uint32_t packetId);
84  void SetPacketSize (uint32_t packetSize);
89  uint32_t GetFlowId (void) const;
94  uint32_t GetPacketId (void) const;
99  uint32_t GetPacketSize (void) const;
100 private:
101  uint32_t m_flowId;
102  uint32_t m_packetId;
103  uint32_t m_packetSize;
104 
105 };
106 
107 TypeId
109 {
110  static TypeId tid = TypeId ("ns3::Ipv6FlowProbeTag")
111  .SetParent<Tag> ()
112  .SetGroupName ("FlowMonitor")
113  .AddConstructor<Ipv6FlowProbeTag> ()
114  ;
115  return tid;
116 }
117 TypeId
119 {
120  return GetTypeId ();
121 }
122 uint32_t
124 {
125  return 4 + 4 + 4;
126 }
127 void
129 {
130  buf.WriteU32 (m_flowId);
131  buf.WriteU32 (m_packetId);
132  buf.WriteU32 (m_packetSize);
133 }
134 void
136 {
137  m_flowId = buf.ReadU32 ();
138  m_packetId = buf.ReadU32 ();
139  m_packetSize = buf.ReadU32 ();
140 }
141 void
142 Ipv6FlowProbeTag::Print (std::ostream &os) const
143 {
144  os << "FlowId=" << m_flowId;
145  os << "PacketId=" << m_packetId;
146  os << "PacketSize=" << m_packetSize;
147 }
149  : Tag ()
150 {
151 }
152 
153 Ipv6FlowProbeTag::Ipv6FlowProbeTag (uint32_t flowId, uint32_t packetId, uint32_t packetSize)
154  : Tag (), m_flowId (flowId), m_packetId (packetId), m_packetSize (packetSize)
155 {
156 }
157 
158 void
160 {
161  m_flowId = id;
162 }
163 void
165 {
166  m_packetId = id;
167 }
168 void
170 {
171  m_packetSize = size;
172 }
173 uint32_t
175 {
176  return m_flowId;
177 }
178 uint32_t
180 {
181  return m_packetId;
182 }
183 uint32_t
185 {
186  return m_packetSize;
187 }
188 
190 // Ipv6FlowProbe class implementation //
192 
194  Ptr<Ipv6FlowClassifier> classifier,
195  Ptr<Node> node)
196  : FlowProbe (monitor),
197  m_classifier (classifier)
198 {
199  NS_LOG_FUNCTION (this << node->GetId ());
200 
202 
203  if (!ipv6->TraceConnectWithoutContext ("SendOutgoing",
205  {
206  NS_FATAL_ERROR ("trace fail");
207  }
208  if (!ipv6->TraceConnectWithoutContext ("UnicastForward",
210  {
211  NS_FATAL_ERROR ("trace fail");
212  }
213  if (!ipv6->TraceConnectWithoutContext ("LocalDeliver",
215  {
216  NS_FATAL_ERROR ("trace fail");
217  }
218 
219  if (!ipv6->TraceConnectWithoutContext ("Drop",
221  {
222  NS_FATAL_ERROR ("trace fail");
223  }
224 
225  // code copied from point-to-point-helper.cc
226  std::ostringstream oss;
227  oss << "/NodeList/" << node->GetId () << "/DeviceList/*/TxQueue/Drop";
229 }
230 
231 /* static */
232 TypeId
234 {
235  static TypeId tid = TypeId ("ns3::Ipv6FlowProbe")
236  .SetParent<FlowProbe> ()
237  .SetGroupName ("FlowMonitor")
238  // No AddConstructor because this class has no default constructor.
239  ;
240 
241  return tid;
242 }
243 
245 {
246 }
247 
248 void
250 {
252 }
253 
254 void
255 Ipv6FlowProbe::SendOutgoingLogger (const Ipv6Header &ipHeader, Ptr<const Packet> ipPayload, uint32_t interface)
256 {
257  FlowId flowId;
258  FlowPacketId packetId;
259 
260  if (m_classifier->Classify (ipHeader, ipPayload, &flowId, &packetId))
261  {
262  uint32_t size = (ipPayload->GetSize () + ipHeader.GetSerializedSize ());
263  NS_LOG_DEBUG ("ReportFirstTx ("<<this<<", "<<flowId<<", "<<packetId<<", "<<size<<"); "
264  << ipHeader << *ipPayload);
265  m_flowMonitor->ReportFirstTx (this, flowId, packetId, size);
266 
267  // tag the packet with the flow id and packet id, so that the packet can be identified even
268  // when Ipv6Header is not accessible at some non-IPv6 protocol layer
269  Ipv6FlowProbeTag fTag (flowId, packetId, size);
270  ipPayload->AddByteTag (fTag);
271  }
272 }
273 
274 void
275 Ipv6FlowProbe::ForwardLogger (const Ipv6Header &ipHeader, Ptr<const Packet> ipPayload, uint32_t interface)
276 {
277  Ipv6FlowProbeTag fTag;
278  bool found = ipPayload->FindFirstMatchingByteTag (fTag);
279 
280  if (found)
281  {
282  FlowId flowId = fTag.GetFlowId ();
283  FlowPacketId packetId = fTag.GetPacketId ();
284 
285  uint32_t size = (ipPayload->GetSize () + ipHeader.GetSerializedSize ());
286  NS_LOG_DEBUG ("ReportForwarding ("<<this<<", "<<flowId<<", "<<packetId<<", "<<size<<");");
287  m_flowMonitor->ReportForwarding (this, flowId, packetId, size);
288  }
289 }
290 
291 void
292 Ipv6FlowProbe::ForwardUpLogger (const Ipv6Header &ipHeader, Ptr<const Packet> ipPayload, uint32_t interface)
293 {
294  Ipv6FlowProbeTag fTag;
295  bool found = ipPayload->FindFirstMatchingByteTag (fTag);
296 
297  if (found)
298  {
299  FlowId flowId = fTag.GetFlowId ();
300  FlowPacketId packetId = fTag.GetPacketId ();
301 
302  uint32_t size = (ipPayload->GetSize () + ipHeader.GetSerializedSize ());
303  NS_LOG_DEBUG ("ReportLastRx ("<<this<<", "<<flowId<<", "<<packetId<<", "<<size<<");");
304  m_flowMonitor->ReportLastRx (this, flowId, packetId, size);
305  }
306 }
307 
308 void
310  Ipv6L3Protocol::DropReason reason, Ptr<Ipv6> ipv6, uint32_t ifIndex)
311 {
312 #if 0
313  switch (reason)
314  {
316  break;
317 
319  case Ipv6L3Protocol::DROP_BAD_CHECKSUM:
320  Ipv6Address addri = m_ipv6->GetAddress (ifIndex);
321  Ipv6Mask maski = m_ipv6->GetNetworkMask (ifIndex);
322  Ipv6Address bcast = addri.GetSubnetDirectedBroadcast (maski);
323  if (ipHeader.GetDestination () == bcast) // we don't want broadcast packets
324  {
325  return;
326  }
327  }
328 #endif
329 
330  Ipv6FlowProbeTag fTag;
331  bool found = ipPayload->FindFirstMatchingByteTag (fTag);
332 
333  if (found)
334  {
335  FlowId flowId = fTag.GetFlowId ();
336  FlowPacketId packetId = fTag.GetPacketId ();
337 
338  uint32_t size = (ipPayload->GetSize () + ipHeader.GetSerializedSize ());
339  NS_LOG_DEBUG ("Drop ("<<this<<", "<<flowId<<", "<<packetId<<", "<<size<<", " << reason
340  << ", destIp=" << ipHeader.GetDestinationAddress () << "); "
341  << "HDR: " << ipHeader << " PKT: " << *ipPayload);
342 
343  DropReason myReason;
344 
345 
346  switch (reason)
347  {
349  myReason = DROP_TTL_EXPIRE;
350  NS_LOG_DEBUG ("DROP_TTL_EXPIRE");
351  break;
353  myReason = DROP_NO_ROUTE;
354  NS_LOG_DEBUG ("DROP_NO_ROUTE");
355  break;
357  myReason = DROP_INTERFACE_DOWN;
358  NS_LOG_DEBUG ("DROP_INTERFACE_DOWN");
359  break;
361  myReason = DROP_ROUTE_ERROR;
362  NS_LOG_DEBUG ("DROP_ROUTE_ERROR");
363  break;
365  myReason = DROP_UNKNOWN_PROTOCOL;
366  NS_LOG_DEBUG ("DROP_UNKNOWN_PROTOCOL");
367  break;
369  myReason = DROP_UNKNOWN_OPTION;
370  NS_LOG_DEBUG ("DROP_UNKNOWN_OPTION");
371  break;
373  myReason = DROP_MALFORMED_HEADER;
374  NS_LOG_DEBUG ("DROP_MALFORMED_HEADER");
375  break;
377  myReason = DROP_FRAGMENT_TIMEOUT;
378  NS_LOG_DEBUG ("DROP_FRAGMENT_TIMEOUT");
379  break;
380  default:
381  myReason = DROP_INVALID_REASON;
382  NS_FATAL_ERROR ("Unexpected drop reason code " << reason);
383  }
384 
385  m_flowMonitor->ReportDrop (this, flowId, packetId, size, myReason);
386  }
387 }
388 
389 void
391 {
392  Ipv6FlowProbeTag fTag;
393  bool tagFound = ipPayload->FindFirstMatchingByteTag (fTag);
394 
395  if (!tagFound)
396  {
397  return;
398  }
399 
400  FlowId flowId = fTag.GetFlowId ();
401  FlowPacketId packetId = fTag.GetPacketId ();
402  uint32_t size = fTag.GetPacketSize ();
403 
404  NS_LOG_DEBUG ("Drop ("<<this<<", "<<flowId<<", "<<packetId<<", "<<size<<", " << DROP_QUEUE
405  << "); ");
406 
407  m_flowMonitor->ReportDrop (this, flowId, packetId, size, DROP_QUEUE);
408 }
409 
410 } // namespace ns3
411 
412 
uint32_t FlowPacketId
Abstract identifier of a packet within a flow.
virtual uint32_t GetSerializedSize(void) const
virtual uint32_t GetSerializedSize(void) const
Get the serialized size of the packet.
Definition: ipv6-header.cc:143
bool FindFirstMatchingByteTag(Tag &tag) const
Finds the first tag matching the parameter Tag type.
Definition: packet.cc:807
Introspection did not find any typical Config paths.
Definition: ipv6-header.h:33
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:73
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
uint32_t m_packetSize
packet size
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:455
Interface is down so can not send packet.
IPv6 layer implementation.
void SendOutgoingLogger(const Ipv6Header &ipHeader, Ptr< const Packet > ipPayload, uint32_t interface)
Log a packet being sent.
uint32_t m_flowId
flow identifier
void DropLogger(const Ipv6Header &ipHeader, Ptr< const Packet > ipPayload, Ipv6L3Protocol::DropReason reason, Ptr< Ipv6 > ipv6, uint32_t ifIndex)
Log a packet being dropped.
Interface is down so can not send packet.
Tag used to allow a fast identification of the packet.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:201
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:786
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
Definition: fatal-error.h:145
uint32_t m_packetId
packet identifier
TAG_BUFFER_INLINE uint32_t ReadU32(void)
Definition: tag-buffer.h:215
void SetPacketId(uint32_t packetId)
Set the packet identifier.
static TypeId GetTypeId(void)
Get the type ID.
Ptr< FlowMonitor > m_flowMonitor
the FlowMonitor instance
Definition: flow-probe.h:106
void SetPacketSize(uint32_t packetSize)
Set the packet size.
virtual void Serialize(TagBuffer buf) const
uint32_t GetPacketSize(void) const
Get the packet size.
TAG_BUFFER_INLINE void WriteU32(uint32_t v)
Definition: tag-buffer.h:186
void ForwardUpLogger(const Ipv6Header &ipHeader, Ptr< const Packet > ipPayload, uint32_t interface)
Log a packet being received by the destination.
Callback< R > MakeCallback(R(T::*memPtr)(void), OBJ objPtr)
Definition: callback.h:1480
void ConnectWithoutContext(std::string path, const CallbackBase &cb)
Definition: config.cc:824
virtual TypeId GetInstanceTypeId(void) const
Get the most derived TypeId for this Object.
tag a set of bytes in a packet
Definition: tag.h:36
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Packet dropped due to missing route to the destination.
DropReason
enumeration of possible reasons why a packet may be dropped
virtual void DoDispose(void)
Destructor implementation.
The FlowProbe class is responsible for listening for packet events in a specific point of the simulat...
Definition: flow-probe.h:39
Describes an IPv6 address.
Definition: ipv6-address.h:48
read and write tag data
Definition: tag-buffer.h:51
Fallback reason (no known reason)
uint32_t GetId(void) const
Definition: node.cc:107
void SetFlowId(uint32_t flowId)
Set the flow identifier.
Packet dropped due to TTL decremented to zero during IPv4 forwarding.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
Definition: log.h:236
uint32_t GetFlowId(void) const
Set the flow identifier.
virtual void Print(std::ostream &os) const
Ipv6FlowProbe(Ptr< FlowMonitor > monitor, Ptr< Ipv6FlowClassifier > classifier, Ptr< Node > node)
Constructor.
static const uint32_t packetSize
uint32_t GetPacketId(void) const
Set the packet identifier.
void ForwardLogger(const Ipv6Header &ipHeader, Ptr< const Packet > ipPayload, uint32_t interface)
Log a packet being forwarded.
Packet dropped due to queue overflow.
static TypeId GetTypeId(void)
Register this type.
Ptr< Ipv6FlowClassifier > m_classifier
the Ipv6FlowClassifier this probe is associated with
a unique identifier for an interface.
Definition: type-id.h:58
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:826
virtual void DoDispose(void)
Destructor implementation.
Definition: flow-probe.cc:50
Ipv6Address GetDestinationAddress(void) const
Get the "Destination address" field.
Definition: ipv6-header.cc:110
void QueueDropLogger(Ptr< const Packet > ipPayload)
Log a packet being dropped by a queue.
DropReason
Reason why a packet has been dropped.
virtual void Deserialize(TagBuffer buf)
void AddByteTag(const Tag &tag) const
Tag each byte included in this packet with a new byte tag.
Definition: packet.cc:791
uint32_t FlowId
Abstract identifier of a packet flow.