Main PacketBB Packet object. More...

#include <packetbb.h>

Inheritance diagram for ns3::PbbPacket:

Collaboration diagram for ns3::PbbPacket:

Public Types
typedef std::list< Ptr < PbbMessage > >::const_iterator	ConstMessageIterator

typedef std::list< Ptr< PbbTlv > >::const_iterator	ConstTlvIterator

typedef std::list< Ptr < PbbMessage > >::iterator	MessageIterator

typedef std::list< Ptr< PbbTlv > >::iterator	TlvIterator

Public Member Functions
	PbbPacket (void)

	~PbbPacket (void)

virtual uint32_t	Deserialize (Buffer::Iterator start)
	Deserializes a packet from the specified buffer. More...

TlvIterator	Erase (TlvIterator position)
	Removes the packet TLV at the specified position. More...

TlvIterator	Erase (TlvIterator first, TlvIterator last)
	Removes all packet TLVs from [first, last) (includes first, not includes last). More...

MessageIterator	Erase (MessageIterator position)
	Removes the message at the specified position. More...

MessageIterator	Erase (MessageIterator first, MessageIterator last)
	Removes all messages from [first, last) (includes first, not includes last). More...

virtual TypeId	GetInstanceTypeId (void) const

uint16_t	GetSequenceNumber (void) const

virtual uint32_t	GetSerializedSize (void) const

uint8_t	GetVersion (void) const

bool	HasSequenceNumber (void) const
	Tests whether or not this packet has a sequence number. More...

Ptr< PbbMessage >	MessageBack (void)

const Ptr< PbbMessage >	MessageBack (void) const

MessageIterator	MessageBegin (void)

ConstMessageIterator	MessageBegin (void) const

void	MessageClear (void)
	Removes all messages from this packet. More...

bool	MessageEmpty (void) const

MessageIterator	MessageEnd (void)

ConstMessageIterator	MessageEnd (void) const

Ptr< PbbMessage >	MessageFront (void)

const Ptr< PbbMessage >	MessageFront (void) const

void	MessagePopBack (void)
	Removes a message from the back of this packet. More...

void	MessagePopFront (void)
	Removes a message from the front of this packet. More...

void	MessagePushBack (Ptr< PbbMessage > message)
	Appends a message to the back of this packet. More...

void	MessagePushFront (Ptr< PbbMessage > message)
	Prepends a message to the front of this packet. More...

int	MessageSize (void) const

bool	operator!= (const PbbPacket &other) const

bool	operator== (const PbbPacket &other) const

virtual void	Print (std::ostream &os) const
	Pretty-prints the contents of this block. More...

virtual void	Serialize (Buffer::Iterator start) const
	Serializes this packet into the specified buffer. More...

void	SetSequenceNumber (uint16_t number)
	Sets the sequence number of this packet. More...

Ptr< PbbTlv >	TlvBack (void)

const Ptr< PbbTlv >	TlvBack (void) const

TlvIterator	TlvBegin (void)

ConstTlvIterator	TlvBegin (void) const

void	TlvClear (void)
	Removes all packet TLVs from this packet. More...

bool	TlvEmpty (void) const

TlvIterator	TlvEnd (void)

ConstTlvIterator	TlvEnd (void) const

Ptr< PbbTlv >	TlvFront (void)

const Ptr< PbbTlv >	TlvFront (void) const

void	TlvPopBack (void)
	Removes a packet TLV from the back of this block. More...

void	TlvPopFront (void)
	Removes a packet TLV from the front of this packet. More...

void	TlvPushBack (Ptr< PbbTlv > tlv)
	Appends a packet TLV to the back of this packet. More...

void	TlvPushFront (Ptr< PbbTlv > tlv)
	Prepends a packet TLV to the front of this packet. More...

int	TlvSize (void) const

Public Member Functions inherited from ns3::SimpleRefCount< PbbPacket, Header >
	SimpleRefCount ()

	SimpleRefCount (const SimpleRefCount &o)

uint32_t	GetReferenceCount (void) const

SimpleRefCount &	operator= (const SimpleRefCount &o)

void	Ref (void) const

void	Unref (void) const

Public Member Functions inherited from ns3::Header
virtual	~Header ()

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

void	GetAttribute (std::string name, AttributeValue &value) const

bool	GetAttributeFailSafe (std::string name, AttributeValue &attribute) const

void	SetAttribute (std::string name, const AttributeValue &value)

bool	SetAttributeFailSafe (std::string name, const AttributeValue &value)

bool	TraceConnect (std::string name, std::string context, const CallbackBase &cb)

