A Discrete-Event Network Simulator
API
ping6.cc
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2007-2009 Strasbourg University
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: Sebastien Vincent <vincent@clarinet.u-strasbg.fr>
19  */
20 
21 #include "ping6.h"
22 #include "ns3/log.h"
23 #include "ns3/nstime.h"
24 #include "ns3/simulator.h"
25 #include "ns3/socket-factory.h"
26 #include "ns3/packet.h"
27 #include "ns3/socket.h"
28 #include "ns3/uinteger.h"
29 #include "ns3/inet6-socket-address.h"
30 #include "ns3/icmpv6-header.h"
31 #include "ns3/ipv6-raw-socket-factory.h"
32 #include "ns3/ipv6-header.h"
33 #include "ns3/ipv6-extension-header.h"
34 
35 
36 namespace ns3
37 {
38 
39 NS_LOG_COMPONENT_DEFINE ("Ping6Application");
40 
42 
44 {
45  static TypeId tid = TypeId ("ns3::Ping6")
47  .SetGroupName("Internet-Apps")
48  .AddConstructor<Ping6>()
49  .AddAttribute ("MaxPackets",
50  "The maximum number of packets the application will send",
51  UintegerValue (100),
53  MakeUintegerChecker<uint32_t>())
54  .AddAttribute ("Interval",
55  "The time to wait between packets",
56  TimeValue (Seconds (1.0)),
58  MakeTimeChecker ())
59  .AddAttribute ("RemoteIpv6",
60  "The Ipv6Address of the outbound packets",
64  .AddAttribute ("LocalIpv6",
65  "Local Ipv6Address of the sender",
69  .AddAttribute ("PacketSize",
70  "Size of packets generated",
71  UintegerValue (100),
73  MakeUintegerChecker<uint32_t>())
74  ;
75  return tid;
76 }
77 
79 {
80  NS_LOG_FUNCTION (this);
81  m_sent = 0;
82  m_socket = 0;
83  m_seq = 0;
85  m_ifIndex = 0;
86  m_sendEvent = EventId ();
87 }
88 
90 {
91  NS_LOG_FUNCTION (this);
92  m_socket = 0;
93 }
94 
96 {
97  NS_LOG_FUNCTION (this);
99 }
100 
102 {
103  NS_LOG_FUNCTION (this);
104 
105  if (!m_socket)
106  {
107  TypeId tid = TypeId::LookupByName ("ns3::Ipv6RawSocketFactory");
109 
111 
116 
117  if (!m_localAddress.IsAny ())
118  {
119  m_ipInterfaceIndex = m_ipv6Protocol->GetInterfaceForAddress (m_localAddress);
120  }
121  }
122 
123  ScheduleTransmit (Seconds (0.));
124 }
125 
127 {
128  NS_LOG_FUNCTION (this << ipv6);
129  m_localAddress = ipv6;
130 }
131 
133 {
134  NS_LOG_FUNCTION (this << ipv6);
135  m_peerAddress = ipv6;
136 }
137 
139 {
140  NS_LOG_FUNCTION (this);
141 
142  if (m_socket)
143  {
145  }
146 
148 }
149 
150 void Ping6::SetIfIndex (uint32_t ifIndex)
151 {
152  m_ifIndex = ifIndex;
153 }
154 
156 {
157  NS_LOG_FUNCTION (this << dt);
159 }
160 
161 void Ping6::SetRouters (std::vector<Ipv6Address> routers)
162 {
163  m_routers = routers;
164 }
165 
166 void Ping6::Send ()
167 {
168  NS_LOG_FUNCTION (this);
170 
171  Ipv6Address src;
172  Ptr<Ipv6> ipv6 = GetNode ()->GetObject<Ipv6> ();
173 
174  if (m_ifIndex > 0)
175  {
176  /* hack to have ifIndex in Ipv6RawSocketImpl
177  * maybe add a SetIfIndex in Ipv6RawSocketImpl directly
178  */
179  for (uint32_t i = 0; i < GetNode ()->GetObject<Ipv6> ()->GetNAddresses (m_ifIndex); i++)
180  {
181  Ipv6InterfaceAddress srcIa;
182  srcIa = GetNode ()->GetObject<Ipv6> ()->GetAddress (m_ifIndex, i);
183 
184  if (srcIa.IsInSameSubnet (m_peerAddress))
185  {
186  src = srcIa.GetAddress ();
187  break;
188  }
189  }
190  }
191  else
192  {
193  src = m_localAddress;
194  }
195 
196  uint32_t size = m_size;
197  if (m_size<4)
198  {
199  NS_LOG_WARN ("ICMPv6 echo request payload size must be >= 4");
200  size = 4;
201  }
202 
203  uint8_t* data = new uint8_t[size];
204  memset(data, 0, size);
205  data[0] = 0xDE;
206  data[1] = 0xAD;
207  data[2] = 0xBE;
208  data[3] = 0xEF;
209 
210  Ptr<Packet> p = Create<Packet> (data, size);
211  Icmpv6Echo req (1);
212 
213  req.SetId (0xBEEF);
214  req.SetSeq (m_seq);
215  m_seq++;
216 
217  /* we do not calculate pseudo header checksum here, because we are not sure about
218  * source IPv6 address. Checksum is calculated in Ipv6RawSocketImpl.
219  */
220 
221  p->AddHeader (req);
222  m_socket->Bind (Inet6SocketAddress (src, 0));
223 
224  /* use Loose Routing (routing type 0) */
225  if (m_routers.size ())
226  {
227  Ipv6ExtensionLooseRoutingHeader routingHeader;
228  routingHeader.SetNextHeader (Ipv6Header::IPV6_ICMPV6);
229  routingHeader.SetTypeRouting (0);
230  routingHeader.SetSegmentsLeft (m_routers.size ());
231  routingHeader.SetRoutersAddress (m_routers);
232  p->AddHeader (routingHeader);
234  }
235 
237  ++m_sent;
238 
239  NS_LOG_INFO ("Sent " << p->GetSize () << " bytes to " << m_peerAddress);
240 
241  if (m_sent < m_count)
242  {
244  }
245 
246  delete[] data;
247 }
248 
250 {
251  NS_LOG_FUNCTION (this << socket);
252 
253  Ptr<Packet> packet=0;
254  Address from;
255  while ((packet = socket->RecvFrom (from)))
256  {
258  {
259  Ipv6Header hdr;
260  Icmpv6Echo reply (0);
261  Icmpv6DestinationUnreachable destUnreach;
262  Icmpv6TimeExceeded timeExceeded;
264 
265  packet->RemoveHeader (hdr);
266 
267  uint8_t type;
268  packet->CopyData (&type, sizeof(type));
269 
270  switch (type)
271  {
273  packet->RemoveHeader (reply);
274 
275  NS_LOG_INFO ("Received Echo Reply size = " << std::dec << packet->GetSize () <<
276  " bytes from " << address.GetIpv6 () <<
277  " id = " << (uint16_t)reply.GetId () <<
278  " seq = " << (uint16_t)reply.GetSeq () <<
279  " Hop Count = " << (uint16_t) (64 - hdr.GetHopLimit ()));
280 
281  if (m_ifIndex)
282  {
283  m_ipv6Protocol->ReachabilityHint (m_ifIndex, address.GetIpv6 ());
284  }
285  else
286  {
287  m_ipv6Protocol->ReachabilityHint (m_ipInterfaceIndex, address.GetIpv6 ());
288  }
289 
290  break;
292  packet->RemoveHeader (destUnreach);
293 
294  NS_LOG_INFO ("Received Destination Unreachable from " << address.GetIpv6 ());
295  break;
297  packet->RemoveHeader (timeExceeded);
298 
299  NS_LOG_INFO ("Received Time Exceeded from " << address.GetIpv6 ());
300  break;
301  default:
302  break;
303  }
304  }
305  }
306 }
307 
308 } /* namespace ns3 */
309 
uint16_t GetSeq() const
Get the sequence number.
uint32_t RemoveHeader(Header &header)
Deserialize and remove the header from the internal buffer.
Definition: packet.cc:280
static EventId Schedule(Time const &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
Definition: simulator.h:557
virtual ~Ping6()
Destructor.
Definition: ping6.cc:89
Ipv6Address GetAddress() const
Get the IPv6 address.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:103
Packet header for IPv6.
Definition: ipv6-header.h:34
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by "...
virtual void StopApplication()
Stop the application.
Definition: ping6.cc:138
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
Definition: object-base.h:45
uint32_t GetSize(void) const
Returns the the size in bytes of the packet (including the zero-filled initial payload).
Definition: packet.h:852
Access to the IPv6 forwarding table, interfaces, and configuration.
Definition: ipv6.h:81
void SetTypeRouting(uint8_t typeRouting)
Set the "Type of Routing" field.
bool IsInSameSubnet(Ipv6Address b) const
Checks if the address is in the same subnet.
ICMPv6 Error Time Exceeded header.
IPv6 layer implementation.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file...
Definition: assert.h:67
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
Definition: log.h:205
IPv6 address associated with an interface.
void SetRouters(std::vector< Ipv6Address > routers)
Set routers for routing type 0 (loose routing).
Definition: ping6.cc:161
#define NS_LOG_INFO(msg)
Use NS_LOG to output a message of level LOG_INFO.
Definition: log.h:281
static void Cancel(const EventId &id)
Set the cancel bit on this event: the event&#39;s associated function will not be invoked when it expires...
Definition: simulator.cc:268
Time m_interval
Interval between packets sent.
Definition: ping6.h:145
void Send()
Send a packet.
Definition: ping6.cc:166
Callback< R, Ts... > MakeNullCallback(void)
Definition: callback.h:1682
bool IsExpired(void) const
This method is syntactic sugar for the ns3::Simulator::IsExpired method.
Definition: event-id.cc:65
a polymophic address class
Definition: address.h:90
void SetIfIndex(uint32_t ifIndex)
Set the out interface index.
Definition: ping6.cc:150
ICMPv6 Error Destination Unreachable header.
Header of IPv6 Extension Routing : Type 0 (Loose Routing)
The base class for all ns3 applications.
Definition: application.h:60
AttributeValue implementation for Time.
Definition: nstime.h:1353
Ptr< const AttributeChecker > MakeIpv6AddressChecker(void)
Hold an unsigned integer type.
Definition: uinteger.h:44
uint8_t data[writeSize]
Ptr< Ipv6L3Protocol > m_ipv6Protocol
IP interface index relative to the local address.
Definition: ping6.h:160
uint32_t m_sent
Number of packets sent.
Definition: ping6.h:135
An Inet6 address class.
virtual void StartApplication()
Start the application.
Definition: ping6.cc:101
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
std::vector< Ipv6Address > m_routers
Routers addresses for routing type 0.
Definition: ping6.h:190
A ping6 application.
Definition: ping6.h:43
void SetLocal(Ipv6Address ipv6)
Set the local address.
Definition: ping6.cc:126
Ptr< Node > GetNode() const
Definition: application.cc:104
uint32_t m_size
Size of the packet.
Definition: ping6.h:140
Ptr< T > GetObject(void) const
Get a pointer to the requested aggregated Object.
Definition: object.h:470
virtual void DoDispose(void)
Destructor implementation.
Definition: application.cc:83
Ptr< Node > m_node
The node that this application is installed on.
Definition: application.h:148
virtual int Bind(const Address &address)=0
Allocate a local endpoint for this socket.
void SetNextHeader(uint8_t nextHeader)
Set the "Next header" field.
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.
Ptr< Socket > m_socket
Local socket.
Definition: ping6.h:170
address
Definition: first.py:44
Ping6()
Constructor.
Definition: ping6.cc:78
AttributeValue implementation for Ipv6Address.
Definition: ipv6-address.h:637
Ptr< const AttributeAccessor > MakeTimeAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: nstime.h:1354
uint32_t m_ipInterfaceIndex
IP interface index relative to the local address.
Definition: ping6.h:155
ICMPv6 Echo message.
Describes an IPv6 address.
Definition: ipv6-address.h:49
void SetRoutersAddress(std::vector< Ipv6Address > routersAddress)
Set the vector of routers&#39; address.
void SetRemote(Ipv6Address ipv6)
Set the remote peer.
Definition: ping6.cc:132
An identifier for simulation events.
Definition: event-id.h:53
uint16_t m_seq
Sequence number.
Definition: ping6.h:175
Ptr< const AttributeAccessor > MakeIpv6AddressAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: ipv6-address.h:637
#define NS_LOG_WARN(msg)
Use NS_LOG to output a message of level LOG_WARN.
Definition: log.h:265
uint32_t CopyData(uint8_t *buffer, uint32_t size) const
Copy the packet contents to a byte buffer.
Definition: packet.cc:378
uint32_t m_ifIndex
Out interface (i.e.
Definition: ping6.h:185
Time Seconds(double value)
Construct a Time in the indicated unit.
Definition: nstime.h:1289
static Inet6SocketAddress ConvertFrom(const Address &addr)
Convert the address to a InetSocketAddress.
Ipv6Address m_localAddress
Local address.
Definition: ping6.h:150
static bool IsMatchingType(const Address &addr)
If the address match.
void ScheduleTransmit(Time dt)
Schedule sending a packet.
Definition: ping6.cc:155
Ptr< const AttributeChecker > MakeTimeChecker(const Time min, const Time max)
Helper to make a Time checker with bounded range.
Definition: time.cc:533
virtual int SendTo(Ptr< Packet > p, uint32_t flags, const Address &toAddress)=0
Send data to a specified peer.
virtual void DoDispose()
Dispose this object;.
Definition: ping6.cc:95
virtual Ptr< Packet > RecvFrom(uint32_t maxSize, uint32_t flags, Address &fromAddress)=0
Read a single packet from the socket and retrieve the sender address.
EventId m_sendEvent
Event ID.
Definition: ping6.h:180
uint8_t GetHopLimit(void) const
Get the "Hop limit" field (TTL).
Definition: ipv6-header.cc:90
static TypeId GetTypeId()
Get the type ID.
Definition: ping6.cc:43
void SetAttribute(std::string name, const AttributeValue &value)
Set a single attribute, raising fatal errors if unsuccessful.
Definition: object-base.cc:185
Ptr< const AttributeAccessor > MakeUintegerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method...
Definition: uinteger.h:45
a unique identifier for an interface.
Definition: type-id.h:58
TypeId SetParent(TypeId tid)
Set the parent TypeId.
Definition: type-id.cc:923
Ipv6Address m_peerAddress
Peer address.
Definition: ping6.h:165
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
void AddHeader(const Header &header)
Add header to this packet.
Definition: packet.cc:256
bool IsAny() const
If the IPv6 address is the "Any" address.
void HandleRead(Ptr< Socket > socket)
Receive method.
Definition: ping6.cc:249
static TypeId LookupByName(std::string name)
Get a TypeId by name.
Definition: type-id.cc:830
uint32_t m_count
Number of "Echo request" packets that will be sent.
Definition: ping6.h:130
uint16_t GetId() const
Get the ID of the packet.
void SetSegmentsLeft(uint8_t segmentsLeft)
Set the "Segments left" field.