This documentation is not the Latest Release.
A Discrete-Event Network Simulator
API
tcp-header.h
Go to the documentation of this file.
1 /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2 /*
3  * Copyright (c) 2007 Georgia Tech Research Corporation
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: Raj Bhattacharjea <raj.b@gatech.edu>
19  */
20 
21 #ifndef TCP_HEADER_H
22 #define TCP_HEADER_H
23 
24 #include <stdint.h>
25 #include "ns3/header.h"
26 #include "ns3/tcp-option.h"
27 #include "ns3/buffer.h"
28 #include "ns3/tcp-socket-factory.h"
29 #include "ns3/ipv4-address.h"
30 #include "ns3/ipv6-address.h"
31 #include "ns3/sequence-number.h"
32 
33 namespace ns3 {
34 
44 class TcpHeader : public Header
45 {
46 public:
47  TcpHeader ();
48  virtual ~TcpHeader ();
49 
57  friend std::ostream& operator<<(std::ostream& os, TcpHeader const & tc);
58 
74  static std::string FlagsToString (uint8_t flags, const std::string& delimiter = "|");
75 
81  void EnableChecksums (void);
82 
83 //Setters
84 
89  void SetSourcePort (uint16_t port);
90 
95  void SetDestinationPort (uint16_t port);
96 
101  void SetSequenceNumber (SequenceNumber32 sequenceNumber);
102 
107  void SetAckNumber (SequenceNumber32 ackNumber);
108 
113  void SetFlags (uint8_t flags);
114 
119  void SetWindowSize (uint16_t windowSize);
120 
125  void SetUrgentPointer (uint16_t urgentPointer);
126 
127 //Getters
128 
133  uint16_t GetSourcePort () const;
134 
139  uint16_t GetDestinationPort () const;
140 
146 
152 
161  uint8_t GetLength () const;
162 
167  uint8_t GetFlags () const;
168 
173  uint16_t GetWindowSize () const;
174 
179  uint16_t GetUrgentPointer () const;
180 
186  Ptr<TcpOption> GetOption (uint8_t kind) const;
187 
193  bool HasOption (uint8_t kind) const;
194 
200  bool AppendOption (Ptr<TcpOption> option);
201 
216  void InitializeChecksum (const Ipv4Address &source,
217  const Ipv4Address &destination,
218  uint8_t protocol);
219 
234  void InitializeChecksum (const Ipv6Address &source,
235  const Ipv6Address &destination,
236  uint8_t protocol);
237 
252  void InitializeChecksum (const Address &source,
253  const Address &destination,
254  uint8_t protocol);
255 
259  typedef enum
260  {
261  NONE = 0,
262  FIN = 1,
263  SYN = 2,
264  RST = 4,
265  PSH = 8,
266  ACK = 16,
267  URG = 32,
268  ECE = 64,
269  CWR = 128
270  } Flags_t;
271 
276  static TypeId GetTypeId (void);
277  virtual TypeId GetInstanceTypeId (void) const;
278  virtual void Print (std::ostream &os) const;
279  virtual uint32_t GetSerializedSize (void) const;
280  virtual void Serialize (Buffer::Iterator start) const;
281  virtual uint32_t Deserialize (Buffer::Iterator start);
282 
287  bool IsChecksumOk (void) const;
288 
295  friend bool operator== (const TcpHeader &lhs, const TcpHeader &rhs);
296 
297 private:
303  uint16_t CalculateHeaderChecksum (uint16_t size) const;
304 
313  uint8_t CalculateHeaderLength () const;
314 
315  uint16_t m_sourcePort;
316  uint16_t m_destinationPort;
319  uint8_t m_length;
320  uint8_t m_flags;
321  uint16_t m_windowSize;
322  uint16_t m_urgentPointer;
323 
326  uint8_t m_protocol;
327 
330 
331 
332  typedef std::list< Ptr<TcpOption> > TcpOptionList;
333  TcpOptionList m_options;
334  uint8_t m_optionsLen;
335  static const uint8_t m_maxOptionsLen = 40;
336 };
337 
338 } // namespace ns3
339 
340 #endif /* TCP_HEADER */
Protocol header serialization and deserialization.
Definition: header.h:42
static std::string FlagsToString(uint8_t flags, const std::string &delimiter="|")
Converts an integer into a human readable list of Tcp flags.
Definition: tcp-header.cc:55
uint16_t GetDestinationPort() const
Get the destination port.
Definition: tcp-header.cc:137
SequenceNumber32 GetSequenceNumber() const
Get the sequence number.
Definition: tcp-header.cc:143
uint8_t GetFlags() const
Get the flags.
Definition: tcp-header.cc:161
void InitializeChecksum(const Ipv4Address &source, const Ipv4Address &destination, uint8_t protocol)
Initialize the TCP checksum.
Definition: tcp-header.cc:179
SequenceNumber32 GetAckNumber() const
Get the ACK number.
Definition: tcp-header.cc:149
static const uint8_t m_maxOptionsLen
Maximum options length.
Definition: tcp-header.h:335
def start()
Definition: core.py:1482
Address m_source
Source IP address.
Definition: tcp-header.h:324
uint16_t m_destinationPort
Destination port.
Definition: tcp-header.h:316
uint8_t CalculateHeaderLength() const
Calculates the header length (in words)
Definition: tcp-header.cc:430
bool m_calcChecksum
Flag to calculate checksum.
Definition: tcp-header.h:328
uint16_t port
Definition: dsdv-manet.cc:44
iterator in a Buffer instance
Definition: buffer.h:98
a polymophic address class
Definition: address.h:90
virtual void Print(std::ostream &os) const
Definition: tcp-header.cc:275
bool AppendOption(Ptr< TcpOption > option)
Append an option to the TCP header.
Definition: tcp-header.cc:448
void SetSequenceNumber(SequenceNumber32 sequenceNumber)
Set the sequence Number.
Definition: tcp-header.cc:101
uint16_t GetWindowSize() const
Get the window size.
Definition: tcp-header.cc:167
std::list< Ptr< TcpOption > > TcpOptionList
List of TcpOption.
Definition: tcp-header.h:332
Flags_t
TCP flag field values.
Definition: tcp-header.h:259
virtual TypeId GetInstanceTypeId(void) const
Get the most derived TypeId for this Object.
Definition: tcp-header.cc:269
uint16_t CalculateHeaderChecksum(uint16_t size) const
Calculate the header checksum.
Definition: tcp-header.cc:209
bool m_goodChecksum
Flag to indicate that checksum is correct.
Definition: tcp-header.h:329
void SetDestinationPort(uint16_t port)
Set the destination port.
Definition: tcp-header.cc:95
void SetFlags(uint8_t flags)
Set flags of the header.
Definition: tcp-header.cc:113
uint16_t m_windowSize
Window size.
Definition: tcp-header.h:321
Every class exported by the ns3 library is enclosed in the ns3 namespace.
uint16_t m_sourcePort
Source port.
Definition: tcp-header.h:315
uint8_t m_optionsLen
Tcp options length.
Definition: tcp-header.h:334
Header for the Transmission Control Protocol.
Definition: tcp-header.h:44
void SetSourcePort(uint16_t port)
Set the source port.
Definition: tcp-header.cc:89
virtual ~TcpHeader()
Definition: tcp-header.cc:50
Address m_destination
Destination IP address.
Definition: tcp-header.h:325
void SetUrgentPointer(uint16_t urgentPointer)
Set the urgent pointer.
Definition: tcp-header.cc:125
virtual uint32_t GetSerializedSize(void) const
Definition: tcp-header.cc:297
uint8_t GetLength() const
Get the length in words.
Definition: tcp-header.cc:155
uint8_t m_protocol
Protocol number.
Definition: tcp-header.h:326
Ptr< TcpOption > GetOption(uint8_t kind) const
Get the option specified.
Definition: tcp-header.cc:474
virtual uint32_t Deserialize(Buffer::Iterator start)
Definition: tcp-header.cc:348
uint16_t m_urgentPointer
Urgent pointer.
Definition: tcp-header.h:322
Describes an IPv6 address.
Definition: ipv6-address.h:47
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:40
SequenceNumber32 m_ackNumber
ACK number.
Definition: tcp-header.h:318
uint8_t m_flags
Flags (really a uint6_t)
Definition: tcp-header.h:320
uint8_t m_length
Length (really a uint4_t) in words.
Definition: tcp-header.h:319
friend bool operator==(const TcpHeader &lhs, const TcpHeader &rhs)
Comparison operator.
Definition: tcp-header.cc:506
void SetAckNumber(SequenceNumber32 ackNumber)
Set the ACK number.
Definition: tcp-header.cc:107
uint16_t GetSourcePort() const
Get the source port.
Definition: tcp-header.cc:131
bool IsChecksumOk(void) const
Is the TCP checksum correct ?
Definition: tcp-header.cc:252
void EnableChecksums(void)
Enable checksum calculation for TCP.
Definition: tcp-header.cc:83
TcpOptionList m_options
TcpOption present in the header.
Definition: tcp-header.h:333
bool HasOption(uint8_t kind) const
Check if the header has the option specified.
Definition: tcp-header.cc:490
void SetWindowSize(uint16_t windowSize)
Set the window size.
Definition: tcp-header.cc:119
a unique identifier for an interface.
Definition: type-id.h:58
friend std::ostream & operator<<(std::ostream &os, TcpHeader const &tc)
Print a TCP header into an output stream.
Definition: tcp-header.cc:520
uint16_t GetUrgentPointer() const
Get the urgent pointer.
Definition: tcp-header.cc:173
virtual void Serialize(Buffer::Iterator start) const
Definition: tcp-header.cc:303
static TypeId GetTypeId(void)
Get the type ID.
Definition: tcp-header.cc:258
SequenceNumber32 m_sequenceNumber
Sequence number.
Definition: tcp-header.h:317