A Discrete-Event Network Simulator
API
ns3::WifiActionHeader Class Reference

See IEEE 802.11 chapter 7.3.1.11 Header format: | category: 1 | action value: 1 |. More...

#include "mgt-headers.h"

+ Inheritance diagram for ns3::WifiActionHeader:
+ Collaboration diagram for ns3::WifiActionHeader:

Classes

union  ActionValue
 typedef for union of different ActionValues More...
 

Public Types

enum  BlockAckActionValue { BLOCK_ACK_ADDBA_REQUEST = 0 , BLOCK_ACK_ADDBA_RESPONSE = 1 , BLOCK_ACK_DELBA = 2 }
 Block Ack Action field values See 802.11 Table 8-202. More...
 
enum  CategoryValue {
  QOS = 1 , BLOCK_ACK = 3 , PUBLIC = 4 , RADIO_MEASUREMENT = 5 ,
  MESH = 13 , MULTIHOP = 14 , SELF_PROTECTED = 15 , DMG = 16 ,
  FST = 18 , UNPROTECTED_DMG = 20 , VENDOR_SPECIFIC_ACTION = 127
}
 CategoryValue enumeration. More...
 
enum  DmgActionValue {
  DMG_POWER_SAVE_CONFIGURATION_REQUEST = 0 , DMG_POWER_SAVE_CONFIGURATION_RESPONSE = 1 , DMG_INFORMATION_REQUEST = 2 , DMG_INFORMATION_RESPONSE = 3 ,
  DMG_HANDOVER_REQUEST = 4 , DMG_HANDOVER_RESPONSE = 5 , DMG_DTP_REQUEST = 6 , DMG_DTP_RESPONSE = 7 ,
  DMG_RELAY_SEARCH_REQUEST = 8 , DMG_RELAY_SEARCH_RESPONSE = 9 , DMG_MULTI_RELAY_CHANNEL_MEASUREMENT_REQUEST = 10 , DMG_MULTI_RELAY_CHANNEL_MEASUREMENT_REPORT = 11 ,
  DMG_RLS_REQUEST = 12 , DMG_RLS_RESPONSE = 13 , DMG_RLS_ANNOUNCEMENT = 14 , DMG_RLS_TEARDOWN = 15 ,
  DMG_RELAY_ACK_REQUEST = 16 , DMG_RELAY_ACK_RESPONSE = 17 , DMG_TPA_REQUEST = 18 , DMG_TPA_RESPONSE = 19 ,
  DMG_TPA_REPORT = 20 , DMG_ROC_REQUEST = 21 , DMG_ROC_RESPONSE = 22
}
 DMG Action field values See 802.11ad Table 8-281b. More...
 
enum  FstActionValue {
  FST_SETUP_REQUEST = 0 , FST_SETUP_RESPONSE = 1 , FST_TEAR_DOWN = 2 , FST_ACK_REQUEST = 3 ,
  FST_ACK_RESPONSE = 4 , ON_CHANNEL_TUNNEL_REQUEST = 5
}
 FST Action field values See 802.11ad Table 8-281x. More...
 
enum  MeshActionValue {
  LINK_METRIC_REPORT = 0 , PATH_SELECTION = 1 , PORTAL_ANNOUNCEMENT = 2 , CONGESTION_CONTROL_NOTIFICATION = 3 ,
  MDA_SETUP_REQUEST , MDA_SETUP_REPLY , MDAOP_ADVERTISMENT_REQUEST , MDAOP_ADVERTISMENTS = 7 ,
  MDAOP_SET_TEARDOWN = 8 , TBTT_ADJUSTMENT_REQUEST = 9 , TBTT_ADJUSTMENT_RESPONSE = 10
}
 MeshActionValue enumeration. More...
 
enum  MultihopActionValue { PROXY_UPDATE = 0 , PROXY_UPDATE_CONFIRMATION = 1 }
 MultihopActionValue enumeration. More...
 
enum  PublicActionValue { QAB_REQUEST = 16 , QAB_RESPONSE = 17 }
 PublicActionValue enumeration. More...
 
