Provide a list of Packet uids to corrupt. More...
#include "error-model.h"
Public Member Functions | |
ListErrorModel () | |
~ListErrorModel () override | |
std::list< uint64_t > | GetList () const |
void | SetList (const std::list< uint64_t > &packetlist) |
Public Member Functions inherited from ns3::ErrorModel | |
ErrorModel () | |
~ErrorModel () override | |
void | Disable () |
Disable the error model. | |
void | Enable () |
Enable the error model. | |
bool | IsCorrupt (Ptr< Packet > pkt) |
Note: Depending on the error model, this function may or may not alter the contents of the packet upon returning true. | |
bool | IsEnabled () const |
void | Reset () |
Reset any state associated with the error model. | |
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. | |
TypeId | GetInstanceTypeId () const override |
Get the most derived TypeId for this Object. | |
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 TypeId | GetTypeId () |
Get the type ID. | |
Static Public Member Functions inherited from ns3::ErrorModel | |
static TypeId | GetTypeId () |
Get the type ID. | |
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. | |
Private Types | |
typedef std::list< uint64_t > | PacketList |
Typedef: packet Uid list. | |
typedef std::list< uint64_t >::const_iterator | PacketListCI |
Typedef: packet Uid list const iterator. | |
Private Member Functions | |
bool | DoCorrupt (Ptr< Packet > p) override |
Corrupt a packet according to the specified model. | |
void | DoReset () override |
Re-initialize any state. | |
Private Attributes | |
PacketList | m_packetList |
container of Uid of packets to corrupt | |
Additional Inherited Members | |
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. | |
Provide a list of Packet uids to corrupt.
This object is used to flag packets as being lost/errored or not. A note on performance: the list is assumed to be unordered, and in general, Packet uids received may be unordered. Therefore, each call to IsCorrupt() will result in a walk of the list with the present underlying implementation.
Note also that if one wants to target multiple packets from looking at an (unerrored) trace file, the act of erroring a given packet may cause subsequent packet uids to change. For instance, suppose one wants to error packets 11 and 17 on a given device. It may be that erroring packet 11 will cause the subsequent uid stream to change and 17 may no longer correspond to the second packet that one wants to lose. Therefore, be advised that it might take some trial and error to select the right uids when multiple are provided.
Reset() on this model will clear the list
IsCorrupt() will not modify the packet data buffer
ns3::ListErrorModel is accessible through the following paths with Config::Set and Config::Connect:
No Attributes are defined for this type.
No TraceSources are defined for this type.
Group: Network
Size of this type is 80 bytes (on a 64-bit architecture).
Definition at line 366 of file error-model.h.
|
private |
Typedef: packet Uid list.
Definition at line 393 of file error-model.h.
|
private |
Typedef: packet Uid list const iterator.
Definition at line 395 of file error-model.h.
ns3::ListErrorModel::ListErrorModel | ( | ) |
Definition at line 427 of file error-model.cc.
References NS_LOG_FUNCTION.
|
override |
Definition at line 432 of file error-model.cc.
References NS_LOG_FUNCTION.
Corrupt a packet according to the specified model.
p | the packet to corrupt |
Implements ns3::ErrorModel.
Definition at line 455 of file error-model.cc.
References ns3::ErrorModel::IsEnabled(), m_packetList, and NS_LOG_FUNCTION.
|
overrideprivatevirtual |
Re-initialize any state.
Implements ns3::ErrorModel.
Definition at line 474 of file error-model.cc.
References m_packetList, and NS_LOG_FUNCTION.
std::list< uint64_t > ns3::ListErrorModel::GetList | ( | ) | const |
Definition at line 438 of file error-model.cc.
References m_packetList, and NS_LOG_FUNCTION.
|
static |
Get the type ID.
Definition at line 418 of file error-model.cc.
References ns3::TypeId::SetParent().
void ns3::ListErrorModel::SetList | ( | const std::list< uint64_t > & | packetlist | ) |
packetlist | The list of packet uids to error. |
This method overwrites any previously provided list.
Definition at line 445 of file error-model.cc.
References m_packetList, and NS_LOG_FUNCTION.
Referenced by EmlsrDlTxopTest::CheckBlockAck(), EmlsrUlTxopTest::CheckCtsFrames(), EmlsrLinkSwitchTest::CheckRtsFrame(), EmlsrUlTxopTest::CheckRtsFrames(), WifiRetransmitTest::SetEvents(), EmlOmnExchangeTest::Transmit(), OrigBlockAckWindowStalled::Transmit(), ReleaseSeqNoAfterCtsTimeoutTest::Transmit(), and WifiTxopTest::Transmit().
|
private |
container of Uid of packets to corrupt
Definition at line 397 of file error-model.h.
Referenced by DoCorrupt(), DoReset(), GetList(), and SetList().