A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ns3::BlockAckManager Class Reference

Manages all block ack agreements for an originator station. More...

#include <block-ack-manager.h>

+ Collaboration diagram for ns3::BlockAckManager:

Classes

struct  Item
 A struct for packet, Wifi header, and timestamp. More...
 

Public Member Functions

 BlockAckManager ()
 
 ~BlockAckManager ()
 
void CreateAgreement (const MgtAddBaRequestHeader *reqHdr, Mac48Address recipient)
 
void DestroyAgreement (Mac48Address recipient, uint8_t tid)
 
bool ExistsAgreement (Mac48Address recipient, uint8_t tid) const
 
bool ExistsAgreementInState (Mac48Address recipient, uint8_t tid, enum OriginatorBlockAckAgreement::State state) const
 
uint32_t GetNBufferedPackets (Mac48Address recipient, uint8_t tid) const
 
Ptr< const PacketGetNextPacket (WifiMacHeader &hdr)
 
uint32_t GetNextPacketSize (void) const
 
uint32_t GetNRetryNeededPackets (Mac48Address recipient, uint8_t tid) const
 
uint16_t GetSeqNumOfNextRetryPacket (Mac48Address recipient, uint8_t tid) const
 
bool HasBar (struct Bar &bar)
 
bool HasOtherFragments (uint16_t sequenceNumber) const
 
bool HasPackets (void) const
 Returns true if there are packets that need of retransmission or at least a BAR is scheduled. More...
 
void NotifyAgreementEstablished (Mac48Address recipient, uint8_t tid, uint16_t startingSeq)
 
void NotifyAgreementUnsuccessful (Mac48Address recipient, uint8_t tid)
 
void NotifyGotBlockAck (const CtrlBAckResponseHeader *blockAck, Mac48Address recipient)
 
void NotifyMpduTransmission (Mac48Address recipient, uint8_t tid, uint16_t nextSeqNumber)
 
void SetBlockAckInactivityCallback (Callback< void, Mac48Address, uint8_t, bool > callback)
 
void SetBlockAckThreshold (uint8_t nPackets)
 
void SetBlockAckType (enum BlockAckType bAckType)
 
void SetBlockDestinationCallback (Callback< void, Mac48Address, uint8_t > callback)
 
void SetMaxPacketDelay (Time maxDelay)
 
void SetQueue (Ptr< WifiMacQueue > queue)
 
void SetTxMiddle (MacTxMiddle *txMiddle)
 
void SetUnblockDestinationCallback (Callback< void, Mac48Address, uint8_t > callback)
 
void StorePacket (Ptr< const Packet > packet, const WifiMacHeader &hdr, Time tStamp)
 
bool SwitchToBlockAckIfNeeded (Mac48Address recipient, uint8_t tid, uint16_t startingSeq)
 
void TearDownBlockAck (Mac48Address recipient, uint8_t tid)
 
void UpdateAgreement (const MgtAddBaResponseHeader *respHdr, Mac48Address recipient)
 

Private Types

typedef std::map< std::pair
< Mac48Address, uint8_t >
, std::pair
< OriginatorBlockAckAgreement,
PacketQueue > > 
Agreements
 typedef for a map between MAC address and block ACK agreement. More...
 
typedef std::map< std::pair
< Mac48Address, uint8_t >
, std::pair
< OriginatorBlockAckAgreement,
PacketQueue >
>::const_iterator 
AgreementsCI
 typedef for a const iterator for Agreements. More...
 
typedef std::map< std::pair
< Mac48Address, uint8_t >
, std::pair
< OriginatorBlockAckAgreement,
PacketQueue > >::iterator 
AgreementsI
 typedef for an iterator for Agreements. More...
 
typedef std::list< ItemPacketQueue
 typedef for a list of Item struct. More...
 
typedef std::list< Item >
::const_iterator 
PacketQueueCI
 typedef for a const iterator for PacketQueue. More...
 
typedef std::list< Item >::iterator PacketQueueI
 typedef for an iterator for PacketQueue. More...
 

