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 
192  uint8_t GetOptionLength () const;
193 
198  uint8_t GetMaxOptionLength () const;
199 
205  bool HasOption (uint8_t kind) const;
206 
212  bool AppendOption (Ptr<TcpOption> option);
213 
228  void InitializeChecksum (const Ipv4Address &source,
229  const Ipv4Address &destination,
230  uint8_t protocol);
231 
246  void InitializeChecksum (const Ipv6Address &source,
247  const Ipv6Address &destination,
248  uint8_t protocol);
249 
264  void InitializeChecksum (const Address &source,
265  const Address &destination,
266  uint8_t protocol);
267 
271  typedef enum
272  {
273  NONE = 0,
274  FIN = 1,
275  SYN = 2,
276  RST = 4,
277  PSH = 8,
278  ACK = 16,
279  URG = 32,
280  ECE = 64,
281  CWR = 128
282  } Flags_t;
283 
288  static TypeId GetTypeId (void);
289  virtual TypeId GetInstanceTypeId (void) const;
290  virtual void Print (std::ostream &os) const;
291  virtual uint32_t GetSerializedSize (void) const;
292  virtual void Serialize (Buffer::Iterator start) const;
293  virtual uint32_t Deserialize (Buffer::Iterator start);
294 
299  bool IsChecksumOk (void) const;
300 
307  friend bool operator== (const TcpHeader &lhs, const TcpHeader &rhs);
308 
309 private:
315  uint16_t CalculateHeaderChecksum (uint16_t size) const;
316 
325  uint8_t CalculateHeaderLength () const;
326 
327  uint16_t m_sourcePort;
328  uint16_t m_destinationPort;
331  uint8_t m_length;
332  uint8_t m_flags;
333  uint16_t m_windowSize;
334  uint16_t m_urgentPointer;
335 
338  uint8_t m_protocol;
339 
342 
343  static const uint8_t m_maxOptionsLen = 40;
344  typedef std::list< Ptr<TcpOption> > TcpOptionList;
345  TcpOptionList m_options;
346  uint8_t m_optionsLen;
347 };
348 
349 } // namespace ns3
350 
351 #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:173
void InitializeChecksum(const Ipv4Address &source, const Ipv4Address &destination, uint8_t protocol)
Initialize the TCP checksum.
Definition: tcp-header.cc:191
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:343
def start()
Definition: core.py:1482
Address m_source
Source IP address.
Definition: tcp-header.h:336
uint8_t GetMaxOptionLength() const
Get maximum option length.
Definition: tcp-header.cc:167
uint16_t m_destinationPort
Destination port.
Definition: tcp-header.h:328
uint8_t CalculateHeaderLength() const
Calculates the header length (in words)
Definition: tcp-header.cc:445
bool m_calcChecksum
Flag to calculate checksum.
Definition: tcp-header.h:340
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:287
bool AppendOption(Ptr< TcpOption > option)
Append an option to the TCP header.
Definition: tcp-header.cc:463
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:179
std::list< Ptr< TcpOption > > TcpOptionList
List of TcpOption.
Definition: tcp-header.h:344
Flags_t
TCP flag field values.
Definition: tcp-header.h:271
virtual TypeId GetInstanceTypeId(void) const
Get the most derived TypeId for this Object.
Definition: tcp-header.cc:281
uint16_t CalculateHeaderChecksum(uint16_t size) const
Calculate the header checksum.
Definition: tcp-header.cc:221
bool m_goodChecksum
Flag to indicate that checksum is correct.
Definition: tcp-header.h:341
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:333
Every class exported by the ns3 library is enclosed in the ns3 namespace.
uint16_t m_sourcePort
Source port.
Definition: tcp-header.h:327
uint8_t m_optionsLen
Tcp options length.
Definition: tcp-header.h:346
Header for the Transmission Control Protocol.
Definition: tcp-header.h:44
uint8_t GetOptionLength() const
Get the total length of appended options.
Definition: tcp-header.cc:161
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:337
void SetUrgentPointer(uint16_t urgentPointer)
Set the urgent pointer.
Definition: tcp-header.cc:125
virtual uint32_t GetSerializedSize(void) const
Definition: tcp-header.cc:309
uint8_t GetLength() const
Get the length in words.
Definition: tcp-header.cc:155
uint8_t m_protocol
Protocol number.
Definition: tcp-header.h:338
Ptr< TcpOption > GetOption(uint8_t kind) const
Get the option specified.
Definition: tcp-header.cc:489
virtual uint32_t Deserialize(Buffer::Iterator start)
Definition: tcp-header.cc:360
uint16_t m_urgentPointer
Urgent pointer.
Definition: tcp-header.h:334
Describes an IPv6 address.
Definition: ipv6-address.h:48
Ipv4 addresses are stored in host order in this class.
Definition: ipv4-address.h:40
SequenceNumber32 m_ackNumber
ACK number.
Definition: tcp-header.h:330
uint8_t m_flags
Flags (really a uint6_t)
Definition: tcp-header.h:332
uint8_t m_length
Length (really a uint4_t) in words.
Definition: tcp-header.h:331
friend bool operator==(const TcpHeader &lhs, const TcpHeader &rhs)
Comparison operator.
Definition: tcp-header.cc:521
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:264
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:345
bool HasOption(uint8_t kind) const
Check if the header has the option specified.
Definition: tcp-header.cc:505
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:535
uint16_t GetUrgentPointer() const
Get the urgent pointer.
Definition: tcp-header.cc:185
virtual void Serialize(Buffer::Iterator start) const
Definition: tcp-header.cc:315
static TypeId GetTypeId(void)
Get the type ID.
Definition: tcp-header.cc:270
SequenceNumber32 m_sequenceNumber
Sequence number.
Definition: tcp-header.h:329