A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ipv4-header.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2005 INRIA
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: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
19  */
20 
21 #ifndef IPV4_HEADER_H
22 #define IPV4_HEADER_H
23 
24 #include "ns3/header.h"
25 #include "ns3/ipv4-address.h"
26 
27 namespace ns3 {
31 class Ipv4Header : public Header
32 {
33 public:
37  Ipv4Header ();
41  void EnableChecksum (void);
45  void SetPayloadSize (uint16_t size);
51  void SetIdentification (uint16_t identification);
55  void SetTos (uint8_t tos);
64  enum DscpType
65  {
66  DscpDefault = 0x00,
67 
68  // Prefixed with "DSCP" to avoid name clash (bug 1723)
69  DSCP_CS1 = 0x20,
70  DSCP_AF11 = 0x28,
71  DSCP_AF12 = 0x30,
72  DSCP_AF13 = 0x38,
73 
74  DSCP_CS2 = 0x40,
75  DSCP_AF21 = 0x48,
76  DSCP_AF22 = 0x50,
77  DSCP_AF23 = 0x58,
78 
79  DSCP_CS3 = 0x60,
80  DSCP_AF31 = 0x68,
81  DSCP_AF32 = 0x70,
82  DSCP_AF33 = 0x78,
83 
84  DSCP_CS4 = 0x80,
85  DSCP_AF41 = 0x88,
86  DSCP_AF42 = 0x90,
87  DSCP_AF43 = 0x98,
88 
89  DSCP_CS5 = 0xA0,
90  DSCP_EF = 0xB8,
91 
92  DSCP_CS6 = 0xC0,
93  DSCP_CS7 = 0xE0
94 
95  };
100  void SetDscp (DscpType dscp);
101 
106  enum EcnType
107  {
108  // Prefixed with "ECN" to avoid name clash (bug 1723)
109  ECN_NotECT = 0x00,
110  ECN_ECT1 = 0x01,
111  ECN_ECT0 = 0x02,
112  ECN_CE = 0x03
113  };
118  void SetEcn (EcnType ecn);
122  void SetMoreFragments (void);
126  void SetLastFragment (void);
130  void SetDontFragment (void);
134  void SetMayFragment (void);
141  void SetFragmentOffset (uint16_t offsetBytes);
145  void SetTtl (uint8_t ttl);
149  void SetProtocol (uint8_t num);
153  void SetSource (Ipv4Address source);
157  void SetDestination (Ipv4Address destination);
161  uint16_t GetPayloadSize (void) const;
165  uint16_t GetIdentification (void) const;
169  uint8_t GetTos (void) const;
173  DscpType GetDscp (void) const;
178  std::string DscpTypeToString (DscpType dscp) const;
182  EcnType GetEcn (void) const;
187  std::string EcnTypeToString (EcnType ecn) const;
191  bool IsLastFragment (void) const;
195  bool IsDontFragment (void) const;
199  uint16_t GetFragmentOffset (void) const;
203  uint8_t GetTtl (void) const;
207  uint8_t GetProtocol (void) const;
211  Ipv4Address GetSource (void) const;
215  Ipv4Address GetDestination (void) const;
216 
223  bool IsChecksumOk (void) const;
224 
229  static TypeId GetTypeId (void);
230  virtual TypeId GetInstanceTypeId (void) const;
231  virtual void Print (std::ostream &os) const;
232  virtual uint32_t GetSerializedSize (void) const;
233  virtual void Serialize (Buffer::Iterator start) const;
234  virtual uint32_t Deserialize (Buffer::Iterator start);
235 private:
236 
238  enum FlagsE {
239  DONT_FRAGMENT = (1<<0),
240  MORE_FRAGMENTS = (1<<1)
241  };
242 
244 
245  uint16_t m_payloadSize;
246  uint16_t m_identification;
247  uint32_t m_tos : 8;
248  uint32_t m_ttl : 8;
249  uint32_t m_protocol : 8;
250  uint32_t m_flags : 3;
251  uint16_t m_fragmentOffset;
254  uint16_t m_checksum;
256  uint16_t m_headerSize;
257 };
258 
259 } // namespace ns3
260 
261 
262 #endif /* IPV4_HEADER_H */
Protocol header serialization and deserialization.
Definition: header.h:42
void SetSource(Ipv4Address source)
Definition: ipv4-header.cc:285
void SetPayloadSize(uint16_t size)
Definition: ipv4-header.cc:57
uint16_t GetPayloadSize(void) const
Definition: ipv4-header.cc:63
uint32_t m_ttl
TTL.
Definition: ipv4-header.h:248
void SetDestination(Ipv4Address destination)
Definition: ipv4-header.cc:298
uint32_t m_flags
flags
Definition: ipv4-header.h:250
uint16_t m_identification
identification
Definition: ipv4-header.h:246
DscpType
DiffServ Code Points Code Points defined in Assured Forwarding (AF) RFC 2597 Expedited Forwarding (EF...
Definition: ipv4-header.h:64
Ipv4Address m_destination
destination address
Definition: ipv4-header.h:253
Ipv4Address GetDestination(void) const
Definition: ipv4-header.cc:304
uint8_t GetProtocol(void) const
Definition: ipv4-header.cc:272
uint16_t GetIdentification(void) const
Definition: ipv4-header.cc:70
uint16_t m_headerSize
IP header size.
Definition: ipv4-header.h:256
bool IsDontFragment(void) const
Definition: ipv4-header.cc:232
void SetFragmentOffset(uint16_t offsetBytes)
The offset is measured in bytes for the packet start.
Definition: ipv4-header.cc:239
Ipv4Address GetSource(void) const
Definition: ipv4-header.cc:291
void SetProtocol(uint8_t num)
Definition: ipv4-header.cc:278
uint32_t m_tos
TOS, also used as DSCP + ECN value.
Definition: ipv4-header.h:247
std::string DscpTypeToString(DscpType dscp) const
Definition: ipv4-header.cc:114
void SetDontFragment(void)
Don't fragment this packet: if you need to anyway, drop it.
Definition: ipv4-header.cc:220
iterator in a Buffer instance
Definition: buffer.h:98
static TypeId GetTypeId(void)
Get the type ID.
Definition: ipv4-header.cc:319
Packet header for IPv4.
Definition: ipv4-header.h:31
void SetLastFragment(void)
This packet is the last packet of a fragmented ipv4 packet.
Definition: ipv4-header.cc:207
bool m_goodChecksum
true if checksum is correct
Definition: ipv4-header.h:255
DscpType GetDscp(void) const
Definition: ipv4-header.cc:106
Ipv4Header()
Construct a null IPv4 header.
Definition: ipv4-header.cc:34
void EnableChecksum(void)
Enable checksum calculation for this header.
Definition: ipv4-header.cc:50
void SetDscp(DscpType dscp)
Set DSCP Field.
Definition: ipv4-header.cc:90
void SetIdentification(uint16_t identification)
Definition: ipv4-header.cc:76
void SetMayFragment(void)
If you need to fragment this packet, you can do it.
Definition: ipv4-header.cc:226
uint16_t m_fragmentOffset
Fragment offset.
Definition: ipv4-header.h:251
uint16_t m_checksum
checksum
Definition: ipv4-header.h:254
void SetMoreFragments(void)
This packet is not the last packet of a fragmented ipv4 packet.
Definition: ipv4-header.cc:201
bool IsLastFragment(void) const
Definition: ipv4-header.cc:213
void SetTos(uint8_t tos)
Definition: ipv4-header.cc:83
virtual void Print(std::ostream &os) const
Definition: ipv4-header.cc:334
Ipv4Address m_source
source address
Definition: ipv4-header.h:252
virtual TypeId GetInstanceTypeId(void) const
Definition: ipv4-header.cc:328
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:38
FlagsE
flags related to IP fragmentation
Definition: ipv4-header.h:238
uint16_t GetFragmentOffset(void) const
Definition: ipv4-header.cc:247
uint32_t m_protocol
Protocol.
Definition: ipv4-header.h:249
void SetEcn(EcnType ecn)
Set ECN Field.
Definition: ipv4-header.cc:98
void SetTtl(uint8_t ttl)
Definition: ipv4-header.cc:259
virtual void Serialize(Buffer::Iterator start) const
Definition: ipv4-header.cc:382
bool IsChecksumOk(void) const
Definition: ipv4-header.cc:312
bool m_calcChecksum
true if the checksum must be calculated
Definition: ipv4-header.h:243
uint8_t GetTtl(void) const
Definition: ipv4-header.cc:265
uint8_t GetTos(void) const
Definition: ipv4-header.cc:195
uint16_t m_payloadSize
payload size
Definition: ipv4-header.h:245
std::string EcnTypeToString(EcnType ecn) const
Definition: ipv4-header.cc:176
virtual uint32_t GetSerializedSize(void) const
Definition: ipv4-header.cc:374
a unique identifier for an interface.
Definition: type-id.h:49
EcnType GetEcn(void) const
Definition: ipv4-header.cc:168
EcnType
ECN Type defined in RFC 3168
Definition: ipv4-header.h:106
virtual uint32_t Deserialize(Buffer::Iterator start)
Definition: ipv4-header.cc:422