Private Member Functions

 BlockAckManager (const BlockAckManager &)
 
void CleanupBuffers (void)
 This method removes packets whose lifetime was exceeded. More...
 
void InactivityTimeout (Mac48Address, uint8_t)
 
BlockAckManageroperator= (const BlockAckManager &)
 
Ptr< PacketScheduleBlockAckReqIfNeeded (Mac48Address recipient, uint8_t tid)
 

Private Attributes

Mac48Address m_address
 
Agreements m_agreements
 This data structure contains, for each block ack agreement (recipient, tid), a set of packets for which an ack by block ack is requested. More...
 
std::list< Barm_bars
 
Callback< void, Mac48Address,
uint8_t, bool > 
m_blockAckInactivityTimeout
 
uint8_t m_blockAckThreshold
 
enum BlockAckType m_blockAckType
 
Callback< void, Mac48Address,
uint8_t > 
m_blockPackets
 
Time m_maxDelay
 
Ptr< WifiMacQueuem_queue
 
std::list< PacketQueueIm_retryPackets
 This list contains all iterators to stored packets that need to be retransmitted. More...
 
MacTxMiddlem_txMiddle
 
Callback< void, Mac48Address,
uint8_t > 
m_unblockPackets
 

Detailed Description

Manages all block ack agreements for an originator station.

Definition at line 73 of file block-ack-manager.h.

Member Typedef Documentation

typedef std::map<std::pair<Mac48Address, uint8_t>, std::pair<OriginatorBlockAckAgreement, PacketQueue> > ns3::BlockAckManager::Agreements
private

typedef for a map between MAC address and block ACK agreement.

Definition at line 320 of file block-ack-manager.h.

typedef std::map<std::pair<Mac48Address, uint8_t>, std::pair<OriginatorBlockAckAgreement, PacketQueue> >::const_iterator ns3::BlockAckManager::AgreementsCI
private

typedef for a const iterator for Agreements.

Definition at line 330 of file block-ack-manager.h.

typedef std::map<std::pair<Mac48Address, uint8_t>, std::pair<OriginatorBlockAckAgreement, PacketQueue> >::iterator ns3::BlockAckManager::AgreementsI
private

typedef for an iterator for Agreements.

Definition at line 325 of file block-ack-manager.h.

typedef for a list of Item struct.

Definition at line 302 of file block-ack-manager.h.

typedef std::list<Item>::const_iterator ns3::BlockAckManager::PacketQueueCI
private

typedef for a const iterator for PacketQueue.

Definition at line 314 of file block-ack-manager.h.

typedef for an iterator for PacketQueue.

Definition at line 310 of file block-ack-manager.h.

Constructor & Destructor Documentation

ns3::BlockAckManager::BlockAckManager ( const BlockAckManager )
private
ns3::BlockAckManager::BlockAckManager ( )

Definition at line 65 of file block-ack-manager.cc.

References NS_LOG_FUNCTION.

ns3::BlockAckManager::~BlockAckManager ( )

Definition at line 70 of file block-ack-manager.cc.

References m_agreements, m_queue, m_retryPackets, and NS_LOG_FUNCTION.

Member Function Documentation

void ns3::BlockAckManager::CleanupBuffers ( void  )
private

This method removes packets whose lifetime was exceeded.

Definition at line 592 of file block-ack-manager.cc.

References m_agreements, m_maxDelay, m_retryPackets, ns3::Simulator::Now(), and NS_LOG_FUNCTION.

Referenced by GetNextPacket().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::BlockAckManager::CreateAgreement ( const MgtAddBaRequestHeader reqHdr,
Mac48Address  recipient 
)
Parameters
reqHdrRelative Add block ack request (action frame).
recipientAddress of peer station involved in block ack mechanism.

Creates a new block ack agreement in pending state. When a ADDBA response with a successful status code is received, the relative agreement becomes established.

Definition at line 112 of file block-ack-manager.cc.