enum  QosActionValue {
  ADDTS_REQUEST = 0 , ADDTS_RESPONSE = 1 , DELTS = 2 , SCHEDULE = 3 ,
  QOS_MAP_CONFIGURE = 4
}
 QosActionValue enumeration. More...
 
enum  RadioMeasurementActionValue {
  RADIO_MEASUREMENT_REQUEST = 0 , RADIO_MEASUREMENT_REPORT = 1 , LINK_MEASUREMENT_REQUEST = 2 , LINK_MEASUREMENT_REPORT = 3 ,
  NEIGHBOR_REPORT_REQUEST = 4 , NEIGHBOR_REPORT_RESPONSE = 5
}
 RadioMeasurementActionValue enumeration. More...
 
enum  SelfProtectedActionValue {
  PEER_LINK_OPEN = 1 , PEER_LINK_CONFIRM = 2 , PEER_LINK_CLOSE = 3 , GROUP_KEY_INFORM = 4 ,
  GROUP_KEY_ACK = 5
}
 SelfProtectedActionValue enumeration. More...
 
enum  UnprotectedDmgActionValue {
  UNPROTECTED_DMG_ANNOUNCE = 0 , UNPROTECTED_DMG_BRP = 1 , UNPROTECTED_MIMO_BF_SETUP = 2 , UNPROTECTED_MIMO_BF_POLL = 3 ,
  UNPROTECTED_MIMO_BF_FEEDBACK = 4 , UNPROTECTED_MIMO_BF_SELECTION = 5
}
 Unprotected DMG action field values See 802.11ad Table 8-281ae. More...
 

Public Member Functions

 WifiActionHeader ()
 
 ~WifiActionHeader () override
 
uint32_t Deserialize (Buffer::Iterator start) override
 
ActionValue GetAction () const
 Return the action value. More...
 
CategoryValue GetCategory () const
 Return the category value. More...
 
TypeId GetInstanceTypeId () const override
 Get the most derived TypeId for this Object. More...
 
uint32_t GetSerializedSize () const override
 
void Print (std::ostream &os) const override
 
void Serialize (Buffer::Iterator start) const override
 
void SetAction (CategoryValue type, ActionValue action)
 Set action for this Action header. 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 ()
 Register this type. 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 Member Functions

std::string CategoryValueToString (CategoryValue value) const
 Category value to string function. More...
 
std::string SelfProtectedActionValueToString (SelfProtectedActionValue value) const
 Self protected action value to string function. More...
 

Private Attributes

uint8_t m_actionValue
 Action value. More...
 
uint8_t m_category
 Category of the action. 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...
 

Detailed Description

See IEEE 802.11 chapter 7.3.1.11 Header format: | category: 1 | action value: 1 |.

Definition at line 1278 of file mgt-headers.h.

Member Enumeration Documentation

◆ BlockAckActionValue

Block Ack Action field values See 802.11 Table 8-202.

Enumerator
BLOCK_ACK_ADDBA_REQUEST 
BLOCK_ACK_ADDBA_RESPONSE 
BLOCK_ACK_DELBA 

Definition at line 1321 of file mgt-headers.h.

◆ CategoryValue

CategoryValue enumeration.

Enumerator
QOS 
BLOCK_ACK 
PUBLIC 
RADIO_MEASUREMENT 
MESH 
MULTIHOP 
SELF_PROTECTED 
DMG 
FST 
UNPROTECTED_DMG 
VENDOR_SPECIFIC_ACTION 

Definition at line 1290 of file mgt-headers.h.

◆ DmgActionValue

DMG Action field values See 802.11ad Table 8-281b.