bool	TraceConnectWithoutContext (std::string name, const CallbackBase &cb)

bool	TraceDisconnect (std::string name, std::string context, const CallbackBase &cb)

bool	TraceDisconnectWithoutContext (std::string name, const CallbackBase &cb)

Static Public Member Functions
static TypeId	GetTypeId (void)

Static Public Member Functions inherited from ns3::SimpleRefCount< PbbPacket, Header >
static void	Cleanup (void)

Static Public Member Functions inherited from ns3::Header
static TypeId	GetTypeId (void)

Static Public Member Functions inherited from ns3::Chunk
static TypeId	GetTypeId (void)

Static Public Member Functions inherited from ns3::ObjectBase
static TypeId	GetTypeId (void)

Private Attributes
bool	m_hasseqnum

std::list< Ptr< PbbMessage > >	m_messageList

uint16_t	m_seqnum

PbbTlvBlock	m_tlvList

uint8_t	m_version

Additional Inherited Members
Protected Member Functions inherited from ns3::ObjectBase
void	ConstructSelf (const AttributeConstructionList &attributes)

virtual void	NotifyConstructionCompleted (void)

Detailed Description

Main PacketBB Packet object.

A PacketBB packet is made up of zero or more packet TLVs (PbbTlv), and zero or more messages (PbbMessage).

See: RFC 5444 for details.

Doxygen introspection did not find any typical Config paths.
No Attributes are defined for this type.
No TraceSources are defined for this type.

Definition at line 364 of file packetbb.h.

Member Typedef Documentation

typedef std::list< Ptr<PbbMessage> >::const_iterator ns3::PbbPacket::ConstMessageIterator

Definition at line 370 of file packetbb.h.

typedef std::list< Ptr<PbbTlv> >::const_iterator ns3::PbbPacket::ConstTlvIterator

Definition at line 368 of file packetbb.h.

typedef std::list< Ptr<PbbMessage> >::iterator ns3::PbbPacket::MessageIterator

Definition at line 369 of file packetbb.h.

typedef std::list< Ptr<PbbTlv> >::iterator ns3::PbbPacket::TlvIterator

Definition at line 367 of file packetbb.h.

Constructor & Destructor Documentation

ns3::PbbPacket::PbbPacket ( void )

Definition at line 546 of file packetbb.cc.

References m_hasseqnum, m_version, NS_LOG_FUNCTION, and VERSION.

ns3::PbbPacket::~PbbPacket ( void )

Definition at line 553 of file packetbb.cc.

References MessageClear(), and NS_LOG_FUNCTION.

Here is the call graph for this function:

Member Function Documentation

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

virtual

Deserializes a packet from the specified buffer.

Parameters

start start offset

Returns: the number of bytes deserialized

If this returns a number smaller than the total number of bytes in the buffer, there was an error.

Implements ns3::Header.

Definition at line 916 of file packetbb.cc.

References ns3::PbbTlvBlock::Deserialize(), ns3::PbbMessage::DeserializeMessage(), ns3::Buffer::Iterator::GetDistanceFrom(), ns3::Buffer::Iterator::IsEnd(), m_tlvList, m_version, MessagePushBack(), NS_LOG_FUNCTION, PHAS_SEQ_NUM, PHAS_TLV, ns3::Buffer::Iterator::ReadNtohU16(), ns3::Buffer::Iterator::ReadU8(), SetSequenceNumber(), and visualizer.core::start().

Referenced by PbbTestCase::TestDeserialize().

Here is the call graph for this function:

Here is the caller graph for this function:

PbbPacket::MessageIterator ns3::PbbPacket::Erase ( PbbPacket::TlvIterator position )

Removes the packet TLV at the specified position.

Parameters

position an Iterator pointing to the packet TLV to erase.

Returns: an iterator pointing to the next packet TLV in the block.

Definition at line 690 of file packetbb.cc.