References ns3::MgtAddBaRequestHeader::GetStartingSequence(), ns3::MgtAddBaRequestHeader::GetTid(), ns3::MgtAddBaRequestHeader::GetTimeout(), ns3::MgtAddBaRequestHeader::IsAmsduSupported(), ns3::MgtAddBaRequestHeader::IsImmediateBlockAck(), m_agreements, m_blockPackets, NS_LOG_FUNCTION, ns3::OriginatorBlockAckAgreement::PENDING, and ns3::BlockAckAgreement::SetStartingSequence().

Referenced by ns3::EdcaTxopN::SendAddBaRequest().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::BlockAckManager::DestroyAgreement ( Mac48Address  recipient,
uint8_t  tid 
)
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTid Traffic id of transmitted packet.

Invoked when a recipient reject a block ack agreement or when a Delba frame is Received/Transmitted.

Definition at line 139 of file block-ack-manager.cc.

References m_agreements, m_bars, m_retryPackets, and NS_LOG_FUNCTION.

Referenced by TearDownBlockAck().

+ Here is the caller graph for this function:

bool ns3::BlockAckManager::ExistsAgreement ( Mac48Address  recipient,
uint8_t  tid 
) const
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTraffic ID.
Returns
true if a block ack agreement exists, false otherwise

Checks if a block ack agreement exists with station addressed by recipient for tid tid.

Definition at line 79 of file block-ack-manager.cc.

References m_agreements, and NS_LOG_FUNCTION.

Referenced by GetNBufferedPackets(), GetNRetryNeededPackets(), ns3::EdcaTxopN::NotifyAccessGranted(), and SwitchToBlockAckIfNeeded().

+ Here is the caller graph for this function:

bool ns3::BlockAckManager::ExistsAgreementInState ( Mac48Address  recipient,
uint8_t  tid,
enum OriginatorBlockAckAgreement::State  state 
) const
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTraffic ID.
stateThe state for block ack agreement
Returns
true if a block ack agreement exists, false otherwise

Checks if a block ack agreement with a state equals to state exists with station addressed by recipient for tid tid.

Definition at line 86 of file block-ack-manager.cc.

References ns3::OriginatorBlockAckAgreement::ESTABLISHED, ns3::OriginatorBlockAckAgreement::INACTIVE, m_agreements, NS_FATAL_ERROR, NS_LOG_FUNCTION, ns3::OriginatorBlockAckAgreement::PENDING, and ns3::OriginatorBlockAckAgreement::UNSUCCESSFUL.

Referenced by GetNextPacket(), ns3::EdcaTxopN::GotAddBaResponse(), NotifyGotBlockAck(), SwitchToBlockAckIfNeeded(), and ns3::EdcaTxopN::VerifyBlockAck().

+ Here is the caller graph for this function:

uint32_t ns3::BlockAckManager::GetNBufferedPackets ( Mac48Address  recipient,
uint8_t  tid 
) const
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTraffic ID.
Returns
the number of packets buffered for a specified agreement

Returns number of packets buffered for a specified agreement. This methods doesn't return number of buffered MPDUs but number of buffered MSDUs.

Definition at line 280 of file block-ack-manager.cc.

References ExistsAgreement(), m_agreements, and NS_LOG_FUNCTION.

Referenced by SwitchToBlockAckIfNeeded().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Ptr< const Packet > ns3::BlockAckManager::GetNextPacket ( WifiMacHeader hdr)
Parameters
hdr802.11 header of returned packet (if exists).
Returns
the packet

This methods returns a packet (if exists) indicated as not received in corresponding block ack bitmap.

Definition at line 221 of file block-ack-manager.cc.

References ns3::WifiMacHeader::BLOCK_ACK, CleanupBuffers(), ns3::OriginatorBlockAckAgreement::ESTABLISHED, ExistsAgreementInState(), ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetQosTid(), ns3::WifiMacHeader::GetSequenceNumber(), m_agreements, m_retryPackets, ns3::WifiMacHeader::NORMAL_ACK, NS_LOG_FUNCTION, NS_LOG_INFO, ns3::WifiMacHeader::SetQosAckPolicy(), ns3::WifiMacHeader::SetRetry(), and SwitchToBlockAckIfNeeded().