Enumerator
DMG_POWER_SAVE_CONFIGURATION_REQUEST 
DMG_POWER_SAVE_CONFIGURATION_RESPONSE 
DMG_INFORMATION_REQUEST 
DMG_INFORMATION_RESPONSE 
DMG_HANDOVER_REQUEST 
DMG_HANDOVER_RESPONSE 
DMG_DTP_REQUEST 
DMG_DTP_RESPONSE 
DMG_RELAY_SEARCH_REQUEST 
DMG_RELAY_SEARCH_RESPONSE 
DMG_MULTI_RELAY_CHANNEL_MEASUREMENT_REQUEST 
DMG_MULTI_RELAY_CHANNEL_MEASUREMENT_REPORT 
DMG_RLS_REQUEST 
DMG_RLS_RESPONSE 
DMG_RLS_ANNOUNCEMENT 
DMG_RLS_TEARDOWN 
DMG_RELAY_ACK_REQUEST 
DMG_RELAY_ACK_RESPONSE 
DMG_TPA_REQUEST 
DMG_TPA_RESPONSE 
DMG_TPA_REPORT 
DMG_ROC_REQUEST 
DMG_ROC_RESPONSE 

Definition at line 1386 of file mgt-headers.h.

◆ FstActionValue

FST Action field values See 802.11ad Table 8-281x.

Enumerator
FST_SETUP_REQUEST 
FST_SETUP_RESPONSE 
FST_TEAR_DOWN 
FST_ACK_REQUEST 
FST_ACK_RESPONSE 
ON_CHANNEL_TUNNEL_REQUEST 

Definition at line 1417 of file mgt-headers.h.

◆ MeshActionValue

MeshActionValue enumeration.

Enumerator
LINK_METRIC_REPORT 
PATH_SELECTION 
PORTAL_ANNOUNCEMENT 
CONGESTION_CONTROL_NOTIFICATION 
MDA_SETUP_REQUEST 
MDA_SETUP_REPLY 
MDAOP_ADVERTISMENT_REQUEST 
MDAOP_ADVERTISMENTS 
MDAOP_SET_TEARDOWN 
TBTT_ADJUSTMENT_REQUEST 
TBTT_ADJUSTMENT_RESPONSE 

Definition at line 1347 of file mgt-headers.h.

◆ MultihopActionValue

MultihopActionValue enumeration.

Enumerator
PROXY_UPDATE 
PROXY_UPDATE_CONFIRMATION 

Definition at line 1366 of file mgt-headers.h.

◆ PublicActionValue

PublicActionValue enumeration.

Enumerator
QAB_REQUEST 
QAB_RESPONSE 

Definition at line 1329 of file mgt-headers.h.

◆ QosActionValue

QosActionValue enumeration.

Enumerator
ADDTS_REQUEST 
ADDTS_RESPONSE 
DELTS 
SCHEDULE 
QOS_MAP_CONFIGURE 

Definition at line 1308 of file mgt-headers.h.

◆ RadioMeasurementActionValue

RadioMeasurementActionValue enumeration.

Enumerator
RADIO_MEASUREMENT_REQUEST 
RADIO_MEASUREMENT_REPORT 
LINK_MEASUREMENT_REQUEST 
LINK_MEASUREMENT_REPORT 
NEIGHBOR_REPORT_REQUEST 
NEIGHBOR_REPORT_RESPONSE 

Definition at line 1336 of file mgt-headers.h.

◆ SelfProtectedActionValue

SelfProtectedActionValue enumeration.

Enumerator
PEER_LINK_OPEN 
PEER_LINK_CONFIRM 
PEER_LINK_CLOSE 
GROUP_KEY_INFORM 
GROUP_KEY_ACK 

Definition at line 1373 of file mgt-headers.h.

◆ UnprotectedDmgActionValue

Unprotected DMG action field values See 802.11ad Table 8-281ae.

Enumerator
UNPROTECTED_DMG_ANNOUNCE 
UNPROTECTED_DMG_BRP 
UNPROTECTED_MIMO_BF_SETUP 
UNPROTECTED_MIMO_BF_POLL 
UNPROTECTED_MIMO_BF_FEEDBACK 
UNPROTECTED_MIMO_BF_SELECTION 

Definition at line 1431 of file mgt-headers.h.

Constructor & Destructor Documentation

◆ WifiActionHeader()

ns3::WifiActionHeader::WifiActionHeader ( )

Definition at line 2129 of file mgt-headers.cc.

◆ ~WifiActionHeader()

ns3::WifiActionHeader::~WifiActionHeader ( )
override

