Defines the TCP option of kind 8 (timestamp option) as in RFC 1323 More...

#include "tcp-option-ts.h"

Inheritance diagram for ns3::TcpOptionTS:

Collaboration diagram for ns3::TcpOptionTS:

Public Member Functions
	TcpOptionTS ()

	~TcpOptionTS () override

uint32_t	Deserialize (Buffer::Iterator start) override
	Deserialize the Option from a buffer iterator.

uint32_t	GetEcho () const
	Get the timestamp echo stored in the Option.

TypeId	GetInstanceTypeId () const override
	Get the most derived TypeId for this Object.

uint8_t	GetKind () const override
	Get the ‘kind’ (as in RFC 793 ) of this option.

uint32_t	GetSerializedSize () const override
	Returns number of bytes required for Option serialization.

uint32_t	GetTimestamp () const
	Get the timestamp stored in the Option.

void	Print (std::ostream &os) const override
	Print the Option contents.

void	Serialize (Buffer::Iterator start) const override
	Serialize the Option to a buffer iterator.

void	SetEcho (uint32_t ts)
	Set the timestamp echo stored in the Option.

void	SetTimestamp (uint32_t ts)
	Set the timestamp stored in the Option.

Public Member Functions inherited from ns3::TcpOption
	TcpOption ()

	~TcpOption () override

Public Member Functions inherited from ns3::Object
	Object ()
	Constructor.

	~Object () override
	Destructor.

void	AggregateObject (Ptr< Object > other)
	Aggregate two Objects together.

void	Dispose ()
	Dispose of this Object.

AggregateIterator	GetAggregateIterator () const
	Get an iterator to the Objects aggregated to this one.

template<typename T >
Ptr< T >	GetObject () const
	Get a pointer to the requested aggregated Object.

template<>
Ptr< Object >	GetObject () const
	Specialization of () for objects of type ns3::Object.

template<typename T >
Ptr< T >	GetObject (TypeId tid) const
	Get a pointer to the requested aggregated Object by TypeId.

template<>
Ptr< Object >	GetObject (TypeId tid) const
	Specialization of (TypeId tid) for objects of type ns3::Object.

void	Initialize ()
	Invoke DoInitialize on all Objects aggregated to this one.

bool	IsInitialized () const
	Check if the object has been initialized.

void	UnidirectionalAggregateObject (Ptr< Object > other)
	Aggregate an Object to another Object.

Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter >
	SimpleRefCount ()
	Default constructor.

	SimpleRefCount (const SimpleRefCount &o)
	Copy constructor.

uint32_t	GetReferenceCount () const
	Get the reference count of the object.

SimpleRefCount &	operator= (const SimpleRefCount &o)
	Assignment operator.

void	Ref () const
	Increment the reference count.

void	Unref () const
	Decrement the reference count.

Public Member Functions inherited from ns3::ObjectBase
virtual	~ObjectBase ()
	Virtual destructor.

void	GetAttribute (std::string name, AttributeValue &value, bool permissive=false) const
	Get the value of an attribute, raising fatal errors if unsuccessful.

bool	GetAttributeFailSafe (std::string name, AttributeValue &value) const
	Get the value of an attribute without raising errors.

void	SetAttribute (std::string name, const AttributeValue &value)
	Set a single attribute, raising fatal errors if unsuccessful.

bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)
	Set a single attribute without raising errors.

bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)
	Connect a TraceSource to a Callback with a context.

bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)
	Connect a TraceSource to a Callback without a context.

bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected with a context.

bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)
	Disconnect from a TraceSource a Callback previously connected without a context.

Static Public Member Functions
static Time	ElapsedTimeFromTsValue (uint32_t echoTime)
	Estimate the Time elapsed from a TS echo value.

static TypeId	GetTypeId ()
	Get the type ID.

static uint32_t	NowToTsValue ()
	Return an uint32_t value which represent "now".

Static Public Member Functions inherited from ns3::TcpOption
static Ptr< TcpOption >	CreateOption (uint8_t kind)
	Creates an option.

static TypeId	GetTypeId ()
	Get the type ID.

static bool	IsKindKnown (uint8_t kind)
	Check if the option is implemented.

Static Public Member Functions inherited from ns3::Object
static TypeId	GetTypeId ()
	Register this type.

Static Public Member Functions inherited from ns3::ObjectBase
static TypeId	GetTypeId ()
	Get the type ID.