Referenced by ns3::EdcaTxopN::NotifyAccessGranted().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

uint32_t ns3::BlockAckManager::GetNextPacketSize ( void  ) const
Returns
the size of the next packet that needs retransmission

Returns size of the next packet that needs retransmission.

Definition at line 579 of file block-ack-manager.cc.

References ns3::Packet::GetSize(), m_retryPackets, NS_LOG_FUNCTION, and ns3::BlockAckManager::Item::packet.

+ Here is the call graph for this function:

uint32_t ns3::BlockAckManager::GetNRetryNeededPackets ( Mac48Address  recipient,
uint8_t  tid 
) const
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTraffic ID.
Returns
the number of packets for a specific agreement that need retransmission

Returns number of packets for a specific agreement that need retransmission. This method doesn't return number of MPDUs that need retransmission but number of MSDUs.

Definition at line 305 of file block-ack-manager.cc.

References ExistsAgreement(), m_retryPackets, and NS_LOG_FUNCTION.

Referenced by NotifyMpduTransmission(), and ScheduleBlockAckReqIfNeeded().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

uint16_t ns3::BlockAckManager::GetSeqNumOfNextRetryPacket ( Mac48Address  recipient,
uint8_t  tid 
) const
Parameters
recipient
tid
Returns
the sequence number of the next retry packet for a specific agreement

Returns the sequence number of the next retry packet for a specific agreement. If there are no packets that need retransmission for the specified agreement or the agreement doesn't exist the function returns 4096;

Definition at line 669 of file block-ack-manager.cc.

References m_retryPackets, and NS_LOG_FUNCTION.

Referenced by NotifyMpduTransmission().

+ Here is the caller graph for this function:

bool ns3::BlockAckManager::HasBar ( struct Bar bar)

Definition at line 260 of file block-ack-manager.cc.

References m_bars, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::NotifyAccessGranted().

+ Here is the caller graph for this function:

bool ns3::BlockAckManager::HasOtherFragments ( uint16_t  sequenceNumber) const
Parameters
sequenceNumberSequence number of the packet which fragment is part of.
Returns
true if another fragment with the given sequence number is scheduled for retransmission.

Returns true if another fragment with sequence number sequenceNumber is scheduled for retransmission.

Definition at line 563 of file block-ack-manager.cc.

References ns3::WifiMacHeader::GetSequenceNumber(), ns3::BlockAckManager::Item::hdr, m_retryPackets, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

bool ns3::BlockAckManager::HasPackets ( void  ) const

Returns true if there are packets that need of retransmission or at least a BAR is scheduled.

Returns false otherwise.

Returns
true if there are packets that need of retransmission or at least a BAR is scheduled, false otherwise

Definition at line 273 of file block-ack-manager.cc.

References m_bars, m_retryPackets, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::NeedsAccess(), ns3::EdcaTxopN::NotifyAccessGranted(), ns3::EdcaTxopN::RestartAccessIfNeeded(), and ns3::EdcaTxopN::StartAccessIfNeeded().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::InactivityTimeout ( Mac48Address  recipient,
uint8_t  tid 
)
private

Definition at line 475 of file block-ack-manager.cc.

References m_blockAckInactivityTimeout, and NS_LOG_FUNCTION.

Referenced by NotifyGotBlockAck(), and UpdateAgreement().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::NotifyAgreementEstablished ( Mac48Address  recipient,
uint8_t  tid,
uint16_t  startingSeq 
)
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTraffic ID of transmitted packet.
startingSeqstarting sequence field

Puts corresponding agreement in established state and updates number of packets and starting sequence field. Invoked typically after a block ack refresh.

Definition at line 482 of file block-ack-manager.cc.

References ns3::OriginatorBlockAckAgreement::ESTABLISHED, m_agreements, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by SwitchToBlockAckIfNeeded().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::NotifyAgreementUnsuccessful ( Mac48Address  recipient,
uint8_t  tid 
)
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTraffic ID of transmitted packet.