Definition at line 2133 of file mgt-headers.cc.

Member Function Documentation

◆ CategoryValueToString()

std::string ns3::WifiActionHeader::CategoryValueToString ( CategoryValue  value) const
private

Category value to string function.

Parameters
valuethe category value
Returns
the category value string

Definition at line 2549 of file mgt-headers.cc.

References BLOCK_ACK, DMG, FST, MESH, MULTIHOP, PUBLIC, QOS, RADIO_MEASUREMENT, SELF_PROTECTED, UNPROTECTED_DMG, second::value, and VENDOR_SPECIFIC_ACTION.

Referenced by Print().

+ Here is the caller graph for this function:

◆ Deserialize()

uint32_t ns3::WifiActionHeader::Deserialize ( Buffer::Iterator  start)
overridevirtual
Parameters
startan iterator which points to where the header should read from.
Returns
the number of bytes read.

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 2634 of file mgt-headers.cc.

References ns3::Buffer::Iterator::GetDistanceFrom(), m_actionValue, m_category, ns3::Buffer::Iterator::ReadU8(), and two-ray-to-three-gpp-ch-calibration::start.

+ Here is the call graph for this function:

◆ GetAction()

WifiActionHeader::ActionValue ns3::WifiActionHeader::GetAction ( ) const

Return the action value.

Returns
ActionValue

Definition at line 2224 of file mgt-headers.cc.

References ADDTS_REQUEST, ADDTS_RESPONSE, BLOCK_ACK, BLOCK_ACK_ADDBA_REQUEST, BLOCK_ACK_ADDBA_RESPONSE, BLOCK_ACK_DELBA, ns3::WifiActionHeader::ActionValue::blockAck, CONGESTION_CONTROL_NOTIFICATION, DELTS, DMG, DMG_DTP_REQUEST, DMG_DTP_RESPONSE, DMG_HANDOVER_REQUEST, DMG_HANDOVER_RESPONSE, DMG_INFORMATION_REQUEST, DMG_INFORMATION_RESPONSE, DMG_MULTI_RELAY_CHANNEL_MEASUREMENT_REPORT, DMG_MULTI_RELAY_CHANNEL_MEASUREMENT_REQUEST, DMG_POWER_SAVE_CONFIGURATION_REQUEST, DMG_POWER_SAVE_CONFIGURATION_RESPONSE, DMG_RELAY_ACK_REQUEST, DMG_RELAY_ACK_RESPONSE, DMG_RELAY_SEARCH_REQUEST, DMG_RELAY_SEARCH_RESPONSE, DMG_RLS_ANNOUNCEMENT, DMG_RLS_REQUEST, DMG_RLS_RESPONSE, DMG_RLS_TEARDOWN, DMG_ROC_REQUEST, DMG_ROC_RESPONSE, DMG_TPA_REQUEST, DMG_TPA_RESPONSE, ns3::WifiActionHeader::ActionValue::dmgAction, FST, FST_ACK_REQUEST, FST_ACK_RESPONSE, FST_SETUP_REQUEST, FST_SETUP_RESPONSE, FST_TEAR_DOWN, ns3::WifiActionHeader::ActionValue::fstAction, GROUP_KEY_ACK, GROUP_KEY_INFORM, LINK_MEASUREMENT_REPORT, LINK_MEASUREMENT_REQUEST, LINK_METRIC_REPORT, m_actionValue, m_category, MDA_SETUP_REPLY, MDA_SETUP_REQUEST, MDAOP_ADVERTISMENT_REQUEST, MDAOP_ADVERTISMENTS, MDAOP_SET_TEARDOWN, MESH, ns3::WifiActionHeader::ActionValue::meshAction, MULTIHOP, ns3::WifiActionHeader::ActionValue::multihopAction, NEIGHBOR_REPORT_REQUEST, NEIGHBOR_REPORT_RESPONSE, NS_FATAL_ERROR, ON_CHANNEL_TUNNEL_REQUEST, PATH_SELECTION, PEER_LINK_CLOSE, PEER_LINK_CONFIRM, PEER_LINK_OPEN, PORTAL_ANNOUNCEMENT, PROXY_UPDATE, PROXY_UPDATE_CONFIRMATION, PUBLIC, ns3::WifiActionHeader::ActionValue::publicAction, QAB_REQUEST, QAB_RESPONSE, QOS, ns3::WifiActionHeader::ActionValue::qos, QOS_MAP_CONFIGURE, RADIO_MEASUREMENT, RADIO_MEASUREMENT_REPORT, RADIO_MEASUREMENT_REQUEST, ns3::WifiActionHeader::ActionValue::radioMeasurementAction, SCHEDULE, SELF_PROTECTED, ns3::WifiActionHeader::ActionValue::selfProtectedAction, TBTT_ADJUSTMENT_REQUEST, TBTT_ADJUSTMENT_RESPONSE, UNPROTECTED_DMG, UNPROTECTED_DMG_ANNOUNCE, UNPROTECTED_DMG_BRP, UNPROTECTED_MIMO_BF_FEEDBACK, UNPROTECTED_MIMO_BF_POLL, UNPROTECTED_MIMO_BF_SELECTION, UNPROTECTED_MIMO_BF_SETUP, and ns3::WifiActionHeader::ActionValue::unprotectedDmgAction.