Protected Attributes
uint32_t	m_echo
	echo timestamp

uint32_t	m_timestamp
	local timestamp

Additional Inherited Members
Public Types inherited from ns3::TcpOption
enum	Kind { END = 0 , NOP = 1 , MSS = 2 , WINSCALE = 3 , SACKPERMITTED = 4 , SACK = 5 , TS = 8 , UNKNOWN = 255 }
	The option Kind, as defined in the respective RFCs. More...

Protected Member Functions inherited from ns3::Object
	Object (const Object &o)
	Copy an Object.

virtual void	DoDispose ()
	Destructor implementation.

virtual void	DoInitialize ()
	Initialize() implementation.

virtual void	NotifyNewAggregate ()
	Notify all Objects aggregated to this one of a new Object being aggregated.

Protected Member Functions inherited from ns3::ObjectBase
void	ConstructSelf (const AttributeConstructionList &attributes)
	Complete construction of ObjectBase; invoked by derived classes.

virtual void	NotifyConstructionCompleted ()
	Notifier called once the ObjectBase is fully constructed.

Related Symbols inherited from ns3::ObjectBase
static TypeId	GetObjectIid ()
	Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly.

Detailed Description

Defines the TCP option of kind 8 (timestamp option) as in RFC 1323

Definition at line 25 of file tcp-option-ts.h.

Constructor & Destructor Documentation

◆ TcpOptionTS()

ns3::TcpOptionTS::TcpOptionTS ( )

Definition at line 20 of file tcp-option-ts.cc.

◆ ~TcpOptionTS()

ns3::TcpOptionTS::~TcpOptionTS ( )

override

Definition at line 27 of file tcp-option-ts.cc.

Member Function Documentation

◆ Deserialize()

uint32_t ns3::TcpOptionTS::Deserialize ( Buffer::Iterator start )

overridevirtual

Deserialize the Option from a buffer iterator.

Parameters

start the buffer iterator

Returns: the number of deserialized bytes

Implements ns3::TcpOption.

Definition at line 70 of file tcp-option-ts.cc.

References GetKind(), GetSerializedSize(), m_echo, m_timestamp, NS_LOG_WARN, ns3::Buffer::Iterator::ReadNtohU32(), and ns3::Buffer::Iterator::ReadU8().

Referenced by TcpOptionTSTestCase::TestDeserialize().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ ElapsedTimeFromTsValue()

Time ns3::TcpOptionTS::ElapsedTimeFromTsValue ( uint32_t echoTime )

static

Estimate the Time elapsed from a TS echo value.

The echoTime should be a value returned from NowToTsValue.

Parameters

echoTime Echoed value from other side

See also: NowToTsValue

Returns: The measured RTT

Definition at line 133 of file tcp-option-ts.cc.

References ns3::Time::GetMilliSeconds(), ns3::MilliSeconds(), ns3::Simulator::Now(), and ns3::Seconds().

Referenced by ns3::TcpSocketBase::CalculateRttSample(), and TimestampValueTestCase::Check().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ GetEcho()

uint32_t ns3::TcpOptionTS::GetEcho ( ) const

Get the timestamp echo stored in the Option.

Returns: the timestamp echo

Definition at line 105 of file tcp-option-ts.cc.

References m_echo.

Referenced by TcpOptionTSTestCase::TestDeserialize(), and TcpOptionTSTestCase::TestSerialize().

Here is the caller graph for this function:

◆ GetInstanceTypeId()

TypeId ns3::TcpOptionTS::GetInstanceTypeId ( ) const

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.

Returns: The TypeId associated to the most-derived type of this instance.

Reimplemented from ns3::TcpOption.

Definition at line 42 of file tcp-option-ts.cc.

References GetTypeId().

Here is the call graph for this function:

◆ GetKind()

uint8_t ns3::TcpOptionTS::GetKind ( ) const

overridevirtual

Get the ‘kind’ (as in RFC 793 ) of this option.

Returns: the Option Kind

Implements ns3::TcpOption.

Definition at line 93 of file tcp-option-ts.cc.

References ns3::TcpOption::TS.

Referenced by Deserialize(), and Serialize().

Here is the caller graph for this function:

◆ GetSerializedSize()

uint32_t ns3::TcpOptionTS::GetSerializedSize ( ) const

overridevirtual

Returns number of bytes required for Option serialization.

Returns: number of bytes required for Option serialization

Implements ns3::TcpOption.

Definition at line 54 of file tcp-option-ts.cc.