Marks an agreement as unsuccessful. This happens if recipient station reject block ack setup by an ADDBAResponse frame with a failure status code. FOr now we assume that every QoS station accepts a block ack setup.

Definition at line 493 of file block-ack-manager.cc.

References m_agreements, NS_ASSERT, NS_LOG_FUNCTION, and ns3::OriginatorBlockAckAgreement::UNSUCCESSFUL.

Referenced by ns3::EdcaTxopN::GotAddBaResponse().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::NotifyGotBlockAck ( const CtrlBAckResponseHeader blockAck,
Mac48Address  recipient 
)
Parameters
blockAckThe received block ack frame.
recipientSender of block ack frame.

Invoked upon receipt of a block ack frame. Typically, this function, is called by ns3::EdcaTxopN object. Performs a check on which MPDUs, previously sent with ack policy set to Block Ack, were correctly received by the recipient. An acknowledged MPDU is removed from the buffer, retransmitted otherwise.

Definition at line 338 of file block-ack-manager.cc.

References ns3::OriginatorBlockAckAgreement::ESTABLISHED, ExistsAgreementInState(), ns3::MacTxMiddle::GetNextSeqNumberByTidAndAddress(), ns3::CtrlBAckResponseHeader::GetTidInfo(), ns3::OriginatorBlockAckAgreement::INACTIVE, InactivityTimeout(), ns3::CtrlBAckResponseHeader::IsBasic(), ns3::CtrlBAckResponseHeader::IsCompressed(), ns3::CtrlBAckResponseHeader::IsFragmentReceived(), ns3::CtrlBAckResponseHeader::IsMultiTid(), ns3::CtrlBAckResponseHeader::IsPacketReceived(), m_agreements, m_retryPackets, m_txMiddle, NS_FATAL_ERROR, NS_LOG_FUNCTION, ns3::Simulator::Schedule(), SwitchToBlockAckIfNeeded(), and timeout.

Referenced by ns3::EdcaTxopN::GotBlockAck().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::BlockAckManager::NotifyMpduTransmission ( Mac48Address  recipient,
uint8_t  tid,
uint16_t  nextSeqNumber 
)
Parameters
recipientAddress of peer station involved in block ack mechanism.
tidTraffic ID of transmitted packet.
nextSeqNumberSequence number of the next packet that would be trasmitted by EdcaTxopN.

This method is typically invoked by ns3::EdcaTxopN object every time that a MPDU with ack policy subfield in Qos Control field set to Block Ack is transmitted. The nextSeqNumber parameter is used to block transmission of packets that are out of bitmap.

Definition at line 505 of file block-ack-manager.cc.

References GetNRetryNeededPackets(), GetSeqNumOfNextRetryPacket(), m_agreements, m_bars, NS_ASSERT, NS_LOG_FUNCTION, and ScheduleBlockAckReqIfNeeded().

Referenced by ns3::EdcaTxopN::CompleteTx().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

BlockAckManager& ns3::BlockAckManager::operator= ( const BlockAckManager )
private
Ptr< Packet > ns3::BlockAckManager::ScheduleBlockAckReqIfNeeded ( Mac48Address  recipient,
uint8_t  tid 
)
private
Parameters
recipient
tid
Returns
a packet

Checks if all packets, for which a block ack agreement was established or refreshed, have been transmitted. If yes, adds a pair in m_bAckReqs to indicate that at next channel access a block ack request (for established agreement recipient,tid) is needed.

Definition at line 434 of file block-ack-manager.cc.

References ns3::Packet::AddHeader(), ns3::WifiMacHeader::ADDR1, ns3::BASIC_BLOCK_ACK, ns3::OriginatorBlockAckAgreement::CompleteExchange(), ns3::COMPRESSED_BLOCK_ACK, GetNRetryNeededPackets(), ns3::BlockAckAgreement::GetStartingSequence(), ns3::BlockAckAgreement::GetTid(), m_agreements, m_blockAckType, m_queue, ns3::MULTI_TID_BLOCK_ACK, NS_ASSERT, NS_FATAL_ERROR, NS_LOG_FUNCTION, ns3::CtrlBAckRequestHeader::SetStartingSequence(), ns3::CtrlBAckRequestHeader::SetTidInfo(), and ns3::CtrlBAckRequestHeader::SetType().

Referenced by NotifyMpduTransmission().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetBlockAckInactivityCallback ( Callback< void, Mac48Address, uint8_t, bool >  callback)

Definition at line 641 of file block-ack-manager.cc.

References m_blockAckInactivityTimeout, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::CompleteConfig().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetBlockAckThreshold ( uint8_t  nPackets)
Parameters
nPacketsMinimum number of packets for use of block ack.

Upon receipt of a block ack frame, if total number of packets (packets in WifiMacQueue and buffered packets) is greater of nPackets, they are transmitted using block ack mechanism.

Definition at line 331 of file block-ack-manager.cc.

References m_blockAckThreshold, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::SetBlockAckThreshold().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetBlockAckType ( enum BlockAckType  bAckType)
Parameters
bAckTypeType of block ack

See ctrl-headers.h for more details.

Definition at line 427 of file block-ack-manager.cc.

References m_blockAckType, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::EdcaTxopN().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetBlockDestinationCallback ( Callback< void, Mac48Address, uint8_t >  callback)

Definition at line 648 of file block-ack-manager.cc.

References m_blockPackets, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::EdcaTxopN().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetMaxPacketDelay ( Time  maxDelay)
Parameters
maxDelayMax delay for a buffered packet.

This method is always called by ns3::WifiMacQueue object and sets max delay equals to ns3:WifiMacQueue delay value.

Definition at line 634 of file block-ack-manager.cc.

References m_maxDelay, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::EdcaTxopN().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetQueue ( Ptr< WifiMacQueue queue)
Parameters
queueThe WifiMacQueue object.

Definition at line 531 of file block-ack-manager.cc.

References m_queue, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::EdcaTxopN().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetTxMiddle ( MacTxMiddle txMiddle)

Definition at line 662 of file block-ack-manager.cc.

References m_txMiddle, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::CompleteConfig().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::SetUnblockDestinationCallback ( Callback< void, Mac48Address, uint8_t >  callback)

Definition at line 655 of file block-ack-manager.cc.

References m_unblockPackets, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::EdcaTxopN().

+ Here is the caller graph for this function:

void ns3::BlockAckManager::StorePacket ( Ptr< const Packet packet,
const WifiMacHeader hdr,
Time  tStamp 
)
Parameters
packetPacket to store.
hdr802.11 header for packet.
tStamptime stamp for packet

Stores packet for a possible future retransmission. Retransmission occurs if the packet, in a block ack frame, is indicated by recipient as not received.

Definition at line 206 of file block-ack-manager.cc.

References ns3::WifiMacHeader::GetAddr1(), ns3::WifiMacHeader::GetQosTid(), ns3::WifiMacHeader::IsQosData(), m_agreements, NS_ASSERT, and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::CompleteTx().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

bool ns3::BlockAckManager::SwitchToBlockAckIfNeeded ( Mac48Address  recipient,
uint8_t  tid,
uint16_t  startingSeq 
)
Parameters
recipient
tid
startingSeq
Returns
true if there are packets in the queue that could be sent under block ACK, false otherwise

Checks if there are in the queue other packets that could be send under block ack. If yes adds these packets in current block ack exchange. However, number of packets exchanged in the current block ack, will not exceed the value of BufferSize in the corresponding OriginatorBlockAckAgreement object.

Definition at line 538 of file block-ack-manager.cc.

References ns3::WifiMacHeader::ADDR1, ExistsAgreement(), ExistsAgreementInState(), GetNBufferedPackets(), m_blockAckThreshold, m_queue, NotifyAgreementEstablished(), NS_ASSERT, NS_LOG_FUNCTION, ns3::OriginatorBlockAckAgreement::PENDING, and ns3::OriginatorBlockAckAgreement::UNSUCCESSFUL.

Referenced by GetNextPacket(), NotifyGotBlockAck(), and ns3::EdcaTxopN::VerifyBlockAck().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

void ns3::BlockAckManager::TearDownBlockAck ( Mac48Address  recipient,
uint8_t  tid 
)
Parameters
recipientAddress of station involved in block ack mechanism.
tidTraffic ID.

This method is invoked by EdcaTxopN object upon receipt of a DELBA frame from recipient. The relative block ack agreement is destroyed.

Definition at line 556 of file block-ack-manager.cc.

References DestroyAgreement(), and NS_LOG_FUNCTION.

Referenced by ns3::EdcaTxopN::GotAck(), and ns3::EdcaTxopN::GotDelBaFrame().

+ Here is the call graph for this function:

+ Here is the caller graph for this function:

Member Data Documentation

Mac48Address ns3::BlockAckManager::m_address
private

Definition at line 366 of file block-ack-manager.h.

Agreements ns3::BlockAckManager::m_agreements
private

This data structure contains, for each block ack agreement (recipient, tid), a set of packets for which an ack by block ack is requested.

Every packet or fragment indicated as correctly received in block ack frame is erased from this data structure. Pushed back in retransmission queue otherwise.

Definition at line 353 of file block-ack-manager.h.

Referenced by CleanupBuffers(), CreateAgreement(), DestroyAgreement(), ExistsAgreement(), ExistsAgreementInState(), GetNBufferedPackets(), GetNextPacket(), NotifyAgreementEstablished(), NotifyAgreementUnsuccessful(), NotifyGotBlockAck(), NotifyMpduTransmission(), ScheduleBlockAckReqIfNeeded(), StorePacket(), UpdateAgreement(), and ~BlockAckManager().

std::list<Bar> ns3::BlockAckManager::m_bars
private

Definition at line 360 of file block-ack-manager.h.

Referenced by DestroyAgreement(), HasBar(), HasPackets(), and NotifyMpduTransmission().

Callback<void, Mac48Address, uint8_t, bool> ns3::BlockAckManager::m_blockAckInactivityTimeout
private

Definition at line 368 of file block-ack-manager.h.

Referenced by InactivityTimeout(), and SetBlockAckInactivityCallback().

uint8_t ns3::BlockAckManager::m_blockAckThreshold
private

Definition at line 362 of file block-ack-manager.h.

Referenced by SetBlockAckThreshold(), and SwitchToBlockAckIfNeeded().

enum BlockAckType ns3::BlockAckManager::m_blockAckType
private

Definition at line 363 of file block-ack-manager.h.

Referenced by ScheduleBlockAckReqIfNeeded(), and SetBlockAckType().

Callback<void, Mac48Address, uint8_t> ns3::BlockAckManager::m_blockPackets
private

Definition at line 369 of file block-ack-manager.h.

Referenced by CreateAgreement(), and SetBlockDestinationCallback().

Time ns3::BlockAckManager::m_maxDelay
private

Definition at line 364 of file block-ack-manager.h.

Referenced by CleanupBuffers(), and SetMaxPacketDelay().

Ptr<WifiMacQueue> ns3::BlockAckManager::m_queue
private
std::list<PacketQueueI> ns3::BlockAckManager::m_retryPackets
private

This list contains all iterators to stored packets that need to be retransmitted.

A packet needs retransmission if it's indicated as not correctly received in a block ack frame.

Definition at line 359 of file block-ack-manager.h.

Referenced by CleanupBuffers(), DestroyAgreement(), GetNextPacket(), GetNextPacketSize(), GetNRetryNeededPackets(), GetSeqNumOfNextRetryPacket(), HasOtherFragments(), HasPackets(), NotifyGotBlockAck(), and ~BlockAckManager().

MacTxMiddle* ns3::BlockAckManager::m_txMiddle
private

Definition at line 365 of file block-ack-manager.h.

Referenced by NotifyGotBlockAck(), and SetTxMiddle().

Callback<void, Mac48Address, uint8_t> ns3::BlockAckManager::m_unblockPackets
private

Definition at line 370 of file block-ack-manager.h.

Referenced by SetUnblockDestinationCallback(), and UpdateAgreement().


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