Determine which packets are errored corresponding to an underlying distribution, rate, and unit. More...
#include "error-model.h"
Public Types | |
enum | ErrorUnit { ERROR_UNIT_BIT , ERROR_UNIT_BYTE , ERROR_UNIT_PACKET } |
Error unit. More... | |
Public Member Functions | |
RateErrorModel () | |
virtual | ~RateErrorModel () |
int64_t | AssignStreams (int64_t stream) |
Assign a fixed random variable stream number to the random variables used by this model. More... | |
double | GetRate (void) const |
RateErrorModel::ErrorUnit | GetUnit (void) const |
void | SetRandomVariable (Ptr< RandomVariableStream >) |
void | SetRate (double rate) |
void | SetUnit (enum ErrorUnit error_unit) |
Public Member Functions inherited from ns3::ErrorModel | |
ErrorModel () | |
virtual | ~ErrorModel () |
void | Disable (void) |
Disable the error model. More... | |
void | Enable (void) |
Enable the error model. More... | |
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. More... | |
bool | IsEnabled (void) const |
void | Reset (void) |
Reset any state associated with the error model. More... | |
Public Member Functions inherited from ns3::Object | |
Object () | |
Constructor. More... | |
virtual | ~Object () |
Destructor. More... | |
void | AggregateObject (Ptr< Object > other) |
Aggregate two Objects together. More... | |
void | Dispose (void) |
Dispose of this Object. More... | |
AggregateIterator | GetAggregateIterator (void) const |
Get an iterator to the Objects aggregated to this one. More... | |
virtual TypeId | GetInstanceTypeId (void) const |
Get the most derived TypeId for this Object. More... | |
template<> | |
Ptr< Object > | GetObject () const |
Specialization of () for objects of type ns3::Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (TypeId tid) const |
Get a pointer to the requested aggregated Object by TypeId. More... | |
template<> | |
Ptr< Object > | GetObject (TypeId tid) const |
Specialization of (TypeId tid) for objects of type ns3::Object. More... | |
template<typename T > | |
Ptr< T > | GetObject (void) const |
Get a pointer to the requested aggregated Object. More... | |
void | Initialize (void) |
Invoke DoInitialize on all Objects aggregated to this one. More... | |
bool | IsInitialized (void) const |
Check if the object has been initialized. More... | |
Public Member Functions inherited from ns3::SimpleRefCount< Object, ObjectBase, ObjectDeleter > | |
SimpleRefCount () | |
Default constructor. More... | |
SimpleRefCount (const SimpleRefCount &o[[maybe_unused]]) | |
Copy constructor. More... | |
uint32_t | GetReferenceCount (void) const |
Get the reference count of the object. More... | |
SimpleRefCount & | operator= ([[maybe_unused]] const SimpleRefCount &o) |
Assignment operator. More... | |
void | Ref (void) const |
Increment the reference count. More... | |
void | Unref (void) const |
Decrement the reference count. 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 erros. 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 (void) |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::ErrorModel | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Static Public Member Functions inherited from ns3::Object | |
static TypeId | GetTypeId (void) |
Register this type. More... | |
Static Public Member Functions inherited from ns3::ObjectBase | |
static TypeId | GetTypeId (void) |
Get the type ID. More... | |
Private Member Functions | |
virtual bool | DoCorrupt (Ptr< Packet > p) |
Corrupt a packet according to the specified model. More... | |
virtual bool | DoCorruptBit (Ptr< Packet > p) |
Corrupt a packet (bit unit). More... | |
virtual bool | DoCorruptByte (Ptr< Packet > p) |
Corrupt a packet (Byte unit). More... | |
virtual bool | DoCorruptPkt (Ptr< Packet > p) |
Corrupt a packet (packet unit). More... | |
virtual void | DoReset (void) |
Re-initialize any state. More... | |
Private Attributes | |
Ptr< RandomVariableStream > | m_ranvar |
rng stream More... | |
double | m_rate |
Error rate. More... | |
enum ErrorUnit | m_unit |
Error rate unit. More... | |
Additional Inherited Members | |
Protected Member Functions inherited from ns3::Object | |
Object (const Object &o) | |
Copy an Object. More... | |
virtual void | DoDispose (void) |
Destructor implementation. More... | |
virtual void | DoInitialize (void) |
Initialize() implementation. More... | |
virtual void | NotifyNewAggregate (void) |
Notify all Objects aggregated to this one of a new Object being aggregated. More... | |
Protected Member Functions inherited from ns3::ObjectBase | |
void | ConstructSelf (const AttributeConstructionList &attributes) |
Complete construction of ObjectBase; invoked by derived classes. More... | |
virtual void | NotifyConstructionCompleted (void) |
Notifier called once the ObjectBase is fully constructed. More... | |
Related Functions inherited from ns3::ObjectBase | |
static TypeId | GetObjectIid (void) |
Ensure the TypeId for ObjectBase gets fully configured to anchor the inheritance tree properly. More... | |
Determine which packets are errored corresponding to an underlying distribution, rate, and unit.
This object is used to flag packets as being lost/errored or not. The two parameters that govern the behavior are the rate (or equivalently, the mean duration/spacing between errors), and the unit (which may be per-bit, per-byte, and per-packet). Users can optionally provide a RandomVariableStream object; the default is to use a Uniform(0,1) distribution.
Reset() on this model will do nothing
IsCorrupt() will not modify the packet data buffer
ns3::RateErrorModel is accessible through the following paths with Config::Set and Config::Connect:
No TraceSources are defined for this type.
Size of this type is 56 bytes (on a 64-bit architecture).
Definition at line 182 of file error-model.h.
Error unit.
The error model can be packet, Byte or bit based.
Enumerator | |
---|---|
ERROR_UNIT_BIT | |
ERROR_UNIT_BYTE | |
ERROR_UNIT_PACKET |
Definition at line 197 of file error-model.h.
ns3::RateErrorModel::RateErrorModel | ( | ) |
Definition at line 176 of file error-model.cc.
References NS_LOG_FUNCTION.
|
virtual |
Definition at line 181 of file error-model.cc.
References NS_LOG_FUNCTION.
int64_t ns3::RateErrorModel::AssignStreams | ( | int64_t | stream | ) |
Assign a fixed random variable stream number to the random variables used by this model.
Return the number of streams (possibly zero) that have been assigned.
stream | first stream index to use |
Definition at line 222 of file error-model.cc.
References m_ranvar, NS_LOG_FUNCTION, and ns3::RandomVariableStream::SetStream().
Referenced by LteRlcAmE2eTestCase::DoRun().
Corrupt a packet according to the specified model.
p | the packet to corrupt |
Implements ns3::ErrorModel.
Definition at line 230 of file error-model.cc.
References DoCorruptBit(), DoCorruptByte(), DoCorruptPkt(), ERROR_UNIT_BIT, ERROR_UNIT_BYTE, ERROR_UNIT_PACKET, ns3::ErrorModel::IsEnabled(), m_unit, NS_ASSERT_MSG, and NS_LOG_FUNCTION.
Corrupt a packet (bit unit).
p | the packet to corrupt |
Definition at line 269 of file error-model.cc.
References ns3::Packet::GetSize(), ns3::RandomVariableStream::GetValue(), m_ranvar, m_rate, and NS_LOG_FUNCTION.
Referenced by DoCorrupt().
Corrupt a packet (Byte unit).
p | the packet to corrupt |
Definition at line 260 of file error-model.cc.
References ns3::Packet::GetSize(), ns3::RandomVariableStream::GetValue(), m_ranvar, m_rate, and NS_LOG_FUNCTION.
Referenced by DoCorrupt().
Corrupt a packet (packet unit).
p | the packet to corrupt |
Definition at line 253 of file error-model.cc.
References ns3::RandomVariableStream::GetValue(), m_ranvar, m_rate, and NS_LOG_FUNCTION.
Referenced by DoCorrupt().
|
privatevirtual |
Re-initialize any state.
Implements ns3::ErrorModel.
Definition at line 278 of file error-model.cc.
References NS_LOG_FUNCTION.
double ns3::RateErrorModel::GetRate | ( | void | ) | const |
Definition at line 201 of file error-model.cc.
References m_rate, and NS_LOG_FUNCTION.
|
static |
Get the type ID.
Definition at line 151 of file error-model.cc.
References ERROR_UNIT_BIT, ERROR_UNIT_BYTE, ERROR_UNIT_PACKET, m_ranvar, m_rate, m_unit, ns3::MakeDoubleAccessor(), ns3::MakeEnumAccessor(), ns3::MakeEnumChecker(), ns3::MakePointerAccessor(), and ns3::TypeId::SetParent().
RateErrorModel::ErrorUnit ns3::RateErrorModel::GetUnit | ( | void | ) | const |
Definition at line 187 of file error-model.cc.
References m_unit, and NS_LOG_FUNCTION.
void ns3::RateErrorModel::SetRandomVariable | ( | Ptr< RandomVariableStream > | ranvar | ) |
ranvar | A random variable distribution to generate random variates |
Definition at line 215 of file error-model.cc.
References m_ranvar, and NS_LOG_FUNCTION.
Referenced by ErrorModelSimple::DoRun().
void ns3::RateErrorModel::SetRate | ( | double | rate | ) |
rate | the error rate to be used by the model |
Definition at line 208 of file error-model.cc.
References m_rate, and NS_LOG_FUNCTION.
Referenced by ThreeGppHttpObjectTestCase::ThreeGppHttpObjectTestCase().
void ns3::RateErrorModel::SetUnit | ( | enum ErrorUnit | error_unit | ) |
error_unit | the ErrorUnit to be used by the underlying model |
Definition at line 194 of file error-model.cc.
References m_unit, and NS_LOG_FUNCTION.
Referenced by ThreeGppHttpObjectTestCase::ThreeGppHttpObjectTestCase().
|
private |
rng stream
Definition at line 262 of file error-model.h.
Referenced by AssignStreams(), DoCorruptBit(), DoCorruptByte(), DoCorruptPkt(), GetTypeId(), and SetRandomVariable().
|
private |
Error rate.
Definition at line 260 of file error-model.h.
Referenced by DoCorruptBit(), DoCorruptByte(), DoCorruptPkt(), GetRate(), GetTypeId(), and SetRate().
|
private |
Error rate unit.
Definition at line 257 of file error-model.h.
Referenced by DoCorrupt(), GetTypeId(), GetUnit(), and SetUnit().