Referenced by ns3::GetTid(), ns3::HtFrameExchangeManager::NotifyPacketDiscarded(), ns3::HtFrameExchangeManager::NotifyReceivedNormalAck(), ns3::WifiMac::Receive(), and ns3::dot11s::PeerManagementProtocolMac::Receive().

+ Here is the caller graph for this function:

◆ GetCategory()

◆ GetInstanceTypeId()

TypeId ns3::WifiActionHeader::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.

Implements ns3::ObjectBase.

Definition at line 2543 of file mgt-headers.cc.

References GetTypeId().

+ Here is the call graph for this function:

◆ GetSerializedSize()

uint32_t ns3::WifiActionHeader::GetSerializedSize ( ) const
overridevirtual
Returns
the expected size of the header.

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 2621 of file mgt-headers.cc.

◆ GetTypeId()

TypeId ns3::WifiActionHeader::GetTypeId ( )
static

Register this type.

Returns
The TypeId.

Definition at line 2533 of file mgt-headers.cc.

References ns3::TypeId::SetParent().

Referenced by GetInstanceTypeId().

+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ Print()

void ns3::WifiActionHeader::Print ( std::ostream &  os) const
overridevirtual
Parameters
osoutput 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 2614 of file mgt-headers.cc.

References CategoryValueToString(), m_actionValue, m_category, and SelfProtectedActionValueToString().

+ Here is the call graph for this function:

◆ SelfProtectedActionValueToString()

std::string ns3::WifiActionHeader::SelfProtectedActionValueToString ( SelfProtectedActionValue  value) const
private

Self protected action value to string function.

Parameters
valuethe protected action value
Returns
the self protected action value string

Definition at line 2583 of file mgt-headers.cc.

References GROUP_KEY_ACK, GROUP_KEY_INFORM, PEER_LINK_CLOSE, PEER_LINK_CONFIRM, PEER_LINK_OPEN, and second::value.

Referenced by Print().

+ Here is the caller graph for this function:

◆ Serialize()

void ns3::WifiActionHeader::Serialize ( Buffer::Iterator  start) const
overridevirtual
Parameters
startan 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 2627 of file mgt-headers.cc.

References m_actionValue, m_category, and two-ray-to-three-gpp-ch-calibration::start.

◆ SetAction()

Member Data Documentation

◆ m_actionValue

uint8_t ns3::WifiActionHeader::m_actionValue
private

Action value.

Definition at line 1503 of file mgt-headers.h.

Referenced by Deserialize(), GetAction(), Print(), Serialize(), and SetAction().

◆ m_category

uint8_t ns3::WifiActionHeader::m_category
private

Category of the action.

Definition at line 1502 of file mgt-headers.h.

Referenced by Deserialize(), GetAction(), GetCategory(), Print(), Serialize(), and SetAction().


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