Referenced by Deserialize(), and TcpOptionTSTestCase::TestSerialize().

Here is the caller graph for this function:

◆ GetTimestamp()

uint32_t ns3::TcpOptionTS::GetTimestamp ( ) const

Get the timestamp stored in the Option.

Returns: the timestamp

Definition at line 99 of file tcp-option-ts.cc.

References m_timestamp.

Referenced by TcpOptionTSTestCase::TestDeserialize(), and TcpOptionTSTestCase::TestSerialize().

Here is the caller graph for this function:

◆ GetTypeId()

TypeId ns3::TcpOptionTS::GetTypeId ( )

static

Get the type ID.

Returns: the object TypeId

Definition at line 32 of file tcp-option-ts.cc.

References ns3::TypeId::SetParent().

Referenced by ns3::TcpOption::CreateOption(), and GetInstanceTypeId().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ NowToTsValue()

uint32_t ns3::TcpOptionTS::NowToTsValue ( )

static

Return an uint32_t value which represent "now".

The value returned is usually used as Timestamp option for the TCP header; when the value will be echoed back, calculating the RTT will be an easy matter.

The RFC does not mention any units for this value; following what is implemented in OS, we use milliseconds. Any change to this must be reflected to EstimateRttFromTs.

See also: EstimateRttFromTs

Returns: The Timestamp value to use

Definition at line 123 of file tcp-option-ts.cc.

References ns3::Time::GetMilliSeconds(), and ns3::Simulator::Now().

Referenced by ns3::TcpSocketBase::AddOptionTimestamp(), TimestampValueTestCase::Check(), and TimestampValueTestCase::Init().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ Print()

void ns3::TcpOptionTS::Print ( std::ostream & os ) const

overridevirtual

Print the Option contents.

Parameters

os	the output stream

Implements ns3::TcpOption.

Definition at line 48 of file tcp-option-ts.cc.

References m_echo, and m_timestamp.

◆ Serialize()

void ns3::TcpOptionTS::Serialize ( Buffer::Iterator start ) const

overridevirtual

Serialize the Option to a buffer iterator.

Parameters

start the buffer iterator

Implements ns3::TcpOption.

Definition at line 60 of file tcp-option-ts.cc.

References GetKind(), m_echo, m_timestamp, ns3::Buffer::Iterator::WriteHtonU32(), and ns3::Buffer::Iterator::WriteU8().

Referenced by TcpOptionTSTestCase::TestSerialize().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ SetEcho()

void ns3::TcpOptionTS::SetEcho ( uint32_t ts )

Set the timestamp echo stored in the Option.

Parameters

ts	the timestamp echo

Definition at line 117 of file tcp-option-ts.cc.

References m_echo.

Referenced by TcpOptionTSTestCase::TestSerialize().

Here is the caller graph for this function:

◆ SetTimestamp()

void ns3::TcpOptionTS::SetTimestamp ( uint32_t ts )

Set the timestamp stored in the Option.

Parameters

ts	the timestamp

Definition at line 111 of file tcp-option-ts.cc.

References m_timestamp.

Referenced by TcpOptionTSTestCase::TestSerialize().

Here is the caller graph for this function:

Member Data Documentation

◆ m_echo

uint32_t ns3::TcpOptionTS::m_echo

protected

echo timestamp

Definition at line 95 of file tcp-option-ts.h.

Referenced by Deserialize(), GetEcho(), Print(), Serialize(), and SetEcho().

◆ m_timestamp

uint32_t ns3::TcpOptionTS::m_timestamp

protected

local timestamp

Definition at line 94 of file tcp-option-ts.h.

Referenced by Deserialize(), GetTimestamp(), Print(), Serialize(), and SetTimestamp().

The documentation for this class was generated from the following files:

src/internet/model/tcp-option-ts.h
src/internet/model/tcp-option-ts.cc

Public Member Functions

Static Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ TcpOptionTS()

◆ ~TcpOptionTS()

Member Function Documentation

◆ Deserialize()

◆ ElapsedTimeFromTsValue()

◆ GetEcho()

◆ GetInstanceTypeId()

◆ GetKind()

◆ GetSerializedSize()

◆ GetTimestamp()

◆ GetTypeId()

◆ NowToTsValue()

◆ Print()

◆ Serialize()

◆ SetEcho()

◆ SetTimestamp()

Member Data Documentation

◆ m_echo

◆ m_timestamp