Implementation of the GPRS Tunnelling Protocol header according to GTPv1-U Release 10 as per 3Gpp TS 29.281 document. More...
#include "epc-gtpu-header.h"
Public Member Functions | |
GtpuHeader () | |
~GtpuHeader () override | |
uint32_t | Deserialize (Buffer::Iterator start) override |
bool | GetExtensionHeaderFlag () const |
Get extension header flag function. More... | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. More... | |
uint16_t | GetLength () const |
Get length function. More... | |
uint8_t | GetMessageType () const |
Get message type function. More... | |
uint8_t | GetNextExtensionType () const |
Get next extension type function. More... | |
uint8_t | GetNPduNumber () const |
Get NPDU number function. More... | |
bool | GetNPduNumberFlag () const |
Get type of GTP-U message function. More... | |
bool | GetProtocolType () const |
Get protocol type function. More... | |
uint16_t | GetSequenceNumber () const |
Get protocol type function. More... | |
bool | GetSequenceNumberFlag () const |
Get sequence number flag function. More... | |
uint32_t | GetSerializedSize () const override |
uint32_t | GetTeid () const |
Get a tunnel endpoint identificator (TEID) More... | |
uint8_t | GetVersion () const |
Get version function. More... | |
bool | operator== (const GtpuHeader &b) const |
Equality operator. More... | |
void | Print (std::ostream &os) const override |
void | Serialize (Buffer::Iterator start) const override |
void | SetExtensionHeaderFlag (bool extensionHeaderFlag) |
Set extension header flag function. More... | |
void | SetLength (uint16_t length) |
Set the length in octets of the payload. More... | |
void | SetMessageType (uint8_t messageType) |
Set message type function. More... | |
void | SetNextExtensionType (uint8_t nextExtensionType) |
Set next extension type function. More... | |
void | SetNPduNumber (uint8_t nPduNumber) |
Set NPDU number function. More... | |
void | SetNPduNumberFlag (bool nPduNumberFlag) |
Sets the flag that indicates the presence of a meaningful value of the N-PDU Number field. More... | |
void | SetProtocolType (bool protocolType) |
Set protocol type function. More... | |
void | SetSequenceNumber (uint16_t sequenceNumber) |
Set sequence number function. More... | |
void | SetSequenceNumberFlag (bool sequenceNumberFlag) |
Set sequence number flag function. More... | |
void | SetTeid (uint32_t teid) |
Set TEID function. More... | |
void | SetVersion (uint8_t version) |
Set version function. More... | |
Public Member Functions inherited from ns3::Header | |
~Header () override | |
virtual uint32_t | Deserialize (Buffer::Iterator start)=0 |
Deserialize the object from a buffer iterator. More... | |
virtual uint32_t | Deserialize (Buffer::Iterator start, Buffer::Iterator end) |
Deserialize the object from a buffer iterator. More... | |
Public Member Functions inherited from ns3::Chunk | |
virtual uint32_t | Deserialize (Buffer::Iterator start, Buffer::Iterator end) |
Deserialize the object from a buffer iterator. More... | |
Public Member Functions inherited from ns3::ObjectBase | |
virtual | ~ObjectBase () |
Virtual destructor. More... | |
void | GetAttribute (std::string name, AttributeValue &value) const |
Get the value of an attribute, raising fatal errors if unsuccessful. More... | |
bool | GetAttributeFailSafe (std::string name, AttributeValue &value) const |
Get the value of an attribute without raising errors. More... | |
void | SetAttribute (std::string name, const AttributeValue &value) |
Set a single attribute, raising fatal errors if unsuccessful. More... | |
bool | SetAttributeFailSafe (std::string name, const AttributeValue &value) |
Set a single attribute without raising errors. More... | |
bool | TraceConnect (std::string name, std::string context, const CallbackBase &cb) |
Connect a TraceSource to a Callback with a context. More... | |
bool | TraceConnectWithoutContext (std::string name, const CallbackBase &cb) |
Connect a TraceSource to a Callback without a context. More... | |
bool | TraceDisconnect (std::string name, std::string context, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected with a context. More... | |
bool | TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb) |
Disconnect from a TraceSource a Callback previously connected without a context. More... | |
Static Public Member Functions | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::Header | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::Chunk | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId () |
Get the type ID. More... | |
Private Attributes | |
bool | m_extensionHeaderFlag |
This flag indicates the presence of a meaningful value of the Next Extension Header field. More... | |
uint16_t | m_length |
This field indicates the length in octets of the payload, i.e. More... | |
uint8_t | m_messageType |
This field indicates the type of GTP-U message. More... | |
uint8_t | m_nextExtensionType |
This field defines the type of Extension Header that follows this field in the GTP-PDU. More... | |
uint8_t | m_nPduNumber |
This field is used at the Inter SGSN Routeing Area Update procedure and some inter-system handover procedures (e.g. More... | |
bool | m_nPduNumberFlag |
This flag indicates the presence of a meaningful value of the N-PDU Number field. More... | |
bool | m_protocolType |
This bit is used as a protocol discriminator between GTP (when PT is '1') and GTP' (when PT is '0'). More... | |
uint16_t | m_sequenceNumber |
If Sequence Number field is used for G-PDUs (T-PDUs+headers), an increasing sequence number for T-PDUs is transmitted via GTP-U tunnels, when transmission order must be preserved. More... | |
bool | m_sequenceNumberFlag |
This flag indicates the presence of a meaningful value of the Sequence Number field. More... | |
uint32_t | m_teid |
This field unambiguously identifies a tunnel endpoint in the receiving GTP-U protocol entity. More... | |
uint8_t | m_version |
This field is used to determine the version of the GTPU-U protocol. More... | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. More... | |
virtual void | NotifyConstructionCompleted () |
Notifier called once the ObjectBase is fully constructed. More... | |
Related Functions inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid () |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
Implementation of the GPRS Tunnelling Protocol header according to GTPv1-U Release 10 as per 3Gpp TS 29.281 document.
Definition at line 39 of file epc-gtpu-header.h.
ns3::GtpuHeader::GtpuHeader | ( | ) |
Definition at line 46 of file epc-gtpu-header.cc.
|
override |
Definition at line 61 of file epc-gtpu-header.cc.
|
overridevirtual |
start | an iterator which points to where the header should read from. |
This method is used by Packet::RemoveHeader to re-create a header from the byte buffer of a packet. The data read is expected to match bit-for-bit the representation of this header in real networks.
Note that data is not actually removed from the buffer to which the iterator points. Both Packet::RemoveHeader() and Packet::PeekHeader() call Deserialize(), but only the RemoveHeader() has additional statements to remove the header bytes from the underlying buffer and associated metadata.
Implements ns3::Header.
Definition at line 93 of file epc-gtpu-header.cc.
References GetSerializedSize(), m_extensionHeaderFlag, m_length, m_messageType, m_nextExtensionType, m_nPduNumber, m_nPduNumberFlag, m_protocolType, m_sequenceNumber, m_sequenceNumberFlag, m_teid, m_version, ns3::Buffer::Iterator::ReadNtohU16(), ns3::Buffer::Iterator::ReadNtohU32(), ns3::Buffer::Iterator::ReadU8(), and two-ray-to-three-gpp-ch-calibration::start.
bool ns3::GtpuHeader::GetExtensionHeaderFlag | ( | ) | const |
Get extension header flag function.
Definition at line 138 of file epc-gtpu-header.cc.
References m_extensionHeaderFlag.
|
overridevirtual |
Get the most derived TypeId for this Object.
This method is typically implemented by ns3::Object::GetInstanceTypeId but some classes which derive from ns3::ObjectBase directly have to implement it themselves.
Implements ns3::ObjectBase.
Definition at line 66 of file epc-gtpu-header.cc.
References GetTypeId().
uint16_t ns3::GtpuHeader::GetLength | ( | void | ) | const |
Get length function.
Definition at line 144 of file epc-gtpu-header.cc.
References m_length.
uint8_t ns3::GtpuHeader::GetMessageType | ( | ) | const |
Get message type function.
Definition at line 150 of file epc-gtpu-header.cc.
References m_messageType.
uint8_t ns3::GtpuHeader::GetNextExtensionType | ( | ) | const |
Get next extension type function.
Definition at line 168 of file epc-gtpu-header.cc.
References m_nextExtensionType.
uint8_t ns3::GtpuHeader::GetNPduNumber | ( | ) | const |
Get NPDU number function.
Definition at line 156 of file epc-gtpu-header.cc.
References m_nPduNumber.
bool ns3::GtpuHeader::GetNPduNumberFlag | ( | ) | const |
Get type of GTP-U message function.
Definition at line 162 of file epc-gtpu-header.cc.
References m_nPduNumberFlag.
bool ns3::GtpuHeader::GetProtocolType | ( | ) | const |
Get protocol type function.
Definition at line 174 of file epc-gtpu-header.cc.
References m_protocolType.
uint16_t ns3::GtpuHeader::GetSequenceNumber | ( | ) | const |
Get protocol type function.
Definition at line 180 of file epc-gtpu-header.cc.
References m_sequenceNumber.
bool ns3::GtpuHeader::GetSequenceNumberFlag | ( | ) | const |
Get sequence number flag function.
Definition at line 186 of file epc-gtpu-header.cc.
References m_sequenceNumberFlag.
|
overridevirtual |
This method is used by Packet::AddHeader to store a header into the byte buffer of a packet. This method should return the number of bytes which are needed to store the full header data by Serialize.
Implements ns3::Header.
Definition at line 72 of file epc-gtpu-header.cc.
Referenced by Deserialize(), ns3::EpcX2::DoSendUeData(), ns3::EpcSgwApplication::SendToS1uSocket(), ns3::EpcEnbApplication::SendToS1uSocket(), ns3::EpcSgwApplication::SendToS5uSocket(), and ns3::EpcPgwApplication::SendToS5uSocket().
uint32_t ns3::GtpuHeader::GetTeid | ( | ) | const |
Get a tunnel endpoint identificator (TEID)
Definition at line 192 of file epc-gtpu-header.cc.
References m_teid.
Referenced by ns3::EpcEnbApplication::RecvFromS1uSocket(), ns3::EpcSgwApplication::RecvFromS1uSocket(), ns3::EpcPgwApplication::RecvFromS5uSocket(), ns3::EpcSgwApplication::RecvFromS5uSocket(), and ns3::EpcX2::RecvFromX2uSocket().
|
static |
Get the type ID.
Definition at line 37 of file epc-gtpu-header.cc.
References ns3::TypeId::SetParent().
Referenced by GetInstanceTypeId().
uint8_t ns3::GtpuHeader::GetVersion | ( | ) | const |
Get version function.
Definition at line 198 of file epc-gtpu-header.cc.
References m_version.
bool ns3::GtpuHeader::operator== | ( | const GtpuHeader & | b | ) | const |
Equality operator.
b | GtpuHeader object to compare |
Definition at line 271 of file epc-gtpu-header.cc.
References m_extensionHeaderFlag, m_length, m_messageType, m_nextExtensionType, m_nPduNumber, m_nPduNumberFlag, m_protocolType, m_sequenceNumber, m_sequenceNumberFlag, m_teid, and m_version.
|
overridevirtual |
os | output stream This method is used by Packet::Print to print the content of a header as ascii data to a c++ output stream. Although the header is free to format its output as it wishes, it is recommended to follow a few rules to integrate with the packet pretty printer: start with flags, small field values located between a pair of parens. Values should be separated by whitespace. Follow the parens with the important fields, separated by whitespace. i.e.: (field1 val1 field2 val2 field3 val3) field4 val4 field5 val5 |
Implements ns3::Header.
Definition at line 112 of file epc-gtpu-header.cc.
References m_extensionHeaderFlag, m_length, m_messageType, m_nextExtensionType, m_nPduNumber, m_nPduNumberFlag, m_protocolType, m_sequenceNumber, m_sequenceNumberFlag, m_teid, and m_version.
|
overridevirtual |
start | an iterator which points to where the header should be written. |
This method is used by Packet::AddHeader to store a header into the byte buffer of a packet. The data written is expected to match bit-for-bit the representation of this header in a real network.
Implements ns3::Header.
Definition at line 78 of file epc-gtpu-header.cc.
References m_extensionHeaderFlag, m_length, m_messageType, m_nextExtensionType, m_nPduNumber, m_nPduNumberFlag, m_protocolType, m_sequenceNumber, m_sequenceNumberFlag, m_teid, m_version, two-ray-to-three-gpp-ch-calibration::start, ns3::Buffer::Iterator::WriteHtonU16(), ns3::Buffer::Iterator::WriteHtonU32(), and ns3::Buffer::Iterator::WriteU8().
void ns3::GtpuHeader::SetExtensionHeaderFlag | ( | bool | extensionHeaderFlag | ) |
Set extension header flag function.
extensionHeaderFlag |
Definition at line 204 of file epc-gtpu-header.cc.
References m_extensionHeaderFlag.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetLength | ( | uint16_t | length | ) |
Set the length in octets of the payload.
length | the length |
Definition at line 210 of file epc-gtpu-header.cc.
References m_length.
Referenced by EpsGtpuHeaderTestCase::DoRun(), ns3::EpcX2::DoSendUeData(), ns3::EpcSgwApplication::SendToS1uSocket(), ns3::EpcEnbApplication::SendToS1uSocket(), ns3::EpcSgwApplication::SendToS5uSocket(), and ns3::EpcPgwApplication::SendToS5uSocket().
void ns3::GtpuHeader::SetMessageType | ( | uint8_t | messageType | ) |
Set message type function.
messageType | the message type |
Definition at line 216 of file epc-gtpu-header.cc.
References m_messageType.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetNextExtensionType | ( | uint8_t | nextExtensionType | ) |
Set next extension type function.
nextExtensionType | the next extension type |
Definition at line 234 of file epc-gtpu-header.cc.
References m_nextExtensionType.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetNPduNumber | ( | uint8_t | nPduNumber | ) |
Set NPDU number function.
nPduNumber | the NPDU number |
Definition at line 222 of file epc-gtpu-header.cc.
References m_nPduNumber.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetNPduNumberFlag | ( | bool | nPduNumberFlag | ) |
Sets the flag that indicates the presence of a meaningful value of the N-PDU Number field.
nPduNumberFlag | the NPDU number flag |
Definition at line 228 of file epc-gtpu-header.cc.
References m_nPduNumberFlag.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetProtocolType | ( | bool | protocolType | ) |
Set protocol type function.
protocolType | the protocol type |
Definition at line 240 of file epc-gtpu-header.cc.
References m_protocolType.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetSequenceNumber | ( | uint16_t | sequenceNumber | ) |
Set sequence number function.
sequenceNumber | the sequence number |
Definition at line 246 of file epc-gtpu-header.cc.
References m_sequenceNumber.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetSequenceNumberFlag | ( | bool | sequenceNumberFlag | ) |
Set sequence number flag function.
sequenceNumberFlag | the sequence number flag |
Definition at line 252 of file epc-gtpu-header.cc.
References m_sequenceNumberFlag.
Referenced by EpsGtpuHeaderTestCase::DoRun().
void ns3::GtpuHeader::SetTeid | ( | uint32_t | teid | ) |
Set TEID function.
teid | the TEID |
Definition at line 258 of file epc-gtpu-header.cc.
References m_teid.
Referenced by EpsGtpuHeaderTestCase::DoRun(), ns3::EpcX2::DoSendUeData(), ns3::EpcSgwApplication::SendToS1uSocket(), ns3::EpcEnbApplication::SendToS1uSocket(), ns3::EpcSgwApplication::SendToS5uSocket(), and ns3::EpcPgwApplication::SendToS5uSocket().
void ns3::GtpuHeader::SetVersion | ( | uint8_t | version | ) |
Set version function.
version | the version |
Definition at line 264 of file epc-gtpu-header.cc.
References m_version.
Referenced by EpsGtpuHeaderTestCase::DoRun().
|
private |
This flag indicates the presence of a meaningful value of the Next Extension Header field.
When it is set to '0', the Next Extension Header field either is not present or, if present, shall not be interpreted. When it is set to '1', the Next Extension Header field is present, and shall be interpreted
Definition at line 193 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetExtensionHeaderFlag(), operator==(), Print(), Serialize(), and SetExtensionHeaderFlag().
|
private |
This field indicates the length in octets of the payload, i.e.
the rest of the packet following the mandatory part of the GTP header (that is the first 8 octets). The Sequence Number, the N-PDU Number or any Extension headers shall be considered to be part of the payload, i.e. included in the length count
Definition at line 219 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetLength(), operator==(), Print(), Serialize(), and SetLength().
|
private |
This field indicates the type of GTP-U message.
Definition at line 212 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetMessageType(), operator==(), Print(), Serialize(), and SetMessageType().
|
private |
This field defines the type of Extension Header that follows this field in the GTP-PDU.
Definition at line 244 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetNextExtensionType(), operator==(), Print(), Serialize(), and SetNextExtensionType().
|
private |
This field is used at the Inter SGSN Routeing Area Update procedure and some inter-system handover procedures (e.g.
between 2G and 3G radio access networks). This field is used to co-ordinate the data transmission for acknowledged mode of communication between the MS and the SGSN
Definition at line 239 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetNPduNumber(), operator==(), Print(), Serialize(), and SetNPduNumber().
|
private |
This flag indicates the presence of a meaningful value of the N-PDU Number field.
When it is set to '0', the N-PDU Number field either is not present, or, if present, shall not be interpreted. When it is set to '1', the N-PDU Number field is present, and shall be interpreted
Definition at line 208 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetNPduNumberFlag(), operator==(), Print(), Serialize(), and SetNPduNumberFlag().
|
private |
This bit is used as a protocol discriminator between GTP (when PT is '1') and GTP' (when PT is '0').
Definition at line 185 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetProtocolType(), operator==(), Print(), Serialize(), and SetProtocolType().
|
private |
If Sequence Number field is used for G-PDUs (T-PDUs+headers), an increasing sequence number for T-PDUs is transmitted via GTP-U tunnels, when transmission order must be preserved.
Definition at line 232 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetSequenceNumber(), operator==(), Print(), Serialize(), and SetSequenceNumber().
|
private |
This flag indicates the presence of a meaningful value of the Sequence Number field.
When it is set to '0', the Sequence Number field either is not present or, if present, shall not be interpreted. When it is set to '1', the Sequence Number field is present, and shall be interpreted
Definition at line 201 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetSequenceNumberFlag(), operator==(), Print(), Serialize(), and SetSequenceNumberFlag().
|
private |
This field unambiguously identifies a tunnel endpoint in the receiving GTP-U protocol entity.
The receiving end side of a GTP tunnel locally assigns the TEID value the transmitting side has to use.
Definition at line 226 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetTeid(), operator==(), Print(), Serialize(), and SetTeid().
|
private |
This field is used to determine the version of the GTPU-U protocol.
The version number shall be set to 1.
Definition at line 179 of file epc-gtpu-header.h.
Referenced by Deserialize(), GetVersion(), operator==(), Print(), Serialize(), and SetVersion().