References ns3::PbbTlvBlock::Erase(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

PbbPacket::MessageIterator ns3::PbbPacket::Erase	(	PbbPacket::TlvIterator	first,
		PbbPacket::TlvIterator	last
	)

Removes all packet TLVs from [first, last) (includes first, not includes last).

Parameters

first	an Iterator pointing to the first packet TLV to erase (inclusive).
last	an Iterator pointing to the element past the last packet TLV to erase.

Returns: an iterator pointing to the next packet TLV in the block.

Definition at line 697 of file packetbb.cc.

References ns3::PbbTlvBlock::Erase(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

MessageIterator ns3::PbbPacket::Erase ( MessageIterator position )

Removes the message at the specified position.

Parameters

position an Iterator pointing to the message to erase.

Returns: an iterator pointing to the next message in the packet.

MessageIterator ns3::PbbPacket::Erase	(	MessageIterator	first,
		MessageIterator	last
	)

Removes all messages from [first, last) (includes first, not includes last).

Parameters

first	an Iterator pointing to the first message to erase (inclusive).
last	an Iterator pointing to the element past the last message to erase.

Returns: an iterator pointing to the next message in the block.

TypeId ns3::PbbPacket::GetInstanceTypeId ( void ) const

virtual

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

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 848 of file packetbb.cc.

References GetTypeId().

Here is the call graph for this function:

uint16_t ns3::PbbPacket::GetSequenceNumber ( void ) const

Returns: the sequence number of this packet.

Calling this while HasSequenceNumber is False is undefined. Make sure you check it first. This will be checked by an assert in debug builds.

Definition at line 575 of file packetbb.cc.

References HasSequenceNumber(), m_seqnum, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by operator==(), Print(), and Serialize().

Here is the call graph for this function:

Here is the caller graph for this function:

uint32_t ns3::PbbPacket::GetSerializedSize ( void ) const

virtual

Returns: The size (in bytes) needed to serialize this packet.

Implements ns3::Header.

Definition at line 854 of file packetbb.cc.

References ns3::PbbTlvBlock::GetSerializedSize(), HasSequenceNumber(), m_tlvList, MessageBegin(), MessageEnd(), NS_LOG_FUNCTION, and TlvEmpty().

Referenced by PbbTestCase::TestSerialize().

Here is the call graph for this function:

Here is the caller graph for this function:

TypeId ns3::PbbPacket::GetTypeId ( void )

static

Definition at line 838 of file packetbb.cc.

References ns3::TypeId::SetParent().

Referenced by GetInstanceTypeId().

Here is the call graph for this function:

Here is the caller graph for this function:

uint8_t ns3::PbbPacket::GetVersion ( void ) const

Returns: the version of PacketBB that constructed this packet.

This will always return 0 for packets constructed using this API.

Definition at line 560 of file packetbb.cc.

References m_version, and NS_LOG_FUNCTION.

Referenced by operator==().

Here is the caller graph for this function:

bool ns3::PbbPacket::HasSequenceNumber ( void ) const

Tests whether or not this packet has a sequence number.

Returns: true if this packet has a sequence number, false otherwise.

This should be called before calling GetSequenceNumber to make sure there actually is one.

Definition at line 583 of file packetbb.cc.

References m_hasseqnum, and NS_LOG_FUNCTION.

Referenced by GetSequenceNumber(), GetSerializedSize(), operator==(), Print(), and Serialize().

Here is the caller graph for this function:

Ptr< PbbMessage > ns3::PbbPacket::MessageBack ( void )

Returns: a smart pointer to the last message in this packet.

Definition at line 769 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

const Ptr< PbbMessage > ns3::PbbPacket::MessageBack ( void ) const

Returns: a const smart pointer to the last message in this packet.

Definition at line 776 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

PbbPacket::MessageIterator ns3::PbbPacket::MessageBegin ( void )

Returns: an iterator to the first message in this packet.

Definition at line 713 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

Referenced by GetSerializedSize(), MessageClear(), operator==(), Print(), and Serialize().

Here is the caller graph for this function:

PbbPacket::ConstMessageIterator ns3::PbbPacket::MessageBegin ( void ) const

Returns: a const iterator to the first message in this packet.

Definition at line 720 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

void ns3::PbbPacket::MessageClear ( void )

Removes all messages from this packet.

Definition at line 826 of file packetbb.cc.

References m_messageList, MessageBegin(), MessageEnd(), and NS_LOG_FUNCTION.

Referenced by ~PbbPacket().

Here is the call graph for this function:

Here is the caller graph for this function:

bool ns3::PbbPacket::MessageEmpty ( void ) const

Returns: true if there are no messages in this packet, false otherwise.

Definition at line 748 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

PbbPacket::MessageIterator ns3::PbbPacket::MessageEnd ( void )

Returns: an iterator to the past-the-end element in this message block.

Definition at line 727 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

Referenced by GetSerializedSize(), MessageClear(), operator==(), Print(), and Serialize().

Here is the caller graph for this function:

PbbPacket::ConstMessageIterator ns3::PbbPacket::MessageEnd ( void ) const

Returns: a const iterator to the past-the-end element in this message block.

Definition at line 734 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

Ptr< PbbMessage > ns3::PbbPacket::MessageFront ( void )

Returns: a smart pointer to the first message in this packet.

Definition at line 755 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

const Ptr< PbbMessage > ns3::PbbPacket::MessageFront ( void ) const

Returns: a const smart pointer to the first message in this packet.

Definition at line 762 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

void ns3::PbbPacket::MessagePopBack ( void )

Removes a message from the back of this packet.

Definition at line 804 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

void ns3::PbbPacket::MessagePopFront ( void )

Removes a message from the front of this packet.

Definition at line 790 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

void ns3::PbbPacket::MessagePushBack ( Ptr< PbbMessage > message )

Appends a message to the back of this packet.

Parameters

message a smart pointer to the message to append.

Definition at line 797 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

Referenced by Deserialize(), and PbbTestSuite::PbbTestSuite().

Here is the caller graph for this function:

void ns3::PbbPacket::MessagePushFront ( Ptr< PbbMessage > message )

Prepends a message to the front of this packet.

Parameters

message a smart pointer to the message to prepend.

Definition at line 783 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

int ns3::PbbPacket::MessageSize ( void ) const

Returns: the number of messages in this packet.

Definition at line 741 of file packetbb.cc.

References m_messageList, and NS_LOG_FUNCTION.

Referenced by operator==().

Here is the caller graph for this function:

bool ns3::PbbPacket::operator!= ( const PbbPacket & other ) const

Definition at line 1017 of file packetbb.cc.

bool ns3::PbbPacket::operator== ( const PbbPacket & other ) const

Definition at line 975 of file packetbb.cc.

References GetSequenceNumber(), GetVersion(), HasSequenceNumber(), m_tlvList, MessageBegin(), MessageEnd(), and MessageSize().

Here is the call graph for this function:

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

virtual

Pretty-prints the contents of this block.

Parameters

os	a stream object to print to.

Implements ns3::Header.

Definition at line 950 of file packetbb.cc.

References GetSequenceNumber(), HasSequenceNumber(), m_tlvList, MessageBegin(), MessageEnd(), NS_LOG_FUNCTION, and ns3::PbbTlvBlock::Print().

Here is the call graph for this function:

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

virtual

Serializes this packet into the specified buffer.

Parameters

start a reference to the point in a buffer to begin serializing.

Implements ns3::Header.

Definition at line 881 of file packetbb.cc.

References GetSequenceNumber(), HasSequenceNumber(), m_tlvList, MessageBegin(), MessageEnd(), ns3::Buffer::Iterator::Next(), NS_LOG_FUNCTION, PHAS_SEQ_NUM, PHAS_TLV, ns3::PbbTlvBlock::Serialize(), visualizer.core::start(), TlvEmpty(), VERSION, ns3::Buffer::Iterator::WriteHtonU16(), and ns3::Buffer::Iterator::WriteU8().

Referenced by PbbTestCase::TestSerialize().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::PbbPacket::SetSequenceNumber ( uint16_t number )

Sets the sequence number of this packet.

Parameters

number the sequence number.

Definition at line 567 of file packetbb.cc.

References m_hasseqnum, m_seqnum, and NS_LOG_FUNCTION.

Referenced by Deserialize(), and PbbTestSuite::PbbTestSuite().

Here is the caller graph for this function:

Ptr< PbbTlv > ns3::PbbPacket::TlvBack ( void )

Returns: a smart pointer to the last packet TLV in this packet.

Definition at line 648 of file packetbb.cc.

References ns3::PbbTlvBlock::Back(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

const Ptr< PbbTlv > ns3::PbbPacket::TlvBack ( void ) const

Returns: a const smart pointer to the last packet TLV in this packet.

Definition at line 655 of file packetbb.cc.

References ns3::PbbTlvBlock::Back(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

PbbPacket::TlvIterator ns3::PbbPacket::TlvBegin ( void )

Returns: an iterator to the first Packet TLV in this packet.

Definition at line 592 of file packetbb.cc.

References ns3::PbbTlvBlock::Begin(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

PbbPacket::ConstTlvIterator ns3::PbbPacket::TlvBegin ( void ) const

Returns: a const iterator to the first Packet TLV in this packet.

Definition at line 599 of file packetbb.cc.

References ns3::PbbTlvBlock::Begin(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

void ns3::PbbPacket::TlvClear ( void )

Removes all packet TLVs from this packet.

Definition at line 704 of file packetbb.cc.

References ns3::PbbTlvBlock::Clear(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

bool ns3::PbbPacket::TlvEmpty ( void ) const

Returns: true if there are no packet TLVs in this packet, false otherwise.

Definition at line 627 of file packetbb.cc.

References ns3::PbbTlvBlock::Empty(), m_tlvList, and NS_LOG_FUNCTION.

Referenced by GetSerializedSize(), and Serialize().

Here is the call graph for this function:

Here is the caller graph for this function:

PbbPacket::TlvIterator ns3::PbbPacket::TlvEnd ( void )

Returns: an iterator to the past-the-end element in this packet TLV block.

Definition at line 606 of file packetbb.cc.

References ns3::PbbTlvBlock::End(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

PbbPacket::ConstTlvIterator ns3::PbbPacket::TlvEnd ( void ) const

Returns: a const iterator to the past-the-end element in this packet TLV block.

Definition at line 613 of file packetbb.cc.

References ns3::PbbTlvBlock::End(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

Ptr< PbbTlv > ns3::PbbPacket::TlvFront ( void )

Returns: a smart pointer to the first packet TLV in this packet.

Definition at line 634 of file packetbb.cc.

References ns3::PbbTlvBlock::Front(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

const Ptr< PbbTlv > ns3::PbbPacket::TlvFront ( void ) const

Returns: a const smart pointer to the first packet TLV in this packet.

Definition at line 641 of file packetbb.cc.

References ns3::PbbTlvBlock::Front(), m_tlvList, and NS_LOG_FUNCTION.

Here is the call graph for this function:

void ns3::PbbPacket::TlvPopBack ( void )

Removes a packet TLV from the back of this block.

Definition at line 683 of file packetbb.cc.

References m_tlvList, NS_LOG_FUNCTION, and ns3::PbbTlvBlock::PopBack().

Here is the call graph for this function:

void ns3::PbbPacket::TlvPopFront ( void )

Removes a packet TLV from the front of this packet.

Definition at line 669 of file packetbb.cc.

References m_tlvList, NS_LOG_FUNCTION, and ns3::PbbTlvBlock::PopFront().

Here is the call graph for this function:

void ns3::PbbPacket::TlvPushBack ( Ptr< PbbTlv > tlv )

Appends a packet TLV to the back of this packet.

Parameters

tlv	a smart pointer to the packet TLV to append.

Definition at line 676 of file packetbb.cc.

References m_tlvList, NS_LOG_FUNCTION, and ns3::PbbTlvBlock::PushBack().

Referenced by PbbTestSuite::PbbTestSuite().

Here is the call graph for this function:

Here is the caller graph for this function:

void ns3::PbbPacket::TlvPushFront ( Ptr< PbbTlv > tlv )

Prepends a packet TLV to the front of this packet.

Parameters

tlv	a smart pointer to the packet TLV to prepend.

Definition at line 662 of file packetbb.cc.

References m_tlvList, NS_LOG_FUNCTION, and ns3::PbbTlvBlock::PushFront().

Here is the call graph for this function:

int ns3::PbbPacket::TlvSize ( void ) const

Returns: the number of packet TLVs in this packet.

Definition at line 620 of file packetbb.cc.

References m_tlvList, NS_LOG_FUNCTION, and ns3::PbbTlvBlock::Size().

Here is the call graph for this function:

Member Data Documentation

bool ns3::PbbPacket::m_hasseqnum

private

Definition at line 641 of file packetbb.h.

Referenced by HasSequenceNumber(), PbbPacket(), and SetSequenceNumber().

std::list< Ptr<PbbMessage> > ns3::PbbPacket::m_messageList

private

Definition at line 637 of file packetbb.h.

Referenced by MessageBack(), MessageBegin(), MessageClear(), MessageEmpty(), MessageEnd(), MessageFront(), MessagePopBack(), MessagePopFront(), MessagePushBack(), MessagePushFront(), and MessageSize().

uint16_t ns3::PbbPacket::m_seqnum

private

Definition at line 642 of file packetbb.h.

Referenced by GetSequenceNumber(), and SetSequenceNumber().

PbbTlvBlock ns3::PbbPacket::m_tlvList

private

Definition at line 636 of file packetbb.h.

Referenced by Deserialize(), Erase(), GetSerializedSize(), operator==(), Print(), Serialize(), TlvBack(), TlvBegin(), TlvClear(), TlvEmpty(), TlvEnd(), TlvFront(), TlvPopBack(), TlvPopFront(), TlvPushBack(), TlvPushFront(), and TlvSize().

uint8_t ns3::PbbPacket::m_version

private

Definition at line 639 of file packetbb.h.

Referenced by Deserialize(), GetVersion(), and PbbPacket().

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

src/network/utils/packetbb.h
src/network/utils/packetbb.cc

Public Types

Public Member Functions

Static Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation